Skip to content

Commit 6838dcd

Browse files
mikemolinetclaude
andcommitted
chore(manifest): refresh — last_audit 2026-05-04 → 2026-05-07; reflect recent ports
Manifest was 3 days stale; many endpoints listed as missing have been ported since the last audit. Moved from endpoints_missing → endpoints_covered (with PR refs): - POST /v1/cues/{id}/fire (PR #23; in-flight kwargs in #33) - POST /v1/executions/{id}/replay (PR #25) - GET /v1/executions/claimable (PR #23) - POST /v1/executions/{id}/claim (PR #23) - POST /v1/executions/claim (PR #23) - GET /v1/workers + DELETE /v1/workers/{id} (PR #26) - GET /v1/usage (PR #26) - POST /v1/agents + GET/PATCH/DELETE /v1/agents/{ref} + GET /v1/agents/{ref}/webhook-secret + GET /v1/agents/{ref}/inbox + /sent (PR #27) - POST /v1/messages + GET/read/ack (PR #28) Added in-flight refs (open PRs): - GET /v1/agents/roster (in-flight PR #35; cueapi #630 parity) - GET /v1/agents/{ref}/presence (in-flight PR #35; cueapi #662 parity) - send_at + exit_criteria + idempotency_key kwargs on fire (PR #33) - send_at kwarg on messages.send (PR #34) New endpoints_missing items (post-audit): - POST /v1/agents/{ref}/webhook-secret/regenerate (destructive; tracked) - DELETE /v1/messages bulk (cueapi #650; bounded by cueapi-cli upstream) - POST /v1/executions/{id}/live-claim (cueapi #664; handler-runtime, not SDK) New "in_flight_ports_2026_05_07" section listing all 4 currently-open SDK PRs with PR-overlap notes (PR #30/#33 lane-flagged with cueapi-main). Bumped sdk_version_at_audit 0.1.3 → 0.2.x. This refresh closes the Backlog row "Refresh cueapi-python parity-manifest.json" filed earlier today (Self-flag 2026-05-07). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent b30d23b commit 6838dcd

1 file changed

Lines changed: 39 additions & 20 deletions

File tree

parity-manifest.json

Lines changed: 39 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@
66
"app/routers/",
77
"app/schemas/"
88
],
9-
"last_full_audit": "2026-05-04",
10-
"sdk_version_at_audit": "0.1.3",
9+
"last_full_audit": "2026-05-07",
10+
"sdk_version_at_audit": "0.2.x",
1111
"audit_methodology": "Walk every endpoint in private cueapi/app/routers/ and check coverage in cueapi/resources/. For each covered endpoint, walk the corresponding schemas/*.py to verify field-level coverage in cueapi/models/. Drift goes in `missing_endpoints` or `missing_fields` keyed by endpoint.",
1212
"audit_cadence": "Monthly full sweep. Per-PR diffs handled via the .github/pull_request_template.md `Parity Impact` section in the private repo.",
1313

@@ -20,34 +20,53 @@
2020
"DELETE /v1/cues/{id}": {"sdk": "client.cues.delete"},
2121
"POST /v1/cues/{id} (pause)": {"sdk": "client.cues.pause"},
2222
"POST /v1/cues/{id} (resume)": {"sdk": "client.cues.resume"},
23+
"POST /v1/cues/{id}/fire": {"sdk": "client.cues.fire (PR #23; in-flight kwargs send_at + exit_criteria + idempotency_key in #33)"},
2324
"POST /v1/executions/{id}/outcome": {"sdk": "client.executions.report_outcome"},
2425
"GET /v1/executions": {"sdk": "client.executions.list"},
2526
"GET /v1/executions/{id}": {"sdk": "client.executions.get"},
2627
"POST /v1/executions/{id}/heartbeat": {"sdk": "client.executions.heartbeat"},
2728
"POST /v1/executions/{id}/verification-pending": {"sdk": "client.executions.mark_verification_pending"},
28-
"POST /v1/executions/{id}/verify": {"sdk": "client.executions.mark_verified"}
29+
"POST /v1/executions/{id}/verify": {"sdk": "client.executions.mark_verified"},
30+
"POST /v1/executions/{id}/replay": {"sdk": "client.executions.replay (PR #25)"},
31+
"GET /v1/executions/claimable": {"sdk": "client.executions.list_claimable (PR #23)"},
32+
"POST /v1/executions/{id}/claim": {"sdk": "client.executions.claim (PR #23)"},
33+
"POST /v1/executions/claim": {"sdk": "client.executions.claim_next (PR #23)"},
34+
"GET /v1/workers": {"sdk": "client.workers.list (PR #26)"},
35+
"DELETE /v1/workers/{id}": {"sdk": "client.workers.delete (PR #26)"},
36+
"GET /v1/usage": {"sdk": "client.usage.get (PR #26)"},
37+
"POST /v1/agents": {"sdk": "client.agents.create (PR #27)"},
38+
"GET /v1/agents": {"sdk": "client.agents.list (PR #27)"},
39+
"GET /v1/agents/{ref}": {"sdk": "client.agents.get (PR #27)"},
40+
"PATCH /v1/agents/{ref}": {"sdk": "client.agents.update (PR #27)"},
41+
"DELETE /v1/agents/{ref}": {"sdk": "client.agents.delete (PR #27)"},
42+
"GET /v1/agents/{ref}/webhook-secret": {"sdk": "client.agents.get_webhook_secret (PR #27)"},
43+
"GET /v1/agents/{ref}/inbox": {"sdk": "client.agents.inbox (PR #27)"},
44+
"GET /v1/agents/{ref}/sent": {"sdk": "client.agents.sent (PR #27)"},
45+
"GET /v1/agents/roster": {"sdk": "client.agents.roster (in-flight PR #35; cueapi #630 parity)"},
46+
"GET /v1/agents/{ref}/presence": {"sdk": "client.agents.presence (in-flight PR #35; cueapi #662 parity)"},
47+
"POST /v1/messages": {"sdk": "client.messages.send (PR #28; in-flight send_at kwarg in #34)"},
48+
"GET /v1/messages/{id}": {"sdk": "client.messages.get (PR #28)"},
49+
"POST /v1/messages/{id}/read": {"sdk": "client.messages.mark_read (PR #28)"},
50+
"POST /v1/messages/{id}/ack": {"sdk": "client.messages.ack (PR #28)"}
2951
},
3052

3153
"endpoints_missing": {
32-
"POST /v1/cues/{id}/fire": {
33-
"blocker": "Real ergonomic gap. Team-comm convention requires payload_override per fire; SDK users currently fall back to raw httpx.",
34-
"tracking": "Backlog row: priority=now after the audit ships. Should pair with the PR #590 require_payload_override port since cue-fire is the primary surface for that enforcement."
35-
},
36-
"POST /v1/executions/{id}/replay": {"blocker": "Used for retry-from-failure flows; not in any current SDK release."},
37-
"GET /v1/executions/claimable": {"blocker": "Worker-pull endpoint; some SDK users want to write Python workers directly without using cueapi-worker."},
38-
"POST /v1/executions/{id}/claim": {"blocker": "Same as above — worker-pull surface missing."},
39-
"POST /v1/worker/heartbeat": {"blocker": "Worker registration endpoint; same justification."},
40-
"GET /v1/workers": {"blocker": "List workers + heartbeat status; useful for fleet visibility."},
41-
"GET /v1/usage": {"blocker": "Plan, cue count, execution usage, rate limit info. Currently SDK users hit /v1/auth/me only."},
54+
"POST /v1/worker/heartbeat": {"blocker": "Worker registration endpoint; users typically run cueapi-worker package which handles this internally."},
4255
"POST /v1/billing/checkout": {"blocker": "Hosted-only — wrap if/when hosted users need programmatic checkout."},
4356
"POST /v1/billing/portal": {"blocker": "Hosted-only."},
44-
"POST /v1/auth/key/regenerate": {"blocker": "Risky destructive op; intentionally not surfaced. Re-evaluate."},
45-
"GET /v1/auth/webhook-secret": {"blocker": "Webhook-secret retrieval — SDK users running their own webhook servers want this."},
46-
"POST /v1/auth/webhook-secret/regenerate": {"blocker": "Destructive; re-evaluate."},
47-
"Messaging primitive (all of /v1/agents, /v1/messages, /v1/agents/{id}/inbox)": {
48-
"blocker": "Phase 12.1.5 messaging primitive is on prod but not yet exposed in the SDK. Significant new surface — agent identity, send_message, inbox poll, idempotency-keyed sends, reply threading.",
49-
"tracking": "Major SDK extension. Should land before push delivery (v1.5) goes wide."
50-
}
57+
"POST /v1/auth/key/regenerate": {"blocker": "Risky destructive op; intentionally not surfaced."},
58+
"GET /v1/auth/webhook-secret": {"blocker": "Webhook-secret retrieval — could surface if SDK users want to verify signatures programmatically. Re-evaluate."},
59+
"POST /v1/auth/webhook-secret/regenerate": {"blocker": "Destructive; intentionally not surfaced."},
60+
"POST /v1/agents/{ref}/webhook-secret/regenerate": {"blocker": "Destructive; needs --confirm-destructive pattern. Tracked on Backlog (Drift-audit deferred 2026-05-07)."},
61+
"DELETE /v1/messages bulk (cueapi #650)": {"blocker": "Server-side shipped; not yet in cueapi-cli. SDK can port directly. Tracked on Backlog (Drift-audit deferred 2026-05-07)."},
62+
"POST /v1/executions/{id}/live-claim (cueapi #664)": {"blocker": "P0 Live-claim attestation endpoint. Handler-runtime concern, not SDK control-plane. Re-evaluate if SDK users build live-attached handlers in Python."}
63+
},
64+
65+
"in_flight_ports_2026_05_07": {
66+
"PR #33 (open)": "client.cues.fire(send_at, exit_criteria, idempotency_key) — covers cueapi #618 + #632 + #683",
67+
"PR #34 (open)": "client.messages.send(send_at) — covers cueapi #623",
68+
"PR #35 (open)": "client.agents.roster() + client.agents.presence() — covers cueapi #630 + #662",
69+
"PR #30 (open, lane-flagged with cueapi-main)": "client.cues.fire(send_at) — narrower scope of #33"
5170
},
5271

5372
"model_drift": {

0 commit comments

Comments
 (0)