openpond-sdk 0.10.0 → 0.11.0

package/dist/chunk-JMQ4HBWP.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/experiment-improvement-client.ts", "../src/experiment-improvement-hosted-adoption.ts"],
+  "sourcesContent": ["import {z} from \"zod\";\nimport {contentHash,sha256} from \"@openpond/harness\";\nimport {verifyExperimentImprovementHumanOptions,ExperimentImprovementListSchema,ExperimentImprovementOptionsSchema,ExperimentImprovementCommandSchema,verifyExperimentImprovementState,type ExperimentImprovementCommand} from \"./experiment-improvement-contracts.js\";\nimport {HostedProfileCandidateCommandSchema,verifyHostedProfileCandidateReceipt} from \"./experiment-improvement-hosted-adoption.js\";\nimport {fetchConnectedJson} from \"./connected-evidence-http.js\";\nexport class ExperimentImprovementClient {\n  private readonly origin:string;\n  constructor(private readonly options:{baseUrl:string;apiKey:string;teamId:string;actorId:string;fetch?:typeof fetch}){const url=new URL(options.baseUrl);if(![\"http:\",\"https:\"].includes(url.protocol)||url.username||url.password||url.hash||url.search||!options.apiKey.trim()||!options.teamId.trim()||!options.actorId.trim())throw new Error(\"Select the authenticated Improve owner and API origin.\");this.origin=url.toString().replace(/\\/+$/,\"\");}\n  async hostedCandidate(raw:import(\"zod\").input<typeof HostedProfileCandidateCommandSchema>,signal?:AbortSignal){const request=HostedProfileCandidateCommandSchema.parse(raw);if(request.operation===\"adopt\"&&(request.export.actorId!==this.options.actorId||request.export.teamId!==this.options.teamId))throw new Error(\"The hosted candidate export belongs to a different owner.\");const {response,value}=await fetchConnectedJson(this.options.fetch??fetch,`${this.origin}/v1/profile-candidate-adoptions`,{method:\"POST\",redirect:\"error\",headers:{Authorization:`Bearer ${this.options.apiKey}`,\"Content-Type\":\"application/json\",\"X-OpenPond-Team-Id\":this.options.teamId},body:JSON.stringify({teamId:this.options.teamId,command:request}),signal},(status,code,message)=>Object.assign(new Error(message),{status,code}));if(!response.ok){const error=z.object({code:z.string(),message:z.string().optional(),error:z.string().optional()}).passthrough().safeParse(value);throw Object.assign(new Error(error.success?error.data.message??error.data.error??error.data.code:\"Hosted candidate operation failed.\"),{status:response.status,code:error.success?error.data.code:undefined});}const receipt=verifyHostedProfileCandidateReceipt(value);if(receipt.actorId!==this.options.actorId||receipt.teamId!==this.options.teamId||receipt.operationId!==request.operationId||request.operation===\"adopt\"&&(receipt.exportHash!==request.export.contentHash||receipt.candidateId!==request.export.candidateId||receipt.testedCandidateRelease.contentHash!==request.export.policySource.harnessRelease.contentHash))throw new Error(\"Hosted candidate readback differs from the exact owner request.\");return receipt;}\n  async command(raw:ExperimentImprovementCommand,signal?:AbortSignal){const request=ExperimentImprovementCommandSchema.parse(raw),{response,value}=await fetchConnectedJson(this.options.fetch??fetch,`${this.origin}/v1/experiment-improvements`,{method:\"POST\",redirect:\"error\",headers:{Authorization:`Bearer ${this.options.apiKey}`,\"Content-Type\":\"application/json\",\"X-OpenPond-Team-Id\":this.options.teamId},body:JSON.stringify({teamId:this.options.teamId,request}),signal},(status,code,message)=>Object.assign(new Error(message),{status,code}));\n    if(!response.ok){const error=z.object({error:z.string(),code:z.string().optional()}).passthrough().safeParse(value);throw Object.assign(new Error(error.success?error.data.error:\"The Improve operation failed.\"),{status:response.status,code:error.success?error.data.code:undefined});}\n    if(request.operation===\"options\"){const result=ExperimentImprovementOptionsSchema.parse(value);if(result.teamId!==this.options.teamId||contentHash(result.evidence)!==contentHash(request.evidence))throw new Error(\"The Improve choices changed their exact originating evidence.\");return result;}\n    if(request.operation===\"humanComparisonOptions\"){const result=verifyExperimentImprovementHumanOptions(value);if(result.candidateId!==request.id||result.actorId!==this.options.actorId||result.teamId!==this.options.teamId)throw new Error(\"Human discovery belongs to another owner or candidate.\");return result;}\n    if(request.operation===\"instructions\"){const result=z.object({candidateId:z.string(),candidateRevision:z.number().int().positive(),path:z.string(),text:z.string().max(250000),textHash:z.string().regex(/^[a-f0-9]{64}$/),contentHash:z.string().regex(/^[a-f0-9]{64}$/)}).strict().parse(value);if(result.candidateId!==request.id||sha256(result.text)!==result.textHash)throw new Error(\"The candidate instructions belong to a different revision.\");return result;}\n    const page=request.operation===\"list\"?ExperimentImprovementListSchema.parse(value):null;if(request.operation===\"list\"&&page&&(page.states.length>request.limit||page.states.some((state,index)=>request.cursor&&state.id<=request.cursor||index>0&&state.id<=page.states[index-1]!.id)||page.nextCursor&&(request.cursor&&page.nextCursor<=request.cursor||page.states.some(state=>state.id>page.nextCursor!))))throw new Error(\"The retained candidate page changed its scan boundary.\");\n    const states=page? page.states:[value];const parsed=states.map(item=>{const state=verifyExperimentImprovementState(item);if(state.actorId!==this.options.actorId||state.teamId!==this.options.teamId||\"id\" in request&&state.id!==request.id)throw new Error(\"The Improve response belongs to a different owner or candidate.\");if(request.operation===\"start\"&&state.requestHash!==contentHash(request.request))throw new Error(\"The Improve request identity changed.\");return state;});return page?{states:parsed,nextCursor:page.nextCursor}:parsed[0]!;\n  }\n}\n", "import {z} from \"zod\";\nimport {contentHash,ImmutableReleaseRefSchema,HarnessPolicySourcePackageSchema,validateHarnessPolicySourcePackage} from \"@openpond/harness\";\nimport {ExperimentImprovementTestRecipeSchema,ExperimentImprovementStateSchema} from \"./experiment-improvement-contracts.js\";\nconst Id=z.string().min(1).max(240),Hash=z.string().regex(/^[a-f0-9]{64}$/),Commit=z.string().regex(/^[a-f0-9]{40}$/);\n/** This export attests native owner execution. It never asserts a hosted run,\n * grants training eligibility, or authorizes automatic candidate adoption. */\nexport const HostedProfileCandidateExportSchema=z.object({schemaVersion:z.literal(\"openpond.hostedProfileCandidateExport.v1\"),\n  actorId:Id,teamId:Id,candidateId:Id,candidateRevision:z.number().int().positive(),projectId:Id.nullable(),\n  profileRef:z.object({source:z.literal(\"openpond_git\"),repositoryId:Id,profileId:Id}).strict(),expectedCommit:Commit,\n  component:ExperimentImprovementStateSchema.shape.component,baseRelease:ImmutableReleaseRefSchema,\n  frozenHash:Hash,executableSourceHash:Hash,protectedClosureHash:Hash,\n  compiler:z.object({workspaceId:Id,name:z.string().max(500),repositoryId:Id}).strict(),\n  sourceManifest:z.object({base64:z.string().max(2_800_000),contentHash:Hash,sizeBytes:z.number().int().positive().max(2_000_000)}).strict(),\n  policySource:HarnessPolicySourcePackageSchema,\n  qualification:z.object({kind:z.enum([\"owner_attested_local\",\"hosted_execution\"]),ownerActorId:Id,teamId:Id,originalEvidence:ImmutableReleaseRefSchema,\n    baseline:ImmutableReleaseRefSchema,candidate:ImmutableReleaseRefSchema,comparisonHash:Hash,recipe:ExperimentImprovementTestRecipeSchema}).strict(),\n  createdAt:z.string().datetime(),contentHash:Hash}).strict();\nexport type HostedProfileCandidateExport=z.infer<typeof HostedProfileCandidateExportSchema>;\nexport function verifyHostedProfileCandidateExport(raw:unknown){const value=HostedProfileCandidateExportSchema.parse(raw),{contentHash:hash,...body}=value;\n  if(contentHash(body)!==hash||value.qualification.ownerActorId!==value.actorId||value.qualification.teamId!==value.teamId||value.qualification.recipe.externalDatasetBinding.profileId!==value.profileRef.profileId||value.qualification.recipe.externalDatasetBinding.protectedProfileClosureHash!==value.protectedClosureHash)throw new Error(\"Hosted candidate owner attestation identity differs.\");\n  validateHarnessPolicySourcePackage(value.policySource);return value;\n}\nexport const HostedProfileCandidateReceiptSchema=z.object({schemaVersion:z.literal(\"openpond.hostedProfileCandidateAdoption.v1\"),id:Id,operationId:Id,actorId:Id,teamId:Id,\n  candidateId:Id,exportHash:Hash,executionOrigin:z.enum([\"owner_attested_local\",\"hosted_execution\"]),qualification:HostedProfileCandidateExportSchema.shape.qualification,\n  testedCandidateRelease:ImmutableReleaseRefSchema,activeRelease:ImmutableReleaseRefSchema,expectedCommit:Commit,committedProfileGit:Commit,\n  executableSourceHash:Hash,protectedClosureHash:Hash,createdAt:z.string().datetime(),contentHash:Hash}).strict();\nexport type HostedProfileCandidateReceipt=z.infer<typeof HostedProfileCandidateReceiptSchema>;\nexport function verifyHostedProfileCandidateReceipt(raw:unknown){const value=HostedProfileCandidateReceiptSchema.parse(raw),{contentHash:hash,...body}=value;if(contentHash(body)!==hash||value.executionOrigin!==value.qualification.kind||value.qualification.ownerActorId!==value.actorId||value.qualification.teamId!==value.teamId)throw new Error(\"Hosted candidate receipt integrity differs.\");return value;}\nexport const HostedProfileCandidateCommandSchema=z.discriminatedUnion(\"operation\",[\n z.object({operation:z.literal(\"adopt\"),operationId:Id,export:HostedProfileCandidateExportSchema}).strict(),\n z.object({operation:z.enum([\"read\",\"rollback\"]),operationId:Id,adoptionOperationId:Id,profileRepositoryId:Id}).strict(),\n]);\n"],
+  "mappings": "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",
+  "names": ["z", "z"]
+}

package/dist/chunk-KQWCXW3A.js

@@ -0,0 +1,294 @@
+import {
+  RunExperimentSchema
+} from "./chunk-XEUOJ5WF.js";
+import {
+  HostedModelProjectSummarySchema,
+  OpenPondProtocolError,
+  canonicalSha256
+} from "./chunk-TCHAWJMB.js";
+import {
+  contentHash
+} from "./chunk-QUOW6URQ.js";
+
+// src/post-training.ts
+import { z } from "zod";
+import {
+  LearningSourceSchema,
+  TaskBatchSchema,
+  TaskDefinitionSchema,
+  LearningPolicySchema,
+  LearningPolicyInspectionResultSchema,
+  LearningIterationSchema
+} from "@openpond/evals/learning";
+import { AcceptancePlanSchema } from "@openpond/evals/learning";
+import { TrainingHandoffOriginSchema } from "@openpond/evals/learning";
+import { TrainingHandoffOriginSchema as TrainingHandoffOriginSchema2 } from "@openpond/evals/learning";
+var Id = z.string().trim().min(1).max(200);
+var Hash = z.string().regex(/^[a-f0-9]{64}$/);
+var Ref = z.object({ id: Id, contentHash: Hash }).strict();
+var TrainingHandoffContextSchema = z.object({
+  available: z.boolean(),
+  reason: z.string().max(1e3).nullable(),
+  origin: TrainingHandoffOriginSchema.nullable()
+}).strict();
+var PostTrainingAttachmentSchema = z.object({
+  schemaVersion: z.literal("openpond.postTrainingAttachment.v1"),
+  binding: z.object({
+    kind: z.enum(["preparation", "policy"]),
+    id: Id,
+    revision: z.number().int().positive(),
+    contentHash: Hash
+  }).strict(),
+  projectId: Id.nullable(),
+  automatic: z.boolean(),
+  maximumSpendUsd: z.number().finite().positive().max(1e4),
+  experiments: z.array(z.object({ id: Id, configuration: RunExperimentSchema }).strict()).min(1).max(20),
+  acceptancePlan: AcceptancePlanSchema.nullable()
+}).strict().superRefine((value, ctx) => {
+  if (new Set(value.experiments.map((item) => item.id)).size !== value.experiments.length)
+    ctx.addIssue({ code: "custom", message: "Attach each evaluation once." });
+  if (value.experiments.reduce((sum, item) => sum + item.configuration.maximumCostUsd, 0) > value.maximumSpendUsd + 1e-9)
+    ctx.addIssue({
+      code: "custom",
+      message: "Attached evaluation budgets exceed the total approved budget."
+    });
+  if (value.experiments.some(
+    (item) => (item.configuration.request.project?.id ?? null) !== value.projectId
+  ))
+    ctx.addIssue({
+      code: "custom",
+      message: "Attached experiments must use the training Project."
+    });
+  if (value.acceptancePlan) {
+    const checked = new Set(value.acceptancePlan.checks.map((c) => c.id));
+    if (value.acceptancePlan.checks.some((c) => !value.experiments.some((m) => m.id === c.id)))
+      ctx.addIssue({
+        code: "custom",
+        message: "Select the frozen Experiment for each acceptance check."
+      });
+    const committed = value.acceptancePlan.maximumSpendUsd + value.experiments.filter((m) => !checked.has(m.id)).reduce((sum, m) => sum + m.configuration.maximumCostUsd, 0);
+    if (committed > value.maximumSpendUsd + 1e-9)
+      ctx.addIssue({
+        code: "custom",
+        message: "Paired acceptance and diagnostic ceilings exceed the approved evaluation budget."
+      });
+  }
+});
+function postTrainingRecipe(configuration) {
+  const {
+    modelId: _model,
+    candidate: _candidate,
+    ...settings
+  } = configuration.request.policy.kind === "fixture" ? { modelId: null, candidate: null, ...configuration.request.policy } : configuration.request.policy;
+  void _model;
+  void _candidate;
+  if ("modelConfigurationHash" in settings)
+    delete settings.modelConfigurationHash;
+  return {
+    dataset: {
+      id: configuration.request.taskset.id,
+      contentHash: configuration.request.taskset.contentHash
+    },
+    populationHash: contentHash(
+      configuration.request.population.map((m) => ({
+        caseId: m.taskId,
+        seed: m.seed,
+        fixtureId: m.fixtureId
+      }))
+    ),
+    executionHash: contentHash({ settings, graders: configuration.graders ?? null })
+  };
+}
+var PostTrainingQualificationSchema = z.object({
+  baseline: Ref,
+  checks: z.array(
+    z.object({
+      id: Id,
+      sourceRunId: Id,
+      sourceManifestHash: Hash,
+      targetConfigurationHash: Hash,
+      executionHash: Hash,
+      populationHash: Hash,
+      evaluator: Ref,
+      feedbackKey: Id,
+      output: z.enum(["boolean", "score"]),
+      unit: z.string().min(1).max(80)
+    }).strict()
+  ).min(1).max(100)
+}).strict();
+var PostTrainingStateSchema = z.enum([
+  "waiting_for_training",
+  "ready",
+  "preparing",
+  "queued",
+  "running",
+  "cleaning",
+  "completed",
+  "failed",
+  "blocked",
+  "cancelled",
+  "budget_exhausted"
+]);
+var PostTrainingSummarySchema = z.object({
+  schemaVersion: z.literal("openpond.postTrainingSummary.v1"),
+  id: Id,
+  teamId: Id,
+  jobId: Id,
+  revision: z.number().int().positive(),
+  planHash: Hash,
+  automatic: z.boolean(),
+  candidate: Ref.nullable(),
+  state: PostTrainingStateSchema,
+  total: z.number().int().positive(),
+  completed: z.number().int().nonnegative(),
+  failed: z.number().int().nonnegative(),
+  requiredOutcome: z.enum(["none", "pending", "passed", "failed", "blocked"]),
+  reason: z.string().max(500).nullable(),
+  groupId: Id.nullable(),
+  experimentIds: z.array(Id).max(20),
+  updatedAt: z.iso.datetime()
+}).strict().superRefine((value, ctx) => {
+  if (value.completed + value.failed > value.total)
+    ctx.addIssue({ code: "custom", message: "Evaluation totals are inconsistent." });
+  if (["preparing", "queued", "running", "cleaning", "completed"].includes(value.state) && !value.candidate)
+    ctx.addIssue({
+      code: "custom",
+      message: "Evaluation execution requires the exact trained candidate."
+    });
+});
+var PostTrainingControlSchema = z.object({ operationId: Id, expectedRevision: z.number().int().positive(), planHash: Hash }).strict();
+var AttachPostTrainingSchema = z.object({ operationId: Id, attachment: PostTrainingAttachmentSchema }).strict();
+var PostTrainingPlanSchema = z.object({
+  id: Id,
+  teamId: Id,
+  ownerUserId: Id,
+  attachment: PostTrainingAttachmentSchema,
+  qualification: PostTrainingQualificationSchema.nullable(),
+  contentHash: Hash,
+  createdAt: z.iso.datetime()
+}).strict();
+function verifyPostTrainingPlan(raw) {
+  const plan = PostTrainingPlanSchema.parse(raw);
+  if (plan.contentHash !== contentHash({ attachment: plan.attachment, qualification: plan.qualification }))
+    throw new Error("The retained evaluation attachment or qualification changed.");
+  return plan;
+}
+function postTrainingActive(summary) {
+  return Boolean(summary && ["preparing", "queued", "running", "cleaning"].includes(summary.state));
+}
+function createPostTrainingClient(input) {
+  const { request } = input;
+  const path = (jobId) => `/v1/training/jobs/${encodeURIComponent(Id.parse(jobId))}/post-training`;
+  async function read(raw, teamId, jobId) {
+    if (raw === null) return null;
+    const value = PostTrainingSummarySchema.parse(raw);
+    if (value.teamId !== teamId || value.jobId !== jobId)
+      throw new OpenPondProtocolError(
+        "post_training_scope_mismatch",
+        "The evaluation summary belongs to another run or workspace."
+      );
+    return value;
+  }
+  return {
+    async attach(teamId, raw) {
+      const body = AttachPostTrainingSchema.parse(raw);
+      const value = verifyPostTrainingPlan(
+        await request("/v1/training/post-training-plans", {
+          method: "POST",
+          body: JSON.stringify(body)
+        })
+      );
+      if (value.teamId !== teamId || await canonicalSha256(value.attachment) !== await canonicalSha256(body.attachment))
+        throw new OpenPondProtocolError(
+          "post_training_plan_mismatch",
+          "The retained attachment differs from the reviewed plan."
+        );
+      return value;
+    },
+    async get(teamId, jobId) {
+      return read(await request(path(jobId)), teamId, jobId);
+    },
+    async control(teamId, jobId, action, raw) {
+      const body = PostTrainingControlSchema.parse(raw);
+      const value = await read(
+        await request(`${path(jobId)}/${action}`, { method: "POST", body: JSON.stringify(body) }),
+        teamId,
+        jobId
+      );
+      if (!value || value.planHash !== body.planHash)
+        throw new OpenPondProtocolError(
+          "post_training_control_mismatch",
+          "Evaluation control did not retain the approved plan."
+        );
+      return value;
+    }
+  };
+}
+var HostedTrainingSetupCatalogSchema = z.object({
+  teamId: Id,
+  actorId: Id,
+  projectId: Id.nullable(),
+  configuration: HostedModelProjectSummarySchema,
+  batches: z.array(TaskBatchSchema).max(1e4),
+  sources: z.array(LearningSourceSchema).max(1e4),
+  definitions: z.array(TaskDefinitionSchema).max(1e4),
+  experiments: z.array(
+    z.object({
+      id: Id,
+      name: z.string().max(500),
+      configuration: RunExperimentSchema,
+      graders: z.array(z.object({ feedbackKey: Id, name: z.string().max(500), ref: Ref }).strict()).max(100)
+    }).strict()
+  ).max(1e4)
+}).strict();
+var HostedTrainingSetupActionSchema = z.enum([
+  "prepare",
+  "start",
+  "cancel",
+  "publish",
+  "attach"
+]);
+var HostedTrainingPolicyDetailSchema = z.object({
+  teamId: Id,
+  actorId: Id,
+  configuration: HostedModelProjectSummarySchema,
+  policy: LearningPolicySchema,
+  inspection: LearningPolicyInspectionResultSchema,
+  iterations: z.array(
+    z.object({
+      iteration: LearningIterationSchema,
+      evals: PostTrainingSummarySchema.nullable()
+    }).strict()
+  ).max(100),
+  nextCursor: Id.nullable()
+}).strict();
+var HostedTrainingPolicyControlSchema = z.object({
+  id: Id,
+  expectedRevision: z.number().int().positive(),
+  policyHash: Hash,
+  operationId: Id,
+  action: z.enum(["pause", "resume", "reserve", "cancel-iteration", "retry-iteration"]),
+  iterationId: Id.optional(),
+  iterationRevision: z.number().int().positive().optional()
+}).strict();
+
+export {
+  TrainingHandoffContextSchema,
+  PostTrainingAttachmentSchema,
+  postTrainingRecipe,
+  PostTrainingQualificationSchema,
+  PostTrainingStateSchema,
+  PostTrainingSummarySchema,
+  PostTrainingControlSchema,
+  AttachPostTrainingSchema,
+  PostTrainingPlanSchema,
+  verifyPostTrainingPlan,
+  postTrainingActive,
+  createPostTrainingClient,
+  HostedTrainingSetupCatalogSchema,
+  HostedTrainingSetupActionSchema,
+  HostedTrainingPolicyDetailSchema,
+  HostedTrainingPolicyControlSchema,
+  TrainingHandoffOriginSchema2 as TrainingHandoffOriginSchema
+};
+//# sourceMappingURL=chunk-KQWCXW3A.js.map

package/dist/chunk-KQWCXW3A.js.map

@@ -0,0 +1,7 @@
+{
+  "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  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          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)), 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\", 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-I2YM3UY4.js → chunk-NHCGOFQW.js}

@@ -1,6 +1,6 @@
 import {
   GraderSpecSchema
-} from "./chunk-LGEF4S5I.js";
+} from "./chunk-XJDWHTH5.js";
 import {
   decodeTasksetPackageFile
 } from "./chunk-JA3KFK3U.js";
@@ -92,4 +92,4 @@ export {
   projectLearningBatchGraders,
   learningVerifierModule
 };
-//# sourceMappingURL=chunk-I2YM3UY4.js.map
+//# sourceMappingURL=chunk-NHCGOFQW.js.map

package/dist/{chunk-32H2EJRA.js → chunk-R3M6BIOK.js}

@@ -14,7 +14,7 @@ import {
   TasksetSourceRefSchema,
   computeTasksetHash,
   validateTaskset
-} from "./chunk-LGEF4S5I.js";
+} from "./chunk-XJDWHTH5.js";
 import {
   ModelTasksetDraftPreparationSchema,
   TasksetDraftFileContentSchema,
@@ -753,4 +753,4 @@ export {
   tasksetDraftFromTaskset,
   publishTasksetDraft
 };
-//# sourceMappingURL=chunk-32H2EJRA.js.map
+//# sourceMappingURL=chunk-R3M6BIOK.js.map

package/dist/chunk-SLS3GFPG.js

@@ -0,0 +1,125 @@
+import {
+  contentHash
+} from "./chunk-QUOW6URQ.js";
+
+// src/human-review.ts
+export * from "@openpond/evals/human-review";
+
+// src/human-review-client.ts
+import { z } from "zod";
+import { HumanReviewTransportSchema, HumanInspectionSchema, HumanEvidenceSchema, HumanFormSchema, HumanResultViewSchema, HumanReviewViewSchema, HumanInboxSchema } from "@openpond/evals/human-review";
+var HumanReviewClientError = class extends Error {
+  constructor(status, code, message) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "HumanReviewClientError";
+  }
+  status;
+  code;
+};
+var OpenPondHumanReviewClient = class {
+  options;
+  constructor(options) {
+    const url = new URL(options.baseUrl);
+    if (!["http:", "https:"].includes(url.protocol) || url.username || url.password || url.hash || url.search || !options.apiKey.trim() || !options.scope.trim() || options.scope !== options.scope.trim() || /[\r\n]/.test(options.scope)) throw new Error("Use a scoped key and a plain HTTP(S) API endpoint.");
+    this.options = { ...options, baseUrl: url.toString().replace(/\/+$/, "") };
+  }
+  async command(command, signal) {
+    const result = HumanReviewViewSchema.parse(await this.request({ endpoint: "command", scope: this.options.scope, command }, signal));
+    const revisionMatches = command.action === "cancel" ? result.status === "cancelled" && result.revision >= command.expectedRevision + 1 : result.revision === command.expectedRevision + 1;
+    if (result.id !== command.id || result.scope !== this.options.scope || !revisionMatches) throw new HumanReviewClientError(502, "human_response_identity_mismatch", "Review response differs from the submitted operation.");
+    return result;
+  }
+  async get(id, revision, signal) {
+    const result = HumanReviewViewSchema.parse(await this.request({ endpoint: "get", scope: this.options.scope, id, ...revision ? { revision } : {} }, signal));
+    if (result.id !== id || result.scope !== this.options.scope || revision !== void 0 && result.revision !== revision) throw new HumanReviewClientError(502, "human_response_identity_mismatch", "Review response differs from the requested identity.");
+    return result;
+  }
+  async inbox(query, signal) {
+    const result = HumanInboxSchema.parse(await this.request({ ...query, endpoint: "inbox", scope: this.options.scope }, signal));
+    if (result.items.some((r) => r.scope !== this.options.scope || query.projectId && r.projectId !== query.projectId)) throw new HumanReviewClientError(502, "human_inbox_scope_mismatch", "Inbox response differs from the authorized scope.");
+    return result;
+  }
+  async snapshot(input, signal) {
+    return z.object({ evidence: HumanEvidenceSchema, form: HumanFormSchema }).strict().parse(await this.request({ ...input, endpoint: "snapshot", scope: this.options.scope }, signal));
+  }
+  async taskSnapshot(input, signal) {
+    return z.object({ evidence: HumanEvidenceSchema, form: HumanFormSchema }).strict().parse(await this.request({ ...input, endpoint: "snapshot_tasks", scope: this.options.scope }, signal));
+  }
+  async inspect(id, signal, options) {
+    const result = HumanInspectionSchema.parse(await this.request({ endpoint: "inspect", scope: this.options.scope, id, ...options }, signal));
+    if (result.some((row) => row.reviewId !== id)) throw new HumanReviewClientError(502, "human_inspection_identity_mismatch", "Inspection differs from selected review.");
+    return result;
+  }
+  async results(executionId, selection, signal) {
+    return HumanResultViewSchema.parse(await this.request({ endpoint: "results", scope: this.options.scope, executionId, ...selection ? { selection } : {} }, signal));
+  }
+  async members(signal) {
+    return z.array(z.object({ userId: z.string(), name: z.string().nullable(), email: z.string().nullable(), role: z.string() }).strict()).parse(await this.request({ endpoint: "members", scope: this.options.scope }, signal));
+  }
+  async request(raw, signal) {
+    const body = HumanReviewTransportSchema.parse(raw);
+    if (body.scope !== this.options.scope) throw new HumanReviewClientError(403, "human_scope_denied", "Request differs from the scoped client workspace.");
+    const serialized = JSON.stringify(body);
+    if (new TextEncoder().encode(serialized).byteLength > 1048576) throw new HumanReviewClientError(422, "human_request_too_large", "Review request exceeds its bounded transport.");
+    const response = await (this.options.fetch ?? globalThis.fetch)(`${this.options.baseUrl}/v1/human-review`, { method: "POST", headers: { authorization: `Bearer ${this.options.apiKey}`, "content-type": "application/json", "x-openpond-team-id": this.options.scope }, body: serialized, signal, redirect: "error" });
+    const reader = response.body?.getReader(), chunks = [];
+    let size = 0;
+    if (reader) {
+      try {
+        while (true) {
+          const part = await reader.read();
+          if (part.done) break;
+          size += part.value.byteLength;
+          if (size > 8388608) {
+            await reader.cancel();
+            throw new HumanReviewClientError(502, "human_response_too_large", "Review response exceeds its bounded transport.");
+          }
+          chunks.push(part.value);
+        }
+      } finally {
+        reader.releaseLock();
+      }
+    }
+    const bytes = new Uint8Array(size);
+    let offset = 0;
+    for (const chunk of chunks) {
+      bytes.set(chunk, offset);
+      offset += chunk.byteLength;
+    }
+    let data;
+    try {
+      data = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+    } catch {
+      throw new HumanReviewClientError(502, "human_response_invalid", "Review response is not valid JSON.");
+    }
+    if (!response.ok) {
+      const failure = z.object({ code: z.string().optional(), error: z.string().optional() }).passthrough().safeParse(data);
+      throw new HumanReviewClientError(response.status, failure.success ? failure.data.code ?? "human_request_failed" : "human_request_failed", failure.success ? failure.data.error ?? "Review request failed." : "Review request failed.");
+    }
+    if (body.endpoint === "results") {
+      const result = HumanResultViewSchema.parse(data), { contentHash: hash, ...content } = result;
+      if (result.executionId !== body.executionId || contentHash(content) !== hash || body.selection !== void 0 && contentHash(result.selection) !== contentHash(body.selection)) throw new HumanReviewClientError(502, "human_result_identity_mismatch", "Human results differ from the exact retained execution or selected reviews.");
+    }
+    if (body.endpoint === "snapshot" || body.endpoint === "publish_evidence") {
+      const result = z.object({ evidence: HumanEvidenceSchema, form: HumanFormSchema }).strict().parse(data);
+      if (result.evidence.graderBinding.id !== body.graderId || result.evidence.attempts.length !== body.selections.length || result.evidence.attempts.some((a, i) => a.experimentId !== body.selections[i].executionId || a.attemptId !== body.selections[i].receiptId)) throw new HumanReviewClientError(502, "human_snapshot_identity_mismatch", "Review snapshot differs from selected retained evidence.");
+    }
+    if (body.endpoint === "publish_local") {
+      const result = z.object({ evidence: HumanEvidenceSchema, form: HumanFormSchema }).strict().parse(data);
+      if (!result.evidence.publication || result.evidence.attempts.length !== body.evidence.attempts.length || result.evidence.attempts.some((attempt, index) => attempt.localSource?.kind !== "owner_attested_local" || attempt.experimentId !== body.evidence.attempts[index].executionId || attempt.attemptId !== body.evidence.attempts[index].receiptId || attempt.localSource.retainedAttemptHash !== body.evidence.attempts[index].origin.retainedAttemptHash)) throw new HumanReviewClientError(502, "human_publication_identity_mismatch", "Published review differs from the exact local-origin export.");
+    }
+    if (body.endpoint === "snapshot_tasks") {
+      const result = z.object({ evidence: HumanEvidenceSchema, form: HumanFormSchema }).strict().parse(data);
+      if (result.evidence.graderBinding.id !== body.graderId || contentHash(result.evidence.dataset) !== contentHash(body.dataset) || (body.taskIds !== void 0 && contentHash(result.evidence.taskIds) !== contentHash(body.taskIds) || !result.evidence.taskIds?.length || new Set(result.evidence.taskIds).size !== result.evidence.taskIds.length)) throw new HumanReviewClientError(502, "human_snapshot_identity_mismatch", "Task snapshot differs from the selected exact tasks.");
+    }
+    return data;
+  }
+};
+
+export {
+  HumanReviewClientError,
+  OpenPondHumanReviewClient
+};
+//# sourceMappingURL=chunk-SLS3GFPG.js.map

package/dist/chunk-SLS3GFPG.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/human-review.ts", "../src/human-review-client.ts"],
+  "sourcesContent": ["export * from \"@openpond/evals/human-review\";\nexport * from \"./human-review-client.js\";\n", "import {contentHash} from \"@openpond/harness\";\nimport { z } from \"zod\";\nimport { HumanReviewTransportSchema,HumanInspectionSchema,HumanEvidenceSchema,HumanFormSchema,HumanResultViewSchema, HumanReviewViewSchema, HumanInboxSchema, type HumanReviewCommand, type HumanReviewRequest, type HumanReviewTransportRequest } from \"@openpond/evals/human-review\";\nexport class HumanReviewClientError extends Error { constructor(readonly status: number, readonly code: string, message: string) { super(message); this.name = \"HumanReviewClientError\"; } }\nexport class OpenPondHumanReviewClient {\n  readonly options: { baseUrl: string; apiKey: string; scope: string; fetch?: typeof globalThis.fetch };\n  constructor(options: OpenPondHumanReviewClient[\"options\"]) {\n    const url = new URL(options.baseUrl);\n    if (![\"http:\", \"https:\"].includes(url.protocol) || url.username || url.password || url.hash || url.search || !options.apiKey.trim() || !options.scope.trim() || options.scope !== options.scope.trim() || /[\\r\\n]/.test(options.scope)) throw new Error(\"Use a scoped key and a plain HTTP(S) API endpoint.\");\n    this.options = { ...options, baseUrl: url.toString().replace(/\\/+$/, \"\") };\n  }\n  async command(command: HumanReviewCommand, signal?: AbortSignal) {\n    const result = HumanReviewViewSchema.parse(await this.request({ endpoint: \"command\", scope: this.options.scope, command }, signal));\n    const revisionMatches = command.action === \"cancel\"\n      ? result.status === \"cancelled\" && result.revision >= command.expectedRevision + 1\n      : result.revision === command.expectedRevision + 1;\n    if (result.id !== command.id || result.scope !== this.options.scope || !revisionMatches) throw new HumanReviewClientError(502, \"human_response_identity_mismatch\", \"Review response differs from the submitted operation.\");\n    return result;\n  }\n  async get(id: string, revision?: number, signal?: AbortSignal) {\n    const result = HumanReviewViewSchema.parse(await this.request({ endpoint: \"get\", scope: this.options.scope, id, ...(revision ? { revision } : {}) }, signal));\n    if (result.id !== id || result.scope !== this.options.scope || revision !== undefined && result.revision !== revision) throw new HumanReviewClientError(502, \"human_response_identity_mismatch\", \"Review response differs from the requested identity.\");\n    return result;\n  }\n  async inbox(query: Omit<Extract<HumanReviewRequest, { endpoint: \"inbox\" }>, \"endpoint\" | \"scope\">, signal?: AbortSignal) {\n    const result = HumanInboxSchema.parse(await this.request({ ...query, endpoint: \"inbox\", scope: this.options.scope }, signal));\n    if (result.items.some(r => r.scope !== this.options.scope || query.projectId && r.projectId !== query.projectId)) throw new HumanReviewClientError(502, \"human_inbox_scope_mismatch\", \"Inbox response differs from the authorized scope.\");\n    return result;\n  }\n  async snapshot(input:Omit<Extract<HumanReviewTransportRequest,{endpoint:\"snapshot\"}>,\"endpoint\"|\"scope\">,signal?:AbortSignal) {return z.object({evidence:HumanEvidenceSchema,form:HumanFormSchema}).strict().parse(await this.request({...input,endpoint:\"snapshot\",scope:this.options.scope},signal));}\n  async taskSnapshot(input:Omit<Extract<HumanReviewTransportRequest,{endpoint:\"snapshot_tasks\"}>,\"endpoint\"|\"scope\">,signal?:AbortSignal) {return z.object({evidence:HumanEvidenceSchema,form:HumanFormSchema}).strict().parse(await this.request({...input,endpoint:\"snapshot_tasks\",scope:this.options.scope},signal));}\n  async inspect(id:string,signal?:AbortSignal,options?:{slot?:number;afterId?:string}) {const result=HumanInspectionSchema.parse(await this.request({endpoint:\"inspect\",scope:this.options.scope,id,...options},signal));if(result.some(row=>row.reviewId!==id))throw new HumanReviewClientError(502,\"human_inspection_identity_mismatch\",\"Inspection differs from selected review.\");return result;}\n  async results(executionId:string,selection?:Extract<HumanReviewTransportRequest,{endpoint:\"results\"}>[\"selection\"],signal?:AbortSignal) {\n    return HumanResultViewSchema.parse(await this.request({endpoint:\"results\",scope:this.options.scope,executionId,...(selection?{selection}:{})},signal));\n  }\n  async members(signal?:AbortSignal) {return z.array(z.object({userId:z.string(),name:z.string().nullable(),email:z.string().nullable(),role:z.string()}).strict()).parse(await this.request({endpoint:\"members\",scope:this.options.scope},signal));}\n  async request(raw: HumanReviewTransportRequest, signal?: AbortSignal) {\n    const body = HumanReviewTransportSchema.parse(raw);\n    if(body.scope!==this.options.scope)throw new HumanReviewClientError(403,\"human_scope_denied\",\"Request differs from the scoped client workspace.\");\n    const serialized=JSON.stringify(body);if(new TextEncoder().encode(serialized).byteLength>1048576)throw new HumanReviewClientError(422,\"human_request_too_large\",\"Review request exceeds its bounded transport.\");\n    const response = await (this.options.fetch ?? globalThis.fetch)(`${this.options.baseUrl}/v1/human-review`, { method: \"POST\", headers: { authorization: `Bearer ${this.options.apiKey}`, \"content-type\": \"application/json\", \"x-openpond-team-id\": this.options.scope }, body: serialized, signal,redirect:\"error\" });\n    const reader=response.body?.getReader(),chunks:Uint8Array[]=[];let size=0;\n    if(reader){try{while(true){const part=await reader.read();if(part.done)break;size+=part.value.byteLength;if(size>8388608){await reader.cancel();throw new HumanReviewClientError(502,\"human_response_too_large\",\"Review response exceeds its bounded transport.\");}chunks.push(part.value);}}finally{reader.releaseLock();}}\n    const bytes=new Uint8Array(size);let offset=0;for(const chunk of chunks){bytes.set(chunk,offset);offset+=chunk.byteLength;}\n    let data:unknown;try{data=JSON.parse(new TextDecoder(\"utf-8\",{fatal:true}).decode(bytes));}catch{throw new HumanReviewClientError(502,\"human_response_invalid\",\"Review response is not valid JSON.\");}\n    if (!response.ok) { const failure = z.object({ code: z.string().optional(), error: z.string().optional() }).passthrough().safeParse(data); throw new HumanReviewClientError(response.status, failure.success ? failure.data.code ?? \"human_request_failed\" : \"human_request_failed\", failure.success ? failure.data.error ?? \"Review request failed.\" : \"Review request failed.\"); }\n    if(body.endpoint===\"results\"){\n      const result=HumanResultViewSchema.parse(data),{contentHash:hash,...content}=result;\n      if(result.executionId!==body.executionId||contentHash(content)!==hash||body.selection!==undefined&&contentHash(result.selection)!==contentHash(body.selection))throw new HumanReviewClientError(502,\"human_result_identity_mismatch\",\"Human results differ from the exact retained execution or selected reviews.\");\n    }\n    if(body.endpoint===\"snapshot\"||body.endpoint===\"publish_evidence\"){const result=z.object({evidence:HumanEvidenceSchema,form:HumanFormSchema}).strict().parse(data);if(result.evidence.graderBinding.id!==body.graderId||result.evidence.attempts.length!==body.selections.length||result.evidence.attempts.some((a,i)=>a.experimentId!==body.selections[i]!.executionId||a.attemptId!==body.selections[i]!.receiptId))throw new HumanReviewClientError(502,\"human_snapshot_identity_mismatch\",\"Review snapshot differs from selected retained evidence.\");}\n    if(body.endpoint===\"publish_local\"){const result=z.object({evidence:HumanEvidenceSchema,form:HumanFormSchema}).strict().parse(data);if(!result.evidence.publication||result.evidence.attempts.length!==body.evidence.attempts.length||result.evidence.attempts.some((attempt,index)=>attempt.localSource?.kind!==\"owner_attested_local\"||attempt.experimentId!==body.evidence.attempts[index]!.executionId||attempt.attemptId!==body.evidence.attempts[index]!.receiptId||attempt.localSource.retainedAttemptHash!==body.evidence.attempts[index]!.origin.retainedAttemptHash))throw new HumanReviewClientError(502,\"human_publication_identity_mismatch\",\"Published review differs from the exact local-origin export.\");}\n    if(body.endpoint===\"snapshot_tasks\"){const result=z.object({evidence:HumanEvidenceSchema,form:HumanFormSchema}).strict().parse(data);if(result.evidence.graderBinding.id!==body.graderId||contentHash(result.evidence.dataset)!==contentHash(body.dataset)||(body.taskIds!==undefined&&contentHash(result.evidence.taskIds)!==contentHash(body.taskIds)||!result.evidence.taskIds?.length||new Set(result.evidence.taskIds).size!==result.evidence.taskIds.length))throw new HumanReviewClientError(502,\"human_snapshot_identity_mismatch\",\"Task snapshot differs from the selected exact tasks.\");}\n    return data;\n  }\n}\n"],
+  "mappings": ";;;;;AAAA,cAAc;;;ACCd,SAAS,SAAS;AAClB,SAAS,4BAA2B,uBAAsB,qBAAoB,iBAAgB,uBAAuB,uBAAuB,wBAA4G;AACjP,IAAM,yBAAN,cAAqC,MAAM;AAAA,EAAE,YAAqB,QAAyB,MAAc,SAAiB;AAAE,UAAM,OAAO;AAAvE;AAAyB;AAAiD,SAAK,OAAO;AAAA,EAA0B;AAAA,EAAhH;AAAA,EAAyB;AAAyF;AACpL,IAAM,4BAAN,MAAgC;AAAA,EAC5B;AAAA,EACT,YAAY,SAA+C;AACzD,UAAM,MAAM,IAAI,IAAI,QAAQ,OAAO;AACnC,QAAI,CAAC,CAAC,SAAS,QAAQ,EAAE,SAAS,IAAI,QAAQ,KAAK,IAAI,YAAY,IAAI,YAAY,IAAI,QAAQ,IAAI,UAAU,CAAC,QAAQ,OAAO,KAAK,KAAK,CAAC,QAAQ,MAAM,KAAK,KAAK,QAAQ,UAAU,QAAQ,MAAM,KAAK,KAAK,SAAS,KAAK,QAAQ,KAAK,EAAG,OAAM,IAAI,MAAM,oDAAoD;AAC5S,SAAK,UAAU,EAAE,GAAG,SAAS,SAAS,IAAI,SAAS,EAAE,QAAQ,QAAQ,EAAE,EAAE;AAAA,EAC3E;AAAA,EACA,MAAM,QAAQ,SAA6B,QAAsB;AAC/D,UAAM,SAAS,sBAAsB,MAAM,MAAM,KAAK,QAAQ,EAAE,UAAU,WAAW,OAAO,KAAK,QAAQ,OAAO,QAAQ,GAAG,MAAM,CAAC;AAClI,UAAM,kBAAkB,QAAQ,WAAW,WACvC,OAAO,WAAW,eAAe,OAAO,YAAY,QAAQ,mBAAmB,IAC/E,OAAO,aAAa,QAAQ,mBAAmB;AACnD,QAAI,OAAO,OAAO,QAAQ,MAAM,OAAO,UAAU,KAAK,QAAQ,SAAS,CAAC,gBAAiB,OAAM,IAAI,uBAAuB,KAAK,oCAAoC,uDAAuD;AAC1N,WAAO;AAAA,EACT;AAAA,EACA,MAAM,IAAI,IAAY,UAAmB,QAAsB;AAC7D,UAAM,SAAS,sBAAsB,MAAM,MAAM,KAAK,QAAQ,EAAE,UAAU,OAAO,OAAO,KAAK,QAAQ,OAAO,IAAI,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC,EAAG,GAAG,MAAM,CAAC;AAC5J,QAAI,OAAO,OAAO,MAAM,OAAO,UAAU,KAAK,QAAQ,SAAS,aAAa,UAAa,OAAO,aAAa,SAAU,OAAM,IAAI,uBAAuB,KAAK,oCAAoC,sDAAsD;AACvP,WAAO;AAAA,EACT;AAAA,EACA,MAAM,MAAM,OAAuF,QAAsB;AACvH,UAAM,SAAS,iBAAiB,MAAM,MAAM,KAAK,QAAQ,EAAE,GAAG,OAAO,UAAU,SAAS,OAAO,KAAK,QAAQ,MAAM,GAAG,MAAM,CAAC;AAC5H,QAAI,OAAO,MAAM,KAAK,OAAK,EAAE,UAAU,KAAK,QAAQ,SAAS,MAAM,aAAa,EAAE,cAAc,MAAM,SAAS,EAAG,OAAM,IAAI,uBAAuB,KAAK,8BAA8B,mDAAmD;AACzO,WAAO;AAAA,EACT;AAAA,EACA,MAAM,SAAS,OAA0F,QAAqB;AAAC,WAAO,EAAE,OAAO,EAAC,UAAS,qBAAoB,MAAK,gBAAe,CAAC,EAAE,OAAO,EAAE,MAAM,MAAM,KAAK,QAAQ,EAAC,GAAG,OAAM,UAAS,YAAW,OAAM,KAAK,QAAQ,MAAK,GAAE,MAAM,CAAC;AAAA,EAAE;AAAA,EACvS,MAAM,aAAa,OAAgG,QAAqB;AAAC,WAAO,EAAE,OAAO,EAAC,UAAS,qBAAoB,MAAK,gBAAe,CAAC,EAAE,OAAO,EAAE,MAAM,MAAM,KAAK,QAAQ,EAAC,GAAG,OAAM,UAAS,kBAAiB,OAAM,KAAK,QAAQ,MAAK,GAAE,MAAM,CAAC;AAAA,EAAE;AAAA,EACvT,MAAM,QAAQ,IAAU,QAAoB,SAAyC;AAAC,UAAM,SAAO,sBAAsB,MAAM,MAAM,KAAK,QAAQ,EAAC,UAAS,WAAU,OAAM,KAAK,QAAQ,OAAM,IAAG,GAAG,QAAO,GAAE,MAAM,CAAC;AAAE,QAAG,OAAO,KAAK,SAAK,IAAI,aAAW,EAAE,EAAE,OAAM,IAAI,uBAAuB,KAAI,sCAAqC,0CAA0C;AAAE,WAAO;AAAA,EAAO;AAAA,EAClY,MAAM,QAAQ,aAAmB,WAAkF,QAAqB;AACtI,WAAO,sBAAsB,MAAM,MAAM,KAAK,QAAQ,EAAC,UAAS,WAAU,OAAM,KAAK,QAAQ,OAAM,aAAY,GAAI,YAAU,EAAC,UAAS,IAAE,CAAC,EAAE,GAAE,MAAM,CAAC;AAAA,EACvJ;AAAA,EACA,MAAM,QAAQ,QAAqB;AAAC,WAAO,EAAE,MAAM,EAAE,OAAO,EAAC,QAAO,EAAE,OAAO,GAAE,MAAK,EAAE,OAAO,EAAE,SAAS,GAAE,OAAM,EAAE,OAAO,EAAE,SAAS,GAAE,MAAK,EAAE,OAAO,EAAC,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,MAAM,KAAK,QAAQ,EAAC,UAAS,WAAU,OAAM,KAAK,QAAQ,MAAK,GAAE,MAAM,CAAC;AAAA,EAAE;AAAA,EAClP,MAAM,QAAQ,KAAkC,QAAsB;AACpE,UAAM,OAAO,2BAA2B,MAAM,GAAG;AACjD,QAAG,KAAK,UAAQ,KAAK,QAAQ,MAAM,OAAM,IAAI,uBAAuB,KAAI,sBAAqB,mDAAmD;AAChJ,UAAM,aAAW,KAAK,UAAU,IAAI;AAAE,QAAG,IAAI,YAAY,EAAE,OAAO,UAAU,EAAE,aAAW,QAAQ,OAAM,IAAI,uBAAuB,KAAI,2BAA0B,+CAA+C;AAC/M,UAAM,WAAW,OAAO,KAAK,QAAQ,SAAS,WAAW,OAAO,GAAG,KAAK,QAAQ,OAAO,oBAAoB,EAAE,QAAQ,QAAQ,SAAS,EAAE,eAAe,UAAU,KAAK,QAAQ,MAAM,IAAI,gBAAgB,oBAAoB,sBAAsB,KAAK,QAAQ,MAAM,GAAG,MAAM,YAAY,QAAO,UAAS,QAAQ,CAAC;AACnT,UAAM,SAAO,SAAS,MAAM,UAAU,GAAE,SAAoB,CAAC;AAAE,QAAI,OAAK;AACxE,QAAG,QAAO;AAAC,UAAG;AAAC,eAAM,MAAK;AAAC,gBAAM,OAAK,MAAM,OAAO,KAAK;AAAE,cAAG,KAAK,KAAK;AAAM,kBAAM,KAAK,MAAM;AAAW,cAAG,OAAK,SAAQ;AAAC,kBAAM,OAAO,OAAO;AAAE,kBAAM,IAAI,uBAAuB,KAAI,4BAA2B,gDAAgD;AAAA,UAAE;AAAC,iBAAO,KAAK,KAAK,KAAK;AAAA,QAAE;AAAA,MAAC,UAAC;AAAQ,eAAO,YAAY;AAAA,MAAE;AAAA,IAAC;AAC3T,UAAM,QAAM,IAAI,WAAW,IAAI;AAAE,QAAI,SAAO;AAAE,eAAU,SAAS,QAAO;AAAC,YAAM,IAAI,OAAM,MAAM;AAAE,gBAAQ,MAAM;AAAA,IAAW;AAC1H,QAAI;AAAa,QAAG;AAAC,aAAK,KAAK,MAAM,IAAI,YAAY,SAAQ,EAAC,OAAM,KAAI,CAAC,EAAE,OAAO,KAAK,CAAC;AAAA,IAAE,QAAM;AAAC,YAAM,IAAI,uBAAuB,KAAI,0BAAyB,oCAAoC;AAAA,IAAE;AACrM,QAAI,CAAC,SAAS,IAAI;AAAE,YAAM,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,UAAU,IAAI;AAAG,YAAM,IAAI,uBAAuB,SAAS,QAAQ,QAAQ,UAAU,QAAQ,KAAK,QAAQ,yBAAyB,wBAAwB,QAAQ,UAAU,QAAQ,KAAK,SAAS,2BAA2B,wBAAwB;AAAA,IAAG;AACnX,QAAG,KAAK,aAAW,WAAU;AAC3B,YAAM,SAAO,sBAAsB,MAAM,IAAI,GAAE,EAAC,aAAY,MAAK,GAAG,QAAO,IAAE;AAC7E,UAAG,OAAO,gBAAc,KAAK,eAAa,YAAY,OAAO,MAAI,QAAM,KAAK,cAAY,UAAW,YAAY,OAAO,SAAS,MAAI,YAAY,KAAK,SAAS,EAAE,OAAM,IAAI,uBAAuB,KAAI,kCAAiC,6EAA6E;AAAA,IACpT;AACA,QAAG,KAAK,aAAW,cAAY,KAAK,aAAW,oBAAmB;AAAC,YAAM,SAAO,EAAE,OAAO,EAAC,UAAS,qBAAoB,MAAK,gBAAe,CAAC,EAAE,OAAO,EAAE,MAAM,IAAI;AAAE,UAAG,OAAO,SAAS,cAAc,OAAK,KAAK,YAAU,OAAO,SAAS,SAAS,WAAS,KAAK,WAAW,UAAQ,OAAO,SAAS,SAAS,KAAK,CAAC,GAAE,MAAI,EAAE,iBAAe,KAAK,WAAW,CAAC,EAAG,eAAa,EAAE,cAAY,KAAK,WAAW,CAAC,EAAG,SAAS,EAAE,OAAM,IAAI,uBAAuB,KAAI,oCAAmC,0DAA0D;AAAA,IAAE;AAC1hB,QAAG,KAAK,aAAW,iBAAgB;AAAC,YAAM,SAAO,EAAE,OAAO,EAAC,UAAS,qBAAoB,MAAK,gBAAe,CAAC,EAAE,OAAO,EAAE,MAAM,IAAI;AAAE,UAAG,CAAC,OAAO,SAAS,eAAa,OAAO,SAAS,SAAS,WAAS,KAAK,SAAS,SAAS,UAAQ,OAAO,SAAS,SAAS,KAAK,CAAC,SAAQ,UAAQ,QAAQ,aAAa,SAAO,0BAAwB,QAAQ,iBAAe,KAAK,SAAS,SAAS,KAAK,EAAG,eAAa,QAAQ,cAAY,KAAK,SAAS,SAAS,KAAK,EAAG,aAAW,QAAQ,YAAY,wBAAsB,KAAK,SAAS,SAAS,KAAK,EAAG,OAAO,mBAAmB,EAAE,OAAM,IAAI,uBAAuB,KAAI,uCAAsC,8DAA8D;AAAA,IAAE;AAC1rB,QAAG,KAAK,aAAW,kBAAiB;AAAC,YAAM,SAAO,EAAE,OAAO,EAAC,UAAS,qBAAoB,MAAK,gBAAe,CAAC,EAAE,OAAO,EAAE,MAAM,IAAI;AAAE,UAAG,OAAO,SAAS,cAAc,OAAK,KAAK,YAAU,YAAY,OAAO,SAAS,OAAO,MAAI,YAAY,KAAK,OAAO,MAAI,KAAK,YAAU,UAAW,YAAY,OAAO,SAAS,OAAO,MAAI,YAAY,KAAK,OAAO,KAAG,CAAC,OAAO,SAAS,SAAS,UAAQ,IAAI,IAAI,OAAO,SAAS,OAAO,EAAE,SAAO,OAAO,SAAS,QAAQ,QAAQ,OAAM,IAAI,uBAAuB,KAAI,oCAAmC,sDAAsD;AAAA,IAAE;AACnkB,WAAO;AAAA,EACT;AACF;",
+  "names": []
+}