@greatwait/contracts 0.2.3 → 0.3.1

package/dist/signatures.js

@@ -34,9 +34,9 @@ export const SIGNATURE_TOLERANCE_SECONDS = 300;
 export const CALLBACK_DELIVERY_PROTOCOL_VERSION = "2026-08-23";
 /** The media type sent on every occurrence delivery. */
 export const CALLBACK_CONTENT_TYPE = "application/json";
-export const signatureHeaderSchema = z
+export const signatureHeaderSchema = /* @__PURE__ */ (() => z
     .string()
-    .regex(/^v1=[0-9a-f]{64}$/u, "must be v1= followed by a lowercase hex SHA-256 HMAC");
+    .regex(/^v1=[0-9a-f]{64}$/u, "must be v1= followed by a lowercase hex SHA-256 HMAC"))();
 /**
  * The exact bytes that are signed: `<timestamp>.<delivery-id>.` followed by the
  * raw body, with no re-serialization anywhere in the path. Re-encoding JSON
@@ -130,13 +130,13 @@ export function isTimestampFresh(timestamp, nowMs, toleranceSeconds = SIGNATURE_
  * an unauthenticated hint has handed anyone who can reach its endpoint a
  * duplicate-execution button.
  */
-export const callbackTriggerSchema = z.discriminatedUnion("kind", [
+export const callbackTriggerSchema = /* @__PURE__ */ (() => z.discriminatedUnion("kind", [
     z.object({ kind: z.literal("automatic") }),
     z.object({
         kind: z.literal("redelivery"),
         sourceAttemptId: attemptIdSchema,
     }),
-]);
+]))();
 /**
  * The envelope version this service emits.
  *
@@ -178,7 +178,7 @@ export const CALLBACK_ENVELOPE_VERSIONS = [
     CALLBACK_ENVELOPE_VERSION_2026_08_08,
     CALLBACK_ENVELOPE_VERSION,
 ];
-const callbackEnvelopeShape = {
+const callbackEnvelopeShape = /* @__PURE__ */ (() => ({
     attempt: z.number().int().positive(),
     /**
      * The customer's payload, delivered verbatim. Deliberately any JSON value:
@@ -190,7 +190,7 @@ const callbackEnvelopeShape = {
     plannedFor: timestampSchema,
     scheduleId: scheduleIdSchema,
     type: z.literal("schedule.occurrence"),
-};
+}))();
 /**
  * Where a `callback` receiver reports that it finished, and with what.
  *
@@ -207,12 +207,12 @@ const callbackEnvelopeShape = {
  * later attempt is refused by the same fence that refuses a late executor
  * result.
  */
-export const callbackCompletionSchema = z.object({
+export const callbackCompletionSchema = /* @__PURE__ */ (() => z.object({
     /** Bearer credential for the report. Send it, do not inspect it. */
     token: z.string().min(1),
     /** Absolute URL to POST to when the work is done. */
     url: z.url(),
-});
+}))();
 /**
  * The completion material every `2026-08-23` delivery carries.
  *
@@ -227,21 +227,21 @@ export const callbackCompletionSchema = z.object({
  * ask for an earlier instant in its acknowledgement and may not ask for a
  * later one.
  */
-export const callbackDeferredCompletionSchema = z.object({
+export const callbackDeferredCompletionSchema = /* @__PURE__ */ (() => z.object({
     /** When this attempt stops being waited for. Absolute, not a duration. */
     deadline: timestampSchema,
     /** Bearer credential for the report. Send it, do not inspect it. */
     token: z.string().min(1),
     /** Absolute URL to POST to when the work is done. */
     url: z.url(),
-});
+}))();
 /**
  * The report body, whose vocabulary lives in the Zod-free `delivery` module so
  * the scheduler's completion route can read it without importing Zod.
  */
-export const callbackCompletionReportSchema = z.object({
+export const callbackCompletionReportSchema = /* @__PURE__ */ (() => z.object({
     outcome: z.enum(CALLBACK_COMPLETION_OUTCOMES).default("succeeded"),
-});
+}))();
 /**
  * The versioned JSON envelope delivered to a customer endpoint.
  *
@@ -251,7 +251,7 @@ export const callbackCompletionReportSchema = z.object({
  * envelope. Collapsing the two would leave a receiver unable to know whether
  * silence about a redelivery is an answer or an absence.
  */
-export const callbackEnvelopeSchema = z.discriminatedUnion("version", [
+export const callbackEnvelopeSchema = /* @__PURE__ */ (() => z.discriminatedUnion("version", [
     z.object({
         ...callbackEnvelopeShape,
         /** Envelope version, dated and independent of the contract version. */
@@ -284,7 +284,7 @@ export const callbackEnvelopeSchema = z.discriminatedUnion("version", [
         trigger: callbackTriggerSchema,
         version: z.literal(CALLBACK_ENVELOPE_VERSION),
     }),
-]);
+]))();
 /**
  * What caused a delivery, for an envelope of any published version.
  *
@@ -436,20 +436,20 @@ export function extractCanonicalEnvelopeIds(rawBody) {
         ? { occurrenceId: occurrenceId.data, scheduleId: scheduleId.data }
         : undefined;
 }
-export const callbackHeadersSchema = z.object({
+export const callbackHeadersSchema = /* @__PURE__ */ (() => z.object({
     [CALLBACK_HEADERS.deliveryId]: deliveryIdSchema,
     [CALLBACK_HEADERS.keyId]: callbackSigningKeyIdSchema,
     [CALLBACK_HEADERS.occurrenceId]: occurrenceIdSchema,
     [CALLBACK_HEADERS.signature]: signatureHeaderSchema,
     [CALLBACK_HEADERS.timestamp]: timestampSchema,
-});
+}))();
 const VECTOR_PREFIX = "2026-07-28T15:00:00.000Z.dlv_0123456789abcdefghjkmnpqrs.";
 const CALLBACK_DELIVERY_VECTOR_BODY = '{"version":"2026-08-23","type":"schedule.occurrence","scheduleId":"sch_0123456789abcdefghjkmnpqrs","occurrenceId":"occ_0123456789abcdefghjkmnpqrs","plannedFor":"2026-07-28T15:00:00.000Z","attempt":1,"completion":{"token":"v2.example-claim-not-a-real-token.example-mac","url":"https://greatwait-scheduler.example/callbacks/completion","deadline":"2026-07-28T15:00:05.000Z"},"trigger":{"kind":"automatic"},"data":{}}';
-const CALLBACK_DELIVERY_VECTOR_INPUT = `${VECTOR_PREFIX}${CALLBACK_DELIVERY_VECTOR_BODY}`;
+const CALLBACK_DELIVERY_VECTOR_INPUT = /* @__PURE__ */ (() => `${VECTOR_PREFIX}${CALLBACK_DELIVERY_VECTOR_BODY}`)();
 const CALLBACK_DELIVERY_UNICODE_VECTOR_BODY = '{"version":"2026-08-23","type":"schedule.occurrence","scheduleId":"sch_0123456789abcdefghjkmnpqrs","occurrenceId":"occ_0123456789abcdefghjkmnpqrs","plannedFor":"2026-07-28T15:00:00.000Z","attempt":1,"completion":{"token":"v2.example-claim-not-a-real-token.example-mac","url":"https://greatwait-scheduler.example/callbacks/completion","deadline":"2026-07-28T15:00:05.000Z"},"trigger":{"kind":"automatic"},"data":{"note":"café ☃"}}';
-const CALLBACK_DELIVERY_UNICODE_VECTOR_INPUT = `${VECTOR_PREFIX}${CALLBACK_DELIVERY_UNICODE_VECTOR_BODY}`;
+const CALLBACK_DELIVERY_UNICODE_VECTOR_INPUT = /* @__PURE__ */ (() => `${VECTOR_PREFIX}${CALLBACK_DELIVERY_UNICODE_VECTOR_BODY}`)();
 const CALLBACK_DELIVERY_REDELIVERY_VECTOR_BODY = '{"version":"2026-08-23","type":"schedule.occurrence","scheduleId":"sch_0123456789abcdefghjkmnpqrs","occurrenceId":"occ_0123456789abcdefghjkmnpqrs","plannedFor":"2026-07-28T15:00:00.000Z","attempt":2,"completion":{"token":"v2.example-claim-not-a-real-token.example-mac","url":"https://greatwait-scheduler.example/callbacks/completion","deadline":"2026-07-28T15:00:05.000Z"},"trigger":{"kind":"redelivery","sourceAttemptId":"att_0123456789abcdefghjkmnpqrs"},"data":{}}';
-const CALLBACK_DELIVERY_REDELIVERY_VECTOR_INPUT = `${VECTOR_PREFIX}${CALLBACK_DELIVERY_REDELIVERY_VECTOR_BODY}`;
+const CALLBACK_DELIVERY_REDELIVERY_VECTOR_INPUT = /* @__PURE__ */ (() => `${VECTOR_PREFIX}${CALLBACK_DELIVERY_REDELIVERY_VECTOR_BODY}`)();
 /**
  * The `2026-08-08` body with no `completion`, byte for byte as published.
  *
@@ -461,9 +461,9 @@ const CALLBACK_DELIVERY_REDELIVERY_VECTOR_INPUT = `${VECTOR_PREFIX}${CALLBACK_DE
  * receiver mid-rollout is still being handed.
  */
 const CALLBACK_DELIVERY_TRIGGER_VECTOR_BODY = '{"version":"2026-08-08","type":"schedule.occurrence","scheduleId":"sch_0123456789abcdefghjkmnpqrs","occurrenceId":"occ_0123456789abcdefghjkmnpqrs","plannedFor":"2026-07-28T15:00:00.000Z","attempt":1,"trigger":{"kind":"automatic"},"data":{}}';
-const CALLBACK_DELIVERY_TRIGGER_VECTOR_INPUT = `${VECTOR_PREFIX}${CALLBACK_DELIVERY_TRIGGER_VECTOR_BODY}`;
+const CALLBACK_DELIVERY_TRIGGER_VECTOR_INPUT = /* @__PURE__ */ (() => `${VECTOR_PREFIX}${CALLBACK_DELIVERY_TRIGGER_VECTOR_BODY}`)();
 const CALLBACK_DELIVERY_COMPLETION_VECTOR_BODY = '{"version":"2026-08-08","type":"schedule.occurrence","scheduleId":"sch_0123456789abcdefghjkmnpqrs","occurrenceId":"occ_0123456789abcdefghjkmnpqrs","plannedFor":"2026-07-28T15:00:00.000Z","attempt":1,"completion":{"token":"v1.example-claim-not-a-real-token.example-mac","url":"https://greatwait-scheduler.example/callbacks/completion"},"trigger":{"kind":"automatic"},"data":{}}';
-const CALLBACK_DELIVERY_COMPLETION_VECTOR_INPUT = `${VECTOR_PREFIX}${CALLBACK_DELIVERY_COMPLETION_VECTOR_BODY}`;
+const CALLBACK_DELIVERY_COMPLETION_VECTOR_INPUT = /* @__PURE__ */ (() => `${VECTOR_PREFIX}${CALLBACK_DELIVERY_COMPLETION_VECTOR_BODY}`)();
 /**
  * The `2026-07-01` body, byte for byte as it was published, with the MAC it was
  * published with.
@@ -476,12 +476,12 @@ const CALLBACK_DELIVERY_COMPLETION_VECTOR_INPUT = `${VECTOR_PREFIX}${CALLBACK_DE
  * published verifier is wrong.
  */
 const CALLBACK_DELIVERY_LEGACY_VECTOR_BODY = '{"version":"2026-07-01","type":"schedule.occurrence","scheduleId":"sch_0123456789abcdefghjkmnpqrs","occurrenceId":"occ_0123456789abcdefghjkmnpqrs","plannedFor":"2026-07-28T15:00:00.000Z","attempt":1,"data":{}}';
-const CALLBACK_DELIVERY_LEGACY_VECTOR_INPUT = `${VECTOR_PREFIX}${CALLBACK_DELIVERY_LEGACY_VECTOR_BODY}`;
+const CALLBACK_DELIVERY_LEGACY_VECTOR_INPUT = /* @__PURE__ */ (() => `${VECTOR_PREFIX}${CALLBACK_DELIVERY_LEGACY_VECTOR_BODY}`)();
 /**
  * Language-neutral known-answer contract for one complete delivery request.
  * The secret is synthetic and deliberately not shaped like a credential.
  */
-export const CALLBACK_DELIVERY_PROTOCOL = {
+export const CALLBACK_DELIVERY_PROTOCOL = /* @__PURE__ */ (() => ({
     envelope: {
         /**
          * The frozen wire order, and `completion` sits inside it.
@@ -790,7 +790,7 @@ export const CALLBACK_DELIVERY_PROTOCOL = {
         signingInputUtf8: CALLBACK_DELIVERY_UNICODE_VECTOR_INPUT,
     },
     version: CALLBACK_DELIVERY_PROTOCOL_VERSION,
-};
+}))();
 /**
  * Every published vector, derived from the protocol rather than listed.
  *

package/dist/stored-http.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The headers a send carries: the endpoint's defaults with the schedule's own
+ * headers over them, matched case-insensitively, the later entry winning, and
+ * suppressed names removed — kept in the order they were written.
+ */
+export declare function mergeStoredHttpHeaders(defaults: readonly unknown[] | null | undefined, overrides: readonly unknown[] | null | undefined): unknown[];
+/**
+ * Whether stored headers fit their bounds: an array of at most 32, each name
+ * present, at most 128 bytes and distinct case-insensitively, and each value
+ * that is not suppressed at most 8,192 bytes, 16,384 bytes in all.
+ */
+export declare function validStoredHttpHeaders(headers: unknown): boolean;
+/**
+ * Whether a schedule's stored HTTP settings, sent through an endpoint with
+ * these default headers, are within bounds: the settings' own shape and
+ * headers, and the headers a send would carry after the merge.
+ */
+export declare function validScheduleHttp(request: unknown, endpointHeaders: readonly unknown[] | null | undefined): boolean;

package/dist/stored-http.js

@@ -0,0 +1,106 @@
+/**
+ * The stored custom-HTTP invariants, as pure functions (W9-73).
+ *
+ * Until W9-73 a schedule insert ran these inside PostgreSQL, in the
+ * `greatwait_schedule_http_bounds` trigger (migration 0050): a lock and read of
+ * the endpoint's default headers, `http_merge_headers_v1` and
+ * `http_validate_headers_v1`. They are the same rules here, over the same JSON,
+ * so the create can validate before it writes and spend no statement on it.
+ * Schedule edits keep the trigger; the endpoint's own trigger still guards an
+ * endpoint header change against every schedule using it.
+ */
+import { HTTP_HEADER_BOUNDS, HTTP_METHODS } from "./http-request.js";
+const encoder = new TextEncoder();
+const BODY_MODES = ["envelope", "json", "none"];
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+/** `value->>'suppressed' = 'true'`: the JSON `true`, or the string. */
+function suppressed(header) {
+    const flag = record(header)?.["suppressed"];
+    return flag === true || flag === "true";
+}
+function headerName(header) {
+    const name = record(header)?.["name"];
+    return typeof name === "string" ? name : undefined;
+}
+/**
+ * The headers a send carries: the endpoint's defaults with the schedule's own
+ * headers over them, matched case-insensitively, the later entry winning, and
+ * suppressed names removed — kept in the order they were written.
+ */
+export function mergeStoredHttpHeaders(defaults, overrides) {
+    // Positions as the SQL numbered them: defaults from 1, overrides from 101,
+    // so an override always outranks a default of the same name.
+    const winners = new Map();
+    const consider = (headers, offset) => {
+        headers.forEach((header, index) => {
+            const key = headerName(header)?.toLowerCase();
+            const position = offset + index + 1;
+            const prior = winners.get(key);
+            if (prior === undefined || position > prior[0])
+                winners.set(key, [position, header]);
+        });
+    };
+    consider(defaults ?? [], 0);
+    consider(overrides ?? [], 100);
+    return [...winners.values()]
+        .filter(([, header]) => !suppressed(header))
+        .sort(([left], [right]) => left - right)
+        .map(([, header]) => header);
+}
+/**
+ * Whether stored headers fit their bounds: an array of at most 32, each name
+ * present, at most 128 bytes and distinct case-insensitively, and each value
+ * that is not suppressed at most 8,192 bytes, 16,384 bytes in all.
+ */
+export function validStoredHttpHeaders(headers) {
+    if (!Array.isArray(headers) || headers.length > HTTP_HEADER_BOUNDS.count)
+        return false;
+    const names = new Set();
+    let total = 0;
+    for (const header of headers) {
+        const name = headerName(header);
+        if (name === undefined || name.length === 0)
+            return false;
+        const nameBytes = encoder.encode(name).byteLength;
+        if (nameBytes > HTTP_HEADER_BOUNDS.nameBytes)
+            return false;
+        if (names.has(name.toLowerCase()))
+            return false;
+        names.add(name.toLowerCase());
+        if (suppressed(header))
+            continue;
+        const size = record(header)?.["valueBytes"];
+        // The SQL read the number as text and required one to five digits.
+        if (typeof size !== "number" ||
+            !Number.isSafeInteger(size) ||
+            size < 0 ||
+            size > HTTP_HEADER_BOUNDS.valueBytes)
+            return false;
+        total += nameBytes + size;
+    }
+    return total <= HTTP_HEADER_BOUNDS.totalBytes;
+}
+/**
+ * Whether a schedule's stored HTTP settings, sent through an endpoint with
+ * these default headers, are within bounds: the settings' own shape and
+ * headers, and the headers a send would carry after the merge.
+ */
+export function validScheduleHttp(request, endpointHeaders) {
+    const settings = record(request);
+    if (request !== null && request !== undefined) {
+        const method = settings?.["method"];
+        const bodyMode = settings?.["bodyMode"];
+        if (settings === undefined ||
+            !HTTP_METHODS.includes(method) ||
+            !BODY_MODES.includes(bodyMode) ||
+            (method === "GET") !== (bodyMode === "none") ||
+            !validStoredHttpHeaders(settings["headers"]))
+            return false;
+    }
+    const overrides = settings?.["headers"];
+    return validStoredHttpHeaders(mergeStoredHttpHeaders(endpointHeaders, Array.isArray(overrides) ? overrides : undefined));
+}

package/dist/test-sink.d.ts

@@ -376,11 +376,11 @@ export declare function resolveTestSinkAction(program: TestSinkProgram, delivery
  */
 export declare const CALLBACK_RECEIVER_DISPOSITIONS: readonly ["body_too_large", "duplicate", "handler_failed", "in_flight", "invalid_envelope", "invalid_headers", "invalid_signature", "processed", "replay", "stale_timestamp"];
 export declare const callbackReceiverDispositionSchema: import("zod").ZodEnum<{
+    in_flight: "in_flight";
     duplicate: "duplicate";
     invalid_signature: "invalid_signature";
     body_too_large: "body_too_large";
     handler_failed: "handler_failed";
-    in_flight: "in_flight";
     invalid_envelope: "invalid_envelope";
     invalid_headers: "invalid_headers";
     processed: "processed";
@@ -400,11 +400,11 @@ export type CallbackReceiverDisposition = z.infer<typeof callbackReceiverDisposi
  */
 export declare const TEST_SINK_DISPOSITIONS: readonly ["body_too_large", "duplicate", "handler_failed", "in_flight", "invalid_envelope", "invalid_headers", "invalid_signature", "processed", "replay", "stale_timestamp", "connection_dropped"];
 export declare const testSinkDispositionSchema: import("zod").ZodEnum<{
+    in_flight: "in_flight";
     duplicate: "duplicate";
     invalid_signature: "invalid_signature";
     body_too_large: "body_too_large";
     handler_failed: "handler_failed";
-    in_flight: "in_flight";
     invalid_envelope: "invalid_envelope";
     invalid_headers: "invalid_headers";
     processed: "processed";
@@ -464,11 +464,11 @@ export declare const CALLBACK_RECEIVER_STATUS: {
  */
 export declare const callbackReceiverAcknowledgementSchema: import("zod").ZodObject<{
     disposition: import("zod").ZodEnum<{
+        in_flight: "in_flight";
         duplicate: "duplicate";
         invalid_signature: "invalid_signature";
         body_too_large: "body_too_large";
         handler_failed: "handler_failed";
-        in_flight: "in_flight";
         invalid_envelope: "invalid_envelope";
         invalid_headers: "invalid_headers";
         processed: "processed";
@@ -642,11 +642,11 @@ export declare const testSinkDeliverySchema: import("zod").ZodObject<{
         timeout: "timeout";
     }>;
     disposition: import("zod").ZodEnum<{
+        in_flight: "in_flight";
         duplicate: "duplicate";
         invalid_signature: "invalid_signature";
         body_too_large: "body_too_large";
         handler_failed: "handler_failed";
-        in_flight: "in_flight";
         invalid_envelope: "invalid_envelope";
         invalid_headers: "invalid_headers";
         processed: "processed";
@@ -681,11 +681,11 @@ export declare const testSinkDeliveryPageSchema: import("zod").ZodObject<{
             timeout: "timeout";
         }>;
         disposition: import("zod").ZodEnum<{
+            in_flight: "in_flight";
             duplicate: "duplicate";
             invalid_signature: "invalid_signature";
             body_too_large: "body_too_large";
             handler_failed: "handler_failed";
-            in_flight: "in_flight";
             invalid_envelope: "invalid_envelope";
             invalid_headers: "invalid_headers";
             processed: "processed";
@@ -747,11 +747,11 @@ export declare const testSinkDeliveryBodySchema: import("zod").ZodObject<{
         timeout: "timeout";
     }>;
     disposition: import("zod").ZodEnum<{
+        in_flight: "in_flight";
         duplicate: "duplicate";
         invalid_signature: "invalid_signature";
         body_too_large: "body_too_large";
         handler_failed: "handler_failed";
-        in_flight: "in_flight";
         invalid_envelope: "invalid_envelope";
         invalid_headers: "invalid_headers";
         processed: "processed";

package/dist/time.js

@@ -16,7 +16,7 @@ import { z } from "./zod.js";
  * into the instant.
  */
 const RFC3339_UTC_MS = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/u;
-export const timestampSchema = z
+export const timestampSchema = /* @__PURE__ */ (() => z
     .string()
     .regex(RFC3339_UTC_MS, "must be an RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-07-28T15:00:00.000Z")
     // A regex alone is not enough: JavaScript happily "parses" 2026-02-31 and
@@ -28,8 +28,8 @@ export const timestampSchema = z
     const parsed = new Date(value);
     // Guarded because checks still run after the pattern fails, and
     // `toISOString` throws rather than returning NaN on an invalid Date.
-    return !Number.isNaN(parsed.getTime()) && parsed.toISOString() === value;
-}, { message: "must be a real instant on the calendar" });
+    return (!Number.isNaN(parsed.getTime()) && parsed.toISOString() === value);
+}, { message: "must be a real instant on the calendar" }))();
 /** Formats an instant in the one representation the wire accepts. */
 export function toTimestamp(instant) {
     if (Number.isNaN(instant.getTime())) {
@@ -41,10 +41,10 @@ export function toTimestamp(instant) {
  * Durations are whole seconds, never strings. Bounds belong to the resource
  * that uses them; this only fixes the representation.
  */
-export const durationSecondsSchema = z
+export const durationSecondsSchema = /* @__PURE__ */ (() => z
     .number()
     .int("must be a whole number of seconds")
-    .nonnegative("must not be negative");
+    .nonnegative("must not be negative"))();
 let canonicalZones;
 /**
  * The zone identifiers this runtime recognizes, plus `UTC`.
@@ -95,7 +95,7 @@ export function toTimeZone(value) {
     return new Intl.DateTimeFormat("en", { timeZone: value }).resolvedOptions()
         .timeZone;
 }
-export const timeZoneSchema = z
+export const timeZoneSchema = /* @__PURE__ */ (() => z
     .string()
     .min(1)
     .refine((value) => {
@@ -125,4 +125,4 @@ export const timeZoneSchema = z
     // spelling would bump the optimistic version and write a spurious audit
     // diff. Deciding this now is free; after W2 persists the first raw string it
     // is a breaking response change plus a data migration.
-    .transform(toTimeZone);
+    .transform(toTimeZone))();

package/dist/usage.d.ts

@@ -73,8 +73,8 @@ export declare const USAGE_BOUNDS: {
 export declare const BILLABLE_TERMINAL_STATES: readonly ["cancelled", "skipped_stale", "succeeded", "terminal_failed"];
 export declare const billableTerminalStateSchema: import("zod").ZodEnum<{
     succeeded: "succeeded";
-    cancelled: "cancelled";
     terminal_failed: "terminal_failed";
+    cancelled: "cancelled";
     skipped_stale: "skipped_stale";
 }>;
 export type BillableTerminalStateName = z.infer<typeof billableTerminalStateSchema>;
@@ -107,8 +107,8 @@ export declare const usageDaySchema: import("zod").ZodObject<{
     billableOccurrences: import("zod").ZodNumber;
     byTerminalState: import("zod").ZodRecord<import("zod").ZodEnum<{
         succeeded: "succeeded";
-        cancelled: "cancelled";
         terminal_failed: "terminal_failed";
+        cancelled: "cancelled";
         skipped_stale: "skipped_stale";
     }> & import("zod/v4/core").$partial, import("zod").ZodNumber>;
     start: import("zod").ZodString;
@@ -120,8 +120,8 @@ export declare const usageSchema: import("zod").ZodObject<{
         billableOccurrences: import("zod").ZodNumber;
         byTerminalState: import("zod").ZodRecord<import("zod").ZodEnum<{
             succeeded: "succeeded";
-            cancelled: "cancelled";
             terminal_failed: "terminal_failed";
+            cancelled: "cancelled";
             skipped_stale: "skipped_stale";
         }> & import("zod/v4/core").$partial, import("zod").ZodNumber>;
         start: import("zod").ZodString;

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

@@ -0,0 +1,42 @@
+{
+  "data": [
+    {
+      "attempt": {
+        "id": "att_01h8xyz9k2m4n6p8r0t2v4w6y8",
+        "attemptNumber": 1,
+        "occurrence": "occ_01h8xyz9k2m4n6p8r0t2v4w6y8",
+        "startedAt": "2026-07-28T15:00:00.000Z",
+        "state": "retryable_failure",
+        "classifiedAt": "2026-07-28T15:00:00.071Z",
+        "durationMs": 71,
+        "responseStatus": 503,
+        "diagnostic": "http_retryable",
+        "remediation": "review_retry_policy",
+        "trigger": {
+          "kind": "automatic"
+        }
+      },
+      "occurrence": {
+        "attemptCount": 2,
+        "generation": 1,
+        "id": "occ_01h8xyz9k2m4n6p8r0t2v4w6y8",
+        "plannedFor": "2026-07-28T14:50:00.000Z",
+        "schedule": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
+        "sequence": 1,
+        "settledAt": "2026-07-28T15:00:04.000Z",
+        "state": "succeeded"
+      },
+      "schedule": {
+        "id": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
+        "name": "Recovered delivery"
+      }
+    }
+  ],
+  "freshness": {
+    "kind": "authoritative"
+  },
+  "retention": {
+    "from": "2026-07-21T15:00:00.000Z",
+    "detailsFrom": "2026-07-21T15:00:00.000Z"
+  }
+}

package/generated/v1/examples/bulk.cancel.request.json

@@ -0,0 +1,3 @@
+{
+  "expectedVersion": 1
+}

package/generated/v1/examples/bulk.cancel.response.json

@@ -0,0 +1,59 @@
+{
+  "id": "bjo_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "authority": {
+    "environment": "env_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "environmentKind": "test",
+    "organization": "org_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8"
+  },
+  "intent": {
+    "target": "schedules",
+    "selection": {
+      "kind": "all_matching",
+      "resource": "schedules",
+      "filter": {
+        "tag": "reminders"
+      }
+    },
+    "operation": "pause",
+    "parameters": {}
+  },
+  "state": "cancelled",
+  "version": 1,
+  "createdAt": "2035-06-01T00:00:00.000Z",
+  "updatedAt": "2035-06-01T00:00:00.000Z",
+  "referenceAt": "2035-06-01T00:00:00.000Z",
+  "preparationExpiresAt": "2035-06-08T00:00:00.000Z",
+  "previewExpiresAt": "2035-06-01T00:05:00.000Z",
+  "intentDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+  "complete": true,
+  "counts": {
+    "matched": 0,
+    "eligible": 0,
+    "ineligible": 0,
+    "pending": 0,
+    "running": 0,
+    "succeeded": 0,
+    "noOp": 0,
+    "skipped": 0,
+    "conflicted": 0,
+    "failed": 0,
+    "cancelled": 0
+  },
+  "reasons": [],
+  "warnings": [],
+  "samples": [],
+  "limits": {
+    "maxTargets": 100000,
+    "executionLifetimeSeconds": 604800,
+    "previewLifetimeSeconds": 300,
+    "resultRetentionSeconds": 1209600,
+    "batchSize": 25,
+    "workerConcurrency": 1
+  },
+  "billing": {
+    "additionalAttemptsMinimum": 0,
+    "exactChargeKnown": false,
+    "note": "Ordinary per-attempt billing and quota admission apply; preview creates no delivery or charge."
+  }
+}

package/generated/v1/examples/bulk.confirm.request.json

@@ -0,0 +1,5 @@
+{
+  "intentDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+  "confirmed": true,
+  "acknowledgeDuplicateEffects": false
+}

package/generated/v1/examples/bulk.confirm.response.json

@@ -0,0 +1,59 @@
+{
+  "id": "bjo_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "authority": {
+    "environment": "env_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "environmentKind": "test",
+    "organization": "org_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8"
+  },
+  "intent": {
+    "target": "schedules",
+    "selection": {
+      "kind": "all_matching",
+      "resource": "schedules",
+      "filter": {
+        "tag": "reminders"
+      }
+    },
+    "operation": "pause",
+    "parameters": {}
+  },
+  "state": "queued",
+  "version": 1,
+  "createdAt": "2035-06-01T00:00:00.000Z",
+  "updatedAt": "2035-06-01T00:00:00.000Z",
+  "referenceAt": "2035-06-01T00:00:00.000Z",
+  "preparationExpiresAt": "2035-06-08T00:00:00.000Z",
+  "previewExpiresAt": "2035-06-01T00:05:00.000Z",
+  "intentDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+  "complete": true,
+  "counts": {
+    "matched": 0,
+    "eligible": 0,
+    "ineligible": 0,
+    "pending": 0,
+    "running": 0,
+    "succeeded": 0,
+    "noOp": 0,
+    "skipped": 0,
+    "conflicted": 0,
+    "failed": 0,
+    "cancelled": 0
+  },
+  "reasons": [],
+  "warnings": [],
+  "samples": [],
+  "limits": {
+    "maxTargets": 100000,
+    "executionLifetimeSeconds": 604800,
+    "previewLifetimeSeconds": 300,
+    "resultRetentionSeconds": 1209600,
+    "batchSize": 25,
+    "workerConcurrency": 1
+  },
+  "billing": {
+    "additionalAttemptsMinimum": 0,
+    "exactChargeKnown": false,
+    "note": "Ordinary per-attempt billing and quota admission apply; preview creates no delivery or charge."
+  }
+}

package/generated/v1/examples/bulk.items.response.json

@@ -0,0 +1,3 @@
+{
+  "data": []
+}