#!/usr/bin/env python3
"""
s16: 团队协议 — 请求-响应协议 + request_id + 分发 + 状态机。
运行: python s16_team_protocols/code.py
需要: pip install anthropic python-dotenv + .env 中配置 ANTHROPIC_API_KEY
相对 s15 的变化:
- ProtocolState dataclass(request_id、type、sender、status、created_at)
- pending_requests 字典:跟踪进行中的协议请求
- dispatch_message:按类型把收到的消息路由给处理器
- request_shutdown:Lead 发送关闭协议请求
- request_plan:Lead 要求队友提交计划
- handle_shutdown_request / handle_plan_response:队友接收并响应
- match_response:Lead 通过 request_id 关联响应(并校验类型)
- 队友空闲循环:等待收件箱消息,而不是 10 轮后退出
- 统一 consume_lead_inbox:协议路由 + 注入历史
- 3 个新 Lead 工具:request_shutdown、request_plan、review_plan
- 1 个新队友工具:submit_plan
ASCII 流程:
Lead: BUS.send("shutdown_request", {request_id}) ──────→ 队友收件箱
Teammate: 分发 → 处理器 → BUS.send("shutdown_response", {request_id}) ─→ Lead 收件箱
Lead: consume_lead_inbox → match_response(request_id) → pending_requests[req_id].status = approved
"""
import os, subprocess, json, time, random, threading
from pathlib import Path
from datetime import datetime
from dataclasses import dataclass, asdict, field
try:
import readline
readline.parse_and_bind('set bind-tty-special-chars off')
except ImportError:
pass
from anthropic import Anthropic
from dotenv import load_dotenv
load_dotenv(override=True)
if os.getenv("ANTHROPIC_BASE_URL"):
os.environ.pop("ANTHROPIC_AUTH_TOKEN", None)
WORKDIR = Path.cwd()
MEMORY_DIR = WORKDIR / ".memory"
MEMORY_INDEX = MEMORY_DIR / "MEMORY.md"
client = Anthropic(base_url=os.getenv("ANTHROPIC_BASE_URL"))
MODEL = os.environ["MODEL_ID"]
# ── 任务系统 (来自 s12,已同步) ──
TASKS_DIR = WORKDIR / ".tasks"
TASKS_DIR.mkdir(exist_ok=True)
@dataclass
class Task:
id: str
subject: str
description: str
status: str # pending | in_progress | completed
owner: str | None
blockedBy: list[str]
def _task_path(task_id: str) -> Path:
return TASKS_DIR / f"{task_id}.json"
def create_task(subject: str, description: str = "",
blockedBy: list[str] | None = None) -> Task:
task = Task(
id=f"task_{int(time.time())}_{random.randint(0, 9999):04d}",
subject=subject, description=description,
status="pending", owner=None,
blockedBy=blockedBy or [],
)
save_task(task)
return task
def save_task(task: Task):
_task_path(task.id).write_text(json.dumps(asdict(task), indent=2))
def load_task(task_id: str) -> Task:
return Task(**json.loads(_task_path(task_id).read_text()))
def list_tasks() -> list[Task]:
return [Task(**json.loads(p.read_text()))
for p in sorted(TASKS_DIR.glob("task_*.json"))]
def get_task(task_id: str) -> str:
"""以 JSON 返回完整任务详情。"""
task = load_task(task_id)
return json.dumps(asdict(task), indent=2)
def can_start(task_id: str) -> bool:
"""Check if all blockedBy dependencies are completed.
Missing dependencies are treated as blocked."""
task = load_task(task_id)
for dep_id in task.blockedBy:
if not _task_path(dep_id).exists():
return False
if load_task(dep_id).status != "completed":
return False
return True
def claim_task(task_id: str, owner: str = "agent") -> str:
task = load_task(task_id)
if task.status != "pending":
return f"任务 {task_id} 当前状态为 {task.status},无法认领"
if not can_start(task_id):
deps = [d for d in task.blockedBy
if not _task_path(d).exists() or load_task(d).status != "completed"]
return f"Blocked by: {deps}"
task.owner = owner
task.status = "in_progress"
save_task(task)
print(f" \033[36m[claim] {task.subject} → in_progress (owner: {owner})\033[0m")
return f"已认领 {task.id} ({task.subject})"
def complete_task(task_id: str) -> str:
task = load_task(task_id)
if task.status != "in_progress":
return f"任务 {task_id} 当前状态为 {task.status},无法完成"
task.status = "completed"
save_task(task)
unblocked = [t.subject for t in list_tasks()
if t.status == "pending" and t.blockedBy and can_start(t.id)]
print(f" \033[32m[complete] {task.subject} ✓\033[0m")
msg = f"已完成 {task.id} ({task.subject})"
if unblocked:
msg += f"\n已解除阻塞:{', '.join(unblocked)}"
print(f" \033[33m[unblocked] {', '.join(unblocked)}\033[0m")
return msg
# ── 提示词组装 (来自 s10,已同步) ──
PROMPT_SECTIONS = {
"identity": "你是一个编码 Agent。直接行动,不要只解释。",
"tools": "可用工具:bash, read_file, write_file, "
"get_task, create_task, list_tasks, claim_task, complete_task, "
"spawn_teammate, send_message, check_inbox, "
"request_shutdown, request_plan, review_plan.",
"workspace": f"工作目录:{WORKDIR}",
"memory": "有可用的相关记忆时,会在下方注入。",
}
def assemble_system_prompt(context: dict) -> str:
sections = [PROMPT_SECTIONS["identity"],
PROMPT_SECTIONS["tools"],
PROMPT_SECTIONS["workspace"]]
memories = context.get("memories", "")
if memories:
sections.append(f"Relevant memories:\n{memories}")
return "\n\n".join(sections)
_last_context_key, _last_prompt = None, None
def get_system_prompt(context: dict) -> str:
global _last_context_key, _last_prompt
key = json.dumps(context, sort_keys=True, ensure_ascii=False, default=str)
if key == _last_context_key and _last_prompt:
return _last_prompt
_last_context_key = key
_last_prompt = assemble_system_prompt(context)
return _last_prompt
# ── 工具 ──
def safe_path(p: str) -> Path:
path = (WORKDIR / p).resolve()
if not path.is_relative_to(WORKDIR):
raise ValueError(f"路径逃逸出工作区:{p}")
return path
def run_bash(command: str, run_in_background: bool = False) -> str:
# run_in_background 由 agent_loop 分发处理,不在这里处理
try:
r = subprocess.run(command, shell=True, cwd=WORKDIR,
capture_output=True, text=True, timeout=120)
out = (r.stdout + r.stderr).strip()
return out[:50000] if out else "(无输出)"
except subprocess.TimeoutExpired:
return "错误:执行超时(120 秒)"
def run_read(path: str, limit: int | None = None) -> str:
try:
lines = safe_path(path).read_text().splitlines()
if limit and limit < len(lines):
lines = lines[:limit] + [f"... ({len(lines) - limit} 行更多内容)"]
return "\n".join(lines)
except Exception as e:
return f"错误:{e}"
def run_write(path: str, content: str) -> str:
try:
fp = safe_path(path)
fp.parent.mkdir(parents=True, exist_ok=True)
fp.write_text(content)
return f"已写入 {len(content)} 字节到 {path}"
except Exception as e:
return f"错误:{e}"
# 任务工具
def run_create_task(subject: str, description: str = "",
blockedBy: list[str] | None = None) -> str:
task = create_task(subject, description, blockedBy)
deps = f" (blockedBy: {', '.join(blockedBy)})" if blockedBy else ""
print(f" \033[34m[create] {task.subject}{deps}\033[0m")
return f"已创建 {task.id}: {task.subject}{deps}"
def run_list_tasks() -> str:
个任务 = list_tasks()
if not 个任务:
return "暂无任务。请使用 create_task 添加任务。"
lines = []
for t in 个任务:
icon = {"pending": "○", "in_progress": "●",
"completed": "✓"}.get(t.status, "?")
deps = f" (blockedBy: {', '.join(t.blockedBy)})" if t.blockedBy else ""
owner = f" [{t.owner}]" if t.owner else ""
lines.append(f" {icon} {t.id}: {t.subject} "
f"[{t.status}]{owner}{deps}")
return "\n".join(lines)
def run_get_task(task_id: str) -> str:
try:
return get_task(task_id)
except FileNotFoundError:
return f"错误:任务 {task_id} 未找到"
def run_claim_task(task_id: str) -> str:
return claim_task(task_id, owner="agent")
def run_complete_task(task_id: str) -> str:
return complete_task(task_id)
# ── 后台任务 (来自 s13,已同步) ──
_bg_计数器 = 0
background_tasks: dict[str, dict] = {}
background_results: dict[str, str] = {}
background_lock = threading.Lock()
def is_slow_operation(tool_name: str, tool_input: dict) -> bool:
"""兜底启发式:判断命令是否可能超过 30 秒。"""
if tool_name != "bash":
return False
cmd = tool_input.get("command", "").lower()
slow_keywords = ["install", "build", "test", "deploy", "compile",
"docker build", "pip install", "npm install",
"cargo build", "pytest", "make"]
return any(kw in cmd for kw in slow_keywords)
def should_run_background(tool_name: str, tool_input: dict) -> bool:
"""模型的显式请求优先;否则使用启发式兜底。"""
if tool_input.get("run_in_background"):
return True
return is_slow_operation(tool_name, tool_input)
def start_background_task(block) -> str:
"""在守护线程中运行工具,并返回后台任务 ID。"""
global _bg_计数器
_bg_计数器 += 1
bg_id = f"bg_{_bg_计数器:04d}"
cmd = block.input.get("command", block.name)
def worker():
result = execute_tool(block)
with background_lock:
background_tasks[bg_id]["status"] = "completed"
background_results[bg_id] = result
with background_lock:
background_tasks[bg_id] = {
"tool_use_id": block.id,
"command": cmd,
"status": "running",
}
threading.Thread(target=worker, daemon=True).start()
print(f" \033[33m[background] dispatched {bg_id}: {cmd[:40]}\033[0m")
return bg_id
def collect_background_results() -> list[str]:
"""将已完成的后台结果收集为 task_notification 消息。"""
with background_lock:
ready_ids = [bid for bid, task in background_tasks.items()
if task["status"] == "completed"]
notifications = []
for bg_id in ready_ids:
with background_lock:
task = background_tasks.pop(bg_id)
output = background_results.pop(bg_id, "")
summary = output[:200] if len(output) > 200 else output
notifications.append(
f"\n"
f" {bg_id}\n"
f" completed\n"
f" {task['command']}\n"
f" {summary}\n"
f"")
print(f" \033[32m[background done] {bg_id}: "
f"{task['command'][:40]} ({len(output)} 个字符)\033[0m")
return notifications
# ── MessageBus (来自 s15) ──
MAILBOX_DIR = WORKDIR / ".mailboxes"
MAILBOX_DIR.mkdir(exist_ok=True)
class MessageBus:
"""File-based message bus. Each agent has a .jsonl inbox.
Read is destructive: read_text + unlink (consumes messages).
Teaching version: no file locking; real CC uses proper-lockfile."""
def send(self, from_agent: str, to_agent: str, content: str,
msg_type: str = "message", metadata: dict = None):
msg = {"from": from_agent, "to": to_agent,
"content": content, "type": msg_type,
"ts": time.time(), "metadata": metadata or {}}
inbox = MAILBOX_DIR / f"{to_agent}.jsonl"
with open(inbox, "a") as f:
f.write(json.dumps(msg) + "\n")
print(f" \033[33m[bus] {from_agent} → {to_agent}: "
f"({msg_type}) {content[:50]}\033[0m")
def read_inbox(self, agent: str) -> list[dict]:
inbox = MAILBOX_DIR / f"{agent}.jsonl"
if not inbox.exists():
return []
msgs = [json.loads(line) for line in inbox.read_text().splitlines()
if line.strip()]
inbox.unlink() # 消费:读取 + 删除
return msgs
BUS = MessageBus()
active_teammates: dict[str, bool] = {}
# ── 协议状态 (s16 新增) ──
@dataclass
class ProtocolState:
request_id: str
type: str # "shutdown" | "plan_approval"
sender: str
target: str
status: str # pending | approved | rejected
payload: str # 计划文本或关闭原因
created_at: float = field(default_factory=time.time)
pending_requests: dict[str, ProtocolState] = {}
def new_request_id() -> str:
return f"req_{random.randint(0, 999999):06d}"
def match_response(response_type: str, request_id: str, approve: bool):
"""Correlate a response to the original request via request_id.
Validates that response_type matches the request type."""
state = pending_requests.get(request_id)
if not state:
print(f" \033[31m[protocol] unknown request_id: {request_id}\033[0m")
return
# 校验响应类型是否匹配请求类型
if state.type == "shutdown" and response_type != "shutdown_response":
print(f" \033[31m[protocol] type mismatch: expected shutdown_response, "
f"got {response_type}\033[0m")
return
if state.type == "plan_approval" and response_type != "plan_approval_response":
print(f" \033[31m[protocol] type mismatch: expected plan_approval_response, "
f"got {response_type}\033[0m")
return
if state.status != "pending":
print(f" \033[33m[protocol] {request_id} already {state.status}, "
f"ignoring duplicate\033[0m")
return
state.status = "approved" if approve else "rejected"
icon = "✓" if approve else "✗"
color = "32" if approve else "31"
print(f" \033[{color}m[protocol] {state.type} {icon} "
f"({request_id}: {state.status})\033[0m")
# ── 统一 Lead 收件箱消费者 (s16 修复) ──
# check_inbox 工具和主循环都会调用这个函数。
# 返回前通过 match_response 路由协议响应。
def consume_lead_inbox(route_protocol: bool = True) -> list[dict]:
"""Read Lead's inbox. Route protocol responses, return all messages.
Called by both run_check_inbox() and main loop to avoid
messages being consumed without protocol routing."""
msgs = BUS.read_inbox("lead")
if not msgs:
return []
if route_protocol:
for msg in msgs:
meta = msg.get("metadata", {})
req_id = meta.get("request_id", "")
msg_type = msg.get("type", "")
if req_id and msg_type.endswith("_response"):
approve = meta.get("approve", False)
match_response(msg_type, req_id, approve)
return msgs
# ── 队友线程 (s16: 空闲循环 + 分发) ──
def spawn_teammate_thread(name: str, role: str, prompt: str) -> str:
"""Spawn a teammate agent in a background thread.
Uses idle loop: 等待 each LLM 轮次, waits for inbox messages
(shutdown_request, new task) instead of exiting."""
if name in active_teammates:
return f"队友 '{name}' 已存在"
system = (f"你是 '{name}',角色是 {role}。"
f"使用工具完成任务。"
f"检查收件箱中的协议消息(shutdown_request 等)。")
def handle_inbox_message(name: str, msg: dict, messages: list) -> bool:
"""Dispatch incoming protocol messages by type.
Returns True if teammate should stop."""
msg_type = msg.get("type", "message")
meta = msg.get("metadata", {})
req_id = meta.get("request_id", "")
if msg_type == "shutdown_request":
BUS.send(name, "lead", "正在平滑关闭。",
"shutdown_response",
{"request_id": req_id, "approve": True})
print(f" \033[35m[protocol] {name} approved shutdown "
f"({req_id})\033[0m")
return True # 停止循环
if msg_type == "plan_approval_response":
approve = meta.get("approve", False)
if approve:
messages.append({"role": "user",
"content": f"[计划已批准] 继续执行任务。"})
else:
messages.append({"role": "user",
"content": f"[计划已拒绝] 反馈:{msg['content']}"})
return False # 继续
def run():
messages = [{"role": "user", "content": prompt}]
sub_tools = [
{"name": "bash", "description": "运行一条 shell 命令。",
"input_schema": {"type": "object",
"properties": {"command": {"type": "string"}},
"required": ["command"]}},
{"name": "read_file", "description": "读取文件。",
"input_schema": {"type": "object",
"properties": {"path": {"type": "string"}},
"required": ["path"]}},
{"name": "write_file", "description": "写入文件。",
"input_schema": {"type": "object",
"properties": {"path": {"type": "string"},
"content": {"type": "string"}},
"required": ["path", "content"]}},
{"name": "send_message",
"description": "Send message to another agent.",
"input_schema": {"type": "object",
"properties": {"to": {"type": "string"},
"content": {"type": "string"}},
"required": ["to", "content"]}},
{"name": "submit_plan",
"description": "提交计划给 Lead 审批。",
"input_schema": {"type": "object",
"properties": {"plan": {"type": "string"}},
"required": ["plan"]}},
]
sub_handlers = {
"bash": run_bash, "read_file": run_read, "write_file": run_write,
"send_message": lambda to, content: (BUS.send(name, to, content),
"Sent")[1],
"submit_plan": lambda plan: _teammate_submit_plan(name, plan),
}
shutdown_requested = False
while not shutdown_requested:
# 检查收件箱中的协议消息
inbox = BUS.read_inbox(name)
should_stop = False
non_protocol = []
for msg in inbox:
if msg.get("type") in ("shutdown_request", "plan_approval_response"):
should_stop = handle_inbox_message(name, msg, messages)
if should_stop:
break
else:
non_protocol.append(msg)
if should_stop:
shutdown_requested = True
break
if non_protocol:
inbox_json = json.dumps(non_protocol)
messages.append({"role": "user",
"content": "" + inbox_json + ""})
# LLM 轮次
try:
response = client.messages.create(
model=MODEL, system=system, messages=messages[-20:],
tools=sub_tools, max_tokens=8000)
except Exception:
break
messages.append({"role": "assistant", "content": response.content})
if response.stop_reason != "tool_use":
# 空闲:等待收件箱消息,而不是退出
# 真实 CC 会在这里向 Lead 发送 idle_notification
while not shutdown_requested:
time.sleep(1)
inbox = BUS.read_inbox(name)
if not inbox:
continue
for msg in inbox:
if msg.get("type") in ("shutdown_request", "plan_approval_response"):
should_stop = handle_inbox_message(name, msg, messages)
if should_stop:
shutdown_requested = True
break
else:
non_protocol.append(msg)
if shutdown_requested:
break
if non_protocol:
inbox_json = json.dumps(non_protocol)
messages.append({"role": "user",
"content": "" + inbox_json + ""})
break # 带着新消息回到 LLM 轮次
# 执行工具调用
results = []
for block in response.content:
if block.type == "tool_use":
handler = sub_handlers.get(block.name)
output = handler(**block.input) if handler else "未知"
results.append({"type": "tool_result",
"tool_use_id": block.id,
"content": str(output)})
messages.append({"role": "user", "content": results})
# 向 Lead 发送最终摘要
summary = "已完成。"
for msg in reversed(messages):
if msg["role"] == "assistant" and isinstance(msg["content"], list):
for b in msg["content"]:
if getattr(b, "type", None) == "text":
summary = b.text
break
else:
continue
break
BUS.send(name, "lead", summary, "result")
active_teammates.pop(name, None)
print(f" \033[32m[teammate] {name} finished\033[0m")
active_teammates[name] = True
threading.Thread(target=run, daemon=True).start()
print(f" \033[36m[teammate] {name} spawned as {role}\033[0m")
return f"队友 '{name}' 已启动为 {role}"
def _teammate_submit_plan(from_name: str, plan: str) -> str:
"""Teammate submits a plan to Lead for approval.
Note: This is a protocol-level request, not a code-level gate.
After submitting, the teammate's thread 继续s running — it can
still call bash/write/etc. Real enforcement relies on the model
waiting for the approval response before acting. Code-level tool
gating would require blocking the teammate's tool dispatch until
approval arrives.
"""
req_id = new_request_id()
pending_requests[req_id] = ProtocolState(
request_id=req_id, type="plan_approval",
sender=from_name, target="lead",
status="pending", payload=plan)
BUS.send(from_name, "lead", plan,
"plan_approval_request",
{"request_id": req_id})
return f"计划已提交({req_id})。正在等待审批..."
# ── Lead Protocol 工具 (s16 新增) ──
def run_request_shutdown(teammate: str) -> str:
req_id = new_request_id()
pending_requests[req_id] = ProtocolState(
request_id=req_id, type="shutdown",
sender="lead", target=teammate,
status="pending", payload="")
BUS.send("lead", teammate, "请平滑关闭。",
"shutdown_request",
{"request_id": req_id})
print(f" \033[35m[protocol] shutdown_request → {teammate} "
f"({req_id})\033[0m")
return f"已向 {teammate} 发送关闭请求(req: {req_id})"
def run_request_plan(teammate: str, task: str) -> str:
"""Lead asks a teammate to submit a plan for a task."""
BUS.send("lead", teammate, f"请为以下任务提交计划:{task}",
"message")
return f"已要求 {teammate} 提交计划"
def run_review_plan(request_id: str, approve: bool, feedback: str = "") -> str:
state = pending_requests.get(request_id)
if not state:
return f"请求 {request_id} 未找到"
if state.status != "pending":
return f"请求 {request_id} 已经是 {state.status}"
state.status = "approved" if approve else "rejected"
BUS.send("lead", state.sender, feedback or ("Approved" if approve else "Rejected"),
"plan_approval_response",
{"request_id": request_id, "approve": approve})
icon = "✓" if approve else "✗"
print(f" \033[32m[protocol] plan {icon} ({request_id})\033[0m")
return f"计划已{'批准' if approve else '拒绝'}({request_id})"
# ── 其他 Lead 工具处理器 ──
def run_spawn_teammate(name: str, role: str, prompt: str) -> str:
return spawn_teammate_thread(name, role, prompt)
def run_send_message(to: str, content: str) -> str:
BUS.send("lead", to, content)
return f"已发送给 {to}"
def run_check_inbox() -> str:
"""检查 Lead 收件箱,并通过 match_response 路由协议响应。"""
msgs = consume_lead_inbox(route_protocol=True)
if not msgs:
return "(收件箱为空)"
lines = []
for m in msgs:
meta = m.get("metadata", {})
req_id = meta.get("request_id", "")
tag = f" [{m['type']} req:{req_id}]" if req_id else f" [{m['type']}]"
lines.append(f" [{m['from']}]{tag} {m['content'][:200]}")
return "\n".join(lines)
# ── 工具分发 ──
def execute_tool(block) -> str:
"""执行工具调用块并返回输出。"""
handler = {
"bash": run_bash, "read_file": run_read, "write_file": run_write,
"create_task": run_create_task, "list_tasks": run_list_tasks,
"get_task": run_get_task, "claim_task": run_claim_task,
"complete_task": run_complete_task,
"spawn_teammate": run_spawn_teammate,
"send_message": run_send_message, "check_inbox": run_check_inbox,
"request_shutdown": run_request_shutdown,
"request_plan": run_request_plan, "review_plan": run_review_plan,
}.get(block.name)
if handler:
return handler(**block.input)
return f"未知工具:{block.name}"
# ── 工具定义 ──
TOOLS = [
{"name": "bash", "description": "运行一条 shell 命令。",
"input_schema": {"type": "object",
"properties": {
"command": {"type": "string"},
"run_in_background": {"type": "boolean"}},
"required": ["command"]}},
{"name": "read_file", "description": "读取文件内容。",
"input_schema": {"type": "object",
"properties": {"path": {"type": "string"},
"limit": {"type": "integer"}},
"required": ["path"]}},
{"name": "write_file", "description": "向文件写入内容。",
"input_schema": {"type": "object",
"properties": {"path": {"type": "string"},
"content": {"type": "string"}},
"required": ["path", "content"]}},
{"name": "create_task",
"description": "创建一个新任务,可选 blockedBy 依赖。",
"input_schema": {"type": "object",
"properties": {
"subject": {"type": "string"},
"description": {"type": "string"},
"blockedBy": {"type": "array",
"items": {"type": "string"}}},
"required": ["subject"]}},
{"name": "list_tasks",
"description": "列出所有任务及其状态、负责人和依赖。",
"input_schema": {"type": "object", "properties": {},
"required": []}},
{"name": "get_task",
"description": "按 ID 获取指定任务的完整详情。",
"input_schema": {"type": "object",
"properties": {"task_id": {"type": "string"}},
"required": ["task_id"]}},
{"name": "claim_task",
"description": "认领一个待处理任务。设置 owner,并将状态改为 in_progress。",
"input_schema": {"type": "object",
"properties": {"task_id": {"type": "string"}},
"required": ["task_id"]}},
{"name": "complete_task",
"description": "完成一个进行中的任务。报告被解除阻塞的下游任务。",
"input_schema": {"type": "object",
"properties": {"task_id": {"type": "string"}},
"required": ["task_id"]}},
{"name": "spawn_teammate",
"description": "在后台线程中启动一个队友 Agent。",
"input_schema": {"type": "object",
"properties": {
"name": {"type": "string"},
"role": {"type": "string"},
"prompt": {"type": "string"}},
"required": ["name", "role", "prompt"]}},
{"name": "send_message",
"description": "Send message to a teammate via MessageBus.",
"input_schema": {"type": "object",
"properties": {"to": {"type": "string"},
"content": {"type": "string"}},
"required": ["to", "content"]}},
{"name": "check_inbox",
"description": "检查 Lead 收件箱,并自动路由协议响应。",
"input_schema": {"type": "object", "properties": {},
"required": []}},
{"name": "request_shutdown",
"description": "请求队友平滑关闭。",
"input_schema": {"type": "object",
"properties": {"teammate": {"type": "string"}},
"required": ["teammate"]}},
{"name": "request_plan",
"description": "要求队友提交计划以供审查。",
"input_schema": {"type": "object",
"properties": {"teammate": {"type": "string"},
"task": {"type": "string"}},
"required": ["teammate", "task"]}},
{"name": "review_plan",
"description": "按 request_id 批准或拒绝已提交的计划。",
"input_schema": {"type": "object",
"properties": {
"request_id": {"type": "string"},
"approve": {"type": "boolean"},
"feedback": {"type": "string"}},
"required": ["request_id", "approve"]}},
]
# ── 上下文 ──
def update_context(context: dict, messages: list) -> dict:
"""Derive context from real state."""
memories = ""
if MEMORY_INDEX.exists():
content = MEMORY_INDEX.read_text().strip()
if content:
memories = content
return {
"enabled_tools": [t["name"] for t in TOOLS],
"workspace": str(WORKDIR),
"memories": memories,
}
# ── Agent 循环 ──
def agent_loop(messages: list, context: dict):
system = get_system_prompt(context)
while True:
try:
response = client.messages.create(
model=MODEL, system=system, messages=messages,
tools=TOOLS, max_tokens=8000)
except Exception as e:
messages.append({"role": "assistant", "content": [
{"type": "text",
"text": f"[错误] {type(e).__name__}: {e}"}]})
return
messages.append({"role": "assistant", "content": response.content})
if response.stop_reason != "tool_use":
return
results = []
for block in response.content:
if block.type != "tool_use":
continue
print(f"\033[36m> {block.name}\033[0m")
if should_run_background(block.name, block.input):
bg_id = start_background_task(block)
results.append({"type": "tool_result",
"tool_use_id": block.id,
"content": f"[Background task {bg_id} started] "
f"完成后结果将可用。"})
else:
output = execute_tool(block)
print(str(output)[:300])
results.append({"type": "tool_result",
"tool_use_id": block.id,
"content": output})
# 将后台工具结果 + 通知合并成一条用户消息
user_content = list(results)
bg_notifications = collect_background_results()
if bg_notifications:
for notif in bg_notifications:
user_content.append({"type": "text", "text": notif})
messages.append({"role": "user", "content": user_content})
context = update_context(context, messages)
system = get_system_prompt(context)
if __name__ == "__main__":
print("s16: 团队协议")
print("输入问题后按回车发送。输入 q 退出。\n")
history = []
context = update_context({}, [])
while True:
try:
query = input("\033[36ms16 >> \033[0m")
except (EOFError, KeyboardInterrupt):
break
if query.strip().lower() in ("q", "exit", ""):
break
history.append({"role": "user", "content": query})
agent_loop(history, context)
context = update_context(context, history)
for block in history[-1]["content"]:
if getattr(block, "type", None) == "text":
print(block.text)
elif isinstance(block, dict) and block.get("type") == "text":
print(block.get("text", ""))
# 检查收件箱 → 路由协议 + 注入历史
inbox_msgs = consume_lead_inbox(route_protocol=True)
if inbox_msgs:
inbox_text = "\n".join(
f"来自 {m['from']}: {m['content'][:200]}" for m in inbox_msgs)
history.append({"role": "user",
"content": f"[收件箱]\n{inbox_text}"})
print(f"\n\033[33m[Inbox: {len(inbox_msgs)} 条消息已注入]\033[0m")
print()