openpond-sdk 0.12.9 → 0.12.11

package/README.md

@@ -1,5 +1,7 @@
 # `openpond-sdk`
 
+See [tool learning](./TOOL_LEARNING.md) for scoped tool capture, private recovery evidence, and metered specialist consultation.
+
 See [task evidence and learning](./LEARNING.md) for reusable Rewards, task-format publication, SDK/HTTP intake, grading, review and approved batches.
 
 The OpenPond SDK is the server-side TypeScript client for running agentic work in OpenPond sandboxes. It gives Node.js applications, Next.js route handlers, workers, and backend services a small API for creating sandboxes, executing commands, managing files and runtimes, and running a model/tool loop in an isolated workspace.

package/TRAINING_PROTOCOL.md

@@ -288,3 +288,43 @@ CLI: `openpond training hosted-recover recovery.json --team-id <id> --home <conf
 Managed Work reconciles a transient or lost policy HTTP response inside its current guest using the identical delivery, turn, seed, messages and tool body. The native gateway reads the existing command result for that identity; a response retry does not add a policy sample or replay already-executed Work tools. The signed native retry allowance is shared across the case and the original execution deadline remains binding. Successful Work timing evidence includes `policyHttpRetries`.
 
 The native runner does not restart a whole stateful Work process to recover a policy HTTP failure. Exhausted retries, authentication/custody failures and first-call budget exhaustion still fail the attempt; no response, reward or optimizer update is fabricated. Other execution kinds keep their established process-retry behavior.
+
+## Supervised recipes and reviewed targets
+
+`SftRecipeSchema` and `ManagedSftRecipeSchema` from `openpond-sdk/training` describe
+supervised LoRA updates with pinned model/tokenizer identity, completion-only
+masking, dataset selection, epochs/steps, batch accumulation, and resource limits.
+The workbench consumes the same recipe schema. SFT does not use GRPO rollout
+counts, relative advantages, or reward-loss parameters. Initial managed SFT
+requests require a fresh single-GPU run without cross-job continuation or
+rollout-only qualification. A deterministic held-out grader remains evaluation
+configuration; it is not the supervised optimizer objective.
+
+`prepareManagedTrainingSubmission` requires a fully materialized approved recipe
+and requests `managed_training.sft@1` for SFT. A deployed backend must explicitly
+support that capability before accepting work; schema availability is not a claim
+that a particular deployment or worker image has qualified SFT. Collection and
+publication do not authorize optimizer execution. Approved targets, an independent
+held-out population, funding, exact artifact custody, and execution permission
+remain separate boundaries.
+
+## Tool episode protocol
+
+`openpond-sdk/tool-learning` re-exports the portable bounded episode, scoped
+installation, manifest, and recovery-consultation schemas from
+`@openpond/evals/tool-learning`. Integration and learned capability entries carry
+different qualification receipts. A learned entry requires training, evaluation,
+adapter, and activation references; newly captured errors cannot promote it.
+Operational unavailability is distinct from a model's `proceed` response, and a
+response must match the request's operation, installation, action, context,
+manifest, capability, and model identity.
+
+The separate `openpond-sdk/tool-learning/node` entry exports
+`ToolLearningLocalStore`, a private bounded SQLite queue for an explicitly selected
+OpenPond home. It records installation scope and capture policy, rejects conflicting
+event identities, bounds pending evidence, records dropped/expired counts, and
+removes queued events only for exact installation/event/content-hash acknowledgements.
+It performs no authentication, network upload, tool execution, training, or model
+activation. Callers must verify authentic durable hosted receipts before
+acknowledging delivery. Import the portable entry in browser code; the Node queue
+is a separate runtime capability.

package/dist/advanced-refiner-evaluations.js

@@ -12,17 +12,18 @@ import {
   sealAdvancedRefinerEvaluationPin,
   sealAdvancedRefinerReviewReceipt,
   verifyAdvancedRefinerEvaluationPin
-} from "./chunk-CZXN63A4.js";
-import "./chunk-LUFOAMN5.js";
+} from "./chunk-UWY5PUHR.js";
+import "./chunk-O3NOGKMT.js";
 import "./chunk-3B5KSH3V.js";
 import "./chunk-H3367ISL.js";
-import "./chunk-YP5DXGGC.js";
+import "./chunk-LHHHJIDR.js";
 import "./chunk-O6FKHAWN.js";
-import "./chunk-WYR3MZHU.js";
-import "./chunk-EWRWGFKD.js";
-import "./chunk-CJDEVI3T.js";
-import "./chunk-YSEYPMQ3.js";
+import "./chunk-C4W2MEFP.js";
+import "./chunk-ZYDDHHZZ.js";
+import "./chunk-RLW4Y5ZV.js";
+import "./chunk-UOV2LEXS.js";
 import "./chunk-CL3IOOVL.js";
+import "./chunk-B3ZHJ2KK.js";
 import "./chunk-H3JZ3P5T.js";
 import "./chunk-YLJ4XMA6.js";
 export {

package/dist/candidate-evaluations.js

@@ -5,13 +5,14 @@ import {
   CandidateEvaluationPreparationSchema,
   CandidateEvaluationRequestSchema,
   createCandidateEvaluationClient
-} from "./chunk-GGG6H4MK.js";
-import "./chunk-UWM2ZPGS.js";
-import "./chunk-WYR3MZHU.js";
-import "./chunk-EWRWGFKD.js";
-import "./chunk-CJDEVI3T.js";
-import "./chunk-YSEYPMQ3.js";
+} from "./chunk-CNREFTAV.js";
+import "./chunk-K54BDIKL.js";
+import "./chunk-C4W2MEFP.js";
+import "./chunk-ZYDDHHZZ.js";
+import "./chunk-RLW4Y5ZV.js";
+import "./chunk-UOV2LEXS.js";
 import "./chunk-CL3IOOVL.js";
+import "./chunk-B3ZHJ2KK.js";
 import "./chunk-H3JZ3P5T.js";
 import "./chunk-YLJ4XMA6.js";
 export {

package/dist/{chunk-TWJYL5YF.js → chunk-2LVR24GU.js}

@@ -6,14 +6,14 @@ import {
   ExperimentImprovementTestRecipeSchema,
   verifyExperimentImprovementHumanOptions,
   verifyExperimentImprovementState
-} from "./chunk-LUFOAMN5.js";
+} from "./chunk-O3NOGKMT.js";
+import {
+  fetchConnectedJson
+} from "./chunk-O6FKHAWN.js";
 import {
   HarnessPolicySourcePackageSchema,
   validateHarnessPolicySourcePackage
 } from "./chunk-Q4TKI2MV.js";
-import {
-  fetchConnectedJson
-} from "./chunk-O6FKHAWN.js";
 import {
   ImmutableReleaseRefSchema,
   contentHash,
@@ -157,4 +157,4 @@ export {
   HostedProfileCandidateCommandSchema,
   ExperimentImprovementClient
 };
-//# sourceMappingURL=chunk-TWJYL5YF.js.map
+//# sourceMappingURL=chunk-2LVR24GU.js.map

package/dist/{chunk-MRUDFIB6.js → chunk-7BYLH47N.js}

@@ -1,11 +1,13 @@
 import {
   RunExperimentSchema
-} from "./chunk-UWM2ZPGS.js";
+} from "./chunk-K54BDIKL.js";
+import {
+  HostedModelProjectSummarySchema
+} from "./chunk-UOV2LEXS.js";
 import {
-  HostedModelProjectSummarySchema,
   OpenPondProtocolError,
   canonicalSha256
-} from "./chunk-YSEYPMQ3.js";
+} from "./chunk-B3ZHJ2KK.js";
 import {
   contentHash
 } from "./chunk-H3JZ3P5T.js";
@@ -293,4 +295,4 @@ export {
   HostedTrainingPolicyControlSchema,
   TrainingHandoffOriginSchema2 as TrainingHandoffOriginSchema
 };
-//# sourceMappingURL=chunk-MRUDFIB6.js.map
+//# sourceMappingURL=chunk-7BYLH47N.js.map

package/dist/{chunk-MRUDFIB6.js.map → chunk-7BYLH47N.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/post-training.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { contentHash } from \"@openpond/harness\";\nimport {\n  LearningSourceSchema,\n  TaskBatchSchema,\n  TaskDefinitionSchema,\n  LearningPolicySchema,\n  LearningPolicyInspectionResultSchema,\n  LearningIterationSchema,\n} from \"@openpond/evals/learning\";\nimport { HostedModelProjectSummarySchema } from \"./model-projects.js\";\nimport { AcceptancePlanSchema } from \"@openpond/evals/learning\";\nimport { TrainingHandoffOriginSchema } from \"@openpond/evals/learning\";\nexport { TrainingHandoffOriginSchema, type TrainingHandoffOrigin } from \"@openpond/evals/learning\";\nimport { RunExperimentSchema } from \"./experiment-run-contracts.js\";\nimport { canonicalSha256, OpenPondProtocolError } from \"./protocol.js\";\n\nconst Id = z.string().trim().min(1).max(200);\nconst Hash = z.string().regex(/^[a-f0-9]{64}$/);\nconst Ref = z.object({ id: Id, contentHash: Hash }).strict();\nexport const TrainingHandoffContextSchema = z\n  .object({\n    available: z.boolean(),\n    reason: z.string().max(1000).nullable(),\n    origin: TrainingHandoffOriginSchema.nullable(),\n  })\n  .strict();\nexport type TrainingHandoffContext = z.infer<typeof TrainingHandoffContextSchema>;\nexport const PostTrainingAttachmentSchema = z\n  .object({\n    schemaVersion: z.literal(\"openpond.postTrainingAttachment.v1\"),\n    binding: z\n      .object({\n        kind: z.enum([\"preparation\", \"policy\"]),\n        id: Id,\n        revision: z.number().int().positive(),\n        contentHash: Hash,\n      })\n      .strict(),\n    projectId: Id.nullable(),\n    automatic: z.boolean(),\n    maximumSpendUsd: z.number().finite().positive().max(10_000),\n    experiments: z\n      .array(z.object({ id: Id, configuration: RunExperimentSchema }).strict())\n      .min(1)\n      .max(20),\n    acceptancePlan: AcceptancePlanSchema.nullable(),\n  })\n  .strict()\n  .superRefine((value, ctx) => {\n    if (new Set(value.experiments.map((item) => item.id)).size !== value.experiments.length)\n      ctx.addIssue({ code: \"custom\", message: \"Attach each evaluation once.\" });\n    if (\n      value.experiments.reduce((sum, item) => sum + item.configuration.maximumCostUsd, 0) >\n      value.maximumSpendUsd + 1e-9\n    )\n      ctx.addIssue({\n        code: \"custom\",\n        message: \"Attached evaluation budgets exceed the total approved budget.\",\n      });\n    if (\n      value.experiments.some(\n        (item) => (item.configuration.request.project?.id ?? null) !== value.projectId,\n      )\n    )\n      ctx.addIssue({\n        code: \"custom\",\n        message: \"Attached experiments must use the training Project.\",\n      });\n    if (value.acceptancePlan) {\n      const checked = new Set(value.acceptancePlan.checks.map((c) => c.id));\n      if (value.acceptancePlan.checks.some((c) => !value.experiments.some((m) => m.id === c.id)))\n        ctx.addIssue({\n          code: \"custom\",\n          message: \"Select the frozen Experiment for each acceptance check.\",\n        });\n      const committed =\n        value.acceptancePlan.maximumSpendUsd +\n        value.experiments\n          .filter((m) => !checked.has(m.id))\n          .reduce((sum, m) => sum + m.configuration.maximumCostUsd, 0);\n      if (committed > value.maximumSpendUsd + 1e-9)\n        ctx.addIssue({\n          code: \"custom\",\n          message:\n            \"Paired acceptance and diagnostic ceilings exceed the approved evaluation budget.\",\n        });\n    }\n  });\nexport type PostTrainingAttachment = z.infer<typeof PostTrainingAttachmentSchema>;\n/** Target-independent recipe pins keep the paired baseline/candidate check on\n * the same released data, case order, settings and graders. */\nexport function postTrainingRecipe(\n  configuration: PostTrainingAttachment[\"experiments\"][number][\"configuration\"],\n) {\n  const {\n    modelId: _model,\n    candidate: _candidate,\n    ...settings\n  } = configuration.request.policy.kind === \"fixture\"\n    ? { modelId: null, candidate: null, ...configuration.request.policy }\n    : configuration.request.policy;\n  void _model;\n  void _candidate;\n  if (\"modelConfigurationHash\" in settings)\n    delete (settings as { modelConfigurationHash?: string }).modelConfigurationHash;\n  return {\n    dataset: {\n      id: configuration.request.taskset.id,\n      contentHash: configuration.request.taskset.contentHash,\n    },\n    populationHash: contentHash(\n      configuration.request.population.map((m) => ({\n        caseId: m.taskId,\n        seed: m.seed,\n        fixtureId: m.fixtureId,\n      })),\n    ),\n    executionHash: contentHash({ settings, graders: configuration.graders ?? null }),\n  };\n}\nexport const PostTrainingQualificationSchema = z\n  .object({\n    baseline: Ref,\n    checks: z\n      .array(\n        z\n          .object({\n            id: Id,\n            sourceRunId: Id,\n            sourceManifestHash: Hash,\n            targetConfigurationHash: Hash,\n            executionHash: Hash,\n            populationHash: Hash,\n            evaluator: Ref,\n            feedbackKey: Id,\n            output: z.enum([\"boolean\", \"score\"]),\n            unit: z.string().min(1).max(80),\n          })\n          .strict(),\n      )\n      .min(1)\n      .max(100),\n  })\n  .strict();\nexport const PostTrainingStateSchema = z.enum([\n  \"waiting_for_training\",\n  \"ready\",\n  \"preparing\",\n  \"queued\",\n  \"running\",\n  \"cleaning\",\n  \"completed\",\n  \"failed\",\n  \"blocked\",\n  \"cancelled\",\n  \"budget_exhausted\",\n]);\nexport const PostTrainingSummarySchema = z\n  .object({\n    schemaVersion: z.literal(\"openpond.postTrainingSummary.v1\"),\n    id: Id,\n    teamId: Id,\n    jobId: Id,\n    revision: z.number().int().positive(),\n    planHash: Hash,\n    automatic: z.boolean(),\n    candidate: Ref.nullable(),\n    state: PostTrainingStateSchema,\n    total: z.number().int().positive(),\n    completed: z.number().int().nonnegative(),\n    failed: z.number().int().nonnegative(),\n    requiredOutcome: z.enum([\"none\", \"pending\", \"passed\", \"failed\", \"blocked\"]),\n    reason: z.string().max(500).nullable(),\n    groupId: Id.nullable(),\n    experimentIds: z.array(Id).max(20),\n    updatedAt: z.iso.datetime(),\n  })\n  .strict()\n  .superRefine((value, ctx) => {\n    if (value.completed + value.failed > value.total)\n      ctx.addIssue({ code: \"custom\", message: \"Evaluation totals are inconsistent.\" });\n    if (\n      [\"preparing\", \"queued\", \"running\", \"cleaning\", \"completed\"].includes(value.state) &&\n      !value.candidate\n    )\n      ctx.addIssue({\n        code: \"custom\",\n        message: \"Evaluation execution requires the exact trained candidate.\",\n      });\n  });\nexport type PostTrainingSummary = z.infer<typeof PostTrainingSummarySchema>;\nexport const PostTrainingControlSchema = z\n  .object({ operationId: Id, expectedRevision: z.number().int().positive(), planHash: Hash })\n  .strict();\nexport const AttachPostTrainingSchema = z\n  .object({ operationId: Id, attachment: PostTrainingAttachmentSchema })\n  .strict();\nexport const PostTrainingPlanSchema = z\n  .object({\n    id: Id,\n    teamId: Id,\n    ownerUserId: Id,\n    attachment: PostTrainingAttachmentSchema,\n    qualification: PostTrainingQualificationSchema.nullable(),\n    contentHash: Hash,\n    createdAt: z.iso.datetime(),\n  })\n  .strict();\nexport type PostTrainingPlan = z.infer<typeof PostTrainingPlanSchema>;\nexport function verifyPostTrainingPlan(raw: unknown): PostTrainingPlan {\n  const plan = PostTrainingPlanSchema.parse(raw);\n  if (\n    plan.contentHash !==\n    contentHash({ attachment: plan.attachment, qualification: plan.qualification })\n  )\n    throw new Error(\"The retained evaluation attachment or qualification changed.\");\n  return plan;\n}\nexport function postTrainingActive(summary: PostTrainingSummary | null | undefined) {\n  return Boolean(summary && [\"preparing\", \"queued\", \"running\", \"cleaning\"].includes(summary.state));\n}\n\n/** Read/setup are configuration-only. Manual start authorizes exactly the\n * retained candidate, plan and revision. A retry never launches training. */\nexport function createPostTrainingClient(input: {\n  request: (path: string, init?: RequestInit) => Promise<unknown>;\n}) {\n  const { request } = input;\n  // These public evaluation routes consume ordinary JSON, independently of\n  // the versioned Training V2 job routes used by the parent factory.\n  const headers = { accept: \"application/json\", \"content-type\": \"application/json\" };\n  const path = (jobId: string) =>\n    `/v1/training/jobs/${encodeURIComponent(Id.parse(jobId))}/post-training`;\n  async function read(raw: unknown, teamId: string, jobId: string) {\n    if (raw === null) return null;\n    const value = PostTrainingSummarySchema.parse(raw);\n    if (value.teamId !== teamId || value.jobId !== jobId)\n      throw new OpenPondProtocolError(\n        \"post_training_scope_mismatch\",\n        \"The evaluation summary belongs to another run or workspace.\",\n      );\n    return value;\n  }\n  return {\n    async attach(teamId: string, raw: z.input<typeof AttachPostTrainingSchema>) {\n      const body = AttachPostTrainingSchema.parse(raw);\n      const value = verifyPostTrainingPlan(\n        await request(\"/v1/training/post-training-plans\", {\n          method: \"POST\",\n          headers,\n          body: JSON.stringify(body),\n        }),\n      );\n      if (\n        value.teamId !== teamId ||\n        (await canonicalSha256(value.attachment)) !== (await canonicalSha256(body.attachment))\n      )\n        throw new OpenPondProtocolError(\n          \"post_training_plan_mismatch\",\n          \"The retained attachment differs from the reviewed plan.\",\n        );\n      return value;\n    },\n    async get(teamId: string, jobId: string) {\n      return read(await request(path(jobId), { headers }), teamId, jobId);\n    },\n    async control(\n      teamId: string,\n      jobId: string,\n      action: \"start\" | \"retry\" | \"cancel\",\n      raw: z.input<typeof PostTrainingControlSchema>,\n    ) {\n      const body = PostTrainingControlSchema.parse(raw);\n      const value = await read(\n        await request(`${path(jobId)}/${action}`, { method: \"POST\", headers, body: JSON.stringify(body) }),\n        teamId,\n        jobId,\n      );\n      if (!value || value.planHash !== body.planHash)\n        throw new OpenPondProtocolError(\n          \"post_training_control_mismatch\",\n          \"Evaluation control did not retain the approved plan.\",\n        );\n      return value;\n    },\n  };\n}\n\nexport const HostedTrainingSetupCatalogSchema = z\n  .object({\n    teamId: Id,\n    actorId: Id,\n    projectId: Id.nullable(),\n    configuration: HostedModelProjectSummarySchema,\n    batches: z.array(TaskBatchSchema).max(10_000),\n    sources: z.array(LearningSourceSchema).max(10_000),\n    definitions: z.array(TaskDefinitionSchema).max(10_000),\n    experiments: z\n      .array(\n        z\n          .object({\n            id: Id,\n            name: z.string().max(500),\n            configuration: RunExperimentSchema,\n            graders: z\n              .array(z.object({ feedbackKey: Id, name: z.string().max(500), ref: Ref }).strict())\n              .max(100),\n          })\n          .strict(),\n      )\n      .max(10_000),\n  })\n  .strict();\nexport type HostedTrainingSetupCatalog = z.infer<typeof HostedTrainingSetupCatalogSchema>;\n\nexport const HostedTrainingSetupActionSchema = z.enum([\n  \"prepare\",\n  \"start\",\n  \"cancel\",\n  \"publish\",\n  \"attach\",\n]);\nexport type HostedTrainingSetupAction = z.infer<typeof HostedTrainingSetupActionSchema>;\n\nexport const HostedTrainingPolicyDetailSchema = z\n  .object({\n    teamId: Id,\n    actorId: Id,\n    configuration: HostedModelProjectSummarySchema,\n    policy: LearningPolicySchema,\n    inspection: LearningPolicyInspectionResultSchema,\n    iterations: z\n      .array(\n        z\n          .object({\n            iteration: LearningIterationSchema,\n            evals: PostTrainingSummarySchema.nullable(),\n          })\n          .strict(),\n      )\n      .max(100),\n    nextCursor: Id.nullable(),\n  })\n  .strict();\nexport const HostedTrainingPolicyControlSchema = z\n  .object({\n    id: Id,\n    expectedRevision: z.number().int().positive(),\n    policyHash: Hash,\n    operationId: Id,\n    action: z.enum([\"pause\", \"resume\", \"reserve\", \"cancel-iteration\", \"retry-iteration\"]),\n    iterationId: Id.optional(),\n    iterationRevision: z.number().int().positive().optional(),\n  })\n  .strict();\nexport type HostedTrainingPolicyControl = z.infer<typeof HostedTrainingPolicyControlSchema>;\n"],"mappings":"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","names":["TrainingHandoffOriginSchema"]}
+{"version":3,"sources":["../src/post-training.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { contentHash } from \"@openpond/harness\";\nimport {\n  LearningSourceSchema,\n  TaskBatchSchema,\n  TaskDefinitionSchema,\n  LearningPolicySchema,\n  LearningPolicyInspectionResultSchema,\n  LearningIterationSchema,\n} from \"@openpond/evals/learning\";\nimport { HostedModelProjectSummarySchema } from \"./model-projects.js\";\nimport { AcceptancePlanSchema } from \"@openpond/evals/learning\";\nimport { TrainingHandoffOriginSchema } from \"@openpond/evals/learning\";\nexport { TrainingHandoffOriginSchema, type TrainingHandoffOrigin } from \"@openpond/evals/learning\";\nimport { RunExperimentSchema } from \"./experiment-run-contracts.js\";\nimport { canonicalSha256, OpenPondProtocolError } from \"./protocol.js\";\n\nconst Id = z.string().trim().min(1).max(200);\nconst Hash = z.string().regex(/^[a-f0-9]{64}$/);\nconst Ref = z.object({ id: Id, contentHash: Hash }).strict();\nexport const TrainingHandoffContextSchema = z\n  .object({\n    available: z.boolean(),\n    reason: z.string().max(1000).nullable(),\n    origin: TrainingHandoffOriginSchema.nullable(),\n  })\n  .strict();\nexport type TrainingHandoffContext = z.infer<typeof TrainingHandoffContextSchema>;\nexport const PostTrainingAttachmentSchema = z\n  .object({\n    schemaVersion: z.literal(\"openpond.postTrainingAttachment.v1\"),\n    binding: z\n      .object({\n        kind: z.enum([\"preparation\", \"policy\"]),\n        id: Id,\n        revision: z.number().int().positive(),\n        contentHash: Hash,\n      })\n      .strict(),\n    projectId: Id.nullable(),\n    automatic: z.boolean(),\n    maximumSpendUsd: z.number().finite().positive().max(10_000),\n    experiments: z\n      .array(z.object({ id: Id, configuration: RunExperimentSchema }).strict())\n      .min(1)\n      .max(20),\n    acceptancePlan: AcceptancePlanSchema.nullable(),\n  })\n  .strict()\n  .superRefine((value, ctx) => {\n    if (new Set(value.experiments.map((item) => item.id)).size !== value.experiments.length)\n      ctx.addIssue({ code: \"custom\", message: \"Attach each evaluation once.\" });\n    if (\n      value.experiments.reduce((sum, item) => sum + item.configuration.maximumCostUsd, 0) >\n      value.maximumSpendUsd + 1e-9\n    )\n      ctx.addIssue({\n        code: \"custom\",\n        message: \"Attached evaluation budgets exceed the total approved budget.\",\n      });\n    if (\n      value.experiments.some(\n        (item) => (item.configuration.request.project?.id ?? null) !== value.projectId,\n      )\n    )\n      ctx.addIssue({\n        code: \"custom\",\n        message: \"Attached experiments must use the training Project.\",\n      });\n    if (value.acceptancePlan) {\n      const checked = new Set(value.acceptancePlan.checks.map((c) => c.id));\n      if (value.acceptancePlan.checks.some((c) => !value.experiments.some((m) => m.id === c.id)))\n        ctx.addIssue({\n          code: \"custom\",\n          message: \"Select the frozen Experiment for each acceptance check.\",\n        });\n      const committed =\n        value.acceptancePlan.maximumSpendUsd +\n        value.experiments\n          .filter((m) => !checked.has(m.id))\n          .reduce((sum, m) => sum + m.configuration.maximumCostUsd, 0);\n      if (committed > value.maximumSpendUsd + 1e-9)\n        ctx.addIssue({\n          code: \"custom\",\n          message:\n            \"Paired acceptance and diagnostic ceilings exceed the approved evaluation budget.\",\n        });\n    }\n  });\nexport type PostTrainingAttachment = z.infer<typeof PostTrainingAttachmentSchema>;\n/** Target-independent recipe pins keep the paired baseline/candidate check on\n * the same released data, case order, settings and graders. */\nexport function postTrainingRecipe(\n  configuration: PostTrainingAttachment[\"experiments\"][number][\"configuration\"],\n) {\n  const {\n    modelId: _model,\n    candidate: _candidate,\n    ...settings\n  } = configuration.request.policy.kind === \"fixture\"\n    ? { modelId: null, candidate: null, ...configuration.request.policy }\n    : configuration.request.policy;\n  void _model;\n  void _candidate;\n  if (\"modelConfigurationHash\" in settings)\n    delete (settings as { modelConfigurationHash?: string }).modelConfigurationHash;\n  return {\n    dataset: {\n      id: configuration.request.taskset.id,\n      contentHash: configuration.request.taskset.contentHash,\n    },\n    populationHash: contentHash(\n      configuration.request.population.map((m) => ({\n        caseId: m.taskId,\n        seed: m.seed,\n        fixtureId: m.fixtureId,\n      })),\n    ),\n    executionHash: contentHash({ settings, graders: configuration.graders ?? null }),\n  };\n}\nexport const PostTrainingQualificationSchema = z\n  .object({\n    baseline: Ref,\n    checks: z\n      .array(\n        z\n          .object({\n            id: Id,\n            sourceRunId: Id,\n            sourceManifestHash: Hash,\n            targetConfigurationHash: Hash,\n            executionHash: Hash,\n            populationHash: Hash,\n            evaluator: Ref,\n            feedbackKey: Id,\n            output: z.enum([\"boolean\", \"score\"]),\n            unit: z.string().min(1).max(80),\n          })\n          .strict(),\n      )\n      .min(1)\n      .max(100),\n  })\n  .strict();\nexport const PostTrainingStateSchema = z.enum([\n  \"waiting_for_training\",\n  \"ready\",\n  \"preparing\",\n  \"queued\",\n  \"running\",\n  \"cleaning\",\n  \"completed\",\n  \"failed\",\n  \"blocked\",\n  \"cancelled\",\n  \"budget_exhausted\",\n]);\nexport const PostTrainingSummarySchema = z\n  .object({\n    schemaVersion: z.literal(\"openpond.postTrainingSummary.v1\"),\n    id: Id,\n    teamId: Id,\n    jobId: Id,\n    revision: z.number().int().positive(),\n    planHash: Hash,\n    automatic: z.boolean(),\n    candidate: Ref.nullable(),\n    state: PostTrainingStateSchema,\n    total: z.number().int().positive(),\n    completed: z.number().int().nonnegative(),\n    failed: z.number().int().nonnegative(),\n    requiredOutcome: z.enum([\"none\", \"pending\", \"passed\", \"failed\", \"blocked\"]),\n    reason: z.string().max(500).nullable(),\n    groupId: Id.nullable(),\n    experimentIds: z.array(Id).max(20),\n    updatedAt: z.iso.datetime(),\n  })\n  .strict()\n  .superRefine((value, ctx) => {\n    if (value.completed + value.failed > value.total)\n      ctx.addIssue({ code: \"custom\", message: \"Evaluation totals are inconsistent.\" });\n    if (\n      [\"preparing\", \"queued\", \"running\", \"cleaning\", \"completed\"].includes(value.state) &&\n      !value.candidate\n    )\n      ctx.addIssue({\n        code: \"custom\",\n        message: \"Evaluation execution requires the exact trained candidate.\",\n      });\n  });\nexport type PostTrainingSummary = z.infer<typeof PostTrainingSummarySchema>;\nexport const PostTrainingControlSchema = z\n  .object({ operationId: Id, expectedRevision: z.number().int().positive(), planHash: Hash })\n  .strict();\nexport const AttachPostTrainingSchema = z\n  .object({ operationId: Id, attachment: PostTrainingAttachmentSchema })\n  .strict();\nexport const PostTrainingPlanSchema = z\n  .object({\n    id: Id,\n    teamId: Id,\n    ownerUserId: Id,\n    attachment: PostTrainingAttachmentSchema,\n    qualification: PostTrainingQualificationSchema.nullable(),\n    contentHash: Hash,\n    createdAt: z.iso.datetime(),\n  })\n  .strict();\nexport type PostTrainingPlan = z.infer<typeof PostTrainingPlanSchema>;\nexport function verifyPostTrainingPlan(raw: unknown): PostTrainingPlan {\n  const plan = PostTrainingPlanSchema.parse(raw);\n  if (\n    plan.contentHash !==\n    contentHash({ attachment: plan.attachment, qualification: plan.qualification })\n  )\n    throw new Error(\"The retained evaluation attachment or qualification changed.\");\n  return plan;\n}\nexport function postTrainingActive(summary: PostTrainingSummary | null | undefined) {\n  return Boolean(summary && [\"preparing\", \"queued\", \"running\", \"cleaning\"].includes(summary.state));\n}\n\n/** Read/setup are configuration-only. Manual start authorizes exactly the\n * retained candidate, plan and revision. A retry never launches training. */\nexport function createPostTrainingClient(input: {\n  request: (path: string, init?: RequestInit) => Promise<unknown>;\n}) {\n  const { request } = input;\n  // These public evaluation routes consume ordinary JSON, independently of\n  // the versioned Training V2 job routes used by the parent factory.\n  const headers = { accept: \"application/json\", \"content-type\": \"application/json\" };\n  const path = (jobId: string) =>\n    `/v1/training/jobs/${encodeURIComponent(Id.parse(jobId))}/post-training`;\n  async function read(raw: unknown, teamId: string, jobId: string) {\n    if (raw === null) return null;\n    const value = PostTrainingSummarySchema.parse(raw);\n    if (value.teamId !== teamId || value.jobId !== jobId)\n      throw new OpenPondProtocolError(\n        \"post_training_scope_mismatch\",\n        \"The evaluation summary belongs to another run or workspace.\",\n      );\n    return value;\n  }\n  return {\n    async attach(teamId: string, raw: z.input<typeof AttachPostTrainingSchema>) {\n      const body = AttachPostTrainingSchema.parse(raw);\n      const value = verifyPostTrainingPlan(\n        await request(\"/v1/training/post-training-plans\", {\n          method: \"POST\",\n          headers,\n          body: JSON.stringify(body),\n        }),\n      );\n      if (\n        value.teamId !== teamId ||\n        (await canonicalSha256(value.attachment)) !== (await canonicalSha256(body.attachment))\n      )\n        throw new OpenPondProtocolError(\n          \"post_training_plan_mismatch\",\n          \"The retained attachment differs from the reviewed plan.\",\n        );\n      return value;\n    },\n    async get(teamId: string, jobId: string) {\n      return read(await request(path(jobId), { headers }), teamId, jobId);\n    },\n    async control(\n      teamId: string,\n      jobId: string,\n      action: \"start\" | \"retry\" | \"cancel\",\n      raw: z.input<typeof PostTrainingControlSchema>,\n    ) {\n      const body = PostTrainingControlSchema.parse(raw);\n      const value = await read(\n        await request(`${path(jobId)}/${action}`, { method: \"POST\", headers, body: JSON.stringify(body) }),\n        teamId,\n        jobId,\n      );\n      if (!value || value.planHash !== body.planHash)\n        throw new OpenPondProtocolError(\n          \"post_training_control_mismatch\",\n          \"Evaluation control did not retain the approved plan.\",\n        );\n      return value;\n    },\n  };\n}\n\nexport const HostedTrainingSetupCatalogSchema = z\n  .object({\n    teamId: Id,\n    actorId: Id,\n    projectId: Id.nullable(),\n    configuration: HostedModelProjectSummarySchema,\n    batches: z.array(TaskBatchSchema).max(10_000),\n    sources: z.array(LearningSourceSchema).max(10_000),\n    definitions: z.array(TaskDefinitionSchema).max(10_000),\n    experiments: z\n      .array(\n        z\n          .object({\n            id: Id,\n            name: z.string().max(500),\n            configuration: RunExperimentSchema,\n            graders: z\n              .array(z.object({ feedbackKey: Id, name: z.string().max(500), ref: Ref }).strict())\n              .max(100),\n          })\n          .strict(),\n      )\n      .max(10_000),\n  })\n  .strict();\nexport type HostedTrainingSetupCatalog = z.infer<typeof HostedTrainingSetupCatalogSchema>;\n\nexport const HostedTrainingSetupActionSchema = z.enum([\n  \"prepare\",\n  \"start\",\n  \"cancel\",\n  \"publish\",\n  \"attach\",\n]);\nexport type HostedTrainingSetupAction = z.infer<typeof HostedTrainingSetupActionSchema>;\n\nexport const HostedTrainingPolicyDetailSchema = z\n  .object({\n    teamId: Id,\n    actorId: Id,\n    configuration: HostedModelProjectSummarySchema,\n    policy: LearningPolicySchema,\n    inspection: LearningPolicyInspectionResultSchema,\n    iterations: z\n      .array(\n        z\n          .object({\n            iteration: LearningIterationSchema,\n            evals: PostTrainingSummarySchema.nullable(),\n          })\n          .strict(),\n      )\n      .max(100),\n    nextCursor: Id.nullable(),\n  })\n  .strict();\nexport const HostedTrainingPolicyControlSchema = z\n  .object({\n    id: Id,\n    expectedRevision: z.number().int().positive(),\n    policyHash: Hash,\n    operationId: Id,\n    action: z.enum([\"pause\", \"resume\", \"reserve\", \"cancel-iteration\", \"retry-iteration\"]),\n    iterationId: Id.optional(),\n    iterationRevision: z.number().int().positive().optional(),\n  })\n  .strict();\nexport type HostedTrainingPolicyControl = z.infer<typeof HostedTrainingPolicyControlSchema>;\n"],"mappings":"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","names":["TrainingHandoffOriginSchema"]}

package/dist/chunk-B3ZHJ2KK.js

@@ -0,0 +1,152 @@
+// src/protocol.ts
+var OPENPOND_TRAINING_PROTOCOL_MAJOR = 2;
+var OPENPOND_TRAINING_MEDIA_TYPE = "application/vnd.openpond.training+json;version=2";
+var OPENPOND_MODEL_PROJECT_MEDIA_TYPE = "application/vnd.openpond.model-project+json;version=2";
+var TRAINING_JOB_SUBMISSION_MAX_BYTES = 1048576;
+var TRAINING_INPUT_ARTIFACT_MAX_BYTES = 67108864;
+var TRAINING_API_RESPONSE_MAX_BYTES = 8388608;
+var MODEL_PROJECT_SYNC_MAX_BYTES = 524288;
+var MODEL_PROJECT_API_RESPONSE_MAX_BYTES = 8388608;
+var OpenPondProtocolError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "OpenPondProtocolError";
+    this.code = code;
+  }
+};
+function canonicalJson(value) {
+  return JSON.stringify(normalizeCanonicalJson(value));
+}
+function canonicalJsonByteLength(value) {
+  return new TextEncoder().encode(canonicalJson(value)).byteLength;
+}
+async function canonicalSha256(value) {
+  const bytes = new TextEncoder().encode(canonicalJson(value));
+  const digest = await globalThis.crypto.subtle.digest("SHA-256", bytes);
+  return Array.from(
+    new Uint8Array(digest),
+    (byte) => byte.toString(16).padStart(2, "0")
+  ).join("");
+}
+function assertCanonicalPayloadSize(value, maximumBytes, label) {
+  const actualBytes = canonicalJsonByteLength(value);
+  if (actualBytes > maximumBytes) {
+    throw new OpenPondProtocolError(
+      "payload_too_large",
+      `${label} is ${actualBytes} bytes; the maximum is ${maximumBytes} bytes.`
+    );
+  }
+}
+function parseBoundedJson(text, maximumBytes, label) {
+  const actualBytes = new TextEncoder().encode(text).byteLength;
+  if (actualBytes > maximumBytes) {
+    throw new OpenPondProtocolError(
+      "response_too_large",
+      `${label} is ${actualBytes} bytes; the maximum is ${maximumBytes} bytes.`
+    );
+  }
+  try {
+    return JSON.parse(text);
+  } catch {
+    throw new OpenPondProtocolError(
+      "invalid_json",
+      `${label} was not valid JSON.`
+    );
+  }
+}
+async function readBoundedJsonResponse(response, maximumBytes, label) {
+  const reader = response.body?.getReader();
+  if (!reader) return parseBoundedJson("", maximumBytes, label);
+  const decoder = new TextDecoder();
+  let bytes = 0;
+  let text = "";
+  try {
+    for (; ; ) {
+      const chunk = await reader.read();
+      if (chunk.done) break;
+      bytes += chunk.value.byteLength;
+      if (bytes > maximumBytes) {
+        throw new OpenPondProtocolError(
+          "response_too_large",
+          `${label} exceeds the maximum of ${maximumBytes} bytes.`
+        );
+      }
+      text += decoder.decode(chunk.value, { stream: true });
+    }
+    text += decoder.decode();
+    return parseBoundedJson(text, maximumBytes, label);
+  } catch (error) {
+    try {
+      await reader.cancel();
+    } catch {
+    }
+    throw error;
+  } finally {
+    try {
+      reader.releaseLock();
+    } catch {
+    }
+  }
+}
+function normalizeCanonicalJson(value) {
+  if (value === null || typeof value === "string" || typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) {
+      throw new OpenPondProtocolError(
+        "non_json_value",
+        "Canonical JSON cannot contain a non-finite number."
+      );
+    }
+    return Object.is(value, -0) ? 0 : value;
+  }
+  if (Array.isArray(value)) {
+    return value.map((entry) => normalizeCanonicalJson(entry));
+  }
+  if (typeof value === "object") {
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null) {
+      throw new OpenPondProtocolError(
+        "non_json_value",
+        "Canonical JSON accepts only plain objects."
+      );
+    }
+    const result = /* @__PURE__ */ Object.create(null);
+    for (const key of Object.keys(value).sort()) {
+      const entry = value[key];
+      if (entry === void 0 || typeof entry === "function" || typeof entry === "symbol") {
+        throw new OpenPondProtocolError(
+          "non_json_value",
+          `Canonical JSON cannot contain ${typeof entry} at ${key}.`
+        );
+      }
+      result[key] = normalizeCanonicalJson(entry);
+    }
+    return result;
+  }
+  throw new OpenPondProtocolError(
+    "non_json_value",
+    `Canonical JSON cannot contain ${typeof value}.`
+  );
+}
+
+export {
+  OPENPOND_TRAINING_PROTOCOL_MAJOR,
+  OPENPOND_TRAINING_MEDIA_TYPE,
+  OPENPOND_MODEL_PROJECT_MEDIA_TYPE,
+  TRAINING_JOB_SUBMISSION_MAX_BYTES,
+  TRAINING_INPUT_ARTIFACT_MAX_BYTES,
+  TRAINING_API_RESPONSE_MAX_BYTES,
+  MODEL_PROJECT_SYNC_MAX_BYTES,
+  MODEL_PROJECT_API_RESPONSE_MAX_BYTES,
+  OpenPondProtocolError,
+  canonicalJson,
+  canonicalJsonByteLength,
+  canonicalSha256,
+  assertCanonicalPayloadSize,
+  parseBoundedJson,
+  readBoundedJsonResponse
+};
+//# sourceMappingURL=chunk-B3ZHJ2KK.js.map

package/dist/chunk-B3ZHJ2KK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol.ts"],"sourcesContent":["export type CanonicalJsonValue =\n  | null\n  | boolean\n  | number\n  | string\n  | CanonicalJsonValue[]\n  | { [key: string]: CanonicalJsonValue };\n\nexport const OPENPOND_TRAINING_PROTOCOL_MAJOR = 2 as const;\nexport const OPENPOND_TRAINING_MEDIA_TYPE =\n  \"application/vnd.openpond.training+json;version=2\" as const;\nexport const OPENPOND_MODEL_PROJECT_MEDIA_TYPE =\n  \"application/vnd.openpond.model-project+json;version=2\" as const;\n\nexport const TRAINING_JOB_SUBMISSION_MAX_BYTES = 1_048_576;\nexport const TRAINING_INPUT_ARTIFACT_MAX_BYTES = 67_108_864;\nexport const TRAINING_API_RESPONSE_MAX_BYTES = 8_388_608;\nexport const MODEL_PROJECT_SYNC_MAX_BYTES = 524_288;\nexport const MODEL_PROJECT_API_RESPONSE_MAX_BYTES = 8_388_608;\n\nexport class OpenPondProtocolError extends Error {\n  readonly code: string;\n\n  constructor(code: string, message: string) {\n    super(message);\n    this.name = \"OpenPondProtocolError\";\n    this.code = code;\n  }\n}\n\n/**\n * Deterministic JSON used for content-addressed OpenPond protocol objects.\n * Object keys are sorted by Unicode code point, arrays retain their authored\n * order, and non-JSON/non-finite values are rejected rather than coerced.\n */\nexport function canonicalJson(value: unknown): string {\n  return JSON.stringify(normalizeCanonicalJson(value));\n}\n\nexport function canonicalJsonByteLength(value: unknown): number {\n  return new TextEncoder().encode(canonicalJson(value)).byteLength;\n}\n\nexport async function canonicalSha256(value: unknown): Promise<string> {\n  const bytes = new TextEncoder().encode(canonicalJson(value));\n  const digest = await globalThis.crypto.subtle.digest(\"SHA-256\", bytes);\n  return Array.from(new Uint8Array(digest), (byte) =>\n    byte.toString(16).padStart(2, \"0\"),\n  ).join(\"\");\n}\n\nexport function assertCanonicalPayloadSize(\n  value: unknown,\n  maximumBytes: number,\n  label: string,\n): void {\n  const actualBytes = canonicalJsonByteLength(value);\n  if (actualBytes > maximumBytes) {\n    throw new OpenPondProtocolError(\n      \"payload_too_large\",\n      `${label} is ${actualBytes} bytes; the maximum is ${maximumBytes} bytes.`,\n    );\n  }\n}\n\nexport function parseBoundedJson(\n  text: string,\n  maximumBytes: number,\n  label: string,\n): unknown {\n  const actualBytes = new TextEncoder().encode(text).byteLength;\n  if (actualBytes > maximumBytes) {\n    throw new OpenPondProtocolError(\n      \"response_too_large\",\n      `${label} is ${actualBytes} bytes; the maximum is ${maximumBytes} bytes.`,\n    );\n  }\n  try {\n    return JSON.parse(text) as unknown;\n  } catch {\n    throw new OpenPondProtocolError(\n      \"invalid_json\",\n      `${label} was not valid JSON.`,\n    );\n  }\n}\n\n/** Bound the wire body while consuming it, before allocating the complete JSON\n * string. Reader cleanup must never replace the original transport/JSON error. */\nexport async function readBoundedJsonResponse(\n  response: Response,\n  maximumBytes: number,\n  label: string,\n): Promise<unknown> {\n  const reader = response.body?.getReader();\n  if (!reader) return parseBoundedJson(\"\", maximumBytes, label);\n  const decoder = new TextDecoder();\n  let bytes = 0;\n  let text = \"\";\n  try {\n    for (;;) {\n      const chunk = await reader.read();\n      if (chunk.done) break;\n      bytes += chunk.value.byteLength;\n      if (bytes > maximumBytes) {\n        throw new OpenPondProtocolError(\n          \"response_too_large\",\n          `${label} exceeds the maximum of ${maximumBytes} bytes.`,\n        );\n      }\n      text += decoder.decode(chunk.value, { stream: true });\n    }\n    text += decoder.decode();\n    return parseBoundedJson(text, maximumBytes, label);\n  } catch (error) {\n    try { await reader.cancel(); } catch { /* Preserve the primary failure. */ }\n    throw error;\n  } finally {\n    try { reader.releaseLock(); } catch { /* Never mask a transport/parse failure. */ }\n  }\n}\n\nfunction normalizeCanonicalJson(value: unknown): CanonicalJsonValue {\n  if (\n    value === null ||\n    typeof value === \"string\" ||\n    typeof value === \"boolean\"\n  ) {\n    return value;\n  }\n  if (typeof value === \"number\") {\n    if (!Number.isFinite(value)) {\n      throw new OpenPondProtocolError(\n        \"non_json_value\",\n        \"Canonical JSON cannot contain a non-finite number.\",\n      );\n    }\n    return Object.is(value, -0) ? 0 : value;\n  }\n  if (Array.isArray(value)) {\n    return value.map((entry) => normalizeCanonicalJson(entry));\n  }\n  if (typeof value === \"object\") {\n    const prototype = Object.getPrototypeOf(value);\n    if (prototype !== Object.prototype && prototype !== null) {\n      throw new OpenPondProtocolError(\n        \"non_json_value\",\n        \"Canonical JSON accepts only plain objects.\",\n      );\n    }\n    const result: Record<string, CanonicalJsonValue> = Object.create(null);\n    for (const key of Object.keys(value as Record<string, unknown>).sort()) {\n      const entry = (value as Record<string, unknown>)[key];\n      if (entry === undefined || typeof entry === \"function\" || typeof entry === \"symbol\") {\n        throw new OpenPondProtocolError(\n          \"non_json_value\",\n          `Canonical JSON cannot contain ${typeof entry} at ${key}.`,\n        );\n      }\n      result[key] = normalizeCanonicalJson(entry);\n    }\n    return result;\n  }\n  throw new OpenPondProtocolError(\n    \"non_json_value\",\n    `Canonical JSON cannot contain ${typeof value}.`,\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-D3WOJTUY.js → chunk-C3TS766N.js}

@@ -1,58 +1,17 @@
 import {
-  ReleaseIdSchema
-} from "./chunk-H3JZ3P5T.js";
-
-// src/learning-credentials.ts
-import { z } from "zod";
-import { LearningRevisionRefSchema } from "@openpond/evals/learning";
-import { TaskSplitSchema } from "@openpond/evals/tasksets";
-var LearningSourceCredentialSchema = z.object({
-  id: ReleaseIdSchema,
-  scope: ReleaseIdSchema,
-  sourceId: ReleaseIdSchema,
-  name: z.string().trim().min(1).max(100),
-  keyPrefix: z.string().min(1).max(100),
-  createdAt: z.iso.datetime(),
-  expiresAt: z.iso.datetime(),
-  revokedAt: z.iso.datetime().nullable()
-}).strict();
-var LearningSourceCredentialSecretSchema = z.string().regex(/^opk_key_[A-Za-z0-9]{16}_[A-Za-z0-9]{48}$/);
-var LearningSourceCredentialRequestSchema = z.discriminatedUnion("action", [
-  z.object({ action: z.literal("create"), scope: ReleaseIdSchema, sourceId: ReleaseIdSchema, name: z.string().trim().min(1).max(100), expiresAt: z.iso.datetime(), operationId: ReleaseIdSchema, apiKey: LearningSourceCredentialSecretSchema }).strict(),
-  z.object({ action: z.literal("list"), scope: ReleaseIdSchema, sourceId: ReleaseIdSchema, afterId: ReleaseIdSchema.optional(), limit: z.number().int().min(1).max(100).default(30) }).strict(),
-  z.object({ action: z.literal("revoke"), scope: ReleaseIdSchema, sourceId: ReleaseIdSchema, id: ReleaseIdSchema }).strict()
-]);
-var LearningSourceCredentialCreatedSchema = z.object({ credential: LearningSourceCredentialSchema, apiKey: LearningSourceCredentialSecretSchema }).strict();
-var LearningSourceCredentialPageSchema = z.object({ items: z.array(LearningSourceCredentialSchema).max(100), nextCursor: ReleaseIdSchema.nullable() }).strict();
-var LearningSourceConfigurationRequestSchema = z.object({ scope: ReleaseIdSchema, sourceId: ReleaseIdSchema }).strict();
-var LearningSourceConfigurationSchema = z.object({
-  scope: ReleaseIdSchema,
-  source: LearningRevisionRefSchema,
-  taskDefinition: LearningRevisionRefSchema,
-  enabled: z.boolean(),
-  allowedSplits: z.array(TaskSplitSchema).min(1).max(4)
-}).strict();
-function createSourceCredentialRequest(input) {
-  return { ...input, operationId: crypto.randomUUID(), apiKey: `opk_key_${randomToken(16)}_${randomToken(48)}` };
-}
-function randomToken(length) {
-  const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
-  let value = "";
-  while (value.length < length) {
-    for (const byte of crypto.getRandomValues(new Uint8Array(64))) {
-      if (byte < 248) value += alphabet[byte % 62];
-      if (value.length === length) return value;
-    }
-  }
-  return value;
-}
-function assertLearningCredentialExpiry(expiresAt, now) {
-  const expires = Date.parse(z.iso.datetime().parse(expiresAt));
-  if (expires <= now.getTime() || expires > now.getTime() + 90 * 24 * 60 * 60 * 1e3) throw new Error("Source credentials must expire within 90 days.");
-}
+  OpenPondLearningError
+} from "./chunk-U2KGUAIS.js";
+import {
+  LearningSourceConfigurationRequestSchema,
+  LearningSourceConfigurationSchema,
+  LearningSourceCredentialCreatedSchema,
+  LearningSourceCredentialPageSchema,
+  LearningSourceCredentialRequestSchema,
+  LearningSourceCredentialSchema
+} from "./chunk-IZ26ZCGU.js";
 
 // src/learning-client.ts
-import { z as z2 } from "zod";
+import { z } from "zod";
 import {
   LearningCommandRequestSchema,
   LearningOperationResultSchema,
@@ -65,30 +24,18 @@ import {
   learningResourceSchemas
 } from "@openpond/evals/learning";
 import { assertBoundedTaskJson } from "@openpond/evals/task-schema";
-var LearningBatchPublicationSchema = z2.object({
-  batchId: z2.string().trim().min(1).max(500),
-  modelProjectId: z2.string().trim().min(1).max(500)
+var LearningBatchPublicationSchema = z.object({
+  batchId: z.string().trim().min(1).max(500),
+  modelProjectId: z.string().trim().min(1).max(500)
 }).strict();
-var LearningBatchPublicationResultSchema = z2.object({
-  batchId: z2.string().min(1),
-  projectId: z2.string().min(1),
-  tasksetId: z2.string().min(1),
-  releaseId: z2.string().min(1),
-  revision: z2.number().int().positive(),
-  contentHash: z2.string().regex(/^[a-f0-9]{64}$/)
+var LearningBatchPublicationResultSchema = z.object({
+  batchId: z.string().min(1),
+  projectId: z.string().min(1),
+  tasksetId: z.string().min(1),
+  releaseId: z.string().min(1),
+  revision: z.number().int().positive(),
+  contentHash: z.string().regex(/^[a-f0-9]{64}$/)
 }).strict();
-var OpenPondLearningError = class extends Error {
-  constructor(status, code, message, details) {
-    super(message);
-    this.status = status;
-    this.code = code;
-    this.details = details;
-    this.name = "OpenPondLearningError";
-  }
-  status;
-  code;
-  details;
-};
 var OpenPondLearningClient = class {
   #options;
   constructor(options) {
@@ -167,7 +114,7 @@ var OpenPondLearningClient = class {
   }
   async list(kind, query = {}, options = {}) {
     const request = LearningReadRequestSchema.parse({ action: "list", scope: this.#options.scope, kind, ...query });
-    return z2.object({ items: z2.array(learningResourceSchemas[kind]).max(100), nextCursor: z2.string().nullable() }).strict().parse(await this.#request("read", request, options));
+    return z.object({ items: z.array(learningResourceSchemas[kind]).max(100), nextCursor: z.string().nullable() }).strict().parse(await this.#request("read", request, options));
   }
   /** Hosted publication only: stores an immutable package and attaches it, without starting training. */
   async publishBatch(input, options = {}) {
@@ -187,7 +134,7 @@ var OpenPondLearningClient = class {
     });
     const payload = await readBoundedLearningResponse(response);
     if (!response.ok) {
-      const error = z2.object({ code: z2.string().optional(), error: z2.string().optional() }).passthrough().safeParse(payload);
+      const error = z.object({ code: z.string().optional(), error: z.string().optional() }).passthrough().safeParse(payload);
       throw new OpenPondLearningError(response.status, error.success ? error.data.code ?? "learning_request_failed" : "learning_request_failed", error.success ? error.data.error ?? `Learning request failed (${response.status}).` : `Learning request failed (${response.status}).`, payload);
     }
     return payload;
@@ -219,19 +166,9 @@ async function readBoundedLearningResponse(response) {
 }
 
 export {
-  LearningSourceCredentialSchema,
-  LearningSourceCredentialSecretSchema,
-  LearningSourceCredentialRequestSchema,
-  LearningSourceCredentialCreatedSchema,
-  LearningSourceCredentialPageSchema,
-  LearningSourceConfigurationRequestSchema,
-  LearningSourceConfigurationSchema,
-  createSourceCredentialRequest,
-  assertLearningCredentialExpiry,
   LearningBatchPublicationSchema,
   LearningBatchPublicationResultSchema,
-  OpenPondLearningError,
   OpenPondLearningClient,
   readBoundedLearningResponse
 };
-//# sourceMappingURL=chunk-D3WOJTUY.js.map
+//# sourceMappingURL=chunk-C3TS766N.js.map

package/dist/chunk-C3TS766N.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/learning-client.ts"],"sourcesContent":["import { OpenPondLearningError } from \"./learning-error.js\";\nexport { OpenPondLearningError } from \"./learning-error.js\";\nimport { z } from \"zod\";\nimport {\n  LearningCommandRequestSchema, LearningOperationResultSchema, LearningReadRequestSchema,\n  TaskEvidenceInspectionResultSchema, sameLearningRef, type LearningRevisionRef,\n  LearningPolicyInspectionResultSchema,\n  LearningTaskQueueInspectionSchema,\n  assertLearningRequestJson,\n  learningResourceSchemas, type LearningCommand, type LearningOperationResult,\n  type LearningResourceFor, type LearningResourceKind, type LearningResourcePage,\n  type LearningResourceQuery, type TaskExampleSubmission, type TaskFeedbackSubmission,\n} from \"@openpond/evals/learning\";\nimport { assertBoundedTaskJson } from \"@openpond/evals/task-schema\";\nimport { LearningSourceCredentialSchema, LearningSourceCredentialRequestSchema, LearningSourceCredentialCreatedSchema, LearningSourceCredentialPageSchema, LearningSourceConfigurationRequestSchema, LearningSourceConfigurationSchema, type LearningSourceCredentialRequest } from \"./learning-credentials.js\";\n\nexport interface OpenPondLearningClientOptions {\n  apiKey: string;\n  baseUrl: string;\n  /** Local profile or hosted team scope. The server checks the credential's ownership. */\n  scope: string;\n  fetch?: typeof globalThis.fetch;\n}\nexport interface LearningRequestOptions { signal?: AbortSignal }\nexport const LearningBatchPublicationSchema = z.object({\n  batchId: z.string().trim().min(1).max(500), modelProjectId: z.string().trim().min(1).max(500),\n}).strict();\nexport const LearningBatchPublicationResultSchema = z.object({\n  batchId: z.string().min(1), projectId: z.string().min(1), tasksetId: z.string().min(1),\n  releaseId: z.string().min(1), revision: z.number().int().positive(), contentHash: z.string().regex(/^[a-f0-9]{64}$/),\n}).strict();\n/** The same portable commands are sent to the local and hosted execution owner. */\nexport class OpenPondLearningClient {\n  readonly #options: OpenPondLearningClientOptions;\n  constructor(options: OpenPondLearningClientOptions) {\n    if (!options.apiKey.trim() || !options.scope.trim()) throw new Error(\"Learning API key and scope are required.\");\n    const url = new URL(options.baseUrl);\n    if (![\"http:\", \"https:\"].includes(url.protocol) || url.username || url.password || url.search || url.hash) throw new Error(\"Learning base URL must be an HTTP(S) endpoint without credentials, query, or fragment.\");\n    this.#options = { ...options, baseUrl: url.toString().replace(/\\/+$/, \"\") };\n  }\n\n  async command(command: LearningCommand, options: LearningRequestOptions = {}): Promise<LearningOperationResult> {\n    assertLearningRequestJson(command);\n    const request = LearningCommandRequestSchema.parse({ scope: this.#options.scope, command });\n    const result = LearningOperationResultSchema.parse(await this.#request(\"commands\", request, options));\n    if (result.operationId !== command.operationId) throw new OpenPondLearningError(502, \"operation_identity_mismatch\", \"Learning response did not match the submitted operation.\", null);\n    return result;\n  }\n\n  submitExample(example: TaskExampleSubmission, options: LearningRequestOptions = {}) {\n    return this.command({ action: \"submit_example\", operationId: example.idempotencyKey, example }, options);\n  }\n\n  submitFeedback(feedback: TaskFeedbackSubmission, options: LearningRequestOptions = {}) {\n    return this.command({ action: \"submit_feedback\", operationId: feedback.idempotencyKey, feedback }, options);\n  }\n\n  async get<K extends LearningResourceKind>(kind: K, id: string, revision?: number, options: LearningRequestOptions = {}): Promise<LearningResourceFor<K>> {\n    const request = LearningReadRequestSchema.parse({ action: \"get\", scope: this.#options.scope, kind, id, ...(revision === undefined ? {} : { revision }) });\n    return learningResourceSchemas[kind].parse(await this.#request(\"read\", request, options)) as LearningResourceFor<K>;\n  }\n\n  async inspectEvidence(evidence: LearningRevisionRef, options: LearningRequestOptions = {}) {\n    const request = LearningReadRequestSchema.parse({ action: \"inspect_evidence\", scope: this.#options.scope, evidence });\n    const result = TaskEvidenceInspectionResultSchema.parse(await this.#request(\"read\", request, options));\n    if (!sameLearningRef(result.evidence, evidence)) throw new OpenPondLearningError(502, \"evidence_identity_mismatch\", \"Inspection did not match the requested evidence release.\", null);\n    return result;\n  }\n\n  /** Read current shared eligibility and budget without reserving or launching work. */\n  async inspectTaskQueue(modelProjectId: string | null = null, options: LearningRequestOptions = {}) {\n    const request = LearningReadRequestSchema.parse({ action: \"inspect_task_queue\", scope: this.#options.scope, modelProjectId });\n    const result = LearningTaskQueueInspectionSchema.parse(await this.#request(\"read\", request, options));\n    if (result.modelProjectId !== modelProjectId) throw new OpenPondLearningError(502, \"model_identity_mismatch\", \"Task queue did not match the requested Model.\", null);\n    return result;\n  }\n\n  /** Read current shared eligibility and budget without reserving or launching work. */\n  async inspectPolicy(policy: LearningRevisionRef, options: LearningRequestOptions = {}) {\n    const request = LearningReadRequestSchema.parse({ action: \"inspect_policy\", scope: this.#options.scope, policy });\n    const result = LearningPolicyInspectionResultSchema.parse(await this.#request(\"read\", request, options));\n    if (!sameLearningRef(result.policy, policy)) throw new OpenPondLearningError(502, \"policy_identity_mismatch\", \"Inspection did not match the requested policy release.\", null);\n    return result;\n  }\n\n  /** Prepare once with createSourceCredentialRequest and reuse it for retries. */\n  async createSourceCredential(input: Omit<Extract<LearningSourceCredentialRequest, { action: \"create\" }>, \"action\" | \"scope\">, options: LearningRequestOptions = {}) {\n    const request = LearningSourceCredentialRequestSchema.parse({ ...input, action: \"create\", scope: this.#options.scope });\n    const result = LearningSourceCredentialCreatedSchema.parse(await this.#request(\"credentials\", request, options));\n    this.#assertCredentialScope(result.credential, input.sourceId);\n    if (result.apiKey !== input.apiKey || !input.apiKey.startsWith(`${result.credential.keyPrefix}_`)) throw new OpenPondLearningError(502, \"credential_identity_mismatch\", \"Credential response did not match the prepared credential.\", null);\n    return result;\n  }\n\n  async listSourceCredentials(sourceId: string, query: { afterId?: string; limit?: number } = {}, options: LearningRequestOptions = {}) {\n    const request = LearningSourceCredentialRequestSchema.parse({ ...query, action: \"list\", scope: this.#options.scope, sourceId });\n    const result = LearningSourceCredentialPageSchema.parse(await this.#request(\"credentials\", request, options));\n    if (result.items.length > (query.limit ?? 30)) throw new OpenPondLearningError(502, \"credential_page_invalid\", \"Credential response exceeded the requested page size.\", null);\n    for (const item of result.items) this.#assertCredentialScope(item, sourceId);\n    return result;\n  }\n\n  async revokeSourceCredential(sourceId: string, id: string, options: LearningRequestOptions = {}) {\n    const request = LearningSourceCredentialRequestSchema.parse({ action: \"revoke\", scope: this.#options.scope, sourceId, id });\n    const result = LearningSourceCredentialSchema.parse(await this.#request(\"credentials\", request, options));\n    this.#assertCredentialScope(result, sourceId);\n    if (result.id !== id || result.revokedAt === null) throw new OpenPondLearningError(502, \"credential_revocation_mismatch\", \"Credential revocation did not match the requested credential.\", null);\n    return result;\n  }\n\n  async sourceConfiguration(sourceId: string, options: LearningRequestOptions = {}) {\n    const request = LearningSourceConfigurationRequestSchema.parse({ scope: this.#options.scope, sourceId });\n    const result = LearningSourceConfigurationSchema.parse(await this.#request(\"source-config\", request, options));\n    if (result.scope !== this.#options.scope || result.source.id !== sourceId) throw new OpenPondLearningError(502, \"source_identity_mismatch\", \"Source configuration did not match the requested source.\", null);\n    return result;\n  }\n\n  #assertCredentialScope(value: { scope: string; sourceId: string }, sourceId: string) {\n    if (value.scope !== this.#options.scope || value.sourceId !== sourceId) throw new OpenPondLearningError(502, \"credential_scope_mismatch\", \"Credential response did not match the requested source.\", null);\n  }\n\n  async list<K extends LearningResourceKind>(kind: K, query: Partial<LearningResourceQuery> = {}, options: LearningRequestOptions = {}): Promise<LearningResourcePage<K>> {\n    const request = LearningReadRequestSchema.parse({ action: \"list\", scope: this.#options.scope, kind, ...query });\n    return z.object({ items: z.array(learningResourceSchemas[kind]).max(100), nextCursor: z.string().nullable() }).strict().parse(await this.#request(\"read\", request, options)) as LearningResourcePage<K>;\n  }\n\n  /** Hosted publication only: stores an immutable package and attaches it, without starting training. */\n  async publishBatch(input: z.infer<typeof LearningBatchPublicationSchema>, options: LearningRequestOptions = {}) {\n    const request = LearningBatchPublicationSchema.parse(input);\n    const result = LearningBatchPublicationResultSchema.parse(await this.#request(\"publish-batch\", { ...request, scope: this.#options.scope }, options));\n    if (result.batchId !== request.batchId) throw new OpenPondLearningError(502, \"batch_identity_mismatch\", \"Published batch response did not match the requested batch.\", null);\n    return result;\n  }\n\n  async #request(endpoint: \"commands\" | \"read\" | \"publish-batch\" | \"credentials\" | \"source-config\", body: unknown, options: LearningRequestOptions): Promise<unknown> {\n    assertBoundedTaskJson(body, 16_777_216);\n    const response = await (this.#options.fetch ?? globalThis.fetch)(`${this.#options.baseUrl}/v1/learning/${endpoint}`, {\n      method: \"POST\", headers: { Authorization: `Bearer ${this.#options.apiKey}`, \"Content-Type\": \"application/json\", Accept: \"application/json\", \"X-OpenPond-Team-Id\": this.#options.scope }, body: JSON.stringify(body), signal: options.signal,\n      redirect: \"error\",\n    });\n    const payload = await readBoundedLearningResponse(response);\n    if (!response.ok) {\n      const error = z.object({ code: z.string().optional(), error: z.string().optional() }).passthrough().safeParse(payload);\n      throw new OpenPondLearningError(response.status, error.success ? error.data.code ?? \"learning_request_failed\" : \"learning_request_failed\", error.success ? error.data.error ?? `Learning request failed (${response.status}).` : `Learning request failed (${response.status}).`, payload);\n    }\n    return payload;\n  }\n}\n\nexport async function readBoundedLearningResponse(response: Response): Promise<unknown> {\n  const maximumBytes = 16_777_216;\n  const reader = response.body?.getReader();\n  if (!reader) throw new OpenPondLearningError(response.status, \"empty_response\", \"Learning response was empty.\", null);\n  const decoder = new TextDecoder();\n  let bytes = 0;\n  let text = \"\";\n  try {\n    while (true) {\n      const next = await reader.read();\n      if (next.done) break;\n      bytes += next.value.byteLength;\n      if (bytes > maximumBytes) throw new OpenPondLearningError(response.status, \"response_too_large\", \"Learning response exceeded 16 MiB; request a smaller page.\", null);\n      text += decoder.decode(next.value, { stream: true });\n    }\n    text += decoder.decode();\n    const value: unknown = JSON.parse(text);\n    assertBoundedTaskJson(value, maximumBytes);\n    return value;\n  } finally {\n    await reader.cancel();\n    reader.releaseLock();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-WYR3MZHU.js → chunk-C4W2MEFP.js}

@@ -1,7 +1,7 @@
 import {
   HarnessExperimentPolicySchema,
   ModelTasksetRunRequestSchema
-} from "./chunk-EWRWGFKD.js";
+} from "./chunk-ZYDDHHZZ.js";
 import {
   contentHash
 } from "./chunk-H3JZ3P5T.js";
@@ -172,4 +172,4 @@ export {
   verifyExperimentDefinition,
   experimentDefinitionRef
 };
-//# sourceMappingURL=chunk-WYR3MZHU.js.map
+//# sourceMappingURL=chunk-C4W2MEFP.js.map