openpond-sdk 0.12.13 → 0.12.15

package/dist/types/packages/sdk/src/steering-inference.d.ts

@@ -0,0 +1,224 @@
+import { z } from "zod";
+import { type SavedSteeringModelSelection } from "./steering-model-selection.js";
+/** Absence inherits the admitted default; null explicitly disables steering.
+ * Never normalize either case into the other before hashing a request. */
+export declare const SteeringInferenceOptionsSchema: z.ZodObject<{
+    savedModel: z.ZodOptional<z.ZodObject<{
+        modelProjectId: z.ZodString;
+        versionHash: z.ZodString;
+    }, z.core.$strict>>;
+    steering: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        contentHash: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type SteeringInferenceOptions = z.infer<typeof SteeringInferenceOptionsSchema>;
+export declare function savedSteeringModelSelection(raw: unknown): Promise<SavedSteeringModelSelection>;
+export declare const ResolvedSteeringSelectionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"openpond.resolvedSteeringSelection.v1">;
+    requested: z.ZodEnum<{
+        inherit: "inherit";
+        off: "off";
+        override: "override";
+    }>;
+    savedModel: z.ZodNullable<z.ZodObject<{
+        modelProjectId: z.ZodString;
+        versionHash: z.ZodString;
+    }, z.core.$strict>>;
+    defaultPublication: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        contentHash: z.ZodString;
+    }, z.core.$strict>>;
+    effectivePublication: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        contentHash: z.ZodString;
+    }, z.core.$strict>>;
+    profileHash: z.ZodNullable<z.ZodString>;
+    modelHash: z.ZodString;
+    calibration: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        contentHash: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ResolvedSteeringSelection = z.infer<typeof ResolvedSteeringSelectionSchema>;
+export declare function parseAndVerifyResolvedSteeringSelection(raw: unknown, options: SteeringInferenceOptions): Promise<{
+    schemaVersion: "openpond.resolvedSteeringSelection.v1";
+    requested: "inherit" | "off" | "override";
+    savedModel: {
+        modelProjectId: string;
+        versionHash: string;
+    } | null;
+    defaultPublication: {
+        id: string;
+        revision: number;
+        contentHash: string;
+    } | null;
+    effectivePublication: {
+        id: string;
+        revision: number;
+        contentHash: string;
+    } | null;
+    profileHash: string | null;
+    modelHash: string;
+    calibration: {
+        id: string;
+        revision: number;
+        contentHash: string;
+    } | null;
+}>;
+/** A completed runner observation, separate from admission. Hosts must require
+ * their authenticated worker proof before constructing this receipt. */
+export declare const SteeringInferenceReceiptContentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"openpond.steeringInferenceReceipt.v1">;
+    teamId: z.ZodString;
+    requestId: z.ZodString;
+    requestHash: z.ZodString;
+    selection: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"openpond.resolvedSteeringSelection.v1">;
+        requested: z.ZodEnum<{
+            inherit: "inherit";
+            off: "off";
+            override: "override";
+        }>;
+        savedModel: z.ZodNullable<z.ZodObject<{
+            modelProjectId: z.ZodString;
+            versionHash: z.ZodString;
+        }, z.core.$strict>>;
+        defaultPublication: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            revision: z.ZodNumber;
+            contentHash: z.ZodString;
+        }, z.core.$strict>>;
+        effectivePublication: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            revision: z.ZodNumber;
+            contentHash: z.ZodString;
+        }, z.core.$strict>>;
+        profileHash: z.ZodNullable<z.ZodString>;
+        modelHash: z.ZodString;
+        calibration: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            revision: z.ZodNumber;
+            contentHash: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    poolId: z.ZodString;
+    routingBinding: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+    }, z.core.$strict>>;
+    runtimeHash: z.ZodString;
+    workerImageDigest: z.ZodString;
+    engineGeneration: z.ZodNumber;
+    cacheNamespace: z.ZodString;
+    completedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const SteeringInferenceReceiptSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"openpond.steeringInferenceReceipt.v1">;
+    teamId: z.ZodString;
+    requestId: z.ZodString;
+    requestHash: z.ZodString;
+    selection: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"openpond.resolvedSteeringSelection.v1">;
+        requested: z.ZodEnum<{
+            inherit: "inherit";
+            off: "off";
+            override: "override";
+        }>;
+        savedModel: z.ZodNullable<z.ZodObject<{
+            modelProjectId: z.ZodString;
+            versionHash: z.ZodString;
+        }, z.core.$strict>>;
+        defaultPublication: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            revision: z.ZodNumber;
+            contentHash: z.ZodString;
+        }, z.core.$strict>>;
+        effectivePublication: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            revision: z.ZodNumber;
+            contentHash: z.ZodString;
+        }, z.core.$strict>>;
+        profileHash: z.ZodNullable<z.ZodString>;
+        modelHash: z.ZodString;
+        calibration: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            revision: z.ZodNumber;
+            contentHash: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    poolId: z.ZodString;
+    routingBinding: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        revision: z.ZodNumber;
+    }, z.core.$strict>>;
+    runtimeHash: z.ZodString;
+    workerImageDigest: z.ZodString;
+    engineGeneration: z.ZodNumber;
+    cacheNamespace: z.ZodString;
+    completedAt: z.ZodISODateTime;
+    contentHash: z.ZodString;
+}, z.core.$strict>;
+export type SteeringInferenceReceipt = z.infer<typeof SteeringInferenceReceiptSchema>;
+export declare function parseAndVerifySteeringInferenceReceipt(raw: unknown, expected: {
+    teamId: string;
+    requestId: string;
+    requestHash: string;
+    options: SteeringInferenceOptions;
+    selection: ResolvedSteeringSelection;
+    runtimeHash: string;
+    poolId: string;
+    routingBinding: {
+        id: string;
+        revision: number;
+    } | null;
+    workerImageDigest: string;
+    engineGeneration: number;
+    cacheNamespace: string;
+}): Promise<{
+    schemaVersion: "openpond.steeringInferenceReceipt.v1";
+    teamId: string;
+    requestId: string;
+    requestHash: string;
+    selection: {
+        schemaVersion: "openpond.resolvedSteeringSelection.v1";
+        requested: "inherit" | "off" | "override";
+        savedModel: {
+            modelProjectId: string;
+            versionHash: string;
+        } | null;
+        defaultPublication: {
+            id: string;
+            revision: number;
+            contentHash: string;
+        } | null;
+        effectivePublication: {
+            id: string;
+            revision: number;
+            contentHash: string;
+        } | null;
+        profileHash: string | null;
+        modelHash: string;
+        calibration: {
+            id: string;
+            revision: number;
+            contentHash: string;
+        } | null;
+    };
+    poolId: string;
+    routingBinding: {
+        id: string;
+        revision: number;
+    } | null;
+    runtimeHash: string;
+    workerImageDigest: string;
+    engineGeneration: number;
+    cacheNamespace: string;
+    completedAt: string;
+    contentHash: string;
+}>;
+//# sourceMappingURL=steering-inference.d.ts.map

package/dist/types/packages/sdk/src/steering-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steering-inference.d.ts","sourceRoot":"","sources":["../../../../../src/steering-inference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,KAAK,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAO1E;0EAC0E;AAC1E,eAAO,MAAM,8BAA8B;;;;;;;;;;kBAGhC,CAAC;AACZ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,wBAAsB,2BAA2B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAIpG;AAED,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQjC,CAAC;AACZ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,wBAAsB,uCAAuC,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;GAU5G;AAED;wEACwE;AACxE,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAOvC,CAAC;AACZ,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA+E,CAAC;AAC3H,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,wBAAsB,sCAAsC,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE;IACnF,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,wBAAwB,CAAC;IAC1F,SAAS,EAAE,yBAAyB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAC1D,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,iBAAiB,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;CAC7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAUA"}

package/dist/types/packages/sdk/src/steering-model-selection.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+/** An immutable publication identity, never a mutable profile record revision. */
+export declare const SteeringPublicationReferenceSchema: z.ZodObject<{
+    id: z.ZodString;
+    revision: z.ZodNumber;
+    contentHash: z.ZodString;
+}, z.core.$strict>;
+export type SteeringPublicationReference = z.infer<typeof SteeringPublicationReferenceSchema>;
+/** Pins a saved Model without copying its publication or result evidence. */
+export declare const SavedSteeringModelSelectionSchema: z.ZodObject<{
+    modelProjectId: z.ZodString;
+    versionHash: z.ZodString;
+}, z.core.$strict>;
+export type SavedSteeringModelSelection = z.infer<typeof SavedSteeringModelSelectionSchema>;
+//# sourceMappingURL=steering-model-selection.d.ts.map

package/dist/types/packages/sdk/src/steering-model-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steering-model-selection.d.ts","sourceRoot":"","sources":["../../../../../src/steering-model-selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,kFAAkF;AAClF,eAAO,MAAM,kCAAkC;;;;kBAEpC,CAAC;AACZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,6EAA6E;AAC7E,eAAO,MAAM,iCAAiC;;;kBAEnC,CAAC;AACZ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC"}