agent-workspace 2026.6.15a4__tar.gz

agent_workspace-2026.6.15a4/PKG-INFO

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: agent-workspace
+Version: 2026.6.15a4
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Summary: Restricted file-operation workspace for AI agents (Python bindings over the Rust core)
+Keywords: agent,workspace,mcp,filesystem
+License: Apache-2.0
+Requires-Python: >=3.9
+Project-URL: Repository, https://github.com/dropxhq/agent-workspace

agent_workspace-2026.6.15a4/agent_workspace/__init__.py

@@ -0,0 +1,46 @@
+"""agent-workspace: restricted file-operation workspace for AI agents.
+
+Native bindings over the Rust core. All paths are workspace-relative and
+cannot escape the configured workspace root.
+
+Example
+-------
+>>> import agent_workspace as ws
+>>> ws.init("./my-workspace")              # writes config.yaml + data/
+>>> w = ws.Workspace("./my-workspace/config.yaml")
+>>> w.write("docs/a.txt", "hello\\n", created_by="me", desc="demo")
+>>> w.read("docs/a.txt")
+'hello\\n'
+>>> report = w.list()
+>>> report.file_count
+1
+>>> w.remove("docs/a.txt")
+"""
+
+from ._agent_workspace import (
+    FileMeta,
+    InvalidPathError,
+    InvalidRangesError,
+    ListReport,
+    LockConflictError,
+    NotFoundError,
+    PathEscapeError,
+    Workspace,
+    WorkspaceError,
+    __version__,
+    init,
+)
+
+__all__ = [
+    "Workspace",
+    "ListReport",
+    "FileMeta",
+    "init",
+    "WorkspaceError",
+    "InvalidPathError",
+    "PathEscapeError",
+    "NotFoundError",
+    "LockConflictError",
+    "InvalidRangesError",
+    "__version__",
+]

agent_workspace-2026.6.15a4/agent_workspace/_agent_workspace.pyi

@@ -0,0 +1,80 @@
+from typing import Optional
+
+__version__: str
+
+class FileMeta:
+    """Metadata for a single workspace file."""
+
+    relative_path: str
+    created_by: str
+    desc: str
+    created_at: str  # RFC 3339 timestamp
+    updated_at: str  # RFC 3339 timestamp
+    size_bytes: int
+    sha256: Optional[str]
+
+class ListReport:
+    """Result of :meth:`Workspace.list`."""
+
+    scope: Optional[str]
+    file_count: int
+    total_size_bytes: int
+    files: list[FileMeta]
+
+class Workspace:
+    """A handle to a workspace backend, scoped to an optional user/session.
+
+    All paths are workspace-relative and cannot escape the workspace root.
+    """
+
+    config_path: str
+
+    def __init__(
+        self,
+        config_path: Optional[str] = ...,
+        *,
+        user_id: Optional[str] = ...,
+        session_id: Optional[str] = ...,
+    ) -> None:
+        """Open a workspace.
+
+        :param config_path: path to ``config.yaml``. If ``None``, resolves via
+            ``AGENT_WORKSPACE_CONFIG`` or ``./config.yaml``.
+        :param user_id: optional scoping segment.
+        :param session_id: optional scoping segment (combined with ``user_id``).
+        """
+
+    def read(self, path: str, ranges: Optional[str] = ...) -> str:
+        """Read a file. ``ranges`` is a 1-indexed, comma-separated spec
+        (e.g. ``"1-10,20-30"``); when given, only those lines are returned."""
+
+    def write(
+        self,
+        path: str,
+        content: str,
+        *,
+        created_by: str,
+        desc: str,
+        ranges: Optional[str] = ...,
+    ) -> None:
+        """Write ``content`` to ``path``. With ``ranges`` (a single
+        ``"START-END"``), replaces those lines instead of overwriting."""
+
+    def list(self, scope: Optional[str] = ...) -> ListReport:
+        """List files, optionally restricted to a subdirectory ``scope``."""
+
+    def remove(self, path: str) -> None:
+        """Remove a file and its metadata."""
+
+def init(target: Optional[str] = ..., *, backend: str = ...) -> None:
+    """Initialize a new workspace (writes ``config.yaml``; for the file backend
+    also creates ``data/``). ``backend`` is ``"file"`` (default) or ``"mysql"``."""
+
+class WorkspaceError(Exception):
+    """Base class for all workspace errors."""
+
+class InvalidPathError(WorkspaceError): ...
+class PathEscapeError(WorkspaceError): ...
+class NotFoundError(WorkspaceError): ...
+class LockConflictError(WorkspaceError): ...
+class InvalidRangesError(WorkspaceError): ...

agent_workspace-2026.6.15a4/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["maturin>=1.7,<2"]
+build-backend = "maturin"
+
+[project]
+name = "agent-workspace"
+description = "Restricted file-operation workspace for AI agents (Python bindings over the Rust core)"
+license = { text = "Apache-2.0" }
+requires-python = ">=3.9"
+keywords = ["agent", "workspace", "mcp", "filesystem"]
+classifiers = [
+    "Programming Language :: Rust",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+]
+# Version is sourced from ../rust/Cargo.toml by maturin.
+dynamic = ["version"]
+
+[project.urls]
+Repository = "https://github.com/dropxhq/agent-workspace"
+
+[tool.maturin]
+# Build the PyO3 extension; the `python` cargo feature gates all binding code.
+features = ["python"]
+bindings = "pyo3"
+# Native module lives inside the Python package as `_agent_workspace`.
+module-name = "agent_workspace._agent_workspace"
+# Pure-Python sources (this directory).
+python-source = "."
+manifest-path = "rust/Cargo.toml"
+# Produce version-agnostic abi3 wheels (matches the abi3-py39 cargo feature).
+
+[dependency-groups]
+dev = ["maturin>=1.7,<2"]