indusagi-coding-agent 0.1.0

package/dist/modes/rpc/rpc-mode.js

@@ -0,0 +1,448 @@
+/**
+ * RPC mode: Headless operation with JSON stdin/stdout protocol.
+ *
+ * Used for embedding the agent in other applications.
+ * Receives commands as JSON on stdin, outputs events and responses as JSON on stdout.
+ *
+ * Protocol:
+ * - Commands: JSON objects with `type` field, optional `id` for correlation
+ * - Responses: JSON objects with `type: "response"`, `command`, `success`, and optional `data`/`error`
+ * - Events: AgentSessionEvent objects streamed as they occur
+ * - Extension UI: Extension UI requests are emitted, client responds with extension_ui_response
+ */
+import * as crypto from "node:crypto";
+import * as readline from "readline";
+import { theme } from "../interactive/theme/theme.js";
+/**
+ * Run in RPC mode.
+ * Listens for JSON commands on stdin, outputs events and responses on stdout.
+ */
+export async function runRpcMode(session) {
+    const output = (obj) => {
+        console.log(JSON.stringify(obj));
+    };
+    const success = (id, command, data) => {
+        if (data === undefined) {
+            return { id, type: "response", command, success: true };
+        }
+        return { id, type: "response", command, success: true, data };
+    };
+    const error = (id, command, message) => {
+        return { id, type: "response", command, success: false, error: message };
+    };
+    // Pending extension UI requests waiting for response
+    const pendingExtensionRequests = new Map();
+    // Shutdown request flag
+    let shutdownRequested = false;
+    /** Helper for dialog methods with signal/timeout support */
+    function createDialogPromise(opts, defaultValue, request, parseResponse) {
+        if (opts?.signal?.aborted)
+            return Promise.resolve(defaultValue);
+        const id = crypto.randomUUID();
+        return new Promise((resolve, reject) => {
+            let timeoutId;
+            const cleanup = () => {
+                if (timeoutId)
+                    clearTimeout(timeoutId);
+                opts?.signal?.removeEventListener("abort", onAbort);
+                pendingExtensionRequests.delete(id);
+            };
+            const onAbort = () => {
+                cleanup();
+                resolve(defaultValue);
+            };
+            opts?.signal?.addEventListener("abort", onAbort, { once: true });
+            if (opts?.timeout) {
+                timeoutId = setTimeout(() => {
+                    cleanup();
+                    resolve(defaultValue);
+                }, opts.timeout);
+            }
+            pendingExtensionRequests.set(id, {
+                resolve: (response) => {
+                    cleanup();
+                    resolve(parseResponse(response));
+                },
+                reject,
+            });
+            output({ type: "extension_ui_request", id, ...request });
+        });
+    }
+    /**
+     * Create an extension UI context that uses the RPC protocol.
+     */
+    const createExtensionUIContext = () => ({
+        select: (title, options, opts) => createDialogPromise(opts, undefined, { method: "select", title, options, timeout: opts?.timeout }, (r) => "cancelled" in r && r.cancelled ? undefined : "value" in r ? r.value : undefined),
+        confirm: (title, message, opts) => createDialogPromise(opts, false, { method: "confirm", title, message, timeout: opts?.timeout }, (r) => "cancelled" in r && r.cancelled ? false : "confirmed" in r ? r.confirmed : false),
+        input: (title, placeholder, opts) => createDialogPromise(opts, undefined, { method: "input", title, placeholder, timeout: opts?.timeout }, (r) => "cancelled" in r && r.cancelled ? undefined : "value" in r ? r.value : undefined),
+        notify(message, type) {
+            // Fire and forget - no response needed
+            output({
+                type: "extension_ui_request",
+                id: crypto.randomUUID(),
+                method: "notify",
+                message,
+                notifyType: type,
+            });
+        },
+        setStatus(key, text) {
+            // Fire and forget - no response needed
+            output({
+                type: "extension_ui_request",
+                id: crypto.randomUUID(),
+                method: "setStatus",
+                statusKey: key,
+                statusText: text,
+            });
+        },
+        setWorkingMessage(_message) {
+            // Working message not supported in RPC mode - requires TUI loader access
+        },
+        setWidget(key, content, options) {
+            // Only support string arrays in RPC mode - factory functions are ignored
+            if (content === undefined || Array.isArray(content)) {
+                output({
+                    type: "extension_ui_request",
+                    id: crypto.randomUUID(),
+                    method: "setWidget",
+                    widgetKey: key,
+                    widgetLines: content,
+                    widgetPlacement: options?.placement,
+                });
+            }
+            // Component factories are not supported in RPC mode - would need TUI access
+        },
+        setFooter(_factory) {
+            // Custom footer not supported in RPC mode - requires TUI access
+        },
+        setHeader(_factory) {
+            // Custom header not supported in RPC mode - requires TUI access
+        },
+        setTitle(title) {
+            // Fire and forget - host can implement terminal title control
+            output({
+                type: "extension_ui_request",
+                id: crypto.randomUUID(),
+                method: "setTitle",
+                title,
+            });
+        },
+        async custom() {
+            // Custom UI not supported in RPC mode
+            return undefined;
+        },
+        setEditorText(text) {
+            // Fire and forget - host can implement editor control
+            output({
+                type: "extension_ui_request",
+                id: crypto.randomUUID(),
+                method: "set_editor_text",
+                text,
+            });
+        },
+        getEditorText() {
+            // Synchronous method can't wait for RPC response
+            // Host should track editor state locally if needed
+            return "";
+        },
+        async editor(title, prefill) {
+            const id = crypto.randomUUID();
+            return new Promise((resolve, reject) => {
+                pendingExtensionRequests.set(id, {
+                    resolve: (response) => {
+                        if ("cancelled" in response && response.cancelled) {
+                            resolve(undefined);
+                        }
+                        else if ("value" in response) {
+                            resolve(response.value);
+                        }
+                        else {
+                            resolve(undefined);
+                        }
+                    },
+                    reject,
+                });
+                output({ type: "extension_ui_request", id, method: "editor", title, prefill });
+            });
+        },
+        setEditorComponent() {
+            // Custom editor components not supported in RPC mode
+        },
+        get theme() {
+            return theme;
+        },
+        getAllThemes() {
+            return [];
+        },
+        getTheme(_name) {
+            return undefined;
+        },
+        setTheme(_theme) {
+            // Theme switching not supported in RPC mode
+            return { success: false, error: "Theme switching not supported in RPC mode" };
+        },
+    });
+    // Set up extensions with RPC-based UI context
+    const extensionRunner = session.extensionRunner;
+    if (extensionRunner) {
+        await session.bindExtensions({
+            uiContext: createExtensionUIContext(),
+            commandContextActions: {
+                waitForIdle: () => session.agent.waitForIdle(),
+                newSession: async (options) => {
+                    const success = await session.newSession({ parentSession: options?.parentSession });
+                    if (success && options?.setup) {
+                        await options.setup(session.sessionManager);
+                    }
+                    return { cancelled: !success };
+                },
+                fork: async (entryId) => {
+                    const result = await session.fork(entryId);
+                    return { cancelled: result.cancelled };
+                },
+                navigateTree: async (targetId, options) => {
+                    const result = await session.navigateTree(targetId, {
+                        summarize: options?.summarize,
+                        customInstructions: options?.customInstructions,
+                        replaceInstructions: options?.replaceInstructions,
+                        label: options?.label,
+                    });
+                    return { cancelled: result.cancelled };
+                },
+            },
+            shutdownHandler: () => {
+                shutdownRequested = true;
+            },
+            onError: (err) => {
+                output({ type: "extension_error", extensionPath: err.extensionPath, event: err.event, error: err.error });
+            },
+        });
+    }
+    // Output all agent events as JSON
+    session.subscribe((event) => {
+        output(event);
+    });
+    // Handle a single command
+    const handleCommand = async (command) => {
+        const id = command.id;
+        switch (command.type) {
+            // =================================================================
+            // Prompting
+            // =================================================================
+            case "prompt": {
+                // Don't await - events will stream
+                // Extension commands are executed immediately, file prompt templates are expanded
+                // If streaming and streamingBehavior specified, queues via steer/followUp
+                session
+                    .prompt(command.message, {
+                    images: command.images,
+                    streamingBehavior: command.streamingBehavior,
+                    source: "rpc",
+                })
+                    .catch((e) => output(error(id, "prompt", e.message)));
+                return success(id, "prompt");
+            }
+            case "steer": {
+                await session.steer(command.message);
+                return success(id, "steer");
+            }
+            case "follow_up": {
+                await session.followUp(command.message);
+                return success(id, "follow_up");
+            }
+            case "abort": {
+                await session.abort();
+                return success(id, "abort");
+            }
+            case "new_session": {
+                const options = command.parentSession ? { parentSession: command.parentSession } : undefined;
+                const cancelled = !(await session.newSession(options));
+                return success(id, "new_session", { cancelled });
+            }
+            // =================================================================
+            // State
+            // =================================================================
+            case "get_state": {
+                const state = {
+                    model: session.model,
+                    thinkingLevel: session.thinkingLevel,
+                    isStreaming: session.isStreaming,
+                    isCompacting: session.isCompacting,
+                    steeringMode: session.steeringMode,
+                    followUpMode: session.followUpMode,
+                    sessionFile: session.sessionFile,
+                    sessionId: session.sessionId,
+                    autoCompactionEnabled: session.autoCompactionEnabled,
+                    messageCount: session.messages.length,
+                    pendingMessageCount: session.pendingMessageCount,
+                };
+                return success(id, "get_state", state);
+            }
+            // =================================================================
+            // Model
+            // =================================================================
+            case "set_model": {
+                const models = await session.modelRegistry.getAvailable();
+                const model = models.find((m) => m.provider === command.provider && m.id === command.modelId);
+                if (!model) {
+                    return error(id, "set_model", `Model not found: ${command.provider}/${command.modelId}`);
+                }
+                await session.setModel(model);
+                return success(id, "set_model", model);
+            }
+            case "cycle_model": {
+                const result = await session.cycleModel();
+                if (!result) {
+                    return success(id, "cycle_model", null);
+                }
+                return success(id, "cycle_model", result);
+            }
+            case "get_available_models": {
+                const models = await session.modelRegistry.getAvailable();
+                return success(id, "get_available_models", { models });
+            }
+            // =================================================================
+            // Thinking
+            // =================================================================
+            case "set_thinking_level": {
+                session.setThinkingLevel(command.level);
+                return success(id, "set_thinking_level");
+            }
+            case "cycle_thinking_level": {
+                const level = session.cycleThinkingLevel();
+                if (!level) {
+                    return success(id, "cycle_thinking_level", null);
+                }
+                return success(id, "cycle_thinking_level", { level });
+            }
+            // =================================================================
+            // Queue Modes
+            // =================================================================
+            case "set_steering_mode": {
+                session.setSteeringMode(command.mode);
+                return success(id, "set_steering_mode");
+            }
+            case "set_follow_up_mode": {
+                session.setFollowUpMode(command.mode);
+                return success(id, "set_follow_up_mode");
+            }
+            // =================================================================
+            // Compaction
+            // =================================================================
+            case "compact": {
+                const result = await session.compact(command.customInstructions);
+                return success(id, "compact", result);
+            }
+            case "set_auto_compaction": {
+                session.setAutoCompactionEnabled(command.enabled);
+                return success(id, "set_auto_compaction");
+            }
+            // =================================================================
+            // Retry
+            // =================================================================
+            case "set_auto_retry": {
+                session.setAutoRetryEnabled(command.enabled);
+                return success(id, "set_auto_retry");
+            }
+            case "abort_retry": {
+                session.abortRetry();
+                return success(id, "abort_retry");
+            }
+            // =================================================================
+            // Bash
+            // =================================================================
+            case "bash": {
+                const result = await session.executeBash(command.command);
+                return success(id, "bash", result);
+            }
+            case "abort_bash": {
+                session.abortBash();
+                return success(id, "abort_bash");
+            }
+            // =================================================================
+            // Session
+            // =================================================================
+            case "get_session_stats": {
+                const stats = session.getSessionStats();
+                return success(id, "get_session_stats", stats);
+            }
+            case "export_html": {
+                const path = await session.exportToHtml(command.outputPath);
+                return success(id, "export_html", { path });
+            }
+            case "switch_session": {
+                const cancelled = !(await session.switchSession(command.sessionPath));
+                return success(id, "switch_session", { cancelled });
+            }
+            case "fork": {
+                const result = await session.fork(command.entryId);
+                return success(id, "fork", { text: result.selectedText, cancelled: result.cancelled });
+            }
+            case "get_fork_messages": {
+                const messages = session.getUserMessagesForForking();
+                return success(id, "get_fork_messages", { messages });
+            }
+            case "get_last_assistant_text": {
+                const text = session.getLastAssistantText();
+                return success(id, "get_last_assistant_text", { text });
+            }
+            // =================================================================
+            // Messages
+            // =================================================================
+            case "get_messages": {
+                return success(id, "get_messages", { messages: session.messages });
+            }
+            default: {
+                const unknownCommand = command;
+                return error(undefined, unknownCommand.type, `Unknown command: ${unknownCommand.type}`);
+            }
+        }
+    };
+    /**
+     * Check if shutdown was requested and perform shutdown if so.
+     * Called after handling each command when waiting for the next command.
+     */
+    async function checkShutdownRequested() {
+        if (!shutdownRequested)
+            return;
+        const currentRunner = session.extensionRunner;
+        if (currentRunner?.hasHandlers("session_shutdown")) {
+            await currentRunner.emit({ type: "session_shutdown" });
+        }
+        // Close readline interface to stop waiting for input
+        rl.close();
+        process.exit(0);
+    }
+    // Listen for JSON input
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        terminal: false,
+    });
+    rl.on("line", async (line) => {
+        try {
+            const parsed = JSON.parse(line);
+            // Handle extension UI responses
+            if (parsed.type === "extension_ui_response") {
+                const response = parsed;
+                const pending = pendingExtensionRequests.get(response.id);
+                if (pending) {
+                    pendingExtensionRequests.delete(response.id);
+                    pending.resolve(response);
+                }
+                return;
+            }
+            // Handle regular commands
+            const command = parsed;
+            const response = await handleCommand(command);
+            output(response);
+            // Check for deferred shutdown request (idle between commands)
+            await checkShutdownRequested();
+        }
+        catch (e) {
+            output(error(undefined, "parse", `Failed to parse command: ${e.message}`));
+        }
+    });
+    // Keep process alive forever
+    return new Promise(() => { });
+}

package/dist/modes/rpc/rpc-types.js

@@ -0,0 +1,7 @@
+/**
+ * RPC protocol types for headless operation.
+ *
+ * Commands are sent as JSON lines on stdin.
+ * Responses and events are emitted as JSON lines on stdout.
+ */
+export {};

package/dist/utils/changelog.js

@@ -0,0 +1,86 @@
+import { existsSync, readFileSync } from "fs";
+/**
+ * Parse changelog entries from CHANGELOG.md
+ * Scans for ## lines and collects content until next ## or EOF
+ */
+export function parseChangelog(changelogPath) {
+    if (!existsSync(changelogPath)) {
+        return [];
+    }
+    try {
+        const content = readFileSync(changelogPath, "utf-8");
+        const lines = content.split("\n");
+        const entries = [];
+        let currentLines = [];
+        let currentVersion = null;
+        for (const line of lines) {
+            // Check if this is a version header (## [x.y.z] ...)
+            if (line.startsWith("## ")) {
+                // Save previous entry if exists
+                if (currentVersion && currentLines.length > 0) {
+                    entries.push({
+                        ...currentVersion,
+                        content: currentLines.join("\n").trim(),
+                    });
+                }
+                // Try to parse version from this line
+                const versionMatch = line.match(/##\s+\[?(\d+)\.(\d+)\.(\d+)\]?/);
+                if (versionMatch) {
+                    currentVersion = {
+                        major: Number.parseInt(versionMatch[1], 10),
+                        minor: Number.parseInt(versionMatch[2], 10),
+                        patch: Number.parseInt(versionMatch[3], 10),
+                    };
+                    currentLines = [line];
+                }
+                else {
+                    // Reset if we can't parse version
+                    currentVersion = null;
+                    currentLines = [];
+                }
+            }
+            else if (currentVersion) {
+                // Collect lines for current version
+                currentLines.push(line);
+            }
+        }
+        // Save last entry
+        if (currentVersion && currentLines.length > 0) {
+            entries.push({
+                ...currentVersion,
+                content: currentLines.join("\n").trim(),
+            });
+        }
+        return entries;
+    }
+    catch (error) {
+        console.error(`Warning: Could not parse changelog: ${error}`);
+        return [];
+    }
+}
+/**
+ * Compare versions. Returns: -1 if v1 < v2, 0 if v1 === v2, 1 if v1 > v2
+ */
+export function compareVersions(v1, v2) {
+    if (v1.major !== v2.major)
+        return v1.major - v2.major;
+    if (v1.minor !== v2.minor)
+        return v1.minor - v2.minor;
+    return v1.patch - v2.patch;
+}
+/**
+ * Get entries newer than lastVersion
+ */
+export function getNewEntries(entries, lastVersion) {
+    // Parse lastVersion
+    const parts = lastVersion.split(".").map(Number);
+    const last = {
+        major: parts[0] || 0,
+        minor: parts[1] || 0,
+        patch: parts[2] || 0,
+        content: "",
+    };
+    return entries.filter((entry) => compareVersions(entry, last) > 0);
+}
+// Re-export getChangelogPath from paths.ts for convenience
+export { getChangelogPath } from "../config.js";

package/dist/utils/clipboard-image.js

@@ -0,0 +1,116 @@
+import Clipboard from "@mariozechner/clipboard";
+import { spawnSync } from "child_process";
+const PREFERRED_IMAGE_MIME_TYPES = ["image/png", "image/jpeg", "image/webp", "image/gif"];
+const DEFAULT_LIST_TIMEOUT_MS = 1000;
+const DEFAULT_READ_TIMEOUT_MS = 3000;
+const DEFAULT_MAX_BUFFER_BYTES = 50 * 1024 * 1024;
+export function isWaylandSession(env = process.env) {
+    return Boolean(env.WAYLAND_DISPLAY) || env.XDG_SESSION_TYPE === "wayland";
+}
+function baseMimeType(mimeType) {
+    return mimeType.split(";")[0]?.trim().toLowerCase() ?? mimeType.toLowerCase();
+}
+export function extensionForImageMimeType(mimeType) {
+    switch (baseMimeType(mimeType)) {
+        case "image/png":
+            return "png";
+        case "image/jpeg":
+            return "jpg";
+        case "image/webp":
+            return "webp";
+        case "image/gif":
+            return "gif";
+        default:
+            return null;
+    }
+}
+function selectPreferredImageMimeType(mimeTypes) {
+    const normalized = mimeTypes
+        .map((t) => t.trim())
+        .filter(Boolean)
+        .map((t) => ({ raw: t, base: baseMimeType(t) }));
+    for (const preferred of PREFERRED_IMAGE_MIME_TYPES) {
+        const match = normalized.find((t) => t.base === preferred);
+        if (match) {
+            return match.raw;
+        }
+    }
+    const anyImage = normalized.find((t) => t.base.startsWith("image/"));
+    return anyImage?.raw ?? null;
+}
+function runCommand(command, args, options) {
+    const timeoutMs = options?.timeoutMs ?? DEFAULT_READ_TIMEOUT_MS;
+    const maxBufferBytes = options?.maxBufferBytes ?? DEFAULT_MAX_BUFFER_BYTES;
+    const result = spawnSync(command, args, {
+        timeout: timeoutMs,
+        maxBuffer: maxBufferBytes,
+    });
+    if (result.error) {
+        return { ok: false, stdout: Buffer.alloc(0) };
+    }
+    if (result.status !== 0) {
+        return { ok: false, stdout: Buffer.alloc(0) };
+    }
+    const stdout = Buffer.isBuffer(result.stdout)
+        ? result.stdout
+        : Buffer.from(result.stdout ?? "", typeof result.stdout === "string" ? "utf-8" : undefined);
+    return { ok: true, stdout };
+}
+function readClipboardImageViaWlPaste() {
+    const list = runCommand("wl-paste", ["--list-types"], { timeoutMs: DEFAULT_LIST_TIMEOUT_MS });
+    if (!list.ok) {
+        return null;
+    }
+    const types = list.stdout
+        .toString("utf-8")
+        .split(/\r?\n/)
+        .map((t) => t.trim())
+        .filter(Boolean);
+    const selectedType = selectPreferredImageMimeType(types);
+    if (!selectedType) {
+        return null;
+    }
+    const data = runCommand("wl-paste", ["--type", selectedType, "--no-newline"]);
+    if (!data.ok || data.stdout.length === 0) {
+        return null;
+    }
+    return { bytes: data.stdout, mimeType: baseMimeType(selectedType) };
+}
+function readClipboardImageViaXclip() {
+    const targets = runCommand("xclip", ["-selection", "clipboard", "-t", "TARGETS", "-o"], {
+        timeoutMs: DEFAULT_LIST_TIMEOUT_MS,
+    });
+    let candidateTypes = [];
+    if (targets.ok) {
+        candidateTypes = targets.stdout
+            .toString("utf-8")
+            .split(/\r?\n/)
+            .map((t) => t.trim())
+            .filter(Boolean);
+    }
+    const preferred = candidateTypes.length > 0 ? selectPreferredImageMimeType(candidateTypes) : null;
+    const tryTypes = preferred ? [preferred, ...PREFERRED_IMAGE_MIME_TYPES] : [...PREFERRED_IMAGE_MIME_TYPES];
+    for (const mimeType of tryTypes) {
+        const data = runCommand("xclip", ["-selection", "clipboard", "-t", mimeType, "-o"]);
+        if (data.ok && data.stdout.length > 0) {
+            return { bytes: data.stdout, mimeType: baseMimeType(mimeType) };
+        }
+    }
+    return null;
+}
+export async function readClipboardImage(options) {
+    const env = options?.env ?? process.env;
+    const platform = options?.platform ?? process.platform;
+    if (platform === "linux" && isWaylandSession(env)) {
+        return readClipboardImageViaWlPaste() ?? readClipboardImageViaXclip();
+    }
+    if (!Clipboard.hasImage()) {
+        return null;
+    }
+    const imageData = await Clipboard.getImageBinary();
+    if (!imageData || imageData.length === 0) {
+        return null;
+    }
+    const bytes = imageData instanceof Uint8Array ? imageData : Uint8Array.from(imageData);
+    return { bytes, mimeType: "image/png" };
+}