feat(agent-sdk): migrate to 0.3.258 and support message queues

CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+### Features
+
+- **Active-turn message queue** (#363, @srothgan): Upgrade to Agent SDK `0.3.258` and queue up to ten messages with correlated chat insertion.
+
 ### Fixes
 
 - **Responsive startup and file indexing** (#352, @srothgan): Keep the composer editable while connecting, defer sends until the session is ready, and run one bounded post-connection file index.

agent-sdk/package.json

@@ -20,7 +20,7 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.3.239"
+    "@anthropic-ai/claude-agent-sdk": "0.3.258"
   },
   "devDependencies": {
     "@biomejs/biome": "2.5.11",

agent-sdk/src/bridge.contract.test.ts

@@ -1,15 +1,28 @@
 import test from "node:test";
 import assert from "node:assert/strict";
 import { spawn, type ChildProcessWithoutNullStreams } from "node:child_process";
+import { readdirSync, readFileSync } from "node:fs";
 import { tmpdir } from "node:os";
-import { dirname, join } from "node:path";
+import { dirname, join, resolve } from "node:path";
 import readline from "node:readline";
 import { fileURLToPath } from "node:url";
 
 type BridgeEnvelope = Record<string, unknown>;
 
 const bridgePath = join(dirname(fileURLToPath(import.meta.url)), "bridge.js");
 
+function productionTypeScriptFiles(directory: string): string[] {
+  return readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {
+    const path = join(directory, entry.name);
+    if (entry.isDirectory()) {
+      return productionTypeScriptFiles(path);
+    }
+    return entry.isFile() && entry.name.endsWith(".ts") && !entry.name.endsWith(".test.ts")
+      ? [path]
+      : [];
+  });
+}
+
 class SpawnedBridge {
   readonly child: ChildProcessWithoutNullStreams;
   readonly stderrLines: string[] = [];
@@ -277,3 +290,15 @@ test("bridge process reports actionable session initialization failure", async (
     await bridge.stop();
   }
 });
+
+test("production bridge source stays on the public main SDK export", () => {
+  const sourceDirectory = resolve(dirname(fileURLToPath(import.meta.url)), "../src");
+  const forbiddenDeepImport = /@anthropic-ai\/claude-agent-sdk\/(?:browser|bridge)/;
+  const forbiddenFactory = /\bcreateSdkMcpServer\b/;
+
+  for (const path of productionTypeScriptFiles(sourceDirectory)) {
+    const source = readFileSync(path, "utf8");
+    assert.doesNotMatch(source, forbiddenDeepImport, path);
+    assert.doesNotMatch(source, forbiddenFactory, path);
+  }
+});