arbiter-server 0.9.1.dev1__py3-none-any.whl

arbiter_server/storage.py

@@ -0,0 +1,60 @@
+from __future__ import annotations
+
+import os
+from pathlib import Path
+import sys
+
+
+class PluginStorage:
+    def __init__(self, *, plugin_name: str, root: Path) -> None:
+        self._plugin_name = plugin_name
+        self._root = plugin_data_dir(root, plugin_name)
+
+    @property
+    def plugin_name(self) -> str:
+        return self._plugin_name
+
+    def path(self, *parts: str) -> Path:
+        relative = Path(*parts)
+        if relative.is_absolute():
+            raise ValueError("plugin storage paths must be relative")
+        if any(part in {"", ".", ".."} for part in relative.parts):
+            raise ValueError("plugin storage paths must not traverse directories")
+        return self._root / relative
+
+    def ensure_dir(self, *parts: str) -> Path:
+        directory = self.path(*parts)
+        ensure_private_dir(directory)
+        return directory
+
+
+def default_plugin_data_root() -> Path:
+    if sys.platform == "win32":
+        base = os.environ.get("LOCALAPPDATA")
+        if base:
+            return Path(base) / "Arbiter" / "server" / "plugins"
+    if sys.platform == "darwin":
+        return (
+            Path.home()
+            / "Library"
+            / "Application Support"
+            / "Arbiter"
+            / "server"
+            / "plugins"
+        )
+    base = os.environ.get("XDG_STATE_HOME")
+    if base:
+        return Path(base) / "arbiter" / "server" / "plugins"
+    return Path.home() / ".local" / "state" / "arbiter" / "server" / "plugins"
+
+
+def plugin_data_dir(root: Path, plugin_name: str) -> Path:
+    if "/" in plugin_name or "\\" in plugin_name or plugin_name in {"", ".", ".."}:
+        raise ValueError(f"invalid plugin name for data directory: {plugin_name}")
+    return root / plugin_name
+
+
+def ensure_private_dir(path: Path) -> None:
+    path.mkdir(mode=0o700, parents=True, exist_ok=True)
+    if os.name != "nt":
+        os.chmod(path, 0o700)

arbiter_server/version.py

@@ -0,0 +1,135 @@
+from __future__ import annotations
+
+import os
+import re
+import subprocess
+from dataclasses import dataclass
+from importlib.metadata import PackageNotFoundError, version
+from pathlib import Path
+
+
+_VERSION_LINE_PATTERN = re.compile(r"^(?P<major>\d+)\.(?P<minor>\d+)(?:\.|$)")
+
+
+@dataclass(frozen=True)
+class SourceInfo:
+    commit: str | None
+    dirty: bool | None
+
+
+def compatibility_line(value: str) -> str:
+    match = _VERSION_LINE_PATTERN.match(value)
+    if not match:
+        raise ValueError(f"version must start with MAJOR.MINOR: {value}")
+    return f"{match.group('major')}.{match.group('minor')}"
+
+
+def _pyproject_version(distribution_name: str, package_file: str | Path) -> str | None:
+    start = Path(package_file).resolve()
+    current = start if start.is_dir() else start.parent
+    for src_dir in (
+        parent for parent in (current, *current.parents) if parent.name == "src"
+    ):
+        package_root = src_dir.parent
+        if not current.is_relative_to(src_dir):
+            continue
+        pyproject = package_root / "pyproject.toml"
+        if not pyproject.exists():
+            return None
+        text = pyproject.read_text(encoding="utf-8")
+        project = re.search(r"(?ms)^\[project\]\s*(.*?)(?=^\[|\Z)", text)
+        if project is None:
+            return None
+        project_text = project.group(1)
+        name = re.search(r'^name\s*=\s*"([^"]+)"\s*$', project_text, re.MULTILINE)
+        if name is None or name.group(1) != distribution_name:
+            return None
+        project_version = re.search(
+            r'^version\s*=\s*"([^"]+)"\s*$',
+            project_text,
+            re.MULTILINE,
+        )
+        if project_version is not None:
+            return project_version.group(1)
+        return None
+    return None
+
+
+def distribution_version(
+    distribution_name: str,
+    *,
+    package_file: str | Path | None = None,
+) -> str:
+    if package_file is not None:
+        source_version = _pyproject_version(distribution_name, package_file)
+        if source_version is not None:
+            return source_version
+
+    try:
+        return version(distribution_name)
+    except PackageNotFoundError:
+        pass
+
+    return "unknown"
+
+
+def arbiter_server_version() -> str:
+    return distribution_version("arbiter-server", package_file=__file__)
+
+
+def server_api_version() -> str:
+    return compatibility_line(arbiter_server_version())
+
+
+def _find_vcs_root(start: str | Path) -> Path | None:
+    current = Path(start).resolve()
+    if current.is_file():
+        current = current.parent
+    for src_dir in (
+        parent for parent in (current, *current.parents) if parent.name == "src"
+    ):
+        if not current.is_relative_to(src_dir):
+            continue
+        package_root = src_dir.parent
+        for parent in (package_root, *package_root.parents):
+            if (parent / ".sl").exists() or (parent / ".git").exists():
+                return parent
+        return None
+    return None
+
+
+def _run_vcs_command(root: Path, args: list[str]) -> str | None:
+    env = os.environ.copy()
+    if args[0] == "sl":
+        env["CHGDISABLE"] = "1"
+    try:
+        result = subprocess.run(
+            args,
+            cwd=root,
+            env=env,
+            check=True,
+            capture_output=True,
+            text=True,
+            timeout=2,
+        )
+    except (OSError, subprocess.SubprocessError):
+        return None
+    return result.stdout.strip()
+
+
+def source_info(package_file: str | Path = __file__) -> SourceInfo:
+    root = _find_vcs_root(package_file)
+    if root is None:
+        return SourceInfo(commit=None, dirty=None)
+
+    if (root / ".sl").exists():
+        commit = _run_vcs_command(root, ["sl", "log", "-r", ".", "-T", "{node|short}"])
+        status = _run_vcs_command(root, ["sl", "status"])
+    else:
+        commit = _run_vcs_command(root, ["git", "rev-parse", "--short", "HEAD"])
+        status = _run_vcs_command(root, ["git", "status", "--porcelain"])
+
+    return SourceInfo(
+        commit=commit or None,
+        dirty=None if status is None else bool(status),
+    )

arbiter_server-0.9.1.dev1.dist-info/METADATA

@@ -0,0 +1,26 @@
+Metadata-Version: 2.4
+Name: arbiter-server
+Version: 0.9.1.dev1
+Summary: Policy-controlled MCP server for agent-accessible services
+Author-email: Omry Yadan <omry@yadan.net>
+Maintainer-email: Omry Yadan <omry@yadan.net>
+License: MIT
+Project-URL: Homepage, https://github.com/omry/arbiter
+Project-URL: Repository, https://github.com/omry/arbiter
+Keywords: agent,policy,mcp,access-control,security
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <3.15,>=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: hydra-core<2.0,>=1.3
+Requires-Dist: mcp<2.0,>=1.9.4
+
+Server package for Arbiter.

arbiter_server-0.9.1.dev1.dist-info/RECORD

@@ -0,0 +1,22 @@
+arbiter_server/__init__.py,sha256=RZjRBfM2N7yWEBWZzXcE1nj_q86-JvddrfthDCdnAvM,30
+arbiter_server/__main__.py,sha256=lU6t3BklI-5H9EdprlceWLr0UcDmfXUu3Th0tjk2ANA,81
+arbiter_server/app.py,sha256=F4JvylSK57jr1FOLG1lb1AT9lOHw5i2M_m1ZbDiQ178,1087
+arbiter_server/artifacts.py,sha256=BielMQadzR2A3T6gYgpBU-ydcE3AOoBjtt7vjZlK3Sc,11514
+arbiter_server/cli_errors.py,sha256=EA0UAEK1SjF8rRtaHJZrkxuEeV-bi72QGHD9EaBW81o,803
+arbiter_server/config.py,sha256=9E2RsjHopBJcWMv7wNssSUPU80632hwUY3MQPNNxbgk,6606
+arbiter_server/main.py,sha256=afGD71-pCPVQGkRYYnOUHR5sX1fgO7hv2ocZyVW-hZw,93164
+arbiter_server/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+arbiter_server/services.py,sha256=jdeCCg-XEVgCQLSsABj30Ctg1WajXjQdpKWkt-nPk_o,25318
+arbiter_server/storage.py,sha256=siCrudgFF4EImI4faggjER25HmzbWjs-WBt7BNyM998,1892
+arbiter_server/version.py,sha256=XM3p4SjNq-XO4FlaxpvK46dE8u1xmk9vIvo5SEvuptc,4078
+arbiter_server/deploy/docker/arbiter-docker,sha256=Umln7WiXDmV1Tc0NSpjqcMVEzK3whhxHJXC_ryaUrHI,130605
+arbiter_server/deploy/docker/compose.yaml,sha256=81zPbgSx0evax3voIrnRzlqm3bLNHKGmArbUAkVbtYk,6135
+arbiter_server/file_protection/__init__.py,sha256=JERhFRL9UqwdrMx8c0740mIrNfewOp46j19gbVZaPac,499
+arbiter_server/file_protection/posix.py,sha256=xYnPnuctbRt7WAPZvZTkJH4YAjT_WuLpMBcFQHxogfE,2430
+arbiter_server/file_protection/windows.py,sha256=_fUzYlImvJcX0iCI0tQUhWer-ogydONLKaEWtJnLKpE,13037
+arbiter_server/plugins/__init__.py,sha256=vAmekvOS-JX_PX2y1V-XAc4eLuVdjpeRHY1X4r4tmys,1091
+arbiter_server-0.9.1.dev1.dist-info/METADATA,sha256=gTz4sEYc3VXuBv4dTQFtWyCIIddkDt3v1ncYHxkfZMM,1076
+arbiter_server-0.9.1.dev1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+arbiter_server-0.9.1.dev1.dist-info/entry_points.txt,sha256=o6Vja25caFpbYolfdGqBhIA6c4hN8Yzguc_IPVqXMpI,60
+arbiter_server-0.9.1.dev1.dist-info/top_level.txt,sha256=FrZNLp36AB4tQL_A9MFn9b0Ol7LTnKpf0lHnsdOQG6U,15
+arbiter_server-0.9.1.dev1.dist-info/RECORD,,

arbiter_server-0.9.1.dev1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

arbiter_server-0.9.1.dev1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+arbiter-server = arbiter_server.main:main

arbiter_server-0.9.1.dev1.dist-info/top_level.txt

@@ -0,0 +1 @@
+arbiter_server