multi-agent-platform 0.1.0__py3-none-any.whl

multi_agent_platform-0.1.0.dist-info/METADATA

@@ -0,0 +1,298 @@
+Metadata-Version: 2.4
+Name: multi-agent-platform
+Version: 0.1.0
+Summary: Multi-Agent experiment collaboration platform
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/quantaeye/multi-agent-platform
+Project-URL: Documentation, https://github.com/quantaeye/multi-agent-platform/tree/main/docs
+Project-URL: Repository, https://github.com/quantaeye/multi-agent-platform
+Project-URL: Issues, https://github.com/quantaeye/multi-agent-platform/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi<0.116,>=0.115.0
+Requires-Dist: uvicorn[standard]<0.41,>=0.32.0
+Requires-Dist: sqlalchemy<2.1,>=2.0.36
+Requires-Dist: alembic<2.0,>=1.14.0
+Requires-Dist: pydantic<2.12,>=2.10.0
+Requires-Dist: pydantic-settings<2.9,>=2.6.0
+Requires-Dist: bcrypt<6.0,>=4.2.0
+Requires-Dist: python-multipart<0.1,>=0.0.17
+Requires-Dist: typer<0.17,>=0.15.0
+Requires-Dist: httpx<0.29,>=0.28.0
+Requires-Dist: pyyaml<7.0,>=6.0
+Requires-Dist: cryptography<50.0,>=44.0.0
+Provides-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: 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: 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
+
+# Multi-Agent Platform (MAP)
+
+多 Agent 实验协作平台：以话题为中心，管理实验计划、评审讨论、执行日志与项目状态。
+
+**新用户？** 一键启动：`./scripts/quickstart.sh`，或阅读 [Quick Start 指南](docs/QUICKSTART.md)。
+
+## 文档
+
+- [Quick Start 指南（新用户必读）](docs/QUICKSTART.md)
+- [产品需求文档（PRD）](docs/prd/archive/v0.1.md)
+- [产品需求文档 v0.2（角色与项目边界）](docs/prd/archive/v0.2.md)
+- [产品需求文档 v0.3（话题独立、UI 写闭环、待办与通知）](docs/prd/archive/v0.3.md)
+- [产品需求文档 v0.4（站内收件箱、@提及、计划 diff、话题置顶）](docs/prd/archive/v0.4.md)
+- [产品需求文档 v0.5（主持待办 pending_topic_replies、topic-host Skill）](docs/prd/archive/v0.5.md)
+- [产品需求文档 v0.6（列表归档、独立列表页、通知 SSE）](docs/prd/archive/v0.6.md)
+- [产品需求文档 v0.9 草案（waker Phase 2 通知降噪）](docs/prd/v0.9.md)
+- [Webhook 话题主持接线指南](docs/WEBHOOK-TOPIC-HOST.md)
+- [Agent Runtime 集成（simple-waker，默认）](docs/MAP-SIMPLE-WAKER.md)
+- [架构设计](docs/ARCHITECTURE.md)
+- [Python SDK 指南](docs/SDK.md)
+- [MCP Server 指南（stdio）](docs/MCP.md)
+
+## 状态
+
+**M1 已完成**：数据模型、Alembic 迁移、Projects/Experiments CRUD REST API。  
+**M2 已完成**：Plans 修订、Reviews、Comments、实验阶段与不合理项状态机。  
+**M3 已完成**：实验日志、Start/Complete、全局 Status API、CLI（`map` 命令）。  
+**M4 已完成**：React + Vite Web UI（看板、项目、实验话题页）。  
+**M5 已完成**：Python SDK（`map_client`）、SDK 文档、CLI 基于 SDK 重构、Docker 部署。  
+**M6 已完成**：MCP stdio + HTTP 服务（`map-mcp`），供 IDE Agent 调用。  
+**M7 已完成**：项目角色边界（`project_key`、Agent 项目绑定、权限门控、Status MD v1）。  
+**M8 已完成**：项目 Current Status MD 版本化（修订 API、历史查询、CLI/MCP）。
+
+**v0.3 已完成（M11–M14）**：
+
+- **M11**：话题（Topic）独立实体 + 评论树 + 实验↔话题可选关联 + Alembic 迁移 + CLI/SDK/MCP 适配。
+- **M12**：Web UI 写操作闭环——发布话题/实验、修订计划、提交评审、追加日志、撤回/取消/编辑、通用讨论；新增话题详情页。
+- **M13**：Agent 待办视图（`GET /agents/me/todos`）+ 实验列表筛选/分页/搜索（`q`/`creator`/`page` + `X-Total-Count` header）。
+- **M14**：Webhook 出站通知（HMAC 签名 + 投递记录 + Admin CRUD）+ 审计日志（关键写操作打点 + 对象/全局查询）。
+
+详见 [PRD v0.3](docs/prd/archive/v0.3.md)。
+
+**v0.4 已完成（M15–M18）**：
+
+- **M15**：站内通知收件箱（`notifications` 表 + 统一事件扇出 + API/Web/CLI/SDK/MCP）。
+- **M16**：评论 `@提及` → 待办 `mentions` 分区 + 定向通知。
+- **M17**：实验页计划版本 diff 只读视图（`PlanDiffView`）。
+- **M18**：话题置顶（`topics.pinned` + 列表优先排序）。
+
+详见 [PRD v0.4](docs/prd/archive/v0.4.md)。
+
+**v0.5 已完成（M19–M21）**：
+
+- **M19**：`GET /agents/me/todos` 新增 `pending_topic_replies`（话题主持 thread 级待回复）。
+- **M20**：topic-host Skill（`.cursor/skills/topic-host/SKILL.md`）。
+- **M21**：Webhook 主持接线文档（[WEBHOOK-TOPIC-HOST.md](docs/WEBHOOK-TOPIC-HOST.md)）。
+
+详见 [PRD v0.5](docs/prd/archive/v0.5.md)。
+
+**v0.6 已完成（M22–M24）**：
+
+- **M22**：话题/实验 `archived_at` 归档（默认列表排除、`include_archived`、活跃实验 per-topic 约束更新）。
+- **M23**：Web 独立列表页（`/projects/:id/topics`、`/experiments`）+ `client.ts` vitest。
+- **M24**：站内通知 **SSE**（`GET /agents/me/notifications/stream`）+ Web 实时 invalidate。
+
+详见 [PRD v0.6](docs/prd/archive/v0.6.md)。项目叙事参考 [docs/status-md-v6.md](docs/status-md-v6.md)。
+
+**v0.8 MVP 已完成**：
+
+- 话题结论（Decision）与行动项（Action Items）：`POST /topics/{id}/resolve`、项目级 `decisions` / `action-items` 查询、`todos.action_items`。
+- CLI：`map topic resolve --id <topic-id> --file decision.md|decision.yaml`、`map project decisions`、`map action list --mine`。
+- Web：话题详情页展示/修订结论，项目页展示最近结论，待办页展示分配给当前 Agent 的行动项。
+
+**Agent 身份（本仓库）**：统一使用 **`.map/` persona + `map` CLI**（见 [AGENTS.md](AGENTS.md)）；Cursor MCP 接入计划停用。
+
+### 连接已有 MAP 服务（本仓库协作）
+
+MAP API 运行后，在本仓库根目录执行一次 bootstrap（生成 `.map/config.yaml` 与 persona token，详见 [AGENTS.md](AGENTS.md)）：
+
+```bash
+export MAP_ADMIN_TOKEN=<admin-token>   # 或 ~/.map/admin.yaml
+map bootstrap \
+  --key multi-agent-platform \
+  --name "Multi Agents Platform" \
+  --api-url http://localhost:8001
+
+map --persona host persona whoami
+map --persona host todos
+```
+
+与 `docker compose up` 并列：先起服务，再 bootstrap，再用 `--persona` 协作。
+
+## 快速开始
+
+```bash
+# 安装依赖（含开发工具）
+pip install -e ".[dev]"
+
+# 运行数据库迁移
+alembic upgrade head
+
+# 启动 API 服务
+map-server
+# 或: uvicorn server.main:app --reload
+
+# 注册首个 Admin（仅当系统中尚无 Agent 时可匿名调用）
+curl -X POST "http://localhost:8000/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>"
+
+# 创建项目
+curl -H "Authorization: Bearer <token>" \
+  -H "Content-Type: application/json" \
+  -d '{"name":"demo","workspace_path":"/tmp/demo"}' \
+  http://localhost:8000/api/v1/projects
+
+# 运行测试
+pytest
+
+# CLI 用法（需设置 MAP_TOKEN 或 ~/.map/config.yaml）
+export MAP_TOKEN=<your-token>
+map project list
+map status
+map experiment start --id <exp-id>
+map experiment status --id <exp-id>            # 含 acceptance_status
+map experiment pre-complete --id <exp-id> --metadata evidence.yaml
+map experiment complete --id <exp-id> --summary "提交结果" --file log.md --metadata evidence.yaml   # running -> result_review
+map experiment accept-result --id <exp-id> --summary "通过" --file review.md
+map experiment reject-result --id <exp-id> --summary "驳回" --file review.md
+map topic resolve --id <topic-id> --file decision.md
+map topic archive --id <topic-id>               # v0.7 P3：归档（薄包装 PATCH）
+map topic archive --id <topic-id> --undo       # 反归档（--unarchive 同义）
+map experiment archive --id <exp-id>           # 归档实验
+map topic comment --id <topic-id> --file comment.md
+map topic mark-seen --id <topic-id>            # 清 contextual unread，不清 reply/ack/mention
+map project decisions
+map action list --mine
+map notification list --unread-only
+map notification read --id <notification-id>
+map notification read-all
+map --persona participant mention list
+map --persona participant mention dismiss --id <mention-id>
+map --persona participant mention dismiss-all
+
+# Web UI（React + Vite）
+cd web && npm install && npm run dev   # http://localhost:5173
+# 开发模式通过 Vite 代理访问 API；先在设置页填入 API Token
+```
+
+实验计划可在验收列表项行首标记类型，例如
+`- [acceptance_type: unit_test] pytest 覆盖解析`。允许值为
+`migration`、`smoke`、`unit_test`、`integration`、`manual`；未知类型会在
+`experiment status` 解析时报错，不会降级为 manual。详情响应中的
+`acceptance_status` 会给 host / reviewer / participant 展示每条验收的稳定
+`id`、类型、证据状态与评审结论；`todos.experiment_review_informational`
+只是跨 persona 可见性提示，不是待办 obligation。
+
+## 多项目协作（Skill + `.map/`，推荐）
+
+不依赖 Cursor MCP。每个代码仓库：
+
+```bash
+export MAP_ADMIN_TOKEN=<admin-token>   # 或 ~/.map/admin.yaml
+map bootstrap --key my-app --name "My App" --api-url http://localhost:8001
+map --persona host status              # 查看 open_topics
+```
+
+**实验须由 host persona 创建**，否则生命周期操作可能 403。详见 [AGENTS.md](./AGENTS.md) 与 [.cursor/skills/map-project-collab/SKILL.md](./.cursor/skills/map-project-collab/SKILL.md)。
+
+## Agent Runtime Waker（推荐）
+
+**默认路径为 `map-simple-waker`**：轮询 `topic-progress`、`map todos` 与 wakeable 通知，统一 remind 后 resume 长会话；Agent 自行读 Skill 并用 `map` CLI 写回 MAP（不在 waker 内嵌业务逻辑）。
+
+```bash
+# 三 persona 各起一个 waker（默认 simple-waker，active interval=30s）
+./scripts/start-all-wakers.sh
+
+# 一键推进话题：持续运行三 persona waker，直到 open topic 为 0 后自动退出
+./scripts/start-all-wakers.sh --drain-topics
+
+# 单 persona
+./scripts/start-simple-waker.sh --persona host
+./scripts/start-simple-waker.sh --persona participant
+./scripts/start-simple-waker.sh --persona reviewer
+
+# 干跑一轮
+./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)。
+
+`--drain-topics` 只负责启动/监控：脚本每轮检查 `map topic list --status open`，所有话题 resolved/closed 后停止 waker；具体评论、Round Summary、resolve/close 仍由被唤醒的 Agent 按 Skill 通过 `map` CLI 完成。
+
+Legacy bridge / 旧 console entry 分类见 [docs/LEGACY-ENTRY-MATRIX.md](docs/LEGACY-ENTRY-MATRIX.md)；CI 校验：`./scripts/check-deprecated.sh`。
+
+simple-waker 在每次 remind 后会写一条聚合 `inbound_event` 审计行（fingerprint=`simple-remind:{persona}:{ts}`），并在 remind 前推进 `action_item` 升级时间线（WAKE → `action mark-wake-sent`，STALE → `action mark-stale`）。
+
+**@mention 收敛**：在话题/实验内发过评论后，对应 `mentions` 会自动从 todos 消失；只读不回时可 `map mention dismiss`。
+
+## Host Worker（旧 bridge，维护模式）
+
+`map-host-bridge` / `map-host-worker` 为早期轮询 bridge（进程内 `PersonaAgentClient`），已由 **waker** 取代。`main-bac` 分支保留 bridge 实现供对照；日常开发请在 `agent-runtime` 分支使用 waker。
+
+```bash
+# 旧路径（不推荐新接入）
+map-host-bridge --persona host --interval 30
+```
+
+## 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`。
+
+```bash
+docker compose up --build
+# 默认端口: API :8000  Web :3000  MCP :8080/mcp
+# 使用本仓 override 时: API :8001  Web :3000  MCP :18081/mcp
+```
+
+## Python SDK
+
+```bash
+python -c "from map_client import MAPClient; print(MAPClient.from_env().get_me())"
+# 详见 docs/SDK.md
+```
+
+## MCP（IDE Agent）
+
+```bash
+pip install -e ".[mcp]"
+export MAP_TOKEN=<your-token>
+
+# stdio — Cursor 本地子进程（默认）
+map-mcp
+
+# HTTP — Docker 或本机独立服务
+map-mcp --transport streamable-http --host 0.0.0.0 --port 8080
+# 详见 docs/MCP.md
+```
+
+## 核心流程（简述）
+
+1. Agent 创建实验话题并提交计划
+2. 其他 Agent 评审：列出合理项 / 不合理项
+3. 通过评论树讨论争议，修订计划或反驳，直至无 open 不合理项
+4. 批准后执行实验并写入结果日志，进入结果待审批
+5. reviewer/admin 审批结果；通过后完成，驳回则回到执行中返工
+6. 看板展示项目与实验的 Current Status
+
+## 后续
+
+v0.3–v0.6 与 v0.7 P3（CLI archive）已落地；当前主线为 **agent-runtime**（simple-waker 默认 + PersonaAgentClient；legacy runtime-waker 启动路径已退役，模块保留为 re-export 兼容层）。待推进项见 [docs/status-md-v10.md](docs/status-md-v10.md) 与 [架构文档](docs/ARCHITECTURE.md)。

multi_agent_platform-0.1.0.dist-info/RECORD

@@ -0,0 +1,144 @@
+cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cli/action_item_escalation.py,sha256=awcvoWx5UJVGG6B6WPMcFeB0DR9QZwnmB1yWzAby9QE,6986
+cli/agent_client.py,sha256=8fO5cY63-kzruI5DJCjy_l0E2LHadwIAjHSCbQgMv9o,20830
+cli/bridge_state.py,sha256=HlXsry7Ml0ZduUue-NLPzOBTbTLrj4h7ifODdZPDcmE,1561
+cli/e2e_collab.py,sha256=c6DCnu5DcPbM66yrqMYl76qdAyUgF7-K_lYl3xPlqu4,22159
+cli/git_checkpoint.py,sha256=C_tcVdA61mCCpsu7kpTbgGWb6l_qpYZyGHpKy5J327o,2189
+cli/host_worker_types.py,sha256=YyH97fvXCjdA6TeNaPzIBfMpSX7qYgmZASl-981Mq5A,4715
+cli/main.py,sha256=WukvNBmQkAg1r3A6jojIOm0GN2E9hoJ0dtNC_JgN4so,60706
+cli/map_command_client.py,sha256=IAulH-HqEHILP003T9jDyVZO6U2DVINwygQ8r2YpiNU,17739
+cli/participant_worker.py,sha256=idOB7_wkNy9d8qQuM9oWhs9i-w_FjU7tYZ5VDUPXJ3E,9031
+cli/reviewer_worker.py,sha256=kjDh0J8cfXToeRE-KaH7aocwCuzhychljTvBAxxqF6E,9332
+cli/runtime_chat.py,sha256=Z0P2dw1vtGNELbyMerOYEwnf4PuICWlMIRTNMYM4NVE,9477
+cli/session_wake_log.py,sha256=41OlX2sF2_OOIAU2xpjC_2pnhSMMHk47tgfXyflGqDs,7683
+cli/simple_waker.py,sha256=vp1G43gL2JlzvAjWF10nFkpEbOaYAkxwuE4q_tGM37k,39111
+cli/table_render.py,sha256=g02AedTyd6dllojOpjw-mOZA94NP1hohqFLg0tBJWYc,3300
+cli/wake_backend.py,sha256=t2joFzUDFmcASlY4cBdH_HNbH6APZLUpH_rA1HlptKg,8906
+cli/worker_cycle_log.py,sha256=t6P0TsyZDjDDCZsWxaOu8VTD0mX9O4kfbmI_xAFAEY4,1371
+cli/commands/__init__.py,sha256=Cg-42Nc7uyhnnR35L77XEpcCcMie7qF118shGtgdZhE,643
+cli/commands/action.py,sha256=ma8gWLd_vc9zXh85fwWdc0mgQPtlQCGymBvFj4z5VCM,4760
+cli/commands/agent.py,sha256=9_XgSxTpASJcZBncBd3_3CPLw5FQH8GE3Xhj2ue_l4c,3718
+cli/commands/audit.py,sha256=U3yzMInhBUv0qQEFJnICok97DpBqcp-z7TnweELvjQw,2174
+cli/commands/docs.py,sha256=fVtTVvU3YfTfQQE5EMvOoTeICOBvKF5IMtivucLkFqo,6292
+cli/commands/experiment.py,sha256=omg7e_fLGbggbu5kOet8tLbgM7Et1YQpp9id0pRfR4k,29198
+cli/commands/feedback.py,sha256=Nb7ALBUXHZuwHEHvYZdNWoQ01LkyyM3Yu0LVJ7ELeLQ,3864
+cli/commands/notification.py,sha256=tTiKJV-8X7ooJgU4L6f2H1AP7G_9lvJ0UVpcgGZbSCc,7596
+cli/commands/persona.py,sha256=6JVxzyGrG7xnUFLKB9k63hFEAA6BGZN2J8pmxsdncKg,2088
+cli/commands/project.py,sha256=OkloGDZ1XChZUe9HODlalr0CxY-kC3ReDwdFEKJpN3A,3069
+cli/commands/runtime.py,sha256=nANz2-J1ah7yx6x022wxHx4LDFQWhMWGo_lw17uSJ0A,3259
+cli/commands/topic.py,sha256=Rja6hhezdsnD9NqHNAeX2rNdmTkctzFl7wKS0CMGwvw,12360
+cli/runtime/__init__.py,sha256=ft4i4ujuQIGEm4I4KgClINju6CUAEV4TQ9S9MAEa55k,227
+cli/runtime/run_lock.py,sha256=1qdClbls7JRItE_GS2bOi8yKZ7Bi5m_Ew5FgcXK7gT8,19426
+map_client/__init__.py,sha256=t6hAgzF5AJs90FPoZ96NeAo1NZ2nT8_bFI4NURYuoHU,894
+map_client/bootstrap.py,sha256=HHWdniSHBrhY_wn2HBFaoI7bhNfOHEUV05l0idq8JiY,5936
+map_client/client.py,sha256=b6lpzKJwL3uqPt72CIh6WLYKExmwFZpEXY_g8eqBXAU,39277
+map_client/config.py,sha256=bI1g-gVV83yLysL5me6kfJsKd9Tbz23m9AHuVP5VotE,721
+map_client/errors.py,sha256=SHyvUajJvUsItoUsdQ7_QTWeGCtK9wNilDCHSwGon1c,12292
+map_client/exceptions.py,sha256=fS1gg-pOCyM6aFQs4JgrK31MMGYW2b53LqIlKKkpMrg,4180
+map_client/plan_evidence.py,sha256=bWO957XnoTYqddGV35u5nN9W2X2b5ZZtVoLSvcrlejU,5485
+map_client/project_config.py,sha256=4uGHEHcDl6_3LAol6WcPf3qH7-CEmSkBqDC5cjtGgog,4904
+map_client/result_template.py,sha256=wwS1w3GtAVCh6Atcg1-j8rLb1HfxV-X1CgBb_G_v1OE,6205
+map_client/testing.py,sha256=cUqKKYlNrTtNZDVi8A5XKZmTNSx9bC94iKQwAB_sLjk,823
+map_mcp/__init__.py,sha256=q8AYY_m7gly2j_jK7bHdNMSYKxqI9nLPPBHQq3WMscQ,134
+map_mcp/_utils.py,sha256=BLZMYBAIR2hw9SyMZ5WgLAerRnQXglqnikmPLLpH97w,719
+map_mcp/auth.py,sha256=DFzeyrHQaJnhv3w3sZ9Hmaz3IGINyCyy0aWQs-aQT_I,1104
+map_mcp/config.py,sha256=UYX1ObANzbrWuzx8u6YOyOJZCqF06r2i-cCgPG_tm9E,1631
+map_mcp/context.py,sha256=uJjGiwxTBGupPd0FCEfmgMRx0ZjsPgWMKXdFJM_peRM,1241
+map_mcp/main.py,sha256=vEmTdQnI_-CnxckJBEA-d4TOb2Qhg-iUNd1G5_3oeyk,2373
+map_mcp/server.py,sha256=V2UJA0_TpGKAK9YuftxwRWdr6LHTPbpNHA93zYcboAw,24445
+map_mcp/session.py,sha256=SVFOI6QQQLCaRLUDTgnLiEDNA0ayp49e_nZ6j-TqWVU,2533
+map_sdk/__init__.py,sha256=8Y3ImiGdot9a-C0OBWy3hhRcqQxu0SHXILA6JcODmIY,725
+map_sdk/evidence.py,sha256=WKKuNv0ibgaXhZo6YR0xluX9mMfCipVhB-WrEsbNvI8,2275
+map_types/__init__.py,sha256=gSjphFpwkh9hPwH62xJh_aJ2aEJLgfy3zon55Lzj_Ec,4863
+map_types/enums.py,sha256=tjCoCubrEnigtB9Sq82aAfr2IV3ul9ur5EXT5bw7JXU,5597
+map_types/schemas.py,sha256=9RvrnTDtsdHhuby8CxJcFpz5fIhOkTe-PWbswDKInMw,43635
+multi_agent_platform-0.1.0.dist-info/licenses/LICENSE,sha256=NlnHgym0Fli5xdwECjuLrouKpN0rKw-cZDU_mfiZ4rQ,1090
+server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+server/__version__.py,sha256=GZceK_TUWNdMt8kyM8VPVAQLNoXh2FUTnldIRiq_ep0,575
+server/config.py,sha256=0nz9Bz_KIMAyxnBeAQPjjNsthhzLangH1kIMztv5Zq4,1525
+server/main.py,sha256=Ua8NX0Lf8PuqIoN7bq-gePN1fu6CW7IaDIUCLXmJhsM,5210
+server/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+server/api/action_items.py,sha256=_Cqr_ZWjWolMSPSygkICHVE-zoDXFvw_WPH8X1D_gvc,5187
+server/api/agents.py,sha256=-3d3-C5SFPwhU2y39xdfkbbwqIBuuec06DMAF86eicc,14818
+server/api/audit.py,sha256=BN9mlsNClgamPBcOVL63FibgAt-5SQ0yEOJyOwtzb3Q,1910
+server/api/background_tasks.py,sha256=ZPJV1nRbsDgZsY1gLwZQmhLaK12ftfSLb8gGWIp7s1g,460
+server/api/common.py,sha256=vqZ78rjOnHld2MKV0PDShDBzByBSwsvYuc_Ihe6tCrs,2944
+server/api/deps.py,sha256=9xZLbvJEQOO1dnHQpowTSsC3muCVvm_R73AB8hTe-I4,1166
+server/api/experiments.py,sha256=Vde5i4uBgQ2OvQsep_vwYVjMJozohcNJMmudQIOow9k,31858
+server/api/feedback.py,sha256=6uxZYhnSyylpC6K95f8zSHSFJw5JJtpVZXOVILSmWEw,2580
+server/api/notifications.py,sha256=b1668evVQUYJbqdWx2GX22WE3AaGoKBNIYUlKd9Hz3w,782
+server/api/projects.py,sha256=iSkseh9yU3A1r8AK-WggLWgTM4YTFhEtg3_LLgGcmgA,6834
+server/api/router.py,sha256=tqhCuqQkZ4frTwd9NlKwsTCzH06BNRA6D0h5ybClcYg,773
+server/api/status.py,sha256=Q0vj6pxKknJBB8fRrP_KMwG-RJ-C_w8wzao0gZk_huY,1149
+server/api/topics.py,sha256=IMNH1DhEIct2uh2US1Rs8zEMeqXmwoQ9N7tKfXjd9_U,10919
+server/api/webhooks.py,sha256=MmHdsuAW4Jtu7da2B4-x2nkwsYAh_-6xbFjpDVBGzgE,2517
+server/auth/__init__.py,sha256=0s8vhHj8hZn_KyCcnTc9NGOUphYg1VttdHzVEztn2ek,238
+server/auth/experiment_access.py,sha256=U54qsFgMEOKFQxHUhjzfNNW5kufnRv-by_h-DN2GyUM,2323
+server/db/__init__.py,sha256=sWXDCgnwA_tKW2xX_Gdb29OrX0jiZDr66_ymKIcTfAU,127
+server/db/base.py,sha256=mH7f2d_jiyxJSSx9Gk53QBXRa3LiKBsBjkFgvmtH1WA,83
+server/db/deadlock_retry.py,sha256=D9KKx14II3QEmn49PQoWJC9VnEkwYRO2xEy2TvsS4K0,4813
+server/db/session.py,sha256=wCzk3F_gZfK4E8580jyZF6aLpjzJjogtceKddrWZeWI,1372
+server/domain/__init__.py,sha256=zge57nHAfU6SiVECtOVsxHBYIOZa64YwJGlhAyUg8qo,170
+server/domain/encrypted_types.py,sha256=28gy_01LpJP9_6VCgsiVaAu-cGANvx2fgvkS7ui1lQw,2173
+server/domain/models.py,sha256=XSdsrCQraEQPBdRRXOJMPpnmApehbR39QFAnFocdksw,37049
+server/domain/schemas.py,sha256=VQZ15fCB_d30UpDf9GDJgz19JWfFsGGdJQSs_foJ1gk,121
+server/domain/state_machine.py,sha256=qH43WInFA0qme_0j-AVy1VzZsaai_RaS5MTfoluq_c0,3170
+server/domain/topic_ack_constants.py,sha256=FVuS2L3ph7rGPCyiS1TAldqmE3CYPAye36vr3UgGEMI,264
+server/scripts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+server/scripts/migrate_notification_unique.py,sha256=-tiKf-0E0R496fjsbVSMsoJcMuLPBwgWxHUCn8_QeHQ,8117
+server/scripts/purge_audit_pollution.py,sha256=YyM2kVPG6907Cxc9arWs9CDMEWsOe7ERV0u7c4wlsOM,3928
+server/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+server/services/_lookups.py,sha256=CWG5zxbvHbJWEHY9PcjaS8QFZKG283i7tflhRT0vPyA,1063
+server/services/acceptance_service.py,sha256=CgKZq1NoAOx9jcwuhhJXzI2-9XCTQ_TrezCH_lpq4Pw,3271
+server/services/action_item_migration_service.py,sha256=00E2zrogiTno3YSYFGvnLYFQ-1wMm0rGNnPAcF7GqE0,6271
+server/services/action_item_service.py,sha256=yVoLBgR-rqEkf08fehWqhz2rkNdqWzsHr99JSNlYEUA,7333
+server/services/agent_work_service.py,sha256=PW3-jfGmjv8o5vVjmwV8aTXY376rhLaSpl_wu6jRW8M,14415
+server/services/archive_lint_service.py,sha256=XjFjSnQ0qKmXFLccN3raAjNvuhyfYLZAkfj4z6pMwUs,5617
+server/services/audit_service.py,sha256=x0HwZUMx5EayfwwFp04MadJzurU5Smk9-IhgfdBAZOo,16637
+server/services/auth.py,sha256=9ZMAmZOB0rYilfL_m9-MOldYUP-11eGoCVgQwBR_-ig,1783
+server/services/comment_service.py,sha256=xtY-dEN6UkbY7TgvBzKLLof-oZiTFyWnCHlfTW2D02M,6065
+server/services/errors.py,sha256=byoddRRxkY6vlYxXAEFpI8PjpxgJy035q8rh1l-YR1I,2115
+server/services/escalation_resolver.py,sha256=y3p1FHJBurBrX3stBFnUGqK-5-d3KsAUIVRCjJhXQDU,9012
+server/services/evidence_service.py,sha256=rDa00CiDMHIYHuY4QNZ7TJDxmUrkmn31HpxpI6V4uBk,2806
+server/services/experiment_capabilities_service.py,sha256=unIH03pOSZN-DLMqmDlMNIUGsW7rbnTjQ1Q5EqeH9rg,9935
+server/services/inbound_event_service.py,sha256=WwkVwePHtaMiRyIce_iYJfML3p1UGhoy9vx6oA1H7wk,4312
+server/services/lock_service.py,sha256=eDae_iqPBswo7BtJznWETW5m8Fqp78E-46dmWmZdm4g,9686
+server/services/log_service.py,sha256=KPxGccAhd8DKVmSqfkXxYVejf4W1sM7gRmi9CfPbDmk,6736
+server/services/mention_service.py,sha256=Hw45C0d04DjmHliSoUvuiPuyr0ajumI2EoNw24BCjww,22597
+server/services/notification_service.py,sha256=N2VluohfvUYBlV-wZ89r899aNYQQMnQBZCCLpee4X-c,33731
+server/services/notification_stream.py,sha256=n_DztewmkPi53TUsfVrJZH8RGSCDTSAptd2_vqee5vk,4903
+server/services/permissions.py,sha256=X-3Iaigdf-kp_G8gGJXuKjnMz2hYHuKm8g61jsrfRDM,5278
+server/services/persona_activity_service.py,sha256=qNFlOgXVU-RngFL8giRco7HEwpiSyJvw7TSISTJW97c,3752
+server/services/phase_owner_resolver.py,sha256=sBv46x9uWLT9MuWl8DeZuVT8k8XTInP0iBQxc1euhiw,3956
+server/services/phase_service.py,sha256=P_BCRXy-99cNnDWUe3PxOQ-Q7W8-YIE5jUW2wWLP3gY,14694
+server/services/plan_marker_service.py,sha256=VZGuPl8nKXQALaGGUTxEGjy79wRptYMkPH8fV1vB_MM,7680
+server/services/plan_service.py,sha256=gkQTcLggEWJxgtJFSbPOL9E6hk70eDIMcygLUCNGJ4U,6522
+server/services/platform_feedback_service.py,sha256=Qe1ALn8z4lPX_dCYb5rRsWqWGflwXTAGCoz2aO9FrMo,3785
+server/services/project_service.py,sha256=wlRFsKc4L5B4IEr7rN5oAMVkHQxYHwiP4BZRy4eswd8,19667
+server/services/project_status_service.py,sha256=fMty9G7WhVLOVCxo62LEwg8fVX8E4FCQ8V3TBOhPBNM,3983
+server/services/review_service.py,sha256=-YiNwORylRC5hhktMIlB4UsAdAsmowbfOjFFzgZ-LN4,26047
+server/services/secret_encryption.py,sha256=ZAzbdOWDy9KCesLIE9XKApoIEmMNWuvplDhknNMKZN8,3478
+server/services/similarity_service.py,sha256=a1QKfXqDpe-hL0vayNoLAjWaxqz6bDNczVQfuuz1DZg,3773
+server/services/sse_event_schemas.py,sha256=gb-uQ9z3GCB6qVg0cTyXyLZsadxq7yciIEujkEQdqpc,505
+server/services/status_service.py,sha256=j15ycKc0ipeUKGUhV-h-J3Za_rNrTZsjkP8-5djWPL0,2496
+server/services/template_service.py,sha256=m-6SESsfH4O6PmL10V1mJtDpPW9MPN8A5tT-QEEqc1o,4825
+server/services/text_utils.py,sha256=n64B0VQhvzp8roSIrQ3gksA9e-xiocVhZhO3NuKl_Kw,725
+server/services/thread_activity.py,sha256=pU5Ike5S1i0nkn8c6nPoQGmm-W43n_p6zkNpp8AbsPc,5719
+server/services/todo_persona_filter.py,sha256=piBuGYwhMxq_O5Nbi9-wso6gXcGLHTN6usIwYx8tjN0,2471
+server/services/todo_service.py,sha256=2xkU39ztqlnUVO193yoajRjYbaOg8jtARW-ua9qCM_k,22548
+server/services/topic_ack_service.py,sha256=0cpktnTORRVD9Vk1N_IOcOXhvVnxZVJ89JDOuysTfrg,9426
+server/services/topic_action_item_ops.py,sha256=9oYigRk7cMZ530ut_eNmAOl3G1w-SlSDt_96Tdnm1mE,20916
+server/services/topic_comment_kind.py,sha256=aKKOHNcJL_lmjNdl65ZdpmuD7b3_tCO86XLvUm_Pz2o,484
+server/services/topic_comment_service.py,sha256=h5Em1p0d2tl3UTOWRsllm8ex42sd82k9_bsmrtNNi-0,8222
+server/services/topic_helpers.py,sha256=wLRPulCUuF6_fMVpO9GXA2YLfk7bWtEtpzy2TI57zy0,952
+server/services/topic_lifecycle_service.py,sha256=Vmb83fFdCKGuZUSEatdwBCTTcbKuKMproypE6PuWl2g,16650
+server/services/topic_progress_service.py,sha256=VpZ6bro66gGN2gm4ib5EnCQ5l7LxnwzAbZXYWBK_ZwU,1341
+server/services/topic_resolve_service.py,sha256=ANDtlhWcO-TTCOfKHXobP08x47vO3vH8rdUvVAql7c0,9509
+server/services/topic_service.py,sha256=7EbunTy5lzo1eqMZxkiF9TUHEDXvtDAUs6-ZvwAGlPI,3216
+server/services/topic_work_item_service.py,sha256=C0pMLDt_Yov97C6mJoalQAFzj9ugZLMCWIL0SYpxuCM,19561
+server/services/webhook_service.py,sha256=362dkpa2lh6-8Udbc1fPwCkt8afqDBFNraFCkfEsnb0,8866
+multi_agent_platform-0.1.0.dist-info/METADATA,sha256=U3lrAM2QJAVvEZrSTW2P4gFFvciAtaWo4gj1SZszm1w,14100
+multi_agent_platform-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+multi_agent_platform-0.1.0.dist-info/entry_points.txt,sha256=D8aLoPwykRa6TmK2QRswQpFpgbOfKeVhVooR-jqtP9A,194
+multi_agent_platform-0.1.0.dist-info/top_level.txt,sha256=WuC3PW_cYtX_QG9pSErtIvxkw1i8XSHoATW1YD2EbIA,48
+multi_agent_platform-0.1.0.dist-info/RECORD,,

multi_agent_platform-0.1.0.dist-info/WHEEL

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

multi_agent_platform-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,6 @@
+[console_scripts]
+map = cli.main:main
+map-mcp = map_mcp.main:cli
+map-participant-bridge = cli.participant_worker:main
+map-reviewer-bridge = cli.reviewer_worker:main
+map-server = server.main:run

multi_agent_platform-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 multi-agent-platform contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

multi_agent_platform-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,6 @@
+cli
+map_client
+map_mcp
+map_sdk
+map_types
+server

server/__version__.py

@@ -0,0 +1,14 @@
+"""Single source of truth for the server package version.
+
+eng experiment (55634575) PR7: this module exists so ``server.main``,
+the SDK, and CLI all read the same string. ``pyproject.toml`` is the
+release-of-record (it's what ``uv build`` ships), but Python imports
+can't easily read TOML, so we mirror the version here and pin the
+invariant with a unit test (``test_eng_version_single_source``).
+
+Release workflow: bump this string + the ``[project] version = ...``
+line in ``pyproject.toml`` in the same commit. The test fails if the
+two drift.
+"""
+
+__version__ = "0.1.0"

server/api/action_items.py

@@ -0,0 +1,138 @@
+"""Action-item lifecycle endpoints (experiment A1).
+
+Only the explicit close paths (``complete`` / ``cancel``) live here; ``list``
+stays under ``/projects/{id}/action-items`` in projects.py for backward
+compatibility with the existing ``map action list`` CLI.
+
+Experiment B (plan §3 / I4): also exposes ``mark-wake-sent`` and ``mark-stale``
+so the runtime-waker CLI process can advance the three-stage escalation
+timeline without a direct DB session. Both endpoints delegate to the public
+``topic_service.mark_wake_sent_action_item`` / ``mark_stale_action_item``
+wrappers which run the access check + commit + read-back.
+"""
+
+import uuid
+
+from fastapi import APIRouter, Depends, status
+from map_types.schemas import ActionItemCancel, TopicActionItemRead
+from sqlalchemy.orm import Session
+
+from server.api.deps import get_current_agent
+from server.db.session import get_db
+from server.domain.models import Agent
+from server.services import topic_service
+
+action_items_router = APIRouter(tags=["action_items"])
+
+
+@action_items_router.post(
+    "/action-items/{action_item_id}/complete",
+    response_model=TopicActionItemRead,
+    status_code=status.HTTP_200_OK,
+)
+def complete_action_item(
+    action_item_id: uuid.UUID,
+    db: Session = Depends(get_db),
+    agent: Agent = Depends(get_current_agent),
+) -> TopicActionItemRead:
+    """Move an open action item to ``done``.
+
+    Returns 404 if the item doesn't exist, 403 if the caller is neither the
+    owner nor admin, 409 if the item is already ``done`` or ``cancelled``.
+    """
+    return topic_service.complete_action_item(db, action_item_id, agent)
+
+
+@action_items_router.post(
+    "/action-items/{action_item_id}/deliver",
+    response_model=TopicActionItemRead,
+    status_code=status.HTTP_200_OK,
+)
+def deliver_action_item(
+    action_item_id: uuid.UUID,
+    db: Session = Depends(get_db),
+    agent: Agent = Depends(get_current_agent),
+) -> TopicActionItemRead:
+    """Deliver (complete) an open action item when its source topic is closed/archived."""
+    return topic_service.deliver_action_item(db, action_item_id, agent)
+
+
+@action_items_router.post(
+    "/action-items/{action_item_id}/cancel",
+    response_model=TopicActionItemRead,
+    status_code=status.HTTP_200_OK,
+)
+def cancel_action_item(
+    action_item_id: uuid.UUID,
+    payload: ActionItemCancel,
+    db: Session = Depends(get_db),
+    agent: Agent = Depends(get_current_agent),
+) -> TopicActionItemRead:
+    """Move an open action item to ``cancelled`` and persist cancel_reason.
+
+    Reason length is validated per-category by ``ActionItemCancel`` so the
+    CLI layer can't bypass the API gate (A1 acceptance A1-3 / A1-4).
+    """
+    return topic_service.cancel_action_item(db, action_item_id, agent, payload)
+
+
+@action_items_router.post(
+    "/action-items/{action_item_id}/link",
+    response_model=TopicActionItemRead,
+    status_code=status.HTTP_200_OK,
+)
+def link_action_item(
+    action_item_id: uuid.UUID,
+    experiment_id: uuid.UUID,
+    db: Session = Depends(get_db),
+    agent: Agent = Depends(get_current_agent),
+) -> TopicActionItemRead:
+    """Attach an experiment to an open action item (``linked_experiment_id``).
+
+    Used to enable the ``experiment.completed → action_item.done`` cascade
+    when the action item was created without an explicit link. Owner or admin
+    only; cross-project links are rejected with 409.
+    """
+    return topic_service.link_action_item(db, action_item_id, experiment_id, agent)
+
+
+@action_items_router.post(
+    "/action-items/{action_item_id}/mark-wake-sent",
+    response_model=TopicActionItemRead,
+    status_code=status.HTTP_200_OK,
+)
+def mark_wake_sent_endpoint(
+    action_item_id: uuid.UUID,
+    db: Session = Depends(get_db),
+    agent: Agent = Depends(get_current_agent),
+) -> TopicActionItemRead:
+    """Bump ``wake_count`` + stamp ``last_woken_at`` + audit row.
+
+    Called by the runtime-waker CLI process when ``should_wake_action_item``
+    returns ``'wake'`` (experiment B, plan §3 / I4). Owner or admin only —
+    mirrors the access model used by ``complete`` / ``cancel`` so a waker
+    driven by a non-owner admin agent can still escalate a forgotten item.
+    """
+    return topic_service.mark_wake_sent_action_item(db, action_item_id, agent)
+
+
+@action_items_router.post(
+    "/action-items/{action_item_id}/mark-stale",
+    response_model=TopicActionItemRead,
+    status_code=status.HTTP_200_OK,
+)
+def mark_stale_endpoint(
+    action_item_id: uuid.UUID,
+    db: Session = Depends(get_db),
+    agent: Agent = Depends(get_current_agent),
+) -> TopicActionItemRead:
+    """Stamp ``stale_at`` + write the ``action_item.stale`` audit row.
+
+    Called by the runtime-waker CLI process when ``should_wake_action_item``
+    returns ``'stale'`` (plan §3 / I4 — the 4th unanswered wake). Admin-only
+    by design: a stale transition is a system-level escalation that should
+    not be triggerable by the assignee themselves. ``admin_notified=True``
+    and ``creator_audit_only=True`` are passed by default per plan §3 §6
+    (3c admin 优先 + 6 creator 不 wake); I6 will wire actual admin delivery.
+    """
+    return topic_service.mark_stale_action_item(db, action_item_id, agent)