Skip to content

docs(openapi): sync session routes from control-plane (A4)#68

Open
George-iam wants to merge 2 commits into
mainfrom
feat/openapi-session-routes-20260520
Open

docs(openapi): sync session routes from control-plane (A4)#68
George-iam wants to merge 2 commits into
mainfrom
feat/openapi-session-routes-20260520

Conversation

@George-iam
Copy link
Copy Markdown
Contributor

Summary

Companion to control-plane PR https://github.com/AxmeAI/axme-control-plane/pull/205 — re-exports gateway.v1.json (and the track-f-sprint1 subset) so the docs CI OpenAPI parity gate stays green once both PRs land on main.

New paths (under /v1/sessions/*):

  • POST /v1/sessions
  • GET /v1/sessions
  • GET /v1/sessions/{session_id}
  • POST /v1/sessions/{session_id}/messages
  • GET /v1/sessions/{session_id}/messages
  • GET /v1/sessions/{session_id}/events
  • POST /v1/sessions/{session_id}/spawn-intent

New request schemas: CreateSessionRequest, SessionMessageCreateRequest, SessionSpawnIntentRequest. The track-f subset gains these schemas in components.schemas as a side effect of the existing subset extractor — no track-f path filter changes.

Test plan

  • CI parity gate diff -u docs/openapi/gateway.*.json axme-control-plane/docs/openapi/gateway.*.json is clean (requires control-plane #205 to be on main first; until then the CI in this PR will diff against old main and fail — that's expected and documented in the merge order below)
  • Merge order: control-plane #205 → axme-docs (this PR). Both PRs are owned by George; no agent-side merge.

Re-exports gateway.v1.json (+ track-f subset) against control-plane PR
#205 (feat/session-routes-20260520). Adds 7 paths under /v1/sessions/*
and 3 request schemas (CreateSessionRequest, SessionMessageCreateRequest,
SessionSpawnIntentRequest). The track-f subset gains the same request
schemas in components/schemas as a side effect of the existing subset
extractor; no track-f path filters change.

Required for the docs CI OpenAPI parity gate to stay green once
control-plane PR #205 lands on main.

#!axme pr=none repo=AxmeAI/axme-docs
Re-export against control-plane PR #205 commit 0a53765 (A4 + A5 + A6 stack):
- new path GET /v1/sessions/{session_id}/stream (SSE)
- session message responses gain optional encryption_alg field

Required for the docs CI OpenAPI parity gate to stay green once
control-plane PR #205 lands on main.

#!axme pr=68 repo=AxmeAI/axme-docs
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