@andorra-labs/code 0.0.0-stage → 0.1.5

package/dist/vendor/engine/runtime/coding-agent/core/keybindings.js

@@ -0,0 +1,320 @@
+import { TUI_KEYBINDINGS, AndorraKeybindingsManager as AndorraTuiKeybindingsManager, } from "../../tui/index.js";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { andorraGetAgentDir } from "../config.js";
+import { andorraStripBom } from "../utils/text.js";
+export function andorraUseWindowsKeybindings(platform = process.platform, env = process.env) {
+    return platform === "win32" || (platform === "linux" && Boolean(env.WSL_DISTRO_NAME || env.WSL_INTEROP));
+}
+const windowsKeybindings = andorraUseWindowsKeybindings();
+export const KEYBINDINGS = {
+    ...TUI_KEYBINDINGS,
+    "tui.editor.undo": {
+        ...TUI_KEYBINDINGS["tui.editor.undo"],
+        defaultKeys: process.platform === "win32" ? "ctrl+z" : windowsKeybindings ? "alt+z" : "ctrl+-",
+    },
+    "tui.altScreen.previousPrompt": {
+        ...TUI_KEYBINDINGS["tui.altScreen.previousPrompt"],
+        defaultKeys: windowsKeybindings ? "ctrl+up" : ["ctrl+shift+up", "ctrl+up"],
+    },
+    "tui.altScreen.nextPrompt": {
+        ...TUI_KEYBINDINGS["tui.altScreen.nextPrompt"],
+        defaultKeys: windowsKeybindings ? "ctrl+down" : ["ctrl+shift+down", "ctrl+down"],
+    },
+    "tui.altScreen.search": {
+        ...TUI_KEYBINDINGS["tui.altScreen.search"],
+        defaultKeys: windowsKeybindings ? "ctrl+f" : "ctrl+shift+f",
+    },
+    "app.interrupt": { defaultKeys: "escape", description: "Cancel or abort" },
+    "app.clear": { defaultKeys: "ctrl+c", description: "Clear editor" },
+    "app.exit": { defaultKeys: "ctrl+d", description: "Exit when editor is empty" },
+    "app.suspend": {
+        defaultKeys: process.platform === "win32" ? [] : "ctrl+z",
+        description: "Suspend to background",
+    },
+    "app.thinking.cycle": {
+        defaultKeys: "shift+tab",
+        description: "Cycle thinking level",
+    },
+    "app.thinking.save": {
+        defaultKeys: "ctrl+s",
+        description: "Save thinking level",
+    },
+    "app.model.cycleForward": {
+        defaultKeys: "ctrl+p",
+        description: "Cycle to next model",
+    },
+    "app.model.cycleBackward": {
+        defaultKeys: windowsKeybindings ? "alt+p" : "shift+ctrl+p",
+        description: "Cycle to previous model",
+    },
+    "app.model.select": { defaultKeys: "ctrl+l", description: "Open model selector" },
+    "app.tools.expand": { defaultKeys: "ctrl+o", description: "Toggle tool output" },
+    "app.thinking.toggle": {
+        defaultKeys: "ctrl+t",
+        description: "Toggle thinking blocks",
+    },
+    "app.session.toggleNamedFilter": {
+        defaultKeys: "ctrl+n",
+        description: "Toggle named session filter",
+    },
+    "app.editor.external": {
+        defaultKeys: "ctrl+g",
+        description: "Open external editor",
+    },
+    "app.message.copy": {
+        defaultKeys: "ctrl+x",
+        description: "Copy selection or last assistant message",
+    },
+    "app.message.followUp": {
+        defaultKeys: windowsKeybindings ? "ctrl+q" : "alt+enter",
+        description: "Queue follow-up message",
+    },
+    "app.message.dequeue": {
+        defaultKeys: windowsKeybindings ? "alt+q" : "alt+up",
+        description: "Restore queued messages",
+    },
+    "app.clipboard.pasteImage": {
+        defaultKeys: windowsKeybindings ? "alt+v" : "ctrl+v",
+        description: "Paste image from clipboard (text fallback)",
+    },
+    "app.session.new": { defaultKeys: [], description: "Start a new session" },
+    "app.session.tree": { defaultKeys: [], description: "Open session tree" },
+    "app.session.fork": { defaultKeys: [], description: "Fork current session" },
+    "app.session.resume": { defaultKeys: [], description: "Resume a session" },
+    "app.tree.foldOrUp": {
+        defaultKeys: process.platform === "darwin" ? ["alt+left", "ctrl+left"] : ["ctrl+left", "alt+left"],
+        description: "Fold tree branch or move up",
+    },
+    "app.tree.unfoldOrDown": {
+        defaultKeys: process.platform === "darwin" ? ["alt+right", "ctrl+right"] : ["ctrl+right", "alt+right"],
+        description: "Unfold tree branch or move down",
+    },
+    "app.tree.editLabel": {
+        defaultKeys: "shift+l",
+        description: "Edit tree label",
+    },
+    "app.tree.toggleLabelTimestamp": {
+        defaultKeys: "shift+t",
+        description: "Toggle tree label timestamps",
+    },
+    "app.session.togglePath": {
+        defaultKeys: "ctrl+p",
+        description: "Toggle session path display",
+    },
+    "app.session.toggleSort": {
+        defaultKeys: "ctrl+s",
+        description: "Toggle session sort mode",
+    },
+    "app.session.rename": {
+        defaultKeys: "ctrl+r",
+        description: "Rename session",
+    },
+    "app.session.delete": {
+        defaultKeys: "ctrl+d",
+        description: "Delete session",
+    },
+    "app.session.deleteNoninvasive": {
+        defaultKeys: "ctrl+backspace",
+        description: "Delete session when query is empty",
+    },
+    "app.models.save": {
+        defaultKeys: "ctrl+s",
+        description: "Save model selection",
+    },
+    "app.models.enableAll": {
+        defaultKeys: "ctrl+a",
+        description: "Enable all models",
+    },
+    "app.models.clearAll": {
+        defaultKeys: "ctrl+x",
+        description: "Clear all models",
+    },
+    "app.models.toggleProvider": {
+        defaultKeys: "ctrl+p",
+        description: "Toggle all models for provider",
+    },
+    "app.models.reorderUp": {
+        defaultKeys: "alt+up",
+        description: "Move model up in order",
+    },
+    "app.models.reorderDown": {
+        defaultKeys: "alt+down",
+        description: "Move model down in order",
+    },
+    "app.tree.filter.default": {
+        defaultKeys: "ctrl+d",
+        description: "Tree filter: default view",
+    },
+    "app.tree.filter.noTools": {
+        defaultKeys: "ctrl+t",
+        description: "Tree filter: hide tool results",
+    },
+    "app.tree.filter.userOnly": {
+        defaultKeys: "ctrl+u",
+        description: "Tree filter: user messages only",
+    },
+    "app.tree.filter.labeledOnly": {
+        defaultKeys: "ctrl+l",
+        description: "Tree filter: labeled entries only",
+    },
+    "app.tree.filter.all": {
+        defaultKeys: "ctrl+a",
+        description: "Tree filter: show all entries",
+    },
+    "app.tree.filter.cycleForward": {
+        defaultKeys: "ctrl+o",
+        description: "Tree filter: cycle forward",
+    },
+    "app.tree.filter.cycleBackward": {
+        defaultKeys: "shift+ctrl+o",
+        description: "Tree filter: cycle backward",
+    },
+};
+const KEYBINDING_NAME_MIGRATIONS = {
+    cursorUp: "tui.editor.cursorUp",
+    cursorDown: "tui.editor.cursorDown",
+    cursorLeft: "tui.editor.cursorLeft",
+    cursorRight: "tui.editor.cursorRight",
+    cursorWordLeft: "tui.editor.cursorWordLeft",
+    cursorWordRight: "tui.editor.cursorWordRight",
+    cursorLineStart: "tui.editor.cursorLineStart",
+    cursorLineEnd: "tui.editor.cursorLineEnd",
+    jumpForward: "tui.editor.jumpForward",
+    jumpBackward: "tui.editor.jumpBackward",
+    pageUp: "tui.editor.pageUp",
+    pageDown: "tui.editor.pageDown",
+    deleteCharBackward: "tui.editor.deleteCharBackward",
+    deleteCharForward: "tui.editor.deleteCharForward",
+    deleteWordBackward: "tui.editor.deleteWordBackward",
+    deleteWordForward: "tui.editor.deleteWordForward",
+    deleteToLineStart: "tui.editor.deleteToLineStart",
+    deleteToLineEnd: "tui.editor.deleteToLineEnd",
+    yank: "tui.editor.yank",
+    yankPop: "tui.editor.yankPop",
+    undo: "tui.editor.undo",
+    newLine: "tui.input.newLine",
+    submit: "tui.input.submit",
+    tab: "tui.input.tab",
+    copy: "tui.input.copy",
+    selectUp: "tui.select.up",
+    selectDown: "tui.select.down",
+    selectPageUp: "tui.select.pageUp",
+    selectPageDown: "tui.select.pageDown",
+    selectConfirm: "tui.select.confirm",
+    selectCancel: "tui.select.cancel",
+    interrupt: "app.interrupt",
+    clear: "app.clear",
+    exit: "app.exit",
+    suspend: "app.suspend",
+    cycleThinkingLevel: "app.thinking.cycle",
+    cycleModelForward: "app.model.cycleForward",
+    cycleModelBackward: "app.model.cycleBackward",
+    selectModel: "app.model.select",
+    expandTools: "app.tools.expand",
+    toggleThinking: "app.thinking.toggle",
+    toggleSessionNamedFilter: "app.session.toggleNamedFilter",
+    externalEditor: "app.editor.external",
+    followUp: "app.message.followUp",
+    dequeue: "app.message.dequeue",
+    pasteImage: "app.clipboard.pasteImage",
+    newSession: "app.session.new",
+    tree: "app.session.tree",
+    fork: "app.session.fork",
+    resume: "app.session.resume",
+    treeFoldOrUp: "app.tree.foldOrUp",
+    treeUnfoldOrDown: "app.tree.unfoldOrDown",
+    treeEditLabel: "app.tree.editLabel",
+    treeToggleLabelTimestamp: "app.tree.toggleLabelTimestamp",
+    toggleSessionPath: "app.session.togglePath",
+    toggleSessionSort: "app.session.toggleSort",
+    renameSession: "app.session.rename",
+    deleteSession: "app.session.delete",
+    deleteSessionNoninvasive: "app.session.deleteNoninvasive",
+};
+function andorraIsLegacyKeybindingName(key) {
+    return key in KEYBINDING_NAME_MIGRATIONS;
+}
+function andorraToKeybindingsConfig(value) {
+    const config = {};
+    for (const [key, binding] of Object.entries(value)) {
+        if (typeof binding === "string") {
+            config[key] = binding;
+            continue;
+        }
+        if (Array.isArray(binding) && binding.every((entry) => typeof entry === "string")) {
+            config[key] = binding;
+        }
+    }
+    return config;
+}
+export function andorraMigrateKeybindingsConfig(rawConfig) {
+    const config = {};
+    let migrated = false;
+    for (const [key, value] of Object.entries(rawConfig)) {
+        const nextKey = andorraIsLegacyKeybindingName(key) ? KEYBINDING_NAME_MIGRATIONS[key] : key;
+        if (nextKey !== key) {
+            migrated = true;
+        }
+        if (key !== nextKey && Object.hasOwn(rawConfig, nextKey)) {
+            migrated = true;
+            continue;
+        }
+        config[nextKey] = value;
+    }
+    return { config: andorraOrderKeybindingsConfig(config), migrated };
+}
+function andorraOrderKeybindingsConfig(config) {
+    const ordered = {};
+    for (const keybinding of Object.keys(KEYBINDINGS)) {
+        if (Object.hasOwn(config, keybinding)) {
+            ordered[keybinding] = config[keybinding];
+        }
+    }
+    const extras = Object.keys(config)
+        .filter((key) => !Object.hasOwn(ordered, key))
+        .sort();
+    for (const key of extras) {
+        ordered[key] = config[key];
+    }
+    return ordered;
+}
+function andorraLoadRawConfig(path) {
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const parsed = JSON.parse(andorraStripBom(readFileSync(path, "utf-8")));
+        if (typeof parsed !== "object" || parsed === null)
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+export class AndorraKeybindingsManager extends AndorraTuiKeybindingsManager {
+    configPath;
+    constructor(userBindings = {}, configPath) {
+        super(KEYBINDINGS, userBindings);
+        this.configPath = configPath;
+    }
+    static create(agentDir = andorraGetAgentDir()) {
+        const configPath = join(agentDir, "keybindings.json");
+        const userBindings = AndorraKeybindingsManager.loadFromFile(configPath);
+        return new AndorraKeybindingsManager(userBindings, configPath);
+    }
+    reload() {
+        if (!this.configPath)
+            return;
+        this.setUserBindings(AndorraKeybindingsManager.loadFromFile(this.configPath));
+    }
+    getEffectiveConfig() {
+        return this.getResolvedBindings();
+    }
+    static loadFromFile(path) {
+        const rawConfig = andorraLoadRawConfig(path);
+        if (!rawConfig)
+            return {};
+        return andorraToKeybindingsConfig(andorraMigrateKeybindingsConfig(rawConfig).config);
+    }
+}

package/dist/vendor/engine/runtime/coding-agent/core/messages.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Custom message types and transformers for the coding agent.
+ *
+ * Extends the base AgentMessage type with coding-agent specific message types,
+ * and provides a transformer to convert them to LLM-compatible messages.
+ */
+import type { AgentMessage } from "../../agent/index.js";
+import type { ImageContent, Message, TextContent } from "../../ai/index.js";
+export declare const COMPACTION_SUMMARY_PREFIX = "The conversation history before this point was compacted into the following summary:\n\n<summary>\n";
+export declare const COMPACTION_SUMMARY_SUFFIX = "\n</summary>";
+export declare const BRANCH_SUMMARY_PREFIX = "The following is a summary of a branch that this conversation came back from:\n\n<summary>\n";
+export declare const BRANCH_SUMMARY_SUFFIX = "</summary>";
+/**
+ * Message type for bash executions via the ! command.
+ */
+export interface BashExecutionMessage {
+    role: "bashExecution";
+    command: string;
+    output: string;
+    exitCode: number | undefined;
+    cancelled: boolean;
+    truncated: boolean;
+    fullOutputPath?: string;
+    timestamp: number;
+    /** If true, this message is excluded from LLM context (!! prefix) */
+    excludeFromContext?: boolean;
+}
+/**
+ * Message type for extension-injected messages via sendMessage().
+ * These are custom messages that extensions can inject into the conversation.
+ */
+export interface CustomMessage<T = unknown> {
+    role: "custom";
+    customType: string;
+    content: string | (TextContent | ImageContent)[];
+    display: boolean;
+    details?: T;
+    timestamp: number;
+}
+export interface BranchSummaryMessage {
+    role: "branchSummary";
+    summary: string;
+    fromId: string | null;
+    timestamp: number;
+}
+export interface CompactionSummaryMessage {
+    role: "compactionSummary";
+    summary: string;
+    tokensBefore: number;
+    timestamp: number;
+}
+declare module "../../agent/index.js" {
+    interface CustomAgentMessages {
+        bashExecution: BashExecutionMessage;
+        custom: CustomMessage;
+        branchSummary: BranchSummaryMessage;
+        compactionSummary: CompactionSummaryMessage;
+    }
+}
+/**
+ * Convert a BashExecutionMessage to user message text for LLM context.
+ */
+export declare function andorraBashExecutionToText(msg: BashExecutionMessage): string;
+export declare function andorraCreateBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage;
+export declare function andorraCreateCompactionSummaryMessage(summary: string, tokensBefore: number, timestamp: string): CompactionSummaryMessage;
+/** Convert CustomMessageEntry to AgentMessage format */
+export declare function andorraCreateCustomMessage(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details: unknown | undefined, timestamp: string): CustomMessage;
+/**
+ * Transform AgentMessages (including custom types) to LLM-compatible Messages.
+ *
+ * This is used by:
+ * - Agent's transormToLlm option (for prompt calls and queued messages)
+ * - Compaction's generateSummary (for summarization)
+ * - Custom extensions and tools
+ */
+export declare function andorraConvertToLlm(messages: AgentMessage[]): Message[];

package/dist/vendor/engine/runtime/coding-agent/core/messages.js

@@ -0,0 +1,123 @@
+/**
+ * Custom message types and transformers for the coding agent.
+ *
+ * Extends the base AgentMessage type with coding-agent specific message types,
+ * and provides a transformer to convert them to LLM-compatible messages.
+ */
+export const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:
+
+<summary>
+`;
+export const COMPACTION_SUMMARY_SUFFIX = `
+</summary>`;
+export const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:
+
+<summary>
+`;
+export const BRANCH_SUMMARY_SUFFIX = `</summary>`;
+/**
+ * Convert a BashExecutionMessage to user message text for LLM context.
+ */
+export function andorraBashExecutionToText(msg) {
+    let text = `Ran \`${msg.command}\`\n`;
+    if (msg.output) {
+        text += `\`\`\`\n${msg.output}\n\`\`\``;
+    }
+    else {
+        text += "(no output)";
+    }
+    if (msg.cancelled) {
+        text += "\n\n(command cancelled)";
+    }
+    else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {
+        text += `\n\nCommand exited with code ${msg.exitCode}`;
+    }
+    if (msg.truncated && msg.fullOutputPath) {
+        text += `\n\n[Output truncated. Full output: ${msg.fullOutputPath}]`;
+    }
+    return text;
+}
+export function andorraCreateBranchSummaryMessage(summary, fromId, timestamp) {
+    return {
+        role: "branchSummary",
+        summary,
+        fromId,
+        timestamp: new Date(timestamp).getTime(),
+    };
+}
+export function andorraCreateCompactionSummaryMessage(summary, tokensBefore, timestamp) {
+    return {
+        role: "compactionSummary",
+        summary: summary,
+        tokensBefore,
+        timestamp: new Date(timestamp).getTime(),
+    };
+}
+/** Convert CustomMessageEntry to AgentMessage format */
+export function andorraCreateCustomMessage(customType, content, display, details, timestamp) {
+    return {
+        role: "custom",
+        customType,
+        content,
+        display,
+        details,
+        timestamp: new Date(timestamp).getTime(),
+    };
+}
+/**
+ * Transform AgentMessages (including custom types) to LLM-compatible Messages.
+ *
+ * This is used by:
+ * - Agent's transormToLlm option (for prompt calls and queued messages)
+ * - Compaction's generateSummary (for summarization)
+ * - Custom extensions and tools
+ */
+export function andorraConvertToLlm(messages) {
+    return messages
+        .map((m) => {
+        switch (m.role) {
+            case "bashExecution":
+                // Skip messages excluded from context (!! prefix)
+                if (m.excludeFromContext) {
+                    return undefined;
+                }
+                return {
+                    role: "user",
+                    content: [{ type: "text", text: andorraBashExecutionToText(m) }],
+                    timestamp: m.timestamp,
+                };
+            case "custom": {
+                const content = typeof m.content === "string" ? [{ type: "text", text: m.content }] : m.content;
+                return {
+                    role: "user",
+                    content,
+                    timestamp: m.timestamp,
+                };
+            }
+            case "branchSummary":
+                return {
+                    role: "user",
+                    content: [{ type: "text", text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],
+                    timestamp: m.timestamp,
+                };
+            case "compactionSummary":
+                return {
+                    role: "user",
+                    content: [
+                        { type: "text", text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },
+                    ],
+                    timestamp: m.timestamp,
+                };
+            case "system":
+            case "user":
+            case "assistant":
+            case "toolResult":
+                return m;
+            default:
+                // biome-ignore lint/correctness/noSwitchDeclarations: fine
+                const _exhaustiveCheck = m;
+                return undefined;
+        }
+    })
+        .filter((m) => m !== undefined);
+}