openpond-sdk 0.3.3 → 0.4.0

package/dist/chunk-747CMU2Y.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/model-starters.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\nimport { TasksetReleaseSchema, assertTasksetRelease } from \"@openpond/evals/tasksets\";\nimport { LearningTextAssetSchema, TaskDefinitionSchema, learningRef, sameLearningRef, sealLearningContent } from \"@openpond/evals/learning\";\nimport { RewardBindingSchema, RewardReleaseSchema, compileBoundGraders } from \"@openpond/evals/rewards\";\nimport { assertBoundedTaskJson, validateTaskValue } from \"@openpond/evals/task-schema\";\n\nimport { ModelProjectBaseModelSchema, ModelProjectTrainingMethodSchema, ModelProjectVersionedRefSchema } from \"./model-projects.js\";\nimport { canonicalSha256 } from \"./protocol.js\";\nimport { ModelStarterExecutionSchema, validateModelStarterExecution } from \"./model-starter-execution.js\";\n\nexport { ModelStarterExecutionSchema, ModelStarterEnvironmentAttemptSchema, verifyModelStarterEnvironmentAttempt, ModelStarterToolFixtureScriptSchema, createModelStarterExecutionAsset, modelStarterExecutionAssetId, resolveModelStarterExecutionAsset, type ModelStarterExecution, type ModelStarterExecutionContext } from \"./model-starter-execution.js\";\nexport { ModelTasksetDerivationSchema, ModelTasksetPackageSchema, deriveModelTaskset, validateModelTasksetPackage, type ModelTasksetPackage } from \"./model-taskset-derivation.js\";\nexport { ModelTasksetExecutionResourcesSchema, createModelTasksetExecutionResourcesAsset, modelTasksetExecutionResourcesAssetId, resolveModelTasksetExecutionResourcesAsset } from \"./model-taskset-resources.js\";\n\nconst IdSchema = z.string().trim().min(1).max(500);\nconst RefSchema = ModelProjectVersionedRefSchema;\n\n/** Catalog records contain references and previews, never the private task rows. */\nexport const ModelStarterContentSchema = z.object({\n  schemaVersion: z.literal(\"openpond.modelStarter.v1\"),\n  id: IdSchema,\n  revision: z.number().int().positive(),\n  name: z.string().trim().min(1).max(200),\n  description: z.string().trim().min(1).max(2_000),\n  category: z.enum([\"extraction\", \"support\", \"operations\", \"knowledge\", \"coding\", \"writing\", \"classification\"]),\n  taskset: RefSchema,\n  taskDefinition: RefSchema,\n  rewardBinding: RefSchema,\n  rewards: z.array(RefSchema).min(1).max(100),\n  assets: z.array(RefSchema).max(1_000),\n  previewTaskIds: z.array(IdSchema).min(1).max(8),\n  startingModel: ModelProjectBaseModelSchema,\n  supportedMethods: z.array(ModelProjectTrainingMethodSchema).min(1).max(8),\n  defaultMethod: ModelProjectTrainingMethodSchema,\n  provenance: z.object({ author: z.string().min(1).max(200), license: z.string().min(1).max(200), sourceDescription: z.string().min(1).max(2_000) }).strict(),\n  // These are references to real results. Package publication does not create\n  // evidence, qualify a starter, or enable continuous learning.\n  evidence: z.object({ verifierFixtures: RefSchema.nullable(), baseline: RefSchema.nullable(), training: RefSchema.nullable(), evaluation: RefSchema.nullable() }).strict(),\n}).strict().superRefine((starter, context) => {\n  if (!starter.supportedMethods.includes(starter.defaultMethod)) context.addIssue({ code: \"custom\", path: [\"defaultMethod\"], message: \"The default method must be supported by the package.\" });\n  for (const field of [\"rewards\", \"assets\"] as const) {\n    if (new Set(starter[field].map(ref => ref.id)).size !== starter[field].length) context.addIssue({ code: \"custom\", path: [field], message: \"Dependency identities must be unique.\" });\n  }\n  if (new Set(starter.previewTaskIds).size !== starter.previewTaskIds.length) context.addIssue({ code: \"custom\", path: [\"previewTaskIds\"], message: \"Preview tasks must be unique.\" });\n});\nexport const ModelStarterSchema = ModelStarterContentSchema.safeExtend({ contentHash: z.string().regex(/^[a-f0-9]{64}$/) });\nexport type ModelStarter = z.infer<typeof ModelStarterSchema>;\n\n/** A resolved small package, obtained separately from catalog discovery.\n * Large Tasksets remain manifest/shard resources; they are not list payloads. */\nexport const ResolvedModelStarterSchema = z.object({\n  starter: ModelStarterSchema,\n  taskset: TasksetReleaseSchema,\n  taskDefinition: TaskDefinitionSchema,\n  rewardBinding: RewardBindingSchema,\n  rewards: z.array(RewardReleaseSchema).min(1).max(100),\n  assets: z.array(LearningTextAssetSchema).max(1_000),\n  execution: ModelStarterExecutionSchema.optional(),\n}).strict();\nexport type ResolvedModelStarter = z.infer<typeof ResolvedModelStarterSchema>;\n\n/** Publisher attestation for original synthetic contact data, never a caller\n * override for arbitrary imports or for a failed secret scan. */\nexport const ModelStarterPrivacyReviewSchema = z.object({\n  schemaVersion: z.literal(\"openpond.modelStarterPrivacyReview.v1\"),\n  disposition: z.literal(\"synthetic_only\"),\n  reviewedBy: z.string().trim().min(1).max(500), reviewedAt: z.iso.datetime(),\n  reviewedContentHash: z.string().regex(/^[a-f0-9]{64}$/),\n  note: z.string().trim().min(1).max(2_000),\n}).strict();\nexport function modelStarterPrivacyContentHash(value: ResolvedModelStarter): string {\n  const { contentHash: _starterHash, ...starter } = value.starter;\n  const { contentHash: _tasksetHash, ...taskset } = value.taskset;\n  const { contentHash: _referenceHash, ...tasksetRef } = starter.taskset;\n  const metadata = { ...taskset.metadata };\n  const authoring = metadata.starterAuthoring;\n  if (authoring && typeof authoring === \"object\" && !Array.isArray(authoring)) {\n    const { privacyReview: _review, ...content } = authoring as Record<string, unknown>;\n    metadata.starterAuthoring = content;\n  }\n  // Exclude only the attestation and hashes that contain that attestation.\n  return sealLearningContent({ ...value, starter: { ...starter, taskset: tasksetRef }, taskset: { ...taskset, metadata } }).contentHash;\n}\n\n/** Final creation intent. The server resolves package bytes from its catalog;\n * callers cannot supply executable resources or qualification receipts here. */\nexport const ModelStarterCreationIntentSchema = z.object({\n  profileId: IdSchema,\n  modelId: IdSchema,\n  name: z.string().trim().min(1).max(200),\n  starter: RefSchema,\n  startingModel: ModelProjectBaseModelSchema,\n  method: ModelProjectTrainingMethodSchema,\n  rewardBindingRef: RefSchema.nullable().optional(),\n}).strict();\nexport const ModelStarterCreationRequestSchema = ModelStarterCreationIntentSchema.extend({\n  schemaVersion: z.literal(\"openpond.modelStarterCreation.v1\"),\n  operationId: IdSchema,\n}).strict();\nexport type ModelStarterCreationRequest = z.infer<typeof ModelStarterCreationRequestSchema>;\n\nexport function parseModelStarterCreationRequest(value: unknown): ModelStarterCreationRequest {\n  assertBoundedTaskJson(value, 64 * 1024);\n  return ModelStarterCreationRequestSchema.parse(value);\n}\n\n/** Prepare once on final confirmation and retain across uncertain transport\n * outcomes. The server must bind operationId to the complete original intent\n * and atomically commit resources, model configuration and the retry receipt. */\nexport async function createModelStarterCreationRequest(\n  value: z.input<typeof ModelStarterCreationIntentSchema>,\n): Promise<ModelStarterCreationRequest> {\n  assertBoundedTaskJson(value, 64 * 1024);\n  const intent = ModelStarterCreationIntentSchema.parse(value);\n  return parseModelStarterCreationRequest({\n    ...intent,\n    schemaVersion: \"openpond.modelStarterCreation.v1\",\n    operationId: `model-starter:${await canonicalSha256(intent)}`,\n  });\n}\n\n/** Scope authorization belongs to the API. This validates the final intent\n * against the exact trusted package before any user resources are written. */\nexport function validateModelStarterCreation(value: unknown, packageValue: unknown) {\n  const request = parseModelStarterCreationRequest(value);\n  const resolved = validateResolvedModelStarter(packageValue);\n  if (!sameLearningRef(request.starter, learningRef(resolved.starter))) throw new Error(\"Starter creation references a different package revision.\");\n  if (!resolved.starter.supportedMethods.includes(request.method)) throw new Error(\"The selected training method is not supported by this starter.\");\n  return { request, resolved };\n}\n\n/** Explicit projection keeps frozen examples, expected outputs, privileged\n * context and verifier source out of read-only model-facing previews. */\nexport function previewModelStarter(value: unknown) {\n  const { starter, taskset, taskDefinition, rewardBinding, rewards } = validateResolvedModelStarter(value);\n  return {\n    starter,\n    inputSchema: taskDefinition.inputSchema,\n    outputSchema: taskDefinition.outputSchema,\n    reward: {\n      name: rewardBinding.name,\n      description: rewardBinding.description,\n      checks: rewardBinding.sources.map(source => {\n        const reward = rewards.find(reward => sameLearningRef(source.reward, learningRef(reward)))!;\n        return { name: reward.name, description: reward.description, kind: reward.implementation.kind, role: source.role, weight: source.weight, required: source.required, hardGate: source.hardGate };\n      }),\n    },\n    tasks: starter.previewTaskIds.map(id => {\n      const task = taskset.tasks.find(task => task.id === id)!;\n      return { id: task.id, input: task.input, policyVisibleContext: task.policyVisibleContext };\n    }),\n    counts: {\n      train: taskset.tasks.filter(task => task.split === \"train\").length,\n      validation: taskset.tasks.filter(task => task.split === \"validation\").length,\n      frozenEvaluation: taskset.tasks.filter(task => task.split === \"frozen_eval\").length,\n    },\n  };\n}\n\n/** Verify the dependency graph before creating user-owned configuration.\n * A matching outer hash alone cannot authorize substituted private graders. */\nexport function validateResolvedModelStarter(value: unknown): ResolvedModelStarter {\n  assertBoundedTaskJson(value, 16 * 1024 * 1024);\n  const resolved = ResolvedModelStarterSchema.parse(value);\n  const { starter, taskset, taskDefinition, rewardBinding, rewards, assets } = resolved;\n  const authoring = taskset.metadata.starterAuthoring;\n  if (authoring && typeof authoring === \"object\" && !Array.isArray(authoring) && \"privacyReview\" in authoring) {\n    const review = ModelStarterPrivacyReviewSchema.parse(authoring.privacyReview);\n    if (review.reviewedContentHash !== modelStarterPrivacyContentHash(resolved)) throw new Error(\"Starter privacy review differs from the published contents.\");\n  }\n  const resources = [starter, taskset, taskDefinition, rewardBinding, ...rewards, ...assets];\n  for (const resource of resources) {\n    const { contentHash, ...content } = resource;\n    if (sealLearningContent(content).contentHash !== contentHash) throw new Error(`Starter resource integrity failed: ${resource.id}.`);\n  }\n  assertTasksetRelease(taskset);\n  validateModelStarterExecution(resolved.execution, taskset, assets);\n  function exact(expected: z.infer<typeof RefSchema>, resource: { id: string; revision: number; contentHash: string }) {\n    if (!sameLearningRef(expected, learningRef(resource))) throw new Error(`Starter dependency mismatch: ${expected.id}.`);\n  }\n  exact(starter.taskset, taskset);\n  exact(starter.taskDefinition, taskDefinition);\n  exact(starter.rewardBinding, rewardBinding);\n  exact(taskDefinition.rewardBinding, rewardBinding);\n  if (rewardBinding.recipeRef) throw new Error(\"Starter binding recipes must be resolved into a standalone binding before publication.\");\n  const { policy, environment, environmentRelease, tools, capabilities, verifierSetRelease } = taskset;\n  const execution = { policy, environment, ...(environmentRelease ? { environmentRelease } : {}), tools, capabilities, ...(verifierSetRelease ? { verifierSetRelease } : {}) };\n  if (sealLearningContent(execution).contentHash !== sealLearningContent(taskDefinition.execution).contentHash) throw new Error(\"Starter execution context differs from its task format.\");\n  if (sealLearningContent({ graders: taskset.graders }).contentHash !== sealLearningContent({ graders: compileBoundGraders(rewardBinding, rewards) }).contentHash) throw new Error(\"Starter executable graders differ from its Reward binding.\");\n  for (const [references, values] of [[starter.rewards, rewards], [starter.assets, assets]] as const) {\n    if (references.length !== values.length || new Set(values.map(resource => resource.id)).size !== values.length) throw new Error(\"Starter dependency inventory mismatch.\");\n    for (const ref of references) {\n      const resource = values.find(value => value.id === ref.id);\n      if (!resource) throw new Error(`Starter dependency is missing: ${ref.id}.`);\n      exact(ref, resource);\n    }\n  }\n  for (const source of rewardBinding.sources) {\n    const reward = rewards.find(reward => reward.id === source.reward.id);\n    if (!reward) throw new Error(`Starter Reward is missing: ${source.reward.id}.`);\n    exact(source.reward, reward);\n  }\n  for (const reward of rewards) {\n    const implementation = reward.implementation;\n    const references = [...reward.assets,\n      ...(\"verifierRef\" in implementation ? [implementation.verifierRef] : []),\n      ...(\"rubricRef\" in implementation ? [implementation.rubricRef] : []),\n      ...(\"inputContract\" in implementation ? [implementation.inputContract] : []),\n    ];\n    for (const ref of references) {\n      const asset = assets.find(asset => asset.id === ref.id);\n      if (!asset || sealLearningContent(asset.asset).contentHash !== sealLearningContent(ref).contentHash) throw new Error(`Starter Reward source is missing or changed: ${ref.id}.`);\n      if (ref.visibility === \"policy\") throw new Error(`Starter Reward source must remain private to its evaluator: ${ref.id}.`);\n    }\n  }\n  if (new Set(taskset.tasks.map(task => task.id)).size !== taskset.tasks.length) throw new Error(\"Starter task identities must be unique.\");\n  const inputSplits = new Map<string, string>();\n  for (const task of taskset.tasks) {\n    if (task.policyVisibleContext.instructions !== taskDefinition.instructions) throw new Error(`Starter task does not carry its declared model instructions: ${task.id}.`);\n    const inputHash = sealLearningContent({ input: task.input, context: task.policyVisibleContext }).contentHash;\n    const priorSplit = inputSplits.get(inputHash);\n    if (priorSplit && priorSplit !== task.split) throw new Error(\"Starter policy input appears in multiple splits.\");\n    inputSplits.set(inputHash, task.split);\n    if (!validateTaskValue(taskDefinition.inputSchema, task.input).valid) throw new Error(`Starter task input does not match its format: ${task.id}.`);\n    if (task.expectedOutput !== null && !validateTaskValue(taskDefinition.outputSchema, task.expectedOutput).valid) throw new Error(`Starter expected output does not match its format: ${task.id}.`);\n  }\n  for (const id of starter.previewTaskIds) {\n    const task = taskset.tasks.find(task => task.id === id);\n    if (!task || task.split === \"frozen_eval\") throw new Error(`Starter preview task is unavailable: ${id}.`);\n  }\n  return resolved;\n}\n"],
+  "mappings": "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",
+  "names": ["reward", "task", "value", "asset"]
+}

package/dist/chunk-7O5X7DBU.js

@@ -0,0 +1,80 @@
+import {
+  apiFetch,
+  readApiJson
+} from "./chunk-APHPXQEA.js";
+
+// src/workflows.ts
+import { randomUUID } from "node:crypto";
+var OpenPondWorkflowsClient = class {
+  #apiKey;
+  #apiBaseUrl;
+  constructor(input) {
+    this.#apiKey = input.apiKey;
+    this.#apiBaseUrl = input.apiBaseUrl.replace(/\/+$/, "");
+  }
+  async list(options = {}) {
+    return this.#request("", "List Workflows", {
+      signal: options.signal
+    });
+  }
+  async create(input, options = {}) {
+    return this.#request("", "Create Workflow", {
+      method: "POST",
+      body: JSON.stringify({
+        ...input,
+        clientRequestId: input.clientRequestId?.trim() || randomUUID()
+      }),
+      signal: options.signal
+    });
+  }
+  async update(scheduleId, input, options = {}) {
+    return this.#request(
+      `/schedules/${encodeURIComponent(requiredId(scheduleId, "scheduleId"))}`,
+      "Update Workflow",
+      {
+        method: "PATCH",
+        body: JSON.stringify(input),
+        signal: options.signal
+      }
+    );
+  }
+  async delete(scheduleId, options = {}) {
+    return this.#request(
+      `/schedules/${encodeURIComponent(requiredId(scheduleId, "scheduleId"))}`,
+      "Delete Workflow",
+      { method: "DELETE", signal: options.signal }
+    );
+  }
+  async runNow(scheduleId, input = {}, options = {}) {
+    return this.#request(
+      `/schedules/${encodeURIComponent(requiredId(scheduleId, "scheduleId"))}/run`,
+      "Run Workflow",
+      {
+        method: "POST",
+        body: JSON.stringify({
+          clientRequestId: input.clientRequestId?.trim() || randomUUID()
+        }),
+        signal: options.signal
+      }
+    );
+  }
+  async #request(suffix, label, options = {}) {
+    const response = await apiFetch(
+      this.#apiBaseUrl,
+      this.#apiKey,
+      `/v1/saved-work${suffix}`,
+      options
+    );
+    return readApiJson(response, label);
+  }
+};
+function requiredId(value, label) {
+  const normalized = value.trim();
+  if (!normalized) throw new Error(`${label} is required`);
+  return normalized;
+}
+
+export {
+  OpenPondWorkflowsClient
+};
+//# sourceMappingURL=chunk-7O5X7DBU.js.map

package/dist/chunk-7O5X7DBU.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/workflows.ts"],
+  "sourcesContent": ["import { randomUUID } from \"node:crypto\";\n\nimport { apiFetch, readApiJson } from \"@openpond/cloud/api/core\";\n\nexport type OpenPondWorkflowWeekday =\n  | \"sunday\"\n  | \"monday\"\n  | \"tuesday\"\n  | \"wednesday\"\n  | \"thursday\"\n  | \"friday\"\n  | \"saturday\";\n\nexport type OpenPondWorkflowRecurrence = {\n  version: 1;\n  kind: \"once\" | \"daily\" | \"weekdays\" | \"weekly\" | \"monthly\";\n  timeZone: string;\n  startDate: string;\n  localTime: string;\n  weekdays?: OpenPondWorkflowWeekday[];\n  dayOfMonth?: number;\n  end:\n    | { kind: \"never\" }\n    | { kind: \"on_date\"; date: string }\n    | { kind: \"after_occurrences\"; occurrences: number };\n};\n\nexport type OpenPondWorkflowSchedule = {\n  id: string;\n  expression: string | null;\n  timeZone: string;\n  recurrence: OpenPondWorkflowRecurrence | null;\n  configurationVersion: number;\n  enabled: boolean;\n  nextRunAt: string | null;\n  lastTriggeredAt: string | null;\n  delivery: Record<string, unknown>;\n};\n\nexport type OpenPondWorkflowDefinition = {\n  id: string;\n  definitionKey: string;\n  version: number;\n  name: string;\n  prompt: string;\n  modelId: string;\n  schedules: OpenPondWorkflowSchedule[];\n};\n\nexport type OpenPondWorkflowRun = {\n  id: string;\n  definitionId: string;\n  scheduleId: string | null;\n  definitionName: string;\n  definitionVersion: number;\n  conversationId: string;\n  triggerKind: \"manual\" | \"schedule\" | \"webhook\" | \"retry\";\n  status: string;\n  notificationStatus: string;\n  deliveryStatus: string;\n  deliveryError: string | null;\n  createdAt: string;\n};\n\nexport type OpenPondWorkflowCatalog = {\n  definitions: OpenPondWorkflowDefinition[];\n  runs: OpenPondWorkflowRun[];\n  asOf: string;\n};\n\nexport type OpenPondWorkflowCreateInput = {\n  clientRequestId?: string;\n  sourceTurnId?: string | null;\n  name: string;\n  prompt: string;\n  recurrence: OpenPondWorkflowRecurrence;\n  modelId?: string;\n  enabled?: boolean;\n  target?:\n    | { kind: \"prompt\" }\n    | {\n        kind: \"external_callback\";\n        callbackUrl: string;\n        externalReference: string;\n      };\n};\n\nexport type OpenPondWorkflowCreateResult = {\n  created: boolean;\n  definitionId: string;\n  scheduleId: string;\n  name: string;\n  enabled: boolean;\n  nextRunAt: string | null;\n  recurrence: OpenPondWorkflowRecurrence | null;\n  timeZone: string;\n};\n\nexport type OpenPondWorkflowUpdateInput =\n  | { enabled: boolean }\n  | {\n      name: string;\n      prompt: string;\n      recurrence: OpenPondWorkflowRecurrence;\n    };\n\nexport type OpenPondWorkflowUpdateResult = {\n  definitionId?: string;\n  schedule: {\n    id: string;\n    enabled: boolean;\n    nextRunAt: string | null;\n  };\n};\n\nexport type OpenPondWorkflowDeleteResult = {\n  schedule: {\n    id: string;\n    archived: true;\n  };\n};\n\nexport type OpenPondWorkflowRunNowResult = {\n  runId: string;\n  conversationId: string;\n};\n\nexport type OpenPondWorkflowRequestOptions = {\n  signal?: AbortSignal;\n};\n\ntype WorkflowsClientInput = {\n  apiKey: string;\n  apiBaseUrl: string;\n};\n\nexport class OpenPondWorkflowsClient {\n  readonly #apiKey: string;\n  readonly #apiBaseUrl: string;\n\n  constructor(input: WorkflowsClientInput) {\n    this.#apiKey = input.apiKey;\n    this.#apiBaseUrl = input.apiBaseUrl.replace(/\\/+$/, \"\");\n  }\n\n  async list(\n    options: OpenPondWorkflowRequestOptions = {},\n  ): Promise<OpenPondWorkflowCatalog> {\n    return this.#request<OpenPondWorkflowCatalog>(\"\", \"List Workflows\", {\n      signal: options.signal,\n    });\n  }\n\n  async create(\n    input: OpenPondWorkflowCreateInput,\n    options: OpenPondWorkflowRequestOptions = {},\n  ): Promise<OpenPondWorkflowCreateResult> {\n    return this.#request<OpenPondWorkflowCreateResult>(\"\", \"Create Workflow\", {\n      method: \"POST\",\n      body: JSON.stringify({\n        ...input,\n        clientRequestId: input.clientRequestId?.trim() || randomUUID(),\n      }),\n      signal: options.signal,\n    });\n  }\n\n  async update(\n    scheduleId: string,\n    input: OpenPondWorkflowUpdateInput,\n    options: OpenPondWorkflowRequestOptions = {},\n  ): Promise<OpenPondWorkflowUpdateResult> {\n    return this.#request<OpenPondWorkflowUpdateResult>(\n      `/schedules/${encodeURIComponent(requiredId(scheduleId, \"scheduleId\"))}`,\n      \"Update Workflow\",\n      {\n        method: \"PATCH\",\n        body: JSON.stringify(input),\n        signal: options.signal,\n      },\n    );\n  }\n\n  async delete(\n    scheduleId: string,\n    options: OpenPondWorkflowRequestOptions = {},\n  ): Promise<OpenPondWorkflowDeleteResult> {\n    return this.#request<OpenPondWorkflowDeleteResult>(\n      `/schedules/${encodeURIComponent(requiredId(scheduleId, \"scheduleId\"))}`,\n      \"Delete Workflow\",\n      { method: \"DELETE\", signal: options.signal },\n    );\n  }\n\n  async runNow(\n    scheduleId: string,\n    input: { clientRequestId?: string } = {},\n    options: OpenPondWorkflowRequestOptions = {},\n  ): Promise<OpenPondWorkflowRunNowResult> {\n    return this.#request<OpenPondWorkflowRunNowResult>(\n      `/schedules/${encodeURIComponent(requiredId(scheduleId, \"scheduleId\"))}/run`,\n      \"Run Workflow\",\n      {\n        method: \"POST\",\n        body: JSON.stringify({\n          clientRequestId: input.clientRequestId?.trim() || randomUUID(),\n        }),\n        signal: options.signal,\n      },\n    );\n  }\n\n  async #request<T>(\n    suffix: string,\n    label: string,\n    options: RequestInit = {},\n  ): Promise<T> {\n    const response = await apiFetch(\n      this.#apiBaseUrl,\n      this.#apiKey,\n      `/v1/saved-work${suffix}`,\n      options,\n    );\n    return readApiJson<T>(response, label);\n  }\n}\n\nfunction requiredId(value: string, label: string): string {\n  const normalized = value.trim();\n  if (!normalized) throw new Error(`${label} is required`);\n  return normalized;\n}\n"],
+  "mappings": ";;;;;;AAAA,SAAS,kBAAkB;AAwIpB,IAAM,0BAAN,MAA8B;AAAA,EAC1B;AAAA,EACA;AAAA,EAET,YAAY,OAA6B;AACvC,SAAK,UAAU,MAAM;AACrB,SAAK,cAAc,MAAM,WAAW,QAAQ,QAAQ,EAAE;AAAA,EACxD;AAAA,EAEA,MAAM,KACJ,UAA0C,CAAC,GACT;AAClC,WAAO,KAAK,SAAkC,IAAI,kBAAkB;AAAA,MAClE,QAAQ,QAAQ;AAAA,IAClB,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,OACJ,OACA,UAA0C,CAAC,GACJ;AACvC,WAAO,KAAK,SAAuC,IAAI,mBAAmB;AAAA,MACxE,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU;AAAA,QACnB,GAAG;AAAA,QACH,iBAAiB,MAAM,iBAAiB,KAAK,KAAK,WAAW;AAAA,MAC/D,CAAC;AAAA,MACD,QAAQ,QAAQ;AAAA,IAClB,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,OACJ,YACA,OACA,UAA0C,CAAC,GACJ;AACvC,WAAO,KAAK;AAAA,MACV,cAAc,mBAAmB,WAAW,YAAY,YAAY,CAAC,CAAC;AAAA,MACtE;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,MAAM,KAAK,UAAU,KAAK;AAAA,QAC1B,QAAQ,QAAQ;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,OACJ,YACA,UAA0C,CAAC,GACJ;AACvC,WAAO,KAAK;AAAA,MACV,cAAc,mBAAmB,WAAW,YAAY,YAAY,CAAC,CAAC;AAAA,MACtE;AAAA,MACA,EAAE,QAAQ,UAAU,QAAQ,QAAQ,OAAO;AAAA,IAC7C;AAAA,EACF;AAAA,EAEA,MAAM,OACJ,YACA,QAAsC,CAAC,GACvC,UAA0C,CAAC,GACJ;AACvC,WAAO,KAAK;AAAA,MACV,cAAc,mBAAmB,WAAW,YAAY,YAAY,CAAC,CAAC;AAAA,MACtE;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,MAAM,KAAK,UAAU;AAAA,UACnB,iBAAiB,MAAM,iBAAiB,KAAK,KAAK,WAAW;AAAA,QAC/D,CAAC;AAAA,QACD,QAAQ,QAAQ;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,SACJ,QACA,OACA,UAAuB,CAAC,GACZ;AACZ,UAAM,WAAW,MAAM;AAAA,MACrB,KAAK;AAAA,MACL,KAAK;AAAA,MACL,iBAAiB,MAAM;AAAA,MACvB;AAAA,IACF;AACA,WAAO,YAAe,UAAU,KAAK;AAAA,EACvC;AACF;AAEA,SAAS,WAAW,OAAe,OAAuB;AACxD,QAAM,aAAa,MAAM,KAAK;AAC9B,MAAI,CAAC,WAAY,OAAM,IAAI,MAAM,GAAG,KAAK,cAAc;AACvD,SAAO;AACT;",
+  "names": []
+}

package/dist/chunk-A4ZDOZKP.js

@@ -0,0 +1,115 @@
+// src/taskset-catalog.ts
+import { z } from "zod";
+var IdSchema = z.string().trim().min(1).max(500);
+var HashSchema = z.string().regex(/^[a-f0-9]{64}$/);
+var TasksetCatalogReleaseRefSchema = z.object({ id: IdSchema, revision: z.number().int().positive(), contentHash: HashSchema }).strict();
+var HostedTasksetSummarySchema = z.object({
+  schemaVersion: z.literal("openpond.hostedTasksetSummary.v1"),
+  id: IdSchema,
+  teamId: IdSchema,
+  release: TasksetCatalogReleaseRefSchema,
+  name: z.string().min(1).max(500),
+  description: z.string().max(2e4),
+  taskCount: z.number().int().nonnegative(),
+  buildIntent: z.string().min(1).max(100),
+  methodHint: z.string().min(1).max(100).nullable(),
+  packageBytes: z.number().int().nonnegative().nullable(),
+  storedBytes: z.number().int().nonnegative().nullable(),
+  createdAt: z.string().datetime({ offset: true })
+}).strict();
+var TasksetCatalogQuerySchema = z.object({
+  afterId: IdSchema.optional(),
+  limit: z.number().int().min(1).max(100).default(30),
+  modelProjectId: IdSchema.optional()
+}).strict();
+var TasksetCatalogPageSchema = z.object({
+  items: z.array(HostedTasksetSummarySchema).max(100),
+  nextCursor: IdSchema.nullable()
+}).strict();
+var TasksetCatalogErrorSchema = z.object({
+  code: z.string().min(1),
+  message: z.string().min(1)
+}).strict();
+var OpenPondTasksetCatalogError = class extends Error {
+  constructor(status, code, message) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "OpenPondTasksetCatalogError";
+  }
+  status;
+  code;
+};
+var OpenPondTasksetCatalogClient = class {
+  #options;
+  constructor(options) {
+    if (!options.apiKey.trim() || !options.teamId.trim()) throw new Error("Taskset API key and workspace are required.");
+    const url = new URL(options.baseUrl);
+    if (!["http:", "https:"].includes(url.protocol) || url.username || url.password || url.search || url.hash) throw new Error("Taskset base URL must be an HTTP(S) endpoint without credentials, query, or fragment.");
+    this.#options = { ...options, baseUrl: url.toString().replace(/\/+$/, "") };
+  }
+  async list(query = {}, options = {}) {
+    const parsed = TasksetCatalogQuerySchema.parse(query);
+    const search = new URLSearchParams({ limit: String(parsed.limit) });
+    if (parsed.afterId) search.set("afterId", parsed.afterId);
+    if (parsed.modelProjectId) search.set("modelProjectId", parsed.modelProjectId);
+    const page = TasksetCatalogPageSchema.parse(await this.#request(`?${search}`, options.signal));
+    if (page.items.length > parsed.limit || page.items.some((item) => item.teamId !== this.#options.teamId)) throw new OpenPondTasksetCatalogError(502, "catalog_scope_mismatch", "Taskset inventory did not match the requested workspace or page size.");
+    return page;
+  }
+  async get(id, options = {}) {
+    const parsed = IdSchema.parse(id);
+    const item = HostedTasksetSummarySchema.parse(await this.#request(`/${encodeURIComponent(parsed)}`, options.signal));
+    if (item.id !== parsed || item.teamId !== this.#options.teamId) throw new OpenPondTasksetCatalogError(502, "catalog_identity_mismatch", "Taskset metadata did not match the requested identity.");
+    return item;
+  }
+  /** Resolve a saved portable reference without scanning inventory pages. */
+  async resolve(release, options = {}) {
+    const parsed = TasksetCatalogReleaseRefSchema.parse(release);
+    const item = HostedTasksetSummarySchema.parse(await this.#request(`/releases/${encodeURIComponent(parsed.id)}/${parsed.revision}/${parsed.contentHash}`, options.signal));
+    if (item.teamId !== this.#options.teamId || item.release.id !== parsed.id || item.release.revision !== parsed.revision || item.release.contentHash !== parsed.contentHash) throw new OpenPondTasksetCatalogError(502, "catalog_release_mismatch", "Taskset metadata did not match the requested immutable release.");
+    return item;
+  }
+  async #request(path, signal) {
+    const response = await (this.#options.fetch ?? globalThis.fetch)(`${this.#options.baseUrl}/v1/taskset-catalog${path}`, {
+      headers: { Authorization: `Bearer ${this.#options.apiKey}`, "X-OpenPond-Team-Id": this.#options.teamId, Accept: "application/json" },
+      signal,
+      redirect: "error"
+    });
+    const reader = response.body?.getReader();
+    if (!reader) throw new OpenPondTasksetCatalogError(response.status, "empty_response", "Taskset catalog response was empty.");
+    const decoder = new TextDecoder();
+    let bytes = 0;
+    let text = "";
+    try {
+      while (true) {
+        const chunk = await reader.read();
+        if (chunk.done) break;
+        bytes += chunk.value.byteLength;
+        if (bytes > 4194304) throw new OpenPondTasksetCatalogError(response.status, "response_too_large", "Taskset catalog response exceeded 4 MiB.");
+        text += decoder.decode(chunk.value, { stream: true });
+      }
+      text += decoder.decode();
+    } finally {
+      await reader.cancel();
+      reader.releaseLock();
+    }
+    const payload = JSON.parse(text);
+    if (!response.ok) {
+      const error = TasksetCatalogErrorSchema.safeParse(payload);
+      throw new OpenPondTasksetCatalogError(response.status, error.success ? error.data.code : "invalid_error_response", error.success ? error.data.message : `Taskset catalog request failed (${response.status}).`);
+    }
+    return payload;
+  }
+};
+
+export {
+  TasksetCatalogReleaseRefSchema,
+  HostedTasksetSummarySchema,
+  TasksetCatalogQuerySchema,
+  TasksetCatalogPageSchema,
+  TasksetCatalogErrorSchema,
+  OpenPondTasksetCatalogError,
+  OpenPondTasksetCatalogClient
+};
+//# sourceMappingURL=chunk-A4ZDOZKP.js.map

package/dist/chunk-A4ZDOZKP.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/taskset-catalog.ts"],
+  "sourcesContent": ["import { z } from \"zod\";\n\nconst IdSchema = z.string().trim().min(1).max(500);\nconst HashSchema = z.string().regex(/^[a-f0-9]{64}$/);\nexport const TasksetCatalogReleaseRefSchema = z.object({ id: IdSchema, revision: z.number().int().positive(), contentHash: HashSchema }).strict();\n\n/** Inventory metadata only. Task rows, evaluator source, and object locations\n * are resolved separately by an authorized package operation. */\nexport const HostedTasksetSummarySchema = z.object({\n  schemaVersion: z.literal(\"openpond.hostedTasksetSummary.v1\"),\n  id: IdSchema,\n  teamId: IdSchema,\n  release: TasksetCatalogReleaseRefSchema,\n  name: z.string().min(1).max(500),\n  description: z.string().max(20_000),\n  taskCount: z.number().int().nonnegative(),\n  buildIntent: z.string().min(1).max(100),\n  methodHint: z.string().min(1).max(100).nullable(),\n  packageBytes: z.number().int().nonnegative().nullable(),\n  storedBytes: z.number().int().nonnegative().nullable(),\n  createdAt: z.string().datetime({ offset: true }),\n}).strict();\nexport const TasksetCatalogQuerySchema = z.object({\n  afterId: IdSchema.optional(),\n  limit: z.number().int().min(1).max(100).default(30),\n  modelProjectId: IdSchema.optional(),\n}).strict();\nexport const TasksetCatalogPageSchema = z.object({\n  items: z.array(HostedTasksetSummarySchema).max(100),\n  nextCursor: IdSchema.nullable(),\n}).strict();\nexport const TasksetCatalogErrorSchema = z.object({\n  code: z.string().min(1),\n  message: z.string().min(1),\n}).strict();\nexport type HostedTasksetSummary = z.infer<typeof HostedTasksetSummarySchema>;\nexport type TasksetCatalogPage = z.infer<typeof TasksetCatalogPageSchema>;\n\nexport class OpenPondTasksetCatalogError extends Error {\n  constructor(readonly status: number, readonly code: string, message: string) {\n    super(message);\n    this.name = \"OpenPondTasksetCatalogError\";\n  }\n}\n\nexport interface TasksetCatalogClientOptions {\n  baseUrl: string;\n  apiKey: string;\n  teamId: string;\n  fetch?: typeof globalThis.fetch;\n}\n\nexport class OpenPondTasksetCatalogClient {\n  readonly #options: TasksetCatalogClientOptions;\n  constructor(options: TasksetCatalogClientOptions) {\n    if (!options.apiKey.trim() || !options.teamId.trim()) throw new Error(\"Taskset API key and workspace 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(\"Taskset 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 list(query: z.input<typeof TasksetCatalogQuerySchema> = {}, options: { signal?: AbortSignal } = {}): Promise<TasksetCatalogPage> {\n    const parsed = TasksetCatalogQuerySchema.parse(query);\n    const search = new URLSearchParams({ limit: String(parsed.limit) });\n    if (parsed.afterId) search.set(\"afterId\", parsed.afterId);\n    if (parsed.modelProjectId) search.set(\"modelProjectId\", parsed.modelProjectId);\n    const page = TasksetCatalogPageSchema.parse(await this.#request(`?${search}`, options.signal));\n    if (page.items.length > parsed.limit || page.items.some((item) => item.teamId !== this.#options.teamId)) throw new OpenPondTasksetCatalogError(502, \"catalog_scope_mismatch\", \"Taskset inventory did not match the requested workspace or page size.\");\n    return page;\n  }\n\n  async get(id: string, options: { signal?: AbortSignal } = {}): Promise<HostedTasksetSummary> {\n    const parsed = IdSchema.parse(id);\n    const item = HostedTasksetSummarySchema.parse(await this.#request(`/${encodeURIComponent(parsed)}`, options.signal));\n    if (item.id !== parsed || item.teamId !== this.#options.teamId) throw new OpenPondTasksetCatalogError(502, \"catalog_identity_mismatch\", \"Taskset metadata did not match the requested identity.\");\n    return item;\n  }\n\n  /** Resolve a saved portable reference without scanning inventory pages. */\n  async resolve(release: z.infer<typeof TasksetCatalogReleaseRefSchema>, options: { signal?: AbortSignal } = {}): Promise<HostedTasksetSummary> {\n    const parsed = TasksetCatalogReleaseRefSchema.parse(release);\n    const item = HostedTasksetSummarySchema.parse(await this.#request(`/releases/${encodeURIComponent(parsed.id)}/${parsed.revision}/${parsed.contentHash}`, options.signal));\n    if (item.teamId !== this.#options.teamId || item.release.id !== parsed.id || item.release.revision !== parsed.revision || item.release.contentHash !== parsed.contentHash) throw new OpenPondTasksetCatalogError(502, \"catalog_release_mismatch\", \"Taskset metadata did not match the requested immutable release.\");\n    return item;\n  }\n\n  async #request(path: string, signal?: AbortSignal): Promise<unknown> {\n    const response = await (this.#options.fetch ?? globalThis.fetch)(`${this.#options.baseUrl}/v1/taskset-catalog${path}`, {\n      headers: { Authorization: `Bearer ${this.#options.apiKey}`, \"X-OpenPond-Team-Id\": this.#options.teamId, Accept: \"application/json\" },\n      signal, redirect: \"error\",\n    });\n    const reader = response.body?.getReader();\n    if (!reader) throw new OpenPondTasksetCatalogError(response.status, \"empty_response\", \"Taskset catalog response was empty.\");\n    const decoder = new TextDecoder();\n    let bytes = 0;\n    let text = \"\";\n    try {\n      while (true) {\n        const chunk = await reader.read();\n        if (chunk.done) break;\n        bytes += chunk.value.byteLength;\n        if (bytes > 4_194_304) throw new OpenPondTasksetCatalogError(response.status, \"response_too_large\", \"Taskset catalog response exceeded 4 MiB.\");\n        text += decoder.decode(chunk.value, { stream: true });\n      }\n      text += decoder.decode();\n    } finally { await reader.cancel(); reader.releaseLock(); }\n    const payload: unknown = JSON.parse(text);\n    if (!response.ok) {\n      const error = TasksetCatalogErrorSchema.safeParse(payload);\n      throw new OpenPondTasksetCatalogError(response.status, error.success ? error.data.code : \"invalid_error_response\", error.success ? error.data.message : `Taskset catalog request failed (${response.status}).`);\n    }\n    return payload;\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/chunk-APHPXQEA.js

@@ -0,0 +1,155 @@
+// ../cloud/dist/api/core.js
+var DEFAULT_API_TIMEOUT_MS = 3e4;
+var DEFAULT_API_RESPONSE_BYTES = 8 * 1024 * 1024;
+var LONG_STREAM_API_OPTIONS = { timeoutMs: 15 * 60 * 1e3, maxResponseBytes: 64 * 1024 * 1024 };
+var ApiTimeoutError = class extends Error {
+  timeoutMs;
+  requestUrl;
+  code = "OPENPOND_API_TIMEOUT";
+  constructor(timeoutMs, requestUrl) {
+    super(`API request timed out after ${timeoutMs}ms: ${requestUrl}`);
+    this.timeoutMs = timeoutMs;
+    this.requestUrl = requestUrl;
+    this.name = "ApiTimeoutError";
+  }
+};
+var ApiResponseTooLargeError = class extends Error {
+  maximumBytes;
+  requestUrl;
+  code = "OPENPOND_API_RESPONSE_TOO_LARGE";
+  constructor(maximumBytes, requestUrl) {
+    super(`API response exceeded ${maximumBytes} bytes: ${requestUrl}`);
+    this.maximumBytes = maximumBytes;
+    this.requestUrl = requestUrl;
+    this.name = "ApiResponseTooLargeError";
+  }
+};
+var OpenPondApiError = class extends Error {
+  status;
+  apiMessage;
+  code;
+  constructor(status, errorCode, label, apiMessage = null) {
+    const detail = apiMessage || errorCode;
+    super(`${label} failed: ${status}${detail ? ` ${detail}` : ""}`);
+    this.status = status;
+    this.apiMessage = apiMessage;
+    this.name = "OpenPondApiError";
+    this.code = errorCode || "OPENPOND_API_ERROR";
+  }
+};
+async function apiFetch(baseUrl, token, requestPath, options = {}) {
+  const { timeoutMs = DEFAULT_API_TIMEOUT_MS, maxResponseBytes = DEFAULT_API_RESPONSE_BYTES, ...init } = options;
+  const requestUrl = `${baseUrl}${requestPath}`;
+  const headers = new Headers(init.headers);
+  headers.set("Content-Type", "application/json");
+  const apiKey = process.env.OPENPOND_API_KEY;
+  const trimmedToken = token?.trim() || "";
+  const tokenIsApiKey = trimmedToken.startsWith("opk_");
+  const effectiveApiKey = apiKey || (tokenIsApiKey ? trimmedToken : null);
+  if (effectiveApiKey && !headers.has("openpond-api-key"))
+    headers.set("openpond-api-key", effectiveApiKey);
+  if (token) {
+    headers.set("Authorization", tokenIsApiKey ? `ApiKey ${trimmedToken}` : `Bearer ${token}`);
+  } else if (apiKey && !headers.has("Authorization")) {
+    headers.set("Authorization", `ApiKey ${apiKey}`);
+  }
+  const timeoutController = new AbortController();
+  const timeoutError = new ApiTimeoutError(timeoutMs, requestUrl);
+  const timer = timeoutMs > 0 ? setTimeout(() => timeoutController.abort(timeoutError), timeoutMs) : null;
+  timer?.unref?.();
+  const signal = composedSignal(init.signal, timeoutController.signal, timeoutMs);
+  const cleanup = () => {
+    if (timer)
+      clearTimeout(timer);
+  };
+  try {
+    const response = await fetch(requestUrl, { ...init, headers, signal });
+    return boundedResponse(response, {
+      cleanup,
+      maximumBytes: maxResponseBytes,
+      requestUrl,
+      timeoutController,
+      timeoutError
+    });
+  } catch (error) {
+    cleanup();
+    if (timeoutController.signal.aborted)
+      throw timeoutError;
+    throw error;
+  }
+}
+async function readApiJson(response, label) {
+  let payload;
+  try {
+    const text = await response.text();
+    payload = text ? JSON.parse(text) : {};
+  } catch (error) {
+    if (error instanceof ApiTimeoutError || error instanceof ApiResponseTooLargeError)
+      throw error;
+    payload = {};
+  }
+  if (!response.ok) {
+    const errorCode = typeof payload.error === "string" ? payload.error : null;
+    const apiMessage = typeof payload.message === "string" ? payload.message : null;
+    throw new OpenPondApiError(response.status, errorCode, label, apiMessage);
+  }
+  return payload;
+}
+function boundedResponse(response, input) {
+  if (!response.body) {
+    input.cleanup();
+    return response;
+  }
+  const contentLength = Number(response.headers.get("content-length"));
+  if (input.maximumBytes > 0 && Number.isFinite(contentLength) && contentLength > input.maximumBytes) {
+    input.cleanup();
+    void response.body.cancel();
+    throw new ApiResponseTooLargeError(input.maximumBytes, input.requestUrl);
+  }
+  const reader = response.body.getReader();
+  let receivedBytes = 0;
+  const body = new ReadableStream({
+    async pull(controller) {
+      try {
+        const result = await reader.read();
+        if (result.done) {
+          input.cleanup();
+          controller.close();
+          return;
+        }
+        receivedBytes += result.value.byteLength;
+        if (input.maximumBytes > 0 && receivedBytes > input.maximumBytes) {
+          input.cleanup();
+          await reader.cancel();
+          controller.error(new ApiResponseTooLargeError(input.maximumBytes, input.requestUrl));
+          return;
+        }
+        controller.enqueue(result.value);
+      } catch (error) {
+        input.cleanup();
+        controller.error(input.timeoutController.signal.aborted ? input.timeoutError : error);
+      }
+    },
+    async cancel(reason) {
+      input.cleanup();
+      await reader.cancel(reason);
+    }
+  });
+  return new Response(body, {
+    headers: response.headers,
+    status: response.status,
+    statusText: response.statusText
+  });
+}
+function composedSignal(callerSignal, timeoutSignal, timeoutMs) {
+  if (timeoutMs <= 0)
+    return callerSignal ?? void 0;
+  return callerSignal ? AbortSignal.any([callerSignal, timeoutSignal]) : timeoutSignal;
+}
+
+export {
+  OpenPondApiError,
+  apiFetch,
+  readApiJson
+};
+//# sourceMappingURL=chunk-APHPXQEA.js.map

package/dist/chunk-APHPXQEA.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../cloud/src/api/core.ts"],
+  "sourcesContent": ["const DEFAULT_API_TIMEOUT_MS = 30_000;\nconst DEFAULT_API_RESPONSE_BYTES = 8 * 1024 * 1024;\nexport const LONG_STREAM_API_OPTIONS = { timeoutMs: 15 * 60 * 1000, maxResponseBytes: 64 * 1024 * 1024 } as const;\n\nexport type ApiFetchOptions = RequestInit & {\n  timeoutMs?: number;\n  maxResponseBytes?: number;\n};\n\nexport class ApiTimeoutError extends Error {\n  readonly code = \"OPENPOND_API_TIMEOUT\";\n\n  constructor(readonly timeoutMs: number, readonly requestUrl: string) {\n    super(`API request timed out after ${timeoutMs}ms: ${requestUrl}`);\n    this.name = \"ApiTimeoutError\";\n  }\n}\n\nexport class ApiResponseTooLargeError extends Error {\n  readonly code = \"OPENPOND_API_RESPONSE_TOO_LARGE\";\n\n  constructor(readonly maximumBytes: number, readonly requestUrl: string) {\n    super(`API response exceeded ${maximumBytes} bytes: ${requestUrl}`);\n    this.name = \"ApiResponseTooLargeError\";\n  }\n}\n\nexport class OpenPondApiError extends Error {\n  readonly code: string;\n\n  constructor(\n    readonly status: number,\n    errorCode: string | null,\n    label: string,\n    readonly apiMessage: string | null = null,\n  ) {\n    const detail = apiMessage || errorCode;\n    super(`${label} failed: ${status}${detail ? ` ${detail}` : \"\"}`);\n    this.name = \"OpenPondApiError\";\n    this.code = errorCode || \"OPENPOND_API_ERROR\";\n  }\n}\n\nexport async function apiFetch(\n  baseUrl: string,\n  token: string | null,\n  requestPath: string,\n  options: ApiFetchOptions = {},\n): Promise<Response> {\n  const { timeoutMs = DEFAULT_API_TIMEOUT_MS, maxResponseBytes = DEFAULT_API_RESPONSE_BYTES, ...init } = options;\n  const requestUrl = `${baseUrl}${requestPath}`;\n  const headers = new Headers(init.headers);\n  headers.set(\"Content-Type\", \"application/json\");\n  const apiKey = process.env.OPENPOND_API_KEY;\n  const trimmedToken = token?.trim() || \"\";\n  const tokenIsApiKey = trimmedToken.startsWith(\"opk_\");\n  const effectiveApiKey = apiKey || (tokenIsApiKey ? trimmedToken : null);\n  if (effectiveApiKey && !headers.has(\"openpond-api-key\")) headers.set(\"openpond-api-key\", effectiveApiKey);\n  if (token) {\n    headers.set(\"Authorization\", tokenIsApiKey ? `ApiKey ${trimmedToken}` : `Bearer ${token}`);\n  } else if (apiKey && !headers.has(\"Authorization\")) {\n    headers.set(\"Authorization\", `ApiKey ${apiKey}`);\n  }\n\n  const timeoutController = new AbortController();\n  const timeoutError = new ApiTimeoutError(timeoutMs, requestUrl);\n  const timer = timeoutMs > 0\n    ? setTimeout(() => timeoutController.abort(timeoutError), timeoutMs)\n    : null;\n  timer?.unref?.();\n  const signal = composedSignal(init.signal, timeoutController.signal, timeoutMs);\n  const cleanup = () => {\n    if (timer) clearTimeout(timer);\n  };\n\n  try {\n    const response = await fetch(requestUrl, { ...init, headers, signal });\n    return boundedResponse(response, {\n      cleanup,\n      maximumBytes: maxResponseBytes,\n      requestUrl,\n      timeoutController,\n      timeoutError,\n    });\n  } catch (error) {\n    cleanup();\n    if (timeoutController.signal.aborted) throw timeoutError;\n    throw error;\n  }\n}\n\nexport async function readApiJson<T>(response: Response, label: string): Promise<T> {\n  let payload: T & { error?: unknown; message?: unknown };\n  try {\n    const text = await response.text();\n    payload = (text ? JSON.parse(text) : {}) as T & { error?: unknown; message?: unknown };\n  } catch (error) {\n    if (error instanceof ApiTimeoutError || error instanceof ApiResponseTooLargeError) throw error;\n    payload = {} as T & { error?: unknown; message?: unknown };\n  }\n  if (!response.ok) {\n    const errorCode = typeof payload.error === \"string\" ? payload.error : null;\n    const apiMessage =\n      typeof payload.message === \"string\" ? payload.message : null;\n    throw new OpenPondApiError(response.status, errorCode, label, apiMessage);\n  }\n  return payload as T;\n}\n\nfunction boundedResponse(\n  response: Response,\n  input: {\n    cleanup: () => void;\n    maximumBytes: number;\n    requestUrl: string;\n    timeoutController: AbortController;\n    timeoutError: ApiTimeoutError;\n  },\n): Response {\n  if (!response.body) {\n    input.cleanup();\n    return response;\n  }\n  const contentLength = Number(response.headers.get(\"content-length\"));\n  if (input.maximumBytes > 0 && Number.isFinite(contentLength) && contentLength > input.maximumBytes) {\n    input.cleanup();\n    void response.body.cancel();\n    throw new ApiResponseTooLargeError(input.maximumBytes, input.requestUrl);\n  }\n\n  const reader = response.body.getReader();\n  let receivedBytes = 0;\n  const body = new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      try {\n        const result = await reader.read();\n        if (result.done) {\n          input.cleanup();\n          controller.close();\n          return;\n        }\n        receivedBytes += result.value.byteLength;\n        if (input.maximumBytes > 0 && receivedBytes > input.maximumBytes) {\n          input.cleanup();\n          await reader.cancel();\n          controller.error(new ApiResponseTooLargeError(input.maximumBytes, input.requestUrl));\n          return;\n        }\n        controller.enqueue(result.value);\n      } catch (error) {\n        input.cleanup();\n        controller.error(input.timeoutController.signal.aborted ? input.timeoutError : error);\n      }\n    },\n    async cancel(reason) {\n      input.cleanup();\n      await reader.cancel(reason);\n    },\n  });\n  return new Response(body, {\n    headers: response.headers,\n    status: response.status,\n    statusText: response.statusText,\n  });\n}\n\nfunction composedSignal(\n  callerSignal: AbortSignal | null | undefined,\n  timeoutSignal: AbortSignal,\n  timeoutMs: number,\n): AbortSignal | undefined {\n  if (timeoutMs <= 0) return callerSignal ?? undefined;\n  return callerSignal ? AbortSignal.any([callerSignal, timeoutSignal]) : timeoutSignal;\n}\n"],
+  "mappings": "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",
+  "names": []
+}