@ai-agent-forge/agent-forge 0.85.0

package/dist/core/keybindings.js

@@ -0,0 +1,329 @@
+import { TUI_KEYBINDINGS, KeybindingsManager as TuiKeybindingsManager, } from "@agent-forge/tui";
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { getAgentDir } from "../config.js";
+import { stripBom } from "../utils/text.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();
+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 message to clipboard",
+    },
+    "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.models.cancel": {
+        defaultKeys: "ctrl+c",
+        description: "Clear model search or cancel model selection",
+    },
+    "app.config.exit": {
+        defaultKeys: "ctrl+c",
+        description: "Exit the app from the config selector",
+    },
+    "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 isLegacyKeybindingName(key) {
+    return key in KEYBINDING_NAME_MIGRATIONS;
+}
+function toKeybindingsConfig(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 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 \"@agent-forge/tui\";\nimport { existsSync, readFileSync } from \"fs\";\nimport { join } from \"path\";\nimport { getAgentDir } from \"../config.ts\";\nimport { stripBom } from \"../utils/text.ts\";\n\nexport interface AppKeybindings {\n\t\"app.interrupt\": true;\n\t\"app.clear\": true;\n\t\"app.exit\": true;\n\t\"app.suspend\": true;\n\t\"app.thinking.cycle\": true;\n\t\"app.thinking.save\": true;\n\t\"app.model.cycleForward\": true;\n\t\"app.model.cycleBackward\": true;\n\t\"app.model.select\": true;\n\t\"app.tools.expand\": true;\n\t\"app.thinking.toggle\": true;\n\t\"app.session.toggleNamedFilter\": true;\n\t\"app.editor.external\": true;\n\t\"app.message.copy\": true;\n\t\"app.message.followUp\": true;\n\t\"app.message.dequeue\": true;\n\t\"app.clipboard.pasteImage\": true;\n\t\"app.config.exit\": true;\n\t\"app.session.new\": true;\n\t\"app.session.tree\": true;\n\t\"app.session.fork\": true;\n\t\"app.session.resume\": true;\n\t\"app.tree.foldOrUp\": true;\n\t\"app.tree.unfoldOrDown\": true;\n\t\"app.tree.editLabel\": true;\n\t\"app.tree.toggleLabelTimestamp\": true;\n\t\"app.session.togglePath\": true;\n\t\"app.session.toggleSort\": true;\n\t\"app.session.rename\": true;\n\t\"app.session.delete\": true;\n\t\"app.session.deleteNoninvasive\": true;\n\t\"app.models.save\": true;\n\t\"app.models.enableAll\": true;\n\t\"app.models.clearAll\": true;\n\t\"app.models.toggleProvider\": true;\n\t\"app.models.reorderUp\": true;\n\t\"app.models.reorderDown\": true;\n\t\"app.models.cancel\": true;\n\t\"app.tree.filter.default\": true;\n\t\"app.tree.filter.noTools\": true;\n\t\"app.tree.filter.userOnly\": true;\n\t\"app.tree.filter.labeledOnly\": true;\n\t\"app.tree.filter.all\": true;\n\t\"app.tree.filter.cycleForward\": true;\n\t\"app.tree.filter.cycleBackward\": true;\n}\n\nexport type AppKeybinding = keyof AppKeybindings;\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\ndeclare module \"@agent-forge/tui\" {\n\tinterface Keybindings extends AppKeybindings {}\n}\n\nconst windowsKeybindings = useWindowsKeybindings();\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.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 message to clipboard\",\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\",\n\t\tdescription: \"Paste image from clipboard (text fallback)\",\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.models.cancel\": {\n\t\tdefaultKeys: \"ctrl+c\",\n\t\tdescription: \"Clear model search or cancel model selection\",\n\t},\n\t\"app.config.exit\": {\n\t\tdefaultKeys: \"ctrl+c\",\n\t\tdescription: \"Exit the app from the config selector\",\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\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\nfunction toKeybindingsConfig(value: Record<string, unknown>): KeybindingsConfig {\n\tconst config: KeybindingsConfig = {};\n\tfor (const [key, binding] of Object.entries(value)) {\n\t\tif (typeof binding === \"string\") {\n\t\t\tconfig[key] = binding as KeyId;\n\t\t\tcontinue;\n\t\t}\n\t\tif (Array.isArray(binding) && binding.every((entry) => typeof entry === \"string\")) {\n\t\t\tconfig[key] = binding as KeyId[];\n\t\t}\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/logger.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Host-process logger: minimal kernel carrying-layer mechanism for runtime
+ * diagnostics (design `会话轨迹与日志设计.md` §5). One JSONL entry per line,
+ * written through with `appendFileSync` into `<dir>/<yyyy-mm-dd>-<pid>.log`
+ * (local date). The file is created lazily on the first written entry.
+ *
+ * Failure contract: logging must never throw. Level filtering drops entries
+ * below the configured level; write failures (disk full, permissions, bad dir)
+ * are swallowed and counted, and `close()` reports `{ written, failed }`.
+ * Expired log files are swept once at logger creation; sweep failures are
+ * recorded as a warn entry through the logger itself.
+ *
+ * Crash contract: registering `uncaughtException`/`unhandledRejection`
+ * listeners replaces Node's default fatal behavior, so the hooks restore it —
+ * one log line per fatal value, Node-default crash text on stderr, exit(1).
+ */
+export type HostLogLevel = "debug" | "info" | "warn" | "error";
+/** Per-entry call-site detail. All members optional; `undefined` members are omitted from the line. */
+export interface HostLogContext {
+    readonly sessionId?: string;
+    readonly traceId?: string;
+    readonly fields?: Record<string, unknown>;
+    readonly cause?: unknown;
+}
+/** One JSONL line in the host log file. */
+export interface HostLogEntry {
+    readonly v: 1;
+    /** Host timestamp (epoch ms). */
+    readonly t: number;
+    readonly level: HostLogLevel;
+    /** Call-site marker, e.g. "sdk", "compaction", "process". */
+    readonly src: string;
+    readonly msg: string;
+    readonly sessionId?: string;
+    readonly traceId?: string;
+    readonly fields?: Record<string, unknown>;
+    /** Bounded error facts (name/message + at most 10 stack lines, or safe JSON for non-Error values). */
+    readonly cause?: unknown;
+}
+export interface HostLoggerOptions {
+    /** Log directory. Created recursively on first write. */
+    readonly dir: string;
+    /**
+     * Minimum level to write; lower levels are dropped. Default "info". An
+     * invalid level fails construction (programmer error), never a silent
+     * fallback to a default.
+     */
+    readonly level?: HostLogLevel;
+    /** Startup sweep retention in days; `0` disables sweeping. Default 14. */
+    readonly maxAgeDays?: number;
+    /** Injected clock for deterministic tests. Default `Date.now`. */
+    readonly now?: () => number;
+    /**
+     * Injected process hooks to avoid attaching to the real process in tests.
+     * Members left unset default to the real process.
+     */
+    readonly processHost?: HostProcessHost;
+}
+/**
+ * Process-hook injection surface for the host logger. When the whole
+ * processHost is omitted it falls back to the real process: both fatal hooks
+ * are registered via `process.on`. With a processHost present, the two
+ * registrar members are opt-in: a member left unset means that fatal hook is
+ * NOT registered and there is no fallback to `process.on` — the process keeps
+ * Node's default fatal behavior for that hook. The crash-restore members
+ * (`exit`/`writeStderr`/`deferThrow`) fall back to the real process when
+ * omitted, so tests can inject captured fakes that never exit or throw.
+ */
+export interface HostProcessHost {
+    /**
+     * Registrar for fatal uncaught exceptions. Omitted = no hook is registered
+     * (no fallback to `process.on("uncaughtException", cb)`).
+     */
+    readonly onUncaughtException?: (cb: (error: unknown) => void) => void;
+    /**
+     * Registrar for fatal unhandled rejections. Omitted = no hook is registered
+     * (no fallback to `process.on("unhandledRejection", cb)`).
+     */
+    readonly onUnhandledRejection?: (cb: (reason: unknown) => void) => void;
+    /** Terminal exit. Omitted = falls back to the real `process.exit`. */
+    readonly exit?: (code: number) => void;
+    /** Crash-text sink. Omitted = falls back to the real `process.stderr.write`. */
+    readonly writeStderr?: (chunk: string) => void;
+    /**
+     * Defers the rejection rethrow so it surfaces as an uncaughtException.
+     * Omitted = falls back to the real `setImmediate(thrower)`.
+     */
+    readonly deferThrow?: (thrower: () => void) => void;
+}
+export interface HostLoggerCloseSummary {
+    readonly written: number;
+    readonly failed: number;
+}
+export interface HostLogger {
+    debug(src: string, msg: string, context?: HostLogContext): void;
+    info(src: string, msg: string, context?: HostLogContext): void;
+    warn(src: string, msg: string, context?: HostLogContext): void;
+    error(src: string, msg: string, context?: HostLogContext): void;
+    /**
+     * Stop logging. Idempotent; later log calls are no-ops. Registered process
+     * hooks stay attached: they stop writing log lines but still restore the
+     * crash semantics (stderr + exit). Returns the write tally.
+     */
+    close(): HostLoggerCloseSummary;
+}
+export declare function createHostLogger(options: HostLoggerOptions): HostLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { appendFileSync, mkdirSync, readdirSync, statSync, unlinkSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\n/**\n * Host-process logger: minimal kernel carrying-layer mechanism for runtime\n * diagnostics (design `会话轨迹与日志设计.md` §5). One JSONL entry per line,\n * written through with `appendFileSync` into `<dir>/<yyyy-mm-dd>-<pid>.log`\n * (local date). The file is created lazily on the first written entry.\n *\n * Failure contract: logging must never throw. Level filtering drops entries\n * below the configured level; write failures (disk full, permissions, bad dir)\n * are swallowed and counted, and `close()` reports `{ written, failed }`.\n * Expired log files are swept once at logger creation; sweep failures are\n * recorded as a warn entry through the logger itself.\n *\n * Crash contract: registering `uncaughtException`/`unhandledRejection`\n * listeners replaces Node's default fatal behavior, so the hooks restore it —\n * one log line per fatal value, Node-default crash text on stderr, exit(1).\n */\n\nexport type HostLogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nconst LEVEL_RANK: Record<HostLogLevel, number> = { debug: 0, info: 1, warn: 2, error: 3 };\n\n/** All valid host log levels; the construction-time level check runs against this list. */\nconst HOST_LOG_LEVELS: readonly HostLogLevel[] = [\"debug\", \"info\", \"warn\", \"error\"];\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\n/** Upper bound on retained stack lines for a logged cause. */\nconst MAX_STACK_LINES = 10;\n\n/** Default retention window for startup sweep, in days. `0` disables sweeping. */\nconst DEFAULT_MAX_AGE_DAYS = 14;\n\n/** Per-entry call-site detail. All members optional; `undefined` members are omitted from the line. */\nexport interface HostLogContext {\n\treadonly sessionId?: string;\n\treadonly traceId?: string;\n\treadonly fields?: Record<string, unknown>;\n\treadonly cause?: unknown;\n}\n\n/** One JSONL line in the host log file. */\nexport interface HostLogEntry {\n\treadonly v: 1;\n\t/** Host timestamp (epoch ms). */\n\treadonly t: number;\n\treadonly level: HostLogLevel;\n\t/** Call-site marker, e.g. \"sdk\", \"compaction\", \"process\". */\n\treadonly src: string;\n\treadonly msg: string;\n\treadonly sessionId?: string;\n\treadonly traceId?: string;\n\treadonly fields?: Record<string, unknown>;\n\t/** Bounded error facts (name/message + at most 10 stack lines, or safe JSON for non-Error values). */\n\treadonly cause?: unknown;\n}\n\nexport interface HostLoggerOptions {\n\t/** Log directory. Created recursively on first write. */\n\treadonly dir: string;\n\t/**\n\t * Minimum level to write; lower levels are dropped. Default \"info\". An\n\t * invalid level fails construction (programmer error), never a silent\n\t * fallback to a default.\n\t */\n\treadonly level?: HostLogLevel;\n\t/** Startup sweep retention in days; `0` disables sweeping. Default 14. */\n\treadonly maxAgeDays?: number;\n\t/** Injected clock for deterministic tests. Default `Date.now`. */\n\treadonly now?: () => number;\n\t/**\n\t * Injected process hooks to avoid attaching to the real process in tests.\n\t * Members left unset default to the real process.\n\t */\n\treadonly processHost?: HostProcessHost;\n}\n\n/**\n * Process-hook injection surface for the host logger. When the whole\n * processHost is omitted it falls back to the real process: both fatal hooks\n * are registered via `process.on`. With a processHost present, the two\n * registrar members are opt-in: a member left unset means that fatal hook is\n * NOT registered and there is no fallback to `process.on` — the process keeps\n * Node's default fatal behavior for that hook. The crash-restore members\n * (`exit`/`writeStderr`/`deferThrow`) fall back to the real process when\n * omitted, so tests can inject captured fakes that never exit or throw.\n */\nexport interface HostProcessHost {\n\t/**\n\t * Registrar for fatal uncaught exceptions. Omitted = no hook is registered\n\t * (no fallback to `process.on(\"uncaughtException\", cb)`).\n\t */\n\treadonly onUncaughtException?: (cb: (error: unknown) => void) => void;\n\t/**\n\t * Registrar for fatal unhandled rejections. Omitted = no hook is registered\n\t * (no fallback to `process.on(\"unhandledRejection\", cb)`).\n\t */\n\treadonly onUnhandledRejection?: (cb: (reason: unknown) => void) => void;\n\t/** Terminal exit. Omitted = falls back to the real `process.exit`. */\n\treadonly exit?: (code: number) => void;\n\t/** Crash-text sink. Omitted = falls back to the real `process.stderr.write`. */\n\treadonly writeStderr?: (chunk: string) => void;\n\t/**\n\t * Defers the rejection rethrow so it surfaces as an uncaughtException.\n\t * Omitted = falls back to the real `setImmediate(thrower)`.\n\t */\n\treadonly deferThrow?: (thrower: () => void) => void;\n}\n\nexport interface HostLoggerCloseSummary {\n\treadonly written: number;\n\treadonly failed: number;\n}\n\nexport interface HostLogger {\n\tdebug(src: string, msg: string, context?: HostLogContext): void;\n\tinfo(src: string, msg: string, context?: HostLogContext): void;\n\twarn(src: string, msg: string, context?: HostLogContext): void;\n\terror(src: string, msg: string, context?: HostLogContext): void;\n\t/**\n\t * Stop logging. Idempotent; later log calls are no-ops. Registered process\n\t * hooks stay attached: they stop writing log lines but still restore the\n\t * crash semantics (stderr + exit). Returns the write tally.\n\t */\n\tclose(): HostLoggerCloseSummary;\n}\n\n/** Real-process defaults for the crash-restore members; `Required` keeps resolved hooks callable. */\nconst NODE_PROCESS_CRASH_HOST: Required<Pick<HostProcessHost, \"exit\" | \"writeStderr\" | \"deferThrow\">> = {\n\texit(code) {\n\t\tprocess.exit(code);\n\t},\n\twriteStderr(chunk) {\n\t\tprocess.stderr.write(chunk);\n\t},\n\tdeferThrow(thrower) {\n\t\tsetImmediate(thrower);\n\t},\n};\n\nconst NODE_PROCESS_HOST: HostProcessHost = {\n\tonUncaughtException(cb) {\n\t\tprocess.on(\"uncaughtException\", cb);\n\t},\n\tonUnhandledRejection(cb) {\n\t\tprocess.on(\"unhandledRejection\", cb);\n\t},\n\t...NODE_PROCESS_CRASH_HOST,\n};\n\n/** Local-date file name for the given timestamp: `<yyyy-mm-dd>-<pid>.log`. */\nfunction logFileName(timestamp: number): string {\n\tconst date = new Date(timestamp);\n\tconst month = String(date.getMonth() + 1).padStart(2, \"0\");\n\tconst day = String(date.getDate()).padStart(2, \"0\");\n\treturn `${date.getFullYear()}-${month}-${day}-${process.pid}.log`;\n}\n\n/**\n * Convert an arbitrary value to JSON-safe data: cycles become \"[circular]\",\n * unserializable members become \"[unserializable]\", bigint/symbol/function are\n * stringified. Diamond references (same object in two places, no cycle) survive.\n */\nfunction toSafeJson(value: unknown): unknown {\n\tconst ancestors = new WeakSet<object>();\n\tconst walk = (input: unknown): unknown => {\n\t\tif (input === null || input === undefined) return null;\n\t\tconst kind = typeof input;\n\t\tif (kind === \"string\" || kind === \"boolean\" || kind === \"number\") return input;\n\t\tif (kind === \"bigint\") return `${String(input)}n`;\n\t\tif (kind === \"function\" || kind === \"symbol\") return \"[unserializable]\";\n\t\tconst obj = input as object;\n\t\tif (ancestors.has(obj)) return \"[circular]\";\n\t\tancestors.add(obj);\n\t\ttry {\n\t\t\tif (input instanceof Date) return input.toISOString();\n\t\t\tif (Array.isArray(input)) return input.map((item) => walk(item));\n\t\t\tconst out: Record<string, unknown> = {};\n\t\t\tfor (const [key, item] of Object.entries(input as Record<string, unknown>)) {\n\t\t\t\tout[key] = walk(item);\n\t\t\t}\n\t\t\treturn out;\n\t\t} catch {\n\t\t\treturn \"[unserializable]\";\n\t\t} finally {\n\t\t\tancestors.delete(obj);\n\t\t}\n\t};\n\treturn walk(value);\n}\n\nfunction boundedStack(stack: string | undefined): string | undefined {\n\tif (stack === undefined) return undefined;\n\tconst lines = stack.split(\"\\n\");\n\treturn lines.length <= MAX_STACK_LINES ? stack : lines.slice(0, MAX_STACK_LINES).join(\"\\n\");\n}\n\n/** Normalize a cause to bounded facts: Errors keep name/message + truncated stack, the rest become safe JSON. */\nfunction boundCause(cause: unknown): unknown {\n\tif (cause instanceof Error) {\n\t\treturn { name: cause.name, message: cause.message, stack: boundedStack(cause.stack) };\n\t}\n\treturn toSafeJson(cause);\n}\n\n/**\n * Node-default crash text for a fatal value: `name: message` plus the stack\n * for Errors (`err.stack` already opens with that header, so it is never\n * echoed twice), safe JSON for anything else.\n */\nfunction fatalStderrText(value: unknown): string {\n\tif (value instanceof Error) {\n\t\tconst header = `${value.name}: ${value.message}`;\n\t\tif (value.stack === undefined) return `${header}\\n`;\n\t\tconst body = value.stack.startsWith(`${header}\\n`) ? value.stack : `${header}\\n${value.stack}`;\n\t\treturn `${body}\\n`;\n\t}\n\treturn `${JSON.stringify(toSafeJson(value))}\\n`;\n}\n\nexport function createHostLogger(options: HostLoggerOptions): HostLogger {\n\t// 构造期校验（程序错误，非运行时降级）：非法 level 立即抛错，绝不静默回落\n\t// 默认级别——那会把配置错误伪装成\"日志变少了\"。\n\tif (options.level !== undefined && !HOST_LOG_LEVELS.includes(options.level)) {\n\t\tthrow new Error(\n\t\t\t`Host logger level must be one of ${HOST_LOG_LEVELS.map((level) => `\"${level}\"`).join(\" | \")}; got ${JSON.stringify(options.level)}`,\n\t\t);\n\t}\n\tconst minRank = LEVEL_RANK[options.level ?? \"info\"];\n\tconst now = options.now ?? Date.now;\n\tconst maxAgeDays = options.maxAgeDays ?? DEFAULT_MAX_AGE_DAYS;\n\tconst processHost = options.processHost ?? NODE_PROCESS_HOST;\n\n\tlet closed = false;\n\tlet dirReady = false;\n\tlet written = 0;\n\tlet failed = 0;\n\n\tconst write = (level: HostLogLevel, src: string, msg: string, context?: HostLogContext): void => {\n\t\tif (closed) return;\n\t\tif (LEVEL_RANK[level] < minRank) return;\n\t\tconst entry: HostLogEntry = {\n\t\t\tv: 1,\n\t\t\tt: now(),\n\t\t\tlevel,\n\t\t\tsrc,\n\t\t\tmsg,\n\t\t\tsessionId: context?.sessionId,\n\t\t\ttraceId: context?.traceId,\n\t\t\tfields: context?.fields === undefined ? undefined : (toSafeJson(context.fields) as Record<string, unknown>),\n\t\t\tcause: context?.cause === undefined ? undefined : boundCause(context.cause),\n\t\t};\n\t\ttry {\n\t\t\tif (!dirReady) {\n\t\t\t\tmkdirSync(options.dir, { recursive: true });\n\t\t\t\tdirReady = true;\n\t\t\t}\n\t\t\tappendFileSync(join(options.dir, logFileName(entry.t)), `${JSON.stringify(entry)}\\n`);\n\t\t\twritten += 1;\n\t\t} catch {\n\t\t\t// Never propagate write failures (disk full, permissions, dir is a file).\n\t\t\tfailed += 1;\n\t\t\tdirReady = false;\n\t\t}\n\t};\n\n\tconst sweep = (): void => {\n\t\tif (maxAgeDays <= 0) return;\n\t\tconst cutoff = now() - maxAgeDays * DAY_MS;\n\t\tconst currentName = logFileName(now());\n\t\tlet names: string[];\n\t\ttry {\n\t\t\tnames = readdirSync(options.dir);\n\t\t} catch (error) {\n\t\t\t// A missing directory means there is nothing to sweep; any other\n\t\t\t// read failure is a real fact and goes into the log itself.\n\t\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return;\n\t\t\twrite(\"warn\", \"logger\", \"log sweep failed: cannot read log directory\", { cause: error });\n\t\t\treturn;\n\t\t}\n\t\tlet removed = 0;\n\t\tlet errors = 0;\n\t\tfor (const name of names) {\n\t\t\tif (!name.endsWith(\".log\") || name === currentName) continue;\n\t\t\tconst fullPath = join(options.dir, name);\n\t\t\ttry {\n\t\t\t\tconst stats = statSync(fullPath);\n\t\t\t\tif (!stats.isFile() || stats.mtimeMs >= cutoff) continue;\n\t\t\t\tunlinkSync(fullPath);\n\t\t\t\tremoved += 1;\n\t\t\t} catch {\n\t\t\t\terrors += 1;\n\t\t\t}\n\t\t}\n\t\tif (errors > 0) {\n\t\t\twrite(\"warn\", \"logger\", \"log sweep finished with failures\", { fields: { removed, errors } });\n\t\t}\n\t};\n\n\tsweep();\n\n\t// Registering uncaughtException/unhandledRejection listeners replaces Node's\n\t// default crash behavior, so these hooks restore it: crash text on stderr\n\t// and exit(1). Without this, a non-interactive crash (print/RPC/serve)\n\t// would leave the process running and disguise the failure as success.\n\t//\n\t// Fatal-value dedup: a rejection reason rethrown below arrives a second time\n\t// as an uncaughtException; the WeakSet keeps the log line to one write while\n\t// stderr + exit still run on every pass.\n\t//\n\t// Interactive boundary: the TUI registers its own uncaughtException handler\n\t// via `prependListener` and exits(1) first, so the uncaughtException branch\n\t// never fires under interactive mode (TUI crashes stay out of the host\n\t// log); a rejection rethrow surfaces to that prepended handler instead.\n\t//\n\t// After close(): the log line is skipped but stderr + exit still run, so a\n\t// closed logger can never swallow a crash.\n\tconst exit = processHost.exit ?? NODE_PROCESS_CRASH_HOST.exit;\n\tconst writeStderr = processHost.writeStderr ?? NODE_PROCESS_CRASH_HOST.writeStderr;\n\tconst deferThrow = processHost.deferThrow ?? NODE_PROCESS_CRASH_HOST.deferThrow;\n\tconst loggedFatalValues = new WeakSet<object>();\n\tconst isFatalValueLogged = (value: unknown): boolean =>\n\t\tvalue !== null && (typeof value === \"object\" || typeof value === \"function\") && loggedFatalValues.has(value);\n\tconst markFatalValueLogged = (value: unknown): void => {\n\t\tif (value !== null && (typeof value === \"object\" || typeof value === \"function\")) loggedFatalValues.add(value);\n\t};\n\tif (processHost.onUncaughtException) {\n\t\tprocessHost.onUncaughtException((error) => {\n\t\t\tif (!isFatalValueLogged(error)) {\n\t\t\t\tmarkFatalValueLogged(error);\n\t\t\t\twrite(\"error\", \"process\", \"uncaughtException\", { cause: error });\n\t\t\t}\n\t\t\twriteStderr(fatalStderrText(error));\n\t\t\texit(1);\n\t\t});\n\t}\n\tif (processHost.onUnhandledRejection) {\n\t\tprocessHost.onUnhandledRejection((reason) => {\n\t\t\tmarkFatalValueLogged(reason);\n\t\t\twrite(\"error\", \"process\", \"unhandledRejection\", { cause: reason });\n\t\t\tdeferThrow(() => {\n\t\t\t\tthrow reason;\n\t\t\t});\n\t\t});\n\t}\n\n\treturn {\n\t\tdebug: (src, msg, context) => write(\"debug\", src, msg, context),\n\t\tinfo: (src, msg, context) => write(\"info\", src, msg, context),\n\t\twarn: (src, msg, context) => write(\"warn\", src, msg, context),\n\t\terror: (src, msg, context) => write(\"error\", src, msg, context),\n\t\tclose: () => {\n\t\t\tclosed = true;\n\t\t\treturn { written, failed };\n\t\t},\n\t};\n}\n"]}