=Ki{SrSSKJr SSKrSSKJrJr SSKrSSKJ r SSK J r SSK JrJrJrJrJrJr SSKJrJrJrJrJr SS KJrJrJrJr SS jrSS jr "S S 5r!g)zFAsync SandboxClient class for interacting with the sandbox server API.) annotationsN)AnyOptional)utils) AsyncSandbox)ResourceInUseErrorResourceNameConflictErrorResourceNotFoundErrorSandboxAPIErrorSandboxConnectionErrorValidationError)handle_client_http_errorhandle_pool_errorhandle_sandbox_creation_errorhandle_volume_creation_errorparse_error_response)PoolSandboxTemplateVolumeVolumeMountSpeccT[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 a/var/www/html/dynamic-report/venv/lib/python3.13/site-packages/langsmith/sandbox/_async_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)?AsyncSandboxClient,aAsync client for interacting with the Sandbox Server API. This client provides an async interface for managing sandboxes and templates. Example: # Uses LANGSMITH_ENDPOINT and LANGSMITH_API_KEY from environment async with AsyncSandboxClient() as client: # Create a sandbox and run commands async with await client.sandbox(template_name="python-sandbox") as sandbox: result = await sandbox.run("python --version") print(result.stdout) Ng$@) api_endpointtimeoutapi_keycU=(d [5RS5UlU=(d [5nX@l0nU(aXES'[ R "X%S9Ulg)a]Initialize the AsyncSandboxClient. 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_keyhttpx AsyncClient_http)selfr)r*r+resolved_api_keyr-s r__init__AsyncSandboxClient.__init__:sU 'E*C*EMMcR"<&:&<( "$ #3K &&wH r!cT# URR5IShvN gN7f)zClose the async HTTP client.N)r2acloser3s rr8AsyncSandboxClient.acloseRsjj!!!s (&(cURR(dL[R"5nUR5(d UR UR 55 ggg![ a gf=f![a gf=f)aBest-effort cleanup of the async HTTP client on garbage collection. If an event loop is running, schedules ``aclose()`` as a task. Otherwise the underlying sockets will be closed by the GC. For deterministic cleanup, use ``async with`` or ``await aclose()``. N)r2 is_closedasyncioget_running_loop create_taskr8 RuntimeError Exception)r3loops r__del__AsyncSandboxClient.__del__Vsw ::''"335D>>++((7,( $   s/A:A A** A74A:6A77A:: BBc# U$7f)zEnter async context manager.r$r9s r __aenter__AsyncSandboxClient.__aenter__hs  sc@# UR5IShvN gN7f)zExit async context manager.N)r8)r3exc_typeexc_valexc_tbs r __aexit__AsyncSandboxClient.__aexit__lskkms <)r*c# URS3nUUSUS.nURRXEUS-S9IShvN nUR5 [R "UR 55$N8![Ran[SU35UeSnAf[Ran[U5 eSnAff=f7f)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*NFailed to connect to server: ) r.r2postraise_for_statusr from_dictrVr0 ConnectErrorr HTTPStatusErrorr)r3rQrRr*urlpayloadresponsees r create_volume AsyncSandboxClient.create_volumeys0 )"   !ZZ__SRT _UUH  % % '##HMMO4 4V!! U(+H)LMST T$$  ( +  sDC A5A37A52C3A55C BC/ B;;CCc# URSU3nURRU5IShvN nUR5 [R "UR 55$N8![Ran[SU35UeSnAf[Ra:nURRS:Xa[SUS3SS9Ue[U5 eSnAff=f7f) zGet a volume by name. Args: name: Volume name. Returns: Volume. Raises: ResourceNotFoundError: If volume not found. SandboxClientError: For other errors. /volumes/NrWVolume ' ' not foundvolume resource_type)r.r2getrYrrZrVr0r[r r\r_ status_coder rr3rQr]r_r`s r get_volumeAsyncSandboxClient.get_volumes $0 !ZZ^^C00H  % % '##HMMO4 41!! U(+H)LMST T$$ zz%%,+tfK0 %Q '   DC%A.A,7A.+C%,A..C"BC"(5CC""C%c# URS3nURRU5IShvN nUR5 UR 5nURS/5Vs/sHn[ R "U5PM sn$N[s snf![Ran[SU35UeSnAf[Ra;nURRS:Xa[SUS35Ue[U5 eSnAff=f7f)z1List all volumes. Returns: List of Volumes. rPNvolumesrWreAPI endpoint not found: %. Check that api_endpoint is correct.)r.r2rkrYrVrrZr0r[r r\r_rlr r)r3r]r_datavr`s r list_volumesAsyncSandboxClient.list_volumess  ) !ZZ^^C00H  % % '==?D15)R1HI1HAF$$Q'1HI I1J!! U(+H)LMST T$$ zz%%,%.se4:; %Q '  VD BB 8B* B B D  BBD (B77D 6DD  D c# URSU3nURRU5IShvN nUR5 gN![R an[ SU35UeSnAf[RaqnURRS:Xa[SUS3SS9UeURRS :Xa[U5n[US SS9Ue[U5 SnAgSnAff=f7f) zDelete a volume. Args: name: Volume name. Raises: ResourceNotFoundError: If volume not found. ResourceInUseError: If volume is referenced by templates. SandboxClientError: For other errors. rdNrWrerfrgrhrimessager.r2deleterYr0r[r r\r_rlr rrrr3rQr]r_r`rus r delete_volume AsyncSandboxClient.delete_volumes $0 (!ZZ..s33H  % % '4!! U(+H)LMST T$$ (zz%%,+tfK0zz%%,+A.(iQWXX $Q ' ' (KC9A A A C9 A C6A..C6A'C1,C91C66C9)new_namerRc# URSU3n0nUbX%S'UbX5S'U(dURU5IShvN $URRXES9IShvN nUR 5 [ R "UR55$NZN:![Ran[SU35UeSnAf[RanURRS:Xa[SUS 3S S 9UeURRS :Xa[U5n[!US SS9UeURRS:Xa[U5n[#US S S 9Ue[%U5 eSnAff=f7f)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. rdNrQrRrVrWrerfrgrhriir| VolumeResize) error_typer{)r.rnr2patchrYrrZrVr0r[r r\r_rlr rr r r) r3rQrrRr]r^r_r`rus r update_volume AsyncSandboxClient.update_volumes~6 $0"$  &FO  "FO.. . !ZZ--c-@@H  % % '##HMMO4 4 /A!! U(+H)LMST T$$ zz%%,+tfK0zz%%,+A.%d9o.QWXXzz%%,+A./O8 %Q '  sS=E;BE;B!B"7BE;BE82CE8BE33E88E;500m512Mi)cpumemorystorage volume_mountsc# URS3nUUUUS.S.nU(aXXSS'U(a-UV s/sHn U RU RS.PM sn US'URR XxS9IS hvN n U R 5 [ R"U R55$s sn fN=![Ran [S U 35U eS n A f[Ran [U 5 eS n A ff=f7f) 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)rQimage resourcesrr) volume_name mount_pathrrNrW)r.rrr2rXrYrrZrVr0r[r r\r) r3rQrrrrrr]r^vmr_r`s rcreate_template"AsyncSandboxClient.create_template6s : + #  .5K  + (('B!#bmmL'(GO $  !ZZ__S_??H  % % '",,X]]_= =( @!! U(+H)LMST T$$  $Q '  sR2D#B3DB::B8;7B:2D8B::DCD4 DDDc# URSU3nURRU5IShvN nUR5 [R "UR 55$N8![Ran[SU35UeSnAf[Ra:nURRS:Xa[SUS3SS9Ue[U5 eSnAff=f7f) zGet a SandboxTemplate by name. Args: name: Template name. Returns: SandboxTemplate. Raises: ResourceNotFoundError: If template not found. SandboxClientError: For other errors. /templates/NrWre Template 'rgtemplateri)r.r2rkrYrrZrVr0r[r r\r_rlr rrms r get_templateAsyncSandboxClient.get_templateos D62 !ZZ^^C00H  % % '",,X]]_= =1!! U(+H)LMST T$$ zz%%,+ k2* %Q '   rpc# URS3nURRU5IShvN nUR5 UR 5nURS/5Vs/sHn[ R "U5PM sn$N[s snf![Ran[SU35UeSnAf[Ra;nURRS:Xa[SUS35Ue[U5 eSnAff=f7f)zCList all SandboxTemplates. Returns: List of SandboxTemplates. rN templatesrWrersrt)r.r2rkrYrVrrZr0r[r r\r_rlr r)r3r]r_rutr`s rlist_templates!AsyncSandboxClient.list_templatess  + !ZZ^^C00H  % % '==?D:>((;PR:ST:SQO--a0:ST T1U!! U(+H)LMST T$$ zz%%,%.se4:; %Q '  ryc8# URSU3nSU0nURRX4S9IShvN nUR5 [R "UR 55$N8![Ran[SU35UeSnAf[RamnURRS:Xa[SUS3S S 9UeURRS :Xa[U5n[US S S 9Ue[!U5 eSnAff=f7f) 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. rrQrNrWrerrgrrir{r|)r.r2rrYrrZrVr0r[r r\r_rlr rr r)r3rQrr]r^r_r`rus rupdate_template"AsyncSandboxClient.update_templates D628$ !ZZ--c-@@H  % % '",,X]]_= =A!! U(+H)LMST T$$ zz%%,+ k2*zz%%,+A./O: %Q '  sEDA0A.7A0-D.A00DBD*A(DDDc# URSU3nURRU5IShvN nUR5 gN![R an[ SU35UeSnAf[RaqnURRS:Xa[SUS3SS9UeURRS :Xa[U5n[US SS9Ue[U5 SnAgSnAff=f7f) 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. rNrWrerrgrrir{r|r}rs rdelete_template"AsyncSandboxClient.delete_templates D62 (!ZZ..s33H  % % '4!! U(+H)LMST T$$ (zz%%,+ k2*zz%%,+A.(O: %Q ' ' (rrTc# URS3nUUUSUS.nUS-nURRXVUS9IShvN nUR5 [R "UR 55$N8![Ran [SU 35U eSn A f[Ran [U 5 eSn A ff=f7f)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)rQ template_namereplicasrSr*rTrUNrW) r.r2rXrYrrZrVr0r[r r\r) r3rQrrr*r]r^ http_timeoutr_r`s r create_poolAsyncSandboxClient.create_pools: '* " #  "R>(--/2 2V!! U(+H)LMST T$$  a  sDC"A8A67A85C6A88C BC2 B>>CCc# URSU3nURRU5IShvN nUR5 [R "UR 55$N8![Ran[SU35UeSnAf[Ra:nURRS:Xa[SUS3SS9Ue[U5 eSnAff=f7f) zGet a Pool by name. Args: name: Pool name. Returns: Pool. Raises: ResourceNotFoundError: If pool not found. SandboxClientError: For other errors. /pools/NrWrePool 'rgpoolri)r.r2rkrYrrZrVr0r[r r\r_rlr rrms rget_poolAsyncSandboxClient.get_pools v. !ZZ^^C00H  % % '>>(--/2 21!! U(+H)LMST T$$ zz%%,+TF+.f %Q '   rpc# URS3nURRU5IShvN nUR5 UR 5nURS/5Vs/sHn[ R "U5PM sn$N[s snf![Ran[SU35UeSnAf[Ra;nURRS:Xa[SUS35Ue[U5 eSnAff=f7f)z-List all Pools. Returns: List of Pools. rNpoolsrWrersrt)r.r2rkrYrVrrZr0r[r r\r_rlr r)r3r]r_rupr`s r list_poolsAsyncSandboxClient.list_pools;s  ' !ZZ^^C00H  % % '==?D/3xx/DE/D!DNN1%/DE E1F!! U(+H)LMST T$$ zz%%,%.se4:; %Q '  ry)rrc# URSU3n0nUbX%S'UbX5S'U(dURU5IShvN $URRXES9IShvN nUR 5 [ R "UR55$NZN:![Ran[SU35UeSnAf[RamnURRS:Xa[SUS 3S S 9UeURRS :Xa[U5n[!US S S 9Ue[#U5 eSnAff=f7f)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. rNrQrrrWrerrgrrir{r|)r.rr2rrYrrZrVr0r[r r\r_rlr rr r) r3rQrrr]r^r_r`rus r update_poolAsyncSandboxClient.update_poolSsM6 v."$  &FO  "*J t,, , !ZZ--c-@@H  % % '>>(--/2 2 -A!! U(+H)LMST T$$ zz%%,+TF+.fzz%%,+A./O6 a  sS=EBEB!B"7BEBE2CEA(EEEc# URSU3nURRU5IShvN nUR5 gN![R an[ SU35UeSnAf[Ra>nURRS:Xa[SUS3SS9Ue[U5 SnAgSnAff=f7f) 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. rNrWrerrgrri r.r2r~rYr0r[r r\r_rlr rrms r delete_poolAsyncSandboxClient.delete_pools v. (!ZZ..s33H  % % '4!! U(+H)LMST T$$ (zz%%,+TF+.f %Q ' '  (JCA A A C A CA..C4B>9C>CC)rQr*cR# URUUUS9IShvN nSUlU$N 7f)a<Create a sandbox and return an AsyncSandbox instance. This is the primary method for creating sandboxes. Use it as an async context manager for automatic cleanup: async with await client.sandbox(template_name="my-template") as sandbox: result = await 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: AsyncSandbox instance. Raises: ResourceTimeoutError: If timeout waiting for sandbox to be ready. SandboxCreationError: If sandbox creation fails. SandboxClientError: For other errors. )rrQr*NT)create_sandbox _auto_delete)r3rrQr*sbs rsandboxAsyncSandboxClient.sandboxs=>&&''     s '%'c# URS3nUSUS.nU(aX%S'URRXEUS-S9IShvN nUR5 [R "UR 5USS 9$N8![Ran[S U35UeSnAf[Ran[U5 eSnAff=f7f) 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 AsyncSandbox. Raises: ResourceTimeoutError: If timeout waiting for sandbox to be ready. SandboxCreationError: If sandbox creation fails. SandboxClientError: For other errors. /boxesT)rrSr*rQrTrUNFclient auto_deleterW) r.r2rXrYrrZrVr0r[r r\r)r3rrQr*r]r^r_r`s rr!AsyncSandboxClient.create_sandboxs2 '+"#  "FO !ZZ__SRT _UUH  % % ')) % V !! U(+H)LMST T$$  )! ,  sF!C  A?A=7A?<C =A??C B""C 9 CC  C c# URSU3nURRU5IShvN nUR5 [R "UR 5USS9$N8![Ran[SU35UeSnAf[Ra:nURRS:Xa[SUS3S S 9Ue[U5 eSnAff=f7f) aGet a Sandbox by name. The sandbox is NOT automatically deleted. Use delete_sandbox() for cleanup. Args: name: Sandbox name. Returns: AsyncSandbox. Raises: ResourceNotFoundError: If sandbox not found. SandboxClientError: For other errors. /boxes/NFrrWre Sandbox 'rgrri)r.r2rkrYrrZrVr0r[r r\r_rlr rrms r get_sandboxAsyncSandboxClient.get_sandboxs v. !ZZ^^C00H  % % ')) % 1 !! U(+H)LMST T$$ zz%%,+v[1 %Q '   rpc # URS3nURRU5IShvN nUR5 UR 5nURS/5Vs/sHn[ R "X@SS9PM sn$NZs snf![Ran[SU35UeSnAf[Ra;nURRS:Xa[SUS 35Ue[U5 eSnAff=f7f) z:List all Sandboxes. Returns: List of AsyncSandboxes. rN sandboxesFrrWrersrt)r.r2rkrYrVrrZr0r[r r\r_rlr r)r3r]r_rucr`s rlist_sandboxes!AsyncSandboxClient.list_sandboxes#s   ' !ZZ^^C00H  % % '==?D+r22A&&q5I2 1!! U(+H)LMST T$$ zz%%,%.se4:; %Q '  sVD BB 8B*B B D  BBD'B66D 6DDD c$# URSU3nSU0nURRX4S9IShvN nUR5 [R "UR 5USS9$N8![Ran[SU35UeSnAf[RacnURRS:Xa[S US 3S S 9UeURRS :Xa[SUS3S S 9Ue[U5 eSnAff=f7f)a.Update a sandbox's display name. Args: name: Current sandbox name. new_name: New display name. Returns: Updated AsyncSandbox. Raises: ResourceNotFoundError: If sandbox not found. ResourceNameConflictError: If new_name is already in use. SandboxClientError: For other errors. rrQrNFrrWrerrgrrir{zSandbox name 'z' already in use)r.r2rrYrrZrVr0r[r r\r_rlr r r)r3rQrr]r^r_r`s rupdate_sandbox!AsyncSandboxClient.update_sandbox>s' v.8$ !ZZ--c-@@H  % % ')) % A !! U(+H)LMST T$$ zz%%,+v[1zz%%,/$XJ.>?"+ %Q '  sEDA0A.7A0-D.A00D BD *ADD  Dc# URSU3nURRU5IShvN nUR5 gN![R an[ SU35UeSnAf[Ra>nURRS:Xa[SUS3SS9Ue[U5 SnAgSnAff=f7f) zDelete a Sandbox. Args: name: Sandbox name. Raises: ResourceNotFoundError: If sandbox not found. SandboxClientError: For other errors. rNrWrerrgrrirrms rdelete_sandbox!AsyncSandboxClient.delete_sandboxes v. (!ZZ..s33H  % % '4!! U(+H)LMST T$$ (zz%%,+v[1 %Q ' '  (r)r/r.r2)r) Optional[str]r*floatr+r)returnNone)rr')rIzOptional[type]rJzOptional[BaseException]rKz Optional[Any]rr)rQstrrRrr*intrr)rQrrr)rz list[Volume])rQrrr)rQrrrrRrrr)rQrrrrrrrrrrzOptional[list[VolumeMountSpec]]rr)rQrrr)rzlist[SandboxTemplate])rQrrrrr) rQrrrrrr*rrr)rQrrr)rz list[Pool])rQrrrrz Optional[int]rr)rrrQrr*rrr)rQrrr)rzlist[AsyncSandbox])rQrrrrr) __name__ __module__ __qualname____firstlineno____doc__r5r8rCrFrLrarnrwrrrrrrrrrrrrrrrrrr__static_attributes__r$r!rr'r',sS  '+!% I$I I  I0"$ )   $ ***  *  *X:0(@#'" :: :  :  :J!%9=777  7  7777 7r:0#J(P 111 1  1 1f:8#'"& 88 8  8  8t(D# %% %  %  %V# .. .  .  .`B6%N(r!r')rr)rr)"r __future__rr=typingrrr0 langsmithrr langsmith.sandbox._async_sandboxrlangsmith.sandbox._exceptionsrr r r r r langsmith.sandbox._helpersrrrrrlangsmith.sandbox._modelsrrrrr r%r'r$r!rrsML" '9UT.+ O (O (r!