=Ki!#SrSSKJr SSKJrJr SSKJrJrJ r J r SSK r SSK J r JrJr SSKJr SSKJr \(aSS KJr \"S S 55rg) z?Sandbox class for interacting with a specific sandbox instance.) annotations) dataclassfield) TYPE_CHECKINGAnyOptionalUnionN)DataplaneNotConfiguredErrorResourceNotFoundErrorSandboxConnectionError)handle_sandbox_http_error)ExecutionResult) SandboxClientcL\rSrSr%SrS\S'S\S'SrS\S'SrS\S 'SrS\S 'Sr S\S '\ "S SS 9r S\S'\ "S SS 9r S\S'\ SS Sjj5rS!SjrS"SjrS#SjrSSSSS.S$SjjrSS.S%SjjrSS.S&SjjrSrg)'Sandboxa3Represents an active sandbox for running commands and file operations. This class is typically obtained from SandboxClient.sandbox() and supports the context manager protocol for automatic cleanup. Attributes: name: Display name (can be updated). template_name: Name of the template used to create this sandbox. dataplane_url: URL for data plane operations (file I/O, command execution). id: Unique identifier (UUID). Remains constant even if name changes. May be None for resources created before ID support was added. created_at: Timestamp when the sandbox was created. updated_at: Timestamp when the sandbox was last updated. Example: with client.sandbox(template_name="python-sandbox") as sandbox: result = sandbox.run("python --version") print(result.stdout) strname template_nameN Optional[str] dataplane_urlid created_at updated_atF)reprdefaultr_clientTbool _auto_deletec U"URSS5URSS5URS5URS5URS5URS5UUS9$) zCreate a Sandbox from API response dict. Args: data: API response dictionary containing sandbox data. client: Parent SandboxClient for operations. auto_delete: Whether to delete the sandbox on context exit. Returns: Sandbox instance. rrrrrr)rrrrrrrr)get)clsdataclient auto_deletes \/var/www/html/dynamic-report/venv/lib/python3.13/site-packages/langsmith/sandbox/_sandbox.py from_dictSandbox.from_dict8sb"&"%((?B7((?3xx~xx -xx -$  cU$)zEnter context manager.selfs r' __enter__Sandbox.__enter__Ts r*cUR(a'URRUR5 gg![a gf=f)z6Exit context manager, optionally deleting the sandbox.N)rrdelete_sandboxr Exception)r.exc_typeexc_valexc_tbs r'__exit__Sandbox.__exit__XsA     ++DII6   s%: AAcnUR(d[SURS35eUR$)zValidate and return the dataplane URL. Returns: The dataplane URL. Raises: DataplaneNotConfiguredError: If dataplane_url is not configured. z Sandbox 'zW' does not have a dataplane_url configured. Runtime operations require a dataplane URL.)rr rr-s r'_require_dataplane_urlSandbox._require_dataplane_urlfs=!!-DII;'>> !!!r*<z /bin/bash)timeoutenvcwdshellcUR5nUS3nUUUS.nUbX8S'UbXHS'URRRXxUS-S9n U R 5 U R 5n [ U RSS 5U RS S 5U RS S 5S 9$![Ra!n [SURSU 35U eSn A f[Ran [U 5 eSn A ff=f)aExecute a command in the sandbox. Args: command: Shell command to execute. timeout: Command timeout in seconds. env: Environment variables to set for the command. cwd: Working directory for command execution. If None, uses sandbox default. shell: Shell to use for command execution. Defaults to "/bin/bash". Returns: ExecutionResult with stdout, stderr, and exit_code. Raises: DataplaneNotConfiguredError: If dataplane_url is not configured. SandboxOperationError: If command execution fails. SandboxConnectionError: If connection to sandbox fails. SandboxNotReadyError: If sandbox is not ready. SandboxClientError: For other errors. z/execute)commandr=r@Nr>r? )jsonr=stdoutr!stderr exit_code)rErFrGFailed to connect to sandbox '': )r:r_httppostraise_for_statusrDrr"httpx ConnectErrorr rHTTPStatusErrorr ) r.rBr=r>r?r@rurlpayloadresponser$es r'run Sandbox.runvs8335 x(#  ? EN ? EN ||))..s'TV,.WH  % % '==?D"xx"-xx"-((;3  !! (0 3qcB $$  %a (  s$BB--DCD4 DD)r=cUR5nUS3n[U[5(aURS5nSSU40nURR R USU0XcS9nUR5 g![Ra!n[SURSU35UeSnAf[Ran[U5 SnAgSnAff=f) aWrite content to a file in the sandbox. Args: path: Target file path in the sandbox. content: File content (str or bytes). timeout: Request timeout in seconds. Raises: DataplaneNotConfiguredError: If dataplane_url is not configured. SandboxOperationError: If file write fails. SandboxConnectionError: If connection to sandbox fails. SandboxNotReadyError: If sandbox is not ready. SandboxClientError: For other errors. z/uploadzutf-8filepath)paramsfilesr=rIrJN)r: isinstancerencoderrKrLrMrNrOr rrPr ) r.rYcontentr=rrQr[rSrTs r'write Sandbox.writes*335 w' gs # #nnW-G&'*+ )||))..VTN%/H  % % '!! (0 3qcB $$ ) %a ( ( )s$7A;;CB++C CCcUR5nUS3nURRRUSU0US9nUR 5 UR $![ Ra!n[SURSU35UeSnAf[ RaGnURRS:Xa[SUS URS 3S S 9Ue[U5 eSnAff=f) aJRead a file from the sandbox. Args: path: File path to read. Supports both absolute paths (e.g., /tmp/file.txt) and relative paths (resolved from /home/user/). timeout: Request timeout in seconds. Returns: File contents as bytes. Raises: DataplaneNotConfiguredError: If dataplane_url is not configured. ResourceNotFoundError: If the file doesn't exist. SandboxOperationError: If file read fails. SandboxConnectionError: If connection to sandbox fails. SandboxNotReadyError: If sandbox is not ready. SandboxClientError: For other errors. z /downloadrY)rZr=rIrJNizFile 'z' not found in sandbox ''rX) resource_type)r:rrKr"rMr^rNrOr rrPrS status_coder r )r.rYr=rrQrSrTs r'read Sandbox.reads&335 y) ||))--VTNG.H  % % '## #!! (0 3qcB $$ zz%%,+TF":499+QG"( &a (  s%AAC(.B  C(!AC##C(r,)T)r$zdict[str, Any]r%rr&rreturnr)rgr)r4zOptional[type]r5zOptional[BaseException]r6z Optional[Any]rgNone)rgr) rBrr=intr>zOptional[dict[str, str]]r?rr@rrgr)rYrr^zUnion[str, bytes]r=rirgrh)rYrr=rirgbytes)__name__ __module__ __qualname____firstlineno____doc____annotations__rrrrrrr classmethodr(r/r7r:rUr_re__static_attributes__r,r*r'rrs`* I#'M='B  $J $ $J $#trzsLE"(66  A57 kk kr*