=Ki"xSrSSKJr SSKJrJr SSKrSSKJr SSK J r J r J r JrJrJr SSKJrJrJrJrJr SSKJrJrJrJr SS KJr SS jrSS jr"S S 5r g)zEMain SandboxClient class for interacting with the sandbox server API.) annotations)AnyOptionalN)utils)ResourceInUseErrorResourceNameConflictErrorResourceNotFoundErrorSandboxAPIErrorSandboxConnectionErrorValidationError)handle_client_http_errorhandle_pool_errorhandle_sandbox_creation_errorhandle_volume_creation_errorparse_error_response)PoolSandboxTemplateVolumeVolumeMountSpec)SandboxcT[R"SSS9nURS5S3$)z~Get the default sandbox API endpoint from environment. Derives the endpoint from LANGSMITH_ENDPOINT (or LANGCHAIN_ENDPOINT). ENDPOINTzhttps://api.smith.langchain.com)default/z /v2/sandboxes)ls_utils get_env_varrstrip)bases [/var/www/html/dynamic-report/venv/lib/python3.13/site-packages/langsmith/sandbox/_client.py_get_default_api_endpointr s.    4U VDkk# } --c.[R"S5$)z)Get the default API key from environment.API_KEY)rrr!r_get_default_api_keyr%&s    **r!c\rSrSrSrSSSS.S*SjjrS+SjrS+SjrS,S jrS-S jr S S .S.S jjr S/Sjr S0Sjr S1Sjr SSS.S2SjjrSSSSS.S3SjjrS4SjrS5SjrS6SjrS1SjrSS .S7SjjrS8SjrS9SjrSSS.S:S jjrS1S!jrSSS".S;S#jjrSSS".S;S$jjrSS'jrS1S(jrS)rg)? SandboxClient+aWClient for interacting with the Sandbox Server API. This client provides a simple interface for managing sandboxes and templates. Example: # Uses LANGSMITH_ENDPOINT and LANGSMITH_API_KEY from environment client = SandboxClient() # Or with explicit configuration client = SandboxClient( api_endpoint="https://api.smith.langchain.com/v2/sandboxes", api_key="your-api-key", ) # Create a sandbox and run commands with client.sandbox(template_name="python-sandbox") as sandbox: result = sandbox.run("python --version") print(result.stdout) Ng$@) api_endpointtimeoutapi_keycU=(d [5RS5UlU=(d [5nX@l0nU(aXES'[ R "X%S9Ulg)aXInitialize the SandboxClient. Args: api_endpoint: Full URL of the sandbox API endpoint. If not provided, derived from LANGSMITH_ENDPOINT environment variable. timeout: Default HTTP timeout in seconds. api_key: API key for authentication. If not provided, uses LANGSMITH_API_KEY environment variable. rz X-Api-Key)r*headersN)r r _base_urlr%_api_keyhttpxClient_http)selfr)r*r+resolved_api_keyr-s r__init__SandboxClient.__init__@sS 'E*C*EMMcR"<&:&<( "$ #3K \\'C r!c8URR5 g)zClose the HTTP client.N)r2closer3s rr8SandboxClient.closeXs r!cURR(dURR5 gg![a gf=f)z,Close the HTTP client on garbage collection.N)r2 is_closedr8 Exceptionr9s r__del__SandboxClient.__del__\s; ::''   "(   s59 AAcU$)zEnter context manager.r$r9s r __enter__SandboxClient.__enter__ds r!c$UR5 g)zExit context manager.N)r8)r3exc_typeexc_valexc_tbs r__exit__SandboxClient.__exit__hs  r!<)r*cnURS3nUUSUS.nURRXEUS-S9nUR5 [R "UR 55$![Ran[SU35UeSnAf[Ran[U5 eSnAff=f)aCreate a new persistent volume. Creates a persistent storage volume that can be referenced in templates. Args: name: Volume name. size: Storage size (e.g., "1Gi", "10Gi"). timeout: Timeout in seconds when waiting for ready (min: 5, max: 300). Returns: Created Volume. Raises: VolumeProvisioningError: If volume provisioning fails. ResourceTimeoutError: If volume doesn't become ready within timeout. SandboxClientError: For other errors. /volumesT)namesizewait_for_readyr*jsonr*Failed to connect to server: N) r.r2postraise_for_statusr from_dictrQr0 ConnectErrorr HTTPStatusErrorr)r3rLrMr*urlpayloadresponsees r create_volumeSandboxClient.create_volumeus0 )"   zzs'B,OH  % % '##HMMO4 4!! U(+H)LMST T$$  ( +  s$AA))B4=B  B4# B//B4cURSU3nURRU5nUR5 [R "UR 55$![Ran[SU35UeSnAf[Ra:nURRS:Xa[SUS3SS9Ue[U5 eSnAff=f) zGet a volume by name. Args: name: Volume name. Returns: Volume. Raises: ResourceNotFoundError: If volume not found. SandboxClientError: For other errors. /volumes/rRNVolume ' ' not foundvolume resource_type)r.r2getrTrrUrQr0rVr rWrZ status_coder r r3rLrXrZr[s r get_volumeSandboxClient.get_volumes $0 zz~~c*H  % % '##HMMO4 4!! U(+H)LMST T$$ zz%%,+tfK0 %Q '   $AA""C6BC5CCcURS3nURRU5nUR5 UR 5nURS/5Vs/sHn[ R "U5PM sn$s snf![Ran[SU35UeSnAf[Ra;nURRS:Xa[SUS35Ue[U5 eSnAff=f)z1List all volumes. Returns: List of Volumes. rKvolumesrRNr`API endpoint not found: %. Check that api_endpoint is correct.)r.r2rfrTrQrrUr0rVr rWrZrgr r )r3rXrZdatavr[s r list_volumesSandboxClient.list_volumess  ) zz~~c*H  % % '==?D15)R1HI1HAF$$Q'1HI II!! U(+H)LMST T$$ zz%%,%.se4:; %Q '  6AB BBBC=B++C=6C88C=cURSU3nURRU5nUR5 g![R an[ SU35UeSnAf[RaqnURRS:Xa[SUS3SS9UeURRS :Xa[U5n[US SS9Ue[U5 SnAgSnAff=f) zDelete a volume. Args: name: Volume name. Raises: ResourceNotFoundError: If volume not found. ResourceInUseError: If volume is referenced by templates. SandboxClientError: For other errors. r_rRNr`rarbrcrdmessager.r2deleterTr0rVr rWrZrgr rrr r3rLrXrZr[rps r delete_volumeSandboxClient.delete_volumes $0 (zz((-H  % % '!! U(+H)LMST T$$ (zz%%,+tfK0zz%%,+A.(iQWXX $Q ' ' ("+?C*A""C*9A'C%%C*)new_namerMcURSU3n0nUbX%S'UbX5S'U(dURU5$URRXES9nUR 5 [ R "UR55$![Ran[SU35UeSnAf[RanURRS:Xa[SUS 3S S 9UeURRS :Xa[U5n[!US SS9UeURRS:Xa[U5n[#US S S 9Ue[%U5 eSnAff=f)axUpdate a volume's name and/or size. You can update the display name, size, or both in a single request. Only storage size increases are allowed (storage backend limitation). Args: name: Current volume name. new_name: New display name (optional). size: New storage size (must be >= current size). Optional. Returns: Updated Volume. Raises: ResourceNotFoundError: If volume not found. VolumeResizeError: If storage decrease attempted. ResourceNameConflictError: If new_name is already in use. SandboxQuotaExceededError: If storage quota would be exceeded. SandboxClientError: For other errors. r_NrLrMrQrRr`rarbrcrdirw VolumeResize) error_typerv)r.rir2patchrTrrUrQr0rVr rWrZrgr rr rr ) r3rLr~rMrXrYrZr[rps r update_volumeSandboxClient.update_volumesi6 $0"$  &FO  "FO??4( ( zz''':H  % % '##HMMO4 4!! U(+H)LMST T$$ zz%%,+tfK0zz%%,+A.%d9o.QWXXzz%%,+A./O8 %Q '  s%A BE"B++E"BEE"500m512Mi)cpumemorystorage volume_mountscURS3nUUUUS.S.nU(aXXSS'U(a-UV s/sHn U RU RS.PM sn US'URR XxS9n U R 5 [ R"U R55$s sn f![Ran [S U 35U eS n A f[Ran [U 5 eS n A ff=f) a]Create a new SandboxTemplate. Only the container image, resource limits, and volume mounts can be configured. All other container details are handled by the server. Args: name: Template name. image: Container image (e.g., "python:3.12-slim"). cpu: CPU limit (e.g., "500m", "1", "2"). Default: "500m". memory: Memory limit (e.g., "256Mi", "1Gi"). Default: "512Mi". storage: Ephemeral storage limit (e.g., "1Gi"). Optional. volume_mounts: List of volumes to mount in the sandbox. Optional. Returns: Created SandboxTemplate. Raises: SandboxClientError: If creation fails. /templates)rr)rLimage resourcesrr) volume_name mount_pathrrrRN)r.rrr2rSrTrrUrQr0rVr rWr ) r3rLrrrrrrXrYvmrZr[s rcreate_templateSandboxClient.create_template2s: + #  .5K  + (('B!#bmmL'(GO $  zzs9H  % % '",,X]]_= =(!! U(+H)LMST T$$  $Q '  s*#B)A B..C9CC9( C44C9cURSU3nURRU5nUR5 [R "UR 55$![Ran[SU35UeSnAf[Ra:nURRS:Xa[SUS3SS9Ue[U5 eSnAff=f) zGet a SandboxTemplate by name. Args: name: Template name. Returns: SandboxTemplate. Raises: ResourceNotFoundError: If template not found. SandboxClientError: For other errors. /templates/rRNr` Template 'rbtemplaterd)r.r2rfrTrrUrQr0rVr rWrZrgr r rhs r get_templateSandboxClient.get_templateks D62 zz~~c*H  % % '",,X]]_= =!! U(+H)LMST T$$ zz%%,+ k2* %Q '   rkcURS3nURRU5nUR5 UR 5nURS/5Vs/sHn[ R "U5PM sn$s snf![Ran[SU35UeSnAf[Ra;nURRS:Xa[SUS35Ue[U5 eSnAff=f)zCList all SandboxTemplates. Returns: List of SandboxTemplates. r templatesrRNr`rnro)r.r2rfrTrQrrUr0rVr rWrZrgr r )r3rXrZrptr[s rlist_templatesSandboxClient.list_templatess  + zz~~c*H  % % '==?D:>((;PR:ST:SQO--a0:ST TT!! U(+H)LMST T$$ zz%%,%.se4:; %Q '  rtcURSU3nSU0nURRX4S9nUR5 [R "UR 55$![Ran[SU35UeSnAf[RamnURRS:Xa[SUS3S S 9UeURRS :Xa[U5n[US S S 9Ue[!U5 eSnAff=f) a4Update a template's display name. Args: name: Current template name. new_name: New display name. Returns: Updated SandboxTemplate. Raises: ResourceNotFoundError: If template not found. ResourceNameConflictError: If new_name is already in use. SandboxClientError: For other errors. rrLrrRNr`rrbrrdrvrw)r.r2rrTrrUrQr0rVr rWrZrgr rrr )r3rLr~rXrYrZr[rps rupdate_templateSandboxClient.update_templates D628$ zz''':H  % % '",,X]]_= =!! U(+H)LMST T$$ zz%%,+ k2*zz%%,+A./O: %Q '  s%A A$$D 8BD A(DD cURSU3nURRU5nUR5 g![R an[ SU35UeSnAf[RaqnURRS:Xa[SUS3SS9UeURRS :Xa[U5n[US SS9Ue[U5 SnAgSnAff=f) zDelete a SandboxTemplate. Args: name: Template name. Raises: ResourceNotFoundError: If template not found. ResourceInUseError: If template is referenced by sandboxes or pools. SandboxClientError: For other errors. rrRNr`rrbrrdrvrwrxrzs rdelete_templateSandboxClient.delete_templates D62 (zz((-H  % % '!! U(+H)LMST T$$ (zz%%,+ k2*zz%%,+A.(O: %Q ' ' (r}rOctURS3nUUUSUS.nUS-nURRXVUS9nUR5 [R "UR 55$![Ran [SU 35U eSn A f[Ran [U 5 eSn A ff=f)aCreate a new Sandbox Pool. Pools pre-provision sandboxes from a template for faster startup. Args: name: Pool name (lowercase letters, numbers, hyphens; max 63 chars). template_name: Name of the SandboxTemplate to use (no volume mounts). replicas: Number of sandboxes to pre-provision (1-100). timeout: Timeout in seconds when waiting for ready (10-600). Returns: Created Pool. Raises: ResourceNotFoundError: If template not found. ValidationError: If template has volumes attached. ResourceAlreadyExistsError: If pool with this name already exists. ResourceTimeoutError: If pool doesn't reach ready state within timeout. SandboxQuotaExceededError: If organization quota is exceeded. SandboxClientError: For other errors. /poolsT)rL template_namereplicasrNr*rOrPrRN) r.r2rSrTrrUrQr0rVr rWr) r3rLrrr*rXrY http_timeoutrZr[s r create_poolSandboxClient.create_pools: '* " #  "R>(--/2 2!! U(+H)LMST T$$  a  s$AA,,B7BB7& B22B7cURSU3nURRU5nUR5 [R "UR 55$![Ran[SU35UeSnAf[Ra:nURRS:Xa[SUS3SS9Ue[U5 eSnAff=f) zGet a Pool by name. Args: name: Pool name. Returns: Pool. Raises: ResourceNotFoundError: If pool not found. SandboxClientError: For other errors. /pools/rRNr`Pool 'rbpoolrd)r.r2rfrTrrUrQr0rVr rWrZrgr r rhs rget_poolSandboxClient.get_pools v. zz~~c*H  % % '>>(--/2 2!! U(+H)LMST T$$ zz%%,+TF+.f %Q '   rkcURS3nURRU5nUR5 UR 5nURS/5Vs/sHn[ R "U5PM sn$s snf![Ran[SU35UeSnAf[Ra;nURRS:Xa[SUS35Ue[U5 eSnAff=f)z-List all Pools. Returns: List of Pools. rpoolsrRNr`rnro)r.r2rfrTrQrrUr0rVr rWrZrgr r )r3rXrZrppr[s r list_poolsSandboxClient.list_pools7s  ' zz~~c*H  % % '==?D/3xx/DE/D!DNN1%/DE EE!! U(+H)LMST T$$ zz%%,%.se4:; %Q '  rt)r~rcdURSU3n0nUbX%S'UbX5S'U(dURU5$URRXES9nUR 5 [ R "UR55$![Ran[SU35UeSnAf[RamnURRS:Xa[SUS 3S S 9UeURRS :Xa[U5n[!US S S 9Ue[#U5 eSnAff=f)aYUpdate a Pool's name and/or replica count. You can update the display name, replica count, or both. The template reference cannot be changed after creation. Args: name: Current pool name. new_name: New display name (optional). replicas: New number of replicas (0-100). Set to 0 to pause. Returns: Updated Pool. Raises: ResourceNotFoundError: If pool not found. ValidationError: If template was deleted. ResourceNameConflictError: If new_name is already in use. SandboxQuotaExceededError: If quota exceeded when scaling up. SandboxClientError: For other errors. rNrLrrrRr`rrbrrdrvrw)r.rr2rrTrrUrQr0rVr rWrZrgr rrr) r3rLr~rrXrYrZr[rps r update_poolSandboxClient.update_poolOs86 v."$  &FO  "*J ==& & zz''':H  % % '>>(--/2 2!! U(+H)LMST T$$ zz%%,+TF+.fzz%%,+A./O6 a  s%A BD/B++D/A(D**D/ctURSU3nURRU5nUR5 g![R an[ SU35UeSnAf[Ra>nURRS:Xa[SUS3SS9Ue[U5 SnAgSnAff=f) zDelete a Pool. This will terminate all sandboxes in the pool. Args: name: Pool name. Raises: ResourceNotFoundError: If pool not found. SandboxClientError: For other errors. rrRNr`rrbrrd r.r2ryrTr0rVr rWrZrgr r rhs r delete_poolSandboxClient.delete_pools v. (zz((-H  % % '!! U(+H)LMST T$$ (zz%%,+TF+.f %Q ' '  (!+?B7A""B794B22B7)rLr*c6URUUUS9nSUlU$)aCreate a sandbox and return a Sandbox instance. This is the primary method for creating sandboxes. Use it as a context manager for automatic cleanup: with client.sandbox(template_name="my-template") as sandbox: result = sandbox.run("echo hello") The sandbox is automatically deleted when exiting the context manager. For sandboxes with manual lifecycle management, use create_sandbox(). Args: template_name: Name of the SandboxTemplate to use. name: Optional sandbox name (auto-generated if not provided). timeout: Timeout in seconds when waiting for ready. Returns: Sandbox instance. Raises: ResourceTimeoutError: If timeout waiting for sandbox to be ready. SandboxCreationError: If sandbox creation fails. SandboxClientError: For other errors. )rrLr*T)create_sandbox _auto_delete)r3rrLr*sbs rsandboxSandboxClient.sandboxs0> '!   r!cURS3nUSUS.nU(aX%S'URRXEUS-S9nUR5 [R "UR 5USS9$![Ran[S U35UeS nAf[Ran[U5 eS nAff=f) a'Create a new Sandbox. The sandbox is NOT automatically deleted. Use delete_sandbox() for cleanup, or use sandbox() for automatic cleanup with a context manager. Args: template_name: Name of the SandboxTemplate to use. name: Optional sandbox name (auto-generated if not provided). timeout: Timeout in seconds when waiting for ready. Returns: Created Sandbox. Raises: ResourceTimeoutError: If timeout waiting for sandbox to be ready. SandboxCreationError: If sandbox creation fails. SandboxClientError: For other errors. /boxesT)rrNr*rLrOrPFclient auto_deleterRN) r.r2rSrTrrUrQr0rVr rWr)r3rrLr*rXrYrZr[s rrSandboxClient.create_sandboxs2 '+"#  "FO zzs'B,OH  % % '$$X]]_TuU U!! U(+H)LMST T$$  )! ,  s$AA33B>BB>- B99B>cURSU3nURRU5nUR5 [R "UR 5USS9$![Ran[SU35UeSnAf[Ra:nURRS:Xa[SUS3S S 9Ue[U5 eSnAff=f) zGet a Sandbox by name. The sandbox is NOT automatically deleted. Use delete_sandbox() for cleanup. Args: name: Sandbox name. Returns: Sandbox. Raises: ResourceNotFoundError: If sandbox not found. SandboxClientError: For other errors. /boxes/FrrRNr` Sandbox 'rbrrd)r.r2rfrTrrUrQr0rVr rWrZrgr r rhs r get_sandboxSandboxClient.get_sandboxs v. zz~~c*H  % % '$$X]]_TuU U!! U(+H)LMST T$$ zz%%,+v[1 %Q '   rkc URS3nURRU5nUR5 UR 5nURS/5Vs/sHn[ R "X@SS9PM sn$s snf![Ran[SU35UeSnAf[Ra;nURRS:Xa[SUS 35Ue[U5 eSnAff=f) z5List all Sandboxes. Returns: List of Sandboxes. r sandboxesFrrRNr`rnro)r.r2rfrTrQrrUr0rVr rWrZrgr r )r3rXrZrpcr[s rlist_sandboxesSandboxClient.list_sandboxess  ' zz~~c*H  % % '==?D+r22A!!!eD2 !! U(+H)LMST T$$ zz%%,%.se4:; %Q '  s6AB B?BBC<B**C<6C77C<cURSU3nSU0nURRX4S9nUR5 [R "UR 5USS9$![Ran[SU35UeSnAf[RacnURRS:Xa[S US 3S S 9UeURRS :Xa[SUS3S S 9Ue[U5 eSnAff=f)a)Update a sandbox's display name. Args: name: Current sandbox name. new_name: New display name. Returns: Updated Sandbox. Raises: ResourceNotFoundError: If sandbox not found. ResourceNameConflictError: If new_name is already in use. SandboxClientError: For other errors. rrLrFrrRNr`rrbrrdrvzSandbox name 'z' already in use)r.r2rrTrrUrQr0rVr rWrZrgr rr )r3rLr~rXrYrZr[s rupdate_sandboxSandboxClient.update_sandbox6s v.8$ zz''':H  % % '$$X]]_TuU U!! U(+H)LMST T$$ zz%%,+v[1zz%%,/$XJ.>?"+ %Q '  s%A A$$D8BDAC<<DctURSU3nURRU5nUR5 g![R an[ SU35UeSnAf[Ra>nURRS:Xa[SUS3SS9Ue[U5 SnAgSnAff=f) zDelete a Sandbox. Args: name: Sandbox name. Raises: ResourceNotFoundError: If sandbox not found. SandboxClientError: For other errors. rrRNr`rrbrrdrrhs rdelete_sandboxSandboxClient.delete_sandbox[s v. (zz((-H  % % '!! U(+H)LMST T$$ (zz%%,+v[1 %Q ' '  (r)r/r.r2)r) Optional[str]r*floatr+r)returnNone)rr')rDzOptional[type]rEzOptional[BaseException]rFz Optional[Any]rr)rLstrrMrr*intrr)rLrrr)rz list[Volume])rLrrr)rLrr~rrMrrr)rLrrrrrrrrrrzOptional[list[VolumeMountSpec]]rr)rLrrr)rzlist[SandboxTemplate])rLrr~rrr) rLrrrrrr*rrr)rLrrr)rz list[Pool])rLrr~rrz Optional[int]rr)rrrLrr*rrr)rLrrr)rz list[Sandbox])rLrr~rrr) __name__ __module__ __qualname____firstlineno____doc__r5r8r>rArGr\rirrr{rrrrrrrrrrrrrrrrr__static_attributes__r$r!rr'r'+sR.'+!% D$D D  D0 )   $ ***  *  *X:0(@#'" :: :  :  :J!%9=777  7  7777 7r:0#J(P 111 1  1 1f:8#'"& 88 8  8  8t(D# %% %  %  %V# ,, ,  ,  ,\>6#J(r!r')rr)rr)!r __future__rtypingrrr0 langsmithrrlangsmith.sandbox._exceptionsrrr r r r langsmith.sandbox._helpersr rrrrlangsmith.sandbox._modelsrrrrlangsmith.sandbox._sandboxrr r%r'r$r!rrsJK" 'UT..+ F (F (r!