openpond-sdk 0.12.21 → 0.12.22

package/TRAINING_WORKFLOWS.md

@@ -54,6 +54,20 @@ execution location. Training authoring uses `trainingForm`. Cleared evaluation
 numeric controls remain `null`; blank training spend fields remain strings.
 These incomplete values can be retained without becoming executable requests.
 
+Model setup authoring may also retain optional `modelSetup` metadata, exported
+as `ModelSetupDraftSchema` and `ModelSetupDraft` from `openpond-sdk/training`.
+It stores the selected workflow (`sft`, `rl`, `decision`), adapter (`lora`,
+`engram`, `neuron-training`), `continualLearning` choice, current setup section
+and an optional editable Dataset `{ id, revision }`. That Dataset reference is
+an authoring destination, not an admitted training batch or immutable release.
+These choices survive the same revisioned draft save/read lifecycle. They do
+not publish a learning policy or establish executor compatibility. Call
+`assertModelSetupExecutionIntent(draft, requestedOperation)` when converting a
+retained setup draft into a preparation request. It rejects a different or
+unsupported workflow/adapter operation; executor admission still owns runtime,
+permissions and resource checks. Direct explicit-method APIs remain independent
+of this authoring metadata.
+
 Use `training.saveExperimentDraft(request)` with
 `schemaVersion: "openpond.experimentDraftSave.v1"`, `teamId`, a stable
 `operationId`, `expectedRevision`, optional `projectId`, and an

package/dist/training.js

@@ -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,