openpond-sdk 0.5.12 → 0.5.13

package/LEARNING.md

@@ -43,6 +43,21 @@ All client requests support an optional `AbortSignal`. Aborting a request does
 not cancel remote compute; use `cancel_grade` and read the authoritative terminal
 job state. Page through list responses with `nextCursor` as `afterId`.
 
+## Configure hosted learning
+
+Use `hostedLearningPolicyReferences(project)` from `openpond-sdk/learning` with
+the Model summary returned by the authenticated Model Projects API. It derives
+the exact recipe, training-parent and retained-evaluation references used by the
+hosted policy snapshot. The recipe identifier binds the Model's reviewed etag,
+including its Harness and data settings; the content hash binds the recipe.
+Missing recipe, starting model or retained evaluation is a configuration error.
+
+Keep those references when changing a policy's pause state, schedule or limits.
+Recompute them only when explicitly applying a newly reviewed Model configuration.
+The server verifies the references when publishing the policy and retains the
+immutable configuration for later preparation. Use `client.inspectPolicy(ref)`
+for shared readiness counts and blockers without reserving or launching work.
+
 ## Connect an application
 
 In the task format, open **Connect an application** and create a source credential.

package/dist/learning.js

@@ -14,11 +14,32 @@ import {
   createSourceCredentialRequest
 } from "./chunk-5M3PPP7D.js";
 import "./chunk-5FBPNWT4.js";
-import "./chunk-QUOW6URQ.js";
+import {
+  contentHash
+} from "./chunk-QUOW6URQ.js";
 
 // src/learning.ts
 export * from "@openpond/evals/learning";
 export * from "@openpond/evals/rewards";
+
+// src/model-learning-policy.ts
+import { LearningDomainError } from "@openpond/evals/learning";
+function hostedLearningPolicyReferences(project) {
+  const setup = project.trainingSetup;
+  const base = setup.baseModel ?? project.defaultBaseModel;
+  if (!setup.recipe || !base || !setup.evaluationTasksetRef) {
+    throw new LearningDomainError(
+      "learning_model_configuration_incomplete",
+      422,
+      "Select a training recipe, starting model and retained evaluation before enabling hosted learning."
+    );
+  }
+  return {
+    recipe: { id: `model-recipe-${project.etag}`, contentHash: contentHash(setup.recipe) },
+    trainingParent: { id: base.modelId, contentHash: contentHash(base) },
+    retentionEvaluation: { id: setup.evaluationTasksetRef.id, contentHash: setup.evaluationTasksetRef.contentHash }
+  };
+}
 export {
   LearningBatchPublicationResultSchema,
   LearningBatchPublicationSchema,
@@ -32,6 +53,7 @@ export {
   OpenPondLearningClient,
   OpenPondLearningError,
   assertLearningCredentialExpiry,
-  createSourceCredentialRequest
+  createSourceCredentialRequest,
+  hostedLearningPolicyReferences
 };
 //# sourceMappingURL=learning.js.map

package/dist/learning.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/learning.ts"],
-  "sourcesContent": ["export * from \"@openpond/evals/learning\";\nexport * from \"@openpond/evals/rewards\";\nexport * from \"./learning-credentials.js\";\nexport * from \"./learning-client.js\";\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA,cAAc;AACd,cAAc;",
+  "sources": ["../src/learning.ts", "../src/model-learning-policy.ts"],
+  "sourcesContent": ["export * from \"@openpond/evals/learning\";\nexport * from \"@openpond/evals/rewards\";\nexport * from \"./learning-credentials.js\";\nexport * from \"./learning-client.js\";\nexport * from \"./model-learning-policy.js\";\n", "import { LearningDomainError } from \"@openpond/evals/learning\";\nimport { contentHash } from \"@openpond/harness\";\n\nimport type { HostedModelProjectSummary } from \"./model-projects.js\";\n\n/** Bind a reviewed hosted Model configuration before asynchronous preparation.\n * Keep the established recipe identity: its id binds the whole Model revision,\n * including Harness and retention selections, while its hash binds the recipe.\n * Callers must obtain the summary from the authenticated Model API. */\nexport function hostedLearningPolicyReferences(project: HostedModelProjectSummary) {\n  const setup = project.trainingSetup;\n  const base = setup.baseModel ?? project.defaultBaseModel;\n  if (!setup.recipe || !base || !setup.evaluationTasksetRef) {\n    throw new LearningDomainError(\"learning_model_configuration_incomplete\", 422,\n      \"Select a training recipe, starting model and retained evaluation before enabling hosted learning.\");\n  }\n  return {\n    recipe: { id: `model-recipe-${project.etag}`, contentHash: contentHash(setup.recipe) },\n    trainingParent: { id: base.modelId, contentHash: contentHash(base) },\n    retentionEvaluation: { id: setup.evaluationTasksetRef.id, contentHash: setup.evaluationTasksetRef.contentHash },\n  };\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA,cAAc;AACd,cAAc;;;ACDd,SAAS,2BAA2B;AAS7B,SAAS,+BAA+B,SAAoC;AACjF,QAAM,QAAQ,QAAQ;AACtB,QAAM,OAAO,MAAM,aAAa,QAAQ;AACxC,MAAI,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,MAAM,sBAAsB;AACzD,UAAM,IAAI;AAAA,MAAoB;AAAA,MAA2C;AAAA,MACvE;AAAA,IAAmG;AAAA,EACvG;AACA,SAAO;AAAA,IACL,QAAQ,EAAE,IAAI,gBAAgB,QAAQ,IAAI,IAAI,aAAa,YAAY,MAAM,MAAM,EAAE;AAAA,IACrF,gBAAgB,EAAE,IAAI,KAAK,SAAS,aAAa,YAAY,IAAI,EAAE;AAAA,IACnE,qBAAqB,EAAE,IAAI,MAAM,qBAAqB,IAAI,aAAa,MAAM,qBAAqB,YAAY;AAAA,EAChH;AACF;",
   "names": []
 }

package/dist/types/packages/sdk/src/learning.d.ts

@@ -2,4 +2,5 @@ export * from "@openpond/evals/learning";
 export * from "@openpond/evals/rewards";
 export * from "./learning-credentials.js";
 export * from "./learning-client.js";
+export * from "./model-learning-policy.js";
 //# sourceMappingURL=learning.d.ts.map

package/dist/types/packages/sdk/src/learning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"learning.d.ts","sourceRoot":"","sources":["../../../../../src/learning.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"learning.d.ts","sourceRoot":"","sources":["../../../../../src/learning.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC"}

package/dist/types/packages/sdk/src/model-learning-policy.d.ts

@@ -0,0 +1,20 @@
+import type { HostedModelProjectSummary } from "./model-projects.js";
+/** Bind a reviewed hosted Model configuration before asynchronous preparation.
+ * Keep the established recipe identity: its id binds the whole Model revision,
+ * including Harness and retention selections, while its hash binds the recipe.
+ * Callers must obtain the summary from the authenticated Model API. */
+export declare function hostedLearningPolicyReferences(project: HostedModelProjectSummary): {
+    recipe: {
+        id: string;
+        contentHash: string;
+    };
+    trainingParent: {
+        id: string;
+        contentHash: string;
+    };
+    retentionEvaluation: {
+        id: string;
+        contentHash: string;
+    };
+};
+//# sourceMappingURL=model-learning-policy.d.ts.map

package/dist/types/packages/sdk/src/model-learning-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-learning-policy.d.ts","sourceRoot":"","sources":["../../../../../src/model-learning-policy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAErE;;;uEAGuE;AACvE,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,yBAAyB;;;;;;;;;;;;;EAYhF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openpond-sdk",
-  "version": "0.5.12",
+  "version": "0.5.13",
   "description": "Server-side TypeScript SDK for OpenPond sandboxes and agentic work",
   "license": "MIT",
   "type": "module",