@schovest/pi-coding-agent 0.7.3

package/dist/core/command-palette/command-palette-component.js

@@ -0,0 +1,86 @@
+import { Container, Input, Spacer } from "@schovest/pi-tui";
+import { DynamicBorder } from "../../modes/interactive/components/dynamic-border.js";
+import { CommandPaletteList } from "./command-palette-list.js";
+export class CommandPaletteComponent extends Container {
+    _focused = false;
+    filteredItems = [];
+    searchInput;
+    list;
+    registry;
+    keybindings;
+    callbacks;
+    terminal;
+    maxHeightPercent;
+    /** Non-list children for chrome measurement */
+    chromeChildren;
+    constructor(registry, keybindings, callbacks, terminal, maxHeightPercent = 50) {
+        super();
+        this.registry = registry;
+        this.keybindings = keybindings;
+        this.callbacks = callbacks;
+        this.terminal = terminal;
+        this.maxHeightPercent = maxHeightPercent;
+        this.searchInput = new Input();
+        this.list = new CommandPaletteList();
+        this.filteredItems = registry.getAll();
+        this.list.setItems(this.filteredItems);
+        const topBorder = new DynamicBorder();
+        const topSpacer = new Spacer(1);
+        const bottomSpacer = new Spacer(1);
+        const bottomBorder = new DynamicBorder();
+        this.chromeChildren = [topBorder, this.searchInput, topSpacer, bottomSpacer, bottomBorder];
+        this.addChild(topBorder);
+        this.addChild(this.searchInput);
+        this.addChild(topSpacer);
+        this.addChild(this.list);
+        this.addChild(bottomSpacer);
+        this.addChild(bottomBorder);
+    }
+    render(width) {
+        const maxOverlayHeight = Math.floor((this.terminal.rows * this.maxHeightPercent) / 100);
+        let chromeLines = 0;
+        for (const child of this.chromeChildren) {
+            chromeLines += child.render(width).length;
+        }
+        const listMaxVisible = Math.max(1, maxOverlayHeight - chromeLines);
+        this.list.setMaxVisible(listMaxVisible);
+        return super.render(width);
+    }
+    get focused() {
+        return this._focused;
+    }
+    set focused(value) {
+        this._focused = value;
+        this.searchInput.focused = value;
+    }
+    handleInput(keyData) {
+        if (this.keybindings.matches(keyData, "tui.select.up")) {
+            this.list.moveUp();
+            return true;
+        }
+        if (this.keybindings.matches(keyData, "tui.select.down")) {
+            this.list.moveDown();
+            return true;
+        }
+        if (this.keybindings.matches(keyData, "tui.select.confirm")) {
+            const selected = this.list.getSelectedItem();
+            if (selected) {
+                this.callbacks.onSelect(selected);
+            }
+            return true;
+        }
+        if (this.keybindings.matches(keyData, "tui.select.cancel")) {
+            this.callbacks.onCancel();
+            return true;
+        }
+        this.searchInput.handleInput(keyData);
+        this.filterItems();
+        return false;
+    }
+    filterItems() {
+        const query = this.searchInput.getValue();
+        this.filteredItems = this.registry.search(query);
+        this.list.setItems(this.filteredItems);
+    }
+}
+//# sourceMappingURL=command-palette-component.js.map

package/dist/core/command-palette/command-palette-component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-palette-component.js","sourceRoot":"","sources":["../../../src/core/command-palette/command-palette-component.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Focusable, Terminal } from \"@schovest/pi-tui\";\nimport { Container, Input, type KeybindingsManager, Spacer } from \"@schovest/pi-tui\";\nimport { DynamicBorder } from \"../../modes/interactive/components/dynamic-border.ts\";\nimport { CommandPaletteList } from \"./command-palette-list.ts\";\nimport type { CommandRegistry } from \"./command-registry.ts\";\nimport type { CommandPaletteCallbacks, CommandPaletteItem } from \"./types.ts\";\n\nexport class CommandPaletteComponent extends Container implements Focusable {\n\tprivate _focused = false;\n\tprivate filteredItems: CommandPaletteItem[] = [];\n\tprivate searchInput: Input;\n\tprivate list: CommandPaletteList;\n\tprivate registry: CommandRegistry;\n\tprivate keybindings: KeybindingsManager;\n\tprivate callbacks: CommandPaletteCallbacks;\n\tprivate terminal: Terminal;\n\tprivate maxHeightPercent: number;\n\n\t/** Non-list children for chrome measurement */\n\tprivate chromeChildren: Array<{ render: (width: number) => string[] }>;\n\n\tconstructor(\n\t\tregistry: CommandRegistry,\n\t\tkeybindings: KeybindingsManager,\n\t\tcallbacks: CommandPaletteCallbacks,\n\t\tterminal: Terminal,\n\t\tmaxHeightPercent: number = 50,\n\t) {\n\t\tsuper();\n\t\tthis.registry = registry;\n\t\tthis.keybindings = keybindings;\n\t\tthis.callbacks = callbacks;\n\t\tthis.terminal = terminal;\n\t\tthis.maxHeightPercent = maxHeightPercent;\n\n\t\tthis.searchInput = new Input();\n\t\tthis.list = new CommandPaletteList();\n\n\t\tthis.filteredItems = registry.getAll();\n\t\tthis.list.setItems(this.filteredItems);\n\n\t\tconst topBorder = new DynamicBorder();\n\t\tconst topSpacer = new Spacer(1);\n\t\tconst bottomSpacer = new Spacer(1);\n\t\tconst bottomBorder = new DynamicBorder();\n\n\t\tthis.chromeChildren = [topBorder, this.searchInput, topSpacer, bottomSpacer, bottomBorder];\n\n\t\tthis.addChild(topBorder);\n\t\tthis.addChild(this.searchInput);\n\t\tthis.addChild(topSpacer);\n\t\tthis.addChild(this.list);\n\t\tthis.addChild(bottomSpacer);\n\t\tthis.addChild(bottomBorder);\n\t}\n\n\trender(width: number): string[] {\n\t\tconst maxOverlayHeight = Math.floor((this.terminal.rows * this.maxHeightPercent) / 100);\n\t\tlet chromeLines = 0;\n\t\tfor (const child of this.chromeChildren) {\n\t\t\tchromeLines += child.render(width).length;\n\t\t}\n\t\tconst listMaxVisible = Math.max(1, maxOverlayHeight - chromeLines);\n\t\tthis.list.setMaxVisible(listMaxVisible);\n\t\treturn super.render(width);\n\t}\n\n\tget focused(): boolean {\n\t\treturn this._focused;\n\t}\n\n\tset focused(value: boolean) {\n\t\tthis._focused = value;\n\t\tthis.searchInput.focused = value;\n\t}\n\n\thandleInput(keyData: string): boolean {\n\t\tif (this.keybindings.matches(keyData, \"tui.select.up\")) {\n\t\t\tthis.list.moveUp();\n\t\t\treturn true;\n\t\t}\n\t\tif (this.keybindings.matches(keyData, \"tui.select.down\")) {\n\t\t\tthis.list.moveDown();\n\t\t\treturn true;\n\t\t}\n\t\tif (this.keybindings.matches(keyData, \"tui.select.confirm\")) {\n\t\t\tconst selected = this.list.getSelectedItem();\n\t\t\tif (selected) {\n\t\t\t\tthis.callbacks.onSelect(selected);\n\t\t\t}\n\t\t\treturn true;\n\t\t}\n\t\tif (this.keybindings.matches(keyData, \"tui.select.cancel\")) {\n\t\t\tthis.callbacks.onCancel();\n\t\t\treturn true;\n\t\t}\n\n\t\tthis.searchInput.handleInput(keyData);\n\t\tthis.filterItems();\n\t\treturn false;\n\t}\n\n\tprivate filterItems(): void {\n\t\tconst query = this.searchInput.getValue();\n\t\tthis.filteredItems = this.registry.search(query);\n\t\tthis.list.setItems(this.filteredItems);\n\t}\n}\n"]}

package/dist/core/command-palette/command-palette-list.d.ts

@@ -0,0 +1,16 @@
+import type { Component } from "@schovest/pi-tui";
+import type { CommandPaletteItem } from "./types.ts";
+export declare class CommandPaletteList implements Component {
+    private items;
+    private selectedIndex;
+    private maxVisible;
+    setMaxVisible(maxVisible: number): void;
+    setItems(items: CommandPaletteItem[]): void;
+    getSelectedItem(): CommandPaletteItem | null;
+    moveUp(): void;
+    moveDown(): void;
+    invalidate(): void;
+    render(_width: number): string[];
+    private renderItem;
+}
+//# sourceMappingURL=command-palette-list.d.ts.map

package/dist/core/command-palette/command-palette-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-palette-list.d.ts","sourceRoot":"","sources":["../../../src/core/command-palette/command-palette-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIrD,qBAAa,kBAAmB,YAAW,SAAS;IACnD,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAA+B;IAEjD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAEtC;IAED,QAAQ,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAG1C;IAED,eAAe,IAAI,kBAAkB,GAAG,IAAI,CAE3C;IAED,MAAM,IAAI,IAAI,CAGb;IAED,QAAQ,IAAI,IAAI,CAGf;IAED,UAAU,IAAI,IAAI,CAAG;IAErB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA4B/B;IAED,OAAO,CAAC,UAAU;CAOlB","sourcesContent":["import type { Component } from \"@schovest/pi-tui\";\nimport { theme } from \"../../modes/interactive/theme/theme.ts\";\nimport type { CommandPaletteItem } from \"./types.ts\";\n\nconst DEFAULT_MAX_VISIBLE = 10;\n\nexport class CommandPaletteList implements Component {\n\tprivate items: CommandPaletteItem[] = [];\n\tprivate selectedIndex = 0;\n\tprivate maxVisible: number = DEFAULT_MAX_VISIBLE;\n\n\tsetMaxVisible(maxVisible: number): void {\n\t\tthis.maxVisible = maxVisible;\n\t}\n\n\tsetItems(items: CommandPaletteItem[]): void {\n\t\tthis.items = items;\n\t\tthis.selectedIndex = Math.min(this.selectedIndex, Math.max(0, items.length - 1));\n\t}\n\n\tgetSelectedItem(): CommandPaletteItem | null {\n\t\treturn this.items[this.selectedIndex] ?? null;\n\t}\n\n\tmoveUp(): void {\n\t\tif (this.items.length === 0) return;\n\t\tthis.selectedIndex = this.selectedIndex > 0 ? this.selectedIndex - 1 : this.items.length - 1;\n\t}\n\n\tmoveDown(): void {\n\t\tif (this.items.length === 0) return;\n\t\tthis.selectedIndex = this.selectedIndex < this.items.length - 1 ? this.selectedIndex + 1 : 0;\n\t}\n\n\tinvalidate(): void {}\n\n\trender(_width: number): string[] {\n\t\tif (this.items.length === 0) {\n\t\t\treturn [theme.fg(\"muted\", \"  No matching commands\")];\n\t\t}\n\n\t\tconst lines: string[] = [];\n\t\tconst visible = Math.min(this.maxVisible, this.items.length);\n\n\t\t// Centered scroll: keep selected item centered in view\n\t\tconst startIndex = Math.max(\n\t\t\t0,\n\t\t\tMath.min(this.selectedIndex - Math.floor(visible / 2), this.items.length - visible),\n\t\t);\n\t\tconst endIndex = Math.min(startIndex + visible, this.items.length);\n\n\t\tfor (let i = startIndex; i < endIndex; i++) {\n\t\t\tconst item = this.items[i];\n\t\t\tif (!item) continue;\n\t\t\tconst isSelected = i === this.selectedIndex;\n\t\t\tlines.push(this.renderItem(item, isSelected));\n\t\t}\n\n\t\tif (startIndex > 0 || endIndex < this.items.length) {\n\t\t\tconst info = theme.fg(\"muted\", `  ${this.selectedIndex + 1}/${this.items.length}`);\n\t\t\tlines.push(info);\n\t\t}\n\n\t\treturn lines;\n\t}\n\n\tprivate renderItem(item: CommandPaletteItem, isSelected: boolean): string {\n\t\tconst prefix = isSelected ? theme.fg(\"accent\", \"▸ \") : \"  \";\n\t\tconst labelText = isSelected ? theme.fg(\"accent\", item.label) : item.label;\n\t\tconst desc = item.description ? theme.fg(\"muted\", item.description) : \"\";\n\t\tconst keyHint = item.keybinding ? theme.fg(\"muted\", item.keybinding) : \"\";\n\t\treturn `${prefix}${labelText}  ${desc}${keyHint ? `  ${keyHint}` : \"\"}`;\n\t}\n}\n"]}

package/dist/core/command-palette/command-palette-list.js

@@ -0,0 +1,58 @@
+import { theme } from "../../modes/interactive/theme/theme.js";
+const DEFAULT_MAX_VISIBLE = 10;
+export class CommandPaletteList {
+    items = [];
+    selectedIndex = 0;
+    maxVisible = DEFAULT_MAX_VISIBLE;
+    setMaxVisible(maxVisible) {
+        this.maxVisible = maxVisible;
+    }
+    setItems(items) {
+        this.items = items;
+        this.selectedIndex = Math.min(this.selectedIndex, Math.max(0, items.length - 1));
+    }
+    getSelectedItem() {
+        return this.items[this.selectedIndex] ?? null;
+    }
+    moveUp() {
+        if (this.items.length === 0)
+            return;
+        this.selectedIndex = this.selectedIndex > 0 ? this.selectedIndex - 1 : this.items.length - 1;
+    }
+    moveDown() {
+        if (this.items.length === 0)
+            return;
+        this.selectedIndex = this.selectedIndex < this.items.length - 1 ? this.selectedIndex + 1 : 0;
+    }
+    invalidate() { }
+    render(_width) {
+        if (this.items.length === 0) {
+            return [theme.fg("muted", "  No matching commands")];
+        }
+        const lines = [];
+        const visible = Math.min(this.maxVisible, this.items.length);
+        // Centered scroll: keep selected item centered in view
+        const startIndex = Math.max(0, Math.min(this.selectedIndex - Math.floor(visible / 2), this.items.length - visible));
+        const endIndex = Math.min(startIndex + visible, this.items.length);
+        for (let i = startIndex; i < endIndex; i++) {
+            const item = this.items[i];
+            if (!item)
+                continue;
+            const isSelected = i === this.selectedIndex;
+            lines.push(this.renderItem(item, isSelected));
+        }
+        if (startIndex > 0 || endIndex < this.items.length) {
+            const info = theme.fg("muted", `  ${this.selectedIndex + 1}/${this.items.length}`);
+            lines.push(info);
+        }
+        return lines;
+    }
+    renderItem(item, isSelected) {
+        const prefix = isSelected ? theme.fg("accent", "▸ ") : "  ";
+        const labelText = isSelected ? theme.fg("accent", item.label) : item.label;
+        const desc = item.description ? theme.fg("muted", item.description) : "";
+        const keyHint = item.keybinding ? theme.fg("muted", item.keybinding) : "";
+        return `${prefix}${labelText}  ${desc}${keyHint ? `  ${keyHint}` : ""}`;
+    }
+}
+//# sourceMappingURL=command-palette-list.js.map

package/dist/core/command-palette/command-palette-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-palette-list.js","sourceRoot":"","sources":["../../../src/core/command-palette/command-palette-list.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Component } from \"@schovest/pi-tui\";\nimport { theme } from \"../../modes/interactive/theme/theme.ts\";\nimport type { CommandPaletteItem } from \"./types.ts\";\n\nconst DEFAULT_MAX_VISIBLE = 10;\n\nexport class CommandPaletteList implements Component {\n\tprivate items: CommandPaletteItem[] = [];\n\tprivate selectedIndex = 0;\n\tprivate maxVisible: number = DEFAULT_MAX_VISIBLE;\n\n\tsetMaxVisible(maxVisible: number): void {\n\t\tthis.maxVisible = maxVisible;\n\t}\n\n\tsetItems(items: CommandPaletteItem[]): void {\n\t\tthis.items = items;\n\t\tthis.selectedIndex = Math.min(this.selectedIndex, Math.max(0, items.length - 1));\n\t}\n\n\tgetSelectedItem(): CommandPaletteItem | null {\n\t\treturn this.items[this.selectedIndex] ?? null;\n\t}\n\n\tmoveUp(): void {\n\t\tif (this.items.length === 0) return;\n\t\tthis.selectedIndex = this.selectedIndex > 0 ? this.selectedIndex - 1 : this.items.length - 1;\n\t}\n\n\tmoveDown(): void {\n\t\tif (this.items.length === 0) return;\n\t\tthis.selectedIndex = this.selectedIndex < this.items.length - 1 ? this.selectedIndex + 1 : 0;\n\t}\n\n\tinvalidate(): void {}\n\n\trender(_width: number): string[] {\n\t\tif (this.items.length === 0) {\n\t\t\treturn [theme.fg(\"muted\", \"  No matching commands\")];\n\t\t}\n\n\t\tconst lines: string[] = [];\n\t\tconst visible = Math.min(this.maxVisible, this.items.length);\n\n\t\t// Centered scroll: keep selected item centered in view\n\t\tconst startIndex = Math.max(\n\t\t\t0,\n\t\t\tMath.min(this.selectedIndex - Math.floor(visible / 2), this.items.length - visible),\n\t\t);\n\t\tconst endIndex = Math.min(startIndex + visible, this.items.length);\n\n\t\tfor (let i = startIndex; i < endIndex; i++) {\n\t\t\tconst item = this.items[i];\n\t\t\tif (!item) continue;\n\t\t\tconst isSelected = i === this.selectedIndex;\n\t\t\tlines.push(this.renderItem(item, isSelected));\n\t\t}\n\n\t\tif (startIndex > 0 || endIndex < this.items.length) {\n\t\t\tconst info = theme.fg(\"muted\", `  ${this.selectedIndex + 1}/${this.items.length}`);\n\t\t\tlines.push(info);\n\t\t}\n\n\t\treturn lines;\n\t}\n\n\tprivate renderItem(item: CommandPaletteItem, isSelected: boolean): string {\n\t\tconst prefix = isSelected ? theme.fg(\"accent\", \"▸ \") : \"  \";\n\t\tconst labelText = isSelected ? theme.fg(\"accent\", item.label) : item.label;\n\t\tconst desc = item.description ? theme.fg(\"muted\", item.description) : \"\";\n\t\tconst keyHint = item.keybinding ? theme.fg(\"muted\", item.keybinding) : \"\";\n\t\treturn `${prefix}${labelText}  ${desc}${keyHint ? `  ${keyHint}` : \"\"}`;\n\t}\n}\n"]}

package/dist/core/command-palette/command-registry.d.ts

@@ -0,0 +1,9 @@
+import type { CommandPaletteItem } from "./types.ts";
+export declare class CommandRegistry {
+    private items;
+    register(item: CommandPaletteItem): void;
+    unregister(id: string): void;
+    getAll(): CommandPaletteItem[];
+    search(query: string): CommandPaletteItem[];
+}
+//# sourceMappingURL=command-registry.d.ts.map

package/dist/core/command-palette/command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../../src/core/command-palette/command-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,qBAAa,eAAe;IAC3B,OAAO,CAAC,KAAK,CAAyC;IAEtD,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAEvC;IAED,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE3B;IAED,MAAM,IAAI,kBAAkB,EAAE,CAM7B;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAS1C;CACD","sourcesContent":["import { fuzzyFilter } from \"@schovest/pi-tui\";\nimport type { CommandPaletteItem } from \"./types.ts\";\n\nexport class CommandRegistry {\n\tprivate items = new Map<string, CommandPaletteItem>();\n\n\tregister(item: CommandPaletteItem): void {\n\t\tthis.items.set(item.id, item);\n\t}\n\n\tunregister(id: string): void {\n\t\tthis.items.delete(id);\n\t}\n\n\tgetAll(): CommandPaletteItem[] {\n\t\treturn [...this.items.values()].filter((item) => {\n\t\t\tif (item.visible === undefined) return true;\n\t\t\tif (typeof item.visible === \"function\") return item.visible();\n\t\t\treturn item.visible;\n\t\t});\n\t}\n\n\tsearch(query: string): CommandPaletteItem[] {\n\t\tconst all = this.getAll();\n\t\tif (!query) return all;\n\t\treturn fuzzyFilter(\n\t\t\tall,\n\t\t\tquery,\n\t\t\t(item) =>\n\t\t\t\t`${item.label} ${item.description ?? \"\"} ${(item.keywords ?? []).join(\" \")} ${item.keybinding ?? \"\"}`,\n\t\t);\n\t}\n}\n"]}

package/dist/core/command-palette/command-registry.js

@@ -0,0 +1,26 @@
+import { fuzzyFilter } from "@schovest/pi-tui";
+export class CommandRegistry {
+    items = new Map();
+    register(item) {
+        this.items.set(item.id, item);
+    }
+    unregister(id) {
+        this.items.delete(id);
+    }
+    getAll() {
+        return [...this.items.values()].filter((item) => {
+            if (item.visible === undefined)
+                return true;
+            if (typeof item.visible === "function")
+                return item.visible();
+            return item.visible;
+        });
+    }
+    search(query) {
+        const all = this.getAll();
+        if (!query)
+            return all;
+        return fuzzyFilter(all, query, (item) => `${item.label} ${item.description ?? ""} ${(item.keywords ?? []).join(" ")} ${item.keybinding ?? ""}`);
+    }
+}
+//# sourceMappingURL=command-registry.js.map

package/dist/core/command-palette/command-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../../../src/core/command-palette/command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,MAAM,OAAO,eAAe;IACnB,KAAK,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEtD,QAAQ,CAAC,IAAwB,EAAQ;QACxC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAAA,CAC9B;IAED,UAAU,CAAC,EAAU,EAAQ;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAAA,CACtB;IAED,MAAM,GAAyB;QAC9B,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YAC5C,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU;gBAAE,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9D,OAAO,IAAI,CAAC,OAAO,CAAC;QAAA,CACpB,CAAC,CAAC;IAAA,CACH;IAED,MAAM,CAAC,KAAa,EAAwB;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK;YAAE,OAAO,GAAG,CAAC;QACvB,OAAO,WAAW,CACjB,GAAG,EACH,KAAK,EACL,CAAC,IAAI,EAAE,EAAE,CACR,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,CACtG,CAAC;IAAA,CACF;CACD","sourcesContent":["import { fuzzyFilter } from \"@schovest/pi-tui\";\nimport type { CommandPaletteItem } from \"./types.ts\";\n\nexport class CommandRegistry {\n\tprivate items = new Map<string, CommandPaletteItem>();\n\n\tregister(item: CommandPaletteItem): void {\n\t\tthis.items.set(item.id, item);\n\t}\n\n\tunregister(id: string): void {\n\t\tthis.items.delete(id);\n\t}\n\n\tgetAll(): CommandPaletteItem[] {\n\t\treturn [...this.items.values()].filter((item) => {\n\t\t\tif (item.visible === undefined) return true;\n\t\t\tif (typeof item.visible === \"function\") return item.visible();\n\t\t\treturn item.visible;\n\t\t});\n\t}\n\n\tsearch(query: string): CommandPaletteItem[] {\n\t\tconst all = this.getAll();\n\t\tif (!query) return all;\n\t\treturn fuzzyFilter(\n\t\t\tall,\n\t\t\tquery,\n\t\t\t(item) =>\n\t\t\t\t`${item.label} ${item.description ?? \"\"} ${(item.keywords ?? []).join(\" \")} ${item.keybinding ?? \"\"}`,\n\t\t);\n\t}\n}\n"]}

package/dist/core/command-palette/index.d.ts

@@ -0,0 +1,4 @@
+export { CommandPaletteComponent } from "./command-palette-component.ts";
+export { CommandRegistry } from "./command-registry.ts";
+export type { CommandCategory, CommandPaletteCallbacks, CommandPaletteItem } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/command-palette/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/command-palette/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { CommandPaletteComponent } from \"./command-palette-component.ts\";\nexport { CommandRegistry } from \"./command-registry.ts\";\nexport type { CommandCategory, CommandPaletteCallbacks, CommandPaletteItem } from \"./types.ts\";\n"]}

package/dist/core/command-palette/index.js

@@ -0,0 +1,3 @@
+export { CommandPaletteComponent } from "./command-palette-component.js";
+export { CommandRegistry } from "./command-registry.js";
+//# sourceMappingURL=index.js.map

package/dist/core/command-palette/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/command-palette/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["export { CommandPaletteComponent } from \"./command-palette-component.ts\";\nexport { CommandRegistry } from \"./command-registry.ts\";\nexport type { CommandCategory, CommandPaletteCallbacks, CommandPaletteItem } from \"./types.ts\";\n"]}

package/dist/core/command-palette/types.d.ts

@@ -0,0 +1,17 @@
+import type { KeyId } from "@schovest/pi-tui";
+export type CommandCategory = "navigation" | "model" | "session" | "settings" | "tools" | "slash" | "extension" | "skill";
+export interface CommandPaletteItem {
+    id: string;
+    label: string;
+    description?: string;
+    category: CommandCategory;
+    keywords?: string[];
+    keybinding?: KeyId;
+    handler: () => void | Promise<void>;
+    visible?: boolean | (() => boolean);
+}
+export interface CommandPaletteCallbacks {
+    onSelect: (item: CommandPaletteItem) => void;
+    onCancel: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/command-palette/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/command-palette/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,MAAM,eAAe,GACxB,YAAY,GACZ,OAAO,GACP,SAAS,GACT,UAAU,GACV,OAAO,GACP,OAAO,GACP,WAAW,GACX,OAAO,CAAC;AAEX,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC7C,QAAQ,EAAE,MAAM,IAAI,CAAC;CACrB","sourcesContent":["import type { KeyId } from \"@schovest/pi-tui\";\n\nexport type CommandCategory =\n\t| \"navigation\"\n\t| \"model\"\n\t| \"session\"\n\t| \"settings\"\n\t| \"tools\"\n\t| \"slash\"\n\t| \"extension\"\n\t| \"skill\";\n\nexport interface CommandPaletteItem {\n\tid: string;\n\tlabel: string;\n\tdescription?: string;\n\tcategory: CommandCategory;\n\tkeywords?: string[];\n\tkeybinding?: KeyId;\n\thandler: () => void | Promise<void>;\n\tvisible?: boolean | (() => boolean);\n}\n\nexport interface CommandPaletteCallbacks {\n\tonSelect: (item: CommandPaletteItem) => void;\n\tonCancel: () => void;\n}\n"]}

package/dist/core/command-palette/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/command-palette/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/command-palette/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { KeyId } from \"@schovest/pi-tui\";\n\nexport type CommandCategory =\n\t| \"navigation\"\n\t| \"model\"\n\t| \"session\"\n\t| \"settings\"\n\t| \"tools\"\n\t| \"slash\"\n\t| \"extension\"\n\t| \"skill\";\n\nexport interface CommandPaletteItem {\n\tid: string;\n\tlabel: string;\n\tdescription?: string;\n\tcategory: CommandCategory;\n\tkeywords?: string[];\n\tkeybinding?: KeyId;\n\thandler: () => void | Promise<void>;\n\tvisible?: boolean | (() => boolean);\n}\n\nexport interface CommandPaletteCallbacks {\n\tonSelect: (item: CommandPaletteItem) => void;\n\tonCancel: () => void;\n}\n"]}

package/dist/core/compaction/branch-summarization.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Branch summarization for tree navigation.
+ *
+ * When navigating to a different point in the session tree, this generates
+ * a summary of the branch being left so context isn't lost.
+ */
+import type { AgentMessage, StreamFn } from "@schovest/pi-agent-core";
+import type { Model } from "@schovest/pi-ai";
+import type { ReadonlySessionManager, SessionEntry } from "../session-manager.ts";
+import { type FileOperations } from "./utils.ts";
+export interface BranchSummaryResult {
+    summary?: string;
+    readFiles?: string[];
+    modifiedFiles?: string[];
+    aborted?: boolean;
+    error?: string;
+}
+/** Details stored in BranchSummaryEntry.details for file tracking */
+export interface BranchSummaryDetails {
+    readFiles: string[];
+    modifiedFiles: string[];
+}
+export type { FileOperations } from "./utils.ts";
+export interface BranchPreparation {
+    /** Messages extracted for summarization, in chronological order */
+    messages: AgentMessage[];
+    /** File operations extracted from tool calls */
+    fileOps: FileOperations;
+    /** Total estimated tokens in messages */
+    totalTokens: number;
+}
+export interface CollectEntriesResult {
+    /** Entries to summarize, in chronological order */
+    entries: SessionEntry[];
+    /** Common ancestor between old and new position, if any */
+    commonAncestorId: string | null;
+}
+export interface GenerateBranchSummaryOptions {
+    /** Model to use for summarization */
+    model: Model<any>;
+    /** API key for the model */
+    apiKey: string;
+    /** Request headers for the model */
+    headers?: Record<string, string>;
+    /** Abort signal for cancellation */
+    signal: AbortSignal;
+    /** Optional custom instructions for summarization */
+    customInstructions?: string;
+    /** If true, customInstructions replaces the default prompt instead of being appended */
+    replaceInstructions?: boolean;
+    /** Tokens reserved for prompt + LLM response (default 16384) */
+    reserveTokens?: number;
+    /** Optional session stream function. Used to preserve SDK request behavior without mutating agent state. */
+    streamFn?: StreamFn;
+}
+/**
+ * Collect entries that should be summarized when navigating from one position to another.
+ *
+ * Walks from oldLeafId back to the common ancestor with targetId, collecting entries
+ * along the way. Does NOT stop at compaction boundaries - those are included and their
+ * summaries become context.
+ *
+ * @param session - Session manager (read-only access)
+ * @param oldLeafId - Current position (where we're navigating from)
+ * @param targetId - Target position (where we're navigating to)
+ * @returns Entries to summarize and the common ancestor
+ */
+export declare function collectEntriesForBranchSummary(session: ReadonlySessionManager, oldLeafId: string | null, targetId: string): CollectEntriesResult;
+/**
+ * Prepare entries for summarization with token budget.
+ *
+ * Walks entries from NEWEST to OLDEST, adding messages until we hit the token budget.
+ * This ensures we keep the most recent context when the branch is too long.
+ *
+ * Also collects file operations from:
+ * - Tool calls in assistant messages
+ * - Existing branch_summary entries' details (for cumulative tracking)
+ *
+ * @param entries - Entries in chronological order
+ * @param tokenBudget - Maximum tokens to include (0 = no limit)
+ */
+export declare function prepareBranchEntries(entries: SessionEntry[], tokenBudget?: number): BranchPreparation;
+/**
+ * Generate a summary of abandoned branch entries.
+ *
+ * @param entries - Session entries to summarize (chronological order)
+ * @param options - Generation options
+ */
+export declare function generateBranchSummary(entries: SessionEntry[], options: GenerateBranchSummaryOptions): Promise<BranchSummaryResult>;
+//# sourceMappingURL=branch-summarization.d.ts.map

package/dist/core/compaction/branch-summarization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-summarization.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/branch-summarization.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAuB,MAAM,iBAAiB,CAAC;AAQlE,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAIN,KAAK,cAAc,EAInB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,mBAAmB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IACjC,mEAAmE;IACnE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,gDAAgD;IAChD,OAAO,EAAE,cAAc,CAAC;IACxB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACpC,mDAAmD;IACnD,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,4BAA4B;IAC5C,qCAAqC;IACrC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oCAAoC;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,qDAAqD;IACrD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wFAAwF;IACxF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4GAA4G;IAC5G,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACpB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,sBAAsB,EAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,MAAM,GACd,oBAAoB,CAkCtB;AAqCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,WAAW,GAAE,MAAU,GAAG,iBAAiB,CAoDxG;AAwCD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,4BAA4B,GACnC,OAAO,CAAC,mBAAmB,CAAC,CAgF9B","sourcesContent":["/**\n * Branch summarization for tree navigation.\n *\n * When navigating to a different point in the session tree, this generates\n * a summary of the branch being left so context isn't lost.\n */\n\nimport type { AgentMessage, StreamFn } from \"@schovest/pi-agent-core\";\nimport type { Model, SimpleStreamOptions } from \"@schovest/pi-ai\";\nimport { completeSimple } from \"@schovest/pi-ai\";\nimport {\n\tconvertToLlm,\n\tcreateBranchSummaryMessage,\n\tcreateCompactionSummaryMessage,\n\tcreateCustomMessage,\n} from \"../messages.ts\";\nimport type { ReadonlySessionManager, SessionEntry } from \"../session-manager.ts\";\nimport { estimateTokens } from \"./compaction.ts\";\nimport {\n\tcomputeFileLists,\n\tcreateFileOps,\n\textractFileOpsFromMessage,\n\ttype FileOperations,\n\tformatFileOperations,\n\tSUMMARIZATION_SYSTEM_PROMPT,\n\tserializeConversation,\n} from \"./utils.ts\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface BranchSummaryResult {\n\tsummary?: string;\n\treadFiles?: string[];\n\tmodifiedFiles?: string[];\n\taborted?: boolean;\n\terror?: string;\n}\n\n/** Details stored in BranchSummaryEntry.details for file tracking */\nexport interface BranchSummaryDetails {\n\treadFiles: string[];\n\tmodifiedFiles: string[];\n}\n\nexport type { FileOperations } from \"./utils.ts\";\n\nexport interface BranchPreparation {\n\t/** Messages extracted for summarization, in chronological order */\n\tmessages: AgentMessage[];\n\t/** File operations extracted from tool calls */\n\tfileOps: FileOperations;\n\t/** Total estimated tokens in messages */\n\ttotalTokens: number;\n}\n\nexport interface CollectEntriesResult {\n\t/** Entries to summarize, in chronological order */\n\tentries: SessionEntry[];\n\t/** Common ancestor between old and new position, if any */\n\tcommonAncestorId: string | null;\n}\n\nexport interface GenerateBranchSummaryOptions {\n\t/** Model to use for summarization */\n\tmodel: Model<any>;\n\t/** API key for the model */\n\tapiKey: string;\n\t/** Request headers for the model */\n\theaders?: Record<string, string>;\n\t/** Abort signal for cancellation */\n\tsignal: AbortSignal;\n\t/** Optional custom instructions for summarization */\n\tcustomInstructions?: string;\n\t/** If true, customInstructions replaces the default prompt instead of being appended */\n\treplaceInstructions?: boolean;\n\t/** Tokens reserved for prompt + LLM response (default 16384) */\n\treserveTokens?: number;\n\t/** Optional session stream function. Used to preserve SDK request behavior without mutating agent state. */\n\tstreamFn?: StreamFn;\n}\n\n// ============================================================================\n// Entry Collection\n// ============================================================================\n\n/**\n * Collect entries that should be summarized when navigating from one position to another.\n *\n * Walks from oldLeafId back to the common ancestor with targetId, collecting entries\n * along the way. Does NOT stop at compaction boundaries - those are included and their\n * summaries become context.\n *\n * @param session - Session manager (read-only access)\n * @param oldLeafId - Current position (where we're navigating from)\n * @param targetId - Target position (where we're navigating to)\n * @returns Entries to summarize and the common ancestor\n */\nexport function collectEntriesForBranchSummary(\n\tsession: ReadonlySessionManager,\n\toldLeafId: string | null,\n\ttargetId: string,\n): CollectEntriesResult {\n\t// If no old position, nothing to summarize\n\tif (!oldLeafId) {\n\t\treturn { entries: [], commonAncestorId: null };\n\t}\n\n\t// Find common ancestor (deepest node that's on both paths)\n\tconst oldPath = new Set(session.getBranch(oldLeafId).map((e) => e.id));\n\tconst targetPath = session.getBranch(targetId);\n\n\t// targetPath is root-first, so iterate backwards to find deepest common ancestor\n\tlet commonAncestorId: string | null = null;\n\tfor (let i = targetPath.length - 1; i >= 0; i--) {\n\t\tif (oldPath.has(targetPath[i].id)) {\n\t\t\tcommonAncestorId = targetPath[i].id;\n\t\t\tbreak;\n\t\t}\n\t}\n\n\t// Collect entries from old leaf back to common ancestor\n\tconst entries: SessionEntry[] = [];\n\tlet current: string | null = oldLeafId;\n\n\twhile (current && current !== commonAncestorId) {\n\t\tconst entry = session.getEntry(current);\n\t\tif (!entry) break;\n\t\tentries.push(entry);\n\t\tcurrent = entry.parentId;\n\t}\n\n\t// Reverse to get chronological order\n\tentries.reverse();\n\n\treturn { entries, commonAncestorId };\n}\n\n// ============================================================================\n// Entry to Message Conversion\n// ============================================================================\n\n/**\n * Extract AgentMessage from a session entry.\n * Similar to getMessageFromEntry in compaction.ts but also handles compaction entries.\n */\nfunction getMessageFromEntry(entry: SessionEntry): AgentMessage | undefined {\n\tswitch (entry.type) {\n\t\tcase \"message\":\n\t\t\t// Skip tool results - context is in assistant's tool call\n\t\t\tif (entry.message.role === \"toolResult\") return undefined;\n\t\t\treturn entry.message;\n\n\t\tcase \"custom_message\":\n\t\t\treturn createCustomMessage(entry.customType, entry.content, entry.display, entry.details, entry.timestamp);\n\n\t\tcase \"branch_summary\":\n\t\t\treturn createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp);\n\n\t\tcase \"compaction\":\n\t\t\treturn createCompactionSummaryMessage(entry.summary, entry.tokensBefore, entry.timestamp);\n\n\t\t// These don't contribute to conversation content\n\t\tcase \"thinking_level_change\":\n\t\tcase \"model_change\":\n\t\tcase \"custom\":\n\t\tcase \"label\":\n\t\tcase \"session_info\":\n\t\tcase \"subagent_run\":\n\t\t\treturn undefined;\n\t}\n}\n\n/**\n * Prepare entries for summarization with token budget.\n *\n * Walks entries from NEWEST to OLDEST, adding messages until we hit the token budget.\n * This ensures we keep the most recent context when the branch is too long.\n *\n * Also collects file operations from:\n * - Tool calls in assistant messages\n * - Existing branch_summary entries' details (for cumulative tracking)\n *\n * @param entries - Entries in chronological order\n * @param tokenBudget - Maximum tokens to include (0 = no limit)\n */\nexport function prepareBranchEntries(entries: SessionEntry[], tokenBudget: number = 0): BranchPreparation {\n\tconst messages: AgentMessage[] = [];\n\tconst fileOps = createFileOps();\n\tlet totalTokens = 0;\n\n\t// First pass: collect file ops from ALL entries (even if they don't fit in token budget)\n\t// This ensures we capture cumulative file tracking from nested branch summaries\n\t// Only extract from pi-generated summaries (fromHook !== true), not extension-generated ones\n\tfor (const entry of entries) {\n\t\tif (entry.type === \"branch_summary\" && !entry.fromHook && entry.details) {\n\t\t\tconst details = entry.details as BranchSummaryDetails;\n\t\t\tif (Array.isArray(details.readFiles)) {\n\t\t\t\tfor (const f of details.readFiles) fileOps.read.add(f);\n\t\t\t}\n\t\t\tif (Array.isArray(details.modifiedFiles)) {\n\t\t\t\t// Modified files go into both edited and written for proper deduplication\n\t\t\t\tfor (const f of details.modifiedFiles) {\n\t\t\t\t\tfileOps.edited.add(f);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Second pass: walk from newest to oldest, adding messages until token budget\n\tfor (let i = entries.length - 1; i >= 0; i--) {\n\t\tconst entry = entries[i];\n\t\tconst message = getMessageFromEntry(entry);\n\t\tif (!message) continue;\n\n\t\t// Extract file ops from assistant messages (tool calls)\n\t\textractFileOpsFromMessage(message, fileOps);\n\n\t\tconst tokens = estimateTokens(message);\n\n\t\t// Check budget before adding\n\t\tif (tokenBudget > 0 && totalTokens + tokens > tokenBudget) {\n\t\t\t// If this is a summary entry, try to fit it anyway as it's important context\n\t\t\tif (entry.type === \"compaction\" || entry.type === \"branch_summary\") {\n\t\t\t\tif (totalTokens < tokenBudget * 0.9) {\n\t\t\t\t\tmessages.unshift(message);\n\t\t\t\t\ttotalTokens += tokens;\n\t\t\t\t}\n\t\t\t}\n\t\t\t// Stop - we've hit the budget\n\t\t\tbreak;\n\t\t}\n\n\t\tmessages.unshift(message);\n\t\ttotalTokens += tokens;\n\t}\n\n\treturn { messages, fileOps, totalTokens };\n}\n\n// ============================================================================\n// Summary Generation\n// ============================================================================\n\nconst BRANCH_SUMMARY_PREAMBLE = `The user explored a different conversation branch before returning here.\nSummary of that exploration:\n\n`;\n\nconst BRANCH_SUMMARY_PROMPT = `Create a structured summary of this conversation branch for context when returning later.\n\nUse this EXACT format:\n\n## Goal\n[What was the user trying to accomplish in this branch?]\n\n## Constraints & Preferences\n- [Any constraints, preferences, or requirements mentioned]\n- [Or \"(none)\" if none were mentioned]\n\n## Progress\n### Done\n- [x] [Completed tasks/changes]\n\n### In Progress\n- [ ] [Work that was started but not finished]\n\n### Blocked\n- [Issues preventing progress, if any]\n\n## Key Decisions\n- **[Decision]**: [Brief rationale]\n\n## Next Steps\n1. [What should happen next to continue this work]\n\nKeep each section concise. Preserve exact file paths, function names, and error messages.`;\n\n/**\n * Generate a summary of abandoned branch entries.\n *\n * @param entries - Session entries to summarize (chronological order)\n * @param options - Generation options\n */\nexport async function generateBranchSummary(\n\tentries: SessionEntry[],\n\toptions: GenerateBranchSummaryOptions,\n): Promise<BranchSummaryResult> {\n\tconst {\n\t\tmodel,\n\t\tapiKey,\n\t\theaders,\n\t\tsignal,\n\t\tcustomInstructions,\n\t\treplaceInstructions,\n\t\treserveTokens = 16384,\n\t\tstreamFn,\n\t} = options;\n\n\t// Token budget = context window minus reserved space for prompt + response\n\tconst contextWindow = model.contextWindow || 128000;\n\tconst tokenBudget = contextWindow - reserveTokens;\n\n\tconst { messages, fileOps } = prepareBranchEntries(entries, tokenBudget);\n\n\tif (messages.length === 0) {\n\t\treturn { summary: \"No content to summarize\" };\n\t}\n\n\t// Transform to LLM-compatible messages, then serialize to text\n\t// Serialization prevents the model from treating it as a conversation to continue\n\tconst llmMessages = convertToLlm(messages);\n\tconst conversationText = serializeConversation(llmMessages);\n\n\t// Build prompt\n\tlet instructions: string;\n\tif (replaceInstructions && customInstructions) {\n\t\tinstructions = customInstructions;\n\t} else if (customInstructions) {\n\t\tinstructions = `${BRANCH_SUMMARY_PROMPT}\\n\\nAdditional focus: ${customInstructions}`;\n\t} else {\n\t\tinstructions = BRANCH_SUMMARY_PROMPT;\n\t}\n\tconst promptText = `<conversation>\\n${conversationText}\\n</conversation>\\n\\n${instructions}`;\n\n\tconst summarizationMessages = [\n\t\t{\n\t\t\trole: \"user\" as const,\n\t\t\tcontent: [{ type: \"text\" as const, text: promptText }],\n\t\t\ttimestamp: Date.now(),\n\t\t},\n\t];\n\n\t// Call LLM for summarization. Prefer the session stream function so SDK\n\t// request behavior (timeouts, retries, attribution headers) stays consistent\n\t// without running through agent state/events.\n\tconst context = { systemPrompt: SUMMARIZATION_SYSTEM_PROMPT, messages: summarizationMessages };\n\tconst requestOptions: SimpleStreamOptions = { apiKey, headers, signal, maxTokens: 2048 };\n\tconst response = streamFn\n\t\t? await (await streamFn(model, context, requestOptions)).result()\n\t\t: await completeSimple(model, context, requestOptions);\n\n\t// Check if aborted or errored\n\tif (response.stopReason === \"aborted\") {\n\t\treturn { aborted: true };\n\t}\n\tif (response.stopReason === \"error\") {\n\t\treturn { error: response.errorMessage || \"Summarization failed\" };\n\t}\n\n\tlet summary = response.content\n\t\t.filter((c): c is { type: \"text\"; text: string } => c.type === \"text\")\n\t\t.map((c) => c.text)\n\t\t.join(\"\\n\");\n\n\t// Prepend preamble to provide context about the branch summary\n\tsummary = BRANCH_SUMMARY_PREAMBLE + summary;\n\n\t// Compute file lists and append to summary\n\tconst { readFiles, modifiedFiles } = computeFileLists(fileOps);\n\tsummary += formatFileOperations(readFiles, modifiedFiles);\n\n\treturn {\n\t\tsummary: summary || \"No summary generated\",\n\t\treadFiles,\n\t\tmodifiedFiles,\n\t};\n}\n"]}