@blxzer/pactile 0.5.0

package/dist/commands/channel/adapters/claude.js

@@ -0,0 +1,203 @@
+function summarizeInput(input, max = 120) {
+    if (input === null || input === undefined)
+        return "";
+    let s;
+    try {
+        s = typeof input === "string" ? input : JSON.stringify(input);
+    }
+    catch {
+        s = String(input);
+    }
+    return s.length > max ? s.slice(0, max) + "…" : s;
+}
+function isMcpToolName(name) {
+    return /^mcp__/.test(name);
+}
+/**
+ * Parse one line of Claude stream-json stdout.
+ * Returns the channel events to emit + any side effects.
+ *
+ * Pure function: same input always produces same output. No I/O.
+ */
+export function parseClaudeLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return { events: [] };
+    let msg;
+    try {
+        msg = JSON.parse(trimmed);
+    }
+    catch {
+        return {
+            events: [
+                {
+                    kind: "error",
+                    payload: {
+                        message: "Failed to parse Claude stdout line",
+                        raw_excerpt: trimmed.slice(0, 200),
+                    },
+                },
+            ],
+        };
+    }
+    switch (msg.type) {
+        case "system":
+            return handleSystem(msg);
+        case "assistant":
+            return handleAssistant(msg);
+        case "user":
+            return { events: [] };
+        case "rate_limit_event":
+            return { events: [] };
+        case "result":
+            return handleResult(msg);
+        case "control_response":
+            // Acknowledgement of our outbound control_request (e.g. interrupt).
+            // Silently consume — supervisor doesn't need to wait on it.
+            return { events: [] };
+        default:
+            return { events: [] };
+    }
+}
+function handleSystem(msg) {
+    if (msg.subtype === "init" && msg.session_id) {
+        return {
+            events: [],
+            side: { persistSessionId: msg.session_id },
+        };
+    }
+    return { events: [] };
+}
+function handleAssistant(msg) {
+    const blocks = msg.message?.content;
+    if (!Array.isArray(blocks))
+        return { events: [] };
+    const events = [];
+    for (const b of blocks) {
+        switch (b.type) {
+            case "text": {
+                if (b.text && b.text.length > 0) {
+                    events.push({ kind: "message", payload: { text: b.text } });
+                }
+                break;
+            }
+            case "tool_use": {
+                const name = b.name ?? "";
+                const payload = {
+                    detail: {
+                        tool: name,
+                        input_summary: summarizeInput(b.input),
+                    },
+                };
+                if (isMcpToolName(name)) {
+                    const parts = name.split("__");
+                    payload.detail.kind = "mcp";
+                    if (parts.length >= 3) {
+                        payload.detail.server = parts[1];
+                        payload.detail.tool_name = parts
+                            .slice(2)
+                            .join("__");
+                    }
+                }
+                events.push({ kind: "progress", payload });
+                break;
+            }
+            case "thinking":
+                // skip in default mode
+                break;
+            default:
+                // unknown block type — skip silently
+                break;
+        }
+    }
+    return { events };
+}
+function handleResult(msg) {
+    if (msg.is_error) {
+        return {
+            events: [
+                {
+                    kind: "error",
+                    payload: {
+                        message: msg.result ?? "Claude reported is_error",
+                        duration_ms: msg.duration_ms,
+                    },
+                },
+            ],
+        };
+    }
+    // Intentionally do NOT copy `msg.result` into `done.text`. Claude already
+    // emitted the final text as an `assistant.message.content[].text` block,
+    // which we turned into a `kind:message` event above. Repeating it on
+    // `done` makes GUI consumers render the answer twice.
+    return {
+        events: [
+            {
+                kind: "done",
+                payload: {
+                    duration_ms: msg.duration_ms,
+                    total_cost_usd: msg.total_cost_usd,
+                    num_turns: msg.num_turns,
+                },
+            },
+        ],
+    };
+}
+/**
+ * Encode a channel user message into Claude stream-json stdin line(s).
+ */
+export function encodeClaudeUserMessage(text) {
+    const lines = [];
+    lines.push(JSON.stringify({
+        type: "user",
+        message: {
+            role: "user",
+            content: [{ type: "text", text }],
+        },
+    }));
+    return lines.join("\n") + "\n";
+}
+/**
+ * Send Claude's provider-level interrupt control request before the
+ * replacement prompt. Current SDK behavior is best-effort, but keeping it
+ * separate from channel message metadata makes interrupt an explicit command path.
+ */
+export function encodeClaudeInterruptMessage(text) {
+    const lines = [
+        JSON.stringify({
+            type: "control_request",
+            request_id: `pactile-int-${Date.now()}-${Math.random()
+                .toString(36)
+                .slice(2, 8)}`,
+            request: { subtype: "interrupt" },
+        }),
+        encodeClaudeUserMessage(text).trimEnd(),
+    ];
+    return lines.join("\n") + "\n";
+}
+/**
+ * Build the Claude CLI args for `claude -p` in stream-json mode.
+ */
+export function buildClaudeArgs(opts) {
+    const args = [
+        "-p",
+        "--input-format",
+        "stream-json",
+        "--output-format",
+        "stream-json",
+        "--permission-mode",
+        "bypassPermissions",
+        "--dangerously-skip-permissions",
+    ];
+    if (opts.verbose !== false)
+        args.push("--verbose");
+    if (opts.resumeSessionId)
+        args.push("--resume", opts.resumeSessionId);
+    if (opts.model)
+        args.push("--model", opts.model);
+    if (opts.systemPrompt?.trim()) {
+        args.push("--append-system-prompt", opts.systemPrompt);
+    }
+    return args;
+}
+//# sourceMappingURL=claude.js.map

package/dist/commands/channel/adapters/claude.js.map

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

package/dist/commands/channel/adapters/codex.d.ts

@@ -0,0 +1,85 @@
+import type { ParseResult } from "./types.js";
+/**
+ * Codex `app-server` adapter (JSON-RPC 2.0 over stdio).
+ *
+ * Wire shape (real data — see research/probes/codex/*.jsonl):
+ *
+ *   Three inbound message kinds:
+ *     1. Response to our outgoing request: { id, result } | { id, error }, no method
+ *     2. Server-to-client request:         { method, id, params }    — must reply
+ *     3. Notification:                     { method, params }        — fire-and-forget
+ *
+ *   Outbound: initialize → thread/start → turn/start
+ *
+ *   Translated events (per probe-findings.md):
+ *     thread/start result.thread.id      → persistThreadId + persistSessionId (same UUIDv7)
+ *     item/started   commandExecution    → progress(tool=shell, cmd, status=inProgress)
+ *     item/started   mcpToolCall         → progress(kind=mcp, server, tool, args_summary)
+ *     item/started   dynamicToolCall     → progress(kind=dynamic, namespace, tool, args)
+ *     item/started   webSearch           → progress(kind=web_search, query)
+ *     item/started   fileChange          → progress(kind=file_change)
+ *     item/completed agentMessage        → say(text, phase)
+ *     item/agentMessage/delta            → progress(kind, stream_id, text_delta)
+ *     item/completed commandExecution    → optional progress(status, exitCode)
+ *     item/started   collabAgentToolCall → error(reason=collab_blocked, recommendation=set features.multi_agent=false)
+ *     turn/completed                     → done
+ *     turn/aborted                       → error(reason=aborted)
+ *     warning                            → progress(kind=warning, message)
+ *     mcpServer/elicitation/request      → reply { action: accept, content: {} }  (auto-allow)
+ *
+ *   Notifications we skip silently:
+ *     remoteControl/status/changed
+ *     mcpServer/startupStatus/updated
+ *     mcpServer/oauthLoginCompleted
+ *     account/rateLimits/updated
+ *     thread/tokenUsage/updated
+ *     thread/status/changed
+ *     thread/started        (we record thread id from thread/start result instead)
+ *     turn/started
+ *     serverRequest/resolved
+ *     ItemGuardianApprovalReview* (until channel supports human-in-loop)
+ *
+ *  This module exposes:
+ *   - parseCodexLine(line, ctx) — pure parser; ctx tracks pending outgoing ids
+ *   - encodeCodexRequest / encodeCodexUserMessage — outbound framing helpers
+ *   - buildCodexArgs                                — CLI args
+ *   - createCodexCtx                                — state holder for pending ids
+ */
+export interface CodexCtx {
+    /** id → label tracking outgoing requests, so adapter can recognise their responses. */
+    pending: Map<number, "initialize" | "thread/start" | "turn/start" | "other">;
+    /** Codex item id → stream metadata used to classify interleaved deltas. */
+    items: Map<string, CodexItemMeta>;
+    /** Whether the current turn has emitted a final user-visible answer. */
+    finalMessageSeen: boolean;
+    /** Codex may send turn/completed before the final agentMessage item. */
+    pendingDone: boolean;
+    /** Last-known thread id (used to scope future requests). */
+    threadId?: string;
+    /** Monotonic outbound id allocator. */
+    nextId: number;
+}
+export declare function createCodexCtx(): CodexCtx;
+interface CodexItemMeta {
+    type?: string;
+    phase?: string;
+}
+export declare function parseCodexLine(line: string, ctx: CodexCtx): ParseResult;
+export declare function encodeCodexRequest(ctx: CodexCtx, method: string, params: unknown, label?: "initialize" | "thread/start" | "turn/start" | "other"): {
+    id: number;
+    line: string;
+};
+export declare function encodeCodexUserMessage(ctx: CodexCtx, text: string): {
+    id: number;
+    line: string;
+};
+export declare function encodeCodexInterruptMessage(ctx: CodexCtx, text: string): {
+    id: number;
+    line: string;
+};
+export declare function buildCodexArgs(opts: {
+    model?: string;
+}): string[];
+export declare function buildCodexThreadStartParams(cwd: string, systemPrompt?: string): Record<string, unknown>;
+export {};
+//# sourceMappingURL=codex.d.ts.map

package/dist/commands/channel/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../../src/commands/channel/adapters/codex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,MAAM,WAAW,QAAQ;IACvB,uFAAuF;IACvF,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC;IAC7E,2EAA2E;IAC3E,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAClC,wEAAwE;IACxE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wEAAwE;IACxE,WAAW,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,IAAI,QAAQ,CAQzC;AAED,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqCD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,WAAW,CAqCvE;AAwZD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,KAAK,GAAE,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,OAAiB,GACtE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAK9B;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,MAAM,GACX;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAiB9B;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,MAAM,GACX;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAM9B;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,EAAE,CAIjE;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB"}