Skip to content

Publish existing Run API contract - #54

Merged
wms2537 merged 1 commit into
mainfrom
agent/issue-49-run-contract
Jul 22, 2026
Merged

Publish existing Run API contract#54
wms2537 merged 1 commit into
mainfrom
agent/issue-49-run-contract

Conversation

@wms2537

@wms2537 wms2537 commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Closes #49

What changed

  • publishes the existing run-as-session/v1 Run create/resource/event JSON Schemas and checked compatibility fixtures
  • adds authenticated contract discovery and stable fail-closed handling for unsupported versions
  • validates real create/get/event HTTP responses against the packaged contract
  • includes the contract bundle in the OCI image
  • documents that Run completion does not imply a Kertas Outcome or Release

Why

Kertas needs a public, machine-readable compatibility boundary before the runtime introduces ManagedSession. This freezes the currently supported Run-as-session seam without exposing runtime storage or adding Kertas product state.

Review fixes

  • added the full Run-events HTTP envelope
  • aligned debugFaultPoints and UTC-only scheduledFor semantics with the existing route
  • froze all always-returned Run fields and rejected unexpected product fields
  • extracted shared validator setup and reused the event schema by reference

Validation

  • npm run typecheck
  • npm test — 58 files / 440 tests
  • npm run release:gate — PASS at ccf3fa08319a162ed43a26b27f0feff124a62dc1
  • npm audit --omit=dev — 0 vulnerabilities
  • independent Standards review — PASS
  • independent Spec review — PASS

@wms2537
wms2537 merged commit 634f45e into main Jul 22, 2026
1 check passed
@wms2537
wms2537 deleted the agent/issue-49-run-contract branch July 22, 2026 06:49
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.

P1: Publish machine-readable existing Run API and event schemas

1 participant