@ai-sdk/harness-grok-build 1.0.14 → 1.0.16

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @ai-sdk/harness-grok-build
 
+## 1.0.16
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.79
+- @ai-sdk/harness-acp@1.0.17
+
+## 1.0.15
+
+### Patch Changes
+
+- c0595b4: feat(harness): support passing a filesystem and process restricted sandbox session to `HarnessAgentSession`, using fallbacks in favor of the preferred network sandbox session methods
+- Updated dependencies [eace6fb]
+- Updated dependencies [c0595b4]
+  - @ai-sdk/harness-acp@1.0.16
+  - @ai-sdk/harness@1.0.78
+
 ## 1.0.14
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as _ai_sdk_provider from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import * as _ai_sdk_harness from '@ai-sdk/harness';
-import { HarnessV1, HarnessV1BuiltinTool } from '@ai-sdk/harness';
+import { HarnessV1PortEndpoint, HarnessV1, HarnessV1BuiltinTool } from '@ai-sdk/harness';
 import { ACPProviderAuthenticationMode } from '@ai-sdk/harness-acp';
 
 type GrokBuildHarnessSettings = {
@@ -18,6 +18,11 @@ type GrokBuildHarnessSettings = {
      * Overrides the sandbox port used by the ACP bridge.
      */
     readonly port?: number;
+    /**
+     * Override the host endpoint used to connect to the sandbox bridge. Required
+     * together with `port` when using a basic sandbox session.
+     */
+    readonly portEndpoint?: HarnessV1PortEndpoint;
     /**
      * Maximum milliseconds to wait for the ACP bridge to start.
      */

package/dist/index.js

@@ -10,7 +10,7 @@ import { tool } from "@ai-sdk/provider-utils";
 import { z } from "zod/v4";
 
 // src/version.ts
-var VERSION = true ? "1.0.14" : "0.0.0-test";
+var VERSION = true ? "1.0.16" : "0.0.0-test";
 
 // src/grok-build-harness.ts
 var GROK_BUILD_CLIENT_APP = `ai-sdk/harness-grok-build/${VERSION}`;
@@ -236,6 +236,7 @@ function createGrokBuild(settings = {}) {
     auth: settings.auth,
     modelId: settings.model,
     port: settings.port,
+    portEndpoint: settings.portEndpoint,
     startupTimeoutMs: settings.startupTimeoutMs,
     mcpServers: settings.mcpServers,
     isMcpToolCall: (toolCall) => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/grok-build-harness.ts","../src/version.ts","../src/index.ts"],"sourcesContent":["import {\n  commonTool,\n  type HarnessV1,\n  type HarnessV1BuiltinTool,\n} from '@ai-sdk/harness';\nimport { createCredentialRequestTransformation } from '@ai-sdk/harness/utils';\nimport {\n  createACP,\n  type ACPProviderAuthenticationMode,\n} from '@ai-sdk/harness-acp';\nimport { tool } from '@ai-sdk/provider-utils';\nimport { z } from 'zod/v4';\nimport { VERSION } from './version';\n\ndeclare const __GROK_BUILD_IMPLEMENTATION_PACKAGE_JSON__: string;\ndeclare const __GROK_BUILD_IMPLEMENTATION_PNPM_LOCK_YAML__: string;\n\nconst GROK_BUILD_CLIENT_APP = `ai-sdk/harness-grok-build/${VERSION}`;\nconst GROK_BUILD_IMPLEMENTATION_PACKAGE_JSON =\n  __GROK_BUILD_IMPLEMENTATION_PACKAGE_JSON__;\nconst GROK_BUILD_IMPLEMENTATION_PNPM_LOCK =\n  __GROK_BUILD_IMPLEMENTATION_PNPM_LOCK_YAML__;\n\nexport type GrokBuildHarnessSettings = {\n  /**\n   * Selects direct xAI or AI Gateway authentication. Defaults to automatic\n   * environment-based selection.\n   */\n  readonly auth?: ACPProviderAuthenticationMode;\n  /**\n   * Grok model id selected through ACP. Unset preserves Grok Build's default.\n   */\n  readonly model?: string;\n  /**\n   * Overrides the sandbox port used by the ACP bridge.\n   */\n  readonly port?: number;\n  /**\n   * Maximum milliseconds to wait for the ACP bridge to start.\n   */\n  readonly startupTimeoutMs?: number;\n  /**\n   * MCP server definitions keyed by server name. Each definition uses the\n   * underlying runtime's native MCP server configuration format.\n   */\n  readonly mcpServers?: Record<string, unknown>;\n  /**\n   * Creates the authentication token used by the sandbox bridge. Defaults to\n   * a random 32-byte hexadecimal token.\n   */\n  readonly mintBridgeToken?: (sandboxId: string) => string;\n};\n\n/*\n * Tool names and inputs were captured from the model request produced by\n * @xai-official/grok 0.2.111, the version used by the pinned Grok Build ACP\n * implementation.\n */\nconst GROK_BUILD_BUILTIN_TOOLS = {\n  bash: commonTool('bash', {\n    nativeName: 'run_terminal_command',\n    toolUseKind: 'bash',\n    inputSchema: z.looseObject({\n      command: z.string(),\n      timeout: z.number().int().min(0).max(36_000_000).nullable().optional(),\n      description: z.string().optional(),\n      background: z.boolean().optional(),\n    }),\n  }),\n  edit: commonTool('edit', {\n    nativeName: 'search_replace',\n    toolUseKind: 'edit',\n    inputSchema: z.looseObject({\n      file_path: z.string(),\n      old_string: z.string(),\n      new_string: z.string(),\n      replace_all: z.boolean().optional(),\n    }),\n  }),\n  grep: commonTool('grep', {\n    nativeName: 'grep',\n    toolUseKind: 'readonly',\n    inputSchema: z.looseObject({\n      pattern: z.string(),\n      path: z.string().nullable().optional(),\n      glob: z.string().nullable().optional(),\n      '-B': z.number().int().optional(),\n      '-A': z.number().int().optional(),\n      '-C': z.number().int().optional(),\n      '-i': z.boolean().optional(),\n      type: z.string().nullable().optional(),\n      head_limit: z.number().int().optional(),\n      multiline: z.boolean().optional(),\n    }),\n  }),\n  webSearch: commonTool('webSearch', {\n    nativeName: 'web_search',\n    toolUseKind: 'readonly',\n    inputSchema: z.looseObject({\n      query: z.string(),\n      allowed_domains: z.array(z.string()).nullable().optional(),\n    }),\n  }),\n  write: commonTool('write', {\n    nativeName: 'write',\n    toolUseKind: 'edit',\n    inputSchema: z.looseObject({\n      file_path: z.string(),\n      content: z.string(),\n    }),\n  }),\n  read_file: {\n    ...tool({\n      inputSchema: z.looseObject({\n        target_file: z.string(),\n        offset: z.number().int().optional(),\n        limit: z.number().int().optional(),\n        pages: z.string().nullable().optional(),\n        format: z.string().nullable().optional(),\n      }),\n    }),\n    toolUseKind: 'readonly',\n  },\n  list_dir: {\n    ...tool({\n      inputSchema: z.looseObject({\n        target_directory: z.string(),\n      }),\n    }),\n    toolUseKind: 'readonly',\n  },\n  kill_command_or_subagent: tool({\n    inputSchema: z.looseObject({\n      task_id: z.string(),\n    }),\n  }),\n  todo_write: tool({\n    inputSchema: z.looseObject({\n      merge: z.boolean().optional(),\n      todos: z.array(\n        z.looseObject({\n          id: z.string(),\n          content: z.string().nullable().optional(),\n          status: z\n            .enum(['pending', 'in_progress', 'completed', 'cancelled'])\n            .nullable()\n            .optional(),\n        }),\n      ),\n    }),\n  }),\n  get_command_or_subagent_output: {\n    ...tool({\n      inputSchema: z.looseObject({\n        task_ids: z.array(z.string()).optional(),\n        timeout_ms: z.number().int().nonnegative().nullable().optional(),\n      }),\n    }),\n    toolUseKind: 'readonly',\n  },\n  spawn_subagent: tool({\n    inputSchema: z.looseObject({\n      prompt: z.string(),\n      description: z.string(),\n      subagent_type: z.string().optional(),\n      background: z.boolean().optional(),\n      capability_mode: z\n        .enum(['read-only', 'read-write', 'execute', 'all'])\n        .nullable()\n        .optional(),\n      isolation: z.enum(['none', 'worktree']).nullable().optional(),\n      resume_from: z.string().nullable().optional(),\n      cwd: z.string().nullable().optional(),\n      model: z.string().nullable().optional(),\n    }),\n  }),\n  scheduler_create: tool({\n    inputSchema: z.looseObject({\n      task_id: z.string().nullable().optional(),\n      interval: z.string().nullable().optional(),\n      prompt: z.string().nullable().optional(),\n      durable: z.boolean().nullable().optional(),\n      foreground: z.boolean().nullable().optional(),\n      fire_immediately: z.boolean().optional(),\n    }),\n  }),\n  scheduler_delete: tool({\n    inputSchema: z.looseObject({ id: z.string() }),\n  }),\n  scheduler_list: {\n    ...tool({ inputSchema: z.looseObject({}) }),\n    toolUseKind: 'readonly',\n  },\n  monitor: tool({\n    inputSchema: z.looseObject({\n      command: z.string(),\n      description: z.string(),\n      timeout_ms: z.number().int().nonnegative().nullable().optional(),\n      persistent: z.boolean().optional(),\n    }),\n  }),\n  search_tool: {\n    ...tool({\n      inputSchema: z.looseObject({\n        query: z.string(),\n        limit: z.number().int().min(0).max(255).nullable().optional(),\n      }),\n    }),\n    toolUseKind: 'readonly',\n  },\n  use_tool: tool({\n    inputSchema: z.looseObject({\n      tool_name: z.string(),\n      tool_input: z.looseObject({}),\n    }),\n  }),\n  workflow: tool({\n    inputSchema: z.looseObject({\n      agent_budget: z.number().int().min(1).max(1024).nullable().optional(),\n      name: z.string().nullable().optional(),\n      script: z.string().nullable().optional(),\n      script_path: z.string().nullable().optional(),\n      args: z.unknown().optional(),\n      resume_from_run_id: z.string().nullable().optional(),\n      validate_only: z.boolean().optional(),\n    }),\n  }),\n  enter_plan_mode: tool({ inputSchema: z.looseObject({}) }),\n  exit_plan_mode: tool({ inputSchema: z.looseObject({}) }),\n  ask_user_question: tool({\n    inputSchema: z.looseObject({\n      questions: z.array(\n        z.looseObject({\n          question: z.string(),\n          options: z.array(\n            z.looseObject({\n              label: z.string(),\n              description: z.string(),\n              preview: z.string().nullable().optional(),\n            }),\n          ),\n          multi_select: z.boolean().nullable().optional(),\n        }),\n      ),\n    }),\n  }),\n  image_gen: tool({\n    inputSchema: z.looseObject({\n      prompt: z.string(),\n      aspect_ratio: z.string().optional(),\n    }),\n  }),\n  image_edit: tool({\n    inputSchema: z.looseObject({\n      prompt: z.string(),\n      image: z.array(z.string()),\n      aspect_ratio: z.string().optional(),\n    }),\n  }),\n  image_to_video: tool({\n    inputSchema: z.looseObject({\n      prompt: z.string().nullable().optional(),\n      image: z.string(),\n      duration: z.number().int().nonnegative().nullable().optional(),\n      resolution_name: z.string().optional(),\n    }),\n  }),\n  reference_to_video: tool({\n    inputSchema: z.looseObject({\n      prompt: z.string(),\n      images: z.array(z.string()),\n      aspect_ratio: z.string(),\n      duration: z.number().int().nonnegative().nullable().optional(),\n      resolution_name: z.string().optional(),\n    }),\n  }),\n} as const satisfies Record<string, HarnessV1BuiltinTool<any, any>>;\n\nexport function createGrokBuild(\n  settings: GrokBuildHarnessSettings = {},\n): HarnessV1<typeof GROK_BUILD_BUILTIN_TOOLS> {\n  const clientAppSegments = GROK_BUILD_CLIENT_APP.split('/');\n  const clientAppVersion = clientAppSegments.pop()!;\n\n  return createACP({\n    auth: settings.auth,\n    modelId: settings.model,\n    port: settings.port,\n    startupTimeoutMs: settings.startupTimeoutMs,\n    mcpServers: settings.mcpServers,\n    isMcpToolCall: toolCall => {\n      const metadata = toolCall._meta?.['x.ai/tool'];\n      return isRecord(metadata) && metadata.namespace === 'mcp';\n    },\n    mintBridgeToken: settings.mintBridgeToken,\n    version: 'v1',\n    harnessId: 'grok-build',\n    builtinTools: GROK_BUILD_BUILTIN_TOOLS,\n    clientApp: {\n      name: clientAppSegments.join('/'),\n      version: clientAppVersion,\n    },\n    source: {\n      type: 'npm-locked',\n      packageJson: GROK_BUILD_IMPLEMENTATION_PACKAGE_JSON,\n      pnpmLockYaml: GROK_BUILD_IMPLEMENTATION_PNPM_LOCK,\n    },\n    executable: 'grok',\n    args: ['agent', 'stdio'],\n    credentialEnv: ['XAI_API_KEY'],\n    credentialBrokering: ({ env }) => {\n      if (!env.XAI_API_KEY) return [];\n      return [\n        createCredentialRequestTransformation({\n          baseUrl: env.GROK_XAI_API_BASE_URL ?? 'https://api.x.ai/v1',\n          headers: { Authorization: `Bearer ${env.XAI_API_KEY}` },\n        }),\n      ];\n    },\n    instructionMapping: {\n      type: 'session-meta',\n      path: ['rules'],\n    },\n    outputSchemaMapping: {\n      type: 'session-prompt-meta',\n      path: ['outputSchema'],\n    },\n    providerAuthentication: {\n      gateway: {\n        env: {\n          GROK_CLIENT_NAME: { $source: 'client-app-name' },\n          GROK_CLIENT_VERSION: { $source: 'client-app-version' },\n          XAI_API_KEY: { $source: 'gateway-api-key' },\n          GROK_XAI_API_BASE_URL: {\n            $source: 'gateway-base-url',\n            ensureSuffix: '/v1',\n          },\n          GROK_MODELS_BASE_URL: {\n            $source: 'gateway-base-url',\n            ensureSuffix: '/v1',\n          },\n        },\n      },\n    },\n  });\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n","declare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n  typeof __PACKAGE_VERSION__ !== 'undefined'\n    ? __PACKAGE_VERSION__\n    : '0.0.0-test';\n","import { createGrokBuild } from './grok-build-harness';\n\n/**\n * Default Grok Build harness instance. Equivalent to `createGrokBuild()`.\n */\nexport const grokBuild = createGrokBuild();\n\nexport { createGrokBuild } from './grok-build-harness';\nexport type { GrokBuildHarnessSettings } from './grok-build-harness';\nexport { VERSION } from './version';\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/grok-build-harness.ts","../src/version.ts","../src/index.ts"],"sourcesContent":["import {\n  commonTool,\n  type HarnessV1,\n  type HarnessV1BuiltinTool,\n  type HarnessV1PortEndpoint,\n} from '@ai-sdk/harness';\nimport { createCredentialRequestTransformation } from '@ai-sdk/harness/utils';\nimport {\n  createACP,\n  type ACPProviderAuthenticationMode,\n} from '@ai-sdk/harness-acp';\nimport { tool } from '@ai-sdk/provider-utils';\nimport { z } from 'zod/v4';\nimport { VERSION } from './version';\n\ndeclare const __GROK_BUILD_IMPLEMENTATION_PACKAGE_JSON__: string;\ndeclare const __GROK_BUILD_IMPLEMENTATION_PNPM_LOCK_YAML__: string;\n\nconst GROK_BUILD_CLIENT_APP = `ai-sdk/harness-grok-build/${VERSION}`;\nconst GROK_BUILD_IMPLEMENTATION_PACKAGE_JSON =\n  __GROK_BUILD_IMPLEMENTATION_PACKAGE_JSON__;\nconst GROK_BUILD_IMPLEMENTATION_PNPM_LOCK =\n  __GROK_BUILD_IMPLEMENTATION_PNPM_LOCK_YAML__;\n\nexport type GrokBuildHarnessSettings = {\n  /**\n   * Selects direct xAI or AI Gateway authentication. Defaults to automatic\n   * environment-based selection.\n   */\n  readonly auth?: ACPProviderAuthenticationMode;\n  /**\n   * Grok model id selected through ACP. Unset preserves Grok Build's default.\n   */\n  readonly model?: string;\n  /**\n   * Overrides the sandbox port used by the ACP bridge.\n   */\n  readonly port?: number;\n  /**\n   * Override the host endpoint used to connect to the sandbox bridge. Required\n   * together with `port` when using a basic sandbox session.\n   */\n  readonly portEndpoint?: HarnessV1PortEndpoint;\n  /**\n   * Maximum milliseconds to wait for the ACP bridge to start.\n   */\n  readonly startupTimeoutMs?: number;\n  /**\n   * MCP server definitions keyed by server name. Each definition uses the\n   * underlying runtime's native MCP server configuration format.\n   */\n  readonly mcpServers?: Record<string, unknown>;\n  /**\n   * Creates the authentication token used by the sandbox bridge. Defaults to\n   * a random 32-byte hexadecimal token.\n   */\n  readonly mintBridgeToken?: (sandboxId: string) => string;\n};\n\n/*\n * Tool names and inputs were captured from the model request produced by\n * @xai-official/grok 0.2.111, the version used by the pinned Grok Build ACP\n * implementation.\n */\nconst GROK_BUILD_BUILTIN_TOOLS = {\n  bash: commonTool('bash', {\n    nativeName: 'run_terminal_command',\n    toolUseKind: 'bash',\n    inputSchema: z.looseObject({\n      command: z.string(),\n      timeout: z.number().int().min(0).max(36_000_000).nullable().optional(),\n      description: z.string().optional(),\n      background: z.boolean().optional(),\n    }),\n  }),\n  edit: commonTool('edit', {\n    nativeName: 'search_replace',\n    toolUseKind: 'edit',\n    inputSchema: z.looseObject({\n      file_path: z.string(),\n      old_string: z.string(),\n      new_string: z.string(),\n      replace_all: z.boolean().optional(),\n    }),\n  }),\n  grep: commonTool('grep', {\n    nativeName: 'grep',\n    toolUseKind: 'readonly',\n    inputSchema: z.looseObject({\n      pattern: z.string(),\n      path: z.string().nullable().optional(),\n      glob: z.string().nullable().optional(),\n      '-B': z.number().int().optional(),\n      '-A': z.number().int().optional(),\n      '-C': z.number().int().optional(),\n      '-i': z.boolean().optional(),\n      type: z.string().nullable().optional(),\n      head_limit: z.number().int().optional(),\n      multiline: z.boolean().optional(),\n    }),\n  }),\n  webSearch: commonTool('webSearch', {\n    nativeName: 'web_search',\n    toolUseKind: 'readonly',\n    inputSchema: z.looseObject({\n      query: z.string(),\n      allowed_domains: z.array(z.string()).nullable().optional(),\n    }),\n  }),\n  write: commonTool('write', {\n    nativeName: 'write',\n    toolUseKind: 'edit',\n    inputSchema: z.looseObject({\n      file_path: z.string(),\n      content: z.string(),\n    }),\n  }),\n  read_file: {\n    ...tool({\n      inputSchema: z.looseObject({\n        target_file: z.string(),\n        offset: z.number().int().optional(),\n        limit: z.number().int().optional(),\n        pages: z.string().nullable().optional(),\n        format: z.string().nullable().optional(),\n      }),\n    }),\n    toolUseKind: 'readonly',\n  },\n  list_dir: {\n    ...tool({\n      inputSchema: z.looseObject({\n        target_directory: z.string(),\n      }),\n    }),\n    toolUseKind: 'readonly',\n  },\n  kill_command_or_subagent: tool({\n    inputSchema: z.looseObject({\n      task_id: z.string(),\n    }),\n  }),\n  todo_write: tool({\n    inputSchema: z.looseObject({\n      merge: z.boolean().optional(),\n      todos: z.array(\n        z.looseObject({\n          id: z.string(),\n          content: z.string().nullable().optional(),\n          status: z\n            .enum(['pending', 'in_progress', 'completed', 'cancelled'])\n            .nullable()\n            .optional(),\n        }),\n      ),\n    }),\n  }),\n  get_command_or_subagent_output: {\n    ...tool({\n      inputSchema: z.looseObject({\n        task_ids: z.array(z.string()).optional(),\n        timeout_ms: z.number().int().nonnegative().nullable().optional(),\n      }),\n    }),\n    toolUseKind: 'readonly',\n  },\n  spawn_subagent: tool({\n    inputSchema: z.looseObject({\n      prompt: z.string(),\n      description: z.string(),\n      subagent_type: z.string().optional(),\n      background: z.boolean().optional(),\n      capability_mode: z\n        .enum(['read-only', 'read-write', 'execute', 'all'])\n        .nullable()\n        .optional(),\n      isolation: z.enum(['none', 'worktree']).nullable().optional(),\n      resume_from: z.string().nullable().optional(),\n      cwd: z.string().nullable().optional(),\n      model: z.string().nullable().optional(),\n    }),\n  }),\n  scheduler_create: tool({\n    inputSchema: z.looseObject({\n      task_id: z.string().nullable().optional(),\n      interval: z.string().nullable().optional(),\n      prompt: z.string().nullable().optional(),\n      durable: z.boolean().nullable().optional(),\n      foreground: z.boolean().nullable().optional(),\n      fire_immediately: z.boolean().optional(),\n    }),\n  }),\n  scheduler_delete: tool({\n    inputSchema: z.looseObject({ id: z.string() }),\n  }),\n  scheduler_list: {\n    ...tool({ inputSchema: z.looseObject({}) }),\n    toolUseKind: 'readonly',\n  },\n  monitor: tool({\n    inputSchema: z.looseObject({\n      command: z.string(),\n      description: z.string(),\n      timeout_ms: z.number().int().nonnegative().nullable().optional(),\n      persistent: z.boolean().optional(),\n    }),\n  }),\n  search_tool: {\n    ...tool({\n      inputSchema: z.looseObject({\n        query: z.string(),\n        limit: z.number().int().min(0).max(255).nullable().optional(),\n      }),\n    }),\n    toolUseKind: 'readonly',\n  },\n  use_tool: tool({\n    inputSchema: z.looseObject({\n      tool_name: z.string(),\n      tool_input: z.looseObject({}),\n    }),\n  }),\n  workflow: tool({\n    inputSchema: z.looseObject({\n      agent_budget: z.number().int().min(1).max(1024).nullable().optional(),\n      name: z.string().nullable().optional(),\n      script: z.string().nullable().optional(),\n      script_path: z.string().nullable().optional(),\n      args: z.unknown().optional(),\n      resume_from_run_id: z.string().nullable().optional(),\n      validate_only: z.boolean().optional(),\n    }),\n  }),\n  enter_plan_mode: tool({ inputSchema: z.looseObject({}) }),\n  exit_plan_mode: tool({ inputSchema: z.looseObject({}) }),\n  ask_user_question: tool({\n    inputSchema: z.looseObject({\n      questions: z.array(\n        z.looseObject({\n          question: z.string(),\n          options: z.array(\n            z.looseObject({\n              label: z.string(),\n              description: z.string(),\n              preview: z.string().nullable().optional(),\n            }),\n          ),\n          multi_select: z.boolean().nullable().optional(),\n        }),\n      ),\n    }),\n  }),\n  image_gen: tool({\n    inputSchema: z.looseObject({\n      prompt: z.string(),\n      aspect_ratio: z.string().optional(),\n    }),\n  }),\n  image_edit: tool({\n    inputSchema: z.looseObject({\n      prompt: z.string(),\n      image: z.array(z.string()),\n      aspect_ratio: z.string().optional(),\n    }),\n  }),\n  image_to_video: tool({\n    inputSchema: z.looseObject({\n      prompt: z.string().nullable().optional(),\n      image: z.string(),\n      duration: z.number().int().nonnegative().nullable().optional(),\n      resolution_name: z.string().optional(),\n    }),\n  }),\n  reference_to_video: tool({\n    inputSchema: z.looseObject({\n      prompt: z.string(),\n      images: z.array(z.string()),\n      aspect_ratio: z.string(),\n      duration: z.number().int().nonnegative().nullable().optional(),\n      resolution_name: z.string().optional(),\n    }),\n  }),\n} as const satisfies Record<string, HarnessV1BuiltinTool<any, any>>;\n\nexport function createGrokBuild(\n  settings: GrokBuildHarnessSettings = {},\n): HarnessV1<typeof GROK_BUILD_BUILTIN_TOOLS> {\n  const clientAppSegments = GROK_BUILD_CLIENT_APP.split('/');\n  const clientAppVersion = clientAppSegments.pop()!;\n\n  return createACP({\n    auth: settings.auth,\n    modelId: settings.model,\n    port: settings.port,\n    portEndpoint: settings.portEndpoint,\n    startupTimeoutMs: settings.startupTimeoutMs,\n    mcpServers: settings.mcpServers,\n    isMcpToolCall: toolCall => {\n      const metadata = toolCall._meta?.['x.ai/tool'];\n      return isRecord(metadata) && metadata.namespace === 'mcp';\n    },\n    mintBridgeToken: settings.mintBridgeToken,\n    version: 'v1',\n    harnessId: 'grok-build',\n    builtinTools: GROK_BUILD_BUILTIN_TOOLS,\n    clientApp: {\n      name: clientAppSegments.join('/'),\n      version: clientAppVersion,\n    },\n    source: {\n      type: 'npm-locked',\n      packageJson: GROK_BUILD_IMPLEMENTATION_PACKAGE_JSON,\n      pnpmLockYaml: GROK_BUILD_IMPLEMENTATION_PNPM_LOCK,\n    },\n    executable: 'grok',\n    args: ['agent', 'stdio'],\n    credentialEnv: ['XAI_API_KEY'],\n    credentialBrokering: ({ env }) => {\n      if (!env.XAI_API_KEY) return [];\n      return [\n        createCredentialRequestTransformation({\n          baseUrl: env.GROK_XAI_API_BASE_URL ?? 'https://api.x.ai/v1',\n          headers: { Authorization: `Bearer ${env.XAI_API_KEY}` },\n        }),\n      ];\n    },\n    instructionMapping: {\n      type: 'session-meta',\n      path: ['rules'],\n    },\n    outputSchemaMapping: {\n      type: 'session-prompt-meta',\n      path: ['outputSchema'],\n    },\n    providerAuthentication: {\n      gateway: {\n        env: {\n          GROK_CLIENT_NAME: { $source: 'client-app-name' },\n          GROK_CLIENT_VERSION: { $source: 'client-app-version' },\n          XAI_API_KEY: { $source: 'gateway-api-key' },\n          GROK_XAI_API_BASE_URL: {\n            $source: 'gateway-base-url',\n            ensureSuffix: '/v1',\n          },\n          GROK_MODELS_BASE_URL: {\n            $source: 'gateway-base-url',\n            ensureSuffix: '/v1',\n          },\n        },\n      },\n    },\n  });\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n","declare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n  typeof __PACKAGE_VERSION__ !== 'undefined'\n    ? __PACKAGE_VERSION__\n    : '0.0.0-test';\n","import { createGrokBuild } from './grok-build-harness';\n\n/**\n * Default Grok Build harness instance. Equivalent to `createGrokBuild()`.\n */\nexport const grokBuild = createGrokBuild();\n\nexport { createGrokBuild } from './grok-build-harness';\nexport type { GrokBuildHarnessSettings } from './grok-build-harness';\nexport { VERSION } from './version';\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/harness-grok-build",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -26,8 +26,8 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/harness": "1.0.77",
-    "@ai-sdk/harness-acp": "1.0.15",
+    "@ai-sdk/harness": "1.0.79",
+    "@ai-sdk/harness-acp": "1.0.17",
     "@ai-sdk/provider-utils": "5.0.28"
   },
   "peerDependencies": {

package/src/grok-build-harness.ts

@@ -2,6 +2,7 @@ import {
   commonTool,
   type HarnessV1,
   type HarnessV1BuiltinTool,
+  type HarnessV1PortEndpoint,
 } from '@ai-sdk/harness';
 import { createCredentialRequestTransformation } from '@ai-sdk/harness/utils';
 import {
@@ -35,6 +36,11 @@ export type GrokBuildHarnessSettings = {
    * Overrides the sandbox port used by the ACP bridge.
    */
   readonly port?: number;
+  /**
+   * Override the host endpoint used to connect to the sandbox bridge. Required
+   * together with `port` when using a basic sandbox session.
+   */
+  readonly portEndpoint?: HarnessV1PortEndpoint;
   /**
    * Maximum milliseconds to wait for the ACP bridge to start.
    */
@@ -286,6 +292,7 @@ export function createGrokBuild(
     auth: settings.auth,
     modelId: settings.model,
     port: settings.port,
+    portEndpoint: settings.portEndpoint,
     startupTimeoutMs: settings.startupTimeoutMs,
     mcpServers: settings.mcpServers,
     isMcpToolCall: toolCall => {