@mutagent/sdk 0.3.55 → 0.4.1

package/src/models/operations/put-api-sandbox-helix-defaults.ts

@@ -0,0 +1,121 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+
+export type PutApiSandboxHelixDefaultsRequest = {
+  /**
+   * Ordered `provider/model` ids from the workspace’s list; the first becomes the default. Every entry must be in the list (422 names the list otherwise). An empty array clears the defaults.
+   */
+  models: Array<string>;
+};
+
+export type PutApiSandboxHelixDefaultsModel = {
+  /**
+   * `provider/model` in the harness spelling — the exact value `--model` (or a session/agent-run `model`) takes.
+   */
+  id: string;
+  /**
+   * The platform provider id of the row this model comes from (`provider_configs.provider`).
+   */
+  provider: string;
+  /**
+   * The harness provider id — the key in the box’s generated `models.json`.
+   */
+  harnessProvider: string;
+  model: string;
+  displayName: string;
+};
+
+/**
+ * The workspace’s Helix Cloud model list — the platform catalog restricted to the workspace’s active providers — and its default models.
+ */
+export type PutApiSandboxHelixDefaultsResponse = {
+  workspaceId: string;
+  models: Array<PutApiSandboxHelixDefaultsModel>;
+  /**
+   * The stored `helix_default_models`, ordered, as written — an entry whose provider has since been deactivated stays listed here and is skipped at resolution.
+   */
+  defaults: Array<string>;
+  /**
+   * The model a run that names none will use: the first entry of `defaults` that is in `models`. Null means such a run answers 428 NO_PROVIDER_CONFIGURED.
+   */
+  default: string | null;
+  /**
+   * Active providers the box cannot credential, by name (a `custom` row as `custom:<harnessProvider>`). They contribute no models.
+   */
+  unmapped: Array<string>;
+};
+
+/** @internal */
+export type PutApiSandboxHelixDefaultsRequest$Outbound = {
+  models: Array<string>;
+};
+
+/** @internal */
+export const PutApiSandboxHelixDefaultsRequest$outboundSchema: z.ZodMiniType<
+  PutApiSandboxHelixDefaultsRequest$Outbound,
+  PutApiSandboxHelixDefaultsRequest
+> = z.object({
+  models: z.array(z.string()),
+});
+
+export function putApiSandboxHelixDefaultsRequestToJSON(
+  putApiSandboxHelixDefaultsRequest: PutApiSandboxHelixDefaultsRequest,
+): string {
+  return JSON.stringify(
+    PutApiSandboxHelixDefaultsRequest$outboundSchema.parse(
+      putApiSandboxHelixDefaultsRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const PutApiSandboxHelixDefaultsModel$inboundSchema: z.ZodMiniType<
+  PutApiSandboxHelixDefaultsModel,
+  unknown
+> = z.object({
+  id: types.string(),
+  provider: types.string(),
+  harnessProvider: types.string(),
+  model: types.string(),
+  displayName: types.string(),
+});
+
+export function putApiSandboxHelixDefaultsModelFromJSON(
+  jsonString: string,
+): SafeParseResult<PutApiSandboxHelixDefaultsModel, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PutApiSandboxHelixDefaultsModel$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PutApiSandboxHelixDefaultsModel' from JSON`,
+  );
+}
+
+/** @internal */
+export const PutApiSandboxHelixDefaultsResponse$inboundSchema: z.ZodMiniType<
+  PutApiSandboxHelixDefaultsResponse,
+  unknown
+> = z.object({
+  workspaceId: types.string(),
+  models: z.array(z.lazy(() => PutApiSandboxHelixDefaultsModel$inboundSchema)),
+  defaults: z.array(types.string()),
+  default: types.nullable(types.string()),
+  unmapped: z.array(types.string()),
+});
+
+export function putApiSandboxHelixDefaultsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<PutApiSandboxHelixDefaultsResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      PutApiSandboxHelixDefaultsResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PutApiSandboxHelixDefaultsResponse' from JSON`,
+  );
+}

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

@@ -33,6 +33,10 @@ export type PresetTimeoutMsKeep2 = {
    * WHAT to do this turn — the task, passed as `-p`. A different prompt from `prompt`.
    */
   task: string;
+  /**
+   * The `provider/model` to run, from the workspace's Helix Cloud model list (GET /api/sandbox/helix/defaults, or `mutagent helix models`). Omitted: the workspace default; none configured: 428. A value outside the list is a 422 that names the list. Equivalent to `--model` in `args`; if both are given they must name the same model, or the request is a 422. A `--model` in `args` with no value is a 422 too, and so is more than one `--model` there, or any `--provider` or `--models`: the harness runs the last `--model`, and those flags change which model it resolves.
+   */
+  model?: string | undefined;
   /**
    * Run the agent on the ASPS-Prime scaffold instead of the default ASPS one — leaner, code-first, no orchestrator persona. Forwarded to the binary as `--prime`.
    */
@@ -56,6 +60,7 @@ export type PresetTimeoutMsKeep2$Outbound = {
   environment?: string | undefined;
   prompt?: string | undefined;
   task: string;
+  model?: string | undefined;
   prime?: boolean | undefined;
   args?: Array<string> | undefined;
   cwd?: string | undefined;
@@ -73,6 +78,7 @@ export const PresetTimeoutMsKeep2$outboundSchema: z.ZodMiniType<
   environment: z.optional(z.string()),
   prompt: z.optional(z.string()),
   task: z.string(),
+  model: z.optional(z.string()),
   prime: z.optional(z.boolean()),
   args: z.optional(z.array(z.string())),
   cwd: z.optional(z.string()),

package/src/sdk/sandbox.ts

@@ -11,6 +11,7 @@ import { sandboxGetApiSandboxByIdTraces } from "../funcs/sandbox-get-api-sandbox
 import { sandboxGetApiSandboxById } from "../funcs/sandbox-get-api-sandbox-by-id.js";
 import { sandboxGetApiSandboxEnvironmentsByName } from "../funcs/sandbox-get-api-sandbox-environments-by-name.js";
 import { sandboxGetApiSandboxEnvironments } from "../funcs/sandbox-get-api-sandbox-environments.js";
+import { sandboxGetApiSandboxHelixDefaults } from "../funcs/sandbox-get-api-sandbox-helix-defaults.js";
 import { sandboxGetApiSandboxPresets } from "../funcs/sandbox-get-api-sandbox-presets.js";
 import { sandboxGetApiSandboxProviders } from "../funcs/sandbox-get-api-sandbox-providers.js";
 import { sandboxGetApiSandbox } from "../funcs/sandbox-get-api-sandbox.js";
@@ -28,6 +29,7 @@ import { sandboxPostApiSandboxTelemetryV1Traces } from "../funcs/sandbox-post-ap
 import { sandboxPostApiSandboxToken } from "../funcs/sandbox-post-api-sandbox-token.js";
 import { sandboxPostApiSandbox } from "../funcs/sandbox-post-api-sandbox.js";
 import { sandboxPutApiSandboxEnvironmentsByName } from "../funcs/sandbox-put-api-sandbox-environments-by-name.js";
+import { sandboxPutApiSandboxHelixDefaults } from "../funcs/sandbox-put-api-sandbox-helix-defaults.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
@@ -324,6 +326,38 @@ export class Sandbox extends ClientSDK {
     ));
   }
 
+  /**
+   * List the workspace's Helix Cloud models and its default
+   *
+   * @remarks
+   * The platform model catalog restricted to the workspace’s active LLM providers, each as `provider/model` in the harness spelling, plus the stored ordered defaults and the one a run naming no model would use now. Providers the box cannot credential are named in `unmapped`. `sandbox:read`.
+   */
+  async getApiSandboxHelixDefaults(
+    options?: RequestOptions,
+  ): Promise<operations.GetApiSandboxHelixDefaultsResponse> {
+    return unwrapAsync(sandboxGetApiSandboxHelixDefaults(
+      this,
+      options,
+    ));
+  }
+
+  /**
+   * Set the workspace's default Helix Cloud models
+   *
+   * @remarks
+   * Replaces the ordered list; the first entry becomes the default for session starts and agent runs that name no model. Every entry must be in the workspace’s list (422 names the list). `[]` clears the defaults, after which such runs answer 428 NO_PROVIDER_CONFIGURED. Operator tokens only. 409 `HELIX_DEFAULTS_UNAVAILABLE` when this server has no Helix Cloud model source configured.
+   */
+  async putApiSandboxHelixDefaults(
+    request: operations.PutApiSandboxHelixDefaultsRequest,
+    options?: RequestOptions,
+  ): Promise<operations.PutApiSandboxHelixDefaultsResponse> {
+    return unwrapAsync(sandboxPutApiSandboxHelixDefaults(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * List the Helix sessions a sandbox is hosting
    *

package/dist/commonjs/models/mode-arm-args.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mode-arm-args.d.ts","sourceRoot":"","sources":["../../../src/models/mode-arm-args.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAGL,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,IAAI,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACrC;;OAEG;IACH,GAAG,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACpC;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjC;;OAEG;IACH,GAAG,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC1C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC1C,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,2BAA2B,GAAG;IACxC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,iCAAiC,EAAE,CAAC,CAAC,WAAW,CAC3D,2BAA2B,EAC3B,kBAAkB,CAGlB,CAAC;AAEH,wBAAgB,wBAAwB,CACtC,kBAAkB,EAAE,kBAAkB,GACrC,MAAM,CAIR;AAED,gBAAgB;AAChB,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjC,GAAG,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAC;CACnD,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,0BAA0B,EAAE,CAAC,CAAC,WAAW,CACpD,oBAAoB,EACpB,WAAW,CASX,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAElE"}

package/dist/commonjs/models/mode-arm-args.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mode-arm-args.js","sourceRoot":"","sources":["../../../src/models/mode-arm-args.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEH,4DAMC;AA2BD,8CAEC;AArGD,+CAAiC;AACjC,yDAI4B;AAC5B,yDAI4B;AAgD5B,gBAAgB;AACH,QAAA,iCAAiC,GAG1C,CAAC,CAAC,MAAM,CAAC;IACX,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CACnC,CAAC,CAAC;AAEH,SAAgB,wBAAwB,CACtC,kBAAsC;IAEtC,OAAO,IAAI,CAAC,SAAS,CACnB,yCAAiC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAC5D,CAAC;AACJ,CAAC;AAaD,gBAAgB;AACH,QAAA,0BAA0B,GAGnC,CAAC,CAAC,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,+CAA4B,EAAE,gCAAa,CAAC,OAAO,CAAC;IACrE,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,+CAA4B,EAAE,gCAAa,CAAC,OAAO,CAAC;IACpE,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,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,yCAAiC,CAAC,CAAC;CACrE,CAAC,CAAC;AAEH,SAAgB,iBAAiB,CAAC,WAAwB;IACxD,OAAO,IAAI,CAAC,SAAS,CAAC,kCAA0B,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/esm/models/mode-arm-args.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mode-arm-args.d.ts","sourceRoot":"","sources":["../../../src/models/mode-arm-args.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EAGL,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,IAAI,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACrC;;OAEG;IACH,GAAG,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACpC;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjC;;OAEG;IACH,GAAG,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC1C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC1C,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,2BAA2B,GAAG;IACxC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,iCAAiC,EAAE,CAAC,CAAC,WAAW,CAC3D,2BAA2B,EAC3B,kBAAkB,CAGlB,CAAC;AAEH,wBAAgB,wBAAwB,CACtC,kBAAkB,EAAE,kBAAkB,GACrC,MAAM,CAIR;AAED,gBAAgB;AAChB,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjC,GAAG,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAC;CACnD,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,0BAA0B,EAAE,CAAC,CAAC,WAAW,CACpD,oBAAoB,EACpB,WAAW,CASX,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAElE"}

package/dist/esm/models/mode-arm-args.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mode-arm-args.js","sourceRoot":"","sources":["../../../src/models/mode-arm-args.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,EACL,aAAa,EACb,4BAA4B,GAE7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,aAAa,EACb,4BAA4B,GAE7B,MAAM,oBAAoB,CAAC;AAgD5B,gBAAgB;AAChB,MAAM,CAAC,MAAM,iCAAiC,GAG1C,CAAC,CAAC,MAAM,CAAC;IACX,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CACnC,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CACtC,kBAAsC;IAEtC,OAAO,IAAI,CAAC,SAAS,CACnB,iCAAiC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAC5D,CAAC;AACJ,CAAC;AAaD,gBAAgB;AAChB,MAAM,CAAC,MAAM,0BAA0B,GAGnC,CAAC,CAAC,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,EAAE,aAAa,CAAC,OAAO,CAAC;IACrE,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,EAAE,aAAa,CAAC,OAAO,CAAC;IACpE,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,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,iCAAiC,CAAC,CAAC;CACrE,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAAC,WAAwB;IACxD,OAAO,IAAI,CAAC,SAAS,CAAC,0BAA0B,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AACvE,CAAC"}