openpond-sdk 0.12.20 → 0.12.22

package/dist/opentelemetry.js

@@ -0,0 +1,92 @@
+import "./chunk-YLJ4XMA6.js";
+
+// src/opentelemetry.ts
+var OpenPondSpanExportError = class extends Error {
+  constructor(failures) {
+    super(`OpenPond could not export ${failures.length} selected span(s).`);
+    this.failures = failures;
+    this.name = "OpenPondSpanExportError";
+  }
+  failures;
+};
+var OpenPondSpanExporter = class {
+  #options;
+  #maxBatchSize;
+  #timeout;
+  #exportTimeout;
+  #closed = false;
+  #active;
+  lastExportError;
+  constructor(options) {
+    if (!options.datasetId.trim()) throw new Error("A dataset ID is required.");
+    this.#maxBatchSize = options.maxExportBatchSize ?? 512;
+    this.#timeout = options.requestTimeoutMillis ?? 1e4;
+    this.#exportTimeout = options.exportTimeoutMillis ?? 25e3;
+    if (!Number.isSafeInteger(this.#maxBatchSize) || this.#maxBatchSize < 1 || this.#maxBatchSize > 4096) throw new Error("maxExportBatchSize must be between 1 and 4096.");
+    if (!Number.isSafeInteger(this.#timeout) || this.#timeout < 1 || this.#timeout > 3e5) throw new Error("requestTimeoutMillis must be between 1 and 300000.");
+    if (!Number.isSafeInteger(this.#exportTimeout) || this.#exportTimeout < 1 || this.#exportTimeout > 3e5) throw new Error("exportTimeoutMillis must be between 1 and 300000.");
+    this.#options = { ...options };
+  }
+  export(spans, resultCallback) {
+    if (this.#closed || this.#active || spans.length > this.#maxBatchSize) {
+      const error = new Error(this.#closed ? "OpenPond exporter is shut down." : this.#active ? "OpenPond exporter already has an active batch." : "OpenPond export batch exceeds its configured limit.");
+      this.lastExportError = error;
+      resultCallback({ code: 1, error });
+      return;
+    }
+    const operation = Promise.resolve().then(() => this.#exportBatch(spans));
+    const settled = operation.then(() => void 0, () => void 0);
+    this.#active = settled;
+    void operation.then(
+      () => {
+        this.lastExportError = void 0;
+        return { code: 0 };
+      },
+      (error) => {
+        this.lastExportError = error;
+        return { code: 1, error };
+      }
+    ).then((result) => {
+      if (this.#active === settled) this.#active = void 0;
+      resultCallback(result);
+    });
+  }
+  async #exportBatch(spans) {
+    const failures = [];
+    const completed = /* @__PURE__ */ new Set();
+    const deadline = performance.now() + this.#exportTimeout;
+    for (const span of spans) {
+      const { traceId, spanId } = span.spanContext();
+      const eventId = `${traceId}:${spanId}`;
+      if (completed.has(eventId)) continue;
+      try {
+        if (!/^[0-9a-f]{32}$/.test(traceId) || !/^[0-9a-f]{16}$/.test(spanId) || /^0+$/.test(traceId) || /^0+$/.test(spanId)) throw new Error("A valid OTel span context is required.");
+        const remaining = Math.floor(deadline - performance.now());
+        if (remaining <= 0) throw new Error("OpenPond export batch deadline exceeded.");
+        const task = this.#options.projectSpan(span);
+        if (task == null) continue;
+        const signal = AbortSignal.timeout(Math.min(this.#timeout, remaining));
+        await this.#options.client.addTask(this.#options.datasetId, {
+          ...task,
+          source: { kind: "opentelemetry", eventId }
+        }, { idempotencyKey: `otel:${eventId}`, signal });
+        completed.add(eventId);
+      } catch (error) {
+        failures.push({ traceId, spanId, error });
+      }
+    }
+    if (failures.length) throw new OpenPondSpanExportError(failures);
+  }
+  async forceFlush() {
+    await this.#active;
+  }
+  async shutdown() {
+    this.#closed = true;
+    await this.forceFlush();
+  }
+};
+export {
+  OpenPondSpanExportError,
+  OpenPondSpanExporter
+};
+//# sourceMappingURL=opentelemetry.js.map

package/dist/opentelemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/opentelemetry.ts"],"sourcesContent":["import type { ReadableSpan, SpanExporter } from \"@opentelemetry/sdk-trace\";\nimport type { AddTaskOptions, DatasetTaskAppendReceipt, DatasetTaskInput } from \"./dataset-task-ingestion.js\";\n\nexport type OpenPondSpanExporterOptions = {\n  client: {\n    addTask(datasetId: string, task: DatasetTaskInput, options?: AddTaskOptions): Promise<DatasetTaskAppendReceipt>;\n  };\n  datasetId: string;\n  /** Select useful completed runs and redact content. Return null to skip. */\n  projectSpan(span: ReadableSpan): DatasetTaskInput | null | undefined;\n  /** Match the BatchSpanProcessor limit. Larger batches fail without uploading. */\n  maxExportBatchSize?: number;\n  /** Per-task request deadline. Projection must be synchronous and bounded. */\n  requestTimeoutMillis?: number;\n  /** Overall batch deadline, including all task submissions. */\n  exportTimeoutMillis?: number;\n};\n\nexport type OpenPondSpanFailure = { traceId: string; spanId: string; error: unknown };\n\nexport class OpenPondSpanExportError extends Error {\n  constructor(readonly failures: readonly OpenPondSpanFailure[]) {\n    super(`OpenPond could not export ${failures.length} selected span(s).`);\n    this.name = \"OpenPondSpanExportError\";\n  }\n}\n\n/**\n * Optional OTel exporter, not an OTLP receiver or automatic instrumentation.\n * Register with BatchSpanProcessor for its bounded background queue. Only the\n * explicit projection is uploaded; no attributes, events, or secrets are copied.\n */\nexport class OpenPondSpanExporter implements SpanExporter {\n  readonly #options: OpenPondSpanExporterOptions;\n  readonly #maxBatchSize: number;\n  readonly #timeout: number;\n  readonly #exportTimeout: number;\n  #closed = false;\n  #active: Promise<void> | undefined;\n  lastExportError: Error | undefined;\n\n  constructor(options: OpenPondSpanExporterOptions) {\n    if (!options.datasetId.trim()) throw new Error(\"A dataset ID is required.\");\n    this.#maxBatchSize = options.maxExportBatchSize ?? 512;\n    this.#timeout = options.requestTimeoutMillis ?? 10_000;\n    this.#exportTimeout = options.exportTimeoutMillis ?? 25_000;\n    if (!Number.isSafeInteger(this.#maxBatchSize) || this.#maxBatchSize < 1 || this.#maxBatchSize > 4096) throw new Error(\"maxExportBatchSize must be between 1 and 4096.\");\n    if (!Number.isSafeInteger(this.#timeout) || this.#timeout < 1 || this.#timeout > 300_000) throw new Error(\"requestTimeoutMillis must be between 1 and 300000.\");\n    if (!Number.isSafeInteger(this.#exportTimeout) || this.#exportTimeout < 1 || this.#exportTimeout > 300_000) throw new Error(\"exportTimeoutMillis must be between 1 and 300000.\");\n    this.#options = { ...options };\n  }\n\n  export(spans: ReadableSpan[], resultCallback: Parameters<SpanExporter[\"export\"]>[1]): void {\n    if (this.#closed || this.#active || spans.length > this.#maxBatchSize) {\n      const error = new Error(this.#closed ? \"OpenPond exporter is shut down.\" : this.#active ? \"OpenPond exporter already has an active batch.\" : \"OpenPond export batch exceeds its configured limit.\");\n      this.lastExportError = error;\n      resultCallback({ code: 1, error });\n      return;\n    }\n    // Reserve the active slot before user projection executes.\n    const operation = Promise.resolve().then(() => this.#exportBatch(spans));\n    const settled = operation.then(() => undefined, () => undefined);\n    this.#active = settled;\n    void operation.then(\n      () => { this.lastExportError = undefined; return { code: 0 as const }; },\n      (error: Error) => { this.lastExportError = error; return { code: 1 as const, error }; },\n    ).then(result => {\n      if (this.#active === settled) this.#active = undefined;\n      resultCallback(result);\n    });\n  }\n\n  async #exportBatch(spans: ReadableSpan[]): Promise<void> {\n    const failures: OpenPondSpanFailure[] = [];\n    const completed = new Set<string>();\n    const deadline = performance.now() + this.#exportTimeout;\n    for (const span of spans) {\n      const { traceId, spanId } = span.spanContext();\n      const eventId = `${traceId}:${spanId}`;\n      if (completed.has(eventId)) continue;\n      try {\n        if (!/^[0-9a-f]{32}$/.test(traceId) || !/^[0-9a-f]{16}$/.test(spanId) || /^0+$/.test(traceId) || /^0+$/.test(spanId)) throw new Error(\"A valid OTel span context is required.\");\n        const remaining = Math.floor(deadline - performance.now());\n        if (remaining <= 0) throw new Error(\"OpenPond export batch deadline exceeded.\");\n        const task = this.#options.projectSpan(span);\n        if (task == null) continue;\n        const signal = AbortSignal.timeout(Math.min(this.#timeout, remaining));\n        await this.#options.client.addTask(this.#options.datasetId, {\n          ...task, source: { kind: \"opentelemetry\", eventId },\n        }, { idempotencyKey: `otel:${eventId}`, signal });\n        completed.add(eventId);\n      } catch (error) {\n        failures.push({ traceId, spanId, error });\n      }\n    }\n    if (failures.length) throw new OpenPondSpanExportError(failures);\n  }\n\n  async forceFlush(): Promise<void> { await this.#active; }\n\n  async shutdown(): Promise<void> {\n    this.#closed = true;\n    await this.forceFlush();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/taskset-drafts.js

@@ -112,7 +112,6 @@ import {
   assertTasksetCalibrationClosures,
   resolveTasksetCalibrationFixture
 } from "./chunk-ZQ6QTYRE.js";
-import "./chunk-Z252BNAZ.js";
 import {
   ModelTasksetDraftRequestSchema,
   TasksetDraftFileInfoSchema,
@@ -120,6 +119,7 @@ import {
   TasksetDraftFilePathSchema,
   TasksetDraftFileSchema
 } from "./chunk-TK3DXH7A.js";
+import "./chunk-Z252BNAZ.js";
 import "./chunk-H3367ISL.js";
 import "./chunk-MVAEE5EI.js";
 import "./chunk-CL3IOOVL.js";

package/dist/taskset-packages.js

@@ -11,7 +11,16 @@ import {
   materializeTasksetDraftWorkspace,
   prepareDatasetTrainingReview,
   prepareTasksetDraftSource
-} from "./chunk-RT7SQHO4.js";
+} from "./chunk-SP7DQEQM.js";
+import {
+  OpenPondTasksetPackageClient,
+  OpenPondTasksetPackageError,
+  TasksetPackageModelConfigurationSchema,
+  TasksetPackagePublicationSchema,
+  TasksetPackageReadbackSchema,
+  TasksetPackageReceiptSchema,
+  TasksetReleasePackageReadbackSchema
+} from "./chunk-7G47YXQT.js";
 import {
   DatasetTrainingReviewReceiptContentSchema,
   DatasetTrainingReviewReceiptSchema,
@@ -24,15 +33,6 @@ import {
   projectLearningBatchGraders,
   tasksetPackageSourceId
 } from "./chunk-GBDBKGXW.js";
-import {
-  OpenPondTasksetPackageClient,
-  OpenPondTasksetPackageError,
-  TasksetPackageModelConfigurationSchema,
-  TasksetPackagePublicationSchema,
-  TasksetPackageReadbackSchema,
-  TasksetPackageReceiptSchema,
-  TasksetReleasePackageReadbackSchema
-} from "./chunk-7G47YXQT.js";
 import {
   ModelBatchReviewInspectionSchema,
   ModelBatchReviewReceiptSchema,
@@ -45,7 +45,8 @@ import {
   prepareAuthoredTasksetSource,
   prepareModelTasksetDraft,
   publishModelTasksetDraftPackage
-} from "./chunk-3MDNVNBM.js";
+} from "./chunk-BNBPKCIR.js";
+import "./chunk-Q4RGCEOI.js";
 import {
   materializePortableTasksetRelease,
   portableTasksetEnvironment,
@@ -54,7 +55,6 @@ import {
   projectPreferenceComparisonRelease,
   resolvePortableTasksetRewardExecution
 } from "./chunk-GWXJSBWR.js";
-import "./chunk-Q4RGCEOI.js";
 import "./chunk-GCUWJUUM.js";
 import {
   MAX_TASKSET_PACKAGE_BYTES,
@@ -73,7 +73,6 @@ import {
   validateTasksetLearningResources,
   validateTasksetPackage
 } from "./chunk-ZQ6QTYRE.js";
-import "./chunk-Z252BNAZ.js";
 import {
   ModelTasksetAuthoringOwnerSchema,
   ModelTasksetAuthoringSchema,
@@ -85,6 +84,7 @@ import {
   TasksetDraftFilePathSchema,
   TasksetDraftFileSchema
 } from "./chunk-TK3DXH7A.js";
+import "./chunk-Z252BNAZ.js";
 import "./chunk-H3367ISL.js";
 import "./chunk-QTNYXOJW.js";
 import "./chunk-MVAEE5EI.js";

package/dist/training-bundle.js

@@ -14,16 +14,6 @@ import {
 import {
   ManagedSftRecipeSchema
 } from "./chunk-YV6PPDXZ.js";
-import {
-  TrainingHandoffOriginSchema
-} from "./chunk-BJMENXR4.js";
-import {
-  HarnessSourceSelectionSchema,
-  createAgentSnapshot,
-  createHarnessRelease,
-  validateHarnessPolicySourcePackage,
-  validateHarnessSourcePackage
-} from "./chunk-774OWTCD.js";
 import {
   prepareImportedTasksetPackage,
   projectLearningBatchGraders
@@ -45,7 +35,17 @@ import {
 } from "./chunk-ZQ6QTYRE.js";
 import "./chunk-TK3DXH7A.js";
 import "./chunk-H3367ISL.js";
+import {
+  TrainingHandoffOriginSchema
+} from "./chunk-BJMENXR4.js";
 import "./chunk-ZQFROKKS.js";
+import {
+  HarnessSourceSelectionSchema,
+  createAgentSnapshot,
+  createHarnessRelease,
+  validateHarnessPolicySourcePackage,
+  validateHarnessSourcePackage
+} from "./chunk-774OWTCD.js";
 import "./chunk-QTNYXOJW.js";
 import "./chunk-GS5HEE4M.js";
 import "./chunk-ZRTNR4U7.js";

package/dist/training.js

@@ -71,14 +71,6 @@ import {
   TrainingSftImageCapabilitiesSchema,
   supportsTrainingSftRecipe
 } from "./chunk-YV6PPDXZ.js";
-import {
-  TrainingHandoffOriginSchema,
-  createPostTrainingClient
-} from "./chunk-BJMENXR4.js";
-import {
-  validateHarnessPolicySourcePackage,
-  validateHarnessSourcePackage
-} from "./chunk-774OWTCD.js";
 import {
   DatasetTrainingReviewReceiptContentSchema,
   DatasetTrainingReviewReceiptSchema,
@@ -89,7 +81,15 @@ import "./chunk-GPQLBVQC.js";
 import {
   TasksetCatalogReleaseRefSchema
 } from "./chunk-Z252BNAZ.js";
+import {
+  TrainingHandoffOriginSchema,
+  createPostTrainingClient
+} from "./chunk-BJMENXR4.js";
 import "./chunk-ZQFROKKS.js";
+import {
+  validateHarnessPolicySourcePackage,
+  validateHarnessSourcePackage
+} from "./chunk-774OWTCD.js";
 import "./chunk-QTNYXOJW.js";
 import {
   ExperimentDefinitionSchema,
@@ -3594,11 +3594,22 @@ var TrainingExperimentFormDraftSchema = z36.object({
     policy: LearningRevisionRefSchema2
   }).strict().optional()
 }).strict();
+var ModelSetupDraftSchema = z36.object({
+  workflow: z36.enum(["sft", "rl", "decision"]),
+  adapter: z36.enum(["lora", "engram", "neuron-training"]),
+  continualLearning: z36.boolean(),
+  dataset: z36.object({
+    id: z36.string().trim().min(1).max(240),
+    revision: z36.number().int().positive()
+  }).strict().optional(),
+  section: z36.enum(["model", "dataset", "graders", "settings"])
+}).strict();
 var ExperimentDraftSchema = z36.object({
   schemaVersion: z36.literal("openpond.experimentDraft.v1"),
   id: z36.string().trim().min(1).max(240),
   operationType: ExperimentOperationTypeSchema,
   name: z36.string().trim().min(1).max(500),
+  modelSetup: ModelSetupDraftSchema.optional(),
   startingModel: ExperimentStartingModelSchema.optional(),
   evaluationForm: EvaluationExperimentDraftSchema.optional(),
   hostedEvaluationForm: HostedEvaluationExperimentFormDraftSchema.optional(),
@@ -3691,6 +3702,16 @@ var ExperimentDraftSchema = z36.object({
   if (draft.training && (!["sft", "grpo"].includes(draft.operationType) || draft.training.settings && draft.training.settings.method !== draft.operationType))
     context.addIssue({ code: "custom", path: ["training"], message: "Training settings must match the experiment type." });
 });
+function assertModelSetupExecutionIntent(draft, requestedOperation) {
+  const parsed = ExperimentDraftSchema.parse(draft);
+  const setup = parsed.modelSetup;
+  if (!setup) return;
+  const operation = setup.workflow === "sft" ? setup.adapter === "lora" ? "sft" : setup.adapter === "engram" ? "engram_adapter" : "selective_neuron_training" : setup.adapter === "lora" ? setup.workflow === "rl" ? "grpo" : "decision_model" : null;
+  if (!operation)
+    throw new OpenPondProtocolError("model_setup_execution_unsupported", "The selected workflow and adapter do not have a supported execution operation.");
+  if (parsed.operationType !== operation || requestedOperation !== operation)
+    throw new OpenPondProtocolError("model_setup_execution_mismatch", "The requested operation differs from the Model setup's selected workflow and adapter.");
+}
 async function parseAndVerifyExperimentDraft(raw, expected = {}) {
   const draft = ExperimentDraftSchema.parse(raw);
   if (draft.startingModel) await parseAndVerifyExperimentStartingModel(draft.startingModel, expected);
@@ -8289,6 +8310,7 @@ export {
   ModelModificationExecutionCapabilitySchema,
   ModelModificationMethodSchema,
   ModelModificationValidationLevelSchema,
+  ModelSetupDraftSchema,
   ModificationRecordingContentSchema,
   ModificationRecordingDocumentSchema,
   ModificationRecordingListQuerySchema,
@@ -8546,6 +8568,7 @@ export {
   assertCanonicalPayloadSize,
   assertManagedModificationPricing,
   assertModelModificationValidationLevel,
+  assertModelSetupExecutionIntent,
   assertTrainingEvaluationIsolation,
   assertTrainingQualificationReceipt,
   canonicalComputeSpendCap,