@greatwait/contracts 0.1.0-alpha.3 → 0.1.0-alpha.4

package/dist/workspace.d.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from "./zod.js";
 /**
  * Repository scaffold contracts.
  *
@@ -8,7 +8,7 @@ import { z } from "zod";
  * defined by W0-02 and does not belong here.
  */
 export declare const WORKSPACE_LAYERS: readonly ["contract", "platform", "domain", "application", "adapter", "test-support"];
-export declare const workspaceLayerSchema: z.ZodEnum<{
+export declare const workspaceLayerSchema: import("zod").ZodEnum<{
     contract: "contract";
     platform: "platform";
     domain: "domain";
@@ -17,8 +17,8 @@ export declare const workspaceLayerSchema: z.ZodEnum<{
     "test-support": "test-support";
 }>;
 export type WorkspaceLayer = z.infer<typeof workspaceLayerSchema>;
-export declare const workspaceIdentitySchema: z.ZodObject<{
-    layer: z.ZodEnum<{
+export declare const workspaceIdentitySchema: import("zod").ZodObject<{
+    layer: import("zod").ZodEnum<{
         contract: "contract";
         platform: "platform";
         domain: "domain";
@@ -26,19 +26,19 @@ export declare const workspaceIdentitySchema: z.ZodObject<{
         adapter: "adapter";
         "test-support": "test-support";
     }>;
-    workspace: z.ZodString;
-}, z.core.$strip>;
+    workspace: import("zod").ZodString;
+}, import("zod/v4/core").$strip>;
 export type WorkspaceIdentity = z.infer<typeof workspaceIdentitySchema>;
 /** Shape of `GET /__greatwait/version` on every Greatwait Worker. */
-export declare const scaffoldVersionSchema: z.ZodObject<{
-    buildSha: z.ZodString;
-    environment: z.ZodString;
-    service: z.ZodString;
-}, z.core.$strip>;
+export declare const scaffoldVersionSchema: import("zod").ZodObject<{
+    buildSha: import("zod").ZodString;
+    environment: import("zod").ZodString;
+    service: import("zod").ZodString;
+}, import("zod/v4/core").$strip>;
 export type ScaffoldVersion = z.infer<typeof scaffoldVersionSchema>;
 /** Shape of the scaffold description an adapter reads from the application. */
-export declare const workspaceScaffoldSchema: z.ZodObject<{
-    dependsOn: z.ZodArray<z.ZodEnum<{
+export declare const workspaceScaffoldSchema: import("zod").ZodObject<{
+    dependsOn: import("zod").ZodArray<import("zod").ZodEnum<{
         contract: "contract";
         platform: "platform";
         domain: "domain";
@@ -46,7 +46,7 @@ export declare const workspaceScaffoldSchema: z.ZodObject<{
         adapter: "adapter";
         "test-support": "test-support";
     }>>;
-    layer: z.ZodEnum<{
+    layer: import("zod").ZodEnum<{
         contract: "contract";
         platform: "platform";
         domain: "domain";
@@ -54,8 +54,8 @@ export declare const workspaceScaffoldSchema: z.ZodObject<{
         adapter: "adapter";
         "test-support": "test-support";
     }>;
-    service: z.ZodString;
-}, z.core.$strip>;
+    service: import("zod").ZodString;
+}, import("zod/v4/core").$strip>;
 export type WorkspaceScaffold = z.infer<typeof workspaceScaffoldSchema>;
 /**
  * The minimal refusal body the scaffold routes return.
@@ -65,28 +65,28 @@ export type WorkspaceScaffold = z.infer<typeof workspaceScaffoldSchema>;
  * real problem document when W1-06 replaces the scaffold with the REST
  * control plane. New code uses `problem()`.
  */
-export declare const scaffoldProblemSchema: z.ZodObject<{
-    title: z.ZodString;
-    type: z.ZodLiteral<"about:blank">;
-}, z.core.$strip>;
+export declare const scaffoldProblemSchema: import("zod").ZodObject<{
+    title: import("zod").ZodString;
+    type: import("zod").ZodLiteral<"about:blank">;
+}, import("zod/v4/core").$strip>;
 export type ScaffoldProblem = z.infer<typeof scaffoldProblemSchema>;
 /**
  * A transport-neutral tool descriptor. REST and MCP publish the same shape, so
  * the two surfaces cannot drift into describing tools differently.
  */
-export declare const toolDescriptorSchema: z.ZodObject<{
-    description: z.ZodString;
-    name: z.ZodString;
-    readOnly: z.ZodBoolean;
-    title: z.ZodString;
-}, z.core.$strip>;
+export declare const toolDescriptorSchema: import("zod").ZodObject<{
+    description: import("zod").ZodString;
+    name: import("zod").ZodString;
+    readOnly: import("zod").ZodBoolean;
+    title: import("zod").ZodString;
+}, import("zod/v4/core").$strip>;
 export type ToolDescriptor = z.infer<typeof toolDescriptorSchema>;
-export declare const toolListSchema: z.ZodObject<{
-    tools: z.ZodArray<z.ZodObject<{
-        description: z.ZodString;
-        name: z.ZodString;
-        readOnly: z.ZodBoolean;
-        title: z.ZodString;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+export declare const toolListSchema: import("zod").ZodObject<{
+    tools: import("zod").ZodArray<import("zod").ZodObject<{
+        description: import("zod").ZodString;
+        name: import("zod").ZodString;
+        readOnly: import("zod").ZodBoolean;
+        title: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>;
 export type ToolList = z.infer<typeof toolListSchema>;

package/dist/workspace.js

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from "./zod.js";
 /**
  * Repository scaffold contracts.
  *

package/dist/zod-values.d.ts

@@ -0,0 +1,3 @@
+/** The exact Zod constructors used by delivery-runtime contract modules. */
+export { ZodError, ZodIssueCode, array, boolean, discriminatedUnion, enum, int, json, literal, number, object, partialRecord, record, strictObject, string, toJSONSchema, tuple, union, unknown, url, } from "zod";
+export type { RefinementCtx, ZodType, ZodTypeAny, infer } from "zod";

package/dist/zod-values.js

@@ -0,0 +1,2 @@
+/** The exact Zod constructors used by delivery-runtime contract modules. */
+export { ZodError, ZodIssueCode, array, boolean, discriminatedUnion, enum, int, json, literal, number, object, partialRecord, record, strictObject, string, toJSONSchema, tuple, union, unknown, url, } from "zod";

package/dist/zod.d.ts

@@ -0,0 +1,2 @@
+/** Tree-shakeable namespace for delivery-runtime contract modules. */
+export * as z from "./zod-values.js";

package/dist/zod.js

@@ -0,0 +1,2 @@
+/** Tree-shakeable namespace for delivery-runtime contract modules. */
+export * as z from "./zod-values.js";

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

@@ -6,6 +6,10 @@
       "delivery": "dlv_01h8xyz9k2m4n6p8r0t2v4w6y8",
       "diagnostic": "http_retryable",
       "durationMs": 71,
+      "firstAttemptLatenessMs": 0,
+      "firstAttemptStartedAt": "2026-07-28T15:00:00.000Z",
+      "timingEligibility": "eligible",
+      "timingPolicyVersion": "payg-v1",
       "id": "att_01h8xyz9k2m4n6p8r0t2v4w6y8",
       "occurrence": "occ_01h8xyz9k2m4n6p8r0t2v4w6y8",
       "remediation": "review_retry_policy",

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

@@ -5,6 +5,10 @@
     "delivery": "dlv_11h8xyz9k2m4n6p8r0t2v4w6y8",
     "diagnostic": "network_ambiguous",
     "durationMs": 10000,
+    "firstAttemptLatenessMs": 0,
+    "firstAttemptStartedAt": "2026-07-28T15:00:00.000Z",
+    "timingEligibility": "eligible",
+    "timingPolicyVersion": "payg-v1",
     "id": "att_11h8xyz9k2m4n6p8r0t2v4w6y8",
     "occurrence": "occ_01h8xyz9k2m4n6p8r0t2v4w6y8",
     "remediation": "review_before_redelivery",

package/generated/v1/examples/billing.autotopup.request.json

@@ -0,0 +1,5 @@
+{
+  "confirmed": true,
+  "expectedRevision": 3,
+  "preview": "automatic-top-up-preview-example"
+}

package/generated/v1/examples/billing.autotopup.response.json

@@ -0,0 +1,120 @@
+{
+  "automaticExecutionTopUp": {
+    "ceiling": {
+      "currency": "USD",
+      "microdollars": "50000000",
+      "scale": 6
+    },
+    "currentPeriod": {
+      "end": "2026-10-01T00:00:00.000Z",
+      "pending": {
+        "currency": "USD",
+        "microdollars": "10830000",
+        "scale": 6
+      },
+      "remaining": {
+        "currency": "USD",
+        "microdollars": "29170000",
+        "scale": 6
+      },
+      "settled": {
+        "currency": "USD",
+        "microdollars": "10000000",
+        "scale": 6
+      },
+      "start": "2026-09-01T00:00:00.000Z"
+    },
+    "rule": {
+      "cooldownUntil": null,
+      "desired": {
+        "ceiling": {
+          "currency": "USD",
+          "microdollars": "50000000",
+          "scale": 6
+        },
+        "credit": {
+          "currency": "USD",
+          "microdollars": "10000000",
+          "scale": 6
+        },
+        "triggerBelow": {
+          "currency": "USD",
+          "microdollars": "2000000",
+          "scale": 6
+        }
+      },
+      "effective": {
+        "ceiling": {
+          "currency": "USD",
+          "microdollars": "50000000",
+          "scale": 6
+        },
+        "credit": {
+          "currency": "USD",
+          "microdollars": "10000000",
+          "scale": 6
+        },
+        "triggerBelow": {
+          "currency": "USD",
+          "microdollars": "2000000",
+          "scale": 6
+        }
+      },
+      "state": "ready",
+      "suspension": null
+    },
+    "revision": 3
+  },
+  "credit": {
+    "amountOwed": {
+      "currency": "USD",
+      "microdollars": "0",
+      "scale": 6
+    },
+    "available": {
+      "currency": "USD",
+      "microdollars": "9000000",
+      "scale": 6
+    },
+    "reserved": {
+      "currency": "USD",
+      "microdollars": "10",
+      "scale": 6
+    }
+  },
+  "freshness": {
+    "kind": "authoritative"
+  },
+  "paymentOperations": [
+    {
+      "createdAt": "2026-09-10T12:00:00.000Z",
+      "credit": {
+        "currency": "USD",
+        "microdollars": "10000000",
+        "scale": 6
+      },
+      "gross": {
+        "currency": "USD",
+        "microdollars": "10830000",
+        "scale": 6
+      },
+      "id": "funding-operation-example",
+      "kind": "automatic",
+      "paymentUrl": "https://pay.stripe.com/receipts/acct_example/example",
+      "reason": "payment-required",
+      "state": "pending",
+      "tax": {
+        "currency": "USD",
+        "microdollars": "830000",
+        "scale": 6
+      },
+      "taxStatus": "confirmed",
+      "updatedAt": "2026-09-10T12:00:01.000Z"
+    }
+  ],
+  "subscribedProjectFees": {
+    "currency": "USD",
+    "microdollars": "5000000",
+    "scale": 6
+  }
+}

package/generated/v1/examples/billing.autotopuppreview.request.json

@@ -0,0 +1,19 @@
+{
+  "action": "enable",
+  "ceiling": {
+    "currency": "USD",
+    "microdollars": "50000000",
+    "scale": 6
+  },
+  "credit": {
+    "currency": "USD",
+    "microdollars": "10000000",
+    "scale": 6
+  },
+  "expectedRevision": 3,
+  "triggerBelow": {
+    "currency": "USD",
+    "microdollars": "2000000",
+    "scale": 6
+  }
+}

package/generated/v1/examples/billing.autotopuppreview.response.json

@@ -0,0 +1,45 @@
+{
+  "action": "enable",
+  "after": {
+    "ceiling": {
+      "currency": "USD",
+      "microdollars": "50000000",
+      "scale": 6
+    },
+    "credit": {
+      "currency": "USD",
+      "microdollars": "10000000",
+      "scale": 6
+    },
+    "triggerBelow": {
+      "currency": "USD",
+      "microdollars": "2000000",
+      "scale": 6
+    }
+  },
+  "before": null,
+  "currentPeriod": {
+    "end": "2026-10-01T00:00:00.000Z",
+    "pending": {
+      "currency": "USD",
+      "microdollars": "0",
+      "scale": 6
+    },
+    "remaining": null,
+    "settled": {
+      "currency": "USD",
+      "microdollars": "0",
+      "scale": 6
+    },
+    "start": "2026-09-01T00:00:00.000Z"
+  },
+  "expectedRevision": 3,
+  "expandsAuthority": true,
+  "expiresAt": "2026-09-10T12:05:00.000Z",
+  "preview": "automatic-top-up-preview-example",
+  "subscribedProjectFees": {
+    "currency": "USD",
+    "microdollars": "5000000",
+    "scale": 6
+  }
+}

package/generated/v1/examples/billing.budgets.request.json

@@ -0,0 +1,13 @@
+{
+  "advisoryBudget": {
+    "currency": "USD",
+    "microdollars": "25000000",
+    "scale": 6
+  },
+  "expectedRevision": 1,
+  "hardCap": {
+    "currency": "USD",
+    "microdollars": "50000000",
+    "scale": 6
+  }
+}

package/generated/v1/examples/billing.budgets.response.json

@@ -0,0 +1,22 @@
+{
+  "budgetPolicy": {
+    "desired": {
+      "advisoryBudget": {
+        "currency": "USD",
+        "microdollars": "25000000",
+        "scale": 6
+      },
+      "hardCap": {
+        "currency": "USD",
+        "microdollars": "50000000",
+        "scale": 6
+      }
+    },
+    "desiredRevision": 2,
+    "effectiveRevision": 1,
+    "pending": true
+  },
+  "freshness": {
+    "kind": "authoritative"
+  }
+}

package/generated/v1/examples/billing.ceiling.request.json

@@ -0,0 +1,8 @@
+{
+  "automaticExecutionTopUpCeiling": {
+    "currency": "USD",
+    "microdollars": "50000000",
+    "scale": 6
+  },
+  "expectedRevision": 3
+}

package/generated/v1/examples/billing.ceiling.response.json

@@ -0,0 +1,120 @@
+{
+  "automaticExecutionTopUp": {
+    "ceiling": {
+      "currency": "USD",
+      "microdollars": "50000000",
+      "scale": 6
+    },
+    "currentPeriod": {
+      "end": "2026-10-01T00:00:00.000Z",
+      "pending": {
+        "currency": "USD",
+        "microdollars": "10830000",
+        "scale": 6
+      },
+      "remaining": {
+        "currency": "USD",
+        "microdollars": "29170000",
+        "scale": 6
+      },
+      "settled": {
+        "currency": "USD",
+        "microdollars": "10000000",
+        "scale": 6
+      },
+      "start": "2026-09-01T00:00:00.000Z"
+    },
+    "rule": {
+      "cooldownUntil": null,
+      "desired": {
+        "ceiling": {
+          "currency": "USD",
+          "microdollars": "50000000",
+          "scale": 6
+        },
+        "credit": {
+          "currency": "USD",
+          "microdollars": "10000000",
+          "scale": 6
+        },
+        "triggerBelow": {
+          "currency": "USD",
+          "microdollars": "2000000",
+          "scale": 6
+        }
+      },
+      "effective": {
+        "ceiling": {
+          "currency": "USD",
+          "microdollars": "50000000",
+          "scale": 6
+        },
+        "credit": {
+          "currency": "USD",
+          "microdollars": "10000000",
+          "scale": 6
+        },
+        "triggerBelow": {
+          "currency": "USD",
+          "microdollars": "2000000",
+          "scale": 6
+        }
+      },
+      "state": "ready",
+      "suspension": null
+    },
+    "revision": 3
+  },
+  "credit": {
+    "amountOwed": {
+      "currency": "USD",
+      "microdollars": "0",
+      "scale": 6
+    },
+    "available": {
+      "currency": "USD",
+      "microdollars": "9000000",
+      "scale": 6
+    },
+    "reserved": {
+      "currency": "USD",
+      "microdollars": "10",
+      "scale": 6
+    }
+  },
+  "freshness": {
+    "kind": "authoritative"
+  },
+  "paymentOperations": [
+    {
+      "createdAt": "2026-09-10T12:00:00.000Z",
+      "credit": {
+        "currency": "USD",
+        "microdollars": "10000000",
+        "scale": 6
+      },
+      "gross": {
+        "currency": "USD",
+        "microdollars": "10830000",
+        "scale": 6
+      },
+      "id": "funding-operation-example",
+      "kind": "automatic",
+      "paymentUrl": "https://pay.stripe.com/receipts/acct_example/example",
+      "reason": "payment-required",
+      "state": "pending",
+      "tax": {
+        "currency": "USD",
+        "microdollars": "830000",
+        "scale": 6
+      },
+      "taxStatus": "confirmed",
+      "updatedAt": "2026-09-10T12:00:01.000Z"
+    }
+  ],
+  "subscribedProjectFees": {
+    "currency": "USD",
+    "microdollars": "5000000",
+    "scale": 6
+  }
+}

package/generated/v1/examples/billing.change.request.json

@@ -0,0 +1,5 @@
+{
+  "quote": "quote-example",
+  "expectedRevision": 2,
+  "confirmed": true
+}

package/generated/v1/examples/billing.change.response.json

@@ -0,0 +1,12 @@
+{
+  "desiredRevision": 2,
+  "effectiveRevision": 2,
+  "pending": false,
+  "recurringProjectFees": {
+    "currency": "USD",
+    "microdollars": "0",
+    "scale": 6
+  },
+  "projects": [],
+  "pendingOperations": []
+}

package/generated/v1/examples/billing.funding.response.json

@@ -0,0 +1,120 @@
+{
+  "automaticExecutionTopUp": {
+    "ceiling": {
+      "currency": "USD",
+      "microdollars": "50000000",
+      "scale": 6
+    },
+    "currentPeriod": {
+      "end": "2026-10-01T00:00:00.000Z",
+      "pending": {
+        "currency": "USD",
+        "microdollars": "10830000",
+        "scale": 6
+      },
+      "remaining": {
+        "currency": "USD",
+        "microdollars": "29170000",
+        "scale": 6
+      },
+      "settled": {
+        "currency": "USD",
+        "microdollars": "10000000",
+        "scale": 6
+      },
+      "start": "2026-09-01T00:00:00.000Z"
+    },
+    "rule": {
+      "cooldownUntil": null,
+      "desired": {
+        "ceiling": {
+          "currency": "USD",
+          "microdollars": "50000000",
+          "scale": 6
+        },
+        "credit": {
+          "currency": "USD",
+          "microdollars": "10000000",
+          "scale": 6
+        },
+        "triggerBelow": {
+          "currency": "USD",
+          "microdollars": "2000000",
+          "scale": 6
+        }
+      },
+      "effective": {
+        "ceiling": {
+          "currency": "USD",
+          "microdollars": "50000000",
+          "scale": 6
+        },
+        "credit": {
+          "currency": "USD",
+          "microdollars": "10000000",
+          "scale": 6
+        },
+        "triggerBelow": {
+          "currency": "USD",
+          "microdollars": "2000000",
+          "scale": 6
+        }
+      },
+      "state": "ready",
+      "suspension": null
+    },
+    "revision": 3
+  },
+  "credit": {
+    "amountOwed": {
+      "currency": "USD",
+      "microdollars": "0",
+      "scale": 6
+    },
+    "available": {
+      "currency": "USD",
+      "microdollars": "9000000",
+      "scale": 6
+    },
+    "reserved": {
+      "currency": "USD",
+      "microdollars": "10",
+      "scale": 6
+    }
+  },
+  "freshness": {
+    "kind": "authoritative"
+  },
+  "paymentOperations": [
+    {
+      "createdAt": "2026-09-10T12:00:00.000Z",
+      "credit": {
+        "currency": "USD",
+        "microdollars": "10000000",
+        "scale": 6
+      },
+      "gross": {
+        "currency": "USD",
+        "microdollars": "10830000",
+        "scale": 6
+      },
+      "id": "funding-operation-example",
+      "kind": "automatic",
+      "paymentUrl": "https://pay.stripe.com/receipts/acct_example/example",
+      "reason": "payment-required",
+      "state": "pending",
+      "tax": {
+        "currency": "USD",
+        "microdollars": "830000",
+        "scale": 6
+      },
+      "taxStatus": "confirmed",
+      "updatedAt": "2026-09-10T12:00:01.000Z"
+    }
+  ],
+  "subscribedProjectFees": {
+    "currency": "USD",
+    "microdollars": "5000000",
+    "scale": 6
+  }
+}

package/generated/v1/examples/billing.fundingquote.request.json

@@ -0,0 +1,7 @@
+{
+  "credit": {
+    "currency": "USD",
+    "microdollars": "10000000",
+    "scale": 6
+  }
+}