b60439152b
- harness/es.py: append-only event store + проекции (образец — кооп-портал) - harness/levels.py: уровни 1с/1м/1ч/1д, контекст ∝ масштабу - harness/scheduler.py: уровневые потоки, идемпотентные тики, absorbed-стабы - harness/isolated_runner.py + _llm_worker.py: LLM-тик в сабпроцессе (глобальный asyncio-рантайм Strands не переживает 2+ create_harness) - cli.py: init/task/tasks/status/events + requeue (написан самим минутным агентом) - 9router: отдельный ключ sk-simbiot, модель auto (glm-5.3 первым)
47 lines
1.8 KiB
Python
47 lines
1.8 KiB
Python
"""Sandbox abstraction for agent code-execution environments.
|
|
|
|
A :class:`Sandbox` provides the runtime context where tools execute code, run
|
|
commands, and interact with a filesystem. This module ports the sandbox
|
|
interface from ``strands-ts/src/sandbox/`` (the behavioral oracle):
|
|
|
|
- :class:`Sandbox` — the abstract base with streaming primitives and
|
|
non-streaming/text convenience wrappers.
|
|
- :class:`PosixShellSandbox` — an abstract sandbox that implements file and code
|
|
operations via shell commands; subclasses implement only
|
|
:meth:`~strands.sandbox.base.Sandbox.execute_streaming`.
|
|
- Data types: :class:`StreamChunk`, :class:`FileInfo`, :class:`OutputFile`,
|
|
:class:`ExecutionResult`, and the :data:`StreamType` literal.
|
|
- :data:`LANGUAGE_PATTERN` — interpreter-name validation pattern.
|
|
|
|
Concrete sandboxes:
|
|
|
|
- :class:`DockerSandbox` — run commands in a Docker container via ``docker exec``.
|
|
- :class:`SshSandbox` — run commands on a remote host via OpenSSH.
|
|
The sandbox error types (:class:`SandboxTimeoutError`, :class:`SandboxPathNotFoundError`)
|
|
are re-exported from the top-level ``strands`` package, as in the TS oracle.
|
|
|
|
Example:
|
|
A minimal shell-backed sandbox needs only ``execute_streaming``::
|
|
|
|
from strands.sandbox import PosixShellSandbox
|
|
|
|
class MyShellSandbox(PosixShellSandbox):
|
|
async def execute_streaming(self, command, *, timeout=None, cwd=None, env=None, **kwargs):
|
|
... # spawn a process, yield StreamChunk(s), then an ExecutionResult
|
|
"""
|
|
|
|
from .base import Sandbox
|
|
from .constants import LANGUAGE_PATTERN
|
|
from .posix_shell import PosixShellSandbox
|
|
from .types import ExecutionResult, FileInfo, OutputFile, StreamChunk, StreamType
|
|
|
|
__all__ = [
|
|
"ExecutionResult",
|
|
"FileInfo",
|
|
"LANGUAGE_PATTERN",
|
|
"OutputFile",
|
|
"PosixShellSandbox",
|
|
"Sandbox",
|
|
"StreamChunk",
|
|
"StreamType",
|
|
]
|