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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-agent-platform
-Version: 0.3.1
+Version: 0.3.2
 Summary: Multi-Agent experiment collaboration platform
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/quantaeye/multi-agent-platform
@@ -17,19 +17,21 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 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
+Requires-Dist: pydantic<2.12,>=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: bcrypt<6.0,>=4.2.0; extra == "server"
+Requires-Dist: python-multipart<0.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"
@@ -38,6 +40,7 @@ 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
@@ -47,18 +50,24 @@ Dynamic: license-file
 # Multi-Agent Platform (MAP)
 
 [![PyPI version](https://img.shields.io/pypi/v/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
-[![Python 3.11+](https://img.shields.io/pypi/pyversions/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
 [![License: MIT](https://img.shields.io/pypi/l/multi-agent-platform.svg)](https://github.com/quantaeye/multi-agent-platform/blob/main/LICENSE)
 
 多 Agent 实验协作平台：以话题为中心，管理实验计划、评审讨论、执行日志与项目状态。
 
 ## 安装
 
+两种安装方式，按需选择：
+
 ```bash
+# 1. 仅安装 CLI（连接远程 MAP server 时使用，轻量）
 pip install multi-agent-platform
+
+# 2. 安装 CLI + Server 依赖（需要本地运行 MAP server 时使用）
+pip install multi-agent-platform-server
 ```
 
-安装后即可使用 `map` CLI 和 `map-server` 命令。详见 [Quick Start 指南](docs/QUICKSTART.md)。
+安装后即可使用 `map` CLI；安装 server 包后还可使用 `map-server` 命令。详见 [Quick Start 指南](docs/QUICKSTART.md)。
 
 **新用户？** 一键启动：`./scripts/quickstart.sh`，或阅读 [Quick Start 指南](docs/QUICKSTART.md)。
 
@@ -124,7 +133,6 @@ map skill install          # 将 5 个 Skill 文件安装到 .cursor/skills/
 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" \
@@ -134,18 +142,21 @@ map --persona host persona whoami
 map --persona host todos
 ```
 
-与 `docker compose up` 并列：先起服务，再 bootstrap，再用 `--persona` 协作。
+与 `docker compose up` 并列：先起服务，再 bootstrap，再用 `--persona` 协作。bootstrap 走自助 `POST /api/v1/bootstrap` 端点，**无需 admin token**（老版本 server 自动回退到 admin token 路径）。
 
 ## 快速开始
 
 ```bash
-# 从 PyPI 安装（用户）
+# 从 PyPI 安装（仅 CLI，连接远程 server）
 pip install multi-agent-platform
 
+# 或安装 CLI + Server（本地运行 server）
+pip install multi-agent-platform-server
+
 # 或从源码开发安装（贡献者）
 pip install -e ".[dev]"
 
-# 运行数据库迁移
+# 运行数据库迁移（需要 server 依赖）
 alembic upgrade head
 
 # 启动 API 服务
@@ -225,7 +236,6 @@ cd web && npm install && npm run dev   # http://localhost:5173
 不依赖 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
 ```

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

@@ -1,18 +1,24 @@
 # Multi-Agent Platform (MAP)
 
 [![PyPI version](https://img.shields.io/pypi/v/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
-[![Python 3.11+](https://img.shields.io/pypi/pyversions/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
 [![License: MIT](https://img.shields.io/pypi/l/multi-agent-platform.svg)](https://github.com/quantaeye/multi-agent-platform/blob/main/LICENSE)
 
 多 Agent 实验协作平台：以话题为中心，管理实验计划、评审讨论、执行日志与项目状态。
 
 ## 安装
 
+两种安装方式，按需选择：
+
 ```bash
+# 1. 仅安装 CLI（连接远程 MAP server 时使用，轻量）
 pip install multi-agent-platform
+
+# 2. 安装 CLI + Server 依赖（需要本地运行 MAP server 时使用）
+pip install multi-agent-platform-server
 ```
 
-安装后即可使用 `map` CLI 和 `map-server` 命令。详见 [Quick Start 指南](docs/QUICKSTART.md)。
+安装后即可使用 `map` CLI；安装 server 包后还可使用 `map-server` 命令。详见 [Quick Start 指南](docs/QUICKSTART.md)。
 
 **新用户？** 一键启动：`./scripts/quickstart.sh`，或阅读 [Quick Start 指南](docs/QUICKSTART.md)。
 
@@ -78,7 +84,6 @@ map skill install          # 将 5 个 Skill 文件安装到 .cursor/skills/
 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" \
@@ -88,18 +93,21 @@ map --persona host persona whoami
 map --persona host todos
 ```
 
-与 `docker compose up` 并列：先起服务，再 bootstrap，再用 `--persona` 协作。
+与 `docker compose up` 并列：先起服务，再 bootstrap，再用 `--persona` 协作。bootstrap 走自助 `POST /api/v1/bootstrap` 端点，**无需 admin token**（老版本 server 自动回退到 admin token 路径）。
 
 ## 快速开始
 
 ```bash
-# 从 PyPI 安装（用户）
+# 从 PyPI 安装（仅 CLI，连接远程 server）
 pip install multi-agent-platform
 
+# 或安装 CLI + Server（本地运行 server）
+pip install multi-agent-platform-server
+
 # 或从源码开发安装（贡献者）
 pip install -e ".[dev]"
 
-# 运行数据库迁移
+# 运行数据库迁移（需要 server 依赖）
 alembic upgrade head
 
 # 启动 API 服务
@@ -179,7 +187,6 @@ cd web && npm install && npm run dev   # http://localhost:5173
 不依赖 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
 ```

{multi_agent_platform-0.3.1 → multi_agent_platform-0.3.2}/cli/commands/experiment.py

@@ -18,9 +18,7 @@ from map_sdk.evidence import (
     EVIDENCE_METADATA_KEYS,
     metadata_has_completion_evidence,
 )
-
-from cli.table_render import enum_value, format_datetime, render_table, short_uuid, truncate
-from server.domain.schemas import (
+from map_types.schemas import (
     ExperimentComplete,
     ExperimentCreate,
     ExperimentLogCreate,
@@ -30,6 +28,8 @@ from server.domain.schemas import (
     ReviewCreate,
 )
 
+from cli.table_render import enum_value, format_datetime, render_table, short_uuid, truncate
+
 experiment_app = typer.Typer(help="Experiment commands", rich_markup_mode=None)
 lock_app = typer.Typer(help="Experiment execution lock commands (per-project).")
 review_app = typer.Typer(help="Review commands")
@@ -128,8 +128,9 @@ def experiment_list(
     Defaults to a compact table view. Use ``--format yaml`` or
     ``--format json`` for full structured output (scripts / piping).
     """
+    from map_types.enums import ExperimentPhase
+
     from cli.main import _resolve_project, _run  # lazy: avoid cycle
-    from server.domain.models import ExperimentPhase
 
     def action(c: MAPClient):
         pid = _resolve_project(c, project, project_key)
@@ -544,7 +545,7 @@ def experiment_archive(
     """
     from cli.main import _require_option_uuid, _run  # lazy: avoid cycle
     experiment_id = _require_option_uuid(experiment_id)
-    from server.domain.schemas import ExperimentUpdate
+    from map_types.schemas import ExperimentUpdate
 
     payload = ExperimentUpdate(archived=not (undo or unarchive))
     object_kind = "experiment"
@@ -760,9 +761,10 @@ def experiment_comment(
     body_file: Path | None = typer.Option(None, "--file", help="Read body from a file (avoids shell-quoting issues)."),
     parent: uuid.UUID | None = typer.Option(None, "--parent"),
 ) -> None:
+    from map_types.enums import CommentAnchorType
+    from map_types.schemas import CommentCreate
+
     from cli.main import _read_text_file, _run  # lazy: avoid cycle
-    from server.domain.models import CommentAnchorType
-    from server.domain.schemas import CommentCreate
 
     if body is None and body_file is None:
         typer.echo("Error: either --body or --file is required", err=True)

{multi_agent_platform-0.3.1 → multi_agent_platform-0.3.2}/cli/commands/feedback.py

@@ -33,9 +33,9 @@ def feedback_submit(
     ),
 ) -> None:
     from map_types.enums import FeedbackCategory
+    from map_types.schemas import PlatformFeedbackCreate
 
     from cli.main import _read_text_file, _run  # lazy: avoid cli.main ↔ cli.commands.* cycle
-    from server.domain.schemas import PlatformFeedbackCreate
 
     if body is None and body_file is None:
         typer.echo("Error: either --body or --file is required", err=True)
@@ -94,9 +94,9 @@ def feedback_update(
     archived: bool | None = typer.Option(None, "--archived/--no-archived"),
 ) -> None:
     from map_types.enums import FeedbackCategory, FeedbackStatus
+    from map_types.schemas import PlatformFeedbackUpdate
 
     from cli.main import _run  # lazy
-    from server.domain.schemas import PlatformFeedbackUpdate
 
     payload = PlatformFeedbackUpdate(
         status=FeedbackStatus(status) if status else None,

{multi_agent_platform-0.3.1 → multi_agent_platform-0.3.2}/cli/commands/notification.py

@@ -188,9 +188,9 @@ def inbound_event_record(
 ) -> None:
     """Record that the caller is about to act on ``event_id``."""
     from map_types.enums import InboundEventSource
+    from map_types.schemas import InboundEventCreate
 
     from cli.main import _read_text_file, _run
-    from server.domain.schemas import InboundEventCreate
 
     extra_payload: dict | None = None
     if payload_file is not None:

{multi_agent_platform-0.3.1 → multi_agent_platform-0.3.2}/cli/commands/project.py

@@ -9,8 +9,7 @@ from pathlib import Path
 
 import typer
 from map_client.client import MAPClient
-
-from server.domain.schemas import ProjectStatusRevise
+from map_types.schemas import ProjectStatusRevise
 
 project_app = typer.Typer(help="Project commands")
 status_app = typer.Typer(help="Project Current Status commands")
@@ -124,7 +123,7 @@ def project_export(
     from cli.project_export import export_project_history
 
     if output_dir is None:
-        from cli.main import find_map_dir, _cli_options
+        from cli.main import _cli_options, find_map_dir
         map_dir = find_map_dir(_cli_options.get("project_root"))
         if map_dir is not None:
             output_dir = map_dir / "history"

{multi_agent_platform-0.3.1 → multi_agent_platform-0.3.2}/cli/commands/sync.py

@@ -10,7 +10,6 @@ from __future__ import annotations
 
 import json
 import uuid
-from pathlib import Path
 
 import typer
 from map_client.client import MAPClient
@@ -20,8 +19,8 @@ sync_app = typer.Typer(help="Local cache sync commands (offline browsing)")
 
 def _require_cache_session():
     """Open the local cache DB, exiting with a helpful hint if .map/ is missing."""
-    from cli.main import find_map_dir, _cli_options
-    from cli.local_cache import init_cache, get_cache_path
+    from cli.local_cache import get_cache_path, init_cache
+    from cli.main import _cli_options, find_map_dir
 
     map_dir = find_map_dir(_cli_options.get("project_root"))
     if map_dir is None:
@@ -46,8 +45,8 @@ def sync_pull(
     After pulling, you can browse topics and experiments offline using
     `map sync topics` and `map sync topic --id <uuid>`.
     """
-    from cli.main import _resolve_project, _run
     from cli.local_cache import pull_project_to_cache
+    from cli.main import _resolve_project, _run
 
     map_dir, db_path, session = _require_cache_session()
 

{multi_agent_platform-0.3.1 → multi_agent_platform-0.3.2}/cli/commands/topic.py

@@ -21,14 +21,14 @@ from typing import Any
 
 import typer
 from map_client.client import MAPClient
-
-from cli.table_render import enum_value, format_datetime, render_table, short_uuid, truncate
-from server.domain.schemas import (
+from map_types.schemas import (
     TopicAdvanceRound,
     TopicCommentCreate,
     TopicUpdate,
 )
 
+from cli.table_render import enum_value, format_datetime, render_table, short_uuid, truncate
+
 topic_app = typer.Typer(help="Topic commands", rich_markup_mode=None)
 mention_app = typer.Typer(help="Mention todo commands")
 todo_app = typer.Typer(help="Todo partition clear routing (explicit_only buckets)")
@@ -46,8 +46,9 @@ def topic_create(
     project_key: str | None = typer.Option(None, "--project-key"),
     description: str | None = typer.Option(None, "--description"),
 ) -> None:
+    from map_types.schemas import TopicCreate
+
     from cli.main import _resolve_project, _run
-    from server.domain.schemas import TopicCreate
 
     payload = TopicCreate(title=title, description=description)
 
@@ -102,8 +103,9 @@ def topic_list(
     Defaults to a compact table view. Use ``--format yaml`` or
     ``--format json`` for full structured output (scripts / piping).
     """
+    from map_types.enums import TopicStatus
+
     from cli.main import _resolve_creator_agent_id, _resolve_project, _run
-    from server.domain.models import TopicStatus
 
     def action(c: MAPClient):
         pid = _resolve_project(c, project, project_key)

{multi_agent_platform-0.3.1 → multi_agent_platform-0.3.2}/cli/main.py

@@ -22,6 +22,8 @@ from map_sdk.evidence import (
     EVIDENCE_METADATA_KEYS,
     metadata_has_completion_evidence,
 )
+from map_types.enums import AgentRole
+from map_types.schemas import TopicResolve
 from pydantic import BaseModel, ConfigDict
 
 # arch experiment (0519e2a3) PR3/PR5: agent / notification /
@@ -45,8 +47,6 @@ from cli.commands.skill import skill_app
 from cli.commands.sync import sync_app
 from cli.commands.topic import mention_app, todo_app, topic_app
 from cli.e2e_collab import e2e_app
-from server.domain.models import AgentRole
-from server.domain.schemas import TopicResolve
 
 app = typer.Typer(name="map", help="Multi-Agent Platform CLI", rich_markup_mode=None)
 # Sub-apps live in cli/commands/*; imported here only to register via

{multi_agent_platform-0.3.1 → multi_agent_platform-0.3.2}/cli/skills/map-project-collab/references/bootstrap-troubleshooting.md

@@ -4,14 +4,9 @@
 
 ## 首次 Bootstrap
 
-前置：MAP API 已运行；admin token 在 `MAP_ADMIN_TOKEN` 或 `~/.map/admin.yaml`：
+前置：MAP API 已运行。
 
-```yaml
-token: "<admin-api-token>"
-api_url: http://localhost:8001
-```
-
-在本代码仓库根目录：
+新版 server（>=0.4）**无需 admin token**——bootstrap 走自助 `POST /api/v1/bootstrap` 端点。直接在本代码仓库根目录运行：
 
 ```bash
 map bootstrap \
@@ -20,6 +15,13 @@ map bootstrap \
   --api-url http://localhost:8001
 ```
 
+> **老版本 server 兼容**：若连接的 server 无 `/bootstrap` 端点（<0.4），CLI 自动回退到 admin token 路径。此时需先准备 admin token，写入 `MAP_ADMIN_TOKEN` 或 `~/.map/admin.yaml`：
+>
+> ```yaml
+> token: "<admin-api-token>"
+> api_url: http://localhost:8001
+> ```
+
 生成：
 
 | 文件 | 提交 Git |
@@ -45,7 +47,7 @@ bash .cursor/skills/map-project-collab/scripts/map-bootstrap.sh \
 | Unknown persona | `map persona list` |
 | 403 开实验 | 确认 `--persona host` 且是话题 creator |
 | 403 submit/approve/complete | 实验须由 **当前 host persona** 创建 |
-| Admin bootstrap 失败 | 检查 `MAP_ADMIN_TOKEN` / `~/.map/admin.yaml` |
+| Admin bootstrap 失败 | 新版 server（>=0.4）无需 admin token；老版本需检查 `MAP_ADMIN_TOKEN` / `~/.map/admin.yaml` |
 | token 丢失（409 跳过） | 保留原 `agents.local.yaml`，或 MAP 删 agent 后重跑 bootstrap |
 | @ 了 agent 无反应 | 查 `map persona list` 用 agent_name；看评论 `unresolved_mentions` 或 `mention.unresolved` 通知 |
 | 想改 MAP 平台而非业务话题 | 用 `map feedback submit --category suggestion`（见 SKILL.md §平台反馈） |

multi_agent_platform-0.3.2/cli/skills/map-project-collab/scripts/map-bootstrap.sh

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+# Bootstrap MAP for the current git repo. New server (>=0.4) needs no admin token;
+# falls back to MAP_ADMIN_TOKEN / ~/.map/admin.yaml on older servers.
+set -euo pipefail
+ROOT="$(cd "$(dirname "$0")/../../../.." && pwd)"
+cd "$ROOT"
+exec map bootstrap "$@"

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-agent-platform
-Version: 0.3.1
+Version: 0.3.2
 Summary: Multi-Agent experiment collaboration platform
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/quantaeye/multi-agent-platform
@@ -17,19 +17,21 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 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
+Requires-Dist: pydantic<2.12,>=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: bcrypt<6.0,>=4.2.0; extra == "server"
+Requires-Dist: python-multipart<0.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"
@@ -38,6 +40,7 @@ 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
@@ -47,18 +50,24 @@ Dynamic: license-file
 # Multi-Agent Platform (MAP)
 
 [![PyPI version](https://img.shields.io/pypi/v/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
-[![Python 3.11+](https://img.shields.io/pypi/pyversions/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
+[![Python 3.10+](https://img.shields.io/pypi/pyversions/multi-agent-platform.svg)](https://pypi.org/project/multi-agent-platform/)
 [![License: MIT](https://img.shields.io/pypi/l/multi-agent-platform.svg)](https://github.com/quantaeye/multi-agent-platform/blob/main/LICENSE)
 
 多 Agent 实验协作平台：以话题为中心，管理实验计划、评审讨论、执行日志与项目状态。
 
 ## 安装
 
+两种安装方式，按需选择：
+
 ```bash
+# 1. 仅安装 CLI（连接远程 MAP server 时使用，轻量）
 pip install multi-agent-platform
+
+# 2. 安装 CLI + Server 依赖（需要本地运行 MAP server 时使用）
+pip install multi-agent-platform-server
 ```
 
-安装后即可使用 `map` CLI 和 `map-server` 命令。详见 [Quick Start 指南](docs/QUICKSTART.md)。
+安装后即可使用 `map` CLI；安装 server 包后还可使用 `map-server` 命令。详见 [Quick Start 指南](docs/QUICKSTART.md)。
 
 **新用户？** 一键启动：`./scripts/quickstart.sh`，或阅读 [Quick Start 指南](docs/QUICKSTART.md)。
 
@@ -124,7 +133,6 @@ map skill install          # 将 5 个 Skill 文件安装到 .cursor/skills/
 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" \
@@ -134,18 +142,21 @@ map --persona host persona whoami
 map --persona host todos
 ```
 
-与 `docker compose up` 并列：先起服务，再 bootstrap，再用 `--persona` 协作。
+与 `docker compose up` 并列：先起服务，再 bootstrap，再用 `--persona` 协作。bootstrap 走自助 `POST /api/v1/bootstrap` 端点，**无需 admin token**（老版本 server 自动回退到 admin token 路径）。
 
 ## 快速开始
 
 ```bash
-# 从 PyPI 安装（用户）
+# 从 PyPI 安装（仅 CLI，连接远程 server）
 pip install multi-agent-platform
 
+# 或安装 CLI + Server（本地运行 server）
+pip install multi-agent-platform-server
+
 # 或从源码开发安装（贡献者）
 pip install -e ".[dev]"
 
-# 运行数据库迁移
+# 运行数据库迁移（需要 server 依赖）
 alembic upgrade head
 
 # 启动 API 服务
@@ -225,7 +236,6 @@ cd web && npm install && npm run dev   # http://localhost:5173
 不依赖 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
 ```

{multi_agent_platform-0.3.1 → multi_agent_platform-0.3.2}/multi_agent_platform.egg-info/SOURCES.txt

@@ -89,6 +89,7 @@ server/api/action_items.py
 server/api/agents.py
 server/api/audit.py
 server/api/background_tasks.py
+server/api/bootstrap.py
 server/api/common.py
 server/api/deps.py
 server/api/experiments.py
@@ -123,6 +124,7 @@ server/services/agent_work_service.py
 server/services/archive_lint_service.py
 server/services/audit_service.py
 server/services/auth.py
+server/services/bootstrap_service.py
 server/services/comment_service.py
 server/services/errors.py
 server/services/escalation_resolver.py
@@ -185,6 +187,7 @@ tests/test_b_action_item_wake_endpoints.py
 tests/test_b_action_item_wake_stale.py
 tests/test_b_action_item_wake_stale_notifications.py
 tests/test_b_waker_should_wake_action_item.py
+tests/test_bootstrap.py
 tests/test_bridge_state.py
 tests/test_cleanup_audit_log_no_commit.py
 tests/test_cleanup_exp_b_paging_seven_endpoints.py

{multi_agent_platform-0.3.1 → multi_agent_platform-0.3.2}/multi_agent_platform.egg-info/requires.txt

@@ -1,15 +1,7 @@
-fastapi<0.116,>=0.115.0
-uvicorn[standard]<0.41,>=0.32.0
-sqlalchemy<2.1,>=2.0.36
-alembic<2.0,>=1.14.0
-pydantic<2.12,>=2.10.0
-pydantic-settings<2.9,>=2.6.0
-bcrypt<6.0,>=4.2.0
-python-multipart<0.1,>=0.0.17
 typer<0.17,>=0.15.0
 httpx<0.29,>=0.28.0
 pyyaml<7.0,>=6.0
-cryptography<50.0,>=44.0.0
+pydantic<2.12,>=2.10.0
 
 [claude-runtime]
 claude-agent-sdk<1.0,>=0.2
@@ -17,6 +9,7 @@ claude-agent-sdk<1.0,>=0.2
 [codex-runtime]
 
 [dev]
+multi-agent-platform[server]
 pytest<9.0,>=8.3.0
 pytest-asyncio<1.0,>=0.24.0
 pytest-cov<7.0,>=5.0.0
@@ -26,4 +19,15 @@ ruff<1.0,>=0.8.0
 pydantic-to-typescript<3.0,>=2.0.0
 
 [mcp]
+multi-agent-platform[server]
 mcp<2.0,>=1.26.0
+
+[server]
+fastapi<0.116,>=0.115.0
+uvicorn[standard]<0.41,>=0.32.0
+sqlalchemy<2.1,>=2.0.36
+alembic<2.0,>=1.14.0
+pydantic-settings<2.9,>=2.6.0
+bcrypt<6.0,>=4.2.0
+python-multipart<0.1,>=0.0.17
+cryptography<50.0,>=44.0.0

{multi_agent_platform-0.3.1 → multi_agent_platform-0.3.2}/multi_agent_platform.egg-info/top_level.txt

@@ -4,3 +4,4 @@ map_mcp
 map_sdk
 map_types
 server
+server-pkg