Skip to content

fix(protocol): regenerate OpenAPI documents - #1628

Merged
dezren39 merged 1 commit into
mainfrom
queue/8814-1560-protocol-openapi-regen
Nov 4, 2026
Merged

dezren39 merged 1 commit into
mainfrom
queue/8814-1560-protocol-openapi-regen

Conversation

@dezren39

@dezren39 dezren39 commented Nov 4, 2026

Copy link
Copy Markdown

Fixes #1560

What

Regeneration only — no schema or handler code changes:

  • packages/protocol/openapi.json: regenerated (bun run generate in packages/protocol)
  • services/www/openapi.json + services/www/public/openapi.json: regenerated from the updated protocol document (bun script/generate-openapi.ts in services/www)

All three documents are now byte-identical.

Current drift (updated evidence)

On current main (20a17ce) the model hidden properties from PR #1547 are already present in the protocol document; the remaining drift that kept check:generated red is description properties now present in the schemas:

  • policies: "Ordered policies controlling access to providers, tools, and integrations"
  • skills discovery paths, ambient instruction paths descriptions
  • the deprecated nested provider policies description
  • (www copies only, extra catch-up) the give-ups description: "Cannot exceed the outcome window, because the count reads only the retained outcomes in that window."

Verification

Queue task 8814.

packages/protocol/openapi.json was stale on main: check:generated exited 1. Regenerating adds the description properties now present in the schemas (policies, skills discovery, instructions, deprecated provider policies); the model hidden properties from #1547 are already present on current main. services/www copies regenerated from the updated protocol document (also catching up the give-ups description), so all three documents are identical and check:generated exits 0 in packages/protocol and services/www.

packages/client check:generated still fails on clean main with Unportable schema: config.config.get.success — pre-existing, verified with this change stashed, and covered by PR #1604.
@dezren39
dezren39 merged commit 6c43550 into main Nov 4, 2026
@dezren39
dezren39 deleted the queue/8814-1560-protocol-openapi-regen branch November 5, 2026 13:38
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.

fix(protocol): packages/protocol OpenAPI stale on main — model hidden field missing, check:generated red

1 participant