@ai-sdk/harness-codex 0.0.0-07500555-20260730161446

package/CHANGELOG.md

@@ -0,0 +1,498 @@
+# @ai-sdk/harness-codex
+
+## 0.0.0-07500555-20260730161446
+
+### Patch Changes
+
+- Updated dependencies [5f65e61]
+  - @ai-sdk/harness@0.0.0-07500555-20260730161446
+  - @ai-sdk/provider-utils@0.0.0-07500555-20260730161446
+
+## 1.0.41
+
+### Patch Changes
+
+- b2f553b: fix(harness-codex): route Codex host tools through the CLI relay only instead of registering them as MCP tools
+- Updated dependencies [86a84c9]
+  - @ai-sdk/harness@1.0.39
+
+## 1.0.40
+
+### Patch Changes
+
+- f5cdb2d: chore(harness): update primary SDK dependencies
+- Updated dependencies [02ffdcb]
+- Updated dependencies [76cb673]
+  - @ai-sdk/provider-utils@5.0.12
+  - @ai-sdk/harness@1.0.38
+
+## 1.0.39
+
+### Patch Changes
+
+- Updated dependencies [b460541]
+- Updated dependencies [079591e]
+  - @ai-sdk/harness@1.0.37
+
+## 1.0.38
+
+### Patch Changes
+
+- Updated dependencies [cd06458]
+  - @ai-sdk/provider-utils@5.0.11
+  - @ai-sdk/harness@1.0.36
+
+## 1.0.37
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.35
+
+## 1.0.36
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.34
+
+## 1.0.35
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.33
+
+## 1.0.34
+
+### Patch Changes
+
+- Updated dependencies [31c7be8]
+  - @ai-sdk/provider-utils@5.0.10
+  - @ai-sdk/harness@1.0.32
+
+## 1.0.33
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.31
+
+## 1.0.32
+
+### Patch Changes
+
+- Updated dependencies [4be62c1]
+- Updated dependencies [7805e4a]
+- Updated dependencies [cd12954]
+  - @ai-sdk/provider-utils@5.0.9
+  - @ai-sdk/harness@1.0.30
+
+## 1.0.31
+
+### Patch Changes
+
+- Updated dependencies [e193290]
+  - @ai-sdk/provider-utils@5.0.8
+  - @ai-sdk/harness@1.0.29
+
+## 1.0.30
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.28
+
+## 1.0.29
+
+### Patch Changes
+
+- c93803d: fix(harness): improve CLI relay tool invocation logic
+
+## 1.0.28
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.27
+
+## 1.0.27
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.26
+
+## 1.0.26
+
+### Patch Changes
+
+- Updated dependencies [44e988a]
+  - @ai-sdk/harness@1.0.25
+
+## 1.0.25
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.24
+
+## 1.0.24
+
+### Patch Changes
+
+- 39c8276: fix(harness): improve opaque sandbox bridge error handling
+- 91fe6d8: fix(harness): emit `finish-step` stream parts correctly per the underlying model steps
+- Updated dependencies [39c8276]
+- Updated dependencies [91fe6d8]
+- Updated dependencies [0be5014]
+  - @ai-sdk/harness@1.0.23
+
+## 1.0.23
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.22
+- @ai-sdk/provider-utils@5.0.7
+
+## 1.0.22
+
+### Patch Changes
+
+- Updated dependencies [ac306ed]
+  - @ai-sdk/provider-utils@5.0.6
+  - @ai-sdk/harness@1.0.21
+
+## 1.0.21
+
+### Patch Changes
+
+- b2d0306: feat(harness): send `User-Agent` and `x-client-app` headers in harness adapters
+- Updated dependencies [b7aa06a]
+  - @ai-sdk/harness@1.0.20
+
+## 1.0.20
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.19
+
+## 1.0.19
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.18
+
+## 1.0.18
+
+### Patch Changes
+
+- Updated dependencies [5c5c0f5]
+  - @ai-sdk/provider-utils@5.0.5
+  - @ai-sdk/harness@1.0.17
+
+## 1.0.17
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.16
+
+## 1.0.16
+
+### Patch Changes
+
+- Updated dependencies [c6f5e62]
+  - @ai-sdk/provider-utils@5.0.4
+  - @ai-sdk/harness@1.0.15
+
+## 1.0.15
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.14
+
+## 1.0.14
+
+### Patch Changes
+
+- Updated dependencies [8c616f0]
+  - @ai-sdk/provider-utils@5.0.3
+  - @ai-sdk/harness@1.0.13
+
+## 1.0.13
+
+### Patch Changes
+
+- 7859cea: feat(harness): add tool filtering via `activeTools` and `inactiveTools`
+- c857346: feat(harness): add utility functions for certain duplicated layers in harnesses
+- Updated dependencies [7859cea]
+- Updated dependencies [c857346]
+  - @ai-sdk/harness@1.0.12
+
+## 1.0.12
+
+### Patch Changes
+
+- 2933383: fix(harness): fix harness relay auth
+  - @ai-sdk/harness@1.0.11
+
+## 1.0.11
+
+### Patch Changes
+
+- 0d1cb8e: fix(harness-codex): improve Codex prompt framing and avoid placing relay shim file in session workdir
+
+## 1.0.10
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.10
+- @ai-sdk/provider-utils@5.0.2
+
+## 1.0.9
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.9
+
+## 1.0.8
+
+### Patch Changes
+
+- c0e991c: fix(harness-codex): fix Codex sometimes stopping after a single text response when using `workflow-harness`
+  - @ai-sdk/harness@1.0.8
+
+## 1.0.7
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.7
+
+## 1.0.6
+
+### Patch Changes
+
+- Updated dependencies [6a436e3]
+  - @ai-sdk/provider-utils@5.0.1
+  - @ai-sdk/harness@1.0.6
+
+## 1.0.5
+
+### Patch Changes
+
+- 43a8c68: fix(harness): use `shellQuote` where appropriate in harness adapters
+  - @ai-sdk/harness@1.0.5
+
+## 1.0.4
+
+### Patch Changes
+
+- c493634: fix(harness): fix harness Zod usage to be v3/v4 compatible
+- Updated dependencies [c493634]
+  - @ai-sdk/harness@1.0.4
+
+## 1.0.3
+
+### Patch Changes
+
+- Updated dependencies [51d10a0]
+  - @ai-sdk/harness@1.0.3
+
+## 1.0.2
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.2
+
+## 1.0.1
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.1
+
+## 1.0.0
+
+### Major Changes
+
+- 3d9a50c: feat(harness): implement harness adapters for Claude Code, Codex, Pi
+
+### Patch Changes
+
+- e5d4a24: chore(harness): update ws package
+- bc77265: chore(harness): enforce more structural conventions in harness adapters
+- aae0138: fix(harness): make listening for sandbox bridge readiness compatible with Bun
+- 1ea15a3: fix(harness): fix various bugs with harness skills not being correctly processed by the harness adapters
+- b8396f0: trigger initial beta release
+- e551763: fix(harness): avoid using peer dependencies for underlying harness and sandbox SDKs
+- 534dac6: fix(harness): fix incomplete OIDC token support for AI Gateway auth in harness adapters
+
+## 1.0.0-beta.24
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-beta.27
+
+## 1.0.0-beta.23
+
+### Patch Changes
+
+- Updated dependencies [a83a367]
+  - @ai-sdk/harness@1.0.0-beta.26
+
+## 1.0.0-beta.22
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-beta.25
+
+## 1.0.0-beta.21
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-beta.24
+
+## 1.0.0-beta.20
+
+### Patch Changes
+
+- Updated dependencies [57e0a59]
+  - @ai-sdk/harness@1.0.0-beta.23
+
+## 1.0.0-beta.19
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-beta.22
+- @ai-sdk/provider-utils@5.0.0-beta.50
+
+## 1.0.0-beta.18
+
+### Patch Changes
+
+- bc77265: chore(harness): enforce more structural conventions in harness adapters
+
+## 1.0.0-beta.17
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-beta.21
+
+## 1.0.0-beta.16
+
+### Patch Changes
+
+- e5d4a24: chore(harness): update ws package
+- Updated dependencies [e5d4a24]
+  - @ai-sdk/harness@1.0.0-beta.20
+
+## 1.0.0-beta.15
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-beta.19
+
+## 1.0.0-beta.14
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-beta.18
+
+## 1.0.0-beta.13
+
+### Patch Changes
+
+- 534dac6: fix(harness): fix incomplete OIDC token support for AI Gateway auth in harness adapters
+- Updated dependencies [534dac6]
+  - @ai-sdk/harness@1.0.0-beta.17
+
+## 1.0.0-beta.12
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-beta.16
+
+## 1.0.0-beta.11
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-beta.15
+
+## 1.0.0-beta.10
+
+### Patch Changes
+
+- b8396f0: trigger initial beta release
+- Updated dependencies [b8396f0]
+  - @ai-sdk/harness@1.0.0-beta.14
+  - @ai-sdk/provider-utils@5.0.0-beta.49
+
+## 1.0.0-canary.9
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-canary.13
+
+## 1.0.0-canary.8
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-canary.12
+
+## 1.0.0-canary.7
+
+### Patch Changes
+
+- Updated dependencies [be83911]
+  - @ai-sdk/harness@1.0.0-canary.11
+
+## 1.0.0-canary.6
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-canary.10
+
+## 1.0.0-canary.5
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-canary.9
+
+## 1.0.0-canary.4
+
+### Patch Changes
+
+- aae0138: fix(harness): make listening for sandbox bridge readiness compatible with Bun
+- Updated dependencies [aae0138]
+  - @ai-sdk/harness@1.0.0-canary.8
+
+## 1.0.0-canary.3
+
+### Patch Changes
+
+- 1ea15a3: fix(harness): fix various bugs with harness skills not being correctly processed by the harness adapters
+- e551763: fix(harness): avoid using peer dependencies for underlying harness and sandbox SDKs
+- Updated dependencies [3d87086]
+- Updated dependencies [aeda373]
+- Updated dependencies [1ea15a3]
+- Updated dependencies [375fdd7]
+- Updated dependencies [b4507d5]
+  - @ai-sdk/harness@1.0.0-canary.7
+  - @ai-sdk/provider-utils@5.0.0-canary.48
+
+## 1.0.0-canary.2
+
+### Patch Changes
+
+- @ai-sdk/harness@1.0.0-canary.6
+
+## 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.