openpond-sdk 0.5.6 → 0.5.8

package/dist/types/packages/sdk/src/training-bundle-contracts.d.ts

@@ -0,0 +1,287 @@
+import { z } from "zod";
+export declare const ScopedSecretDeclarationSchema: z.ZodObject<{
+    id: z.ZodString;
+    purpose: z.ZodString;
+    audience: z.ZodEnum<{
+        environment: "environment";
+        orchestrator: "orchestrator";
+        privileged_scorer: "privileged_scorer";
+        trainer: "trainer";
+        infrastructure: "infrastructure";
+    }>;
+    required: z.ZodBoolean;
+    ttlSeconds: z.ZodNumber;
+    scopes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare const OpaqueSecretLeaseRefSchema: z.ZodObject<{
+    declarationId: z.ZodString;
+    leaseRef: z.ZodString;
+    audience: z.ZodEnum<{
+        environment: "environment";
+        orchestrator: "orchestrator";
+        privileged_scorer: "privileged_scorer";
+        trainer: "trainer";
+        infrastructure: "infrastructure";
+    }>;
+    expiresAt: z.ZodString;
+}, z.core.$strict>;
+export type ScopedSecretDeclaration = z.infer<typeof ScopedSecretDeclarationSchema>;
+export type OpaqueSecretLeaseRef = z.infer<typeof OpaqueSecretLeaseRefSchema>;
+export declare const HarnessRuntimeTargetBindingSchema: z.ZodObject<{
+    adapterId: z.ZodString;
+    placement: z.ZodEnum<{
+        local: "local";
+        remote: "remote";
+        colocated: "colocated";
+        provider_native: "provider_native";
+    }>;
+    capabilityReceipt: z.ZodString;
+    runtimeVersion: z.ZodString;
+    dataPlane: z.ZodNullable<z.ZodObject<{
+        provider: z.ZodString;
+        dataPlaneId: z.ZodString;
+        cellId: z.ZodString;
+        runnerPoolId: z.ZodString;
+        runtimeImageDigest: z.ZodString;
+        capabilityReceipt: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const ComputeTargetBindingSchema: z.ZodObject<{
+    adapterId: z.ZodString;
+    kind: z.ZodEnum<{
+        custom: "custom";
+        local: "local";
+        managed: "managed";
+        ssh: "ssh";
+    }>;
+    deviceOrPool: z.ZodString;
+    capabilityReceipt: z.ZodString;
+    provider: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const TrainingEngineBindingSchema: z.ZodObject<{
+    adapterId: z.ZodString;
+    workerVersion: z.ZodString;
+    workerImageDigest: z.ZodNullable<z.ZodString>;
+    upstreamRevision: z.ZodString;
+    capabilityReceipt: z.ZodString;
+}, z.core.$strict>;
+export declare const HarnessRunManifestContentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"openpond.harnessRunManifest.v1">;
+    id: z.ZodString;
+    harnessRelease: z.ZodObject<{
+        id: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+    datasetRelease: z.ZodObject<{
+        id: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+    evidenceSets: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>>;
+    model: z.ZodObject<{
+        source: z.ZodString;
+        revision: z.ZodString;
+        artifactHash: z.ZodNullable<z.ZodString>;
+        tokenizerRevision: z.ZodString;
+        chatTemplateHash: z.ZodString;
+    }, z.core.$strict>;
+    recipe: z.ZodObject<{
+        method: z.ZodString;
+        version: z.ZodString;
+        configHash: z.ZodString;
+    }, z.core.$strict>;
+    runtimeTarget: z.ZodObject<{
+        adapterId: z.ZodString;
+        placement: z.ZodEnum<{
+            local: "local";
+            remote: "remote";
+            colocated: "colocated";
+            provider_native: "provider_native";
+        }>;
+        capabilityReceipt: z.ZodString;
+        runtimeVersion: z.ZodString;
+        dataPlane: z.ZodNullable<z.ZodObject<{
+            provider: z.ZodString;
+            dataPlaneId: z.ZodString;
+            cellId: z.ZodString;
+            runnerPoolId: z.ZodString;
+            runtimeImageDigest: z.ZodString;
+            capabilityReceipt: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    computeTarget: z.ZodObject<{
+        adapterId: z.ZodString;
+        kind: z.ZodEnum<{
+            custom: "custom";
+            local: "local";
+            managed: "managed";
+            ssh: "ssh";
+        }>;
+        deviceOrPool: z.ZodString;
+        capabilityReceipt: z.ZodString;
+        provider: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    engine: z.ZodObject<{
+        adapterId: z.ZodString;
+        workerVersion: z.ZodString;
+        workerImageDigest: z.ZodNullable<z.ZodString>;
+        upstreamRevision: z.ZodString;
+        capabilityReceipt: z.ZodString;
+    }, z.core.$strict>;
+    resolvedBundleHash: z.ZodString;
+    secretLeaseRefs: z.ZodArray<z.ZodObject<{
+        declarationId: z.ZodString;
+        leaseRef: z.ZodString;
+        audience: z.ZodEnum<{
+            environment: "environment";
+            orchestrator: "orchestrator";
+            privileged_scorer: "privileged_scorer";
+            trainer: "trainer";
+            infrastructure: "infrastructure";
+        }>;
+        expiresAt: z.ZodString;
+    }, z.core.$strict>>;
+    approval: z.ZodObject<{
+        approvalHash: z.ZodString;
+        approvedAt: z.ZodString;
+        maximumSpendUsd: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>;
+    createdAt: z.ZodString;
+}, z.core.$strict>;
+export declare const HarnessRunManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"openpond.harnessRunManifest.v1">;
+    id: z.ZodString;
+    harnessRelease: z.ZodObject<{
+        id: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+    datasetRelease: z.ZodObject<{
+        id: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+    evidenceSets: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>>;
+    model: z.ZodObject<{
+        source: z.ZodString;
+        revision: z.ZodString;
+        artifactHash: z.ZodNullable<z.ZodString>;
+        tokenizerRevision: z.ZodString;
+        chatTemplateHash: z.ZodString;
+    }, z.core.$strict>;
+    recipe: z.ZodObject<{
+        method: z.ZodString;
+        version: z.ZodString;
+        configHash: z.ZodString;
+    }, z.core.$strict>;
+    runtimeTarget: z.ZodObject<{
+        adapterId: z.ZodString;
+        placement: z.ZodEnum<{
+            local: "local";
+            remote: "remote";
+            colocated: "colocated";
+            provider_native: "provider_native";
+        }>;
+        capabilityReceipt: z.ZodString;
+        runtimeVersion: z.ZodString;
+        dataPlane: z.ZodNullable<z.ZodObject<{
+            provider: z.ZodString;
+            dataPlaneId: z.ZodString;
+            cellId: z.ZodString;
+            runnerPoolId: z.ZodString;
+            runtimeImageDigest: z.ZodString;
+            capabilityReceipt: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    computeTarget: z.ZodObject<{
+        adapterId: z.ZodString;
+        kind: z.ZodEnum<{
+            custom: "custom";
+            local: "local";
+            managed: "managed";
+            ssh: "ssh";
+        }>;
+        deviceOrPool: z.ZodString;
+        capabilityReceipt: z.ZodString;
+        provider: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    engine: z.ZodObject<{
+        adapterId: z.ZodString;
+        workerVersion: z.ZodString;
+        workerImageDigest: z.ZodNullable<z.ZodString>;
+        upstreamRevision: z.ZodString;
+        capabilityReceipt: z.ZodString;
+    }, z.core.$strict>;
+    resolvedBundleHash: z.ZodString;
+    secretLeaseRefs: z.ZodArray<z.ZodObject<{
+        declarationId: z.ZodString;
+        leaseRef: z.ZodString;
+        audience: z.ZodEnum<{
+            environment: "environment";
+            orchestrator: "orchestrator";
+            privileged_scorer: "privileged_scorer";
+            trainer: "trainer";
+            infrastructure: "infrastructure";
+        }>;
+        expiresAt: z.ZodString;
+    }, z.core.$strict>>;
+    approval: z.ZodObject<{
+        approvalHash: z.ZodString;
+        approvedAt: z.ZodString;
+        maximumSpendUsd: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>;
+    createdAt: z.ZodString;
+    contentHash: z.ZodString;
+}, z.core.$strict>;
+export declare const ResolvedTrainingBundleContentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"openpond.resolvedTrainingBundle.v1">;
+    projection: z.ZodLiteral<"trainer">;
+    harnessRelease: z.ZodObject<{
+        id: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+    datasetRelease: z.ZodObject<{
+        id: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+    evidenceSetRelease: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+        sizeBytes: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const ResolvedTrainingBundleManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"openpond.resolvedTrainingBundle.v1">;
+    projection: z.ZodLiteral<"trainer">;
+    harnessRelease: z.ZodObject<{
+        id: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+    datasetRelease: z.ZodObject<{
+        id: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>;
+    evidenceSetRelease: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        contentHash: z.ZodString;
+    }, z.core.$strict>>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+        sizeBytes: z.ZodNumber;
+    }, z.core.$strict>>;
+    contentHash: z.ZodString;
+}, z.core.$strict>;
+export type HarnessRuntimeTargetBinding = z.infer<typeof HarnessRuntimeTargetBindingSchema>;
+export type ComputeTargetBinding = z.infer<typeof ComputeTargetBindingSchema>;
+export type TrainingEngineBinding = z.infer<typeof TrainingEngineBindingSchema>;
+export type HarnessRunManifest = z.infer<typeof HarnessRunManifestSchema>;
+export type ResolvedTrainingBundleManifest = z.infer<typeof ResolvedTrainingBundleManifestSchema>;
+//# sourceMappingURL=training-bundle-contracts.d.ts.map

package/dist/types/packages/sdk/src/training-bundle-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"training-bundle-contracts.d.ts","sourceRoot":"","sources":["../../../../../src/training-bundle-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;kBAe/B,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;;;;;kBAO5B,CAAC;AAEZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;kBAkBnC,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;;;;;kBAQ5B,CAAC;AAEZ,eAAO,MAAM,2BAA2B;;;;;;kBAW7B,CAAC;AAEZ,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqCjC,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE1B,CAAC;AAEZ,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;kBAmBrC,CAAC;AAEZ,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;kBAGpC,CAAC;AAEd,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,iCAAiC,CACzC,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CACzC,OAAO,2BAA2B,CACnC,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,oCAAoC,CAC5C,CAAC"}

package/dist/types/packages/sdk/src/training-bundle.d.ts

@@ -0,0 +1,50 @@
+import { type HarnessSourcePackage, type ImmutableReleaseRef, type VersionedReleaseRef } from "@openpond/harness";
+import { type LearningTextAsset } from "@openpond/evals/learning";
+import { type ComputeTargetBinding, type HarnessRunManifest, type HarnessRuntimeTargetBinding, type OpaqueSecretLeaseRef, type ResolvedTrainingBundleManifest, type TrainingEngineBinding } from "./training-bundle-contracts.js";
+import type { ModelProject } from "./model-projects.js";
+import type { Taskset } from "./taskset-authored-contracts.js";
+import { type TasksetRewardExecution } from "./taskset-authored-portable-release.js";
+import { type TrainingEvaluationSource } from "./training-evaluation-source.js";
+export * from "./training-bundle-contracts.js";
+export { materializeLearningBatchTaskset, prepareReviewedLearningBatch } from "./training-learning-batch.js";
+export { prepareManagedTrainingSubmission, type ManagedTrainingPreparationInput, type TrainingPreparationFile } from "./managed-training-preparation.js";
+export { scanAndRedactEvidence, type EvidencePrivacyScan } from "./training-privacy.js";
+export type TasksetTrainingBundle = {
+    manifest: HarnessRunManifest;
+    resolvedBundleManifest: ResolvedTrainingBundleManifest;
+    assets: ReadonlyMap<string, Uint8Array>;
+    profileRelease: VersionedReleaseRef;
+    harnessRelease: ImmutableReleaseRef;
+    tasksetRelease: ImmutableReleaseRef;
+    datasetRelease: ImmutableReleaseRef;
+    evidenceSetRelease: ImmutableReleaseRef | null;
+};
+/**
+ * Produces the one artifact the training worker consumes. The release refs in
+ * the manifest are immutable lineage identifiers, not separately materialized
+ * release objects.
+ */
+export declare function buildTasksetTrainingBundle(input: {
+    taskset: Taskset;
+    modelProject: ModelProject;
+    modelRunId: string;
+    runtime: HarnessRuntimeTargetBinding;
+    compute: ComputeTargetBinding;
+    engine: TrainingEngineBinding;
+    approval: {
+        approvalHash: string;
+        approvedAt: string;
+        maximumSpendUsd: number | null;
+    };
+    secretLeaseRefs?: OpaqueSecretLeaseRef[];
+    openpondRelease: string;
+    workerProtocol: string;
+    harnessRelease: ImmutableReleaseRef;
+    tasksetRelease: ImmutableReleaseRef;
+    harnessSource?: HarnessSourcePackage | null;
+    tasksetAssetBytes?: ReadonlyMap<string, Uint8Array>;
+    rewardExecution?: TasksetRewardExecution;
+    verifierAssets?: LearningTextAsset[];
+    evaluationSource?: TrainingEvaluationSource;
+}): TasksetTrainingBundle;
+//# sourceMappingURL=training-bundle.d.ts.map

package/dist/types/packages/sdk/src/training-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"training-bundle.d.ts","sourceRoot":"","sources":["../../../../../src/training-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6H,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7O,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,OAAO,EAAwI,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,KAAK,2BAA2B,EAAE,KAAK,oBAAoB,EAAE,KAAK,8BAA8B,EAAE,KAAK,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACxW,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAE/D,OAAO,EAAyC,KAAK,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAC5H,OAAO,EAAsG,KAAK,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAEpL,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC7G,OAAO,EAAE,gCAAgC,EAAE,KAAK,+BAA+B,EAAE,KAAK,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACzJ,OAAO,EAAE,qBAAqB,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAExF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,sBAAsB,EAAE,8BAA8B,CAAC;IACvD,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,cAAc,EAAE,mBAAmB,CAAC;IACpC,cAAc,EAAE,mBAAmB,CAAC;IACpC,cAAc,EAAE,mBAAmB,CAAC;IACpC,cAAc,EAAE,mBAAmB,CAAC;IACpC,kBAAkB,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAChD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,2BAA2B,CAAC;IACrC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;IACF,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,mBAAmB,CAAC;IACpC,cAAc,EAAE,mBAAmB,CAAC;IACpC,aAAa,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5C,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpD,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,cAAc,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACrC,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;CAC7C,GAAG,qBAAqB,CA8NxB"}