Product Contract

One schema. HTTP /v1 is the projection.

The sole public schema is Protobuf Edition 2023 at api/proto/sylphx/compute/v1/compute.proto with contract/product.json. HTTP /v1 on https://api.compute.sylphx.com is the serving projection. Atlas SQL, handler structs, and a handwritten OpenAPI beside the contract are not the public schema.

Envelope

Audience and API: https://api.compute.sylphx.com/v1. Discovery is Binding api_base.

Callers present a Platform-signed Ed25519 Project Binding (typ=sylphx-project-binding+jwt) and an Identity-signed Delegation (typ=sylphx-delegation+jwt). Compute verifies Binding; it does not mint Binding. There is no Compute product API key. COMPUTE_API_KEY is local scaffold only.

POST /v1/schedules/{id}:tick admits typ=sylphx-wake+jwt only. Binding and the local scaffold key are not that door.

Customer operations
Job	REST projection	Meaning
Create a Job	`POST /v1/jobs`	Revisioned artifact-backed definition plus a mutation Operation.
Read Jobs	`GET /v1/jobs`, `GET /v1/jobs/{id}`	Project-scoped. Bounded cursor lists.
Revise or tombstone	`PATCH` / `DELETE /v1/jobs/{id}`	Revision-fenced. Active execution is conflict.
Request execution	`POST /v1/jobs/{id}:execute`	Admits an Operation. Not a local run. Not a receipt.
Create a Schedule	`POST /v1/schedules`	Calendar, timezone field, overlap, catch-up, target. Same row on exact replay.
Pause / resume / delete	`POST …:pause`, `:resume`, `DELETE`	Revision-fenced. Commands the next Wake.
Observe	`GET /v1/operations/{id}`, `/execution`, `/receipt`, `/usage-facts`	Compact execution omits unbounded history. Receipt is generation-bound.
Clock Tick	`POST /v1/schedules/{id}:tick`	Wake JWT only. Records one Tick, then fires the target.

Errors

Expected failures use a typed envelope with authority=compute. Reusing an idempotency key with changed intent, or a stale revision or generation, is 409 and writes no extra row. Missing or forged Binding is 401. An unavailable provider on :execute is a truthful blocked Operation with no receipt, not a fake success.

Generated clients

Generated SDK and CLI are Compute identities from this same proto (compute-sdk, CLI binary compute). Do not treat Platform sylphx-sdk or sylphx-cli as the Compute client. Session types exist on the contract; POST /v1/sessions is not first success on this site.

Authority files in the source repository: api/proto/sylphx/compute/v1/compute.proto and contract/product.json.