letta-code-acp 0.0.2

package/dist/letta-process.js

@@ -0,0 +1,151 @@
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import { EventEmitter } from "node:events";
+import { parseWire } from "./wire.js";
+/**
+ * Owns a single `letta -p --input-format stream-json --output-format stream-json`
+ * subprocess. Emits parsed wire messages and accepts JSON inputs on stdin.
+ *
+ * Lifecycle: construct -> start() -> waits for system/init -> ready.
+ * One LettaProcess per ACP session.
+ */
+export class LettaProcess extends EventEmitter {
+    opts;
+    child = null;
+    initMsg = null;
+    exited = false;
+    stderrBuf = "";
+    /** Cap stderr ring-buffer so long-running verbose agents don't leak memory. */
+    static STDERR_TAIL_LIMIT = 8 * 1024;
+    constructor(opts) {
+        super();
+        this.opts = opts;
+    }
+    async start() {
+        const bin = this.opts.lettaBin ?? process.env.LETTA_BIN ?? "letta";
+        const args = [
+            "-p",
+            "--input-format",
+            "stream-json",
+            "--output-format",
+            "stream-json",
+            "--include-partial-messages",
+        ];
+        // `--conversation <id>` with an explicit id derives the agent from the
+        // conversation - headless rejects `--agent` alongside it. For the special
+        // "default" virtual id, both flags are allowed (agent is the addressing
+        // key; "default" selects its primary chat).
+        const conv = this.opts.conversationId;
+        const conversationIsExplicit = !!conv && conv !== "default";
+        if (this.opts.agentId && !conversationIsExplicit)
+            args.push("-a", this.opts.agentId);
+        if (this.opts.model)
+            args.push("-m", this.opts.model);
+        if (this.opts.permissionMode)
+            args.push("--permission-mode", this.opts.permissionMode);
+        if (conv)
+            args.push("--conversation", conv);
+        // `--new` is mutually exclusive with `--conversation` in headless.
+        if (this.opts.newConversation && !conv)
+            args.push("--new");
+        if (this.opts.reflectionTrigger) {
+            args.push("--reflection-trigger", this.opts.reflectionTrigger);
+        }
+        if (typeof this.opts.reflectionStepCount === "number") {
+            args.push("--reflection-step-count", String(this.opts.reflectionStepCount));
+        }
+        if (this.opts.extraArgs)
+            args.push(...this.opts.extraArgs);
+        const child = spawn(bin, args, {
+            cwd: this.opts.cwd,
+            env: { ...process.env, ...this.opts.env },
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.child = child;
+        const rl = createInterface({ input: child.stdout });
+        rl.on("line", (line) => {
+            const msg = parseWire(line);
+            if (!msg)
+                return;
+            if (!this.initMsg && msg.type === "system" && msg.subtype === "init") {
+                this.initMsg = msg;
+                this.emit("init", this.initMsg);
+            }
+            this.emit("wire", msg);
+        });
+        child.stderr.on("data", (chunk) => {
+            const text = chunk.toString("utf8");
+            this.stderrBuf += text;
+            if (this.stderrBuf.length > LettaProcess.STDERR_TAIL_LIMIT) {
+                this.stderrBuf = this.stderrBuf.slice(-LettaProcess.STDERR_TAIL_LIMIT);
+            }
+            this.emit("stderr", text);
+        });
+        child.on("exit", (code, signal) => {
+            this.exited = true;
+            this.emit("exit", { code, signal, stderr: this.stderrBuf });
+        });
+        return new Promise((resolve, reject) => {
+            const onInit = (m) => {
+                cleanup();
+                resolve(m);
+            };
+            const onExit = (info) => {
+                cleanup();
+                reject(new Error(`letta exited before init (code=${info.code}): ${info.stderr.trim()}`));
+            };
+            const cleanup = () => {
+                this.off("init", onInit);
+                this.off("exit", onExit);
+            };
+            this.once("init", onInit);
+            this.once("exit", onExit);
+        });
+    }
+    /** Send a user prompt over stdin in the UserInput shape. */
+    sendUserPrompt(text) {
+        if (!this.child || this.exited)
+            throw new Error("letta process not running");
+        const input = { type: "user", message: { role: "user", content: text } };
+        this.child.stdin.write(JSON.stringify(input) + "\n");
+    }
+    /** Send a raw control request (e.g. interrupt). */
+    sendRaw(obj) {
+        if (!this.child || this.exited)
+            return;
+        this.child.stdin.write(JSON.stringify(obj) + "\n");
+    }
+    /**
+     * Cancel the in-flight turn (if any). Letta's `interrupt` control_request
+     * aborts the current operation but keeps the process alive so future
+     * prompts on the same session continue to work. We intentionally do NOT
+     * fall back to SIGINT - that would kill the subprocess and orphan the
+     * adapter's session map.
+     */
+    cancel() {
+        if (!this.child || this.exited)
+            return;
+        try {
+            // Letta's ControlRequest wire shape: { type, request_id, request: { subtype } }
+            // - subtype lives INSIDE request, not at the envelope level.
+            this.sendRaw({
+                type: "control_request",
+                request_id: `cancel-${Date.now()}`,
+                request: { subtype: "interrupt" },
+            });
+        }
+        catch {
+            // ignore
+        }
+    }
+    kill() {
+        this.child?.kill("SIGTERM");
+    }
+    get init() {
+        return this.initMsg;
+    }
+    onWire(fn) {
+        this.on("wire", fn);
+    }
+}
+//# sourceMappingURL=letta-process.js.map

package/dist/letta-process.js.map

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

package/dist/mapping.d.ts

@@ -0,0 +1,43 @@
+import type { SessionNotification } from "@agentclientprotocol/sdk";
+import type { WireMessage } from "./wire.js";
+/**
+ * Translate a Letta WireMessage into a partial ACP SessionNotification.
+ *
+ * Returns null for messages that have no direct user-visible mapping
+ * (lifecycle, queue events, sync markers). The caller wraps the returned
+ * `update` with the ACP sessionId.
+ *
+ * Heuristic for ToolKind: inferred from tool name. See `inferToolKind`.
+ */
+export declare function wireToSessionUpdate(msg: WireMessage, sessionId: string): SessionNotification | null;
+/**
+ * Build a human-readable title from tool name + complete args.
+ * Mirrors claude-agent-acp's toolInfoFromToolUse: include file path,
+ * pattern, or command in the title so the host UI doesn't show every
+ * row as a bare 'Read' / 'Bash' / 'Grep'.
+ */
+export declare function descriptiveTitle(toolName: string, rawInput: any): string | null;
+/**
+ * For filesystem edit tools (`Edit`, `Write`, `MultiEdit`, `ApplyPatch`):
+ * attach an ACP-style `diff` content block so the host UI renders an actual
+ * before/after view instead of the bare tool_return JSON
+ * (`{"message":"Successfully replaced 1 occurrence..."}`), which carries no
+ * useful information to the user once the change has been made.
+ */
+export declare function decorateFileEditToolCall(baseUpdate: any, toolName: string, rawInput: any): any;
+/**
+ * Strip Letta `Read` tool line-number prefixes (`  42→content`) from a return
+ * body so the host renders the file contents cleanly. The prefix is purely a
+ * decoration for the model and gets in the way of agent-shell's rendering
+ * (visual noise + broken indentation).
+ */
+export declare function stripReadLineNumbers(text: string): string;
+/**
+ * For `memory`, `memory_apply_patch`, `memory_insert`, `memory_replace`:
+ *  - prefix title with "memory · " so the host UI flags it visually,
+ *  - try to build an ACP-style Diff content block from args (old_string/new_string
+ *    for the unified `memory` tool, or file_text for `create`).
+ *
+ * Returns the enriched update (still `sessionUpdate: "tool_call"`).
+ */
+export declare function decorateMemoryToolCall(baseUpdate: any, toolName: string, rawInput: any): any;

package/dist/mapping.js

@@ -0,0 +1,444 @@
+/**
+ * Translate a Letta WireMessage into a partial ACP SessionNotification.
+ *
+ * Returns null for messages that have no direct user-visible mapping
+ * (lifecycle, queue events, sync markers). The caller wraps the returned
+ * `update` with the ACP sessionId.
+ *
+ * Heuristic for ToolKind: inferred from tool name. See `inferToolKind`.
+ */
+export function wireToSessionUpdate(msg, sessionId) {
+    switch (msg.type) {
+        case "message":
+            return mapMessage(msg, sessionId);
+        case "stream_event":
+            return mapStreamEvent(msg, sessionId);
+        case "tool_execution_started":
+            return toolUpdate(sessionId, String(msg.tool_call_id ?? "?"), {
+                status: "in_progress",
+            });
+        case "tool_execution_finished": {
+            const m = msg;
+            return toolUpdate(sessionId, String(m.tool_call_id ?? "?"), {
+                status: m.status === "error" ? "failed" : "completed",
+                content: m.content
+                    ? [{ type: "content", content: { type: "text", text: String(m.content) } }]
+                    : undefined,
+            });
+        }
+        case "auto_approval": {
+            const m = msg;
+            const tc = m.tool_call ?? {};
+            const id = String(tc.tool_call_id ?? `call-${Date.now()}`);
+            const name = String(tc.name ?? "");
+            const rawInput = safeParseJson(tc.arguments);
+            const base = {
+                sessionUpdate: "tool_call_update",
+                toolCallId: id,
+                status: "in_progress",
+                rawInput,
+            };
+            // Re-run memory decoration with full args (the original tool_call
+            // emission only had the tool name; args streamed in later deltas).
+            const enriched = decorateFileEditToolCall(decorateMemoryToolCall(base, name, rawInput), name, rawInput);
+            return { sessionId, update: enriched };
+        }
+        default:
+            return null;
+    }
+}
+function mapMessage(msg, sessionId) {
+    const m = msg;
+    switch (m.message_type) {
+        case "assistant_message":
+            return {
+                sessionId,
+                update: {
+                    sessionUpdate: "agent_message_chunk",
+                    content: { type: "text", text: String(m.content ?? "") },
+                },
+            };
+        case "reasoning_message":
+            return {
+                sessionId,
+                update: {
+                    sessionUpdate: "agent_thought_chunk",
+                    content: { type: "text", text: String(m.reasoning ?? m.content ?? "") },
+                },
+            };
+        case "tool_call_message": {
+            const tc = m.tool_call ?? {};
+            const name = String(tc.name ?? "tool");
+            return {
+                sessionId,
+                update: {
+                    sessionUpdate: "tool_call",
+                    toolCallId: String(tc.tool_call_id ?? `call-${Date.now()}`),
+                    title: name,
+                    kind: inferToolKind(name),
+                    status: "pending",
+                    rawInput: safeParseJson(tc.arguments),
+                },
+            };
+        }
+        case "tool_return_message":
+            return toolUpdate(sessionId, String(m.tool_call_id ?? "?"), {
+                status: m.status === "error" ? "failed" : "completed",
+                content: m.tool_return
+                    ? [{ type: "content", content: { type: "text", text: String(m.tool_return) } }]
+                    : undefined,
+            });
+    }
+    return null;
+}
+function mapStreamEvent(msg, sessionId) {
+    const ev = msg.event ?? {};
+    const mt = ev.message_type;
+    // Letta emits assistant text under `event.content`. Reasoning lives under
+    // `event.reasoning`. Delta variants share the same field names.
+    const assistantText = typeof ev.content === "string"
+        ? ev.content
+        : typeof ev.text === "string"
+            ? ev.text
+            : null;
+    const reasoningText = typeof ev.reasoning === "string"
+        ? ev.reasoning
+        : typeof ev.content === "string"
+            ? ev.content
+            : typeof ev.text === "string"
+                ? ev.text
+                : null;
+    if (assistantText !== null && (mt === "assistant_message" || mt === "assistant_message_delta")) {
+        return {
+            sessionId,
+            update: { sessionUpdate: "agent_message_chunk", content: { type: "text", text: assistantText } },
+        };
+    }
+    if (reasoningText !== null && (mt === "reasoning_message" || mt === "reasoning_message_delta")) {
+        return {
+            sessionId,
+            update: { sessionUpdate: "agent_thought_chunk", content: { type: "text", text: reasoningText } },
+        };
+    }
+    if (mt === "approval_request_message" && ev.tool_call?.name) {
+        const tc = ev.tool_call;
+        const name = String(tc.name);
+        const rawInput = safeParseJson(tc.arguments);
+        const base = {
+            sessionUpdate: "tool_call",
+            toolCallId: String(tc.tool_call_id ?? `call-${Date.now()}`),
+            title: name,
+            kind: inferToolKind(name),
+            status: "pending",
+            rawInput,
+        };
+        return {
+            sessionId,
+            update: decorateFileEditToolCall(decorateMemoryToolCall(base, name, rawInput), name, rawInput),
+        };
+    }
+    if (mt === "tool_call_message" && ev.tool_call) {
+        const tc = ev.tool_call;
+        const name = String(tc.name ?? "tool");
+        const rawInput = safeParseJson(tc.arguments);
+        const base = {
+            sessionUpdate: "tool_call",
+            toolCallId: String(tc.tool_call_id ?? tc.id ?? `call-${Date.now()}`),
+            title: name,
+            kind: inferToolKind(name),
+            status: "pending",
+            rawInput,
+        };
+        return {
+            sessionId,
+            update: decorateFileEditToolCall(decorateMemoryToolCall(base, name, rawInput), name, rawInput),
+        };
+    }
+    if (mt === "tool_return_message") {
+        const text = String(ev.tool_return ?? ev.stdout ?? "");
+        // Heuristic: some tools (web_search) return status="success" with an
+        // error-shaped JSON body. Detect common patterns and flip to `failed` so
+        // the user sees a clear error indicator instead of a green "completed"
+        // hiding a 400/auth/quota issue.
+        const looksLikeError = ev.status !== "error" &&
+            (/^\s*\{\s*"[^"]*"\s*:\s*"[^"]*"\s*,\s*"error"\s*:/.test(text) ||
+                /\b(Request failed|status code [45]\d\d|Validation error)\b/i.test(text));
+        return toolUpdate(sessionId, String(ev.tool_call_id ?? "?"), {
+            status: ev.status === "error" || looksLikeError ? "failed" : "completed",
+            content: text
+                ? [{ type: "content", content: { type: "text", text } }]
+                : undefined,
+        });
+    }
+    // stop_reason / usage_statistics: lifecycle, no ACP update needed.
+    return null;
+}
+function toolUpdate(sessionId, toolCallId, fields) {
+    return {
+        sessionId,
+        update: {
+            sessionUpdate: "tool_call_update",
+            toolCallId,
+            ...fields,
+        },
+    };
+}
+function safeParseJson(s) {
+    if (typeof s !== "string")
+        return s ?? null;
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return s;
+    }
+}
+/**
+ * Build a human-readable title from tool name + complete args.
+ * Mirrors claude-agent-acp's toolInfoFromToolUse: include file path,
+ * pattern, or command in the title so the host UI doesn't show every
+ * row as a bare 'Read' / 'Bash' / 'Grep'.
+ */
+export function descriptiveTitle(toolName, rawInput) {
+    if (!rawInput || typeof rawInput !== "object")
+        return null;
+    const a = rawInput;
+    const fp = typeof a.file_path === "string" ? a.file_path : null;
+    switch (toolName) {
+        case "Read":
+        case "ReadLSP":
+        case "ViewImage":
+            return fp ? `Read ${relativizePath(fp)}` : null;
+        case "Write":
+            return fp ? `Write ${relativizePath(fp)}` : null;
+        case "Edit":
+        case "MultiEdit":
+        case "ApplyPatch":
+            return fp ? `Edit ${relativizePath(fp)}` : null;
+        case "Glob":
+        case "GlobGemini": {
+            const pattern = typeof a.pattern === "string" ? a.pattern : null;
+            const path = typeof a.path === "string" ? a.path : null;
+            if (pattern && path)
+                return `Glob ${pattern} in ${relativizePath(path)}`;
+            if (pattern)
+                return `Glob ${pattern}`;
+            return null;
+        }
+        case "Grep":
+        case "GrepFilesCodex": {
+            const pattern = typeof a.pattern === "string" ? a.pattern : null;
+            const path = typeof a.path === "string" ? a.path : null;
+            if (pattern && path)
+                return `Grep "${pattern}" in ${relativizePath(path)}`;
+            if (pattern)
+                return `Grep "${pattern}"`;
+            return null;
+        }
+        case "Bash":
+        case "BashOutput":
+        case "ShellCommand": {
+            const desc = typeof a.description === "string" ? a.description : null;
+            const cmd = typeof a.command === "string" ? a.command : null;
+            if (desc && cmd)
+                return `${desc}`;
+            if (cmd)
+                return `Bash ${truncate(cmd, 80)}`;
+            return null;
+        }
+        case "Task":
+        case "Agent": {
+            const desc = typeof a.description === "string" ? a.description : null;
+            const sub = typeof a.subagent_type === "string" ? a.subagent_type : null;
+            if (desc && sub)
+                return `Agent[${sub}] ${desc}`;
+            if (desc)
+                return `Agent ${desc}`;
+            return null;
+        }
+        case "TodoWrite": {
+            // Letta's TodoWrite mutates an internal task list. The default 'TodoWrite'
+            // title looks like generic developer-facing API noise. Surface a more
+            // user-visible label and summarize the action.
+            const todos = Array.isArray(a.todos) ? a.todos : null;
+            if (todos && todos.length > 0) {
+                const counts = todos.reduce((acc, t) => {
+                    const s = String(t?.status ?? "pending");
+                    acc[s] = (acc[s] ?? 0) + 1;
+                    return acc;
+                }, {});
+                const parts = Object.entries(counts)
+                    .map(([k, v]) => `${v} ${k}`)
+                    .join(", ");
+                return `Plan · ${todos.length} todo${todos.length > 1 ? "s" : ""} (${parts})`;
+            }
+            return `Plan · update todos`;
+        }
+        case "UpdatePlan": {
+            return `Plan · update`;
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * For filesystem edit tools (`Edit`, `Write`, `MultiEdit`, `ApplyPatch`):
+ * attach an ACP-style `diff` content block so the host UI renders an actual
+ * before/after view instead of the bare tool_return JSON
+ * (`{"message":"Successfully replaced 1 occurrence..."}`), which carries no
+ * useful information to the user once the change has been made.
+ */
+export function decorateFileEditToolCall(baseUpdate, toolName, rawInput) {
+    if (toolName !== "Edit" &&
+        toolName !== "Write" &&
+        toolName !== "MultiEdit" &&
+        toolName !== "ApplyPatch") {
+        return baseUpdate;
+    }
+    const args = rawInput && typeof rawInput === "object" ? rawInput : {};
+    const fp = typeof args.file_path === "string" ? args.file_path : null;
+    if (!fp)
+        return baseUpdate;
+    let before = null;
+    let after = null;
+    if (toolName === "Edit") {
+        before = typeof args.old_string === "string" ? args.old_string : null;
+        after = typeof args.new_string === "string" ? args.new_string : null;
+    }
+    else if (toolName === "Write") {
+        before = "";
+        after = typeof args.content === "string" ? args.content : null;
+    }
+    else if (toolName === "MultiEdit" && Array.isArray(args.edits)) {
+        const olds = [];
+        const news = [];
+        for (const e of args.edits) {
+            if (typeof e?.old_string === "string")
+                olds.push(e.old_string);
+            if (typeof e?.new_string === "string")
+                news.push(e.new_string);
+        }
+        if (olds.length || news.length) {
+            before = olds.join("\n\n---\n\n");
+            after = news.join("\n\n---\n\n");
+        }
+    }
+    if (before === null || after === null)
+        return baseUpdate;
+    const update = { ...baseUpdate };
+    const existing = Array.isArray(update.content) ? update.content : [];
+    const alreadyHasDiff = existing.some((c) => c?.type === "diff");
+    if (alreadyHasDiff)
+        return update;
+    update.content = [...existing, { type: "diff", path: fp, oldText: before, newText: after }];
+    return update;
+}
+/**
+ * Strip Letta `Read` tool line-number prefixes (`  42→content`) from a return
+ * body so the host renders the file contents cleanly. The prefix is purely a
+ * decoration for the model and gets in the way of agent-shell's rendering
+ * (visual noise + broken indentation).
+ */
+export function stripReadLineNumbers(text) {
+    return text.replace(/^[ \t]*\d+→/gm, "");
+}
+function relativizePath(p) {
+    const cwd = process.cwd();
+    if (p.startsWith(cwd + "/"))
+        return p.slice(cwd.length + 1);
+    const home = process.env.HOME ?? "";
+    if (home && p.startsWith(home + "/"))
+        return "~/" + p.slice(home.length + 1);
+    return p;
+}
+function truncate(s, n) {
+    return s.length <= n ? s : s.slice(0, n - 1) + "…";
+}
+function inferToolKind(name) {
+    const n = name.toLowerCase();
+    // Memory tools edit agent state (system prompt blocks, MemFS files), so
+    // surface them as `edit` even though the file doesn't live in cwd.
+    if (n.startsWith("memory"))
+        return "edit";
+    if (n.includes("read") || n.includes("view") || n.includes("grep") || n.includes("glob"))
+        return "read";
+    if (n.includes("edit") || n.includes("write") || n.includes("patch") || n.includes("apply"))
+        return "edit";
+    if (n.includes("shell") || n.includes("bash") || n.includes("exec") || n.includes("run"))
+        return "execute";
+    if (n.includes("search"))
+        return "search";
+    if (n.includes("plan") || n.includes("todo"))
+        return "think";
+    return "other";
+}
+/**
+ * For `memory`, `memory_apply_patch`, `memory_insert`, `memory_replace`:
+ *  - prefix title with "memory · " so the host UI flags it visually,
+ *  - try to build an ACP-style Diff content block from args (old_string/new_string
+ *    for the unified `memory` tool, or file_text for `create`).
+ *
+ * Returns the enriched update (still `sessionUpdate: "tool_call"`).
+ */
+export function decorateMemoryToolCall(baseUpdate, toolName, rawInput) {
+    // Accept either the raw Letta name ("memory_replace") or the already-
+    // decorated title ("memory · replace · path") - the refinement path
+    // re-runs decoration after the title has been rewritten.
+    const lc = toolName.toLowerCase();
+    if (!lc.startsWith("memory"))
+        return baseUpdate;
+    const update = { ...baseUpdate };
+    const args = rawInput && typeof rawInput === "object" ? { ...rawInput } : {};
+    const command = args.command;
+    // Letta memory tools use `file_path` (unified `memory` tool) or `label`
+    // (memory_replace / memory_insert targeting a memory block).  Treat both
+    // as the destination identifier.
+    const path = args.file_path ?? args.label ?? args.old_path ?? args.new_path;
+    const action = command ? `${command}` : toolName.replace(/^memory_?/, "") || "update";
+    update.title = `memory · ${action}${path ? ` · ${path}` : ""}`;
+    update.kind = "edit";
+    // Compute before/after text from Letta's arg shape.
+    const before = typeof args.old_string === "string"
+        ? args.old_string
+        : command === "create"
+            ? ""
+            : null;
+    const after = typeof args.new_string === "string"
+        ? args.new_string
+        : typeof args.file_text === "string"
+            ? args.file_text
+            : typeof args.insert_text === "string"
+                ? args.insert_text
+                : null;
+    if (before !== null && after !== null && path) {
+        // Path 1: emit a 'diff' content block so ACP hosts that read content[]
+        // (Zed) render the change.
+        const existing = Array.isArray(update.content) ? update.content : [];
+        update.content = [
+            ...existing,
+            {
+                type: "diff",
+                path: `~/.letta/memfs/${path}`,
+                oldText: before,
+                newText: after,
+            },
+        ];
+        // Path 2: mirror into rawInput under the ACP-standard keys
+        // (old_str/new_str/path). agent-shell extracts diffs from rawInput when
+        // content[] doesn't include a diff block - that's the path we hit when a
+        // tool_call_update later overwrites content with the tool_return text.
+        args.old_str = before;
+        args.new_str = after;
+        args.path = `~/.letta/memfs/${path}`;
+        update.rawInput = args;
+    }
+    else if (typeof args.reason === "string") {
+        const existing = Array.isArray(update.content) ? update.content : [];
+        update.content = [
+            ...existing,
+            { type: "content", content: { type: "text", text: `reason: ${args.reason}` } },
+        ];
+    }
+    return update;
+}
+//# sourceMappingURL=mapping.js.map