@ai-sdk/harness-grok-build 0.0.0 → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# @ai-sdk/harness-grok-build
+
+## 1.0.1
+
+### Patch Changes
+
+- a03ff6c: feat(harness): add support for per-harness MCP servers
+- fc3baaf: feat(harness): add optional `mintBridgeToken(sandboxId)` to harness settings to control the bridge token value
+- Updated dependencies [401a4ba]
+- Updated dependencies [a03ff6c]
+- Updated dependencies [fc3baaf]
+  - @ai-sdk/provider-utils@5.0.26
+  - @ai-sdk/harness-acp@1.0.2
+  - @ai-sdk/harness@1.0.65
+
+## 1.0.0
+
+### Major Changes
+
+- bb54c38: feat(harness-grok-build): add Grok Build harness built on top of ACP adapter
+
+### Patch Changes
+
+- Updated dependencies [6f54e1d]
+- Updated dependencies [15d0475]
+- Updated dependencies [faaabb0]
+- Updated dependencies [81cd026]
+  - @ai-sdk/harness-acp@1.0.1
+  - @ai-sdk/provider-utils@5.0.25
+  - @ai-sdk/harness@1.0.64

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2023 Vercel, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -1,5 +1,43 @@
-# @ai-sdk/harness-grok-build
+# AI SDK - Grok Build Harness
 
-AI SDK harness adapter for Grok Build.
+The **[@ai-sdk/harness-grok-build](https://www.npmjs.com/package/@ai-sdk/harness-grok-build)** package adapts [Grok Build](https://x.ai/cli) to the AI SDK harness abstraction through the Agent Client Protocol (ACP).
 
-The implementation is maintained in the `vercel/ai` repository.
+## Setup
+
+```bash
+npm install @ai-sdk/harness @ai-sdk/harness-grok-build @ai-sdk/sandbox-vercel
+```
+
+## Usage
+
+```ts
+import { HarnessAgent } from '@ai-sdk/harness/agent';
+import { grokBuild } from '@ai-sdk/harness-grok-build';
+import { createVercelSandbox } from '@ai-sdk/sandbox-vercel';
+
+const agent = new HarnessAgent({
+  harness: grokBuild,
+  sandbox: createVercelSandbox({
+    runtime: 'node24',
+    ports: [4000],
+  }),
+});
+
+const session = await agent.createSession();
+
+try {
+  const result = await agent.generate({
+    session,
+    prompt: 'Inspect this project and summarize its purpose.',
+  });
+  console.log(result.text);
+} finally {
+  await session.destroy();
+}
+```
+
+The adapter uses `@ai-sdk/harness-acp`, which installs the pinned Grok Build CLI inside the sandbox. The sandbox must provide network access and at least one exposed TCP port.
+
+Set `XAI_API_KEY` for direct authentication. Set `AI_GATEWAY_API_KEY` or `VERCEL_OIDC_TOKEN` to use AI Gateway instead.
+
+See the [Grok Build harness documentation](https://ai-sdk.dev/providers/ai-sdk-harnesses/grok-build) for settings, tools, and limitations.

package/dist/bridge/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "harness-grok-build-bridge",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "@agentclientprotocol/sdk": "1.2.1",
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "@xai-official/grok": "0.2.111",
+    "ws": "8.21.0",
+    "zod": "4.4.3"
+  }
+}