feat(harness-grok-build): implement harness adapter for Grok build

.changeset/grok-build-turn-driver.md

@@ -0,0 +1,5 @@
+---
+'@ai-sdk/harness-grok-build': major
+---
+
+feat(harness-grok-build): implement bridge turn driver and doStart

examples/ai-functions/package.json

@@ -30,6 +30,7 @@
     "@ai-sdk/harness": "workspace:*",
     "@ai-sdk/harness-claude-code": "workspace:*",
     "@ai-sdk/harness-codex": "workspace:*",
+    "@ai-sdk/harness-grok-build": "workspace:*",
     "@ai-sdk/harness-pi": "workspace:*",
     "@ai-sdk/huggingface": "workspace:*",
     "@ai-sdk/hume": "workspace:*",

examples/ai-functions/src/harness-agent/grok-build/generate-text.ts

@@ -0,0 +1,38 @@
+import { HarnessAgent } from '@ai-sdk/harness/agent';
+import { grokBuild } from '@ai-sdk/harness-grok-build';
+import { createVercelSandbox } from '@ai-sdk/sandbox-vercel';
+import { run } from '../../lib/run';
+
+// End-to-end smoke test against the Vercel Sandbox (required: grok-build is
+// bridge-backed and needs a port, which the local just-bash sandbox cannot
+// expose). Requires Vercel Sandbox credentials (OIDC token / `vercel` auth)
+// and XAI_API_KEY (or AI Gateway env) in examples/ai-functions/.env.
+run(async () => {
+  const sandbox = createVercelSandbox({
+    runtime: 'node24',
+    ports: [4000],
+    timeout: 10 * 60 * 1000,
+  });
+  const agent = new HarnessAgent({
+    harness: grokBuild,
+    sandbox,
+  });
+
+  let exitCode = 0;
+  const session = await agent.createSession();
+  try {
+    const result = await agent.generate({
+      session,
+      prompt: 'In one sentence, what is the capital of France?',
+    });
+    console.log('text:', result.text);
+    console.log('finishReason:', result.finishReason);
+    console.log('usage:', result.usage);
+  } catch (err) {
+    exitCode = 1;
+    console.error('[example] failed:', err);
+  } finally {
+    await session.destroy();
+    process.exit(exitCode);
+  }
+});

examples/harness-e2e-next/agent/harness/grok-build/ai-sdk-coding-agent.ts

@@ -0,0 +1,52 @@
+import { HarnessAgent } from '@ai-sdk/harness/agent';
+import { grokBuild } from '@ai-sdk/harness-grok-build';
+import { createVercelSandbox } from '@ai-sdk/sandbox-vercel';
+import type { InferUITools, UIMessage } from 'ai';
+
+// Default sandbox resources won't allow for a full parallel build of all packages.
+// Not worth bumping all demo sandboxes' resources for just this, we can easily
+// work around this by guiding the harness.
+const instructions = `
+Building all packages at once (e.g. running \`pnpm build\` or \`pnpm build:packages\`)
+will exceed sandbox memory. When asked to do this, use the corresponding
+\`pnpm exec turbo\` call directly with a lower \`--concurrency=4\` flag.
+`;
+
+export const aiSdkCodingGrokBuildHarnessAgent = new HarnessAgent({
+  harness: grokBuild,
+  instructions,
+  sandbox: createVercelSandbox({
+    runtime: 'node24',
+    ports: [4000],
+  }),
+  onSandboxSession: async ({ session, sessionWorkDir, abortSignal }) => {
+    const result = await session.run({
+      command:
+        'test -d .git || git clone --depth 1 https://github.com/vercel/ai.git .',
+      workingDirectory: sessionWorkDir,
+      abortSignal,
+    });
+    if (result.exitCode !== 0) {
+      throw new Error(
+        `Failed to clone vercel/ai (exit ${result.exitCode}): ${result.stderr}`,
+      );
+    }
+
+    const installResult = await session.run({
+      command: 'test -d node_modules || pnpm install',
+      workingDirectory: sessionWorkDir,
+      abortSignal,
+    });
+    if (installResult.exitCode !== 0) {
+      throw new Error(
+        `Failed to install dependencies (exit ${installResult.exitCode}): ${installResult.stderr}`,
+      );
+    }
+  },
+});
+
+export type AiSdkCodingGrokBuildHarnessAgentMessage = UIMessage<
+  unknown,
+  never,
+  InferUITools<typeof aiSdkCodingGrokBuildHarnessAgent.tools>
+>;

examples/harness-e2e-next/agent/harness/grok-build/basic-agent.ts

@@ -0,0 +1,29 @@
+import {
+  HarnessAgent,
+  createFileReporter,
+  createTraceTreeReporter,
+} from '@ai-sdk/harness/agent';
+import { grokBuild } from '@ai-sdk/harness-grok-build';
+import { createVercelSandbox } from '@ai-sdk/sandbox-vercel';
+import type { InferUITools, UIMessage } from 'ai';
+
+export const grokBuildHarnessAgent = new HarnessAgent({
+  harness: grokBuild,
+  sandbox: createVercelSandbox({
+    runtime: 'node24',
+    ports: [4000],
+  }),
+  debug: { enabled: true },
+  telemetry: {
+    integrations: [
+      createTraceTreeReporter(),
+      createFileReporter({ dir: '.harness-observability/grok-build/basic' }),
+    ],
+  },
+});
+
+export type GrokBuildHarnessAgentMessage = UIMessage<
+  unknown,
+  never,
+  InferUITools<typeof grokBuildHarnessAgent.tools>
+>;

examples/harness-e2e-next/app/api/harness/grok-build/ai-sdk-coding/route.ts

@@ -0,0 +1,41 @@
+import { aiSdkCodingGrokBuildHarnessAgent } from '@/agent/harness/grok-build/ai-sdk-coding-agent';
+import {
+  detachAndPersist,
+  resumeOrCreateSession,
+} from '@/util/harness-resume-store';
+import {
+  convertToModelMessages,
+  createUIMessageStreamResponse,
+  toUIMessageStream,
+  type UIMessage,
+} from 'ai';
+
+export async function POST(request: Request) {
+  const body: {
+    id?: string;
+    messages: UIMessage[];
+  } = await request.json();
+
+  if (!body.id) {
+    return new Response('Missing chat id', { status: 400 });
+  }
+  const chatId = body.id;
+  const messages = await convertToModelMessages(body.messages);
+
+  const session = await resumeOrCreateSession(
+    aiSdkCodingGrokBuildHarnessAgent,
+    chatId,
+  );
+
+  const result = await aiSdkCodingGrokBuildHarnessAgent.stream({
+    session,
+    messages,
+  });
+
+  return createUIMessageStreamResponse({
+    stream: toUIMessageStream({
+      stream: result.stream,
+      onFinish: () => detachAndPersist(chatId, session),
+    }),
+  });
+}

examples/harness-e2e-next/app/api/harness/grok-build/basic-with-stop/route.ts

@@ -0,0 +1,37 @@
+import { grokBuildHarnessAgent } from '@/agent/harness/grok-build/basic-agent';
+import {
+  resumeOrCreateSession,
+  stopAndPersist,
+} from '@/util/harness-resume-store';
+import {
+  convertToModelMessages,
+  createUIMessageStreamResponse,
+  toUIMessageStream,
+  type UIMessage,
+} from 'ai';
+
+export async function POST(request: Request) {
+  const body: {
+    id?: string;
+    messages: UIMessage[];
+  } = await request.json();
+
+  if (!body.id) {
+    return new Response('Missing chat id', { status: 400 });
+  }
+  const chatId = body.id;
+  const messages = await convertToModelMessages(body.messages);
+
+  const session = await resumeOrCreateSession(grokBuildHarnessAgent, chatId);
+
+  const result = await grokBuildHarnessAgent.stream({ session, messages });
+
+  return createUIMessageStreamResponse({
+    stream: toUIMessageStream({
+      stream: result.stream,
+      // Stop the session at the end of the turn so the next request resumes
+      // from the persisted snapshot rather than attaching to a parked bridge.
+      onFinish: () => stopAndPersist(chatId, session),
+    }),
+  });
+}

examples/harness-e2e-next/app/api/harness/grok-build/basic/route.ts

@@ -0,0 +1,35 @@
+import { grokBuildHarnessAgent } from '@/agent/harness/grok-build/basic-agent';
+import {
+  detachAndPersist,
+  resumeOrCreateSession,
+} from '@/util/harness-resume-store';
+import {
+  convertToModelMessages,
+  createUIMessageStreamResponse,
+  toUIMessageStream,
+  type UIMessage,
+} from 'ai';
+
+export async function POST(request: Request) {
+  const body: {
+    id?: string;
+    messages: UIMessage[];
+  } = await request.json();
+
+  if (!body.id) {
+    return new Response('Missing chat id', { status: 400 });
+  }
+  const chatId = body.id;
+  const messages = await convertToModelMessages(body.messages);
+
+  const session = await resumeOrCreateSession(grokBuildHarnessAgent, chatId);
+
+  const result = await grokBuildHarnessAgent.stream({ session, messages });
+
+  return createUIMessageStreamResponse({
+    stream: toUIMessageStream({
+      stream: result.stream,
+      onFinish: () => detachAndPersist(chatId, session),
+    }),
+  });
+}

examples/harness-e2e-next/app/harness/grok-build/ai-sdk-coding/page.tsx

@@ -0,0 +1,19 @@
+import ChatIdProvider from '@/components/chat-id-provider';
+import GrokBuildHarnessChat from '@/components/grok-build-harness-chat';
+
+export const metadata = {
+  title: 'Grok Build — AI SDK Checkout',
+};
+
+const STORAGE_KEY = 'harness-grok-build-ai-sdk-coding-chat-id';
+
+export default function HarnessGrokBuildAiSdkCodingPage() {
+  return (
+    <ChatIdProvider storageKey={STORAGE_KEY}>
+      <GrokBuildHarnessChat
+        apiRoute="/api/harness/grok-build/ai-sdk-coding"
+        exampleLabel="AI SDK Checkout"
+      />
+    </ChatIdProvider>
+  );
+}

examples/harness-e2e-next/app/harness/grok-build/basic-with-stop/page.tsx

@@ -0,0 +1,19 @@
+import ChatIdProvider from '@/components/chat-id-provider';
+import GrokBuildHarnessChat from '@/components/grok-build-harness-chat';
+
+export const metadata = {
+  title: 'Grok Build — Basic (with stop)',
+};
+
+const STORAGE_KEY = 'harness-grok-build-basic-with-stop-chat-id';
+
+export default function HarnessGrokBuildBasicWithStopPage() {
+  return (
+    <ChatIdProvider storageKey={STORAGE_KEY}>
+      <GrokBuildHarnessChat
+        apiRoute="/api/harness/grok-build/basic-with-stop"
+        exampleLabel="Basic (with stop)"
+      />
+    </ChatIdProvider>
+  );
+}

examples/harness-e2e-next/app/harness/grok-build/basic/page.tsx

@@ -0,0 +1,19 @@
+import ChatIdProvider from '@/components/chat-id-provider';
+import GrokBuildHarnessChat from '@/components/grok-build-harness-chat';
+
+export const metadata = {
+  title: 'Grok Build — Basic',
+};
+
+const STORAGE_KEY = 'harness-grok-build-basic-chat-id';
+
+export default function HarnessGrokBuildPage() {
+  return (
+    <ChatIdProvider storageKey={STORAGE_KEY}>
+      <GrokBuildHarnessChat
+        apiRoute="/api/harness/grok-build/basic"
+        exampleLabel="Basic"
+      />
+    </ChatIdProvider>
+  );
+}

examples/harness-e2e-next/app/page.tsx

@@ -42,6 +42,11 @@ const HARNESSES = [
       'weather-approval',
     ],
   },
+  {
+    slug: 'grok-build',
+    label: 'Grok Build',
+    variants: ['basic', 'basic-with-stop', 'ai-sdk-coding'],
+  },
 ] as const;
 
 const VARIANT_LABELS: Record<string, string> = Object.fromEntries(