xiaohei/Agentswarm
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
123 Commits 5 Branches 0 Tags
983518522cb01d401d853a99d2edd66f278f674c
Commit Graph
16 Commits
Author SHA1 Message Date
zsbgnw12andGitHub bdddef2c23 Merge branch 'main' into fix/orphan-agent-lifecycle 2026-06-16 12:07:27 +08:00
gongzhiyongandClaude Opus 4.8 4309eac2ce fix(#66): 退役 _manager_provided_agents 逃生门 + pod 数[3,16]上下限 + 消费 metadata.max_agents_per_user 
去中心化是唯一行为(对齐 runtime-contract §3.3): 所有蜂群统一播种单一目标任务 + Swarm 自己拉 agent 池;
orchestration_plan.agents 不再控制拉起/任务创建, 退化为无害元数据。修复"任务建了但无 agent 认领、永久 pending"。

- main.py: 删除 _manager_provided_agents 两处分支(任务创建改无条件播种、拉起永远执行) + 函数退役
- agent_launcher.py: launch_count clamp 到 [AGENT_LAUNCH_MIN_POOL=3, AGENT_LAUNCH_MAX_POOL=16]
- main.py: max_agents_per_user(body) 消费 metadata.max_agents_per_user(HM 下发; >0 优先, 否则 env)
- main.py: WS 注册兜底按 agent 所属 run 的 metadata cap 反查(fail-soft 回退 env), 与拉起口径一致
- docs/integration/runtime-contract.md §3.3: 同步架构师裁定口径(2026-06-15)
- tests: test-agent-launcher / test-max-agents-per-user / test-merge-smoke 同步断言

Refs #66

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 00:19:14 +08:00
FastheiandClaude Opus 4.8 efa865cac4 fix(launcher/#63): 拉起 agent 注入 git 绑定（GIT_REPO_URL + azkv 凭据）— 修 HM #92 
现象（HM #92）：蜂群"需绑定 git 仓库才能使用"，但 agent 实际拿不到仓库。

根因：HM 已在 swarm create 的 resource_grants 下发 git 绑定（resource_type=git +
metadata.repo_url + secret_ref=azkv://），但 swarm 拉起侧只把 grant 用于校验/脱敏/审批，
launcher 从不消费它 → 被拉起 agent 的 env 没有 GIT_REPO_URL/凭据 → 无法 clone。
（agent 侧 agent/main.py + agent/git_operations.py 早已读取这些 env，缺的纯是注入。）

修复（仅 launcher 注入，比照模型 key 的服务端解析路径）：
- 新增 resolve_git_grant(body)：从 resource_grants（含 per-agent）取首个 git grant，
  repo_url(metadata) → GIT_REPO_URL（非密文 inline）；secret_ref(azkv) 服务端解析 →
  GIT_USERNAME/GIT_PASSWORD。复用 azkv 读取（workload identity；dev/CI 用
  HEICODE_SECRET_<name>）。有 repo 无凭据仍注入 GIT_REPO_URL（公有仓可 clone；私有仓
  报错，不伪造）。
- plan_launch_specs 增加 git_env 合并；create 路径解析并透传。
- k8s 后端：GIT_PASSWORD 与模型 key 同走 per-swarm Secret 的 secretKeyRef，绝不内联
  PodSpec；GIT_REPO_URL/GIT_USERNAME 为非密文 inline。SENSITIVE_ENV_KEYS 统一管控。
- git KV secret 值约定 JSON {"git_username","git_password"}（接受 git_token/token 形式
  + 裸 token），待 HM #92 对齐。

git 凭据不入 create 请求体/回调/日志/argv（_reject_plaintext_secrets 已覆盖
resource_grants）。

文档：runtime-contract §3.3 env 表 + 约束、security-boundary §6 增 git 绑定解析口径。
测试：scripts/test-agent-launcher.py 增 resolve_git_grant/凭据提取/k8s git secret 用例。

影响：仅 agent_swarm（Swarm/Agent + 密钥/secret_ref + 文档）；不改 Manager/客户端/release/
契约状态机/计费/审计字段。HM 侧 binding_id（B 路径）解析另在 HM #92 处理，与本 PR 无关。

验收：
  python scripts/test-runtime-contract.py
  python scripts/test-contract-freeze.py
  REDIS_FAKE=1 python scripts/test-key-injection-contract.py
  python scripts/test-security-boundary.py
  python scripts/test-agent-launcher.py
  python scripts/test-git-workflow.py
  python scripts/test-merge-smoke.py
  python scripts/test-workflow-e2e.py
（全部通过）

Refs HM #92, Closes #63

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-15 12:17:51 +08:00
gongzhiyongandClaude Opus 4.8 185c0033b1 docs(#56): 模型网关域名 A.4 更正 code.xinghanlab.com → code.heicode.cc（HM 权威口径） 
HM #56 评论:code.heicode.cc 为正式地址,code.xinghanlab.com 为前期过渡域名。
runtime-contract §3.3.1 A.4 的 AGENT_OPENAI_API_BASE 示例同步更正为
https://code.heicode.cc/v1。纯文档,无代码改动。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-14 18:21:36 +08:00
gongzhiyong a117c02e3f docs(#56): 更正模型 key 库名 heicode-kv → heicode-vault（HM 实测口径） 
agent_swarm#56 评论:模型 key 的真实 Key Vault 库名是 `heicode-vault`
(`https://heicode-vault.vault.azure.net`),早期契约文档误写为 `heicode-kv`;
且生产 `SECRET_RESOLVER` 须指向 `heicode-vault`。

- runtime-contract.md §3.3.1 A.3:库名更正 + 标注 SECRET_RESOLVER 指向 heicode-vault
  + 明确 Swarm 需提供 Pod 身份的 clientId+objectId 给 HM 授权(只读、限 swarm-model-key-*)。
- security-boundary.md:secret_ref 示例 host 同步更正。
- test-key-injection-contract.py:模型 key fixture host 同步更正(resolver 仅取末段名,
  功能不变;测试仍全绿)。

纯文档/fixture 更名,无事件 schema/契约字段改动。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-14 17:12:27 +08:00
FastheiandGitHub d7c9cd64b6 Merge branch 'main' into feat/agent-launcher-k8s-backend 2026-06-11 23:05:02 +08:00
Songhaoz666andClaude Opus 4.8 82eb2bbdd5 A.3 措辞纠正：KV RBAC 归属 HM/运维（其库 heicode-kv）+ Swarm 先 provision Pod 身份（Refs #16 #60） 
回应 @zsbgnw12 在 #43 的纠正：heicode-kv 是 HM 侧库，库上 RBAC 授权由 HM/运维做，
Swarm 仅提供 Pod 的 Workload Identity id + 收窄作用域。并如实标注：我方 Pod 的
Workload Identity 目前未 provision（仓内无 azure.workload.identity 注解 / IaC），
A.3 第一步是 Swarm 侧建 UAMI→federate orchestrator-sa→注解 SA，属 AKS/Azure 基础设施
动作，不在本仓。参数面（A.1/A.2/A.4/A.5+B.1/B.2）不受影响、仍冻结。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-11 21:23:38 +08:00
Songhaoz666andClaude Opus 4.8 0cbab3f750 模型 key 注入对接：定死 HM #60 参数（KV value JSON + per-user 吊销握手）（Refs #16 #60） 
回应 HM「#60 落地前需 Swarm 定死的参数清单」。Swarm 侧逐条定死并落实现：

- A.2 KV secret value 格式：JSON {"openai_api_key":"sk-..."}（对齐 callback 签名密钥
  约定），解析字段 openai_api_key；裸 sk- 串兼容；解析不到/字段缺失不伪造。实现
  agent_launcher._extract_model_key + _resolve_secret_ref。
- A.5 吊销信号（事件驱动）：sk- per-user 长存；stop 为唯一终态（completed/failed 经
  …/input 可重开故保 key）。某用户全部 run 被 stop（retained 集清空）时，运行时发
  恰好一次 swarm.pool_terminated{user_id, secret_ref}，HM 据此吊销 sk- + 清 KV。
  单 run swarm.stopped 不触发吊销。实现 swarm_runtime.retain_run_for_user /
  release_run_and_maybe_terminate_pool（per-user retained 集 + 一次性 flag）。
- A.1 粒度：每用户一把、跨 run 复用；KV 命名 swarm-model-key-<user_id>（文档）。
- A.4 OPENAI_API_BASE：Swarm 部署常量（已实现），不经 create 下发（文档确认）。
- A.3 KV 读 RBAC：⚠ 待定（联调阻塞前置）——如实标注归属未敲定，不伪造已就绪。
- B.1：CLIENT_GUIDE §9 /events 游标改 after=<next_after>（HM 不透明游标，非 sequence）。

swarm.pool_terminated 为 HM 控制面生命周期事件，不入 FROZEN_CLIENT_EVENT_TYPES、
不渲染驾驶舱；payload secret_ref 为 azkv:// 引用（非明文 key）。

文档：runtime-contract §3.3.1（参数表）、event-schema（注册 + 说明）、
security-boundary §6（吊销握手 + RBAC 待定）。测试 scripts/test-key-injection-contract.py
（KV 格式解析 + 吊销握手：单 run/多 run 保留/不重复吊销/teardown 后重新武装）+ CI 步。

不动 Manager 面接口、HMAC 回调、审批链、计费/审计字段语义。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-11 17:57:15 +08:00
Songhaoz666andClaude Opus 4.8 af26455a8b agent_launcher：新增一等 kubernetes 后端（每 agent 一 Pod，key 经 Secret 引用不内联）（Refs #16） 
回应「我们跑在 k8s pods 上」——此前 launcher 只有 dev 的 subprocess + 通用 command hook，
未把 k8s 作为一等后端，且把 OPENAI_API_KEY 内联进 env（在 k8s 会落 etcd）。本次：

- 新增 AGENT_LAUNCH_BACKEND=kubernetes：每 agent 一个 Pod（build_pod_manifest）——资源
  requests/limits、标签 heicode-swarm-id/heicode-user-id（GC/teardown）、restartPolicy OnFailure、
  serviceAccountName；非敏感 env 内联，**OPENAI_API_KEY 经 secretKeyRef 引用每-swarm k8s Secret
  （build_secret_manifest，via kubectl apply -f - stdin），绝不内联进 PodSpec（不落 etcd/argv）**。
- stop_launched：k8s 按标签 kubectl delete pod,secret；subprocess 仍 terminate。
- config：AGENT_POD_IMAGE/NAMESPACE/SERVICE_ACCOUNT/CPU|MEM_REQUEST|LIMIT；ORCHESTRATOR_URL=
  集群内 Service DNS。文档注明前置（kubectl + 最小 RBAC ServiceAccount + NetworkPolicy）与
  硬化替代（azkv CSI SecretProviderClass，编排器全程不碰明文）。

文档：runtime-contract §3.3 后端列表加 kubernetes（含密钥/RBAC/Service DNS/CSI）；
security-boundary §6 增 K8s pod 边界（Secret 引用不内联、最小 RBAC、NetworkPolicy、CSI 硬化）。
测试：test-agent-launcher 增 k8s manifest 断言（标签、secretKeyRef 非内联、原文不在 Pod manifest、
资源限额、无 secret 则省略 key）。

影响范围：仅 agent_swarm（launcher + 文档 + 测试）。默认仍 backend=none，CI/e2e 不变。

Refs #16

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-11 17:19:35 +08:00
FastheiandGitHub 02b8b08ab3 Merge branch 'main' into feat/swarm-io 2026-06-11 17:03:58 +08:00
Songhaoz666andClaude Opus 4.8 dd96b73b2d Swarm I/O：接收用户 prompt（追加输入）+ 返回结果（/result + swarm.completed 带答案）（Refs #40） 
补齐「客户端如何把 prompt 给我们 + 如何拿到结果」的端到端路径。

输入：
- POST /api/swarms/{id}/input（+别名）：接收用户后续 prompt，注入 source=user_append 任务进共享池
  （终态 run 自动 reopen 为 running；stopped 拒绝 RUN_STOPPED）。指令原文作任务描述下发给 agent，
  **不回显进事件流**——仅产一条 task.created(user_append) 类别 message。（初始 prompt 仍走 create
  的 requirement.objective）

输出：
- GET /api/swarms/{id}/result（+别名）：返回 {summary, deliverable, artifacts[], termination_reason,
  status}（build_run_result）。产物内容在 artifact.uri（git/runtime），result 给摘要+定位。
- swarm.completed 事件 payload 增带 summary + deliverable，客户端看一条终态事件即得答案。

文档：runtime-contract §3 增 input/result 行；event-schema swarm.completed 标注带 summary/deliverable；
CLIENT_GUIDE §3.5/§3.6（input/result）+ §3.2 表 + 修正 §5「Agent 平台拉起」为「Swarm 拉起 + 从
secret_ref 解析 key」（对齐 team 决议）+ 新增 §9 完整工作流地图（client→HM→Swarm→output→client）。

测试 scripts/test-swarm-io.py（TestClient：input 注入 + 原文不入事件流 + 终态 reopen + stopped 拒绝 +
result 形状）接入 CI。e2e/contract 回归通过。

影响范围：仅 agent_swarm（新增 2 只读/写端点 + 终态事件增字段 + 文档 + 测试 + CI）。
追加输入原文不入事件流/回调/日志；不改鉴权/计费账本/审批链。SSE 实时流仍归 HM Phase2（#46）。

Refs #40

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-11 16:28:37 +08:00
Songhaoz666andClaude Opus 4.8 9516b5c696 Swarm 负责拉起 agent + 执行限额（team 决议，反转 AM 拉起）（Refs #16） 
团队决议：由 Swarm 运行时（非 AM）拉起专家 agent 池并执行每用户限额。

代码：
- orchestrator/agent_launcher.py（新）：plan_launch_specs（纯，按 min(池大小, MAX_AGENTS_PER_USER
  −已连) 限额 + 组装每 agent env）、resolve_model_key（override→azkv secret_ref 解析(部署
  SecretResolver/dev HEICODE_SECRET_<name>)→OPENAI_API_KEY 兜底，解析不到不伪造）、可插拔后端
  launch()（none 默认/subprocess/command 模板，fail-soft）、stop_launched。
- orchestrator/main.py：create 播种后调 launch_swarm_agents（仅去中心化、非 Manager 显式 agent；
  从 create x-user-id 取 user_id；key 服务端解析，不入 create 体）；stop_swarm_run 调 stop_launched。

文档：runtime-contract §3.3 由「AM 拉起（提案待确认）」改为「Swarm 拉起 + 限额（已定）」，
更新 env 来源列（key=Swarm 从 secret_ref 解析、AGENT_ID/CAPABILITIES=Swarm launcher、
HEICODE_USER_ID=从 create 透传）+ 后端/限额/解析约束；security-boundary §6 增 Swarm 拉起 +
服务端解析 key（不上 argv/日志）说明。

测试：scripts/test-agent-launcher.py（限额封顶、env 组装、key 解析优先级、command 模板、
none no-op）接入 CI。e2e/contract 回归通过（默认 backend=none，行为不变）。

影响范围：仅 agent_swarm（orchestrator + docs + 测试 + CI）。默认 backend=none 不自动拉起、
向后兼容；密钥仅服务端 env 注入、不入 create 体/回调/日志/argv（满足 §3.1 + security-boundary）。
不改 Manager↔Swarm 契约鉴权/计费账本/审批链。

Refs #16

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-11 15:07:23 +08:00
Songhaoz666andClaude Opus 4.8 fb367c4373 runtime-contract §3.3：拉起触发链标为「提案待确认」，不冻结（Refs #16） 
回应 HM 复审（#16）：§3.3 此前把「AM 拉起（HM 触发）」写成已定论超前了——该触发链
（谁调 AM、何时拉起、agent 池由谁提供）尚未与 AM(@azgy)/HM(@zsbgnw12) 敲定。本次：
- 顶部加冻结状态说明：env 字段清单已稳定，触发链未冻结、待确认。
- 澄清 §1「派发」= 指派给已连入 agent，非编排器拉 pod（§1 与 §3.3 不矛盾，但都未定义拉起方）。
- 把拉起流程明确标为「提案」：去中心化下无 per-run agent 清单；agent 为 per-user 常驻池，
  由 HM 触发 AM 拉起（AM 无批量接口则 HM 循环调模板 POST /agents）。

仅文档。Refs #16

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-11 14:33:48 +08:00
Songhaoz666andClaude Opus 4.8 2e792bc8eb runtime-contract §3.3：蜂群专家 agent 拉起环境契约（Refs #16） 
回应 agent_swarm#16 的接线问题：钉死「per-user sk- 怎么进 agent」。编排器不拉 agent / 无 AM 客户端 / 不持 key，agent 由 AM 拉起（HM 触发，同模板 mintAgentModelToken→env）。新增 §3.3 列出 AM 拉起蜂群专家 agent 必须注入的 env（OPENAI_API_KEY=per-user sk-、OPENAI_API_BASE=HM /v1、OPENAI_MODEL、ORCHESTRATOR_URL、AGENT_ID、AGENT_CAPABILITIES、HEICODE_USER_ID、可选 WORKSPACE_DIR/GIT_REPO_URL），均为 agent/main.py 实读；key 走 HM→AM server→server、不经 create 体；token 绑 agent 生命周期；并注明运行时事件前置（SWARM_RUNTIME_ENABLED 真派发 + agent 连入）。

仅文档；无代码/契约逻辑改动。Refs #16

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-11 08:51:16 +08:00
Songhaoz666andClaude Opus 4.8 15fe5d379b 契约冻结 v1：Manager/客户端 Swarm Run 查询契约（Refs #2 #14 #15） 
回应 HM 驾驶舱（heicode-mananger #28/#45/#46）经 agent_swarm#14（runtime-contract）
+ #15（event-schema）提出的消费需求。HM 只读查询已落地（HM PR #53），唯一前置是本
仓契约冻结。本 PR 把回调契约冻结为 v1 并落代码 + 测试。

代码（orchestrator/）：
- swarm_runtime.emit_event：回调 envelope 新增 **per-swarm 严格递增 `sequence`**
  （INCR 计数键 swarm_event_seq:{swarm_id}，从 1、无空洞，供客户端 events?after= 去重/续传）。
- 新增冻结的客户端 13 类事件（FROZEN_CLIENT_EVENT_TYPES）中此前缺的 6 类，均**附加**发出
  （不动既有 deployment.status_changed，HM 仍用其更新 AgentDeployment.Status）：
  · swarm.completed/failed（refresh_swarm_run_status 终态）、swarm.stopped（stop_run）；
  · approval.approved/rejected（record_approval_decision 决定落地）；
  · handoff.created（child 任务建立时）。
- artifact.created envelope 补扁平字段：created_at（默认 occurred_at）、task_id（回填）、
  size_bytes 透传（未知则省略，不伪造，规则 #9）。
- redis_client 新增原子 incr（真实 + 两处 fake stub）。

文档（docs/integration/，FROZEN v1）：
- event-schema.md：envelope sequence、artifact 扁平字段、事件注册表标注 ⭐13 类 + 新增 6 类、
  对齐状态更新（title/threshold_pct/sequence/artifact 已在 emit 统一处理）。
- runtime-contract.md：冻结 stop 端点 + ID 映射；§4.1 新增**状态机映射表**——运行时不臆造
  preparing/degraded/verifying（规则 #9），由 HM/客户端按表映射真实状态
  （blocked→degraded、评审期→verifying 等）；终态另发 swarm.* 事件。

测试：
- 新增 scripts/test-contract-freeze.py（hermetic）：sequence 单调/每-swarm/无空洞、13 类
  round-trip、artifact 形状（含未知 size 不伪造）、approval.*/swarm.stopped 真实发出、
  明文凭据脱敏而 azkv secret_ref 透传。接入 CI + CLAUDE.md 提交前清单。
- test-workflow-e2e.py：全流程 e2e 额外断言 swarm.completed + sequence 无空洞。
- 两处 FakeRedis stub 补 incr。

影响范围：仅 agent_swarm（orchestrator + docs/integration + 测试 + CI + CLAUDE.md）。
- Manager：回调**新增** sequence 字段与 6 类事件——向后兼容（旧消费方忽略新字段/新类型即可）；
  HM 注册表需登记新 6 类方能对外暴露（agent_swarm#15.2，已在 doc 列为剩余项）。
- 计费/审计：不涉及（查询面不计费由 HM 保证；本仓未改计费/审计字段）。
- 密钥：envelope 不含明文凭据；secret_ref 仍为 azkv 引用，HM 对客户端再脱敏。

Refs #2
Refs #14
Refs #15

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-10 17:35:04 +08:00
Songhaoz666andClaude Opus 4.8 54cb327348 Agent Swarm v6：基准 v2.1、主控 Agent、实质性对等回复、客户端指南 
- 基准标准 v2.1：SwarmMetrics（15 字段）、τ/η/P_decision/reward 公式、对称 G_E,c（修正 C_base=1.0 退化）、Σλ=1.0 校验；新增基线对比与运行记录 schema；指标覆盖缺口分析；参考系数暂留为元数据（待量化）。
- 主控 Agent 实体（分解 / 评审决策 / 汇总）；事件契约修正（timeline.title、budget.threshold_pct、handoff 角色、task.released）+ 契约校验脚本。
- 实质性 LLM 对等回复（含降级回退）；集成契约（runtime / event / usage / audit / frontend / capability / security）；CLIENT_GUIDE 客户端指南；CI 工作流；治理与交付文档。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-09 16:21:18 +08:00