@greatwait/contracts 0.1.0-alpha.1

package/generated/v1/callback-receiver.json

@@ -0,0 +1,241 @@
+{
+  "idempotency": {
+    "occurrence": {
+      "identity": "Callback-Occurrence-Id",
+      "note": "Every automatic delivery of one occurrence — the first attempt and every retry the system chose — is at most one execution. A receiver claims the occurrence atomically and answers 200 for every later automatic delivery of it. This is what makes at-least-once delivery safe; a receiver that needs a second execution asks for a second occurrence, or a person orders a redelivery.",
+      "requirement": "claim the occurrence atomically before running the handler; release the claim if the handler fails so a later attempt can retry it"
+    },
+    "redelivery": {
+      "identity": "Callback-Occurrence-Id together with the signed attempt number, which is the redelivery's ordinal",
+      "note": "A redelivery is a deliberate, authorized instruction to do the work again. Suppressing it as a duplicate answers a person with silence, which is what a customer pressing redeliver after fixing their endpoint experiences as the attempt succeeding while nothing happens.",
+      "optOut": "A receiver that genuinely requires strict once-only per occurrence chooses it explicitly and keeps answering duplicate. It is an opt-out, not the default, because a default of suppression makes the product lie to the person who pressed the button.",
+      "ordering": "attempt only ever increases within an occurrence and every copy of one redelivery carries the same value, so a receiver keeps the highest redelivery it has run to completion and refuses anything at or below it. That is what recognises a copy delayed in a proxy, a queue or an abandoned connection, however late it arrives and however many redeliveries have completed since. Remembering only the most recent instruction cannot do this and will run a customer's work twice; remembering every instruction can, at the cost of a store that grows without bound. sourceAttemptId names the attempt the person chose to follow and is there to show them, not to decide whether the work runs.",
+      "requirement": "run the handler again for a redelivery whose attempt is above the highest this receiver has run to completion for the occurrence, and suppress every redelivery at or below that high-water mark",
+      "strictness": "A receiver that chose strict once-only suppresses every delivery for an occurrence once anything has finished, whatever caused it. Reading strictness as a rule about redeliveries alone leaves a hole: a strict receiver that processed a redelivery first would then admit a delayed automatic delivery and run a payment twice.",
+      "warranty": "Each accepted redelivery is one logical run. Repeats are suppressed once the receiver has durably completed that run — not from the moment it starts one. A handler that performs its external effect and then dies before its claim is settled will be run again when the lease expires, which is the honest limit of what any at-least-once receiver can promise. A customer whose effect must happen exactly once commits the occurrence and ordinal alongside their own state, or passes them downstream as an idempotency key."
+    },
+    "replay": {
+      "identity": "Callback-Delivery-Id",
+      "requirement": "reject a previously accepted delivery identity before parsing, and answer 200 — a duplicated request is not a failure"
+    }
+  },
+  "claimRules": [
+    "another delivery holds an unexpired lease, whatever the run, so an ordered redelivery never runs alongside the attempt it follows -> in_flight",
+    "the delivery may not retake a settled occurrence and anything at all has finished for it -> settled. This covers every automatic delivery and every delivery at a receiver that chose strict once-only",
+    "the delivery is a redelivery whose ordinal is at or below the highest this receiver has run to completion -> settled",
+    "otherwise take it, recording the holder and the run -> claimed"
+  ],
+  "order": [
+    "read the exact request bytes before any body parser sees them",
+    "reject a body over the receiver's byte bound without buffering it",
+    "validate the five Callback-* headers and the content type",
+    "reject a timestamp outside tolerance",
+    "select the signing key by Callback-Key-Id within the receiver's own endpoint, project, and environment",
+    "compare the HMAC in constant time over <timestamp>.<delivery-id>. plus the exact bytes",
+    "compare the canonical envelope identifiers with the occurrence header",
+    "claim the delivery identity atomically",
+    "only now parse the body, and read the trigger that says why this delivery exists",
+    "claim the occurrence identity atomically, for the run the signed body names — the occurrence for an automatic delivery, and the occurrence with the redelivery's attempt ordinal for one a person ordered",
+    "run the application handler"
+  ],
+  "responses": {
+    "body_too_large": 413,
+    "duplicate": 200,
+    "handler_failed": 500,
+    "in_flight": 503,
+    "invalid_envelope": 400,
+    "invalid_headers": 401,
+    "invalid_signature": 401,
+    "processed": 200,
+    "replay": 200,
+    "stale_timestamp": 408
+  },
+  "sink": {
+    "behaviors": {
+      "client_error": {
+        "defaultStatus": 422,
+        "receiverActed": false,
+        "senderOutcome": "terminal",
+        "summary": "Answers a selected 4xx. The sender records a customer refusal, and retries it only when the status is one the receiver may recover from — 401, 403 and 404, listed as `clientErrorStatusesRetried`. The default, 422, is not one of those, so it settles on the first attempt."
+      },
+      "defer_abandon": {
+        "defaultStatus": 202,
+        "deferredReport": "never",
+        "receiverActed": true,
+        "senderOutcome": "ambiguous",
+        "summary": "Acknowledges the delivery and then never reports at all. The sender waits until the deadline in the envelope and records ambiguity, because a receiver that took the work and went quiet may well have done it. This is the case the completion deadline exists to bound."
+      },
+      "defer_fail": {
+        "defaultStatus": 202,
+        "deferredReport": "failed",
+        "receiverActed": true,
+        "senderOutcome": "retryable",
+        "summary": "Acknowledges the delivery, then reports `failed` with the credential in its signed envelope. The occurrence goes back on the ordinary retry ladder — the same place a 500 puts it — which is how a receiver says its job died rather than that it vanished."
+      },
+      "defer_succeed": {
+        "defaultStatus": 202,
+        "deferredReport": "succeeded",
+        "receiverActed": true,
+        "senderOutcome": "success",
+        "summary": "Acknowledges the delivery with 202 and the pending marker, keeps the work, then reports `succeeded` with the credential in its signed envelope. The whole deferred exchange, without writing a receiver."
+      },
+      "delay": {
+        "defaultStatus": 200,
+        "receiverActed": true,
+        "senderOutcome": "success",
+        "summary": "Waits a bounded interval, then accepts. Exercises a slow receiver that still succeeds."
+      },
+      "disconnect": {
+        "receiverActed": false,
+        "senderOutcome": "ambiguous",
+        "summary": "Authenticates the delivery and then drops the connection without processing it, holding until the sender gives up. Nothing was claimed and nothing ran, but the sender cannot know that."
+      },
+      "duplicate": {
+        "defaultStatus": 200,
+        "receiverActed": false,
+        "senderOutcome": "success",
+        "summary": "Accepts and reports the occurrence as already handled, without processing it again. What occurrence idempotency looks like from the sender's side."
+      },
+      "invalid_signature": {
+        "defaultStatus": 401,
+        "receiverActed": false,
+        "senderOutcome": "retryable",
+        "summary": "Rejects the delivery as unauthenticated regardless of whether the signature verified. Exercises the key-mismatch path without forging a signature. The sender retries on the receiver's ordinary budget, because the usual cause is a credential the receiver is about to redeploy."
+      },
+      "rate_limited": {
+        "defaultStatus": 429,
+        "receiverActed": false,
+        "senderOutcome": "retryable",
+        "summary": "Answers 429 with a bounded Retry-After. The sender honours the hint and does not spend its give-up budget."
+      },
+      "server_error": {
+        "defaultStatus": 503,
+        "receiverActed": false,
+        "senderOutcome": "retryable",
+        "summary": "Answers a selected 5xx. The sender retries with backoff."
+      },
+      "success": {
+        "defaultStatus": 200,
+        "receiverActed": true,
+        "senderOutcome": "success",
+        "summary": "Verifies, records, and accepts."
+      },
+      "timeout": {
+        "receiverActed": true,
+        "senderOutcome": "ambiguous",
+        "summary": "Verifies and records the delivery, then never answers. The receiver acted and the sender cannot know it."
+      }
+    },
+    "bounds": {
+      "maxCompletionDelayMs": 5000,
+      "maxDelayMs": 10000,
+      "maxHoldMs": 45000,
+      "maxRetainedDeliveries": 50,
+      "maxSinksPerEnvironment": 10,
+      "maxRequestBodyBytes": 65536,
+      "maxRetainedBodyBytes": 4096
+    },
+    "clientErrorStatuses": [400, 401, 403, 404, 409, 410, 422],
+    "clientErrorStatusesRetried": [401, 403, 404],
+    "deferral": {
+      "acknowledgement": "{\"greatwait\":{\"status\":\"pending\"}}",
+      "note": "A deferring behavior answers this exact body with this status, then reports with the bearer credential from the delivery's own signed envelope — to the one completion address the stage is configured with, which the envelope's own URL must match. A delivery whose envelope carries no completion material, or names a different address, cannot defer, and the sink answers it as an ordinary success instead.",
+      "status": 202
+    },
+    "egress": "A test sink has no destination field: no program, no control operation and no request header names anywhere for it to send. The one request it performs is a deferred-completion report for a delivery it has already received and authenticated, to the URL and credential carried inside that delivery's signed envelope. It cannot forward or redirect a delivery.",
+    "visibility": "Test environments only. Organization, project, environment, and credential kind come from the verified principal; no request may widen them.",
+    "programSchema": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "type": "object",
+      "properties": {
+        "behavior": {
+          "type": "string",
+          "enum": [
+            "client_error",
+            "defer_abandon",
+            "defer_fail",
+            "defer_succeed",
+            "delay",
+            "disconnect",
+            "duplicate",
+            "invalid_signature",
+            "rate_limited",
+            "server_error",
+            "success",
+            "timeout"
+          ]
+        },
+        "completionDelayMs": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 5000
+        },
+        "delayMs": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 10000
+        },
+        "forDeliveries": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 100
+        },
+        "retryAfterSeconds": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 300
+        },
+        "status": {
+          "type": "integer",
+          "minimum": 400,
+          "maximum": 599
+        },
+        "then": {
+          "type": "string",
+          "enum": [
+            "client_error",
+            "defer_abandon",
+            "defer_fail",
+            "defer_succeed",
+            "delay",
+            "disconnect",
+            "duplicate",
+            "invalid_signature",
+            "rate_limited",
+            "server_error",
+            "success",
+            "timeout"
+          ]
+        }
+      },
+      "required": ["behavior"]
+    }
+  },
+  "version": "2026-08-23",
+  "acknowledgementSchema": {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "type": "object",
+    "properties": {
+      "disposition": {
+        "type": "string",
+        "enum": [
+          "body_too_large",
+          "duplicate",
+          "handler_failed",
+          "in_flight",
+          "invalid_envelope",
+          "invalid_headers",
+          "invalid_signature",
+          "processed",
+          "replay",
+          "stale_timestamp"
+        ]
+      },
+      "occurrenceId": {
+        "type": "string",
+        "pattern": "^occ_[0-9abcdefghjkmnpqrstvwxyz]{26}$"
+      }
+    },
+    "required": ["disposition"]
+  }
+}

package/generated/v1/examples/attempts.list.response.json

@@ -0,0 +1,24 @@
+{
+  "data": [
+    {
+      "attemptNumber": 1,
+      "classifiedAt": "2026-07-28T15:00:00.071Z",
+      "delivery": "dlv_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "diagnostic": "http_retryable",
+      "durationMs": 71,
+      "id": "att_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "occurrence": "occ_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "remediation": "review_retry_policy",
+      "responseStatus": 503,
+      "startedAt": "2026-07-28T15:00:00.000Z",
+      "state": "retryable_failure",
+      "trigger": {
+        "kind": "automatic"
+      }
+    }
+  ],
+  "freshness": {
+    "kind": "authoritative"
+  },
+  "nextCursor": "eyJhIjoxNzg1MjUwODAwMDAwLCJpIjoiYXR0XzAxaDh4eXo5azJtNG42cDhyMHQydjR3Nnk4IiwiayI6Ijk1MTM1NDZmIn0"
+}

package/generated/v1/examples/attempts.read.response.json

@@ -0,0 +1,20 @@
+{
+  "attempt": {
+    "attemptNumber": 2,
+    "classifiedAt": "2026-07-28T15:02:00.000Z",
+    "delivery": "dlv_11h8xyz9k2m4n6p8r0t2v4w6y8",
+    "diagnostic": "network_ambiguous",
+    "durationMs": 10000,
+    "id": "att_11h8xyz9k2m4n6p8r0t2v4w6y8",
+    "occurrence": "occ_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "remediation": "review_before_redelivery",
+    "startedAt": "2026-07-28T15:01:50.000Z",
+    "state": "ambiguous",
+    "trigger": {
+      "kind": "automatic"
+    }
+  },
+  "freshness": {
+    "kind": "authoritative"
+  }
+}

package/generated/v1/examples/credentials.create.request.json

@@ -0,0 +1,5 @@
+{
+  "environmentKind": "test",
+  "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "scopes": ["schedules:write"]
+}

package/generated/v1/examples/credentials.create.response.json

@@ -0,0 +1,10 @@
+{
+  "createdAt": "2026-07-28T15:00:00.000Z",
+  "displayPrefix": "pt_test_a1b2c3d4",
+  "environmentKind": "test",
+  "id": "ak_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "scopes": ["schedules:write"],
+  "secret": "pt_test_a1b2c3d4<the-32-character-secret-half-here>",
+  "shownOnce": true
+}

package/generated/v1/examples/credentials.list.response.json

@@ -0,0 +1,17 @@
+{
+  "data": [
+    {
+      "createdAt": "2026-07-28T15:00:00.000Z",
+      "displayPrefix": "pt_test_a1b2c3d4",
+      "environmentKind": "test",
+      "id": "ak_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "lastUsedAt": "2026-07-28T15:04:00.000Z",
+      "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "scopes": ["schedules:write"]
+    }
+  ],
+  "freshness": {
+    "kind": "authoritative"
+  },
+  "nextCursor": "eyJhIjoxNzg1MjUwODAwMDAwLCJpIjoiYWtfMDFoOHh5ejlrMm00bjZwOHIwdDJ2NHc2eTgiLCJrIjoiOTUxMzU0NmYifQ"
+}

package/generated/v1/examples/credentials.revoke.response.json

@@ -0,0 +1,11 @@
+{
+  "credential": {
+    "createdAt": "2026-07-28T15:00:00.000Z",
+    "displayPrefix": "pt_test_a1b2c3d4",
+    "environmentKind": "test",
+    "id": "ak_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "revokedAt": "2026-07-28T16:00:00.000Z",
+    "scopes": ["schedules:write"]
+  }
+}

package/generated/v1/examples/credentials.rotate.request.json

@@ -0,0 +1,3 @@
+{
+  "overlapSeconds": 3600
+}

package/generated/v1/examples/credentials.rotate.response.json

@@ -0,0 +1,22 @@
+{
+  "credential": {
+    "createdAt": "2026-07-28T15:00:00.000Z",
+    "displayPrefix": "pt_test_e5f6g7h8",
+    "environmentKind": "test",
+    "id": "ak_01h8xyz9k2m4n6p8r0t2v4w6y9",
+    "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "scopes": ["schedules:write"],
+    "secret": "pt_test_e5f6g7h8<the-32-character-secret-half-here>",
+    "shownOnce": true
+  },
+  "retired": {
+    "createdAt": "2026-07-28T15:00:00.000Z",
+    "displayPrefix": "pt_test_a1b2c3d4",
+    "environmentKind": "test",
+    "expiresAt": "2026-07-29T15:00:00.000Z",
+    "id": "ak_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "supersededBy": "ak_01h8xyz9k2m4n6p8r0t2v4w6y9",
+    "scopes": ["schedules:write"]
+  }
+}

package/generated/v1/examples/endpoints.create.request.json

@@ -0,0 +1,3 @@
+{
+  "url": "https://hooks.example.com/greatwait"
+}

package/generated/v1/examples/endpoints.create.response.json

@@ -0,0 +1,16 @@
+{
+  "createdAt": "2026-08-05T15:00:00.000Z",
+  "environmentKind": "test",
+  "id": "ep_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "signingKeys": {
+    "current": "csk_01h8xyz9k2m4n6p8r0t2v4w6y8"
+  },
+  "status": "pending",
+  "updatedAt": "2026-08-05T15:00:00.000Z",
+  "url": "https://hooks.example.com/greatwait",
+  "version": 1,
+  "keyId": "csk_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "secret": "ptsk_test_<the-one-time-endpoint-secret-here>",
+  "shownOnce": true
+}

package/generated/v1/examples/endpoints.disable.response.json

@@ -0,0 +1,15 @@
+{
+  "createdAt": "2026-08-05T15:00:00.000Z",
+  "disabledAt": "2026-08-05T17:00:00.000Z",
+  "environmentKind": "test",
+  "id": "ep_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "signingKeys": {
+    "current": "csk_01h8xyz9k2m4n6p8r0t2v4w6y8"
+  },
+  "status": "disabled",
+  "updatedAt": "2026-08-05T17:00:00.000Z",
+  "url": "https://hooks.example.com/greatwait",
+  "verifiedAt": "2026-08-05T15:01:00.000Z",
+  "version": 3
+}

package/generated/v1/examples/endpoints.list.response.json

@@ -0,0 +1,21 @@
+{
+  "data": [
+    {
+      "createdAt": "2026-08-05T15:00:00.000Z",
+      "environmentKind": "test",
+      "id": "ep_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "signingKeys": {
+        "current": "csk_01h8xyz9k2m4n6p8r0t2v4w6y8"
+      },
+      "status": "verified",
+      "updatedAt": "2026-08-05T15:01:00.000Z",
+      "url": "https://hooks.example.com/greatwait",
+      "verifiedAt": "2026-08-05T15:01:00.000Z",
+      "version": 2
+    }
+  ],
+  "freshness": {
+    "kind": "authoritative"
+  }
+}

package/generated/v1/examples/endpoints.read.response.json

@@ -0,0 +1,14 @@
+{
+  "createdAt": "2026-08-05T15:00:00.000Z",
+  "environmentKind": "test",
+  "id": "ep_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "signingKeys": {
+    "current": "csk_01h8xyz9k2m4n6p8r0t2v4w6y8"
+  },
+  "status": "verified",
+  "updatedAt": "2026-08-05T15:01:00.000Z",
+  "url": "https://hooks.example.com/greatwait",
+  "verifiedAt": "2026-08-05T15:01:00.000Z",
+  "version": 2
+}

package/generated/v1/examples/endpoints.rotateSigningKey.request.json

@@ -0,0 +1,3 @@
+{
+  "overlapSeconds": 3600
+}

package/generated/v1/examples/endpoints.rotateSigningKey.response.json

@@ -0,0 +1,23 @@
+{
+  "endpoint": {
+    "createdAt": "2026-08-05T15:00:00.000Z",
+    "environmentKind": "test",
+    "id": "ep_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "signingKeys": {
+      "current": "csk_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "next": {
+        "id": "csk_11h8xyz9k2m4n6p8r0t2v4w6y8",
+        "overlapEndsAt": "2026-08-06T15:05:00.000Z"
+      }
+    },
+    "status": "verified",
+    "updatedAt": "2026-08-05T15:05:00.000Z",
+    "url": "https://hooks.example.com/greatwait",
+    "verifiedAt": "2026-08-05T15:01:00.000Z",
+    "version": 3
+  },
+  "keyId": "csk_11h8xyz9k2m4n6p8r0t2v4w6y8",
+  "secret": "ptsk_test_<the-next-one-time-endpoint-secret-here>",
+  "shownOnce": true
+}

package/generated/v1/examples/endpoints.update.request.json

@@ -0,0 +1,3 @@
+{
+  "url": "https://hooks.example.com/replacement"
+}

package/generated/v1/examples/endpoints.update.response.json

@@ -0,0 +1,13 @@
+{
+  "createdAt": "2026-08-05T15:00:00.000Z",
+  "environmentKind": "test",
+  "id": "ep_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "signingKeys": {
+    "current": "csk_01h8xyz9k2m4n6p8r0t2v4w6y8"
+  },
+  "status": "pending",
+  "updatedAt": "2026-08-05T16:00:00.000Z",
+  "url": "https://hooks.example.com/replacement",
+  "version": 3
+}

package/generated/v1/examples/endpoints.verify.response.json

@@ -0,0 +1,15 @@
+{
+  "createdAt": "2026-08-05T15:00:00.000Z",
+  "environmentKind": "test",
+  "id": "ep_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "lastVerificationAttemptAt": "2026-08-05T15:01:00.000Z",
+  "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "signingKeys": {
+    "current": "csk_01h8xyz9k2m4n6p8r0t2v4w6y8"
+  },
+  "status": "verified",
+  "updatedAt": "2026-08-05T15:01:00.000Z",
+  "url": "https://hooks.example.com/greatwait",
+  "verifiedAt": "2026-08-05T15:01:00.000Z",
+  "version": 2
+}

package/generated/v1/examples/forecast.read.response.json

@@ -0,0 +1,28 @@
+{
+  "buckets": [
+    {
+      "byLatencyClass": {
+        "bulk": 12,
+        "realtime": 3
+      },
+      "byPartitionKey": {
+        "campaign.spring": 9,
+        "campaign.winter": 4
+      },
+      "count": 15,
+      "nextFireCount": 4,
+      "otherPartitionKeyCount": 2,
+      "start": "2026-07-28T15:00:00.000Z"
+    }
+  ],
+  "freshness": {
+    "asOf": "2026-07-28T14:58:30.000Z",
+    "kind": "projected",
+    "lagSeconds": 90
+  },
+  "window": {
+    "bucketSeconds": 1800,
+    "from": "2026-07-28T15:00:00.000Z",
+    "to": "2026-07-29T15:00:00.000Z"
+  }
+}

package/generated/v1/examples/forecast.windows.response.json

@@ -0,0 +1,21 @@
+{
+  "bucketSeconds": 600,
+  "buckets": [
+    {
+      "byTenant": {
+        "campaign.spring": 9,
+        "campaign.winter": 4
+      },
+      "count": 15,
+      "nextFireCount": 4,
+      "otherCount": 2,
+      "start": "2026-07-28T15:00:00.000Z"
+    }
+  ],
+  "freshness": {
+    "asOf": "2026-07-28T14:58:30.000Z",
+    "kind": "projected",
+    "lagSeconds": 90
+  },
+  "version": "2026-08-09"
+}

package/generated/v1/examples/grants.list.response.json

@@ -0,0 +1,17 @@
+{
+  "data": [
+    {
+      "client": {
+        "id": "oc_01h8xyz9k2m4n6p8r0t2v4w6y8",
+        "name": "Flow XO"
+      },
+      "createdAt": "2026-08-14T11:00:00.000Z",
+      "environmentKind": "test",
+      "id": "og_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "lastUsedAt": "2026-08-15T09:12:00.000Z",
+      "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "scopes": ["schedules:read", "schedules:write"],
+      "status": "active"
+    }
+  ]
+}

package/generated/v1/examples/grants.revoke.response.json

@@ -0,0 +1,16 @@
+{
+  "grant": {
+    "client": {
+      "id": "oc_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "name": "Flow XO"
+    },
+    "createdAt": "2026-08-14T11:00:00.000Z",
+    "environmentKind": "test",
+    "id": "og_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "revocationReason": "member-revoked",
+    "revokedAt": "2026-08-15T10:00:00.000Z",
+    "scopes": ["schedules:read", "schedules:write"],
+    "status": "revoked"
+  }
+}

package/generated/v1/examples/meta.scaffold.response.json

@@ -0,0 +1,5 @@
+{
+  "dependsOn": ["application", "contract", "platform"],
+  "layer": "adapter",
+  "service": "@greatwait/api"
+}

package/generated/v1/examples/meta.version.response.json

@@ -0,0 +1,5 @@
+{
+  "buildSha": "9f2c1ab",
+  "environment": "development",
+  "service": "@greatwait/api"
+}

package/generated/v1/examples/occurrences.list.response.json

@@ -0,0 +1,17 @@
+{
+  "data": [
+    {
+      "attemptCount": 1,
+      "generation": 1,
+      "id": "occ_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "plannedFor": "2026-07-28T15:00:00.000Z",
+      "schedule": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "sequence": 1,
+      "state": "retry_wait"
+    }
+  ],
+  "freshness": {
+    "kind": "authoritative"
+  },
+  "nextCursor": "eyJhIjoxNzg1MjUwODAwMDAwLCJpIjoib2NjXzAxaDh4eXo5azJtNG42cDhyMHQydjR3Nnk4IiwiayI6Ijk1MTM1NDZmIn0"
+}

package/generated/v1/examples/occurrences.read.response.json

@@ -0,0 +1,15 @@
+{
+  "freshness": {
+    "kind": "authoritative"
+  },
+  "occurrence": {
+    "attemptCount": 2,
+    "generation": 1,
+    "id": "occ_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "plannedFor": "2026-07-28T15:00:00.000Z",
+    "schedule": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "sequence": 1,
+    "settledAt": "2026-07-28T15:02:00.000Z",
+    "state": "terminal_failed"
+  }
+}