@ai-sdk/harness-codex 0.0.0 → 1.0.0-canary.1

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# @ai-sdk/harness-codex
+
+## 1.0.0-canary.1
+
+### Patch Changes
+
+- Updated dependencies [d77bed4]
+- Updated dependencies [bae5e2b]
+  - @ai-sdk/harness@1.0.0-canary.5
+  - @ai-sdk/provider-utils@5.0.0-canary.47
+
+## 1.0.0-canary.0
+
+### Major Changes
+
+- 3d9a50c: feat(harness): implement harness adapters for Claude Code, Codex, Pi
+
+### Patch Changes
+
+- Updated dependencies [3d9a50c]
+  - @ai-sdk/harness@1.0.0-canary.4

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

@@ -0,0 +1,73 @@
+# AI SDK - Codex Harness
+
+`HarnessV1` adapter backed by [`@openai/codex-sdk`](https://www.npmjs.com/package/@openai/codex-sdk), which drives the `codex` CLI. The adapter ships a bridge process that runs inside a sandbox and talks to the host over a WebSocket on a sandbox-proxied loopback port.
+
+## Setup
+
+```bash
+npm i @ai-sdk/harness-codex @ai-sdk/harness @ai-sdk/sandbox-vercel
+```
+
+The bridge installs `@openai/codex-sdk` (and the `codex` CLI it depends on) inside the sandbox the first time the session starts.
+
+## Usage
+
+```ts
+import { HarnessAgent } from '@ai-sdk/harness/agent';
+import { createCodex } from '@ai-sdk/harness-codex';
+import { createVercelSandbox } from '@ai-sdk/sandbox-vercel';
+import { tool } from 'ai';
+import { z } from 'zod/v4';
+
+const agent = new HarnessAgent({
+  harness: createCodex(),
+  id: 'demo',
+  sandbox: createVercelSandbox({
+    runtime: 'node24',
+    ports: [4000],
+  }),
+  tools: {
+    deploy: tool({
+      description: 'Deploy a service.',
+      inputSchema: z.object({ env: z.enum(['staging', 'production']) }),
+      execute: async ({ env }) => ({ url: `https://${env}.example.com` }),
+    }),
+  },
+  harnessOptions: {
+    codex: { reasoningEffort: 'high' },
+  },
+});
+```
+
+> Codex does not auto-discover a skills directory the way the `claude` CLI
+> does, so when you supply `skills: [...]` on the factory the adapter
+> injects every skill inline into the user prompt on each turn. Use fewer,
+> larger skills rather than many tiny ones.
+
+```ts
+const agent = new HarnessAgent({
+  harness: createCodex({
+    skills: [
+      { name: 'haiku-mode', description: 'Answer in haikus.', content: '...' },
+    ],
+  }),
+  sandbox: createVercelSandbox({
+    runtime: 'node24',
+    ports: [4000],
+  }),
+});
+
+const session = await agent.createSession();
+
+try {
+  const result = await agent.generate({
+    session,
+    prompt: 'List the files in this workspace and describe their purpose.',
+  });
+  console.log(result.text);
+} finally {
+  await session.destroy();
+}
+```
+
+The adapter requires a `HarnessV1SandboxProvider` whose handles expose at least one port — `@ai-sdk/sandbox-vercel` is the supported choice today. The agent calls `provider.createSession()` when a session starts. Use `session.detach()` to park the bridge and sandbox, `session.stop()` to save state and stop the sandbox, or `session.destroy()` to clean up without keeping resume state.

package/dist/bridge/host-tool-mcp.mjs

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+
+// src/bridge/host-tool-mcp.ts
+import * as mcpServerModule from "@modelcontextprotocol/sdk/server/mcp.js";
+import * as mcpStdioModule from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+var { McpServer } = mcpServerModule;
+var { StdioServerTransport } = mcpStdioModule;
+var schemas = JSON.parse(process.env.TOOL_SCHEMAS || "[]");
+var relayUrl = process.env.TOOL_RELAY_URL || "";
+var relayToken = process.env.TOOL_RELAY_TOKEN || "";
+if (!schemas.length || !relayUrl) {
+  process.stderr.write(
+    "[host-tool-mcp] Missing TOOL_SCHEMAS or TOOL_RELAY_URL; exiting\n"
+  );
+  process.exit(0);
+}
+var server = new McpServer({ name: "harness-tools", version: "1.0.0" });
+for (const schema of schemas) {
+  const shape = toZodShape(schema.inputSchema);
+  server.tool(
+    schema.name,
+    schema.description ?? "",
+    shape,
+    async (input) => {
+      const requestId = crypto.randomUUID();
+      try {
+        const res = await fetch(relayUrl, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            ...relayToken ? { Authorization: `Bearer ${relayToken}` } : {}
+          },
+          body: JSON.stringify({ requestId, toolName: schema.name, input })
+        });
+        if (!res.ok) {
+          const body = await res.text();
+          throw new Error(
+            `Tool relay ${schema.name} failed with ${res.status}: ${body.slice(0, 500)}`
+          );
+        }
+        const data = await res.json();
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(data.result ?? null)
+            }
+          ]
+        };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: `Error: ${String(err)}` }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+function toZodShape(schema) {
+  if (!schema?.properties) return {};
+  const required = new Set(schema.required ?? []);
+  const shape = {};
+  for (const [key, propSchema] of Object.entries(schema.properties)) {
+    const propType = toZodType(propSchema);
+    shape[key] = required.has(key) ? propType : propType.optional();
+  }
+  return shape;
+}
+function toZodType(schema) {
+  if (!schema) return z.any();
+  const types = Array.isArray(schema.type) ? schema.type.filter((t) => t !== "null") : [schema.type].filter(Boolean);
+  let zType;
+  switch (types[0]) {
+    case "string":
+      zType = z.string();
+      break;
+    case "number":
+      zType = z.number();
+      break;
+    case "integer":
+      zType = z.number().int();
+      break;
+    case "boolean":
+      zType = z.boolean();
+      break;
+    case "array":
+      zType = z.array(toZodType(schema.items));
+      break;
+    case "object":
+      zType = z.object(toZodShape(schema));
+      break;
+    case "null":
+      zType = z.null();
+      break;
+    default:
+      zType = z.any();
+  }
+  if (schema.description) zType = zType.describe(schema.description);
+  if (schema.nullable) zType = zType.nullable();
+  return zType;
+}
+var transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=host-tool-mcp.mjs.map

package/dist/bridge/host-tool-mcp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/bridge/host-tool-mcp.ts"],"sourcesContent":["#!/usr/bin/env node\n// MCP-stdio tool server spawned by the codex CLI when\n// `mcp_servers.harness-tools` is configured. Exposes host-defined tools\n// over MCP-stdio and round-trips each call to the bridge's HTTP relay.\n//\n// Env vars (set by the bridge when starting a turn):\n//   TOOL_SCHEMAS    — JSON array of { name, description, inputSchema }\n//   TOOL_RELAY_URL  — http://127.0.0.1:<port> of the bridge relay server\n//   TOOL_RELAY_TOKEN — bearer token required by the relay\n\n/*\n * CONSTRAINT — the third-party imports below are NEVER bundled into the\n * compiled `bridge/host-tool-mcp.mjs`. They are declared `external` in\n * tsup.config.ts and resolved at runtime from the node_modules that the\n * bridge installs *inside the sandbox* from `src/bridge/package.json` (and\n * its pinned `pnpm-lock.yaml`). That bridge package.json — NOT this host\n * package — is the single source of truth for these packages and their\n * versions; the published `@ai-sdk/harness-codex` package does not provide\n * them at runtime.\n *\n * When adding or changing a third-party import here you MUST keep all three\n * in sync, or this server will either get the dependency bundled in or fail\n * to resolve it in the sandbox:\n *   1. the import statement below,\n *   2. the `external` array in tsup.config.ts, and\n *   3. the dependency entry in `src/bridge/package.json`.\n */\nimport * as mcpServerModule from '@modelcontextprotocol/sdk/server/mcp.js';\nimport * as mcpStdioModule from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { z } from 'zod';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst { McpServer } = mcpServerModule as any;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst { StdioServerTransport } = mcpStdioModule as any;\n\ntype ToolSchema = {\n  name: string;\n  description?: string;\n  inputSchema?: JsonSchemaObject;\n};\n\ntype JsonSchemaObject = {\n  type?: string | string[];\n  description?: string;\n  properties?: Record<string, JsonSchemaObject>;\n  required?: string[];\n  items?: JsonSchemaObject;\n  enum?: unknown[];\n  const?: unknown;\n  oneOf?: JsonSchemaObject[];\n  anyOf?: JsonSchemaObject[];\n  additionalProperties?: boolean | JsonSchemaObject;\n  nullable?: boolean;\n};\n\nconst schemas: ToolSchema[] = JSON.parse(process.env.TOOL_SCHEMAS || '[]');\nconst relayUrl = process.env.TOOL_RELAY_URL || '';\nconst relayToken = process.env.TOOL_RELAY_TOKEN || '';\n\nif (!schemas.length || !relayUrl) {\n  process.stderr.write(\n    '[host-tool-mcp] Missing TOOL_SCHEMAS or TOOL_RELAY_URL; exiting\\n',\n  );\n  process.exit(0);\n}\n\nconst server = new McpServer({ name: 'harness-tools', version: '1.0.0' });\n\nfor (const schema of schemas) {\n  const shape = toZodShape(schema.inputSchema);\n  server.tool(\n    schema.name,\n    schema.description ?? '',\n    shape,\n    async (input: Record<string, unknown>) => {\n      const requestId = crypto.randomUUID();\n      try {\n        const res = await fetch(relayUrl, {\n          method: 'POST',\n          headers: {\n            'Content-Type': 'application/json',\n            ...(relayToken ? { Authorization: `Bearer ${relayToken}` } : {}),\n          },\n          body: JSON.stringify({ requestId, toolName: schema.name, input }),\n        });\n        if (!res.ok) {\n          const body = await res.text();\n          throw new Error(\n            `Tool relay ${schema.name} failed with ${res.status}: ${body.slice(0, 500)}`,\n          );\n        }\n        const data = (await res.json()) as { result?: unknown };\n        return {\n          content: [\n            {\n              type: 'text' as const,\n              text: JSON.stringify(data.result ?? null),\n            },\n          ],\n        };\n      } catch (err) {\n        return {\n          content: [{ type: 'text' as const, text: `Error: ${String(err)}` }],\n          isError: true,\n        };\n      }\n    },\n  );\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction toZodShape(schema: JsonSchemaObject | undefined): Record<string, any> {\n  if (!schema?.properties) return {};\n  const required = new Set(schema.required ?? []);\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const shape: Record<string, any> = {};\n  for (const [key, propSchema] of Object.entries(schema.properties)) {\n    const propType = toZodType(propSchema);\n    shape[key] = required.has(key) ? propType : propType.optional();\n  }\n  return shape;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction toZodType(schema: JsonSchemaObject | undefined): any {\n  if (!schema) return z.any();\n  const types = Array.isArray(schema.type)\n    ? schema.type.filter((t): t is string => t !== 'null')\n    : ([schema.type].filter(Boolean) as string[]);\n  let zType;\n  switch (types[0]) {\n    case 'string':\n      zType = z.string();\n      break;\n    case 'number':\n      zType = z.number();\n      break;\n    case 'integer':\n      zType = z.number().int();\n      break;\n    case 'boolean':\n      zType = z.boolean();\n      break;\n    case 'array':\n      zType = z.array(toZodType(schema.items));\n      break;\n    case 'object':\n      zType = z.object(toZodShape(schema));\n      break;\n    case 'null':\n      zType = z.null();\n      break;\n    default:\n      zType = z.any();\n  }\n  if (schema.description) zType = zType.describe(schema.description);\n  if (schema.nullable) zType = zType.nullable();\n  return zType;\n}\n\nconst transport = new StdioServerTransport();\nawait server.connect(transport);\n"],"mappings":"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","names":[]}