Ë b‡„i!#ãóž—dZddlmZddlmZmZddlmZmZm Z m Z ddl Z ddl m Z mZmZddlmZddlmZerdd lmZeGd „d ««Zy) z?Sandbox class for interacting with a specific sandbox instance.é)Ú annotations)Ú dataclassÚfield)Ú TYPE_CHECKINGÚAnyÚOptionalÚUnionN)ÚDataplaneNotConfiguredErrorÚResourceNotFoundErrorÚSandboxConnectionError)Úhandle_sandbox_http_error)ÚExecutionResult)Ú SandboxClientcó:—eZdZUdZded<ded<dZded<dZded<dZded <dZded <e d d¬ «Z d ed<e d d¬ «Z ded<e d dd„«Z dd„Z d d„Zd!d„Zdddddœ d"d„Zddœ d#d„Zddœd$d„Zy)%ÚSandboxaoRepresents 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) ÚstrÚnameÚ template_nameNú Optional[str]Ú dataplane_urlÚidÚ created_atÚ updated_atF)ÚreprÚdefaultrÚ_clientTÚboolÚ _auto_deletec óÚ—||jdd«|jdd«|jd«|jd«|jd«|jd«||¬«S) a4Create 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. rÚrrrrr)rrrrrrrr)Úget)ÚclsÚdataÚclientÚ auto_deletes úd/home/obispo/Crisostomo_bridge/mision_env/lib/python3.12/site-packages/langsmith/sandbox/_sandbox.pyÚ from_dictzSandbox.from_dict8sb€ñ"Ø—‘˜& "Ó%ØŸ(™( ?°BÓ7ØŸ(™( ?Ó3Øx‰x˜‹~Ø—x‘x  Ó-Ø—x‘x  Ó-ØØ$ô  ð ócó—|S)zEnter context manager.©©Úselfs r&Ú __enter__zSandbox.__enter__Ts€àˆ r(cóˆ—|jr' |jj|j«yy#t$rYywxYw)z6Exit context manager, optionally deleting the sandbox.N)rrÚdelete_sandboxrÚ Exception)r,Úexc_typeÚexc_valÚexc_tbs r&Ú__exit__zSandbox.__exit__XsA€ð × Ò ð Ø— ‘ ×+Ñ+¨D¯I©IÕ6ð øôò áð úsŽ%5µ AÁAcód—|jstd|j›d«‚|jS)z¾Validate 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_urlzSandbox._require_dataplane_urlfs=€ð×!Ò!Ü-ؘDŸI™I˜;ð'>ð>óð ð×!Ñ!Ð!r(é<z /bin/bash)ÚtimeoutÚenvÚcwdÚshellcó—|j«}|›d}|||dœ}|||d<|||d< |jjj|||dz¬«} | j «| j «} t | jdd «| jd d «| jd d «¬ «S#tj$r!} td|j›d| ›«| ‚d} ~ wtj$r} t| «‚d} ~ wwxYw)a!Execute 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)Úcommandr8r;Nr9r:é )Újsonr8Ústdoutr ÚstderrÚ exit_codeéÿÿÿÿ)r@rArBúFailed to connect to sandbox 'ú': )r6rÚ_httpÚpostÚraise_for_statusr?rr!ÚhttpxÚ ConnectErrorr rÚHTTPStatusErrorr ) r,r=r8r9r:r;rÚurlÚpayloadÚresponser#Úes r&Úrunz Sandbox.runvs€ð8×3Ñ3Ó5ˆ ؘxÐ(ˆàØØñ# ˆð ˆ?Ø ˆGE‰NØ ˆ?Ø ˆGE‰Nð Ø—|‘|×)Ñ)×.Ñ.¨s¸È'ÐTVÉ,Ð.ÓWˆHØ × %Ñ %Ô 'Ø—=‘=“?ˆDÜ"Ø—x‘x ¨"Ó-Ø—x‘x ¨"Ó-ØŸ(™( ;°Ó3ôð øô ×!Ñ!ò Ü(Ø0°·±° ¸3¸q¸cÐBóàð ûô×$Ñ$ò Ü % aÔ (à ûð ús$«BB4Â4D ÃC#Ã#D Ã9 DÄD )r8có®—|j«}|›d}t|t«r|jd«}dd|fi} |jj j |d|i||¬«}|j«y#tj$r!}td|j›d|›«|‚d}~wtj$r}t|«Yd}~yd}~wwxYw) 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-8ÚfileÚpath)ÚparamsÚfilesr8rDrEN)r6Ú isinstancerÚencoderrFrGrHrIrJr rrKr ) r,rSÚcontentr8rrLrUrNrOs r&Úwritez Sandbox.write°sÜ€ð*×3Ñ3Ó5ˆ ؘwÐ'ˆô gœsÔ #Ø—n‘n WÓ-ˆGà˜& 'Ð*Ð+ˆð )Ø—|‘|×)Ñ)×.Ñ.ؘV T˜N°%Àð/óˆHð × %Ñ %Õ 'øÜ×!Ñ!ò Ü(Ø0°·±° ¸3¸q¸cÐBóàð ûô×$Ñ$ò )Ü % a× (Ñ (ûð )ús#¾;A:Á:C B)Â)CÂ? CÃCcóÜ—|j«}|›d} |jjj|d|i|¬«}|j «|j S#t j$r!}td|j›d|›«|‚d}~wt j$rI}|jjdk(rtd|›d |j›d d ¬ «|‚t|«‚d}~wwxYw) aºRead 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 /downloadrS)rTr8rDrENi”zFile 'z' not found in sandbox 'ú'rR)Ú resource_type)r6rrFr!rHrXrIrJr rrKrNÚ status_coder r )r,rSr8rrLrNrOs r&Úreadz Sandbox.readÚsý€ð&×3Ñ3Ó5ˆ ؘyÐ)ˆð Ø—|‘|×)Ñ)×-Ñ-ؘV T˜N°Gð.óˆHð × %Ñ %Ô 'Ø×#Ñ#Ð #øÜ×!Ñ!ò Ü(Ø0°·±° ¸3¸q¸cÐBóàð ûô×$Ñ$ò Øz‰z×%Ñ%¨Ò,Ü+ؘT˜FÐ":¸4¿9¹9¸+ÀQÐGØ"(ôððô & aÔ (à ûð ús%—AAÁC+Á0B  C+Â"AC&Ã&C+)T)r#zdict[str, Any]r$rr%rÚreturnr)r_r)r1zOptional[type]r2zOptional[BaseException]r3z Optional[Any]r_ÚNone)r_r) r=rr8Úintr9zOptional[dict[str, str]]r:rr;rr_r)rSrrXzUnion[str, bytes]r8rar_r`)rSrr8rar_Úbytes)Ú__name__Ú __module__Ú __qualname__Ú__doc__Ú__annotations__rrrrrrrÚ classmethodr'r-r4r6rPrYr^r*r(r&rrs[…ñð* ƒIØÓØ#'€M=Ó'Ø€Bˆ ÓØ $€J Ó$Ø $€J Ó$ñ#¨°tÔ<€Gˆ]Ó<Ù E°4Ô8€L$Ó8àð !ð  àð ðð ðð  ð ò  óð ó6ð à ð ð)ð ðð ð ó ó"ð(Ø(,Ø!Ø ñ8àð8ðð 8ð &ð 8ð ð 8ðð8ð ó8ð~ñ ()àð()ð#ð()ð ð ()ð ó ()ðT13ö(r(r)rfÚ __future__rÚ dataclassesrrÚtypingrrrr rIÚlangsmith.sandbox._exceptionsr r r Úlangsmith.sandbox._helpersr Úlangsmith.sandbox._modelsrÚlangsmith.sandbox._clientrrr*r(r&úrpsLðÙEå"ç(ß6Ó6ã ÷ñõ AÝ5áÝ7ð ÷kðkó ñkr(