@agentclientprotocol/claude-agent-acp 0.99.2-preview.5 → 0.99.2-preview.7

package/dist/v2/initialize.js

@@ -9,6 +9,7 @@
  */
 import { PROTOCOL_VERSION as V1_PROTOCOL_VERSION, } from "@agentclientprotocol/sdk/unstable";
 import * as v2 from "@agentclientprotocol/sdk/experimental/v2/unstable";
+import { AIR_ASYNC_TASKS_CAPABILITY, AIR_GOAL_KEY } from "../air-extension.js";
 import { SYSTEM_PROMPT_CAPABILITY } from "../client-system-prompt.js";
 /** The v1 `initialize` request that a v2 client means. */
 export function v1InitializeRequest(request) {
@@ -57,14 +58,15 @@ const UNSERVED_EXTENSION_KEYS = ["steering"];
  * The v2 `initialize` response for the v1 response of the agent.
  *
  * It does not advertise what the v2 surface does not serve yet: the
- * extensions of {@link UNSERVED_EXTENSION_KEYS}.
+ * extensions of {@link UNSERVED_EXTENSION_KEYS}, and the AIR extensions of
+ * {@link withoutUnservedAirExtensions}.
  */
 export function v2InitializeResponse(response) {
     if (!response.agentInfo) {
         throw new Error("ACP v2 requires agentInfo, and the agent reported none");
     }
     const meta = response.agentCapabilities?._meta;
-    const topMeta = Object.fromEntries(Object.entries(response._meta ?? {}).filter(([key]) => !UNSERVED_EXTENSION_KEYS.includes(key)));
+    const topMeta = withoutUnservedAirExtensions(Object.fromEntries(Object.entries(response._meta ?? {}).filter(([key]) => !UNSERVED_EXTENSION_KEYS.includes(key))));
     return {
         protocolVersion: v2.PROTOCOL_VERSION,
         info: response.agentInfo,
@@ -81,6 +83,27 @@ export function v2InitializeResponse(response) {
         ...(Object.keys(topMeta).length > 0 ? { _meta: topMeta } : {}),
     };
 }
+/**
+ * `meta` without the AIR extensions whose methods the v2 surface does not
+ * register: the `asyncTasks` capability (`_session/async_task/stop`) and the
+ * `goal` entry (`_session/goal`) of `_meta.jetbrains.air`.
+ */
+function withoutUnservedAirExtensions(meta) {
+    const jetbrains = asRecord(meta.jetbrains);
+    const air = asRecord(jetbrains.air);
+    if (Object.keys(air).length === 0)
+        return meta;
+    const served = Object.fromEntries(Object.entries(air).filter(([key]) => key !== AIR_GOAL_KEY));
+    if (Array.isArray(served.capabilities)) {
+        served.capabilities = served.capabilities.filter((capability) => capability !== AIR_ASYNC_TASKS_CAPABILITY);
+    }
+    return { ...meta, jetbrains: { ...jetbrains, air: served } };
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
 /**
  * The session capabilities of the v2 surface, which serves each through a v1
  * method of the agent.
@@ -94,7 +117,7 @@ export function v2InitializeResponse(response) {
  *   v1 baseline; v2 has no SSE transport.
  * - `systemPrompt`, in `append` and `override` mode.
  */
-const V2_SESSION_CAPABILITIES = {
+export const V2_SESSION_CAPABILITIES = {
     prompt: { image: {}, embeddedContext: {} },
     mcp: { stdio: {}, http: {} },
     delete: {},

package/dist/v2/prompt.d.ts

@@ -51,7 +51,8 @@ export declare function v2Foreground(send: (update: v2.SessionUpdate) => void):
  * so such a block fails the request with invalid params (-32602) rather than
  * being dropped from the prompt. The same goes for an embedded blob that
  * Claude cannot read, e.g. an `application/zip` resource: `promptToClaude`
- * would drop it.
+ * would drop it. An empty `prompt` fails the same way: v2 requires at least
+ * one content block.
  */
 export declare function v1PromptRequest({ prompt, ...request }: v2.PromptRequest): PromptRequest;
 export declare function v1ContentBlock(block: v2.ContentBlock): ContentBlock;

package/dist/v2/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/v2/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,mDAAmD,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAuC,MAAM,mBAAmB,CAAC;AAE/F;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,EAAE,CAAC,aAAa,EACxB,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,KAAK,IAAI,GACvC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,CAiC5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,KAAK,IAAI,GAAG,gBAAgB,CAoBvF;AAgCD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,aAAa,GAAG,aAAa,CAkBvF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,GAAG,YAAY,CAcnE"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/v2/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,mDAAmD,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAuC,MAAM,mBAAmB,CAAC;AAE/F;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,EAAE,CAAC,aAAa,EACxB,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,KAAK,IAAI,GACvC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,CAiC5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,KAAK,IAAI,GAAG,gBAAgB,CAoBvF;AAgCD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,aAAa,GAAG,aAAa,CAqBvF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,GAAG,YAAY,CAcnE"}

package/dist/v2/prompt.js

@@ -129,9 +129,13 @@ function idle({ stopReason, usage, _meta }) {
  * so such a block fails the request with invalid params (-32602) rather than
  * being dropped from the prompt. The same goes for an embedded blob that
  * Claude cannot read, e.g. an `application/zip` resource: `promptToClaude`
- * would drop it.
+ * would drop it. An empty `prompt` fails the same way: v2 requires at least
+ * one content block.
  */
 export function v1PromptRequest({ prompt, ...request }) {
+    if (prompt.length === 0) {
+        throw RequestError.invalidParams({ prompt }, "`prompt` must hold at least one content block");
+    }
     return {
         ...request,
         prompt: prompt.map((block) => {

package/dist/v2/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/v2/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EAGxB,KAAK,6BAA6B,EAEnC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,mDAAmD,CAAC;AAGxE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,EAAE,CAAC,iBAAiB,GAAG,iBAAiB,CAQnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,EAAE,CAAC,oBAAoB,GAE7B;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAmBlD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,GAAG,kBAAkB,CAOtF;AAaD,oGAAoG;AACpG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,EAAE,CAAC,kBAAkB,CAExF;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,EAAE,CAAC,qBAAqB,CAKjG;AAED,uEAAuE;AACvE,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,EAAE,CAAC,6BAA6B,GACvC,6BAA6B,CAgB/B;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC,mBAAmB,EAAE,CAQxF;AAWD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAMvF"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/v2/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EAGxB,KAAK,6BAA6B,EAEnC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,mDAAmD,CAAC;AAIxE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,EAAE,CAAC,iBAAiB,GAAG,iBAAiB,CAQnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,EAAE,CAAC,oBAAoB,GAE7B;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAoBlD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,GAAG,kBAAkB,CAOtF;AAaD,oGAAoG;AACpG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,EAAE,CAAC,kBAAkB,CAExF;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,EAAE,CAAC,qBAAqB,CAKjG;AAED,uEAAuE;AACvE,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,EAAE,CAAC,6BAA6B,GACvC,6BAA6B,CAgB/B;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC,mBAAmB,EAAE,CAQxF;AAWD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAMvF"}

package/dist/v2/session.js

@@ -5,13 +5,14 @@
  */
 import { RequestError, } from "@agentclientprotocol/sdk/unstable";
 import * as v2 from "@agentclientprotocol/sdk/experimental/v2/unstable";
+import { V2_SESSION_CAPABILITIES } from "./initialize.js";
 import { v1ContentBlock } from "./prompt.js";
 export function v1NewSessionRequest(params) {
     const { mcpServers, systemPrompt, ...request } = params;
     // v1 requires the list; v2 treats an omitted list as an empty one.
     return {
         ...request,
-        mcpServers: (mcpServers ?? []).map(v1McpServer),
+        mcpServers: v1McpServers(mcpServers) ?? [],
         ...v1SystemPromptField(systemPrompt),
     };
 }
@@ -30,15 +31,16 @@ export function v1RestoreSessionRequest(params) {
     if (replayFrom == null) {
         return {
             method: "resume",
-            request: { ...request, ...(mcpServers ? { mcpServers: mcpServers.map(v1McpServer) } : {}) },
+            request: { ...request, ...(mcpServers ? { mcpServers: v1McpServers(mcpServers) } : {}) },
         };
     }
+    const servers = v1McpServers(mcpServers);
     if (replayFrom.type !== "start") {
         throw RequestError.invalidParams({ replayFrom }, `Replaying from a ${replayFrom.type} cursor is not supported`);
     }
     return {
         method: "load",
-        request: { ...request, mcpServers: (mcpServers ?? []).map(v1McpServer) },
+        request: { ...request, mcpServers: servers ?? [] },
     };
 }
 /**
@@ -49,7 +51,7 @@ export function v1ForkSessionRequest(params) {
     const { mcpServers, systemPrompt, ...request } = params;
     return {
         ...request,
-        ...(mcpServers ? { mcpServers: mcpServers.map(v1McpServer) } : {}),
+        ...(mcpServers ? { mcpServers: v1McpServers(mcpServers) } : {}),
         ...v1SystemPromptField(systemPrompt),
     };
 }
@@ -120,13 +122,23 @@ export function v2AvailableCommands(commands) {
 function v2ConfigOptionsField(options) {
     return options != null ? { configOptions: v2ConfigOptions(options) } : {};
 }
+/**
+ * The v1 list of the MCP servers of a v2 setup request, or undefined for no
+ * list. A request with two servers of the same `name`, or with a transport
+ * that the agent does not advertise in `session.mcp` (such as `acp` or a
+ * custom `_` type), fails with invalid params (-32602): the v1 session setup
+ * would otherwise drop the server without telling the client.
+ */
+function v1McpServers(servers) {
+    if (servers == null)
+        return undefined;
+    v2.assertSupportedMcpServers(servers, V2_SESSION_CAPABILITIES.mcp);
+    return servers.map(v1McpServer);
+}
 /**
  * v2 requires a `type` on every transport and makes the empty lists optional.
  * The agent recognizes a v1 stdio server by its missing `type`, so the v2 tag
- * is dropped. Any other transport, such as `acp` or a custom `_` type, fails
- * the request with invalid params (-32602): the agent advertises only stdio
- * and HTTP, and the v1 session setup would otherwise drop the server without
- * telling the client.
+ * is dropped. {@link v1McpServers} has already rejected every other transport.
  */
 function v1McpServer(server) {
     if (v2.McpServer.isStdio(server)) {
@@ -136,5 +148,5 @@ function v1McpServer(server) {
     if (v2.McpServer.isHttp(server)) {
         return { ...server, headers: server.headers ?? [] };
     }
-    throw RequestError.invalidParams({ type: server.type }, `MCP servers of type ${server.type} are not supported`);
+    throw new Error(`Unreachable: MCP server of type ${server.type} passed the transport check`);
 }

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.99.2-preview.5",
+  "version": "0.99.2-preview.7",
   "description": "An ACP-compatible coding agent powered by the Claude Agent SDK (TypeScript)",
   "main": "dist/lib.js",
   "types": "dist/lib.d.ts",