~tj'dZddlmZddlmZddlmZGddeZGddeZGd d eZ Gd d eZ Gd de Z Gdde Z GddeZ GddeZGddeZGddeZGddeZGddeZGddeZGdd eZGd!d"eZGd#d$eZGd%d&eZGd'd(eZGd)d*eZGd+d,eZGd-d.eZGd/d0eZd1S)2zCustom 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)LangSmithErrorceZdZdZdS)SandboxClientErrorz)Base exception for sandbox client errors.N__name__ __module__ __qualname____doc__[/var/www/html/CA-Chatbot/venv/lib/python3.11/site-packages/langsmith/sandbox/_exceptions.pyrrs33DrrceZdZdZdS)SandboxAPIErrorzvRaised when the API endpoint returns an unexpected error. For example, this is raised for wrong URL or path. Nrr rrrr  DrrceZdZdZdS)SandboxAuthenticationErrorz>Raised when authentication fails (invalid or missing API key).Nrr rrrr#sHHDrrceZdZdZdS)SandboxConnectionErrorz3Raised when connection to the sandbox server fails.Nrr rrrr)s==DrrceZdZdZdS)SandboxConnectTimeoutErrorayRaised when the socket fails or times out before the WebSocket handshake. Distinct from its parent because it is safely retryable: the execute frame was never sent, so re-issuing the same command_id cannot double-run a command. run() retries this with backoff; a plain SandboxConnectionError (a rejected handshake) is permanent and propagates immediately. Nrr rrrr/s DrrceZdZdZdS)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   Drrc&eZdZdZdd fd ZxZS) ResourceNotFoundErrorz}Raised when a resource is not found. Attributes: resource_type: Type of resource (sandbox, snapshot, file). Nmessagestr resource_type Optional[str]cXt|||_dSInitialize the error.Nsuper__init__rselfrr __class__s rr&zResourceNotFoundError.__init__Y) !!!*rNrrrr r r r r r& __classcell__r)s@rrrRL +++++++++++rrc6eZdZdZ d d fd Zd fd ZxZS)ResourceTimeoutErrorzRaised when an operation times out. Attributes: resource_type: Type of resource (sandbox, snapshot). last_status: The last known status before timeout (for sandboxes). Nrrrr last_statuscft|||_||_dSr")r%r&rr3)r(rrr3r)s rr&zResourceTimeoutError.__init__gs3 !!!*&rreturncpt}|jr |d|jdS|S)Return string representation.z (last_status: ))r%__str__r3)r(baser)s rr9zResourceTimeoutError.__str__rs@ww     ?>>4+;>>> > rNN)rrrr r3r r5rr r r r r&r9r.r/s@rr2r2_sr(,%) ' ' ' ' ' ' 'rr2c&eZdZdZdd fd ZxZS) ResourceInUseErrorzRaised when deleting a resource that is still in use. Attributes: resource_type: Type of resource (snapshot). Nrrrr cXt|||_dSr"r$r's rr&zResourceInUseError.__init__r*rr+r,r-r/s@rr?r?zr0rr?c&eZdZdZdd fd ZxZS) ResourceAlreadyExistsErrorzRaised when creating a resource that already exists. Attributes: resource_type: Type of resource (e.g., snapshot). Nrrrr cXt|||_dSr"r$r's rr&z#ResourceAlreadyExistsError.__init__r*rr+r,r-r/s@rrBrBr0rrBc&eZdZdZdd fd ZxZS) ResourceNameConflictErrorzRaised when updating a resource name to one that already exists. Attributes: resource_type: Type of resource (sandbox, snapshot). Nrrrr cXt|||_dSr"r$r's rr&z"ResourceNameConflictError.__init__r*rr+r,r-r/s@rrErEr0rrEc,eZdZdZ d d fd ZxZS) ValidationErroraRaised when request validation fails. This includes: - Resource values exceeding server-defined limits (CPU, memory, storage) - Invalid resource units - Invalid name formats 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. Nrrfieldr detailsOptional[list[dict]] error_typecxt|||_|pg|_||_dSr")r%r&rIrJrL)r(rrIrJrLr)s rr&zValidationError.__init__s: !!! }" $r)NNN)rrrIr rJrKrLr r-r/s@rrHrHsW   $(,$( % % % % % % % % % % %rrHc&eZdZdZdd fd ZxZS) QuotaExceededErroraRaised when organization quota limits are exceeded. Users should contact technical support via our Support Portal (https://support.langchain.com) to increase quotas. Attributes: quota_type: Type of quota exceeded (e.g., "sandbox_count", "cpu"). Nrr quota_typer cXt|||_dSr")r%r&rP)r(rrPr)s rr&zQuotaExceededError.__init__s& !!!$rr+)rrrPr r-r/s@rrOrOsL%%%%%%%%%%%rrOc6eZdZdZ d d fd Zd fd ZxZS)ResourceCreationErrorzRaised when resource provisioning fails. Attributes: resource_type: Type of resource (sandbox, snapshot). error_type: Machine-readable error type (ImagePull, CrashLoop, SandboxConfig, Unschedulable). Nrrrr rLcft|||_||_dSr")r%r&rrL)r(rrrLr)s rr&zResourceCreationError.__init__s0 !!!*$rr5c|jr+td|jdStSr7z []rLr%r9r(r)s rr9zResourceCreationError.__str__H ? >ggoo''==4?=== =ww   rr;)rrrr rLr r<r=r/s@rrSrSsr(,$( % % % % % % %!!!!!!!!!!rrSceZdZdZdS)DataplaneNotConfiguredErrorzRaised when dataplane_url is not available for the sandbox. This occurs when the sandbox-router URL is not configured for the cluster. Nrr rrr\r\rrr\ceZdZdZdS)SandboxNotReadyErrorzDRaised when attempting to interact with a sandbox that is not ready.Nrr rrr^r^sNNDrr^c6eZdZdZ d d fd Zd fd 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. Nrr operationr rLcft|||_||_dSr")r%r&rarL)r(rrarLr)s rr&zSandboxOperationError.__init__s/ !!!"$rr5c|jr+td|jdStSrVrXrYs rr9zSandboxOperationError.__str__rZrr;)rrrar rLr r<r=r/s@rr`r`sr$($( % % % % % % %!!!!!!!!!!rr`c&eZdZdZdd fd ZxZS) CommandTimeoutErrorzRaised when a command exceeds its timeout. Attributes: timeout: The timeout value in seconds that was exceeded. Nrrtimeout Optional[int]c^t|dd||_dS)r#commandCommandTimeout)rarLN)r%r&rf)r(rrfr)s rr&zCommandTimeoutError.__init__'s. IBRSSS rr+)rrrfrgr-r/s@rrere sL rreceZdZdZdS) TunnelErrorz%Base exception for TCP tunnel errors.Nrr rrrlrl2s//Drrlc$eZdZdZdfd ZxZS)TunnelPortNotAllowedErrorzlThe daemon rejected the port as not allowed. Attributes: port: The port that was rejected. rrportintcXt|||_dSr"r%r&ror(rror)s rr&z"TunnelPortNotAllowedError.__init__?& !!! rrrrorpr-r/s@rrnrn8G rrnc$eZdZdZdfd ZxZS)TunnelConnectionRefusedErrorzNothing is listening on the target port inside the sandbox. Attributes: port: The port that could not be reached. rrrorpcXt|||_dSr"rrrss rr&z%TunnelConnectionRefusedError.__init__Lrtrrur-r/s@rrxrxErvrrxceZdZdZdS)TunnelUnsupportedVersionErrorzCProtocol version mismatch between the tunnel client and the daemon.Nrr rrr{r{RsMMDrr{N)r __future__rtypingrlangsmith.utilsrrrrrrrrr2r?rBrErHrOrSr\r^r`rerlrnrxr{r rrrs#"""""******             (        !3        /        !7         5   . + + + + +. + + +-6 + + + + ++ + + + + + + + +!3 + + + + + + + + 2 + + +$%%%%%(%%%8 % % % % %+ % % %*!!!!!.!!!@     "4        -   !!!!!.!!!4     /   $     $               ;        K     r