Zǻi&dZddlmZddlmZddlmZGddeZGddeZGd d eZ Gd d eZ Gd de Z GddeZ GddeZ GddeZGddeZGddeZGddeZGddeZGddeZGdd eZGd!d"eZGd#d$eZGd%d&eZGd'd(eZGd)d*eZGd+d,eZGd-d.eZy/)0zCustom exceptions for the sandbox client. All sandbox exceptions extend LangSmithError for unified error handling. The exceptions are organized by error type rather than resource type, with a resource_type attribute for specific handling when needed. ) annotations)Optional)LangSmithErrorceZdZdZy)SandboxClientErrorz)Base exception for sandbox client errors.N__name__ __module__ __qualname____doc__[/opt/lhia/marcimex/agent/venv/lib/python3.12/site-packages/langsmith/sandbox/_exceptions.pyrrs3rrceZdZdZy)SandboxAPIErrorzvRaised when the API endpoint returns an unexpected error. For example, this is raised for wrong URL or path. Nrr rrrr   rrceZdZdZy)SandboxAuthenticationErrorz>Raised when authentication fails (invalid or missing API key).Nrr rrrr#sHrrceZdZdZy)SandboxConnectionErrorz3Raised when connection to the sandbox server fails.Nrr rrrr)s=rrceZdZdZy)SandboxServerReloadErroruWRaised when the server sends a 1001 Going Away close frame. This indicates a server hot-reload, not a true connection failure. The command is still running on the server. This is a subclass of SandboxConnectionError, so the auto-reconnect logic in CommandHandle catches it along with all other connection errors. The distinction matters for retry strategy: SandboxServerReloadError triggers immediate reconnect (no backoff), while other SandboxConnectionError triggers exponential backoff. Users typically never see this exception — it's handled internally. Nrr rrrr/s   rrc&eZdZdZddfd ZxZS)ResourceNotFoundErrorzRaised when a resource is not found. Attributes: resource_type: Type of resource (sandbox, template, volume, pool, file). c2t||||_yInitialize the error.Nsuper__init__ resource_typeselfmessager! __class__s rr zResourceNotFoundError.__init__M !*rNr$strr! Optional[str]r r r r r __classcell__r%s@rrrF ++rrc@eZdZdZ d dfd Zdfd ZxZS)ResourceTimeoutErrorzRaised when an operation times out. Attributes: resource_type: Type of resource (sandbox, volume, pool). last_status: The last known status before timeout (for sandboxes). c@t||||_||_yr)rr r! last_status)r#r$r!r2r%s rr zResourceTimeoutError.__init__[s" !*&rc`t|}|jr|d|jdS|S)Return string representation.z (last_status: ))r__str__r2)r#baser%s rr6zResourceTimeoutError.__str__fs7w    V?4+;+;* > rNN)r$r)r!r*r2r*returnr)r r r r r r6r,r-s@rr0r0Ss;(,%) ' '% '# 'rr0c&eZdZdZddfd ZxZS)ResourceInUseErrorzRaised when deleting a resource that is still in use. Attributes: resource_type: Type of resource (template, volume). c2t||||_yrrr"s rr zResourceInUseError.__init__ur&rr'r(r+r-s@rr=r=nr.rr=c&eZdZdZddfd ZxZS)ResourceAlreadyExistsErrorzRaised when creating a resource that already exists. Attributes: resource_type: Type of resource (e.g., pool). c2t||||_yrrr"s rr z#ResourceAlreadyExistsError.__init__r&rr'r(r+r-s@rr@r@{r.rr@c&eZdZdZddfd ZxZS)ResourceNameConflictErrorzRaised when updating a resource name to one that already exists. Attributes: resource_type: Type of resource (volume, template, pool, sandbox). c2t||||_yrrr"s rr z"ResourceNameConflictError.__init__r&rr'r(r+r-s@rrCrCr.rrCc:eZdZdZ d dfd ZxZS)ValidationErroraRaised when request validation fails. This includes: - Resource values exceeding server-defined limits (CPU, memory, storage) - Invalid resource units - Invalid name formats - Pool validation failures (e.g., template has volumes) Attributes: field: The field that failed validation (e.g., "cpu", "memory"). details: List of validation error details from the API. error_type: Machine-readable error type from the API. cVt||||_|xsg|_||_yr)rr fielddetails error_type)r#r$rHrIrJr%s rr zValidationError.__init__s+ ! }" $r)NNN)r$r)rHr*rIzOptional[list[dict]]rJr*r+r-s@rrFrFsC " $(,$( % % %& % " % %rrFc&eZdZdZddfd ZxZS)QuotaExceededErrorzRaised when organization quota limits are exceeded. Users should contact support@langchain.dev to increase quotas. Attributes: quota_type: Type of quota exceeded (e.g., "sandbox_count", "cpu"). c2t||||_yr)rr quota_type)r#r$rNr%s rr zQuotaExceededError.__init__s !$rr')r$r)rNr*r+r-s@rrLrLs%%rrLc@eZdZdZ d dfd Zdfd ZxZS)ResourceCreationErroraRaised when resource provisioning fails. Attributes: resource_type: Type of resource (sandbox, volume, pool). error_type: Machine-readable error type (ImagePull, CrashLoop, SandboxConfig, Unschedulable, VolumeProvisioning). c@t||||_||_yr)rr r!rJ)r#r$r!rJr%s rr zResourceCreationError.__init__s! !*$rct|jrt| d|jdSt| Sr4z []rJrr6r#r%s rr6zResourceCreationError.__str__7 ??go'(4??*;1= =w  rr8)r$r)r!r*rJr*r9r;r-s@rrPrPs;(,$( % %% %" %!!rrPceZdZdZy)DataplaneNotConfiguredErrorzRaised when dataplane_url is not available for the sandbox. This occurs when the sandbox-router URL is not configured for the cluster. Nrr rrrYrYrrrYceZdZdZy)SandboxNotReadyErrorzDRaised when attempting to interact with a sandbox that is not ready.Nrr rrr[r[sNrr[c@eZdZdZ d dfd Zdfd ZxZS)SandboxOperationErrorzRaised when a sandbox operation fails (run, read, write). Attributes: operation: The operation that failed (command, read, write). error_type: Machine-readable error type from the API. c@t||||_||_yr)rr operationrJ)r#r$r_rJr%s rr zSandboxOperationError.__init__s  !"$rct|jrt| d|jdSt| SrSrUrVs rr6zSandboxOperationError.__str__ rWrr8)r$r)r_r*rJr*r9r;r-s@rr]r]s;$($( % %! %" %!!rr]c&eZdZdZddfd ZxZS)CommandTimeoutErrorzRaised when a command exceeds its timeout. Attributes: timeout: The timeout value in seconds that was exceeded. c8t||dd||_y)rcommandCommandTimeout)r_rJN)rr timeout)r#r$rfr%s rr zCommandTimeoutError.__init__s IBRS rr')r$r)rfz Optional[int]r+r-s@rrbrbs rrbceZdZdZy) TunnelErrorz%Base exception for TCP tunnel errors.Nrr rrrhrh&s/rrhc$eZdZdZdfd ZxZS)TunnelPortNotAllowedErrorzlThe daemon rejected the port as not allowed. Attributes: port: The port that was rejected. c2t||||_yrrr portr#r$rmr%s rr z"TunnelPortNotAllowedError.__init__3 ! rr$r)rmintr+r-s@rrjrj, rrjc$eZdZdZdfd ZxZS)TunnelConnectionRefusedErrorzNothing is listening on the target port inside the sandbox. Attributes: port: The port that could not be reached. c2t||||_yrrlrns rr z%TunnelConnectionRefusedError.__init__@rorrpr+r-s@rrtrt9rrrrtceZdZdZy)TunnelUnsupportedVersionErrorzCProtocol version mismatch between the tunnel client and the daemon.Nrr rrrwrwFsMrrwN)r __future__rtypingrlangsmith.utilsrrrrrrrr0r=r@rCrFrLrPrYr[r]rbrhrjrtrwr rrr{s##*   (  !3  /  5 . +. +-6 ++ + +!3 + + 2 +$%(%: %+ %(!.!@ "4  - !.!4 / $ $   ;  K r