Spaces:
Paused
Paused
File size: 2,933 Bytes
9792ea7 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 | # -*- coding: utf-8 -*-
"""Host-side helpers shared by workspace implementations.
Constants for the standard workspace layout, plus pure functions for
detecting the local ``agentscope`` version and reading scripts bundled
with the package. No Docker / E2B SDK dependency lives here.
This module is internal to ``agentscope.workspace``. Public-sounding
constants are shared within the package, not exported as user-facing
API.
"""
import importlib.resources as _res
# ── shared constants ───────────────────────────────────────────────
#: Standard workspace-relative directory for offloaded multimodal data.
DEFAULT_DATA_DIR = "data"
#: Standard workspace-relative directory for reusable skills.
DEFAULT_SKILLS_DIR = "skills"
#: Standard workspace-relative directory for session context and results.
DEFAULT_SESSIONS_DIR = "sessions"
#: Standard workspace-relative file for persisted MCP registrations.
DEFAULT_MCP_FILE = ".mcp"
DEFAULT_GATEWAY_VENV = ".venv"
DEFAULT_GATEWAY_LOG = "gateway.log"
DEFAULT_GATEWAY_SCRIPT = "_mcp_gateway_app.py"
DEFAULT_GLOB_HELPER_SCRIPT = "_glob_helper.py"
#: Minimum Python packages the gateway script needs at runtime.
#: Both Docker (image build) and E2B (sandbox bootstrap) install this
#: same tuple into the gateway venv before adding ``agentscope`` itself.
_GATEWAY_BASE_REQUIREMENTS: tuple[str, ...] = (
"mcp",
"uvicorn",
"fastapi",
)
# ── gateway script ─────────────────────────────────────────────────
def _read_gateway_script_bytes() -> bytes:
"""Read the standalone gateway script as bytes via ``importlib.resources``.
The script ships at
``agentscope/workspace/_mcp_gateway/_mcp_gateway_app.py``. Both
backends copy it to a fixed in-container / in-sandbox path so the
launch command can invoke it directly, avoiding ``python -m`` and
the heavy ``agentscope.workspace.__init__`` import graph.
"""
return (
_res.files("agentscope.workspace._mcp_gateway")
.joinpath("_mcp_gateway_app.py")
.read_bytes()
)
# ── builtin tool helper scripts ───────────────────────────────────
def _read_glob_helper_bytes() -> bytes:
"""Read the standalone glob helper script as bytes.
The script ships at
``agentscope/tool/_builtin/_scripts/_glob_helper.py``. Both Docker
and E2B backends copy it into the workspace so the :class:`Glob`
tool can invoke it uniformly via ``exec_shell``.
Returns:
`bytes`:
The raw contents of the ``_glob_helper.py`` script.
"""
return (
_res.files("agentscope.tool._builtin._scripts")
.joinpath("_glob_helper.py")
.read_bytes()
)
|