multiagentos 0.4.2__tar.gz → 0.4.3__tar.gz

{multiagentos-0.4.2 → multiagentos-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multiagentos
-Version: 0.4.2
+Version: 0.4.3
 Summary: Cost-free, local-first, GitHub-native multi-agent development orchestration
 Project-URL: Homepage, https://github.com/eaglesjo/MultiAgentOS
 Project-URL: Repository, https://github.com/eaglesjo/MultiAgentOS
@@ -213,7 +213,21 @@ multiagentos mcp install --path C:\\Users\\<you>\\Documents\\your-project --allo
 multiagentos mcp status
 ```
 
-Both platforms keep the MCP server on `127.0.0.1:8000`. See [Windows MCP Service](docs/WINDOWS_MCP_SERVICE.md) and [macOS MCP Service](docs/MACOS_MCP_SERVICE.md) for lifecycle details.
+Each managed project gets its own OS service identity. Use a different port for each simultaneously running project:
+
+```bash
+multiagentos mcp install --path /absolute/path/to/project1 --port 8000 --allow-write
+multiagentos mcp install --path /absolute/path/to/project2 --port 8001 --allow-write
+```
+
+Then inspect or remove a specific project service:
+
+```bash
+multiagentos mcp status --path /absolute/path/to/project1
+multiagentos mcp uninstall --path /absolute/path/to/project1
+```
+
+The service identity is derived from the resolved project path, so multiple projects can coexist without sharing the same OS service registration. See [Windows MCP Service](docs/WINDOWS_MCP_SERVICE.md) and [macOS MCP Service](docs/MACOS_MCP_SERVICE.md) for lifecycle details.
 
 ## Terminology
 
@@ -304,11 +318,18 @@ multiagentos mcp install --path . --allow-write
 Check or remove the service with:
 
 ```bash
-multiagentos mcp status
-multiagentos mcp uninstall
+multiagentos mcp status --path .
+multiagentos mcp uninstall --path .
+```
+
+For multiple projects, assign each project a different port:
+
+```bash
+multiagentos mcp install --path /absolute/path/to/project1 --port 8000 --allow-write
+multiagentos mcp install --path /absolute/path/to/project2 --port 8001 --allow-write
 ```
 
-The managed service listens only on `127.0.0.1:8000` and keeps its logs under `.multiagentos/logs/`.
+Each managed service listens only on `127.0.0.1` and keeps its logs under that project's `.multiagentos/logs/`.
 
 ## Configuration
 

{multiagentos-0.4.2 → multiagentos-0.4.3}/README.md

@@ -196,7 +196,21 @@ multiagentos mcp install --path C:\\Users\\<you>\\Documents\\your-project --allo
 multiagentos mcp status
 ```
 
-Both platforms keep the MCP server on `127.0.0.1:8000`. See [Windows MCP Service](docs/WINDOWS_MCP_SERVICE.md) and [macOS MCP Service](docs/MACOS_MCP_SERVICE.md) for lifecycle details.
+Each managed project gets its own OS service identity. Use a different port for each simultaneously running project:
+
+```bash
+multiagentos mcp install --path /absolute/path/to/project1 --port 8000 --allow-write
+multiagentos mcp install --path /absolute/path/to/project2 --port 8001 --allow-write
+```
+
+Then inspect or remove a specific project service:
+
+```bash
+multiagentos mcp status --path /absolute/path/to/project1
+multiagentos mcp uninstall --path /absolute/path/to/project1
+```
+
+The service identity is derived from the resolved project path, so multiple projects can coexist without sharing the same OS service registration. See [Windows MCP Service](docs/WINDOWS_MCP_SERVICE.md) and [macOS MCP Service](docs/MACOS_MCP_SERVICE.md) for lifecycle details.
 
 ## Terminology
 
@@ -287,11 +301,18 @@ multiagentos mcp install --path . --allow-write
 Check or remove the service with:
 
 ```bash
-multiagentos mcp status
-multiagentos mcp uninstall
+multiagentos mcp status --path .
+multiagentos mcp uninstall --path .
+```
+
+For multiple projects, assign each project a different port:
+
+```bash
+multiagentos mcp install --path /absolute/path/to/project1 --port 8000 --allow-write
+multiagentos mcp install --path /absolute/path/to/project2 --port 8001 --allow-write
 ```
 
-The managed service listens only on `127.0.0.1:8000` and keeps its logs under `.multiagentos/logs/`.
+Each managed service listens only on `127.0.0.1` and keeps its logs under that project's `.multiagentos/logs/`.
 
 ## Configuration
 

{multiagentos-0.4.2 → multiagentos-0.4.3}/multiagentos/cli.py

@@ -318,12 +318,14 @@ def build_parser() -> argparse.ArgumentParser:
     mcp_install.add_argument("--allow-process", action="store_true", help="enable shell execution")
 
     mcp_uninstall = mcp_sub.add_parser(
-        "uninstall", help="remove the local Streamable HTTP MCP OS-managed service"
+        "uninstall", help="remove the local Streamable HTTP MCP OS-managed service for a project"
     )
+    mcp_uninstall.add_argument("--path", default=".", help="project root")
 
     mcp_status = mcp_sub.add_parser(
-        "status", help="show the local Streamable HTTP MCP OS-managed service status"
+        "status", help="show the local Streamable HTTP MCP OS-managed service status for a project"
     )
+    mcp_status.add_argument("--path", default=".", help="project root")
 
     github = subparsers.add_parser("github", help="use Agent Execution Runtime GitHub runtime")
     github_sub = github.add_subparsers(dest="github_command", required=True)
@@ -583,12 +585,12 @@ def main(argv: list[str] | None = None) -> int:
 
     if args.command == "mcp" and args.mcp_command == "uninstall":
         from multiagentos.mcp_service import uninstall_mcp_service
-        print(uninstall_mcp_service())
+        print(uninstall_mcp_service(Path(args.path).expanduser().resolve()))
         return 0
 
     if args.command == "mcp" and args.mcp_command == "status":
         from multiagentos.mcp_service import mcp_service_status
-        print(mcp_service_status())
+        print(mcp_service_status(Path(args.path).expanduser().resolve()))
         return 0
 
     if args.command == "github" and args.github_command == "probe":

{multiagentos-0.4.2 → multiagentos-0.4.3}/multiagentos/mcp_service.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import getpass
+import hashlib
 import os
 import plistlib
 import shutil
@@ -18,6 +19,22 @@ LABEL = "com.eaglesjo.multiagentos.mcp"
 WINDOWS_TASK_NAME = "MultiAgentOS Local MCP"
 LAUNCH_AGENTS_DIR = Path.home() / "Library" / "LaunchAgents"
 PLIST_PATH = LAUNCH_AGENTS_DIR / f"{LABEL}.plist"
+
+
+def _service_id(project_root: Path) -> str:
+    return hashlib.sha256(str(project_root).encode("utf-8")).hexdigest()[:12]
+
+
+def _service_label(project_root: Path) -> str:
+    return f"{LABEL}.{_service_id(project_root)}"
+
+
+def _windows_task_name(project_root: Path) -> str:
+    return f"{WINDOWS_TASK_NAME} ({_service_id(project_root)})"
+
+
+def _plist_path(project_root: Path) -> Path:
+    return LAUNCH_AGENTS_DIR / f"{_service_label(project_root)}.plist"
 WINDOWS_TASK_NS = "http://schemas.microsoft.com/windows/2004/02/mit/task"
 
 
@@ -44,8 +61,8 @@ def _schtasks(*args: str, check: bool = True) -> subprocess.CompletedProcess[str
     )
 
 
-def _target() -> str:
-    return f"gui/{os.getuid()}/{LABEL}"
+def _target(project_root: Path) -> str:
+    return f"gui/{os.getuid()}/{_service_label(project_root)}"
 
 
 def _validate_install_args(project_root: Path, host: str, port: int) -> Path:
@@ -169,6 +186,31 @@ def _wait_for_endpoint(host: str, port: int, *, timeout: float = 30.0) -> bool:
     return False
 
 
+def _wait_for_service_unloaded(target: str, *, timeout: float = 5.0) -> None:
+    """Wait until launchd no longer reports a service target."""
+    deadline = time.monotonic() + timeout
+    while time.monotonic() < deadline:
+        result = _launchctl("print", target, check=False)
+        if result.returncode != 0:
+            return
+        time.sleep(0.1)
+    raise RuntimeError(f"launchd service did not unload within {timeout:.1f}s: {target}")
+
+
+def _write_plist_atomically(plist_path: Path, plist: dict) -> None:
+    """Write a launchd plist atomically so launchd never sees a partial file."""
+    plist_path.parent.mkdir(parents=True, exist_ok=True)
+    fd, temp_name = tempfile.mkstemp(prefix=f".{plist_path.name}.", suffix=".tmp", dir=plist_path.parent)
+    try:
+        with os.fdopen(fd, "wb") as handle:
+            handle.write(plistlib.dumps(plist))
+            handle.flush()
+            os.fsync(handle.fileno())
+        os.replace(temp_name, plist_path)
+    finally:
+        Path(temp_name).unlink(missing_ok=True)
+
+
 def install_mcp_service(
     project_root: Path,
     *,
@@ -216,7 +258,7 @@ def _install_macos(
     LAUNCH_AGENTS_DIR.mkdir(parents=True, exist_ok=True)
 
     plist = {
-        "Label": LABEL,
+        "Label": _service_label(project_root),
         "ProgramArguments": program_arguments,
         "WorkingDirectory": str(project_root),
         "RunAtLoad": True,
@@ -227,21 +269,65 @@ def _install_macos(
         "StandardErrorPath": str(logs / "mcp-launchd.error.log"),
         "EnvironmentVariables": {"PYTHONUNBUFFERED": "1"},
     }
-    PLIST_PATH.write_bytes(plistlib.dumps(plist))
-
-    _launchctl("bootout", _target(), check=False)
+    plist_path = _plist_path(project_root)
+    target = _target(project_root)
     domain = f"gui/{os.getuid()}"
-    bootstrap = _launchctl("bootstrap", domain, str(PLIST_PATH), check=False)
-    if bootstrap.returncode != 0:
-        if "service already loaded" not in bootstrap.stderr.lower():
+
+    previous_plist = plist_path.read_bytes() if plist_path.exists() else None
+    _launchctl("bootout", target, check=False)
+    _wait_for_service_unloaded(target)
+
+    try:
+        _write_plist_atomically(plist_path, plist)
+
+        bootstrap = _launchctl("bootstrap", domain, str(plist_path), check=False)
+        if bootstrap.returncode != 0:
             raise subprocess.CalledProcessError(
                 bootstrap.returncode,
                 bootstrap.args,
                 output=bootstrap.stdout,
                 stderr=bootstrap.stderr,
             )
-    _launchctl("kickstart", "-k", _target())
-    _launchctl("print", _target())
+
+        kickstart = _launchctl("kickstart", "-k", target, check=False)
+        if kickstart.returncode != 0:
+            raise subprocess.CalledProcessError(
+                kickstart.returncode,
+                kickstart.args,
+                output=kickstart.stdout,
+                stderr=kickstart.stderr,
+            )
+
+        if not _wait_for_endpoint(host, port):
+            raise RuntimeError(
+                "launchd registered the MultiAgentOS local MCP service, "
+                f"but http://{host}:{port}/mcp did not start within 30 seconds."
+            )
+
+        _launchctl("print", target)
+    except Exception:
+        # Never leave a half-installed project service behind. Restore the
+        # previous project plist when one existed, without touching other
+        # project-scoped launchd services.
+        _launchctl("bootout", target, check=False)
+        try:
+            _wait_for_service_unloaded(target)
+        except Exception:
+            pass
+
+        if previous_plist is None:
+            plist_path.unlink(missing_ok=True)
+        else:
+            try:
+                plist_path.write_bytes(previous_plist)
+                restored = _launchctl("bootstrap", domain, str(plist_path), check=False)
+                if restored.returncode == 0:
+                    _launchctl("kickstart", "-k", target, check=False)
+            except Exception:
+                # Preserve the original install failure; the failed install
+                # must not mask it with a best-effort rollback error.
+                pass
+        raise
 
     return (
         "MultiAgentOS local MCP service installed and started. "
@@ -260,6 +346,9 @@ def _install_windows(
     logs = project_root / ".multiagentos" / "logs"
     logs.mkdir(parents=True, exist_ok=True)
 
+    _schtasks("/End", "/TN", WINDOWS_TASK_NAME, check=False)
+    _schtasks("/Delete", "/TN", WINDOWS_TASK_NAME, "/F", check=False)
+
     xml = _windows_task_xml(program_arguments, project_root=project_root)
     xml_path = None
     try:
@@ -279,7 +368,7 @@ def _install_windows(
             "/XML",
             xml_path,
             "/TN",
-            WINDOWS_TASK_NAME,
+            _windows_task_name(project_root),
             "/F",
             check=False,
         )
@@ -294,7 +383,7 @@ def _install_windows(
             f"(exit code {result.returncode}): {detail}"
         )
 
-    run = _schtasks("/Run", "/TN", WINDOWS_TASK_NAME, check=False)
+    run = _schtasks("/Run", "/TN", _windows_task_name(project_root), check=False)
     if run.returncode != 0:
         raise subprocess.CalledProcessError(
             run.returncode,
@@ -316,48 +405,44 @@ def _install_windows(
     )
 
 
-def uninstall_mcp_service() -> str:
-    """Stop and remove the managed local MCP service."""
+def uninstall_mcp_service(project_root: Path = Path(".")) -> str:
+    """Stop and remove the managed local MCP service for a project."""
     _require_supported_platform()
+    project_root = _validate_install_args(project_root, "127.0.0.1", 8000)
     if sys.platform == "darwin":
-        _launchctl("bootout", _target(), check=False)
-        PLIST_PATH.unlink(missing_ok=True)
-        return f"MultiAgentOS local MCP service removed: {LABEL}"
-
+        label = _service_label(project_root)
+        target = _target(project_root)
+        _launchctl("bootout", target, check=False)
+        _wait_for_service_unloaded(target)
+        _plist_path(project_root).unlink(missing_ok=True)
+        return f"MultiAgentOS local MCP service removed: {label}"
+
+    task_name = _windows_task_name(project_root)
+    _schtasks("/End", "/TN", task_name, check=False)
     _schtasks("/End", "/TN", WINDOWS_TASK_NAME, check=False)
-    result = _schtasks("/Delete", "/TN", WINDOWS_TASK_NAME, "/F", check=False)
+    result = _schtasks("/Delete", "/TN", task_name, "/F", check=False)
+    _schtasks("/Delete", "/TN", WINDOWS_TASK_NAME, "/F", check=False)
     if result.returncode not in {0, 1}:
-        raise subprocess.CalledProcessError(
-            result.returncode,
-            result.args,
-            output=result.stdout,
-            stderr=result.stderr,
-        )
-    return f"MultiAgentOS local MCP service removed: {WINDOWS_TASK_NAME}"
+        raise subprocess.CalledProcessError(result.returncode, result.args, output=result.stdout, stderr=result.stderr)
+    return f"MultiAgentOS local MCP service removed: {task_name}"
 
 
-def mcp_service_status() -> str:
-    """Return the status for the managed local MCP service."""
+def mcp_service_status(project_root: Path = Path(".")) -> str:
+    """Return the status for the managed local MCP service for a project."""
     _require_supported_platform()
+    project_root = _validate_install_args(project_root, "127.0.0.1", 8000)
     if sys.platform == "darwin":
-        result = _launchctl("print", _target(), check=False)
+        label = _service_label(project_root)
+        result = _launchctl("print", _target(project_root), check=False)
         if result.returncode == 0:
             return result.stdout.strip()
-        return f"MultiAgentOS local MCP service is not installed: {LABEL}"
-
-    result = _schtasks(
-        "/Query",
-        "/TN",
-        WINDOWS_TASK_NAME,
-        "/FO",
-        "LIST",
-        "/V",
-        check=False,
-    )
+        return f"MultiAgentOS local MCP service is not installed: {label}"
+
+    task_name = _windows_task_name(project_root)
+    result = _schtasks("/Query", "/TN", task_name, "/FO", "LIST", "/V", check=False)
     if result.returncode == 0:
         return result.stdout.strip()
-    return f"MultiAgentOS local MCP service is not installed: {WINDOWS_TASK_NAME}"
-
+    return f"MultiAgentOS local MCP service is not installed: {task_name}"
 
 __all__ = [
     "LABEL",

{multiagentos-0.4.2 → multiagentos-0.4.3}/multiagentos.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multiagentos
-Version: 0.4.2
+Version: 0.4.3
 Summary: Cost-free, local-first, GitHub-native multi-agent development orchestration
 Project-URL: Homepage, https://github.com/eaglesjo/MultiAgentOS
 Project-URL: Repository, https://github.com/eaglesjo/MultiAgentOS
@@ -213,7 +213,21 @@ multiagentos mcp install --path C:\\Users\\<you>\\Documents\\your-project --allo
 multiagentos mcp status
 ```
 
-Both platforms keep the MCP server on `127.0.0.1:8000`. See [Windows MCP Service](docs/WINDOWS_MCP_SERVICE.md) and [macOS MCP Service](docs/MACOS_MCP_SERVICE.md) for lifecycle details.
+Each managed project gets its own OS service identity. Use a different port for each simultaneously running project:
+
+```bash
+multiagentos mcp install --path /absolute/path/to/project1 --port 8000 --allow-write
+multiagentos mcp install --path /absolute/path/to/project2 --port 8001 --allow-write
+```
+
+Then inspect or remove a specific project service:
+
+```bash
+multiagentos mcp status --path /absolute/path/to/project1
+multiagentos mcp uninstall --path /absolute/path/to/project1
+```
+
+The service identity is derived from the resolved project path, so multiple projects can coexist without sharing the same OS service registration. See [Windows MCP Service](docs/WINDOWS_MCP_SERVICE.md) and [macOS MCP Service](docs/MACOS_MCP_SERVICE.md) for lifecycle details.
 
 ## Terminology
 
@@ -304,11 +318,18 @@ multiagentos mcp install --path . --allow-write
 Check or remove the service with:
 
 ```bash
-multiagentos mcp status
-multiagentos mcp uninstall
+multiagentos mcp status --path .
+multiagentos mcp uninstall --path .
+```
+
+For multiple projects, assign each project a different port:
+
+```bash
+multiagentos mcp install --path /absolute/path/to/project1 --port 8000 --allow-write
+multiagentos mcp install --path /absolute/path/to/project2 --port 8001 --allow-write
 ```
 
-The managed service listens only on `127.0.0.1:8000` and keeps its logs under `.multiagentos/logs/`.
+Each managed service listens only on `127.0.0.1` and keeps its logs under that project's `.multiagentos/logs/`.
 
 ## Configuration
 

{multiagentos-0.4.2 → multiagentos-0.4.3}/multiagentos.egg-info/SOURCES.txt

@@ -242,6 +242,8 @@ tests/test_tool_calling_runtime.py
 tests/test_tool_ledger_runtime.py
 tests/test_tunnel_client_mcp_health.py
 tests/test_tunnel_client_runtime_status.py
+tests/test_tunnel_installer_script.py
+tests/test_tunnel_launchd_scripts.py
 tests/test_unified_checkpoints.py
 tests/test_validation_runtime.py
 tests/test_windows_launcher.py

{multiagentos-0.4.2 → multiagentos-0.4.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "multiagentos"
-version = "0.4.2"
+version = "0.4.3"
 description = "Cost-free, local-first, GitHub-native multi-agent development orchestration"
 readme = "README.md"
 requires-python = ">=3.10"