 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 |
|
|
gongzhiyongandClaude Opus 4.8
|
207e027fbb
|
feat(#56): 补 azkv SECRET_RESOLVER —— 用 Pod workload identity 从 heicode-vault 读模型 key
#56 缺口:`_resolve_secret_ref` 此前只读 dev 环境映射 `HEICODE_SECRET_<name>`,
没有生产从 Azure Key Vault 取 key 的实现(原注释写"适配器在仓外",实际缺)。
本次在仓内补上,走刚建好的 Pod workload identity:
- `_resolve_from_keyvault`:`DefaultAzureCredential` + `SecretClient` 读 azkv:// ref;
**lazy import** azure SDK,任何失败(未启用/不可解析/SDK 缺/无凭证/网络/secret 不存在)
返回 None —— 不伪造、不抛。
- `_azkv_enabled`:**仅当** Pod 注入了 workload identity(`AZURE_FEDERATED_TOKEN_FILE`)
或显式 `SECRET_RESOLVER=azkv` 才真连 KV —— dev/CI/测试保持 hermetic、不碰网络。
- `_parse_azkv_ref`:解析 `azkv://<vault>/secrets/<name>[/<ver>]`(裸名→`https://<name>.vault.azure.net`,
全 host 保留,兼容短形式)。
- `_resolve_secret_ref` 顺序:dev 环境映射 → KV(workload identity),保持既有 dev 行为不变。
- requirements:加 `azure-keyvault-secrets`(lazy import;`azure-identity` 已在)。
测试 `test-agent-launcher.py` 新增:azkv 解析、gating(默认关、两种开关)、disabled→None。
`test-agent-launcher` / `test-key-injection-contract` 全绿。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
2026-06-14 19:17:29 +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 |
|
|
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 |
|