chore: release 0.24.0

Author: OhadAssulin

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.24.0] - 2025-11-23
+### 🛠 Claude Agent SDK & Streaming
+- Bumped `@anthropic-ai/claude-agent-sdk` support to the latest `0.1.50` with a safe range `<0.1.99`.
+- Default Claude adapter now loads local/project/user `.claude` settings via `settingSources` so SDK runs mirror the CLI (fixes credential/config loading when a workingDirectory is provided).
+- Added a live streaming test that validates partial message handling end-to-end against a `.claude` workspace.
+
 ## [0.23.0] - 2025-11-23
 ### 🧩 Codex SDK Compatibility
 - Broadened `@openai/codex-sdk` peer/dev range to `>=0.60.0 <0.80.0` in the Codex adapter so consumers can install newer 0.6x releases (e.g., 0.63+).

examples/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@headless-coder-sdk/examples-tests",
   "private": true,
-  "version": "0.23.0",
+  "version": "0.24.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.23.0",
+  "version": "0.24.0",
   "type": "module",
   "workspaces": [
     "packages/*",
@@ -15,7 +15,7 @@
     "acp:e2e": "npm run e2e --workspace packages/acp-server"
   },
   "devDependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.1.46",
+    "@anthropic-ai/claude-agent-sdk": "^0.1.50",
     "@types/node": "^20.12.7",
     "tsup": "^8.5.0",
     "tsx": "^4.19.1",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@headless-coder-sdk/acp-server",
-  "version": "0.23.0",
+  "version": "0.24.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.23.0",
+  "version": "0.24.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -19,11 +19,12 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsup --config tsup.config.ts"
+    "build": "tsup --config tsup.config.ts",
+    "test": "tsx --test test/*.test.ts"
   },
   "peerDependencies": {
-    "@anthropic-ai/claude-agent-sdk": ">=0.1.46",
-    "@headless-coder-sdk/core": "^0.23.0"
+    "@anthropic-ai/claude-agent-sdk": ">=0.1.50 <0.1.99",
+    "@headless-coder-sdk/core": "^0.24.0"
   },
   "devDependencies": {
     "typescript": "^5.4.0",

packages/claude-adapter/package.json

@@ -164,6 +164,7 @@ export class ClaudeAdapter implements HeadlessCoder {
   private buildOptions(state: ClaudeThreadState, runOpts?: RunOpts, useNativeStructuredOutput?: boolean): Options {
     const startOpts = state.opts ?? {};
     const resumeId = state.resume ? state.sessionId : undefined;
+    const settingSources = startOpts.settingSources ?? ['local', 'project', 'user'];
     const permissionMode: PermissionMode | undefined =
       (startOpts.permissionMode as PermissionMode | undefined) ?? (startOpts.yolo ? 'bypassPermissions' : undefined);
     const outputFormat =
@@ -185,6 +186,7 @@ export class ClaudeAdapter implements HeadlessCoder {
       permissionMode,
       permissionPromptToolName: startOpts.permissionPromptToolName,
       outputFormat,
+      settingSources,
     };
   }
 
@@ -650,3 +652,8 @@ function buildClaudeResultErrorMessage(result: any): string {
     'Claude run failed';
   return `Claude run failed: ${summary}`;
 }
+
+/**
+ * @internal Exported for testing stream event normalization only.
+ */
+export const __normalizeClaudeStreamMessage = normalizeClaudeStreamMessage;

packages/claude-adapter/src/index.ts

@@ -0,0 +1,76 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import { CODER_NAME, __normalizeClaudeStreamMessage as normalize } from '../src/index.js';
+
+const wrap = (event: Record<string, unknown>) => ({
+  type: 'stream_event',
+  session_id: 'sess-123',
+  event,
+});
+
+test('content_block_delta text_delta emits assistant delta message', () => {
+  const events = normalize(
+    wrap({
+      type: 'content_block_delta',
+      delta: { type: 'text_delta', text: 'Hello' },
+    }),
+    'sess-123',
+  );
+
+  assert.equal(events.length, 1);
+  const [evt] = events;
+  assert.equal(evt.type, 'message');
+  assert.equal(evt.provider, CODER_NAME);
+  assert.equal(evt.delta, true);
+  assert.equal(evt.text, 'Hello');
+});
+
+test('content_block_start tool_use emits tool_use event', () => {
+  const events = normalize(
+    wrap({
+      type: 'content_block_start',
+      content_block: { type: 'tool_use', id: 'call-1', name: 'bash', input: { cmd: 'echo hi' } },
+    }),
+    'sess-123',
+  );
+
+  assert.equal(events.length, 1);
+  const [evt] = events;
+  assert.equal(evt.type, 'tool_use');
+  assert.equal(evt.provider, CODER_NAME);
+  assert.equal(evt.callId, 'call-1');
+  assert.equal(evt.name, 'bash');
+  assert.deepEqual(evt.args, { cmd: 'echo hi' });
+});
+
+test('message_delta usage is surfaced as usage event', () => {
+  const usage = { input_tokens: 10, output_tokens: 5 };
+  const events = normalize(
+    wrap({
+      type: 'message_delta',
+      usage,
+    }),
+    'sess-123',
+  );
+
+  assert.equal(events.length, 1);
+  const [evt] = events;
+  assert.equal(evt.type, 'usage');
+  assert.equal(evt.provider, CODER_NAME);
+  assert.deepEqual(evt.stats, usage);
+});
+
+test('message_stop emits done', () => {
+  const events = normalize(
+    wrap({
+      type: 'message_stop',
+    }),
+    'sess-123',
+  );
+
+  assert.equal(events.length, 1);
+  const [evt] = events;
+  assert.equal(evt.type, 'done');
+  assert.equal(evt.provider, CODER_NAME);
+});

packages/claude-adapter/test/stream-events.test.ts

@@ -0,0 +1,55 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+
+import { createHeadlessClaude } from '../src/index.js';
+
+const CONFIG_SOURCE = process.env.CLAUDE_STREAM_CONFIG_SOURCE;
+
+if (!CONFIG_SOURCE) {
+  test.skip('claude streaming integration (requires CLAUDE_STREAM_CONFIG_SOURCE)', () => {});
+} else {
+  test(
+    'claude streams partial messages and completes',
+    { timeout: 120_000 },
+    async () => {
+      const workspace = '/tmp/headless-coder-sdk/test_claude_stream';
+      const configDest = path.join(workspace, '.claude');
+      fs.rmSync(configDest, { recursive: true, force: true });
+      fs.cpSync(CONFIG_SOURCE, configDest, { recursive: true });
+      assert(fs.existsSync(configDest), 'expected .claude directory in workspace');
+
+      const coder = createHeadlessClaude({ permissionMode: 'bypassPermissions' });
+      const thread = await coder.startThread({ workingDirectory: workspace });
+
+      const events: any[] = [];
+      for await (const evt of thread.runStreamed('Say hello briefly and mention your model.', { streamPartialMessages: true })) {
+        events.push(evt);
+        if (evt.type === 'done') break; // stop after completion
+      }
+
+      const messages = events.filter(e => e.type === 'message');
+      assert(messages.length > 0, 'expected at least one assistant message');
+
+      const combined = messages.map(m => m.text ?? '').join(' ');
+      assert(
+        !combined.toLowerCase().includes('credit balance is too low'),
+        'Claude returned credit error; top up credits to run this test',
+      );
+      assert(
+        /hello/i.test(combined),
+        `expected assistant text to include "hello", got: "${combined || '[empty]'}"`,
+      );
+
+      const hasDelta = messages.some(m => m.delta === true);
+      assert(hasDelta, 'expected at least one delta message from streaming');
+
+      const usage = events.find(e => e.type === 'usage');
+      assert(usage, 'expected a usage event');
+
+      assert(events.some(e => e.type === 'done'), 'expected a done event');
+    },
+  );
+}

packages/claude-adapter/test/stream-live.test.ts

@@ -1,6 +1,6 @@
 {
   "name": "@headless-coder-sdk/codex-adapter",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -22,7 +22,7 @@
     "build": "tsup --config tsup.config.ts"
   },
   "peerDependencies": {
-    "@headless-coder-sdk/core": "^0.23.0",
+    "@headless-coder-sdk/core": "^0.24.0",
     "@openai/codex-sdk": ">=0.60.0 <0.80.0"
   },
   "devDependencies": {