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

{multi_agent_platform-0.3.2/multi_agent_platform.egg-info → multi_agent_platform-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-agent-platform
-Version: 0.3.2
+Version: 0.4.0
 Summary: Multi-Agent experiment collaboration platform
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/quantaeye/multi-agent-platform
@@ -42,7 +42,6 @@ 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,17 +163,17 @@ 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
@@ -280,7 +279,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

{multi_agent_platform-0.3.2 → multi_agent_platform-0.4.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,17 +115,17 @@ 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
@@ -231,7 +231,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

{multi_agent_platform-0.3.2 → multi_agent_platform-0.4.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.4.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.4.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")