@labelbox/rl-sdk 0.0.149 → 0.0.150

package/dist/generated/types.gen.d.ts

@@ -8381,7 +8381,7 @@ export type ManagedAgentsCreateVaultRequest = {
  */
 export type ManagedAgentsDefineOutcomeRequest = {
     /**
-     * The task the agent works toward. This starts the session.
+     * The objective the agent works toward, and the statement of it the grader is given. It opens the session when the start request carries no message.
      */
     description: string;
     /**
@@ -8389,7 +8389,7 @@ export type ManagedAgentsDefineOutcomeRequest = {
      */
     grader_model_ref_id?: string;
     /**
-     * Revision passes allowed before the loop stops. Defaults to 3, maximum 20.
+     * Ceiling on grader passes before the outcome ends as max_iterations_reached. Omit it, or send 0, to revise until the grader is satisfied, which is the default. Set a number only to cap a rubric you are not sure can be met.
      */
     max_iterations?: number;
     /**
@@ -9948,7 +9948,7 @@ export type ManagedAgentsOutcome = {
      */
     defined_by_event_id?: string;
     /**
-     * Task the agent works toward, in prose. Supplied at session start in place of an opening message.
+     * Objective the agent works toward, in prose, and the statement of it quoted to the grader. Opens the session when the start request carries no message.
      */
     description?: string;
     /**
@@ -9964,7 +9964,7 @@ export type ManagedAgentsOutcome = {
      */
     grader_model_ref_id?: string;
     /**
-     * Ceiling on grader passes before the outcome ends as max_iterations_reached. Defaults to 3; 20 is the maximum accepted.
+     * Ceiling on grader passes before the outcome ends as max_iterations_reached. Zero means unbounded, which is the default: the loop runs until the grader is satisfied.
      */
     max_iterations?: number;
     /**
@@ -11061,7 +11061,7 @@ export type ManagedAgentsSkillVersionListResponse = {
     skill_versions?: unknown;
 };
 /**
- * Request body for starting a session: which agent to run, the environment to run it in, the vault grants it receives, and the opening message or outcome that gives it work.
+ * Request body for starting a session: which agent to run, the environment to run it in, the vault grants it receives, and the opening message and/or outcome that gives it work.
  */
 export type ManagedAgentsStartSessionRequest = {
     /**
@@ -11089,7 +11089,7 @@ export type ManagedAgentsStartSessionRequest = {
      */
     idempotency_key?: string;
     /**
-     * Opening user message for the session.
+     * Opening user message for the session, and the context the agent works from. Send it alongside an outcome to supply facts the agent needs without making them part of what the grader measures; the grader never sees it. Kept in the session's system prompt for the whole run, so context compaction cannot summarize it away.
      */
     message?: string;
     outcome?: ManagedAgentsDefineOutcomeRequest;

package/dist/reference/sdk-reference.generated.js

@@ -47212,7 +47212,7 @@ export const SDK_REFERENCE = {
                 in: 'body',
                 required: true,
                 type: 'string',
-                description: 'The task the agent works toward. This starts the session.',
+                description: 'The objective the agent works toward, and the statement of it the grader is given. It opens the session when the start request carries no message.',
             },
             {
                 name: 'grader_model_ref_id',
@@ -47226,7 +47226,7 @@ export const SDK_REFERENCE = {
                 in: 'body',
                 required: false,
                 type: 'integer',
-                description: 'Revision passes allowed before the loop stops. Defaults to 3, maximum 20.',
+                description: 'Ceiling on grader passes before the outcome ends as max_iterations_reached. Omit it, or send 0, to revise until the grader is satisfied, which is the default. Set a number only to cap a rubric you are not sure can be met.',
                 format: 'int64',
             },
             {
@@ -47264,7 +47264,7 @@ export const SDK_REFERENCE = {
                     name: 'description',
                     required: false,
                     type: 'string',
-                    description: 'Task the agent works toward, in prose. Supplied at session start in place of an opening message.',
+                    description: 'Objective the agent works toward, in prose, and the statement of it quoted to the grader. Opens the session when the start request carries no message.',
                 },
                 {
                     name: 'ended_at',
@@ -47461,7 +47461,7 @@ export const SDK_REFERENCE = {
                     name: 'max_iterations',
                     required: false,
                     type: 'integer',
-                    description: 'Ceiling on grader passes before the outcome ends as max_iterations_reached. Defaults to 3; 20 is the maximum accepted.',
+                    description: 'Ceiling on grader passes before the outcome ends as max_iterations_reached. Zero means unbounded, which is the default: the loop runs until the grader is satisfied.',
                     format: 'int64',
                 },
                 {
@@ -54523,20 +54523,20 @@ export const SDK_REFERENCE = {
                 in: 'body',
                 required: false,
                 type: 'string',
-                description: 'Opening user message for the session.',
+                description: "Opening user message for the session, and the context the agent works from. Send it alongside an outcome to supply facts the agent needs without making them part of what the grader measures; the grader never sees it. Kept in the session's system prompt for the whole run, so context compaction cannot summarize it away.",
             },
             {
                 name: 'outcome',
                 in: 'body',
                 required: false,
                 type: 'ManagedAgentsDefineOutcomeRequest',
-                description: "Optional definition of done, graded against a rubric. Its description is the task, so send an outcome or a message, not both. Omit to inherit the agent version's default_rubric when it defines one, graded against this request's message; an outcome sent here is used as given and the agent default is ignored entirely.",
+                description: "Optional definition of done, graded against a rubric. Its description is the objective and is quoted to the grader; send a message alongside it for context the grader should not see. With no message the description opens the session. Omit to inherit the agent version's default_rubric when it defines one, graded against this request's message; an outcome sent here is used as given and the agent default is ignored entirely.",
                 fields: [
                     {
                         name: 'description',
                         required: true,
                         type: 'string',
-                        description: 'The task the agent works toward. This starts the session.',
+                        description: 'The objective the agent works toward, and the statement of it the grader is given. It opens the session when the start request carries no message.',
                     },
                     {
                         name: 'grader_model_ref_id',
@@ -54548,7 +54548,7 @@ export const SDK_REFERENCE = {
                         name: 'max_iterations',
                         required: false,
                         type: 'integer',
-                        description: 'Revision passes allowed before the loop stops. Defaults to 3, maximum 20.',
+                        description: 'Ceiling on grader passes before the outcome ends as max_iterations_reached. Omit it, or send 0, to revise until the grader is satisfied, which is the default. Set a number only to cap a rubric you are not sure can be met.',
                         format: 'int64',
                     },
                     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@labelbox/rl-sdk",
-  "version": "0.0.149",
+  "version": "0.0.150",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",