@agentclientprotocol/claude-agent-acp 0.69.0 → 0.71.0

package/dist/permissions/options.js

@@ -0,0 +1,60 @@
+import { buildEditPermissionOptions, buildGlobPermissionOptions, buildGrepPermissionOptions, buildNotebookEditPermissionOptions, buildReadPermissionOptions, buildWritePermissionOptions, } from "./options/filesystem.js";
+import { buildBashPermissionOptions, buildPowerShellPermissionOptions } from "./options/shell.js";
+import { buildComputerUseMcpPermissionOptions, buildEnterPlanModePermissionOptions, buildExitPlanModePermissionOptions, buildFallbackPermissionOptions, buildSandboxNetworkPermissionOptions, buildSkillPermissionOptions, buildWebFetchPermissionOptions, isComputerUseMcpTool, } from "./options/tools.js";
+export { PERMISSION_OPTION_ID } from "./options/shared.js";
+export function buildClaudePermissionOptions(context) {
+    return buildUnsortedClaudePermissionOptions(context).sort((left, right) => permissionOptionOrder(left) - permissionOptionOrder(right));
+}
+function buildUnsortedClaudePermissionOptions(context) {
+    if (isComputerUseMcpTool(context.toolName)) {
+        return buildComputerUseMcpPermissionOptions(context);
+    }
+    switch (context.toolName) {
+        case "AskUserQuestion":
+            throw new Error("AskUserQuestion must be handled by ACP elicitation, not permission options");
+        case "Bash":
+            return buildBashPermissionOptions(context);
+        case "PowerShell":
+            return buildPowerShellPermissionOptions(context);
+        case "Read":
+            return buildReadPermissionOptions(context);
+        case "Glob":
+            return buildGlobPermissionOptions(context);
+        case "Grep":
+            return buildGrepPermissionOptions(context);
+        case "Edit":
+            return buildEditPermissionOptions(context);
+        case "Write":
+            return buildWritePermissionOptions(context);
+        case "NotebookEdit":
+            return buildNotebookEditPermissionOptions(context);
+        case "WebFetch":
+            return buildWebFetchPermissionOptions(context);
+        case "Skill":
+            return buildSkillPermissionOptions(context);
+        case "EnterPlanMode":
+            return buildEnterPlanModePermissionOptions();
+        case "ExitPlanMode":
+            return buildExitPlanModePermissionOptions(context);
+        case "SandboxNetworkAccess":
+            return buildSandboxNetworkPermissionOptions(context);
+        case "WebSearch":
+        case "Agent":
+        case "Task":
+        default:
+            return buildFallbackPermissionOptions(context);
+    }
+}
+function permissionOptionOrder(option) {
+    switch (option.kind) {
+        case "allow_once":
+            return 0;
+        case "allow_always":
+            return 1;
+        case "reject_once":
+        case "reject_always":
+            return 3;
+        default:
+            return 2;
+    }
+}

package/dist/permissions/presentation.d.ts

@@ -0,0 +1,15 @@
+import type { RequestPermissionRequest } from "@agentclientprotocol/sdk";
+export interface ClaudePermissionPresentationInput {
+    toolName: string;
+    input: Record<string, unknown>;
+    toolUseID: string;
+    cwd?: string;
+    supportsTerminalOutput?: boolean;
+    blockedPath?: string;
+    title?: string;
+    displayName?: string;
+    description?: string;
+    decisionReason?: string;
+}
+export declare function buildClaudePermissionPresentation(value: ClaudePermissionPresentationInput): Pick<RequestPermissionRequest, "toolCall" | "_meta">;
+//# sourceMappingURL=presentation.d.ts.map

package/dist/permissions/presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../src/permissions/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAoB,MAAM,0BAA0B,CAAC;AAG3F,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAqCD,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,iCAAiC,GACvC,IAAI,CAAC,wBAAwB,EAAE,UAAU,GAAG,OAAO,CAAC,CA0DtD"}

package/dist/permissions/presentation.js

@@ -0,0 +1,83 @@
+import { toolInfoFromToolUse } from "../tools.js";
+function humanText(value, maxLength, singleLine = false) {
+    if (typeof value !== "string")
+        return undefined;
+    const withoutControls = Array.from(value)
+        .filter((character) => {
+        const code = character.charCodeAt(0);
+        return !(code <= 0x08 ||
+            code === 0x0b ||
+            code === 0x0c ||
+            (code >= 0x0e && code <= 0x1f) ||
+            code === 0x7f);
+    })
+        .join("");
+    const normalized = singleLine
+        ? withoutControls.replace(/\s+/gu, " ").trim()
+        : withoutControls.trim();
+    return normalized && normalized.length <= maxLength ? normalized : undefined;
+}
+function compactText(value) {
+    return humanText(value, 160, true);
+}
+function withBlockedPath(locations, blockedPath) {
+    const path = humanText(blockedPath, 4_096, true);
+    if (!path)
+        return locations;
+    const result = [...(locations ?? [])];
+    if (!result.some((location) => location.path === path))
+        result.push({ path });
+    return result;
+}
+export function buildClaudePermissionPresentation(value) {
+    const info = toolInfoFromToolUse({ id: value.toolUseID, name: value.toolName, input: value.input }, value.supportsTerminalOutput ?? false, value.cwd);
+    const host = value.toolName === "SandboxNetworkAccess" ? compactText(value.input.host) : undefined;
+    const isComputerUse = value.toolName.startsWith("mcp__computer-use__");
+    const subjectTitle = host ?? (isComputerUse ? compactText(value.displayName) : undefined);
+    const subjectContent = (host || isComputerUse) && info.content.length === 0
+        ? [
+            {
+                type: "content",
+                content: {
+                    type: "text",
+                    text: `\`\`\`json\n${JSON.stringify(value.input, null, 2)}\n\`\`\``,
+                },
+            },
+        ]
+        : info.content;
+    // Reuse the exact standard tool-call heading as the permission heading so
+    // the approval never maintains a second, divergent name for the operation.
+    // decisionReason is temporarily exposed as the permission description so
+    // its actual SDK values can be inspected; it remains diagnostic policy text.
+    const shellTitle = value.toolName === "Bash" || value.toolName === "PowerShell"
+        ? (compactText(value.input.description) ?? value.toolName)
+        : undefined;
+    const toolCallTitle = shellTitle ?? subjectTitle ?? info.title;
+    const permissionTitle = value.toolName === "ExitPlanMode" ? "Ready to code?" : toolCallTitle;
+    const title = humanText(permissionTitle, 4_000, true) ?? "Use tool?";
+    const decisionReason = humanText(value.decisionReason, 4_000);
+    const description = decisionReason ? `Reason: ${decisionReason}` : undefined;
+    return {
+        toolCall: {
+            toolCallId: value.toolUseID,
+            name: value.toolName,
+            status: "pending",
+            rawInput: value.input,
+            ...info,
+            title: toolCallTitle,
+            content: subjectContent,
+            locations: withBlockedPath(info.locations, value.blockedPath),
+        },
+        ...(title
+            ? {
+                _meta: {
+                    permission: {
+                        version: 1,
+                        title,
+                        ...(description ? { description } : {}),
+                    },
+                },
+            }
+            : {}),
+    };
+}

package/dist/permissions/response.d.ts

@@ -0,0 +1,11 @@
+import type { RequestPermissionResponse } from "@agentclientprotocol/sdk";
+import type { PermissionOption } from "@agentclientprotocol/sdk";
+import type { PermissionMode, PermissionResult } from "@anthropic-ai/claude-agent-sdk";
+import type { DurablePermissionChangeSet } from "./normalization.js";
+export interface ClaudePermissionDecision {
+    permissionResult: PermissionResult;
+    contextResetMode?: PermissionMode;
+}
+/** Decode, validate, and interpret an ACP response exactly once. */
+export declare function decodeClaudePermissionResponse(response: RequestPermissionResponse, toolName: string, input: Record<string, unknown>, toolUseID: string, offeredOptions: readonly PermissionOption[], durableChangeSet?: DurablePermissionChangeSet): ClaudePermissionDecision;
+//# sourceMappingURL=response.d.ts.map

package/dist/permissions/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/permissions/response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGrE,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,CAAC,EAAE,cAAc,CAAC;CACnC;AAED,oEAAoE;AACpE,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,yBAAyB,EACnC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,SAAS,gBAAgB,EAAE,EAC3C,gBAAgB,CAAC,EAAE,0BAA0B,GAC5C,wBAAwB,CAgB1B"}

package/dist/permissions/response.js

@@ -0,0 +1,19 @@
+import { applyClaudePermissionSelection, parseClaudePermissionSelection } from "./effects.js";
+/** Decode, validate, and interpret an ACP response exactly once. */
+export function decodeClaudePermissionResponse(response, toolName, input, toolUseID, offeredOptions, durableChangeSet) {
+    const selection = parseClaudePermissionSelection(response, toolName);
+    const offeredOption = offeredOptions.find((option) => option.optionId === selection.optionId);
+    if (!offeredOption) {
+        throw new Error(`Permission option was not offered: ${selection.optionId}`);
+    }
+    const permissionResult = applyClaudePermissionSelection(selection, {
+        toolName,
+        input,
+        toolUseID,
+        durableChangeSet,
+    });
+    return {
+        permissionResult,
+        ...(selection.contextResetMode ? { contextResetMode: selection.contextResetMode } : {}),
+    };
+}

package/dist/session-config-ids.d.ts

@@ -0,0 +1,5 @@
+/** Shared sentinels and ids for session preferences managed by the adapter. */
+export declare const DEFAULT_MODEL_ID = "default";
+export declare const DEFAULT_AGENT_ID = "default";
+export declare const EFFORT_CONFIG_ID = "effort";
+//# sourceMappingURL=session-config-ids.d.ts.map

package/dist/session-config-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-config-ids.d.ts","sourceRoot":"","sources":["../src/session-config-ids.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,gBAAgB,WAAW,CAAC"}

package/dist/session-config-ids.js

@@ -0,0 +1,4 @@
+/** Shared sentinels and ids for session preferences managed by the adapter. */
+export const DEFAULT_MODEL_ID = "default";
+export const DEFAULT_AGENT_ID = "default";
+export const EFFORT_CONFIG_ID = "effort";

package/dist/session-failure-extension.d.ts

@@ -1,13 +1,6 @@
 import type { ClientCapabilities, SessionNotification } from "@agentclientprotocol/sdk";
 import { getSessionMessages, type SDKAssistantMessageError } from "@anthropic-ai/claude-agent-sdk";
-export declare function airSessionFailureCapabilityMeta(...additionalCapabilities: string[]): {
-    jetbrains: {
-        air: {
-            version: number;
-            capabilities: string[];
-        };
-    };
-};
+export declare function airSessionFailureCapabilityMeta(...additionalCapabilities: string[]): Record<string, unknown>;
 export type ClaudeFailureKind = "advisory" | "auth_required" | "bad_request" | "budget_exhausted" | "context_exhausted" | "internal_error" | "overloaded" | "provider_error" | "quota_exhausted" | "rate_limited" | "transport_lost" | "worker_shutdown";
 type AirSessionFailureCategory = "connection" | "access" | "limit" | "request" | "service" | "unknown";
 type AirSessionFailureSeverity = "warning" | "error";
@@ -46,22 +39,7 @@ type Logger = {
     error: (...args: unknown[]) => void;
 };
 export declare function createSessionFailureState(): SessionFailureState;
-export declare function sessionFailureMeta(failure: PublishedSessionFailure): {
-    jetbrains: {
-        air: {
-            version: number;
-            sessionFailure: {
-                actions: AirSessionFailureAction[];
-                details?: string | undefined;
-                id: string;
-                revision: number;
-                category: AirSessionFailureCategory;
-                severity: AirSessionFailureSeverity;
-                title: string;
-            };
-        };
-    };
-};
+export declare function sessionFailureMeta(failure: PublishedSessionFailure): Record<string, unknown>;
 /** `getSessionMessages` deliberately exposes only the API message and strips
  *  transcript-level `error` / `isApiErrorMessage` fields. The SDK exports the
  *  exact stable prefixes used by its synthetic usage-limit errors, so replay

package/dist/session-failure-extension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-failure-extension.d.ts","sourceRoot":"","sources":["../src/session-failure-extension.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-failure-extension.d.ts","sourceRoot":"","sources":["../src/session-failure-extension.ts"],"names":[],"mappings":"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"}

package/dist/session-failure-extension.js

@@ -1,20 +1,8 @@
 import { USAGE_LIMIT_ERROR_PREFIXES, } from "@anthropic-ai/claude-agent-sdk";
 import { randomUUID } from "node:crypto";
-const JETBRAINS_META_KEY = "jetbrains";
-const AIR_META_KEY = "air";
-const AIR_EXTENSION_VERSION_KEY = "version";
-const AIR_EXTENSION_CAPABILITIES_KEY = "capabilities";
-const AIR_SESSION_FAILURE_KEY = "sessionFailure";
-const AIR_EXTENSION_VERSION = 1;
+import { AIR_SESSION_FAILURE_CAPABILITY, airCapabilityMeta, clientSupportsAirCapability, withAirMeta, } from "./air-extension.js";
 export function airSessionFailureCapabilityMeta(...additionalCapabilities) {
-    return {
-        [JETBRAINS_META_KEY]: {
-            [AIR_META_KEY]: {
-                [AIR_EXTENSION_VERSION_KEY]: AIR_EXTENSION_VERSION,
-                [AIR_EXTENSION_CAPABILITIES_KEY]: [AIR_SESSION_FAILURE_KEY, ...additionalCapabilities],
-            },
-        },
-    };
+    return airCapabilityMeta(AIR_SESSION_FAILURE_CAPABILITY, ...additionalCapabilities);
 }
 export function createSessionFailureState() {
     return {
@@ -86,22 +74,15 @@ const AIR_FAILURE_POLICY = {
     },
 };
 export function sessionFailureMeta(failure) {
-    return {
-        [JETBRAINS_META_KEY]: {
-            [AIR_META_KEY]: {
-                [AIR_EXTENSION_VERSION_KEY]: AIR_EXTENSION_VERSION,
-                [AIR_SESSION_FAILURE_KEY]: {
-                    id: failure.id,
-                    revision: failure.revision,
-                    category: failure.category,
-                    severity: failure.severity,
-                    title: failure.title,
-                    ...(failure.details ? { details: failure.details } : {}),
-                    actions: failure.actions,
-                },
-            },
-        },
-    };
+    return withAirMeta(undefined, AIR_SESSION_FAILURE_CAPABILITY, {
+        id: failure.id,
+        revision: failure.revision,
+        category: failure.category,
+        severity: failure.severity,
+        title: failure.title,
+        ...(failure.details ? { details: failure.details } : {}),
+        actions: failure.actions,
+    });
 }
 /** `getSessionMessages` deliberately exposes only the API message and strips
  *  transcript-level `error` / `isApiErrorMessage` fields. The SDK exports the
@@ -161,16 +142,7 @@ export function activeUsageLimitMessage(messages) {
     return active;
 }
 export function supportsAirSessionFailures(capabilities) {
-    const jetbrains = capabilities?._meta?.[JETBRAINS_META_KEY];
-    const air = jetbrains?.[AIR_META_KEY];
-    const version = air?.[AIR_EXTENSION_VERSION_KEY];
-    const advertised = air?.[AIR_EXTENSION_CAPABILITIES_KEY];
-    return (typeof version === "number" &&
-        Number.isFinite(version) &&
-        Number.isInteger(version) &&
-        version >= AIR_EXTENSION_VERSION &&
-        Array.isArray(advertised) &&
-        advertised.some((capability) => capability === AIR_SESSION_FAILURE_KEY));
+    return clientSupportsAirCapability(capabilities, AIR_SESSION_FAILURE_CAPABILITY);
 }
 function sessionFailureRecoveryPolicy(kind, turnId) {
     switch (kind) {
@@ -331,6 +303,7 @@ export function providerFailureCategory(errorKind, isUsageLimit = false) {
         case "oauth_org_not_allowed":
             return "auth_required";
         case "billing_error":
+        case "account_on_hold":
             return "quota_exhausted";
         case "rate_limit":
             return "rate_limited";

package/dist/session-mode.d.ts

@@ -0,0 +1,66 @@
+import { type SessionConfigOption, type SessionModeState, type SessionNotification, type SetSessionModeRequest, type SetSessionModeResponse } from "@agentclientprotocol/sdk";
+import type { ModelInfo, PermissionMode, PermissionResult, Query } from "@anthropic-ai/claude-agent-sdk";
+export declare const MODE_CONFIG_ID = "mode";
+export declare const AUTO_MODE_FALLBACK: PermissionMode;
+export type SessionMode = {
+    query: Pick<Query, "setPermissionMode">;
+    queryClosed?: boolean;
+    modes: SessionModeState;
+    models: {
+        currentModelId: string;
+    };
+    modelInfos: ModelInfo[];
+    /** Prevents the model-specific Auto fallback from spamming the transcript. */
+    autoModeFallbackWarningShown?: boolean;
+    /** Initial mode fallback is reported after session/new, on the first prompt. */
+    autoModeFallbackWarningPending?: boolean;
+};
+export type SessionModeManagerOptions<S extends SessionMode> = {
+    getSession(sessionId: string): S | undefined;
+    sessionEndedMessage: string;
+    updateConfigOption(sessionId: string, configId: string, value: string): Promise<void>;
+    sessionUpdate(params: SessionNotification): Promise<void>;
+    logError(...args: unknown[]): void;
+};
+type ModeConfigSession = SessionMode & {
+    configOptions: SessionConfigOption[];
+};
+type InitializeSessionModeParams = {
+    query: Pick<Query, "setPermissionMode">;
+    requestedMode: PermissionMode;
+    currentModelInfo?: ModelInfo;
+    currentModelId: string;
+};
+/** Owns session-mode policy and the ACP/SDK synchronization it requires. */
+export declare class SessionModeManager<S extends SessionMode> {
+    private readonly options;
+    constructor(options: SessionModeManagerOptions<S>);
+    initialize({ query, requestedMode, currentModelInfo, currentModelId, }: InitializeSessionModeParams): Promise<{
+        modes: SessionModeState;
+        autoModeFallbackWarningPending: boolean;
+    }>;
+    static configOption(modes: SessionModeState): SessionConfigOption;
+    syncConfig(session: ModeConfigSession, mode: string): void;
+    availableModeIds(modes: SessionModeState): string[];
+    effectiveMode(session: SessionMode, requestedMode: PermissionMode): PermissionMode;
+    applyPermissionFallback(session: SessionMode, permissionResult: PermissionResult): {
+        permissionResult: PermissionResult;
+        fallbackApplied: boolean;
+    };
+    /** Reconcile mode after a model switch. The caller rebuilds config options
+     * before publishing the returned state change. */
+    reconcileForModel(session: SessionMode, model: ModelInfo | undefined): Promise<boolean>;
+    selectMode(sessionId: string, modeId: string): Promise<PermissionMode>;
+    setSessionMode(params: SetSessionModeRequest): Promise<SetSessionModeResponse>;
+    publishCurrent(sessionId: string, mode: string): Promise<void>;
+    publishFallbackWarning(sessionId: string, session: SessionMode): Promise<void>;
+    publishFallbackState(sessionId: string, session: SessionMode): Promise<void>;
+    private requireOpenSession;
+    private isAutoUnavailable;
+    private isAvailable;
+    private parseMode;
+    private buildAvailableModes;
+    private trySyncMode;
+}
+export {};
+//# sourceMappingURL=session-mode.d.ts.map

package/dist/session-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-mode.d.ts","sourceRoot":"","sources":["../src/session-mode.ts"],"names":[],"mappings":"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"}