@opengeni/contracts 5.5.0 → 5.5.2-canary.40656248492001

package/dist/turn-serving-policy.d.ts

@@ -0,0 +1,223 @@
+import { z } from "zod";
+export declare const TURN_SERVING_POLICY_METADATA_KEY: "turnServingPolicyV1";
+export declare const TURN_PENDING_SERVING_POLICY_METADATA_KEY: "turnPendingServingPolicyV1";
+/** One immutable serving receipt, not a replacement for the accepted policy.
+ * The lazy reference keeps the contracts barrel free of initialization cycles.
+ * Connection ids are references only; no credential material belongs here.
+ */
+export declare const TurnServingPolicyV1: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    policy: z.ZodLazy<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        productModelId: z.ZodString;
+        requestedModelId: z.ZodNullable<z.ZodString>;
+        modelSource: z.ZodEnum<{
+            continuation: "continuation";
+            deployment: "deployment";
+            explicit: "explicit";
+            session: "session";
+        }>;
+        reasoningEffort: z.ZodEnum<{
+            high: "high";
+            low: "low";
+            max: "max";
+            medium: "medium";
+            minimal: "minimal";
+            none: "none";
+            xhigh: "xhigh";
+        }>;
+        reasoningSource: z.ZodEnum<{
+            continuation: "continuation";
+            deployment: "deployment";
+            explicit: "explicit";
+            session: "session";
+        }>;
+        latencyMode: z.ZodDefault<z.ZodEnum<{
+            fast: "fast";
+            priority: "priority";
+            standard: "standard";
+            ultrafast: "ultrafast";
+        }>>;
+        latencyModeSource: z.ZodDefault<z.ZodEnum<{
+            continuation: "continuation";
+            deployment: "deployment";
+            explicit: "explicit";
+            session: "session";
+        }>>;
+        providerId: z.ZodString;
+        upstreamModelId: z.ZodString;
+        wireApi: z.ZodEnum<{
+            "anthropic-messages": "anthropic-messages";
+            chat: "chat";
+            responses: "responses";
+        }>;
+        credentialSource: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"deployment">;
+            mechanism: z.ZodEnum<{
+                api_key: "api_key";
+                azure_ad_bearer: "azure_ad_bearer";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"connected_subscription">;
+            provider: z.ZodEnum<{
+                claude: "claude";
+                codex: "codex";
+                xai: "xai";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"workspace_connection">;
+            mechanism: z.ZodLiteral<"api_key">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"organization_connection">;
+            mechanism: z.ZodLiteral<"api_key">;
+        }, z.core.$strict>]>, z.ZodObject<{
+            kind: z.ZodLiteral<"deployment">;
+            mechanism: z.ZodLiteral<"none">;
+        }, z.core.$strict>]>;
+        billing: z.ZodObject<{
+            upstreamPayer: z.ZodEnum<{
+                connected_subscription: "connected_subscription";
+                deployment: "deployment";
+                organization: "organization";
+                workspace: "workspace";
+            }>;
+            metering: z.ZodEnum<{
+                external: "external";
+                opengeni_credits: "opengeni_credits";
+            }>;
+        }, z.core.$strict>;
+        definitionVersion: z.ZodString;
+        credentialRestriction: z.ZodOptional<z.ZodLiteral<"developer_setup">>;
+    }, z.core.$strict>>;
+    executionGeneration: z.ZodNumber;
+    connectionId: z.ZodString;
+    reason: z.ZodEnum<{
+        failover_cross_provider: "failover_cross_provider";
+        failover_same_provider: "failover_same_provider";
+        initial: "initial";
+        pinned: "pinned";
+        reselected_cold: "reselected_cold";
+        return_to_preferred: "return_to_preferred";
+        sticky: "sticky";
+    }>;
+    historyPosition: z.ZodNumber;
+}, z.core.$strict>;
+export type TurnServingPolicyV1 = z.infer<typeof TurnServingPolicyV1>;
+/** A recovery proposal, NOT provenance. Its history boundary is assigned only
+ * when a newer claimed generation commits a serving revision. C2 will stage it
+ * atomically with recovery using the transaction-local database helper.
+ */
+export declare const TurnPendingServingPolicyV1: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    sourceExecutionGeneration: z.ZodNumber;
+    sourceAttemptId: z.ZodString;
+    policy: z.ZodLazy<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        productModelId: z.ZodString;
+        requestedModelId: z.ZodNullable<z.ZodString>;
+        modelSource: z.ZodEnum<{
+            continuation: "continuation";
+            deployment: "deployment";
+            explicit: "explicit";
+            session: "session";
+        }>;
+        reasoningEffort: z.ZodEnum<{
+            high: "high";
+            low: "low";
+            max: "max";
+            medium: "medium";
+            minimal: "minimal";
+            none: "none";
+            xhigh: "xhigh";
+        }>;
+        reasoningSource: z.ZodEnum<{
+            continuation: "continuation";
+            deployment: "deployment";
+            explicit: "explicit";
+            session: "session";
+        }>;
+        latencyMode: z.ZodDefault<z.ZodEnum<{
+            fast: "fast";
+            priority: "priority";
+            standard: "standard";
+            ultrafast: "ultrafast";
+        }>>;
+        latencyModeSource: z.ZodDefault<z.ZodEnum<{
+            continuation: "continuation";
+            deployment: "deployment";
+            explicit: "explicit";
+            session: "session";
+        }>>;
+        providerId: z.ZodString;
+        upstreamModelId: z.ZodString;
+        wireApi: z.ZodEnum<{
+            "anthropic-messages": "anthropic-messages";
+            chat: "chat";
+            responses: "responses";
+        }>;
+        credentialSource: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"deployment">;
+            mechanism: z.ZodEnum<{
+                api_key: "api_key";
+                azure_ad_bearer: "azure_ad_bearer";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"connected_subscription">;
+            provider: z.ZodEnum<{
+                claude: "claude";
+                codex: "codex";
+                xai: "xai";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"workspace_connection">;
+            mechanism: z.ZodLiteral<"api_key">;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"organization_connection">;
+            mechanism: z.ZodLiteral<"api_key">;
+        }, z.core.$strict>]>, z.ZodObject<{
+            kind: z.ZodLiteral<"deployment">;
+            mechanism: z.ZodLiteral<"none">;
+        }, z.core.$strict>]>;
+        billing: z.ZodObject<{
+            upstreamPayer: z.ZodEnum<{
+                connected_subscription: "connected_subscription";
+                deployment: "deployment";
+                organization: "organization";
+                workspace: "workspace";
+            }>;
+            metering: z.ZodEnum<{
+                external: "external";
+                opengeni_credits: "opengeni_credits";
+            }>;
+        }, z.core.$strict>;
+        definitionVersion: z.ZodString;
+        credentialRestriction: z.ZodOptional<z.ZodLiteral<"developer_setup">>;
+    }, z.core.$strict>>;
+    connectionId: z.ZodString;
+    reason: z.ZodEnum<{
+        failover_cross_provider: "failover_cross_provider";
+        failover_same_provider: "failover_same_provider";
+        initial: "initial";
+        pinned: "pinned";
+        reselected_cold: "reselected_cold";
+        return_to_preferred: "return_to_preferred";
+        sticky: "sticky";
+    }>;
+}, z.core.$strict>;
+export type TurnPendingServingPolicyV1 = z.infer<typeof TurnPendingServingPolicyV1>;
+export declare function readTurnPendingServingPolicyV1(metadata: unknown): TurnPendingServingPolicyV1 | null;
+export type TurnServingPolicyReadV1 = {
+    kind: "absent";
+} | {
+    kind: "valid";
+    revisions: TurnServingPolicyV1[];
+};
+/** Only absence is legacy. Malformed present metadata fails closed, without
+ * reflecting untrusted values (which might contain credentials) into errors.
+ */
+export declare function readTurnServingPolicyV1(metadata: unknown): TurnServingPolicyReadV1;
+/** D-39: the first receipt establishes the baseline. Reclaims, account-only
+ * rotations and reasoning changes do not spend the model/provider bound.
+ * Combine this with the all-provider refusal count at the recovery boundary.
+ */
+export declare function countTurnServingPolicyChangesV1(revisions: readonly TurnServingPolicyV1[]): number;

package/dist/usage-allowances.d.ts

@@ -23,6 +23,19 @@ export declare const MemberAllowanceDefault: z.ZodUnion<readonly [z.ZodEnum<{
     credits: z.ZodNumber;
 }, z.core.$strict>]>;
 export type MemberAllowanceDefault = z.infer<typeof MemberAllowanceDefault>;
+/**
+ * How model calls that spend no Opengeni credits count: subscription
+ * connections, workspace-owned keys and deployments without credit billing.
+ * "ignore" (the default) keeps the allowance credit-only. "list_price" counts
+ * each such call at its configured list-price estimate in USD micros and
+ * admits those turns against the allowance; calls without a list price are
+ * not counted.
+ */
+export declare const UnbilledUsageMetering: z.ZodEnum<{
+    ignore: "ignore";
+    list_price: "list_price";
+}>;
+export type UnbilledUsageMetering = z.infer<typeof UnbilledUsageMetering>;
 /** Omitted threshold lists default to [0.8, 1]. Monthly boundaries are UTC. */
 export declare const WorkspaceAllowanceConfig: z.ZodObject<{
     includedCredits: z.ZodNumber;
@@ -43,6 +56,10 @@ export declare const WorkspaceAllowanceConfig: z.ZodObject<{
         workspace: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
         member: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     }, z.core.$strict>>;
+    unbilledUsage: z.ZodOptional<z.ZodEnum<{
+        ignore: "ignore";
+        list_price: "list_price";
+    }>>;
 }, z.core.$strict>;
 export type WorkspaceAllowanceConfig = z.infer<typeof WorkspaceAllowanceConfig>;
 export declare const WorkspaceAllowance: z.ZodObject<{
@@ -64,6 +81,10 @@ export declare const WorkspaceAllowance: z.ZodObject<{
         workspace: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
         member: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     }, z.core.$strict>>;
+    unbilledUsage: z.ZodOptional<z.ZodEnum<{
+        ignore: "ignore";
+        list_price: "list_price";
+    }>>;
     version: z.ZodNumber;
 }, z.core.$strict>;
 export type WorkspaceAllowance = z.infer<typeof WorkspaceAllowance>;
@@ -93,6 +114,10 @@ export declare const WorkspaceAllowanceState: z.ZodObject<{
             workspace: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
             member: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
         }, z.core.$strict>>;
+        unbilledUsage: z.ZodOptional<z.ZodEnum<{
+            ignore: "ignore";
+            list_price: "list_price";
+        }>>;
         version: z.ZodNumber;
     }, z.core.$strict>>;
 }, z.core.$strict>;
@@ -116,6 +141,10 @@ export declare const SetWorkspaceAllowanceRequest: z.ZodObject<{
         workspace: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
         member: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     }, z.core.$strict>>;
+    unbilledUsage: z.ZodOptional<z.ZodEnum<{
+        ignore: "ignore";
+        list_price: "list_price";
+    }>>;
     expectedVersion: z.ZodNumber;
 }, z.core.$strict>;
 export type SetWorkspaceAllowanceRequest = z.infer<typeof SetWorkspaceAllowanceRequest>;
@@ -228,6 +257,7 @@ export declare const MemberAllowanceUsage: z.ZodObject<{
 export type MemberAllowanceUsage = z.infer<typeof MemberAllowanceUsage>;
 /** /usage/me returns only the authenticated subject's member row, never the roster. */
 export declare const WorkspaceUsageResponse: z.ZodObject<{
+    unit: z.ZodOptional<z.ZodLiteral<"usd_micros">>;
     period: z.ZodObject<{
         start: z.ZodNullable<z.ZodString>;
         end: z.ZodNullable<z.ZodString>;

package/dist/usage-allowances.js

@@ -12,6 +12,7 @@ import {
   MemberAllowanceUsage,
   SetMemberAllowanceRequest,
   SetWorkspaceAllowanceRequest,
+  UnbilledUsageMetering,
   UsageAllowancePeriod,
   UsageAllowanceStatus,
   UsageAllowanceWindow,
@@ -21,7 +22,9 @@ import {
   WorkspaceAllowanceUsage,
   WorkspaceCreditGrant,
   WorkspaceUsageResponse
-} from "./chunk-EK7NDGFR.js";
+} from "./chunk-MYHMB6GZ.js";
+import "./chunk-AQYDZUJV.js";
+import "./chunk-56SNIMDO.js";
 export {
   AllowanceCredits,
   AllowanceExhaustedRefusal,
@@ -36,6 +39,7 @@ export {
   MemberAllowanceUsage,
   SetMemberAllowanceRequest,
   SetWorkspaceAllowanceRequest,
+  UnbilledUsageMetering,
   UsageAllowancePeriod,
   UsageAllowanceStatus,
   UsageAllowanceWindow,

package/dist/values.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Small runtime helpers shared across packages. Dependency-free and safe in
+ * browsers, React Native, workers and servers, so any package can import
+ * `@opengeni/contracts/values` without pulling in zod or Node built-ins.
+ */
+/** A non-null object that is not an array. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** An `Error`'s message, or the value converted to a string. */
+export declare function errorMessage(error: unknown): string;
+/** Lowercase hex SHA-256 of bytes, or of a string's UTF-8 encoding, with Web Crypto. */
+export declare function sha256Hex(data: string | Uint8Array): Promise<string>;

package/dist/values.js

@@ -0,0 +1,19 @@
+// src/values.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+async function sha256Hex(data) {
+  const bytes = typeof data === "string" ? new TextEncoder().encode(data) : new Uint8Array(data.byteLength);
+  if (typeof data !== "string") bytes.set(data);
+  const digest = new Uint8Array(await globalThis.crypto.subtle.digest("SHA-256", bytes));
+  return Array.from(digest, (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+export {
+  errorMessage,
+  isRecord,
+  sha256Hex
+};
+//# sourceMappingURL=values.js.map

package/dist/values.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/values.ts"],"sourcesContent":["/**\n * Small runtime helpers shared across packages. Dependency-free and safe in\n * browsers, React Native, workers and servers, so any package can import\n * `@opengeni/contracts/values` without pulling in zod or Node built-ins.\n */\n\n/** A non-null object that is not an array. */\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** An `Error`'s message, or the value converted to a string. */\nexport function errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/** Lowercase hex SHA-256 of bytes, or of a string's UTF-8 encoding, with Web Crypto. */\nexport async function sha256Hex(data: string | Uint8Array): Promise<string> {\n  // A copy hands Web Crypto a plain ArrayBuffer even for views over shared memory.\n  const bytes =\n    typeof data === \"string\" ? new TextEncoder().encode(data) : new Uint8Array(data.byteLength);\n  if (typeof data !== \"string\") bytes.set(data);\n  const digest = new Uint8Array(await globalThis.crypto.subtle.digest(\"SHA-256\", bytes));\n  return Array.from(digest, (byte) => byte.toString(16).padStart(2, \"0\")).join(\"\");\n}\n"],"mappings":";AAOO,SAAS,SAAS,OAAkD;AACzE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAGO,SAAS,aAAa,OAAwB;AACnD,SAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;AAGA,eAAsB,UAAU,MAA4C;AAE1E,QAAM,QACJ,OAAO,SAAS,WAAW,IAAI,YAAY,EAAE,OAAO,IAAI,IAAI,IAAI,WAAW,KAAK,UAAU;AAC5F,MAAI,OAAO,SAAS,SAAU,OAAM,IAAI,IAAI;AAC5C,QAAM,SAAS,IAAI,WAAW,MAAM,WAAW,OAAO,OAAO,OAAO,WAAW,KAAK,CAAC;AACrF,SAAO,MAAM,KAAK,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE;AACjF;","names":[]}