@lucascouts/claude-agent-acp-plus 0.8.1 → 0.9.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

@@ -0,0 +1,104 @@
+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 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";
+type AirSessionFailureAction = "retry" | "login" | "new_session";
+type SessionFailureRecoveryPolicy = "never" | "next_attempt" | "real_model_success" | "auth_status" | "runtime_rebind";
+export type PublishedSessionFailure = {
+    id: string;
+    revision: number;
+    kind: ClaudeFailureKind;
+    category: AirSessionFailureCategory;
+    turnId?: string;
+    severity: AirSessionFailureSeverity;
+    title: string;
+    details?: string;
+    actions: AirSessionFailureAction[];
+    recoveryPolicy: SessionFailureRecoveryPolicy;
+};
+type SessionFailureOptions = {
+    turnId?: string;
+    sessionScoped?: boolean;
+    title?: string;
+    details?: string;
+    severity?: AirSessionFailureSeverity;
+};
+export type SessionFailureState = {
+    epoch: string;
+    revisions: Map<string, number>;
+    active: Map<string, PublishedSessionFailure>;
+    nextIncident?: number;
+    lastNotice?: {
+        title: string;
+        id: string;
+    };
+};
+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;
+            };
+        };
+    };
+};
+/** `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
+ *  can recover this one typed failure without matching arbitrary model prose. */
+export declare function assistantMessageText(apiMessage: unknown): string | undefined;
+export declare function isSyntheticUsageLimitMessage(apiMessage: unknown): boolean;
+export declare function activeUsageLimitMessage(messages: Awaited<ReturnType<typeof getSessionMessages>>): {
+    uuid: string;
+    title: string;
+} | undefined;
+export declare function supportsAirSessionFailures(capabilities?: ClientCapabilities): boolean;
+/** Owns the AIR failure lifecycle for both the live consumer and history replay.
+ *  Published revisions become active only after delivery succeeds; recovery only
+ *  removes internal active state because transcript records are historical. */
+export declare class SessionFailureController {
+    private readonly sessionId;
+    private readonly state;
+    private readonly capabilities?;
+    private readonly isCurrent;
+    private readonly sendUpdate;
+    private readonly logger;
+    constructor(options: {
+        sessionId: string;
+        state: SessionFailureState;
+        capabilities?: ClientCapabilities;
+        isCurrent: () => boolean;
+        sendUpdate: (notification: SessionNotification) => Promise<void>;
+        logger: Logger;
+    });
+    private isSupported;
+    private emit;
+    recordActive(failure: PublishedSessionFailure): void;
+    clear(shouldClear?: (failure: PublishedSessionFailure) => boolean): Promise<boolean>;
+    prepare(kind: ClaudeFailureKind, failureOptions?: SessionFailureOptions): Promise<PublishedSessionFailure | undefined>;
+    publish(kind: ClaudeFailureKind, failureOptions?: SessionFailureOptions): Promise<void>;
+    restore(id: string, kind: ClaudeFailureKind, title: string, active?: boolean): Promise<boolean>;
+}
+export declare function providerFailureCategory(errorKind?: SDKAssistantMessageError, isUsageLimit?: boolean): ClaudeFailureKind;
+export {};
+//# sourceMappingURL=session-failure-extension.d.ts.map

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

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