@mars_ai/marscli 2.0.12 → 2.0.14

package/dist/core/keybindings.js

@@ -0,0 +1,324 @@
+import { TUI_KEYBINDINGS, KeybindingsManager as TuiKeybindingsManager, } from "@earendil-works/pi-tui";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { Compile } from "typebox/compile";
+import { getAgentDir } from "../config.js";
+import { stripBom } from "../utils/text.js";
+import { KeybindingValueSchema } from "./key-id-schema.js";
+export function useWindowsKeybindings(platform = process.platform, env = process.env) {
+    return platform === "win32" || (platform === "linux" && Boolean(env.WSL_DISTRO_NAME || env.WSL_INTEROP));
+}
+const windowsKeybindings = useWindowsKeybindings();
+const APP_KEYBINDINGS = {
+    "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"] : "ctrl+v",
+        description: "Paste files on macOS, images, or text from clipboard",
+    },
+    "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",
+    },
+};
+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_KEYBINDINGS,
+};
+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 isLegacyKeybindingName(key) {
+    return key in KEYBINDING_NAME_MIGRATIONS;
+}
+const validateKeybindingValue = Compile(KeybindingValueSchema);
+function toKeybindingsConfig(value) {
+    const config = {};
+    for (const [key, binding] of Object.entries(value)) {
+        if (key === "$schema")
+            continue;
+        if (validateKeybindingValue.Check(binding))
+            config[key] = binding;
+    }
+    return config;
+}
+export function migrateKeybindingsConfig(rawConfig) {
+    const config = {};
+    let migrated = false;
+    for (const [key, value] of Object.entries(rawConfig)) {
+        const nextKey = isLegacyKeybindingName(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: orderKeybindingsConfig(config), migrated };
+}
+function orderKeybindingsConfig(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 loadRawConfig(path) {
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const parsed = JSON.parse(stripBom(readFileSync(path, "utf-8")));
+        if (typeof parsed !== "object" || parsed === null)
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+export class KeybindingsManager extends TuiKeybindingsManager {
+    configPath;
+    constructor(userBindings = {}, configPath) {
+        super(KEYBINDINGS, userBindings);
+        this.configPath = configPath;
+    }
+    static create(agentDir = getAgentDir()) {
+        const configPath = join(agentDir, "keybindings.json");
+        const userBindings = KeybindingsManager.loadFromFile(configPath);
+        return new KeybindingsManager(userBindings, configPath);
+    }
+    reload() {
+        if (!this.configPath)
+            return;
+        this.setUserBindings(KeybindingsManager.loadFromFile(this.configPath));
+    }
+    getEffectiveConfig() {
+        return this.getResolvedBindings();
+    }
+    static loadFromFile(path) {
+        const rawConfig = loadRawConfig(path);
+        if (!rawConfig)
+            return {};
+        return toKeybindingsConfig(migrateKeybindingsConfig(rawConfig).config);
+    }
+}
+//# sourceMappingURL=keybindings.js.map

package/dist/core/keybindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keybindings.js","sourceRoot":"","sources":["../../src/core/keybindings.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype Keybinding,\n\ttype KeybindingDefinitions,\n\ttype KeybindingsConfig,\n\ttype KeyId,\n\tTUI_KEYBINDINGS,\n\tKeybindingsManager as TuiKeybindingsManager,\n} from \"@earendil-works/pi-tui\";\nimport { existsSync, readFileSync } from \"fs\";\nimport { join } from \"path\";\nimport { Compile } from \"typebox/compile\";\nimport { getAgentDir } from \"../config.ts\";\nimport { stripBom } from \"../utils/text.ts\";\nimport { KeybindingValueSchema } from \"./key-id-schema.ts\";\n\nexport function useWindowsKeybindings(\n\tplatform: NodeJS.Platform = process.platform,\n\tenv: NodeJS.ProcessEnv = process.env,\n): boolean {\n\treturn platform === \"win32\" || (platform === \"linux\" && Boolean(env.WSL_DISTRO_NAME || env.WSL_INTEROP));\n}\n\nconst windowsKeybindings = useWindowsKeybindings();\n\nconst APP_KEYBINDINGS = {\n\t\"app.interrupt\": { defaultKeys: \"escape\", description: \"Cancel or abort\" },\n\t\"app.clear\": { defaultKeys: \"ctrl+c\", description: \"Clear editor\" },\n\t\"app.exit\": { defaultKeys: \"ctrl+d\", description: \"Exit when editor is empty\" },\n\t\"app.suspend\": {\n\t\tdefaultKeys: process.platform === \"win32\" ? [] : \"ctrl+z\",\n\t\tdescription: \"Suspend to background\",\n\t},\n\t\"app.thinking.cycle\": {\n\t\tdefaultKeys: \"shift+tab\",\n\t\tdescription: \"Cycle thinking level\",\n\t},\n\t\"app.thinking.save\": {\n\t\tdefaultKeys: \"ctrl+s\",\n\t\tdescription: \"Save thinking level\",\n\t},\n\t\"app.model.cycleForward\": {\n\t\tdefaultKeys: \"ctrl+p\",\n\t\tdescription: \"Cycle to next model\",\n\t},\n\t\"app.model.cycleBackward\": {\n\t\tdefaultKeys: windowsKeybindings ? \"alt+p\" : \"shift+ctrl+p\",\n\t\tdescription: \"Cycle to previous model\",\n\t},\n\t\"app.model.select\": { defaultKeys: \"ctrl+l\", description: \"Open model selector\" },\n\t\"app.tools.expand\": { defaultKeys: \"ctrl+o\", description: \"Toggle tool output\" },\n\t\"app.thinking.toggle\": {\n\t\tdefaultKeys: \"ctrl+t\",\n\t\tdescription: \"Toggle thinking blocks\",\n\t},\n\t\"app.session.toggleNamedFilter\": {\n\t\tdefaultKeys: \"ctrl+n\",\n\t\tdescription: \"Toggle named session filter\",\n\t},\n\t\"app.editor.external\": {\n\t\tdefaultKeys: \"ctrl+g\",\n\t\tdescription: \"Open external editor\",\n\t},\n\t\"app.message.copy\": {\n\t\tdefaultKeys: \"ctrl+x\",\n\t\tdescription: \"Copy selection or last assistant message\",\n\t},\n\t\"app.message.followUp\": {\n\t\tdefaultKeys: windowsKeybindings ? \"ctrl+q\" : \"alt+enter\",\n\t\tdescription: \"Queue follow-up message\",\n\t},\n\t\"app.message.dequeue\": {\n\t\tdefaultKeys: windowsKeybindings ? \"alt+q\" : \"alt+up\",\n\t\tdescription: \"Restore queued messages\",\n\t},\n\t\"app.clipboard.pasteImage\": {\n\t\tdefaultKeys: windowsKeybindings ? [\"alt+v\", \"ctrl+v\"] : \"ctrl+v\",\n\t\tdescription: \"Paste files on macOS, images, or text from clipboard\",\n\t},\n\t\"app.session.new\": { defaultKeys: [], description: \"Start a new session\" },\n\t\"app.session.tree\": { defaultKeys: [], description: \"Open session tree\" },\n\t\"app.session.fork\": { defaultKeys: [], description: \"Fork current session\" },\n\t\"app.session.resume\": { defaultKeys: [], description: \"Resume a session\" },\n\t\"app.tree.foldOrUp\": {\n\t\tdefaultKeys: process.platform === \"darwin\" ? [\"alt+left\", \"ctrl+left\"] : [\"ctrl+left\", \"alt+left\"],\n\t\tdescription: \"Fold tree branch or move up\",\n\t},\n\t\"app.tree.unfoldOrDown\": {\n\t\tdefaultKeys: process.platform === \"darwin\" ? [\"alt+right\", \"ctrl+right\"] : [\"ctrl+right\", \"alt+right\"],\n\t\tdescription: \"Unfold tree branch or move down\",\n\t},\n\t\"app.tree.editLabel\": {\n\t\tdefaultKeys: \"shift+l\",\n\t\tdescription: \"Edit tree label\",\n\t},\n\t\"app.tree.toggleLabelTimestamp\": {\n\t\tdefaultKeys: \"shift+t\",\n\t\tdescription: \"Toggle tree label timestamps\",\n\t},\n\t\"app.session.togglePath\": {\n\t\tdefaultKeys: \"ctrl+p\",\n\t\tdescription: \"Toggle session path display\",\n\t},\n\t\"app.session.toggleSort\": {\n\t\tdefaultKeys: \"ctrl+s\",\n\t\tdescription: \"Toggle session sort mode\",\n\t},\n\t\"app.session.rename\": {\n\t\tdefaultKeys: \"ctrl+r\",\n\t\tdescription: \"Rename session\",\n\t},\n\t\"app.session.delete\": {\n\t\tdefaultKeys: \"ctrl+d\",\n\t\tdescription: \"Delete session\",\n\t},\n\t\"app.session.deleteNoninvasive\": {\n\t\tdefaultKeys: \"ctrl+backspace\",\n\t\tdescription: \"Delete session when query is empty\",\n\t},\n\t\"app.models.save\": {\n\t\tdefaultKeys: \"ctrl+s\",\n\t\tdescription: \"Save model selection\",\n\t},\n\t\"app.models.enableAll\": {\n\t\tdefaultKeys: \"ctrl+a\",\n\t\tdescription: \"Enable all models\",\n\t},\n\t\"app.models.clearAll\": {\n\t\tdefaultKeys: \"ctrl+x\",\n\t\tdescription: \"Clear all models\",\n\t},\n\t\"app.models.toggleProvider\": {\n\t\tdefaultKeys: \"ctrl+p\",\n\t\tdescription: \"Toggle all models for provider\",\n\t},\n\t\"app.models.reorderUp\": {\n\t\tdefaultKeys: \"alt+up\",\n\t\tdescription: \"Move model up in order\",\n\t},\n\t\"app.models.reorderDown\": {\n\t\tdefaultKeys: \"alt+down\",\n\t\tdescription: \"Move model down in order\",\n\t},\n\t\"app.tree.filter.default\": {\n\t\tdefaultKeys: \"ctrl+d\",\n\t\tdescription: \"Tree filter: default view\",\n\t},\n\t\"app.tree.filter.noTools\": {\n\t\tdefaultKeys: \"ctrl+t\",\n\t\tdescription: \"Tree filter: hide tool results\",\n\t},\n\t\"app.tree.filter.userOnly\": {\n\t\tdefaultKeys: \"ctrl+u\",\n\t\tdescription: \"Tree filter: user messages only\",\n\t},\n\t\"app.tree.filter.labeledOnly\": {\n\t\tdefaultKeys: \"ctrl+l\",\n\t\tdescription: \"Tree filter: labeled entries only\",\n\t},\n\t\"app.tree.filter.all\": {\n\t\tdefaultKeys: \"ctrl+a\",\n\t\tdescription: \"Tree filter: show all entries\",\n\t},\n\t\"app.tree.filter.cycleForward\": {\n\t\tdefaultKeys: \"ctrl+o\",\n\t\tdescription: \"Tree filter: cycle forward\",\n\t},\n\t\"app.tree.filter.cycleBackward\": {\n\t\tdefaultKeys: \"shift+ctrl+o\",\n\t\tdescription: \"Tree filter: cycle backward\",\n\t},\n} as const satisfies KeybindingDefinitions;\n\nexport type AppKeybinding = keyof typeof APP_KEYBINDINGS;\nexport type AppKeybindings = { [K in AppKeybinding]: true };\n\ndeclare module \"@earendil-works/pi-tui\" {\n\tinterface Keybindings extends AppKeybindings {}\n}\n\nexport const KEYBINDINGS = {\n\t...TUI_KEYBINDINGS,\n\t\"tui.editor.undo\": {\n\t\t...TUI_KEYBINDINGS[\"tui.editor.undo\"],\n\t\tdefaultKeys: process.platform === \"win32\" ? \"ctrl+z\" : windowsKeybindings ? \"alt+z\" : \"ctrl+-\",\n\t},\n\t\"tui.altScreen.previousPrompt\": {\n\t\t...TUI_KEYBINDINGS[\"tui.altScreen.previousPrompt\"],\n\t\tdefaultKeys: windowsKeybindings ? \"ctrl+up\" : [\"ctrl+shift+up\", \"ctrl+up\"],\n\t},\n\t\"tui.altScreen.nextPrompt\": {\n\t\t...TUI_KEYBINDINGS[\"tui.altScreen.nextPrompt\"],\n\t\tdefaultKeys: windowsKeybindings ? \"ctrl+down\" : [\"ctrl+shift+down\", \"ctrl+down\"],\n\t},\n\t\"tui.altScreen.search\": {\n\t\t...TUI_KEYBINDINGS[\"tui.altScreen.search\"],\n\t\tdefaultKeys: windowsKeybindings ? \"ctrl+f\" : \"ctrl+shift+f\",\n\t},\n\t...APP_KEYBINDINGS,\n} as const satisfies KeybindingDefinitions;\n\nconst KEYBINDING_NAME_MIGRATIONS = {\n\tcursorUp: \"tui.editor.cursorUp\",\n\tcursorDown: \"tui.editor.cursorDown\",\n\tcursorLeft: \"tui.editor.cursorLeft\",\n\tcursorRight: \"tui.editor.cursorRight\",\n\tcursorWordLeft: \"tui.editor.cursorWordLeft\",\n\tcursorWordRight: \"tui.editor.cursorWordRight\",\n\tcursorLineStart: \"tui.editor.cursorLineStart\",\n\tcursorLineEnd: \"tui.editor.cursorLineEnd\",\n\tjumpForward: \"tui.editor.jumpForward\",\n\tjumpBackward: \"tui.editor.jumpBackward\",\n\tpageUp: \"tui.editor.pageUp\",\n\tpageDown: \"tui.editor.pageDown\",\n\tdeleteCharBackward: \"tui.editor.deleteCharBackward\",\n\tdeleteCharForward: \"tui.editor.deleteCharForward\",\n\tdeleteWordBackward: \"tui.editor.deleteWordBackward\",\n\tdeleteWordForward: \"tui.editor.deleteWordForward\",\n\tdeleteToLineStart: \"tui.editor.deleteToLineStart\",\n\tdeleteToLineEnd: \"tui.editor.deleteToLineEnd\",\n\tyank: \"tui.editor.yank\",\n\tyankPop: \"tui.editor.yankPop\",\n\tundo: \"tui.editor.undo\",\n\tnewLine: \"tui.input.newLine\",\n\tsubmit: \"tui.input.submit\",\n\ttab: \"tui.input.tab\",\n\tcopy: \"tui.input.copy\",\n\tselectUp: \"tui.select.up\",\n\tselectDown: \"tui.select.down\",\n\tselectPageUp: \"tui.select.pageUp\",\n\tselectPageDown: \"tui.select.pageDown\",\n\tselectConfirm: \"tui.select.confirm\",\n\tselectCancel: \"tui.select.cancel\",\n\tinterrupt: \"app.interrupt\",\n\tclear: \"app.clear\",\n\texit: \"app.exit\",\n\tsuspend: \"app.suspend\",\n\tcycleThinkingLevel: \"app.thinking.cycle\",\n\tcycleModelForward: \"app.model.cycleForward\",\n\tcycleModelBackward: \"app.model.cycleBackward\",\n\tselectModel: \"app.model.select\",\n\texpandTools: \"app.tools.expand\",\n\ttoggleThinking: \"app.thinking.toggle\",\n\ttoggleSessionNamedFilter: \"app.session.toggleNamedFilter\",\n\texternalEditor: \"app.editor.external\",\n\tfollowUp: \"app.message.followUp\",\n\tdequeue: \"app.message.dequeue\",\n\tpasteImage: \"app.clipboard.pasteImage\",\n\tnewSession: \"app.session.new\",\n\ttree: \"app.session.tree\",\n\tfork: \"app.session.fork\",\n\tresume: \"app.session.resume\",\n\ttreeFoldOrUp: \"app.tree.foldOrUp\",\n\ttreeUnfoldOrDown: \"app.tree.unfoldOrDown\",\n\ttreeEditLabel: \"app.tree.editLabel\",\n\ttreeToggleLabelTimestamp: \"app.tree.toggleLabelTimestamp\",\n\ttoggleSessionPath: \"app.session.togglePath\",\n\ttoggleSessionSort: \"app.session.toggleSort\",\n\trenameSession: \"app.session.rename\",\n\tdeleteSession: \"app.session.delete\",\n\tdeleteSessionNoninvasive: \"app.session.deleteNoninvasive\",\n} as const satisfies Record<string, Keybinding>;\n\nfunction isLegacyKeybindingName(key: string): key is keyof typeof KEYBINDING_NAME_MIGRATIONS {\n\treturn key in KEYBINDING_NAME_MIGRATIONS;\n}\n\nconst validateKeybindingValue = Compile(KeybindingValueSchema);\n\nfunction toKeybindingsConfig(value: Record<string, unknown>): KeybindingsConfig {\n\tconst config: KeybindingsConfig = {};\n\tfor (const [key, binding] of Object.entries(value)) {\n\t\tif (key === \"$schema\") continue;\n\t\tif (validateKeybindingValue.Check(binding)) config[key] = binding;\n\t}\n\treturn config;\n}\n\nexport function migrateKeybindingsConfig(rawConfig: Record<string, unknown>): {\n\tconfig: Record<string, unknown>;\n\tmigrated: boolean;\n} {\n\tconst config: Record<string, unknown> = {};\n\tlet migrated = false;\n\n\tfor (const [key, value] of Object.entries(rawConfig)) {\n\t\tconst nextKey = isLegacyKeybindingName(key) ? KEYBINDING_NAME_MIGRATIONS[key] : key;\n\t\tif (nextKey !== key) {\n\t\t\tmigrated = true;\n\t\t}\n\t\tif (key !== nextKey && Object.hasOwn(rawConfig, nextKey)) {\n\t\t\tmigrated = true;\n\t\t\tcontinue;\n\t\t}\n\t\tconfig[nextKey] = value;\n\t}\n\n\treturn { config: orderKeybindingsConfig(config), migrated };\n}\n\nfunction orderKeybindingsConfig(config: Record<string, unknown>): Record<string, unknown> {\n\tconst ordered: Record<string, unknown> = {};\n\tfor (const keybinding of Object.keys(KEYBINDINGS)) {\n\t\tif (Object.hasOwn(config, keybinding)) {\n\t\t\tordered[keybinding] = config[keybinding];\n\t\t}\n\t}\n\n\tconst extras = Object.keys(config)\n\t\t.filter((key) => !Object.hasOwn(ordered, key))\n\t\t.sort();\n\tfor (const key of extras) {\n\t\tordered[key] = config[key];\n\t}\n\n\treturn ordered;\n}\n\nfunction loadRawConfig(path: string): Record<string, unknown> | undefined {\n\tif (!existsSync(path)) return undefined;\n\ttry {\n\t\tconst parsed = JSON.parse(stripBom(readFileSync(path, \"utf-8\"))) as unknown;\n\t\tif (typeof parsed !== \"object\" || parsed === null) return undefined;\n\t\treturn parsed as Record<string, unknown>;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nexport class KeybindingsManager extends TuiKeybindingsManager {\n\tprivate configPath: string | undefined;\n\n\tconstructor(userBindings: KeybindingsConfig = {}, configPath?: string) {\n\t\tsuper(KEYBINDINGS, userBindings);\n\t\tthis.configPath = configPath;\n\t}\n\n\tstatic create(agentDir: string = getAgentDir()): KeybindingsManager {\n\t\tconst configPath = join(agentDir, \"keybindings.json\");\n\t\tconst userBindings = KeybindingsManager.loadFromFile(configPath);\n\t\treturn new KeybindingsManager(userBindings, configPath);\n\t}\n\n\treload(): void {\n\t\tif (!this.configPath) return;\n\t\tthis.setUserBindings(KeybindingsManager.loadFromFile(this.configPath));\n\t}\n\n\tgetEffectiveConfig(): KeybindingsConfig {\n\t\treturn this.getResolvedBindings();\n\t}\n\n\tprivate static loadFromFile(path: string): KeybindingsConfig {\n\t\tconst rawConfig = loadRawConfig(path);\n\t\tif (!rawConfig) return {};\n\t\treturn toKeybindingsConfig(migrateKeybindingsConfig(rawConfig).config);\n\t}\n}\n\nexport type { Keybinding, KeyId, KeybindingsConfig };\n"]}

package/dist/core/mcp-servers.d.ts

@@ -0,0 +1,121 @@
+/**
+ * MCP server configuration and the servers extensions register with `pi.registerMcpServer()`.
+ *
+ * The core only validates and stores registrations. The MCP extension (built in, or another
+ * extension that handles `mcp_servers_change`) connects them next to the servers from `mcp.json`.
+ * The `mcpServers` shape itself (stdio and HTTP fields, `oauth`, `enabled`, `description`, `timeout`)
+ * is pi-mcp's; this file adds pi's fields to it.
+ */
+import { type McpHttpServerConfig as McpHttpServerFields, type McpOAuthConfig as McpOAuthFields, type McpStdioServerConfig as McpStdioServerFields } from "@earendil-works/pi-mcp";
+/** Whether a tool name matches any of the entries, each an exact name or a pattern. */
+export declare function createToolNameMatcher(entries: readonly string[]): (name: string) => boolean;
+/** MCP resource tools, which reach every server with resources. */
+export declare const LIST_MCP_RESOURCES_TOOL = "list_mcp_resources";
+export declare const LIST_MCP_RESOURCE_TEMPLATES_TOOL = "list_mcp_resource_templates";
+export declare const READ_MCP_RESOURCE_TOOL = "read_mcp_resource";
+/** Whether a tool comes from MCP: a server tool (`mcp__<server>__<tool>`) or a resource tool. */
+export declare function isMcpToolName(name: string): boolean;
+/**
+ * - `codemode`: tools are callable from codemode scripts but neither declared to the model nor
+ *   listed in the codemode description, which lists only the server's namespace. Scripts find them
+ *   with `searchTools()`. `codemode-deferred` is accepted as an alias.
+ * - `deferred`: not declared to the model until the `tool_search` tool loads them; the model then
+ *   calls them directly. Does not need codemode.
+ * - `direct`: tools are declared to the model like any other tool (and callable from codemode).
+ * - `hidden`: tools are registered but unreachable.
+ */
+export type McpExposure = "codemode" | "deferred" | "direct" | "hidden";
+/**
+ * pi's fields of every server entry, beside the shared `mcpServers` fields of pi-mcp. `description`
+ * and `timeout` are shared fields, declared again for pi's documentation.
+ */
+interface McpServerConfigBase {
+    /** Default: `codemode`. */
+    exposure?: McpExposure;
+    /**
+     * What the server offers, in a sentence. The `mcp_servers` system prompt section lists the server
+     * with it, tool search ranks the server's tools by it, and codemode's `describeNamespace()` returns it.
+     */
+    description?: string;
+    /**
+     * Exposure of single tools, overriding `exposure`. Keys are tool names as the server offers them,
+     * or patterns where `*` matches any characters. An exact name wins over patterns; among patterns
+     * the first match in the object wins. `hidden` removes tools, so `"exposure": "hidden"` with
+     * overrides for a few tools exposes only those.
+     */
+    toolExposure?: Record<string, McpExposure>;
+    /** Per-request timeout in seconds. Progress notifications from the server reset it. Default: 60. */
+    timeout?: number;
+}
+export interface McpStdioServerConfig extends McpStdioServerFields, McpServerConfigBase {
+    /** Values may reference environment variables (`${NAME}`) or commands (`!cmd`). */
+    env?: Record<string, string>;
+    /** Relative paths resolve against the session working directory. */
+    cwd?: string;
+}
+/** OAuth client settings for servers that do not support dynamic client registration. */
+export interface McpOAuthConfig extends McpOAuthFields {
+    /** May reference environment variables (`${NAME}`) or commands (`!cmd`). */
+    clientSecret?: string;
+    /**
+     * `client_name` sent with dynamic client registration, for servers that only accept known clients.
+     * Default: `pi`.
+     */
+    clientName?: string;
+    /**
+     * How pi identifies itself without `clientId`. `auto` (default): pi's Client ID Metadata Document on
+     * pi.dev when the authorization server supports it for public clients, otherwise dynamic client
+     * registration; with `clientName` or a `callbackUrl` other than `/callback` on localhost or 127.0.0.1,
+     * always dynamic client registration. `cimd`: always the document, and sign-in fails without support.
+     * `dcr`: always dynamic client registration.
+     */
+    clientRegistration?: "auto" | "dcr" | "cimd";
+}
+/**
+ * Whether pi's Client ID Metadata Documents list a redirect URI for the loopback `callbackUrl`: they list
+ * `/callback` on localhost and 127.0.0.1, on any port. Without `callbackUrl`, pi uses such a URI.
+ */
+export declare function isClientMetadataDocumentCallback(callbackUrl: string | undefined): boolean;
+export interface McpHttpServerConfig extends McpHttpServerFields, McpServerConfigBase {
+    /** Values may reference environment variables (`${NAME}`) or commands (`!cmd`). */
+    headers?: Record<string, string>;
+    oauth?: McpOAuthConfig;
+    /**
+     * Send the token of a pi provider (`/login <provider>`) instead of using OAuth. Not allowed in project
+     * `mcp.json` files, and requires https except on loopback hosts, since it sends the credential to `url`.
+     */
+    auth?: {
+        provider: string;
+    };
+}
+export type McpServerConfig = McpStdioServerConfig | McpHttpServerConfig;
+/** Exposure of one tool of a server: its `toolExposure` entry, else the server's `exposure`. */
+export declare function getMcpToolExposure(config: McpServerConfig, toolName: string): McpExposure;
+/**
+ * Validate one server entry of the `mcpServers` shape: pi-mcp's shared fields and pi's own. Returns a
+ * copy of the config with exposure aliases resolved, or an error message.
+ */
+export declare function validateMcpServerConfig(name: string, raw: unknown): McpServerConfig | string;
+/** A server an extension registered with `pi.registerMcpServer()`. */
+export interface RegisteredMcpServer {
+    name: string;
+    config: McpServerConfig;
+    /** Path of the extension that registered the server. */
+    extensionPath: string;
+}
+/** Servers registered by the extensions of one runtime. */
+export declare class McpServerRegistry {
+    private readonly servers;
+    private changeListener;
+    /** Register or replace a server. The caller checks ownership. */
+    register(server: RegisteredMcpServer): void;
+    /** Remove a server registered by `extensionPath`. Servers of other extensions are left alone. */
+    unregister(name: string, extensionPath: string): void;
+    get(name: string): RegisteredMcpServer | undefined;
+    /** Copies of the registered servers, in registration order. */
+    list(): RegisteredMcpServer[];
+    /** Called after every change. The runner sets it when it binds, to emit `mcp_servers_change`. */
+    setChangeListener(listener: (() => void) | undefined): void;
+}
+export {};
+//# sourceMappingURL=mcp-servers.d.ts.map

package/dist/core/mcp-servers.d.ts.map

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

package/dist/core/mcp-servers.js

@@ -0,0 +1,163 @@
+/**
+ * MCP server configuration and the servers extensions register with `pi.registerMcpServer()`.
+ *
+ * The core only validates and stores registrations. The MCP extension (built in, or another
+ * extension that handles `mcp_servers_change`) connects them next to the servers from `mcp.json`.
+ * The `mcpServers` shape itself (stdio and HTTP fields, `oauth`, `enabled`, `description`, `timeout`)
+ * is pi-mcp's; this file adds pi's fields to it.
+ */
+import { validateMcpServerConfig as validateMcpServerFields, } from "@earendil-works/pi-mcp";
+/**
+ * Regular expression for a tool name pattern where `*` matches any characters, as `toolExposure`,
+ * `--tools`, and `--exclude-tools` accept them.
+ */
+function toolPatternRegExp(pattern) {
+    const source = pattern
+        .split("*")
+        .map((part) => part.replace(/[.+?^${}()|[\]\\]/g, "\\$&"))
+        .join(".*");
+    return new RegExp(`^${source}$`);
+}
+/** Whether a tool name matches any of the entries, each an exact name or a pattern. */
+export function createToolNameMatcher(entries) {
+    const names = new Set(entries.filter((entry) => !entry.includes("*")));
+    const patterns = entries.filter((entry) => entry.includes("*")).map(toolPatternRegExp);
+    return (name) => names.has(name) || patterns.some((pattern) => pattern.test(name));
+}
+/** MCP resource tools, which reach every server with resources. */
+export const LIST_MCP_RESOURCES_TOOL = "list_mcp_resources";
+export const LIST_MCP_RESOURCE_TEMPLATES_TOOL = "list_mcp_resource_templates";
+export const READ_MCP_RESOURCE_TOOL = "read_mcp_resource";
+const MCP_RESOURCE_TOOLS = new Set([
+    LIST_MCP_RESOURCES_TOOL,
+    LIST_MCP_RESOURCE_TEMPLATES_TOOL,
+    READ_MCP_RESOURCE_TOOL,
+]);
+/** Whether a tool comes from MCP: a server tool (`mcp__<server>__<tool>`) or a resource tool. */
+export function isMcpToolName(name) {
+    return name.startsWith("mcp__") || MCP_RESOURCE_TOOLS.has(name);
+}
+const MCP_EXPOSURES = ["codemode", "deferred", "direct", "hidden"];
+/** Older exposure names, accepted in configs and replaced by their current name when validated. */
+const MCP_EXPOSURE_ALIASES = { "codemode-deferred": "codemode" };
+/**
+ * Whether pi's Client ID Metadata Documents list a redirect URI for the loopback `callbackUrl`: they list
+ * `/callback` on localhost and 127.0.0.1, on any port. Without `callbackUrl`, pi uses such a URI.
+ */
+export function isClientMetadataDocumentCallback(callbackUrl) {
+    if (callbackUrl === undefined)
+        return true;
+    const url = new URL(callbackUrl);
+    return url.hostname !== "[::1]" && url.pathname === "/callback";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isExposure(value) {
+    return typeof value === "string" && MCP_EXPOSURES.includes(value);
+}
+/** The exposure an alias stands for; other values are returned unchanged. */
+function resolveExposureAlias(value) {
+    return typeof value === "string" ? (MCP_EXPOSURE_ALIASES[value] ?? value) : value;
+}
+/** A copy of the server entry with exposure aliases replaced by their current names. */
+function resolveExposureAliases(value) {
+    const { exposure, toolExposure } = value;
+    const resolved = { ...value };
+    if (exposure !== undefined)
+        resolved.exposure = resolveExposureAlias(exposure);
+    if (isRecord(toolExposure)) {
+        resolved.toolExposure = Object.fromEntries(Object.entries(toolExposure).map(([tool, entry]) => [tool, resolveExposureAlias(entry)]));
+    }
+    return resolved;
+}
+/** Exposure of one tool of a server: its `toolExposure` entry, else the server's `exposure`. */
+export function getMcpToolExposure(config, toolName) {
+    const overrides = config.toolExposure ?? {};
+    const exact = overrides[toolName];
+    if (exact !== undefined)
+        return exact;
+    for (const [pattern, exposure] of Object.entries(overrides)) {
+        if (pattern.includes("*") && toolPatternRegExp(pattern).test(toolName))
+            return exposure;
+    }
+    return config.exposure ?? "codemode";
+}
+/** Checks `exposure` and `toolExposure`, after aliases were resolved. Returns an error message. */
+function checkExposures(entry) {
+    const { exposure, toolExposure } = entry;
+    const exposures = MCP_EXPOSURES.map((value) => `"${value}"`).join(", ");
+    if (exposure !== undefined && !isExposure(exposure))
+        return `exposure must be one of ${exposures}`;
+    if (toolExposure !== undefined) {
+        if (!isRecord(toolExposure))
+            return "toolExposure must map tool names to exposures";
+        for (const [tool, value] of Object.entries(toolExposure)) {
+            if (!isExposure(value))
+                return `toolExposure "${tool}" must be one of ${exposures}`;
+        }
+    }
+    return undefined;
+}
+const LOOPBACK_HOSTS = ["localhost", "127.0.0.1", "[::1]"];
+/** Checks `auth` of an HTTP server, which sends a provider's credential to `url`. Returns an error message. */
+function checkAuth(auth, url) {
+    if (auth === undefined)
+        return undefined;
+    if (!isRecord(auth) || typeof auth.provider !== "string" || !auth.provider) {
+        return "auth.provider must be a provider name";
+    }
+    const parsed = new URL(url);
+    if (parsed.protocol !== "https:" && !LOOPBACK_HOSTS.includes(parsed.hostname)) {
+        return "auth requires an https URL, or http on localhost, 127.0.0.1, or [::1]";
+    }
+    return undefined;
+}
+/**
+ * Validate one server entry of the `mcpServers` shape: pi-mcp's shared fields and pi's own. Returns a
+ * copy of the config with exposure aliases resolved, or an error message.
+ */
+export function validateMcpServerConfig(name, raw) {
+    const result = validateMcpServerFields(name, isRecord(raw) ? resolveExposureAliases(raw) : raw, {
+        checkMetadataDocumentCallback: (callbackUrl) => isClientMetadataDocumentCallback(callbackUrl)
+            ? undefined
+            : 'oauth.clientRegistration "cimd" requires oauth.callbackUrl on localhost or 127.0.0.1 with path /callback',
+    });
+    if (result.kind === "invalid")
+        return result.error;
+    const error = checkExposures(result.config) ??
+        (result.kind === "http" ? checkAuth(result.config.auth, result.config.url) : undefined);
+    if (error)
+        return `server "${name}": ${error}`;
+    // The cast holds because pi's fields were checked above, which the types cannot express.
+    return result.config;
+}
+/** Servers registered by the extensions of one runtime. */
+export class McpServerRegistry {
+    servers = new Map();
+    changeListener;
+    /** Register or replace a server. The caller checks ownership. */
+    register(server) {
+        this.servers.set(server.name, server);
+        this.changeListener?.();
+    }
+    /** Remove a server registered by `extensionPath`. Servers of other extensions are left alone. */
+    unregister(name, extensionPath) {
+        if (this.servers.get(name)?.extensionPath !== extensionPath)
+            return;
+        this.servers.delete(name);
+        this.changeListener?.();
+    }
+    get(name) {
+        return this.servers.get(name);
+    }
+    /** Copies of the registered servers, in registration order. */
+    list() {
+        return [...this.servers.values()].map((server) => ({ ...server, config: structuredClone(server.config) }));
+    }
+    /** Called after every change. The runner sets it when it binds, to emit `mcp_servers_change`. */
+    setChangeListener(listener) {
+        this.changeListener = listener;
+    }
+}
+//# sourceMappingURL=mcp-servers.js.map