Skip to content

docs(api): 补齐 Worker、归档与管理接口 / Document Worker, archive and management APIs - #82

Merged
yi-ge merged 1 commit into
mainfrom
codex/api-update-20261029
Oct 29, 2026
Merged

yi-ge merged 1 commit into
mainfrom
codex/api-update-20261029

Conversation

@yi-ge

@yi-ge yi-ge commented Oct 29, 2026

Copy link
Copy Markdown
Member

概要 / Summary

对照 DesireCore dev@724d8fe87c2e01a7495c3e22f1910e1b4486caa9,补齐8项公开操作,公开清单由50增至58(Agent Service50 / Compat3 / Workflow5),15组中英文页面。

Document eight additional operations against the pinned DesireCore dev snapshot. Public coverage grows from 50 to 58 operations across 15 bilingual page groups.

更新 / Changes

  • Worker列表与记录:父Run归属、状态推导、有效entry分页、公开字段/敏感结果投影;新增双语页面及 workers.mjs。
  • 归档手动话题与持久会话恢复引用:区分null、404和 500 SESSION_RESTORE_FAILED;扩展 history.mjs。
  • 算力准备显式重试:无query、无body,不重发业务请求;扩展 observe.mjs。
  • 团队归档列表/恢复与精确Workflow定义的TaskBoard绑定:owner凭据、恢复warnings、CAS/幂等和无隐式执行;新增双语管理页及 admin.mjs。
  • 同步 OpenAPI 1.4.0、catalog、下载镜像、导航、错误指南和维护记录。按当前共享Schema更新TaskBoard动作/claim/submission/review结构,区分数据版本3与默认策略V5;将重复内嵌详情结构改为组件引用。
  • 历史敏感结果同时移除modelOutput/modelOutputRefs,并说明普通结果中的可选模型文本投影。

Adds Worker records, archived manual topics, persistent recovery references, explicit Compute preparation retry, team archive management and exact Workflow definition bindings. Synchronizes bilingual guides, OpenAPI/catalog and eight downloadable scripts. Refreshes current TaskBoard schemas and privacy semantics. Management writes are explicit and are never automatically retried.

验证 / Verification

  • Pinned-source targeted tests: 327 passed in 20 files (237 route/domain tests + 84 TaskBoard tests + 6 management auth tests).
  • Node22 example tests: 85/85 passed; real local HTTP fixtures with synthetic responses.
  • Actual Fastify instance/governance hooks verify standalone token-only management and distinguish embedded team-archive source requirements from Workflow owner injection. Team/Workflow business ports and profile remain synthetic; no real team restore or provider call.
  • pnpm typecheck, pnpm api:check, bilingual pnpm build, pnpm api:check -- --build passed.
  • AJV Draft7: 200 component schemas / 65 normative JSON examples passed.
  • Redocly 2.63.0: 0 errors / 87 existing-category warnings; no ignore configuration or fabricated license.
  • Local delivery: 30 pages + 22 downloads passed, exact download bytes and canonical URLs checked.
  • Browser: Worker language switch and 12 representative bilingual pages/anchors at 390px, no page-wide overflow; viewport restored.

验证记录 / Detailed evidence: api/update-verification-2026-10-29.md.

范围 / Scope

源码无需修改;Worker投影修复已在源PR #5224合入,本批重新验证后公开。测试不代表真实模型、供应商或打包客户端端到端验收。尚未合并/部署或触发Algolia,不把旧搜索记录当成本批上线证明。

No source change is required. The previously merged Worker projection fix is revalidated before documenting these endpoints. This PR does not claim production deployment, search indexing, real-provider execution or packaged-client acceptance. Merge/deployment remain a separate step.

@vercel

vercel Bot commented Oct 29, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Oct 29, 2026 4:16am UTC

Request Review

@yi-ge
yi-ge merged commit 462a2eb into main Oct 29, 2026
6 checks passed
@yi-ge
yi-ge deleted the codex/api-update-20261029 branch October 29, 2026 06:18

This branch was successfully deployed

1 active deployment
Preview — d1bb0e1a Deployed Oct 29, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant