multi-agent-platform 0.3.2__tar.gz → 0.6.0__tar.gz

{multi_agent_platform-0.3.2 → multi_agent_platform-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-agent-platform
-Version: 0.3.2
+Version: 0.6.0
 Summary: Multi-Agent experiment collaboration platform
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/quantaeye/multi-agent-platform
@@ -17,32 +17,31 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: typer<0.17,>=0.15.0
-Requires-Dist: httpx<0.29,>=0.28.0
+Requires-Dist: typer<0.28,>=0.15.0
+Requires-Dist: httpx<1,>=0.28.0
 Requires-Dist: pyyaml<7.0,>=6.0
-Requires-Dist: pydantic<2.12,>=2.10.0
+Requires-Dist: pydantic<3,>=2.10.0
 Provides-Extra: server
-Requires-Dist: fastapi<0.116,>=0.115.0; extra == "server"
-Requires-Dist: uvicorn[standard]<0.41,>=0.32.0; extra == "server"
-Requires-Dist: sqlalchemy<2.1,>=2.0.36; extra == "server"
-Requires-Dist: alembic<2.0,>=1.14.0; extra == "server"
-Requires-Dist: pydantic-settings<2.9,>=2.6.0; extra == "server"
+Requires-Dist: fastapi<1,>=0.115.0; extra == "server"
+Requires-Dist: uvicorn[standard]<1,>=0.32.0; extra == "server"
+Requires-Dist: sqlalchemy<3,>=2.0.36; extra == "server"
+Requires-Dist: alembic<3,>=1.14.0; extra == "server"
+Requires-Dist: pydantic-settings<3,>=2.6.0; extra == "server"
 Requires-Dist: bcrypt<6.0,>=4.2.0; extra == "server"
-Requires-Dist: python-multipart<0.1,>=0.0.17; extra == "server"
+Requires-Dist: python-multipart<1,>=0.0.17; extra == "server"
 Requires-Dist: cryptography<50.0,>=44.0.0; extra == "server"
 Provides-Extra: dev
 Requires-Dist: multi-agent-platform[server]; extra == "dev"
-Requires-Dist: pytest<9.0,>=8.3.0; extra == "dev"
-Requires-Dist: pytest-asyncio<1.0,>=0.24.0; extra == "dev"
-Requires-Dist: pytest-cov<7.0,>=5.0.0; extra == "dev"
-Requires-Dist: httpx<0.29,>=0.28.0; extra == "dev"
+Requires-Dist: pytest<10,>=8.3.0; extra == "dev"
+Requires-Dist: pytest-asyncio<2.0,>=0.24.0; extra == "dev"
+Requires-Dist: pytest-cov<8.0,>=5.0.0; extra == "dev"
+Requires-Dist: httpx<1,>=0.28.0; extra == "dev"
 Requires-Dist: mcp<2.0,>=1.26.0; extra == "dev"
 Requires-Dist: ruff<1.0,>=0.8.0; extra == "dev"
 Requires-Dist: pydantic-to-typescript<3.0,>=2.0.0; extra == "dev"
 Provides-Extra: mcp
 Requires-Dist: multi-agent-platform[server]; extra == "mcp"
 Requires-Dist: mcp<2.0,>=1.26.0; extra == "mcp"
-Provides-Extra: codex-runtime
 Provides-Extra: claude-runtime
 Requires-Dist: claude-agent-sdk<1.0,>=0.2; extra == "claude-runtime"
 Dynamic: license-file
@@ -106,9 +105,9 @@ map skill install          # 将 5 个 Skill 文件安装到 .cursor/skills/
 
 ### PRD
 
-- [现行草案：v0.9（waker Phase 2 通知降噪）](docs/prd/v0.9.md)
-- [归档：v0.1 / v0.2 / v0.3 / v0.4 / v0.5 / v0.6](docs/prd/archive/)
-- [占位：v0.7 / v0.8（未单独成稿）](docs/prd/archive/v0.7.md)
+- [现行主线：v0.11（Agent 体验与生态互操作）](docs/prd/v0.11.md)
+- [提案草案：v0.12（Agent 人机工程）](docs/prd/v0.12.md)
+- 版本清单与历史归档以 [docs/prd/README.md](docs/prd/README.md) 为准
 
 ## 状态
 
@@ -122,9 +121,9 @@ map skill install          # 将 5 个 Skill 文件安装到 .cursor/skills/
 - **Agent Runtime**：simple-waker 默认路径（轮询 + remind + action_item 升级）
 - **多 persona 协作**：`.map/` persona + Skill 指导 Agent 写回 MAP
 
-**当前主线**：v0.9 草案（waker Phase 2 通知降噪）。详见 [PRD v0.9](docs/prd/v0.9.md) 与 [status-md-v10.md](docs/status-md-v10.md)。
+**当前主线**：v0.11（Agent 体验与生态互操作，M50–M53 已完成），提案 v0.12（Agent 人机工程）评审中。详见 [PRD 入口](docs/prd/README.md) 与 [status-md-v10.md](docs/status-md-v10.md)。
 
-历史里程碑详见 PRD 归档：[v0.1–v0.6](docs/prd/archive/) · [占位 v0.7 / v0.8](docs/prd/archive/v0.7.md)。
+历史里程碑详见 [PRD 归档](docs/prd/README.md#历史归档按时间倒序)。
 
 **Agent 身份（本仓库）**：统一使用 **`.map/` persona + `map` CLI**（见 [AGENTS.md](AGENTS.md)）；Cursor MCP 接入计划停用。
 
@@ -164,23 +163,24 @@ map-server
 # 或: uvicorn server.main:app --reload
 
 # 注册首个 Admin（仅当系统中尚无 Agent 时可匿名调用）
-curl -X POST "http://localhost:8000/api/v1/agents?name=ops-admin&role=admin"
+curl -X POST "http://localhost:8001/api/v1/agents?name=ops-admin&role=admin"
 
 # 后续 Agent 须由 Admin 注册
 curl -H "Authorization: Bearer <admin-token>" \
-  -X POST "http://localhost:8000/api/v1/agents?name=agent-alpha&role=agent&project_key=<project-key>"
+  -X POST "http://localhost:8001/api/v1/agents?name=agent-alpha&role=agent&project_key=<project-key>"
 
 # 创建项目
 curl -H "Authorization: Bearer <token>" \
   -H "Content-Type: application/json" \
   -d '{"name":"demo","workspace_path":"/tmp/demo"}' \
-  http://localhost:8000/api/v1/projects
+  http://localhost:8001/api/v1/projects
 
 # 运行测试
 pytest
 
 # CLI 用法（需设置 MAP_TOKEN 或 ~/.map/config.yaml）
 export MAP_TOKEN=<your-token>
+map --version
 map project list
 map status
 map experiment start --id <exp-id>
@@ -262,7 +262,7 @@ map --persona host status              # 查看 open_topics
 ./scripts/start-simple-waker.sh --persona host --once --dry-run
 ```
 
-状态文件：`.map/simple-waker-state-<persona>.json`（session + remind 时间戳，勿提交 Git）。详见 [docs/MAP-SIMPLE-WAKER.md](docs/MAP-SIMPLE-WAKER.md)。
+状态文件：`.map/simple-waker-state-<persona>.json`（session + remind 时间戳）。`.map/` 整目录 gitignore，勿提交。详见 [docs/MAP-SIMPLE-WAKER.md](docs/MAP-SIMPLE-WAKER.md)。
 
 `--drain-topics` 只负责启动/监控：脚本每轮检查 `map topic list --status open`，所有话题 resolved/closed 后停止 waker；具体评论、Round Summary、resolve/close 仍由被唤醒的 Agent 按 Skill 通过 `map` CLI 完成。
 
@@ -280,7 +280,7 @@ simple-waker 在每次 remind 后会写一条聚合 `inbound_event` 审计行（
 
 ## Docker（API + Web）
 
-默认 `docker-compose.yml` 暴露 API `:8000`、Web `:3000`、MCP `:8080`。本仓包含 `docker-compose.override.yml`，用于本机端口冲突场景，会把 API 改为 `:8001`、MCP 改为 `:18081`；因此本仓 `.map/` bootstrap 示例使用 `http://localhost:8001`。
+默认 `docker-compose.yml` 暴露 API `:8000`、Web `:3000`、MCP `:8080`；本仓自带的 `docker-compose.override.yml` 在 `docker compose up` 时自动生效，把宿主端口改为 API `:8001`、MCP `:18081`。因此本仓库文档与 `.map/` bootstrap 示例统一使用 `http://localhost:8001`。
 
 ```bash
 docker compose up --build
@@ -288,6 +288,23 @@ docker compose up --build
 # 使用本仓 override 时: API :8001  Web :3000  MCP :18081/mcp
 ```
 
+### FS 事实源与 Docker / 远程部署
+
+`map/` 文件夹事实源默认要求 server 与仓库**同文件系统**。容器 / 远程部署时 `map bootstrap` 会在末尾自动探测并给出三态判定（`map fs status` 随时复查）：
+
+- **`local-fs`**：server 直接读 workspace，全链路可用。
+- **`projection-cache`**：workspace 不可达，但已执行 `map fs push` 上行投影缓存——列表合并 / `map work` 待办 / Web 渲染回退到投影；验证型写（advance-round / close）走 validate → 本地写回 → commit（服务端只校验签发，不再要求写文件）。写完文件或推进轮次后重新 push 即可。
+- **`detached`**：两者皆无——FS 话题对 server 不可见（显式警告，不再静默空列表）。
+
+Docker 单机想让 server 直接看到 workspace 时，用同绝对路径挂载（过渡方案；注意 macOS bind mount 性能与容器写文件的属主问题）：
+
+```bash
+export MAP_WORKSPACE_PATH=/absolute/path/to/this/repo
+docker compose -f docker-compose.yml -f docker-compose.override.yml -f docker-compose.fs.yml up
+```
+
+详见 [架构文档 §4.1 部署矩阵](docs/ARCHITECTURE.md#41-部署矩阵server-能否看到-workspace)。
+
 ## Python SDK
 
 ```bash

{multi_agent_platform-0.3.2 → multi_agent_platform-0.6.0}/README.md

@@ -57,9 +57,9 @@ map skill install          # 将 5 个 Skill 文件安装到 .cursor/skills/
 
 ### PRD
 
-- [现行草案：v0.9（waker Phase 2 通知降噪）](docs/prd/v0.9.md)
-- [归档：v0.1 / v0.2 / v0.3 / v0.4 / v0.5 / v0.6](docs/prd/archive/)
-- [占位：v0.7 / v0.8（未单独成稿）](docs/prd/archive/v0.7.md)
+- [现行主线：v0.11（Agent 体验与生态互操作）](docs/prd/v0.11.md)
+- [提案草案：v0.12（Agent 人机工程）](docs/prd/v0.12.md)
+- 版本清单与历史归档以 [docs/prd/README.md](docs/prd/README.md) 为准
 
 ## 状态
 
@@ -73,9 +73,9 @@ map skill install          # 将 5 个 Skill 文件安装到 .cursor/skills/
 - **Agent Runtime**：simple-waker 默认路径（轮询 + remind + action_item 升级）
 - **多 persona 协作**：`.map/` persona + Skill 指导 Agent 写回 MAP
 
-**当前主线**：v0.9 草案（waker Phase 2 通知降噪）。详见 [PRD v0.9](docs/prd/v0.9.md) 与 [status-md-v10.md](docs/status-md-v10.md)。
+**当前主线**：v0.11（Agent 体验与生态互操作，M50–M53 已完成），提案 v0.12（Agent 人机工程）评审中。详见 [PRD 入口](docs/prd/README.md) 与 [status-md-v10.md](docs/status-md-v10.md)。
 
-历史里程碑详见 PRD 归档：[v0.1–v0.6](docs/prd/archive/) · [占位 v0.7 / v0.8](docs/prd/archive/v0.7.md)。
+历史里程碑详见 [PRD 归档](docs/prd/README.md#历史归档按时间倒序)。
 
 **Agent 身份（本仓库）**：统一使用 **`.map/` persona + `map` CLI**（见 [AGENTS.md](AGENTS.md)）；Cursor MCP 接入计划停用。
 
@@ -115,23 +115,24 @@ map-server
 # 或: uvicorn server.main:app --reload
 
 # 注册首个 Admin（仅当系统中尚无 Agent 时可匿名调用）
-curl -X POST "http://localhost:8000/api/v1/agents?name=ops-admin&role=admin"
+curl -X POST "http://localhost:8001/api/v1/agents?name=ops-admin&role=admin"
 
 # 后续 Agent 须由 Admin 注册
 curl -H "Authorization: Bearer <admin-token>" \
-  -X POST "http://localhost:8000/api/v1/agents?name=agent-alpha&role=agent&project_key=<project-key>"
+  -X POST "http://localhost:8001/api/v1/agents?name=agent-alpha&role=agent&project_key=<project-key>"
 
 # 创建项目
 curl -H "Authorization: Bearer <token>" \
   -H "Content-Type: application/json" \
   -d '{"name":"demo","workspace_path":"/tmp/demo"}' \
-  http://localhost:8000/api/v1/projects
+  http://localhost:8001/api/v1/projects
 
 # 运行测试
 pytest
 
 # CLI 用法（需设置 MAP_TOKEN 或 ~/.map/config.yaml）
 export MAP_TOKEN=<your-token>
+map --version
 map project list
 map status
 map experiment start --id <exp-id>
@@ -213,7 +214,7 @@ map --persona host status              # 查看 open_topics
 ./scripts/start-simple-waker.sh --persona host --once --dry-run
 ```
 
-状态文件：`.map/simple-waker-state-<persona>.json`（session + remind 时间戳，勿提交 Git）。详见 [docs/MAP-SIMPLE-WAKER.md](docs/MAP-SIMPLE-WAKER.md)。
+状态文件：`.map/simple-waker-state-<persona>.json`（session + remind 时间戳）。`.map/` 整目录 gitignore，勿提交。详见 [docs/MAP-SIMPLE-WAKER.md](docs/MAP-SIMPLE-WAKER.md)。
 
 `--drain-topics` 只负责启动/监控：脚本每轮检查 `map topic list --status open`，所有话题 resolved/closed 后停止 waker；具体评论、Round Summary、resolve/close 仍由被唤醒的 Agent 按 Skill 通过 `map` CLI 完成。
 
@@ -231,7 +232,7 @@ simple-waker 在每次 remind 后会写一条聚合 `inbound_event` 审计行（
 
 ## Docker（API + Web）
 
-默认 `docker-compose.yml` 暴露 API `:8000`、Web `:3000`、MCP `:8080`。本仓包含 `docker-compose.override.yml`，用于本机端口冲突场景，会把 API 改为 `:8001`、MCP 改为 `:18081`；因此本仓 `.map/` bootstrap 示例使用 `http://localhost:8001`。
+默认 `docker-compose.yml` 暴露 API `:8000`、Web `:3000`、MCP `:8080`；本仓自带的 `docker-compose.override.yml` 在 `docker compose up` 时自动生效，把宿主端口改为 API `:8001`、MCP `:18081`。因此本仓库文档与 `.map/` bootstrap 示例统一使用 `http://localhost:8001`。
 
 ```bash
 docker compose up --build
@@ -239,6 +240,23 @@ docker compose up --build
 # 使用本仓 override 时: API :8001  Web :3000  MCP :18081/mcp
 ```
 
+### FS 事实源与 Docker / 远程部署
+
+`map/` 文件夹事实源默认要求 server 与仓库**同文件系统**。容器 / 远程部署时 `map bootstrap` 会在末尾自动探测并给出三态判定（`map fs status` 随时复查）：
+
+- **`local-fs`**：server 直接读 workspace，全链路可用。
+- **`projection-cache`**：workspace 不可达，但已执行 `map fs push` 上行投影缓存——列表合并 / `map work` 待办 / Web 渲染回退到投影；验证型写（advance-round / close）走 validate → 本地写回 → commit（服务端只校验签发，不再要求写文件）。写完文件或推进轮次后重新 push 即可。
+- **`detached`**：两者皆无——FS 话题对 server 不可见（显式警告，不再静默空列表）。
+
+Docker 单机想让 server 直接看到 workspace 时，用同绝对路径挂载（过渡方案；注意 macOS bind mount 性能与容器写文件的属主问题）：
+
+```bash
+export MAP_WORKSPACE_PATH=/absolute/path/to/this/repo
+docker compose -f docker-compose.yml -f docker-compose.override.yml -f docker-compose.fs.yml up
+```
+
+详见 [架构文档 §4.1 部署矩阵](docs/ARCHITECTURE.md#41-部署矩阵server-能否看到-workspace)。
+
 ## Python SDK
 
 ```bash

{multi_agent_platform-0.3.2 → multi_agent_platform-0.6.0}/cli/action_item_escalation.py

@@ -13,7 +13,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
-from datetime import UTC, datetime, timedelta
+from datetime import datetime, timedelta, timezone
 from enum import Enum
 from typing import Any
 
@@ -48,12 +48,12 @@ def _parse_iso_datetime(value: Any) -> datetime | None:
     if value is None or value == "":
         return None
     if isinstance(value, datetime):
-        return value if value.tzinfo else value.replace(tzinfo=UTC)
+        return value if value.tzinfo else value.replace(tzinfo=timezone.utc)
     try:
         parsed = datetime.fromisoformat(str(value).replace("Z", "+00:00"))
     except ValueError:
         return None
-    return parsed if parsed.tzinfo else parsed.replace(tzinfo=UTC)
+    return parsed if parsed.tzinfo else parsed.replace(tzinfo=timezone.utc)
 
 
 def should_wake_action_item(
@@ -77,7 +77,7 @@ def should_wake_action_item(
       written the diagnostic audit row we stop bothering the assignee.
     - First wake fires 24h after ``first_open_at``; second at 72h; further
       wakes every 7d; the (N+1)th check after the 4th wake writes stale.
-    - ``now`` defaults to ``datetime.now(UTC)`` — callers that need a
+    - ``now`` defaults to ``datetime.now(timezone.utc)`` — callers that need a
       deterministic clock (tests, dogfood) inject their own.
     """
     if not isinstance(item, dict):
@@ -91,7 +91,7 @@ def should_wake_action_item(
     if _parse_iso_datetime(item.get("stale_at")) is not None:
         return ActionItemWakeDecision.SKIP
 
-    current = now or datetime.now(UTC)
+    current = now or datetime.now(timezone.utc)
     first_open_at = _parse_iso_datetime(item.get("first_open_at"))
     if first_open_at is None:
         # Pre-I1 backfill may have missed this row (closed before I1, etc).

{multi_agent_platform-0.3.2 → multi_agent_platform-0.6.0}/cli/agent_client.py

@@ -13,7 +13,7 @@ import logging
 import os
 import re
 from collections.abc import Callable
-from datetime import UTC, datetime
+from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any, Literal, Protocol, TypedDict
 
@@ -150,7 +150,7 @@ class PersonaAgentClient:
         # the real session_id only arrives with the ResultMessage. A long
         # running turn is then observable live — a stuck agent shows up as the
         # last event ts going stale.
-        pre_sid = resume_session_id or f"new-{datetime.now(UTC).strftime('%Y%m%dT%H%M%S%f')}"
+        pre_sid = resume_session_id or f"new-{datetime.now(timezone.utc).strftime('%Y%m%dT%H%M%S%f')}"
         log_path = resolve_session_log_path(self._resolve_session_log_dir(), pre_sid, self.persona)
         self._log_event(
             log_path,
@@ -261,7 +261,7 @@ class PersonaAgentClient:
         else:
             status = "ok"
 
-        self.state["last_wakeup_at"] = datetime.now(UTC).isoformat()
+        self.state["last_wakeup_at"] = datetime.now(timezone.utc).isoformat()
         self.state["last_wakeup_status"] = status
         self._save_state_fn()
 
@@ -337,7 +337,7 @@ class PersonaAgentClient:
             return str(result.session_id)
         if resume_session_id:
             return str(resume_session_id)
-        return f"unknown-{datetime.now(UTC).strftime('%Y%m%dT%H%M%S%fZ')}"
+        return f"unknown-{datetime.now(timezone.utc).strftime('%Y%m%dT%H%M%S%fZ')}"
 
     def _log_event(
         self,

multi_agent_platform-0.6.0/cli/commands/auth.py

@@ -0,0 +1,104 @@
+"""``map auth ...`` sub-app — self-service credential recovery (M52C).
+
+``map auth reissue`` recovers a lost agent token using the project_key
+(same self-service trust boundary as ``map bootstrap``): the server
+rotates the token, revoking the old one, and the CLI writes the new
+token back into ``.map/agents.local.yaml``.
+"""
+from __future__ import annotations
+
+from pathlib import Path
+
+import typer
+from map_client.bootstrap import reissue_map_token
+from map_client.exceptions import MAPHTTPError
+
+auth_app = typer.Typer(help="Manage MAP credentials (token recovery)")
+
+
+@auth_app.command("reissue")
+def auth_reissue(
+    name: str = typer.Option(
+        ...,
+        "--name",
+        "-n",
+        help="Agent name to reissue (e.g. multi-agent-platform-host; "
+        "see .map/agents.yaml).",
+    ),
+    key: str | None = typer.Option(
+        None,
+        "--key",
+        "-k",
+        help="Project key (default: project_key from .map/config.yaml).",
+    ),
+    api_url: str | None = typer.Option(
+        None,
+        "--api-url",
+        help="MAP API base URL (default: api_url from .map/config.yaml, "
+        "then MAP_API_URL, then http://localhost:8000).",
+    ),
+    project_root: Path | None = typer.Option(
+        None,
+        "--project-root",
+        help="Directory containing .map/ (default: current directory).",
+    ),
+) -> None:
+    """Reissue an agent's API token and write it back to .map/agents.local.yaml.
+
+    Recovery path for a lost ``.map/agents.local.yaml``. The previous
+    token is revoked immediately (anywhere it was used will start
+    returning 401 until re-reissued). Trust model mirrors
+    ``map bootstrap``: the project_key is the proof of ownership.
+
+    \b
+    Examples:
+        map auth reissue --key my-project --name my-project-host
+        map auth reissue --name my-project-host          # key from .map/config.yaml
+    """
+    from cli.main import _cli_options
+
+    fmt = _cli_options.get("format", "yaml")
+    root = project_root or _cli_options.get("project_root")
+
+    try:
+        result = reissue_map_token(
+            agent_name=name,
+            project_key=key,
+            project_root=Path(root) if root else None,
+            api_url=api_url,
+        )
+    except ValueError as exc:
+        typer.echo(f"Error: {exc}", err=True)
+        raise typer.Exit(1) from exc
+    except MAPHTTPError as exc:
+        typer.echo(f"Error {exc.status_code}: {exc.detail}", err=True)
+        raise typer.Exit(1) from exc
+
+    if fmt == "json":
+        import json
+
+        typer.echo(
+            json.dumps(
+                {
+                    "ok": True,
+                    "data": {
+                        "agent_id": result.agent_id,
+                        "agent_name": result.agent_name,
+                        "persona": result.persona_key,
+                        "api_url": result.api_url,
+                        "wrote_back": str(result.local_path),
+                        "previous_token_revoked": True,
+                    },
+                },
+                ensure_ascii=False,
+                indent=2,
+            )
+        )
+        return
+
+    typer.echo(f"Reissued token for agent '{result.agent_name}' ({result.agent_id})")
+    typer.echo(f"Previous token revoked. Wrote back: {result.local_path}")
+    if result.persona_key:
+        typer.echo(f"Try: map --persona {result.persona_key} persona whoami")
+    else:
+        typer.echo("Try: map persona whoami")