@greatwait/contracts 0.2.2 → 0.3.0

package/dist/scheduling.d.ts

@@ -1,3 +1,4 @@
+import { type OccurrenceState } from "./occurrence-states.js";
 import { z } from "./zod.js";
 import { type CursorBinding } from "./protocol.js";
 import type { FieldError } from "./problems.js";
@@ -36,9 +37,9 @@ import { type CallbackTrigger, type ResponseClass } from "./signatures.js";
  */
 export declare const SCHEDULE_STATUSES: readonly ["active", "paused", "cancelled", "completed"];
 export declare const scheduleStatusSchema: import("zod").ZodEnum<{
-    paused: "paused";
-    active: "active";
     cancelled: "cancelled";
+    active: "active";
+    paused: "paused";
     completed: "completed";
 }>;
 export type ScheduleStatus = z.infer<typeof scheduleStatusSchema>;
@@ -346,19 +347,7 @@ export type PartitionKey = z.infer<typeof partitionKeySchema>;
  * not `cancelled`: a customer who cancelled something and a customer whose
  * occurrence went stale need different explanations.
  */
-export declare const OCCURRENCE_STATES: readonly ["planned", "due", "dispatching", "retry_wait", "ambiguous", "succeeded", "terminal_failed", "cancelled", "skipped_stale"];
-export declare const occurrenceStateSchema: import("zod").ZodEnum<{
-    succeeded: "succeeded";
-    ambiguous: "ambiguous";
-    due: "due";
-    cancelled: "cancelled";
-    planned: "planned";
-    dispatching: "dispatching";
-    retry_wait: "retry_wait";
-    terminal_failed: "terminal_failed";
-    skipped_stale: "skipped_stale";
-}>;
-export type OccurrenceState = z.infer<typeof occurrenceStateSchema>;
+export { OCCURRENCE_STATES, occurrenceStateSchema, type OccurrenceState, } from "./occurrence-states.js";
 /**
  * One project-wide walk over retained occurrences, newest first.
  *
@@ -370,23 +359,35 @@ export type OccurrenceState = z.infer<typeof occurrenceStateSchema>;
 export declare const projectOccurrenceListRequestSchema: import("zod").ZodObject<{
     cursor: import("zod").ZodOptional<import("zod").ZodString>;
     limit: import("zod").ZodDefault<import("zod").ZodNumber>;
-    endpoint: import("zod").ZodOptional<import("zod").ZodString>;
+    endpoint: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodLiteral<"none">]>>;
+    schedule: import("zod").ZodOptional<import("zod").ZodString>;
     external_identifier: import("zod").ZodOptional<import("zod").ZodString>;
     tag: import("zod").ZodOptional<import("zod").ZodString>;
+    status: import("zod").ZodOptional<import("zod").ZodEnum<{
+        cancelled: "cancelled";
+        active: "active";
+        paused: "paused";
+        completed: "completed";
+    }>>;
+    recurrence: import("zod").ZodOptional<import("zod").ZodEnum<{
+        at: "at";
+        every: "every";
+        cron: "cron";
+    }>>;
+    text: import("zod").ZodOptional<import("zod").ZodString>;
     from: import("zod").ZodOptional<import("zod").ZodString>;
+    to: import("zod").ZodOptional<import("zod").ZodString>;
     outcome: import("zod").ZodOptional<import("zod").ZodEnum<{
-        succeeded: "succeeded";
-        ambiguous: "ambiguous";
-        due: "due";
-        cancelled: "cancelled";
         planned: "planned";
+        due: "due";
         dispatching: "dispatching";
         retry_wait: "retry_wait";
+        ambiguous: "ambiguous";
+        succeeded: "succeeded";
         terminal_failed: "terminal_failed";
+        cancelled: "cancelled";
         skipped_stale: "skipped_stale";
     }>>;
-    schedule: import("zod").ZodOptional<import("zod").ZodString>;
-    to: import("zod").ZodOptional<import("zod").ZodString>;
 }, import("zod/v4/core").$strip>;
 export type ProjectOccurrenceListRequest = z.infer<typeof projectOccurrenceListRequestSchema>;
 export type ProjectOccurrenceListRequestParse = {
@@ -427,8 +428,8 @@ export declare function isTerminalOccurrenceState(state: OccurrenceState): boole
  */
 export declare const ATTEMPT_STATES: readonly ["succeeded", "retryable_failure", "terminal_failure", "ambiguous"];
 export declare const attemptStateSchema: import("zod").ZodEnum<{
-    succeeded: "succeeded";
     ambiguous: "ambiguous";
+    succeeded: "succeeded";
     retryable_failure: "retryable_failure";
     terminal_failure: "terminal_failure";
 }>;
@@ -803,9 +804,9 @@ export declare const scheduleSchema: import("zod").ZodObject<{
         timeZone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
     }, import("zod/v4/core").$strip>], "kind">;
     status: import("zod").ZodEnum<{
-        paused: "paused";
-        active: "active";
         cancelled: "cancelled";
+        active: "active";
+        paused: "paused";
         completed: "completed";
     }>;
     updatedAt: import("zod").ZodString;
@@ -905,9 +906,9 @@ export declare const schedulePageSchema: import("zod").ZodObject<{
             timeZone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
         }, import("zod/v4/core").$strip>], "kind">;
         status: import("zod").ZodEnum<{
-            paused: "paused";
-            active: "active";
             cancelled: "cancelled";
+            active: "active";
+            paused: "paused";
             completed: "completed";
         }>;
         updatedAt: import("zod").ZodString;
@@ -939,14 +940,14 @@ export declare const occurrenceSchema: import("zod").ZodObject<{
     sequence: import("zod").ZodNumber;
     settledAt: import("zod").ZodOptional<import("zod").ZodString>;
     state: import("zod").ZodEnum<{
-        succeeded: "succeeded";
-        ambiguous: "ambiguous";
-        due: "due";
-        cancelled: "cancelled";
         planned: "planned";
+        due: "due";
         dispatching: "dispatching";
         retry_wait: "retry_wait";
+        ambiguous: "ambiguous";
+        succeeded: "succeeded";
         terminal_failed: "terminal_failed";
+        cancelled: "cancelled";
         skipped_stale: "skipped_stale";
     }>;
     firstAttemptLatenessMs: import("zod").ZodOptional<import("zod").ZodInt>;
@@ -1013,8 +1014,8 @@ export type AttemptFailureSnippet = z.infer<typeof attemptFailureSnippetSchema>;
 export declare const attemptCapturedBodySchema: import("zod").ZodObject<{
     contentType: import("zod").ZodString;
     encoding: import("zod").ZodEnum<{
-        utf8: "utf8";
         base64: "base64";
+        utf8: "utf8";
     }>;
     content: import("zod").ZodString;
     capturedBytes: import("zod").ZodInt;
@@ -1038,8 +1039,8 @@ export declare const attemptResponseSchema: import("zod").ZodObject<{
     body: import("zod").ZodOptional<import("zod").ZodObject<{
         contentType: import("zod").ZodString;
         encoding: import("zod").ZodEnum<{
-            utf8: "utf8";
             base64: "base64";
+            utf8: "utf8";
         }>;
         content: import("zod").ZodString;
         capturedBytes: import("zod").ZodInt;
@@ -1098,8 +1099,8 @@ export declare const attemptSchema: import("zod").ZodObject<{
         body: import("zod").ZodOptional<import("zod").ZodObject<{
             contentType: import("zod").ZodString;
             encoding: import("zod").ZodEnum<{
-                utf8: "utf8";
                 base64: "base64";
+                utf8: "utf8";
             }>;
             content: import("zod").ZodString;
             capturedBytes: import("zod").ZodInt;
@@ -1134,8 +1135,8 @@ export declare const attemptSchema: import("zod").ZodObject<{
     responseStatus: import("zod").ZodOptional<import("zod").ZodNumber>;
     startedAt: import("zod").ZodString;
     state: import("zod").ZodOptional<import("zod").ZodEnum<{
-        succeeded: "succeeded";
         ambiguous: "ambiguous";
+        succeeded: "succeeded";
         retryable_failure: "retryable_failure";
         terminal_failure: "terminal_failure";
     }>>;
@@ -1185,14 +1186,14 @@ export declare const occurrencePageSchema: import("zod").ZodObject<{
         sequence: import("zod").ZodNumber;
         settledAt: import("zod").ZodOptional<import("zod").ZodString>;
         state: import("zod").ZodEnum<{
-            succeeded: "succeeded";
-            ambiguous: "ambiguous";
-            due: "due";
-            cancelled: "cancelled";
             planned: "planned";
+            due: "due";
             dispatching: "dispatching";
             retry_wait: "retry_wait";
+            ambiguous: "ambiguous";
+            succeeded: "succeeded";
             terminal_failed: "terminal_failed";
+            cancelled: "cancelled";
             skipped_stale: "skipped_stale";
         }>;
         firstAttemptLatenessMs: import("zod").ZodOptional<import("zod").ZodInt>;
@@ -1222,14 +1223,14 @@ export declare const projectOccurrencePageSchema: import("zod").ZodObject<{
         sequence: import("zod").ZodNumber;
         settledAt: import("zod").ZodOptional<import("zod").ZodString>;
         state: import("zod").ZodEnum<{
-            succeeded: "succeeded";
-            ambiguous: "ambiguous";
-            due: "due";
-            cancelled: "cancelled";
             planned: "planned";
+            due: "due";
             dispatching: "dispatching";
             retry_wait: "retry_wait";
+            ambiguous: "ambiguous";
+            succeeded: "succeeded";
             terminal_failed: "terminal_failed";
+            cancelled: "cancelled";
             skipped_stale: "skipped_stale";
         }>;
         firstAttemptLatenessMs: import("zod").ZodOptional<import("zod").ZodInt>;
@@ -1265,14 +1266,14 @@ export declare const occurrenceViewSchema: import("zod").ZodObject<{
         sequence: import("zod").ZodNumber;
         settledAt: import("zod").ZodOptional<import("zod").ZodString>;
         state: import("zod").ZodEnum<{
-            succeeded: "succeeded";
-            ambiguous: "ambiguous";
-            due: "due";
-            cancelled: "cancelled";
             planned: "planned";
+            due: "due";
             dispatching: "dispatching";
             retry_wait: "retry_wait";
+            ambiguous: "ambiguous";
+            succeeded: "succeeded";
             terminal_failed: "terminal_failed";
+            cancelled: "cancelled";
             skipped_stale: "skipped_stale";
         }>;
         firstAttemptLatenessMs: import("zod").ZodOptional<import("zod").ZodInt>;
@@ -1324,8 +1325,8 @@ export declare const attemptPageSchema: import("zod").ZodObject<{
             body: import("zod").ZodOptional<import("zod").ZodObject<{
                 contentType: import("zod").ZodString;
                 encoding: import("zod").ZodEnum<{
-                    utf8: "utf8";
                     base64: "base64";
+                    utf8: "utf8";
                 }>;
                 content: import("zod").ZodString;
                 capturedBytes: import("zod").ZodInt;
@@ -1360,8 +1361,8 @@ export declare const attemptPageSchema: import("zod").ZodObject<{
         responseStatus: import("zod").ZodOptional<import("zod").ZodNumber>;
         startedAt: import("zod").ZodString;
         state: import("zod").ZodOptional<import("zod").ZodEnum<{
-            succeeded: "succeeded";
             ambiguous: "ambiguous";
+            succeeded: "succeeded";
             retryable_failure: "retryable_failure";
             terminal_failure: "terminal_failure";
         }>>;
@@ -1442,8 +1443,8 @@ export declare const attemptViewSchema: import("zod").ZodObject<{
             body: import("zod").ZodOptional<import("zod").ZodObject<{
                 contentType: import("zod").ZodString;
                 encoding: import("zod").ZodEnum<{
-                    utf8: "utf8";
                     base64: "base64";
+                    utf8: "utf8";
                 }>;
                 content: import("zod").ZodString;
                 capturedBytes: import("zod").ZodInt;
@@ -1478,8 +1479,8 @@ export declare const attemptViewSchema: import("zod").ZodObject<{
         responseStatus: import("zod").ZodOptional<import("zod").ZodNumber>;
         startedAt: import("zod").ZodString;
         state: import("zod").ZodOptional<import("zod").ZodEnum<{
-            succeeded: "succeeded";
             ambiguous: "ambiguous";
+            succeeded: "succeeded";
             retryable_failure: "retryable_failure";
             terminal_failure: "terminal_failure";
         }>>;
@@ -1540,14 +1541,14 @@ export declare const scheduleViewSchema: import("zod").ZodObject<{
         sequence: import("zod").ZodNumber;
         settledAt: import("zod").ZodOptional<import("zod").ZodString>;
         state: import("zod").ZodEnum<{
-            succeeded: "succeeded";
-            ambiguous: "ambiguous";
-            due: "due";
-            cancelled: "cancelled";
             planned: "planned";
+            due: "due";
             dispatching: "dispatching";
             retry_wait: "retry_wait";
+            ambiguous: "ambiguous";
+            succeeded: "succeeded";
             terminal_failed: "terminal_failed";
+            cancelled: "cancelled";
             skipped_stale: "skipped_stale";
         }>;
         firstAttemptLatenessMs: import("zod").ZodOptional<import("zod").ZodInt>;
@@ -1643,9 +1644,9 @@ export declare const scheduleViewSchema: import("zod").ZodObject<{
             timeZone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
         }, import("zod/v4/core").$strip>], "kind">;
         status: import("zod").ZodEnum<{
-            paused: "paused";
-            active: "active";
             cancelled: "cancelled";
+            active: "active";
+            paused: "paused";
             completed: "completed";
         }>;
         updatedAt: import("zod").ZodString;
@@ -1668,14 +1669,14 @@ export declare const scheduleWrittenViewSchema: import("zod").ZodObject<{
         sequence: import("zod").ZodNumber;
         settledAt: import("zod").ZodOptional<import("zod").ZodString>;
         state: import("zod").ZodEnum<{
-            succeeded: "succeeded";
-            ambiguous: "ambiguous";
-            due: "due";
-            cancelled: "cancelled";
             planned: "planned";
+            due: "due";
             dispatching: "dispatching";
             retry_wait: "retry_wait";
+            ambiguous: "ambiguous";
+            succeeded: "succeeded";
             terminal_failed: "terminal_failed";
+            cancelled: "cancelled";
             skipped_stale: "skipped_stale";
         }>;
         firstAttemptLatenessMs: import("zod").ZodOptional<import("zod").ZodInt>;
@@ -1771,9 +1772,9 @@ export declare const scheduleWrittenViewSchema: import("zod").ZodObject<{
             timeZone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
         }, import("zod/v4/core").$strip>], "kind">;
         status: import("zod").ZodEnum<{
-            paused: "paused";
-            active: "active";
             cancelled: "cancelled";
+            active: "active";
+            paused: "paused";
             completed: "completed";
         }>;
         updatedAt: import("zod").ZodString;

package/dist/scheduling.js

@@ -1,7 +1,9 @@
+import { occurrenceStateSchema, } from "./occurrence-states.js";
+import { executionSelectionSchema, normalizeExecutionSelection, } from "./execution-selection.js";
 import { httpRequestSchema, publicHttpRequestSchema } from "./http-request.js";
 import { FIXED_INTERVAL_MIN_SECONDS, FIXED_INTERVAL_MAX_SECONDS, MAX_INLINE_PAYLOAD_BYTES, } from "./configuration-bounds.js";
 import { z } from "./zod.js";
-import { externalIdentifierSchema, scheduleTagSchema, scheduleTagsSchema, } from "./host-correlation.js";
+import { externalIdentifierSchema, scheduleTagsSchema, } from "./host-correlation.js";
 import { attemptIdSchema, deliveryIdSchema, endpointIdSchema, occurrenceIdSchema, scheduleIdSchema, } from "./identifiers.js";
 import { CALLBACK_ATTEMPT_DIAGNOSTICS } from "./delivery.js";
 import { callbackUrlSchema, signingSecretNoticeSchema } from "./endpoints.js";
@@ -358,18 +360,7 @@ export const partitionKeySchema = z
  * not `cancelled`: a customer who cancelled something and a customer whose
  * occurrence went stale need different explanations.
  */
-export const OCCURRENCE_STATES = [
-    "planned",
-    "due",
-    "dispatching",
-    "retry_wait",
-    "ambiguous",
-    "succeeded",
-    "terminal_failed",
-    "cancelled",
-    "skipped_stale",
-];
-export const occurrenceStateSchema = z.enum(OCCURRENCE_STATES);
+export { OCCURRENCE_STATES, occurrenceStateSchema, } from "./occurrence-states.js";
 /**
  * One project-wide walk over retained occurrences, newest first.
  *
@@ -379,25 +370,17 @@ export const occurrenceStateSchema = z.enum(OCCURRENCE_STATES);
  * this contract, so adjacent requests neither overlap nor leave a gap.
  */
 export const projectOccurrenceListRequestSchema = pageRequestSchema
-    .extend({
-    endpoint: endpointIdSchema.optional(),
-    external_identifier: externalIdentifierSchema.optional(),
-    tag: scheduleTagSchema.optional(),
-    from: timestampSchema.optional(),
-    outcome: occurrenceStateSchema.optional(),
-    schedule: scheduleIdSchema.optional(),
-    to: timestampSchema.optional(),
-})
+    .extend(executionSelectionSchema.shape)
     .refine((request) => request.from === undefined ||
     request.to === undefined ||
-    Date.parse(request.from) < Date.parse(request.to), {
-    message: "must be later than from",
-    path: ["to"],
-});
+    Date.parse(request.from) < Date.parse(request.to), { message: "must be later than from", path: ["to"] });
 const PROJECT_OCCURRENCE_LIST_PARAMETERS = [
     "cursor",
     "limit",
     "endpoint",
+    "status",
+    "recurrence",
+    "text",
     "external_identifier",
     "tag",
     "from",
@@ -448,17 +431,7 @@ export function parseProjectOccurrenceListRequest(query) {
 export function projectOccurrenceCursorBinding(request) {
     return {
         operation: "executions.list",
-        parameters: {
-            ...(request.endpoint === undefined ? {} : { endpoint: request.endpoint }),
-            ...(request.external_identifier === undefined
-                ? {}
-                : { external_identifier: request.external_identifier }),
-            ...(request.tag === undefined ? {} : { tag: request.tag }),
-            ...(request.from === undefined ? {} : { from: request.from }),
-            ...(request.outcome === undefined ? {} : { outcome: request.outcome }),
-            ...(request.schedule === undefined ? {} : { schedule: request.schedule }),
-            ...(request.to === undefined ? {} : { to: request.to }),
-        },
+        parameters: { ...normalizeExecutionSelection(request) },
     };
 }
 /**

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/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
+}