chore: release 0.21.0

Author: OhadAssulin

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.21.0] - 2025-11-20
+### ⚡ Codex Adapter Direct Execution
+- `@headless-coder-sdk/codex-adapter` now targets `@openai/codex-sdk@0.59.0` and calls the SDK directly instead of spawning worker processes. Cancellation flows through the SDK’s native `AbortSignal` support, so both `RunOpts.signal` and `thread.interrupt()` stop Codex turns immediately with no worker fallback.
+- Removed the worker entry/export, simplified the tsup build, and refreshed smoke tests to reflect the single-entry bundle layout.
+
+### 📚 Documentation
+- Root and core READMEs now describe the server-only Codex requirement without mentioning worker placement, since bundlers no longer need to keep extra assets adjacent to the entry point.
+- Core README is synced with the repository README for every release.
+
 ## [0.20.0] - 2025-11-19
 ### ♻️ Gemini Resume Support
 - `@headless-coder-sdk/gemini-adapter` now captures CLI session ids/indexes and forwards `--resume` for every subsequent run, so both repeated thread runs and explicit `resumeThread()` flows continue the same workspace.

README.md

@@ -237,7 +237,7 @@ In this workflow two reviewers (Claude, Codex) analyze the same commit in parall
 
 ## ⚠️ Codex Adapter Runtime
 
-- The Codex adapter forks worker processes via Node’s `child_process` API and **must run on the server**. It is safe to import in build tooling, but gate runtime usage to environments where `process.versions.node` exists.
+- The Codex adapter talks directly to the Codex CLI through Node APIs and **must run on the server**. It is safe to import in build tooling, but gate runtime usage to environments where `process.versions.node` exists.
 - A convenience helper, `createHeadlessCodex`, registers the adapter and returns a coder in one call:
 
   ```ts
@@ -330,7 +330,7 @@ Open an [issue](https://github.com/OhadAssulin/headless-coder-sdk/issues) or sub
 - You can import `createCoder` or helper utilities directly from `@headless-coder-sdk/core` and `@headless-coder-sdk/codex-adapter` without deep `dist/*/src` paths—the `main`/`module` fields now point at those root files.
 - Helper factories (`createHeadlessCodex/Claude/Gemini`) register adapters and return coders in one call, making server-only integrations simpler.
 - `package.json` is exposed via the exports map (`import '@headless-coder-sdk/core/package.json'`) for tooling that needs to inspect versions at runtime.
-- `@headless-coder-sdk/codex-adapter` forks a worker via `fileURLToPath(new URL('./worker.js', import.meta.url))`; keep `dist/worker.js` adjacent when rebundling so that child processes can spawn correctly.
+- `@headless-coder-sdk/codex-adapter` now calls the Codex SDK directly with AbortSignal-based cancellation, so bundlers no longer need to juggle extra worker assets—ensuring the adapter stays server-only is sufficient.
 
 ---
 

examples/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@headless-coder-sdk/examples-tests",
   "private": true,
-  "version": "0.20.0",
+  "version": "0.21.0",
   "type": "module",
   "main": "src/codex-web-calculator.test.ts",
   "files": [

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "headless-coder-sdk",
   "private": true,
-  "version": "0.20.0",
+  "version": "0.21.0",
   "type": "module",
   "workspaces": [
     "packages/*",
@@ -20,5 +20,6 @@
     "tsup": "^8.5.0",
     "tsx": "^4.19.1",
     "typescript": "^5.4.0"
-  }
+  },
+  "packageManager": "pnpm@10.20.0+sha512.cf9998222162dd85864d0a8102e7892e7ba4ceadebbf5a31f9c2fce48dfce317a9c53b9f6464d1ef9042cba2e02ae02a9f7c143a2b438cd93c91840f0192b9dd"
 }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@headless-coder-sdk/acp-server",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "type": "module",
   "scripts": {
     "dev": "next dev -p 8000",

packages/acp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@headless-coder-sdk/claude-adapter",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -19,7 +19,7 @@
   },
   "peerDependencies": {
     "@anthropic-ai/claude-agent-sdk": ">=0.1.46",
-    "@headless-coder-sdk/core": "^0.20.0"
+    "@headless-coder-sdk/core": "^0.21.0"
   },
   "devDependencies": {
     "typescript": "^5.4.0",

packages/claude-adapter/package.json

@@ -27,7 +27,7 @@ console.log(turn.text);
 
 ## Next.js / server frameworks
 
-The adapter forks worker processes via Node’s `child_process`, so keep it on the server:
+The adapter interacts with the Codex CLI via Node APIs, so keep it on the server:
 
 ```ts
 export async function POST() {
@@ -42,10 +42,4 @@ export async function POST() {
 }
 ```
 
-## Worker placement
-
-- The adapter forks a worker via `fileURLToPath(new URL('./worker.js', import.meta.url))`.
-- A transpiled `dist/worker.js` **must remain adjacent** to the published entry file. If you bundle the adapter, copy the worker into the final output directory or configure your bundler to emit it as an asset.
-- When packaging custom builds (Electron, webpack, etc.), keep the relative path stable or provide your own thin wrapper that adjusts `WORKER_PATH` before registering the adapter.
-
-The published package already includes the worker alongside the JS/typings outputs; the guidance above is to prevent third-party bundlers from tree-shaking or relocating it.
+The adapter is server-only because it shells out to the Codex executable and depends on the Node.js runtime.

packages/codex-adapter/README.md

@@ -1,6 +1,6 @@
 {
   "name": "@headless-coder-sdk/codex-adapter",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -11,11 +11,6 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
-    "./worker": {
-      "types": "./dist/worker.d.ts",
-      "import": "./dist/worker.js",
-      "require": "./dist/worker.cjs"
-    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -27,12 +22,12 @@
     "build": "tsup --config tsup.config.ts"
   },
   "peerDependencies": {
-    "@headless-coder-sdk/core": "^0.20.0",
-    "@openai/codex-sdk": "^0.58.0"
+    "@headless-coder-sdk/core": "^0.21.0",
+    "@openai/codex-sdk": "^0.59.0"
   },
   "devDependencies": {
     "typescript": "^5.4.0",
     "@headless-coder-sdk/core": "workspace:*",
-    "@openai/codex-sdk": "^0.58.0"
+    "@openai/codex-sdk": "^0.59.0"
   }
 }