@tickernelz/paperclip-pro-adapter-claude-local 2026.925.0

package/dist/server/acp.d.ts

@@ -0,0 +1,68 @@
+import type { AdapterBillingType, AdapterEnvironmentCheck, AdapterEnvironmentTestContext, AdapterEnvironmentTestResult, AdapterExecutionContext, AdapterExecutionResult } from "@tickernelz/paperclip-pro-adapter-utils";
+import type { AdapterExecutionTarget } from "@tickernelz/paperclip-pro-adapter-utils/execution-target";
+import type { AcpxEngineExecutorOptions, AcpxTerminalSessionFailure, AcpxTerminalFailureClassification } from "@tickernelz/paperclip-pro-adapter-utils/acpx-engine/execute";
+export type ClaudeExecutionEngine = "cli" | "acp";
+export interface ClaudeEngineSelection {
+    engine: ClaudeExecutionEngine;
+    explicit: boolean;
+    unavailableReason?: string;
+}
+type ClaudeEngineResolutionInput = Pick<AdapterExecutionContext, "config"> & Partial<Pick<AdapterExecutionContext, "executionTarget" | "executionTransport">>;
+type ClaudeAcpExecutorOptions = Omit<AcpxEngineExecutorOptions, "adapterType" | "moduleDir" | "packageRootDir">;
+type ClaudeAcpExecutor = (ctx: AdapterExecutionContext) => Promise<AdapterExecutionResult>;
+export declare function resolveClaudeExecutionEngine(config: Record<string, unknown>): ClaudeEngineSelection;
+export declare function resolveClaudeExecutionEngineForRun(input: ClaudeEngineResolutionInput): Promise<ClaudeEngineSelection>;
+export declare function buildClaudeAcpConfig(config: Record<string, unknown>, inheritedEnv?: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Classify billing the same way the Claude CLI lane does so ACP runs land in
+ * the cost ledger with a real provider/billingType instead of acpx/unknown.
+ * Host env only counts for local execution targets; remote targets see just
+ * the adapter-config env.
+ */
+export declare function resolveClaudeAcpBillingIdentity(ctx: Pick<AdapterExecutionContext, "config"> & Partial<Pick<AdapterExecutionContext, "executionTarget" | "executionTransport">>): {
+    provider: string;
+    biller: string;
+    billingType: AdapterBillingType;
+};
+export declare function classifyClaudeTerminalSessionFailure(failure: AcpxTerminalSessionFailure, now: Date): AcpxTerminalFailureClassification | null;
+/**
+ * Translate the generic acpx auth-required code into the Claude-specific code at
+ * the claude-local boundary. The shared acpx engine reports the generic
+ * `acpx_auth_required` code for every adapter. The user interface run gate reads
+ * the Claude-specific `claude_auth_required` code, the same code the Claude CLI
+ * lane emits. Without this translation the default ACP run never shows the login
+ * prompt. The function changes only the error code and keeps every other field,
+ * so the error message and the error metadata stay intact.
+ */
+export declare function mapClaudeAcpAuthErrorCode(result: AdapterExecutionResult): AdapterExecutionResult;
+export declare function createClaudeAcpExecutor(options?: ClaudeAcpExecutorOptions): ClaudeAcpExecutor;
+export declare function nodeVersionMeetsClaudeAcpMinimum(version?: string): boolean;
+/**
+ * Probe the stored Claude login for the probed target on the ACP path. The ACP
+ * engine and the Claude CLI share the same stored Claude login, so the probe
+ * runs the `claude` command with a short hello turn. The probe runs against any
+ * target: a local host, an SSH remote, or a sandbox. On a local target the
+ * probe builds the child env and the executable from the shared
+ * deny-by-default builder, so a hostile caller value can neither select the
+ * executable nor reach the child. On a remote target the caller passes the
+ * prepared `env`, so the probe reads the managed `CLAUDE_CONFIG_DIR` the same
+ * way the CLI lane does.
+ *
+ * When the probe reports that login is required, the function returns the
+ * auth-required checks. Only a sandbox target also gets the canonical
+ * `adapter_auth_missing` code, so the user interface offers login for sandbox
+ * targets only.
+ *
+ * The function keeps two signals distinct. It returns the auth-required check
+ * only when the probe ran and login is required. It returns a separate warn
+ * check when the probe could not run, timed out, or did not complete. It never
+ * maps "probe could not run" to a silent pass.
+ */
+export declare function probeClaudeAcpSandboxLogin(input: {
+    config: Record<string, unknown>;
+    target: AdapterExecutionTarget | null;
+    env?: Record<string, string>;
+}): Promise<AdapterEnvironmentCheck[]>;
+export declare function testClaudeAcpEnvironment(ctx: AdapterEnvironmentTestContext): Promise<AdapterEnvironmentTestResult>;
+export {};
+//# sourceMappingURL=acp.d.ts.map

package/dist/server/acp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp.d.ts","sourceRoot":"","sources":["../../src/server/acp.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACvB,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,yCAAyC,CAAC;AAYjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0DAA0D,CAAC;AAOvG,OAAO,KAAK,EACV,yBAAyB,EAGzB,0BAA0B,EAC1B,iCAAiC,EAClC,MAAM,6DAA6D,CAAC;AA6BrE,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,KAAK,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,KAAK,2BAA2B,GAC9B,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,iBAAiB,GAAG,oBAAoB,CAAC,CAAC,CAAC;AAEnF,KAAK,wBAAwB,GAAG,IAAI,CAClC,yBAAyB,EACzB,aAAa,GAAG,WAAW,GAAG,gBAAgB,CAC/C,CAAC;AAEF,KAAK,iBAAiB,GAAG,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAS3F,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,qBAAqB,CAEnG;AAED,wBAAsB,kCAAkC,CACtD,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,qBAAqB,CAAC,CAgBhC;AAWD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BzB;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,GAC1C,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,iBAAiB,GAAG,oBAAoB,CAAC,CAAC,GACjF;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,kBAAkB,CAAA;CAAE,CAyBvE;AA8HD,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,0BAA0B,EACnC,GAAG,EAAE,IAAI,GACR,iCAAiC,GAAG,IAAI,CAe1C;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,sBAAsB,GAC7B,sBAAsB,CAGxB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,wBAA6B,GAAG,iBAAiB,CAmBjG;AAQD,wBAAgB,gCAAgC,CAAC,OAAO,SAAkB,GAAG,OAAO,CAMnF;AA+KD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAqGrC;AAED,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,6BAA6B,GACjC,OAAO,CAAC,4BAA4B,CAAC,CAwNvC"}