a i&zdZddlmZddlmZddlmZGddeZGddeZGd 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.eZd/S)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)LangSmithErrorceZdZdZdS)SandboxClientErrorz)Base exception for sandbox client errors.N__name__ __module__ __qualname____doc__C:\Users\Dell Inspiron 16\Desktop\tws\AgrotaPowerBi\back-agrota-powerbi\mcp-client-agrota\venv\Lib\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)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) ResourceNotFoundErrorzRaised when a resource is not found. Attributes: resource_type: Type of resource (sandbox, template, volume, pool, file). Nmessagestr resource_type Optional[str]cXt|||_dSInitialize the error.Nsuper__init__rselfrr __class__s rr$zResourceNotFoundError.__init__M) !!!*rNrrrrr r r r r$ __classcell__r's@rrrFL +++++++++++rrc6eZdZdZ d d fd Zd fd 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). Nrrrr last_statuscft|||_||_dSr )r#r$rr1)r&rrr1r's rr$zResourceTimeoutError.__init__[s3 !!!*&rreturncpt}|jr |d|jdS|S)Return string representation.z (last_status: ))r#__str__r1)r&baser's rr7zResourceTimeoutError.__str__fs@ww     ?>>4+;>>> > rNN)rrrrr1rr3rr r r r r$r7r,r-s@rr0r0Ssr(,%) ' ' ' ' ' ' 'rr0c&eZdZdZdd fd ZxZS) ResourceInUseErrorzRaised when deleting a resource that is still in use. Attributes: resource_type: Type of resource (template, volume). NrrrrcXt|||_dSr r"r%s rr$zResourceInUseError.__init__ur(rr)r*r+r-s@rr=r=nr.rr=c&eZdZdZdd fd ZxZS) ResourceAlreadyExistsErrorzRaised when creating a resource that already exists. Attributes: resource_type: Type of resource (e.g., pool). NrrrrcXt|||_dSr r"r%s rr$z#ResourceAlreadyExistsError.__init__r(rr)r*r+r-s@rr@r@{r.rr@c&eZdZdZdd fd ZxZS) ResourceNameConflictErrorzRaised when updating a resource name to one that already exists. Attributes: resource_type: Type of resource (volume, template, pool, sandbox). NrrrrcXt|||_dSr r"r%s rr$z"ResourceNameConflictError.__init__r(rr)r*r+r-s@rrCrCr.rrCc,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 - 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. NrrfieldrdetailsOptional[list[dict]] error_typecxt|||_|pg|_||_dSr )r#r$rGrHrJ)r&rrGrHrJr's rr$zValidationError.__init__s: !!! }" $r)NNN)rrrGrrHrIrJrr+r-s@rrFrFsW  " $(,$( % % % % % % % % % % %rrFc&eZdZdZdd fd 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"). Nrr quota_typercXt|||_dSr )r#r$rN)r&rrNr's rr$zQuotaExceededError.__init__s& !!!$rr))rrrNrr+r-s@rrMrMsL%%%%%%%%%%%rrMc6eZdZdZ d d fd Zd fd 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). NrrrrrJcft|||_||_dSr )r#r$rrJ)r&rrrJr's rr$zResourceCreationError.__init__s0 !!!*$rr3c|jr+td|jdStSr5z []rJr#r7r&r's rr7zResourceCreationError.__str__H ? >ggoo''==4?=== =ww   rr9)rrrrrJrr:r;r-s@rrQrQsr(,$( % % % % % % %!!!!!!!!!!rrQceZdZdZdS)DataplaneNotConfiguredErrorzRaised when dataplane_url is not available for the sandbox. This occurs when the sandbox-router URL is not configured for the cluster. Nrr rrrZrZrrrZceZdZdZdS)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 operationrrJcft|||_||_dSr )r#r$r_rJ)r&rr_rJr's rr$zSandboxOperationError.__init__s/ !!!"$rr3c|jr+td|jdStSrTrVrWs rr7zSandboxOperationError.__str__ rXrr9)rrr_rrJrr: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)r_rJN)r#r$rd)r&rrdr's rr$zCommandTimeoutError.__init__s. IBRSSS rr))rrrdrer+r-s@rrcrcsL rrcceZdZdZdS) TunnelErrorz%Base exception for TCP tunnel errors.Nrr rrrjrj&s//Drrjc$eZdZdZdfd ZxZS)TunnelPortNotAllowedErrorzlThe daemon rejected the port as not allowed. Attributes: port: The port that was rejected. rrportintcXt|||_dSr r#r$rmr&rrmr's rr$z"TunnelPortNotAllowedError.__init__3& !!! rrrrmrnr+r-s@rrlrl,G rrlc$eZdZdZdfd ZxZS)TunnelConnectionRefusedErrorzNothing is listening on the target port inside the sandbox. Attributes: port: The port that could not be reached. rrrmrncXt|||_dSr rprqs rr$z%TunnelConnectionRefusedError.__init__@rrrrsr+r-s@rrvrv9rtrrvceZdZdZdS)TunnelUnsupportedVersionErrorzCProtocol version mismatch between the tunnel client and the daemon.Nrr rrryryFsMMDrryN)r __future__rtypingrlangsmith.utilsrrrrrrrr0r=r@rCrFrMrQrZr\r^rcrjrlrvryr rrr}s#"""""******             (        !3        /        5   . + + + + +. + + +-6 + + + + ++ + + + + + + + +!3 + + + + + + + + 2 + + +$%%%%%(%%%: % % % % %+ % % %(!!!!!.!!!@     "4        -   !!!!!.!!!4     /   $     $               ;        K     r