@penclipai/adapter-utils 2026.704.0 → 2026.714.0

package/README.md

@@ -1,4 +1,4 @@
-# @paperclipai/adapter-utils
+# @penclipai/adapter-utils
 
 Shared utilities for Paperclip adapters: process spawning, environment
 injection, sandbox/SSH transport, workspace sync, and the round-trip helpers

package/dist/acpx-engine/cli.d.ts

@@ -0,0 +1,2 @@
+export declare function printAcpxStreamEvent(raw: string, debug: boolean): void;
+//# sourceMappingURL=cli.d.ts.map

package/dist/acpx-engine/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/acpx-engine/cli.ts"],"names":[],"mappings":"AAkDA,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAsEtE"}

package/dist/acpx-engine/cli.js

@@ -0,0 +1,128 @@
+import pc from "picocolors";
+function parseJson(line) {
+    try {
+        const parsed = JSON.parse(line);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function asString(value, fallback = "") {
+    return typeof value === "string" ? value : fallback;
+}
+function asNumber(value, fallback = 0) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function stringify(value) {
+    if (typeof value === "string")
+        return value;
+    if (value === null || value === undefined)
+        return "";
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+}
+function pickToolUseId(parsed) {
+    return (asString(parsed.toolCallId) ||
+        asString(parsed.toolUseId) ||
+        asString(parsed.id));
+}
+function statusLine(parsed) {
+    const text = asString(parsed.text).trim();
+    const tag = asString(parsed.tag).trim();
+    const used = asNumber(parsed.used, -1);
+    const size = asNumber(parsed.size, -1);
+    const parts = [];
+    if (text)
+        parts.push(text);
+    if (tag && !text)
+        parts.push(tag);
+    if (used >= 0 && size > 0)
+        parts.push(`(${used}/${size} ctx)`);
+    return parts.join(" ") || tag || "status";
+}
+export function printAcpxStreamEvent(raw, debug) {
+    const line = raw.trim();
+    if (!line)
+        return;
+    const parsed = parseJson(line);
+    if (!parsed) {
+        if (debug)
+            console.log(pc.gray(line));
+        else
+            console.log(line);
+        return;
+    }
+    const type = asString(parsed.type);
+    if (type === "acpx.session") {
+        const agent = asString(parsed.agent, "acpx");
+        const session = asString(parsed.acpSessionId) ||
+            asString(parsed.sessionId) ||
+            asString(parsed.runtimeSessionName);
+        const mode = asString(parsed.mode);
+        const permissionMode = asString(parsed.permissionMode);
+        const tail = [mode, permissionMode].filter(Boolean).join(" / ");
+        const suffix = tail ? ` [${tail}]` : "";
+        console.log(pc.blue(`${agent} session${session ? `: ${session}` : ""}${suffix}`));
+        return;
+    }
+    if (type === "acpx.text_delta") {
+        const text = asString(parsed.text);
+        if (!text)
+            return;
+        const channel = asString(parsed.channel) || asString(parsed.stream);
+        const isThought = channel === "thought" || channel === "thinking";
+        if (isThought)
+            console.log(pc.gray(text));
+        else
+            process.stdout.write(pc.green(text));
+        return;
+    }
+    if (type === "acpx.tool_call") {
+        const name = asString(parsed.name, "acp_tool");
+        const status = asString(parsed.status);
+        const id = pickToolUseId(parsed);
+        const header = status ? `tool_call: ${name} [${status}]` : `tool_call: ${name}`;
+        const idSuffix = id ? ` (${id})` : "";
+        const isError = status === "failed" || status === "cancelled";
+        console.log((isError ? pc.red : pc.yellow)(`${header}${idSuffix}`));
+        if (parsed.input !== undefined) {
+            console.log(pc.gray(stringify(parsed.input)));
+        }
+        else {
+            const text = asString(parsed.text).trim();
+            if (text)
+                console.log(pc.gray(text));
+        }
+        return;
+    }
+    if (type === "acpx.tool_result") {
+        const isError = parsed.isError === true || parsed.error !== undefined;
+        console.log((isError ? pc.red : pc.cyan)(`tool_result: ${asString(parsed.name, "acp_tool")}`));
+        const content = stringify(parsed.content ?? parsed.output ?? parsed.error);
+        if (content)
+            console.log((isError ? pc.red : pc.gray)(content));
+        return;
+    }
+    if (type === "acpx.status") {
+        console.log(pc.gray(`status: ${statusLine(parsed)}`));
+        return;
+    }
+    if (type === "acpx.result") {
+        const summary = asString(parsed.summary, asString(parsed.stopReason, asString(parsed.subtype, "complete")));
+        console.log(pc.blue(`result: ${summary}`));
+        return;
+    }
+    if (type === "acpx.error") {
+        console.log(pc.red(`error: ${asString(parsed.message, line)}`));
+        return;
+    }
+    console.log(debug ? pc.gray(line) : line);
+}
+//# sourceMappingURL=cli.js.map

package/dist/acpx-engine/cli.js.map

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

package/dist/acpx-engine/constants.d.ts

@@ -0,0 +1,16 @@
+export declare const DEFAULT_ACP_ENGINE_AGENT = "claude";
+export declare const DEFAULT_ACP_ENGINE_MODE = "persistent";
+export declare const DEFAULT_ACP_ENGINE_PERMISSION_MODE = "approve-all";
+export declare const DEFAULT_ACP_ENGINE_NON_INTERACTIVE_PERMISSIONS = "deny";
+export declare const DEFAULT_ACP_ENGINE_TIMEOUT_SEC = 0;
+export declare const DEFAULT_ACP_ENGINE_WARM_HANDLE_IDLE_MS = 0;
+export declare const ACPX_ADAPTER_AGENT_IDS: {
+    readonly claude_local: "claude";
+    readonly codex_local: "codex";
+    readonly gemini_local: "gemini";
+    readonly custom_acp: "custom";
+};
+export type AcpxAdapterType = keyof typeof ACPX_ADAPTER_AGENT_IDS;
+export type AcpxAgentId = (typeof ACPX_ADAPTER_AGENT_IDS)[AcpxAdapterType];
+export declare function acpxAgentIdForAdapterType(adapterType: string | null | undefined): AcpxAgentId | null;
+//# sourceMappingURL=constants.d.ts.map

package/dist/acpx-engine/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/acpx-engine/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,WAAW,CAAC;AACjD,eAAO,MAAM,uBAAuB,eAAe,CAAC;AACpD,eAAO,MAAM,kCAAkC,gBAAgB,CAAC;AAChE,eAAO,MAAM,8CAA8C,SAAS,CAAC;AACrE,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,sCAAsC,IAAI,CAAC;AAExD,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,eAAe,CAAC,CAAC;AAE3E,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,IAAI,CAGpG"}

package/dist/acpx-engine/constants.js

@@ -0,0 +1,18 @@
+export const DEFAULT_ACP_ENGINE_AGENT = "claude";
+export const DEFAULT_ACP_ENGINE_MODE = "persistent";
+export const DEFAULT_ACP_ENGINE_PERMISSION_MODE = "approve-all";
+export const DEFAULT_ACP_ENGINE_NON_INTERACTIVE_PERMISSIONS = "deny";
+export const DEFAULT_ACP_ENGINE_TIMEOUT_SEC = 0;
+export const DEFAULT_ACP_ENGINE_WARM_HANDLE_IDLE_MS = 0;
+export const ACPX_ADAPTER_AGENT_IDS = {
+    claude_local: "claude",
+    codex_local: "codex",
+    gemini_local: "gemini",
+    custom_acp: "custom",
+};
+export function acpxAgentIdForAdapterType(adapterType) {
+    if (!adapterType)
+        return null;
+    return ACPX_ADAPTER_AGENT_IDS[adapterType] ?? null;
+}
+//# sourceMappingURL=constants.js.map

package/dist/acpx-engine/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/acpx-engine/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,QAAQ,CAAC;AACjD,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CAAC;AACpD,MAAM,CAAC,MAAM,kCAAkC,GAAG,aAAa,CAAC;AAChE,MAAM,CAAC,MAAM,8CAA8C,GAAG,MAAM,CAAC;AACrE,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAChD,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,YAAY,EAAE,QAAQ;IACtB,WAAW,EAAE,OAAO;IACpB,YAAY,EAAE,QAAQ;IACtB,UAAU,EAAE,QAAQ;CACZ,CAAC;AAKX,MAAM,UAAU,yBAAyB,CAAC,WAAsC;IAC9E,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,sBAAsB,CAAC,WAA8B,CAAC,IAAI,IAAI,CAAC;AACxE,CAAC"}

package/dist/acpx-engine/execute.d.ts

@@ -0,0 +1,57 @@
+import type { AdapterBillingType, AdapterExecutionContext, AdapterExecutionResult, UsageSummary } from "@penclipai/adapter-utils";
+import { type AcpRuntime, type AcpRuntimeHandle, type AcpRuntimeOptions, type AcpRuntimeStatus, type AcpRuntimeUsageBreakdown } from "acpx/runtime";
+type AcpxRuntimeFactory = (options: AcpRuntimeOptions) => AcpRuntime;
+export interface RuntimeCacheEntry {
+    runtime: AcpRuntime;
+    handle: AcpRuntimeHandle;
+    fingerprint: string;
+    lastUsedAt: number;
+    cleanupTimer?: NodeJS.Timeout;
+}
+export interface AcpxEngineBillingIdentity {
+    provider?: string | null;
+    biller?: string | null;
+    billingType?: AdapterBillingType | null;
+}
+export interface AcpxEngineExecutorOptions {
+    createRuntime?: AcpxRuntimeFactory;
+    now?: () => number;
+    warmHandles?: Map<string, RuntimeCacheEntry>;
+    adapterType?: string;
+    moduleDir?: string;
+    packageRootDir?: string;
+    /**
+     * Adapter-specific billing classification (provider/biller/billingType) for
+     * cost-ledger attribution. Without it, results fall back to the opaque
+     * "acpx" provider and an "unknown" billing type.
+     */
+    resolveBillingIdentity?: (ctx: AdapterExecutionContext) => AcpxEngineBillingIdentity | null | Promise<AcpxEngineBillingIdentity | null>;
+}
+export declare function findAncestorBin(startDir: string, binName: string): Promise<string | null>;
+export declare function parseGeminiVersionParts(output: string | null | undefined): number[] | null;
+export declare function geminiVersionSupportsNativeAcpFlag(parts: number[] | null): boolean;
+export declare function rewriteGeminiAcpFlagForVersion(commandShell: string, versionParts: number[] | null): string;
+/**
+ * Fold the ACP runtime's post-turn usage into the adapter execution result
+ * shape. The runtime persists the latest turn's token breakdown (adapters like
+ * claude-agent-acp report per-turn accumulated usage in the prompt response),
+ * so tokens are per-run. Cost is reported by agents as a cumulative session
+ * amount, so the per-run cost is the delta against the pre-turn snapshot; a
+ * decrease means the agent process restarted and its counter reset, in which
+ * case the post-turn amount alone covers this run.
+ */
+export declare function summarizeAcpxTurnUsage(input: {
+    preStatus: AcpRuntimeStatus | null;
+    postStatus: AcpRuntimeStatus | null;
+    eventBreakdown: AcpRuntimeUsageBreakdown | null;
+    eventCostUsd: number | null;
+}): {
+    usage: UsageSummary | null;
+    usageDetail: Record<string, number> | null;
+    costUsd: number | null;
+    cumulativeCostUsd: number | null;
+};
+export declare function createAcpxEngineExecutor(deps?: AcpxEngineExecutorOptions): (ctx: AdapterExecutionContext) => Promise<AdapterExecutionResult>;
+export declare const execute: (ctx: AdapterExecutionContext) => Promise<AdapterExecutionResult>;
+export {};
+//# sourceMappingURL=execute.d.ts.map

package/dist/acpx-engine/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/acpx-engine/execute.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,YAAY,EACb,MAAM,0BAA0B,CAAC;AAwClC,OAAO,EAML,KAAK,UAAU,EAEf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAGrB,KAAK,wBAAwB,EAE9B,MAAM,cAAc,CAAC;AActB,KAAK,kBAAkB,GAAG,CAAC,OAAO,EAAE,iBAAiB,KAAK,UAAU,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;CAC/B;AAQD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,CACvB,GAAG,EAAE,uBAAuB,KACzB,yBAAyB,GAAG,IAAI,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;CACnF;AA6ED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS/F;AA+BD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,IAAI,CAI1F;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAOlF;AAED,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,MAAM,CAO1G;AAkwCD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpC,cAAc,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAChD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GAAG;IACF,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC3C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAyDA;AA4OD,wBAAgB,wBAAwB,CAAC,IAAI,GAAE,yBAA8B,IAMnC,KAAK,uBAAuB,KAAG,OAAO,CAAC,sBAAsB,CAAC,CA0YvG;AAGD,eAAO,MAAM,OAAO,QA7Y2B,uBAAuB,KAAG,OAAO,CAAC,sBAAsB,CA6YtD,CAAC"}