@mutagent/sdk 0.3.45 → 0.3.47

package/dist/commonjs/funcs/sandbox-post-api-sandbox-agent-run.d.ts

@@ -12,7 +12,7 @@ import { Result } from "../types/fp.js";
  * Run one agent turn in a fresh sandbox
  *
  * @remarks
- * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
+ * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. `prompt` may be omitted when `args` carries `--name <agent>` instead — the box's own helix then resolves the name against the image's bundled roster and its agent dirs; exactly one of the two is required (422 otherwise). The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
  */
 export declare function sandboxPostApiSandboxAgentRun(client: MutagentCore, request: operations.PostApiSandboxAgentRunRequest, options?: RequestOptions): APIPromise<Result<operations.PostApiSandboxAgentRunResponse, errors.ErrorMessage | errors.ErrorMessageStatusCode | MutagentError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 //# sourceMappingURL=sandbox-post-api-sandbox-agent-run.d.ts.map

package/dist/commonjs/funcs/sandbox-post-api-sandbox-agent-run.js

@@ -52,7 +52,7 @@ const async_js_1 = require("../types/async.js");
  * Run one agent turn in a fresh sandbox
  *
  * @remarks
- * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
+ * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. `prompt` may be omitted when `args` carries `--name <agent>` instead — the box's own helix then resolves the name against the image's bundled roster and its agent dirs; exactly one of the two is required (422 otherwise). The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
  */
 function sandboxPostApiSandboxAgentRun(client, request, options) {
     return new async_js_1.APIPromise($do(client, request, options));

package/dist/commonjs/lib/config.d.ts

@@ -35,8 +35,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "2.0.0";
-    readonly sdkVersion: "0.3.45";
+    readonly sdkVersion: "0.3.47";
     readonly genVersion: "2.935.1";
-    readonly userAgent: "speakeasy-sdk/typescript 0.3.45 2.935.1 2.0.0 @mutagent/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 0.3.47 2.935.1 2.0.0 @mutagent/sdk";
 };
 //# sourceMappingURL=config.d.ts.map

package/dist/commonjs/lib/config.js

@@ -31,8 +31,8 @@ function serverURLFromOptions(options) {
 exports.SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "2.0.0",
-    sdkVersion: "0.3.45",
+    sdkVersion: "0.3.47",
     genVersion: "2.935.1",
-    userAgent: "speakeasy-sdk/typescript 0.3.45 2.935.1 2.0.0 @mutagent/sdk",
+    userAgent: "speakeasy-sdk/typescript 0.3.47 2.935.1 2.0.0 @mutagent/sdk",
 };
 //# sourceMappingURL=config.js.map

package/dist/commonjs/models/preset-timeout-ms-keep2.d.ts

@@ -17,9 +17,9 @@ export type PresetTimeoutMsKeep2 = {
      */
     runId?: string | undefined;
     /**
-     * WHO the agent is — the agent definition, passed as `helix agent --prompt`.
+     * WHO the agent is — the agent definition, passed as `helix agent --prompt`. Omit it to name a definition the BOX resolves instead: `args` must then carry `--name <agent>` (the image’s bundled roster, then the box’s agent dirs). Exactly one of `prompt` or a `--name` in `args` is required.
      */
-    prompt: string;
+    prompt?: string | undefined;
     /**
      * WHAT to do this turn — the task, passed as `-p`. A different prompt from `prompt`.
      */
@@ -43,7 +43,7 @@ export type PresetTimeoutMsKeep2$Outbound = {
     timeoutMs?: number | undefined;
     keep?: boolean | undefined;
     runId?: string | undefined;
-    prompt: string;
+    prompt?: string | undefined;
     task: string;
     prime?: boolean | undefined;
     args?: Array<string> | undefined;

package/dist/commonjs/models/preset-timeout-ms-keep2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preset-timeout-ms-keep2.d.ts","sourceRoot":"","sources":["../../../src/models/preset-timeout-ms-keep2.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjC;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,mCAAmC,EAAE,CAAC,CAAC,WAAW,CAC7D,6BAA6B,EAC7B,oBAAoB,CAWpB,CAAC;AAEH,wBAAgB,0BAA0B,CACxC,oBAAoB,EAAE,oBAAoB,GACzC,MAAM,CAIR"}
+{"version":3,"file":"preset-timeout-ms-keep2.d.ts","sourceRoot":"","sources":["../../../src/models/preset-timeout-ms-keep2.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjC;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,mCAAmC,EAAE,CAAC,CAAC,WAAW,CAC7D,6BAA6B,EAC7B,oBAAoB,CAWpB,CAAC;AAEH,wBAAgB,0BAA0B,CACxC,oBAAoB,EAAE,oBAAoB,GACzC,MAAM,CAIR"}

package/dist/commonjs/models/preset-timeout-ms-keep2.js

@@ -45,7 +45,7 @@ exports.PresetTimeoutMsKeep2$outboundSchema = z.object({
     timeoutMs: z.optional(z.number()),
     keep: z.optional(z.boolean()),
     runId: z.optional(z.string()),
-    prompt: z.string(),
+    prompt: z.optional(z.string()),
     task: z.string(),
     prime: z.optional(z.boolean()),
     args: z.optional(z.array(z.string())),

package/dist/commonjs/models/preset-timeout-ms-keep2.js.map

@@ -1 +1 @@
-{"version":3,"file":"preset-timeout-ms-keep2.js","sourceRoot":"","sources":["../../../src/models/preset-timeout-ms-keep2.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwEH,gEAMC;AA5ED,+CAAiC;AAsDjC,gBAAgB;AACH,QAAA,mCAAmC,GAG5C,CAAC,CAAC,MAAM,CAAC;IACX,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC5B,CAAC,CAAC;AAEH,SAAgB,0BAA0B,CACxC,oBAA0C;IAE1C,OAAO,IAAI,CAAC,SAAS,CACnB,2CAAmC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAChE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"preset-timeout-ms-keep2.js","sourceRoot":"","sources":["../../../src/models/preset-timeout-ms-keep2.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwEH,gEAMC;AA5ED,+CAAiC;AAsDjC,gBAAgB;AACH,QAAA,mCAAmC,GAG5C,CAAC,CAAC,MAAM,CAAC;IACX,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC5B,CAAC,CAAC;AAEH,SAAgB,0BAA0B,CACxC,oBAA0C;IAE1C,OAAO,IAAI,CAAC,SAAS,CACnB,2CAAmC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAChE,CAAC;AACJ,CAAC"}

package/dist/commonjs/sdk/sandbox.d.ts

@@ -133,7 +133,7 @@ export declare class Sandbox extends ClientSDK {
      * Run one agent turn in a fresh sandbox
      *
      * @remarks
-     * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
+     * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. `prompt` may be omitted when `args` carries `--name <agent>` instead — the box's own helix then resolves the name against the image's bundled roster and its agent dirs; exactly one of the two is required (422 otherwise). The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
      */
     postApiSandboxAgentRun(request: operations.PostApiSandboxAgentRunRequest, options?: RequestOptions): Promise<operations.PostApiSandboxAgentRunResponse>;
     /**

package/dist/commonjs/sdk/sandbox.js

@@ -197,7 +197,7 @@ class Sandbox extends sdks_js_1.ClientSDK {
      * Run one agent turn in a fresh sandbox
      *
      * @remarks
-     * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
+     * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. `prompt` may be omitted when `args` carries `--name <agent>` instead — the box's own helix then resolves the name against the image's bundled roster and its agent dirs; exactly one of the two is required (422 otherwise). The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
      */
     async postApiSandboxAgentRun(request, options) {
         return (0, fp_js_1.unwrapAsync)((0, sandbox_post_api_sandbox_agent_run_js_1.sandboxPostApiSandboxAgentRun)(this, request, options));

package/dist/esm/funcs/sandbox-post-api-sandbox-agent-run.d.ts

@@ -12,7 +12,7 @@ import { Result } from "../types/fp.js";
  * Run one agent turn in a fresh sandbox
  *
  * @remarks
- * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
+ * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. `prompt` may be omitted when `args` carries `--name <agent>` instead — the box's own helix then resolves the name against the image's bundled roster and its agent dirs; exactly one of the two is required (422 otherwise). The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
  */
 export declare function sandboxPostApiSandboxAgentRun(client: MutagentCore, request: operations.PostApiSandboxAgentRunRequest, options?: RequestOptions): APIPromise<Result<operations.PostApiSandboxAgentRunResponse, errors.ErrorMessage | errors.ErrorMessageStatusCode | MutagentError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 //# sourceMappingURL=sandbox-post-api-sandbox-agent-run.d.ts.map

package/dist/esm/funcs/sandbox-post-api-sandbox-agent-run.js

@@ -16,7 +16,7 @@ import { APIPromise } from "../types/async.js";
  * Run one agent turn in a fresh sandbox
  *
  * @remarks
- * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
+ * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. `prompt` may be omitted when `args` carries `--name <agent>` instead — the box's own helix then resolves the name against the image's bundled roster and its agent dirs; exactly one of the two is required (422 otherwise). The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
  */
 export function sandboxPostApiSandboxAgentRun(client, request, options) {
     return new APIPromise($do(client, request, options));

package/dist/esm/lib/config.d.ts

@@ -35,8 +35,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "2.0.0";
-    readonly sdkVersion: "0.3.45";
+    readonly sdkVersion: "0.3.47";
     readonly genVersion: "2.935.1";
-    readonly userAgent: "speakeasy-sdk/typescript 0.3.45 2.935.1 2.0.0 @mutagent/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 0.3.47 2.935.1 2.0.0 @mutagent/sdk";
 };
 //# sourceMappingURL=config.d.ts.map

package/dist/esm/lib/config.js

@@ -27,8 +27,8 @@ export function serverURLFromOptions(options) {
 export const SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "2.0.0",
-    sdkVersion: "0.3.45",
+    sdkVersion: "0.3.47",
     genVersion: "2.935.1",
-    userAgent: "speakeasy-sdk/typescript 0.3.45 2.935.1 2.0.0 @mutagent/sdk",
+    userAgent: "speakeasy-sdk/typescript 0.3.47 2.935.1 2.0.0 @mutagent/sdk",
 };
 //# sourceMappingURL=config.js.map

package/dist/esm/models/preset-timeout-ms-keep2.d.ts

@@ -17,9 +17,9 @@ export type PresetTimeoutMsKeep2 = {
      */
     runId?: string | undefined;
     /**
-     * WHO the agent is — the agent definition, passed as `helix agent --prompt`.
+     * WHO the agent is — the agent definition, passed as `helix agent --prompt`. Omit it to name a definition the BOX resolves instead: `args` must then carry `--name <agent>` (the image’s bundled roster, then the box’s agent dirs). Exactly one of `prompt` or a `--name` in `args` is required.
      */
-    prompt: string;
+    prompt?: string | undefined;
     /**
      * WHAT to do this turn — the task, passed as `-p`. A different prompt from `prompt`.
      */
@@ -43,7 +43,7 @@ export type PresetTimeoutMsKeep2$Outbound = {
     timeoutMs?: number | undefined;
     keep?: boolean | undefined;
     runId?: string | undefined;
-    prompt: string;
+    prompt?: string | undefined;
     task: string;
     prime?: boolean | undefined;
     args?: Array<string> | undefined;

package/dist/esm/models/preset-timeout-ms-keep2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preset-timeout-ms-keep2.d.ts","sourceRoot":"","sources":["../../../src/models/preset-timeout-ms-keep2.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjC;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,mCAAmC,EAAE,CAAC,CAAC,WAAW,CAC7D,6BAA6B,EAC7B,oBAAoB,CAWpB,CAAC;AAEH,wBAAgB,0BAA0B,CACxC,oBAAoB,EAAE,oBAAoB,GACzC,MAAM,CAIR"}
+{"version":3,"file":"preset-timeout-ms-keep2.d.ts","sourceRoot":"","sources":["../../../src/models/preset-timeout-ms-keep2.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjC;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,mCAAmC,EAAE,CAAC,CAAC,WAAW,CAC7D,6BAA6B,EAC7B,oBAAoB,CAWpB,CAAC;AAEH,wBAAgB,0BAA0B,CACxC,oBAAoB,EAAE,oBAAoB,GACzC,MAAM,CAIR"}

package/dist/esm/models/preset-timeout-ms-keep2.js

@@ -8,7 +8,7 @@ export const PresetTimeoutMsKeep2$outboundSchema = z.object({
     timeoutMs: z.optional(z.number()),
     keep: z.optional(z.boolean()),
     runId: z.optional(z.string()),
-    prompt: z.string(),
+    prompt: z.optional(z.string()),
     task: z.string(),
     prime: z.optional(z.boolean()),
     args: z.optional(z.array(z.string())),

package/dist/esm/models/preset-timeout-ms-keep2.js.map

@@ -1 +1 @@
-{"version":3,"file":"preset-timeout-ms-keep2.js","sourceRoot":"","sources":["../../../src/models/preset-timeout-ms-keep2.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAsDjC,gBAAgB;AAChB,MAAM,CAAC,MAAM,mCAAmC,GAG5C,CAAC,CAAC,MAAM,CAAC;IACX,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,UAAU,0BAA0B,CACxC,oBAA0C;IAE1C,OAAO,IAAI,CAAC,SAAS,CACnB,mCAAmC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAChE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"preset-timeout-ms-keep2.js","sourceRoot":"","sources":["../../../src/models/preset-timeout-ms-keep2.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAsDjC,gBAAgB;AAChB,MAAM,CAAC,MAAM,mCAAmC,GAG5C,CAAC,CAAC,MAAM,CAAC;IACX,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,UAAU,0BAA0B,CACxC,oBAA0C;IAE1C,OAAO,IAAI,CAAC,SAAS,CACnB,mCAAmC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAChE,CAAC;AACJ,CAAC"}

package/dist/esm/sdk/sandbox.d.ts

@@ -133,7 +133,7 @@ export declare class Sandbox extends ClientSDK {
      * Run one agent turn in a fresh sandbox
      *
      * @remarks
-     * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
+     * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. `prompt` may be omitted when `args` carries `--name <agent>` instead — the box's own helix then resolves the name against the image's bundled roster and its agent dirs; exactly one of the two is required (422 otherwise). The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
      */
     postApiSandboxAgentRun(request: operations.PostApiSandboxAgentRunRequest, options?: RequestOptions): Promise<operations.PostApiSandboxAgentRunResponse>;
     /**

package/dist/esm/sdk/sandbox.js

@@ -194,7 +194,7 @@ export class Sandbox extends ClientSDK {
      * Run one agent turn in a fresh sandbox
      *
      * @remarks
-     * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
+     * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. `prompt` may be omitted when `args` carries `--name <agent>` instead — the box's own helix then resolves the name against the image's bundled roster and its agent dirs; exactly one of the two is required (422 otherwise). The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
      */
     async postApiSandboxAgentRun(request, options) {
         return unwrapAsync(sandboxPostApiSandboxAgentRun(this, request, options));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutagent/sdk",
-  "version": "0.3.45",
+  "version": "0.3.47",
   "author": "Speakeasy",
   "tshy": {
     "sourceDialects": [

package/src/funcs/sandbox-post-api-sandbox-agent-run.ts

@@ -31,7 +31,7 @@ import { Result } from "../types/fp.js";
  * Run one agent turn in a fresh sandbox
  *
  * @remarks
- * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
+ * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. `prompt` may be omitted when `args` carries `--name <agent>` instead — the box's own helix then resolves the name against the image's bundled roster and its agent dirs; exactly one of the two is required (422 otherwise). The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
  */
 export function sandboxPostApiSandboxAgentRun(
   client: MutagentCore,

package/src/lib/config.ts

@@ -65,7 +65,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "2.0.0",
-  sdkVersion: "0.3.45",
+  sdkVersion: "0.3.47",
   genVersion: "2.935.1",
-  userAgent: "speakeasy-sdk/typescript 0.3.45 2.935.1 2.0.0 @mutagent/sdk",
+  userAgent: "speakeasy-sdk/typescript 0.3.47 2.935.1 2.0.0 @mutagent/sdk",
 } as const;

package/src/models/preset-timeout-ms-keep2.ts

@@ -22,9 +22,9 @@ export type PresetTimeoutMsKeep2 = {
    */
   runId?: string | undefined;
   /**
-   * WHO the agent is — the agent definition, passed as `helix agent --prompt`.
+   * WHO the agent is — the agent definition, passed as `helix agent --prompt`. Omit it to name a definition the BOX resolves instead: `args` must then carry `--name <agent>` (the image’s bundled roster, then the box’s agent dirs). Exactly one of `prompt` or a `--name` in `args` is required.
    */
-  prompt: string;
+  prompt?: string | undefined;
   /**
    * WHAT to do this turn — the task, passed as `-p`. A different prompt from `prompt`.
    */
@@ -49,7 +49,7 @@ export type PresetTimeoutMsKeep2$Outbound = {
   timeoutMs?: number | undefined;
   keep?: boolean | undefined;
   runId?: string | undefined;
-  prompt: string;
+  prompt?: string | undefined;
   task: string;
   prime?: boolean | undefined;
   args?: Array<string> | undefined;
@@ -65,7 +65,7 @@ export const PresetTimeoutMsKeep2$outboundSchema: z.ZodMiniType<
   timeoutMs: z.optional(z.number()),
   keep: z.optional(z.boolean()),
   runId: z.optional(z.string()),
-  prompt: z.string(),
+  prompt: z.optional(z.string()),
   task: z.string(),
   prime: z.optional(z.boolean()),
   args: z.optional(z.array(z.string())),

package/src/sdk/sandbox.ts

@@ -342,7 +342,7 @@ export class Sandbox extends ClientSDK {
    * Run one agent turn in a fresh sandbox
    *
    * @remarks
-   * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
+   * `prompt` is WHO the agent is (the agent definition) and `task` is WHAT to do this turn. They are two different prompts and are never concatenated. `prompt` may be omitted when `args` carries `--name <agent>` instead — the box's own helix then resolves the name against the image's bundled roster and its agent dirs; exactly one of the two is required (422 otherwise). The turn's output comes back on stdout with the agent's real exit code. With `?stream=1` the same turn is delivered as it happens, in the event framing of `GET /:id/stream`: a `sandbox` event naming the box, then `stdout`/`stderr` as the agent produces them, then a `result` event carrying the exit code and whether the sandbox was torn down, then the terminal `status`. Disconnecting mid-stream releases the sandbox.
    */
   async postApiSandboxAgentRun(
     request: operations.PostApiSandboxAgentRunRequest,