bkper 4.28.1 → 4.29.0

package/README.md

@@ -194,6 +194,8 @@ When the selected model cannot read images, the agent briefly uses Bkper's defau
 
 Use `/handoff <goal>` to continue long-running work in a new focused session. If you omit the goal, the agent opens an empty goal editor. Pressing `Ctrl+H` opens that editor with your current input text as the goal. The new session is linked to the original, with the relevant context drafted in the input editor for you to adjust or submit.
 
+Press `Ctrl+R` in the standard or handoff input to fuzzy-search recently submitted inputs. Search history starts with inputs submitted after this feature is installed; it does not scan existing sessions. The handoff search omits Bash commands. Press `Ctrl+Alt+R` to open the session tree.
+
 Auto-handoff is enabled by default and offers a handoff shortly before context compaction. Auto-handoff and Auto-compact are independent and can each be turned on or off from `/settings`.
 
 ---

package/lib/agent/extensions/handoff-goal-editor.d.ts

@@ -1,4 +1,5 @@
 import { type AutocompleteProvider } from '@earendil-works/pi-tui';
+import type { PromptHistoryRepository } from '../interactive/prompt-history-store.js';
 export declare const HANDOFF_GOAL_EDITOR_TITLE = "Next session goal";
 export interface HandoffPromptTemplate {
     name: string;
@@ -7,7 +8,16 @@ export interface HandoffPromptTemplate {
     content: string;
 }
 interface HandoffGoalEditor {
+    autocompleteProvider?: AutocompleteProvider;
     setAutocompleteProvider(provider: AutocompleteProvider): void;
+    requestAutocomplete?(options: {
+        force: boolean;
+        explicitTab: boolean;
+    }): void;
+    isShowingAutocomplete?(): boolean;
+    getText?(): string;
+    setText?(text: string): void;
+    handleInput?(data: string): void;
 }
 export interface HandoffGoalEditorHost {
     showExtensionEditor(title: string, prefill?: string): Promise<string | undefined>;
@@ -22,6 +32,7 @@ export interface HandoffGoalEditorHost {
     };
 }
 export declare function expandHandoffGoalTemplate(goal: string, templates: ReadonlyArray<HandoffPromptTemplate>): string;
+export declare function installHandoffGoalEditorPromptHistory(host: HandoffGoalEditorHost, history: PromptHistoryRepository): void;
 export declare function installHandoffGoalEditorAutocomplete(host: HandoffGoalEditorHost): void;
 export {};
 //# sourceMappingURL=handoff-goal-editor.d.ts.map

package/lib/agent/extensions/handoff-goal-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handoff-goal-editor.d.ts","sourceRoot":"","sources":["../../../src/agent/extensions/handoff-goal-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,oBAAoB,EAC5B,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,iBAAiB;IACvB,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACjE;AAED,MAAM,WAAW,qBAAqB;IAClC,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClF,eAAe,CAAC,EAAE;QACd,MAAM,CAAC,EAAE,iBAAiB,CAAC;KAC9B,CAAC;IACF,OAAO,CAAC,EAAE;QACN,eAAe,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;KACzD,CAAC;IACF,cAAc,CAAC,EAAE;QACb,MAAM,IAAI,MAAM,CAAC;KACpB,CAAC;CACL;AA+DD,wBAAgB,yBAAyB,CACrC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,aAAa,CAAC,qBAAqB,CAAC,GAChD,MAAM,CAYR;AAgCD,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAuBtF"}
+{"version":3,"file":"handoff-goal-editor.d.ts","sourceRoot":"","sources":["../../../src/agent/extensions/handoff-goal-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,oBAAoB,EAC5B,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,wCAAwC,CAAC;AAEpF,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,iBAAiB;IACvB,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC9D,mBAAmB,CAAC,CAAC,OAAO,EAAE;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAA;KAAC,GAAG,IAAI,CAAC;IAC5E,qBAAqB,CAAC,IAAI,OAAO,CAAC;IAClC,OAAO,CAAC,IAAI,MAAM,CAAC;IACnB,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IAClC,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClF,eAAe,CAAC,EAAE;QACd,MAAM,CAAC,EAAE,iBAAiB,CAAC;KAC9B,CAAC;IACF,OAAO,CAAC,EAAE;QACN,eAAe,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;KACzD,CAAC;IACF,cAAc,CAAC,EAAE;QACb,MAAM,IAAI,MAAM,CAAC;KACpB,CAAC;CACL;AA+DD,wBAAgB,yBAAyB,CACrC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,aAAa,CAAC,qBAAqB,CAAC,GAChD,MAAM,CAYR;AA8CD,wBAAgB,qCAAqC,CACjD,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,uBAAuB,GACjC,IAAI,CAsBN;AAED,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAuBtF"}

package/lib/agent/extensions/handoff-goal-editor.js

@@ -8,6 +8,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { CombinedAutocompleteProvider, } from '@earendil-works/pi-tui';
+import { installPromptHistorySearch, } from '../interactive/prompt-history-search.js';
 export const HANDOFF_GOAL_EDITOR_TITLE = 'Next session goal';
 function parseCommandArgs(argsString) {
     const args = [];
@@ -86,13 +87,48 @@ function createPromptTemplateAutocompleteProvider(templates, cwd) {
                 if (cursorLine !== 0 || !/^\/[^\s]*$/.test(textBeforeCursor)) {
                     return null;
                 }
-                return provider.getSuggestions(lines, cursorLine, cursorCol, Object.assign(Object.assign({}, options), { force: false }));
+                const suggestions = yield provider.getSuggestions(lines, cursorLine, cursorCol, Object.assign(Object.assign({}, options), { force: false }));
+                return suggestions ? Object.assign(Object.assign({}, suggestions), { prefix: '' }) : null;
             });
         },
-        applyCompletion: (lines, cursorLine, cursorCol, item, prefix) => provider.applyCompletion(lines, cursorLine, cursorCol, item, prefix),
+        applyCompletion(lines, cursorLine, cursorCol, item) {
+            var _a, _b;
+            const template = templates.find(candidate => candidate.name === item.value);
+            if (!template) {
+                return { lines, cursorLine, cursorCol };
+            }
+            const expandedLines = substituteArgs(template.content, []).split('\n');
+            const expandedCursorLine = Math.max(0, expandedLines.length - 1);
+            return {
+                lines: expandedLines,
+                cursorLine: expandedCursorLine,
+                cursorCol: (_b = (_a = expandedLines[expandedCursorLine]) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0,
+            };
+        },
         shouldTriggerFileCompletion: () => false,
     };
 }
+export function installHandoffGoalEditorPromptHistory(host, history) {
+    const showExtensionEditor = host.showExtensionEditor.bind(host);
+    host.showExtensionEditor = (title, prefill) => __awaiter(this, void 0, void 0, function* () {
+        if (title !== HANDOFF_GOAL_EDITOR_TITLE) {
+            return showExtensionEditor(title, prefill);
+        }
+        const result = showExtensionEditor(title, prefill);
+        queueMicrotask(() => {
+            var _a;
+            const editor = (_a = host.extensionEditor) === null || _a === void 0 ? void 0 : _a.editor;
+            if ((editor === null || editor === void 0 ? void 0 : editor.getText) && editor.setText && editor.handleInput) {
+                installPromptHistorySearch(editor, history, false);
+            }
+        });
+        const goal = yield result;
+        if (goal === null || goal === void 0 ? void 0 : goal.trim()) {
+            history.record(goal, 'handoff');
+        }
+        return goal;
+    });
+}
 export function installHandoffGoalEditorAutocomplete(host) {
     const showExtensionEditor = host.showExtensionEditor.bind(host);
     host.showExtensionEditor = (title, prefill) => __awaiter(this, void 0, void 0, function* () {

package/lib/agent/extensions/handoff-goal-editor.js.map

@@ -1 +1 @@
-{"version":3,"file":"handoff-goal-editor.js","sourceRoot":"","sources":["../../../src/agent/extensions/handoff-goal-editor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handoff-goal-editor.js","sourceRoot":"","sources":["../../../src/agent/extensions/handoff-goal-editor.ts"],"names":[],"mappings":"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"}

package/lib/agent/interactive/interactive-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactive-mode.d.ts","sourceRoot":"","sources":["../../../src/agent/interactive/interactive-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,eAAe,EAElB,MAAM,iCAAiC,CAAC;AAiBzC,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAStF,wBAAgB,0BAA0B,IAAI,MAAM,IAAI,CAmBvD;AAED,qBAAa,oBAAqB,SAAQ,eAAe;IAC/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2DrB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7B"}
+{"version":3,"file":"interactive-mode.d.ts","sourceRoot":"","sources":["../../../src/agent/interactive/interactive-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,eAAe,EAElB,MAAM,iCAAiC,CAAC;AA0BzC,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAStF,wBAAgB,0BAA0B,IAAI,MAAM,IAAI,CAmBvD;AAED,qBAAa,oBAAqB,SAAQ,eAAe;IAC/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsErB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAS7B"}

package/lib/agent/interactive/interactive-mode.js

@@ -9,8 +9,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { getAgentDir, InteractiveMode, } from '@earendil-works/pi-coding-agent';
 import { installBkperAuthCommandRouting } from '../extensions/auth-commands.js';
-import { installHandoffGoalEditorAutocomplete, } from '../extensions/handoff-goal-editor.js';
+import { installHandoffGoalEditorAutocomplete, installHandoffGoalEditorPromptHistory, } from '../extensions/handoff-goal-editor.js';
 import { FileAutoHandoffSettings, getAutoHandoffSettingsPath, installAutoHandoffSettingsIntegration, } from '../extensions/handoff.js';
+import { installPromptHistoryEditor, } from './prompt-history-search.js';
+import { FilePromptHistory, getPromptHistoryPath, } from './prompt-history-store.js';
 import { installBkperSessionKeybindings, } from './session-keybindings.js';
 const PI_RESUME_HINT_TEXT = 'To resume this session:';
 const ANSI_PATTERN = /\x1B\[[0-?]*[ -/]*[@-~]/g;
@@ -46,9 +48,12 @@ export class BkperInteractiveMode extends InteractiveMode {
             if (authRoutingMode.editorContainer && authRoutingMode.showSettingsSelector) {
                 installAutoHandoffSettingsIntegration(authRoutingMode, new FileAutoHandoffSettings(getAutoHandoffSettingsPath(getAgentDir())));
             }
+            const promptHistory = new FilePromptHistory(getPromptHistoryPath(getAgentDir()));
             const handoffGoalMode = this;
             if (handoffGoalMode.showExtensionEditor) {
-                installHandoffGoalEditorAutocomplete(handoffGoalMode);
+                const handoffGoalHost = handoffGoalMode;
+                installHandoffGoalEditorPromptHistory(handoffGoalHost, promptHistory);
+                installHandoffGoalEditorAutocomplete(handoffGoalHost);
             }
             const providerRegistry = (_a = authRoutingMode.session) === null || _a === void 0 ? void 0 : _a.modelRuntime;
             if (providerRegistry) {
@@ -57,6 +62,10 @@ export class BkperInteractiveMode extends InteractiveMode {
                     installBkperAuthCommandRouting(editor, providerRegistry);
                 }
             }
+            const editors = new Set([authRoutingMode.defaultEditor, authRoutingMode.editor].filter(editor => editor !== undefined));
+            for (const editor of editors) {
+                installPromptHistoryEditor(editor, promptHistory);
+            }
         });
     }
     run() {

package/lib/agent/interactive/interactive-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactive-mode.js","sourceRoot":"","sources":["../../../src/agent/interactive/interactive-mode.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EACH,WAAW,EACX,eAAe,GAElB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAC,8BAA8B,EAAC,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EACH,oCAAoC,GAEvC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACH,uBAAuB,EACvB,0BAA0B,EAC1B,qCAAqC,GAExC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACH,8BAA8B,GAEjC,MAAM,0BAA0B,CAAC;AAIlC,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AACtD,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEhD,SAAS,oBAAoB,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,0BAA0B;IACtC,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAE3C,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,UAEnB,KAA0B,EAC1B,QAAyB,EACzB,QAAuC;QAEvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAgC,CAAC;IAEjC,OAAO,GAAG,EAAE;QACR,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC;IACzC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IAC/C,IAAI;;;;;;YACN,MAAM,eAAe,GAAG,IAGvB,CAAC;YACF,eAAe,CAAC,sBAAsB,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC;YAEzD,IAAI,eAAe,CAAC,WAAW,EAAE,CAAC;gBAC9B,8BAA8B,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;YAChE,CAAC;YAED,MAAM,OAAM,IAAI,WAAE,CAAC;YAEnB,MAAM,eAAe,GAAG,IAoBvB,CAAC;YACF,IAAI,eAAe,CAAC,eAAe,IAAI,eAAe,CAAC,oBAAoB,EAAE,CAAC;gBAC1E,qCAAqC,CACjC,eAAqD,EACrD,IAAI,uBAAuB,CAAC,0BAA0B,CAAC,WAAW,EAAE,CAAC,CAAC,CACzE,CAAC;YACN,CAAC;YAED,MAAM,eAAe,GAAG,IAAiD,CAAC;YAC1E,IAAI,eAAe,CAAC,mBAAmB,EAAE,CAAC;gBACtC,oCAAoC,CAAC,eAAwC,CAAC,CAAC;YACnF,CAAC;YAED,MAAM,gBAAgB,GAAG,MAAA,eAAe,CAAC,OAAO,0CAAE,YAAY,CAAC;YAC/D,IAAI,gBAAgB,EAAE,CAAC;gBACnB,MAAM,OAAO,GAAG,IAAI,GAAG,CACnB,CAAC,eAAe,CAAC,aAAa,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAC1D,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,SAAS,CACjC,CACJ,CAAC;gBACF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC3B,8BAA8B,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;gBAC7D,CAAC;YACL,CAAC;QACL,CAAC;KAAA;IAEK,GAAG;;;;;YACL,MAAM,uBAAuB,GAAG,0BAA0B,EAAE,CAAC;YAE7D,IAAI,CAAC;gBACD,MAAM,OAAM,GAAG,WAAE,CAAC;YACtB,CAAC;oBAAS,CAAC;gBACP,uBAAuB,EAAE,CAAC;YAC9B,CAAC;QACL,CAAC;KAAA;CACJ"}
+{"version":3,"file":"interactive-mode.js","sourceRoot":"","sources":["../../../src/agent/interactive/interactive-mode.ts"],"names":[],"mappings":"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"}

package/lib/agent/interactive/prompt-history-search.d.ts

@@ -0,0 +1,26 @@
+import type { AutocompleteItem, AutocompleteProvider, AutocompleteSuggestions } from '@earendil-works/pi-tui';
+import { type PromptHistoryEntry, type PromptHistoryRepository } from './prompt-history-store.js';
+export interface PromptHistoryEditor {
+    getText(): string;
+    getExpandedText?(): string;
+    setText(text: string): void;
+    handleInput(data: string): void;
+    onSubmit?: (text: string) => void | Promise<void>;
+}
+export declare class PromptHistoryAutocompleteProvider implements AutocompleteProvider {
+    private readonly entries;
+    private readonly includeBash;
+    constructor(entries: readonly PromptHistoryEntry[], includeBash: boolean);
+    getSuggestions(lines: string[], _cursorLine: number, _cursorCol: number, _options: {
+        signal: AbortSignal;
+        force?: boolean;
+    }): Promise<AutocompleteSuggestions | null>;
+    applyCompletion(_lines: string[], _cursorLine: number, _cursorCol: number, item: AutocompleteItem, _prefix: string): {
+        lines: string[];
+        cursorLine: number;
+        cursorCol: number;
+    };
+}
+export declare function installPromptHistorySearch(editor: PromptHistoryEditor, history: Pick<PromptHistoryRepository, 'getEntries'>, includeBash: boolean): void;
+export declare function installPromptHistoryEditor(editor: PromptHistoryEditor, history: PromptHistoryRepository): void;
+//# sourceMappingURL=prompt-history-search.d.ts.map

package/lib/agent/interactive/prompt-history-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-history-search.d.ts","sourceRoot":"","sources":["../../../src/agent/interactive/prompt-history-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EAC1B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAEH,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC/B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,mBAAmB;IAChC,OAAO,IAAI,MAAM,CAAC;IAClB,eAAe,CAAC,IAAI,MAAM,CAAC;IAC3B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAyCD,qBAAa,iCAAkC,YAAW,oBAAoB;IAEtE,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,WAAW,EAAE,OAAO;IAGnC,cAAc,CAChB,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE;QAAC,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAC,GACjD,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAkB1C,eAAe,CACX,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,GAChB;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC;CAS9D;AAED,wBAAgB,0BAA0B,CACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,YAAY,CAAC,EACpD,WAAW,EAAE,OAAO,GACrB,IAAI,CA0EN;AAED,wBAAgB,0BAA0B,CACtC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,uBAAuB,GACjC,IAAI,CAkBN"}

package/lib/agent/interactive/prompt-history-search.js

@@ -0,0 +1,139 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { getKeybindings, matchesKey } from '@earendil-works/pi-tui';
+import { searchPromptHistoryEntries, } from './prompt-history-store.js';
+const searchInstalledEditors = new WeakSet();
+const recordingInstalledEditors = new WeakSet();
+const DOWN_KEY_INPUT = '\x1b[B';
+function collapsePreview(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
+function isBashInput(text) {
+    return text.trimStart().startsWith('!');
+}
+function supportsInlineAutocomplete(editor) {
+    const candidate = editor;
+    return (candidate.autocompleteProvider !== undefined &&
+        typeof candidate.setAutocompleteProvider === 'function' &&
+        typeof candidate.requestAutocomplete === 'function' &&
+        typeof candidate.isShowingAutocomplete === 'function');
+}
+export class PromptHistoryAutocompleteProvider {
+    constructor(entries, includeBash) {
+        this.entries = entries;
+        this.includeBash = includeBash;
+    }
+    getSuggestions(lines, _cursorLine, _cursorCol, _options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = searchPromptHistoryEntries(this.entries, lines.join('\n'), { includeBash: this.includeBash });
+            if (results.length === 0) {
+                return null;
+            }
+            return {
+                items: results.map(entry => ({
+                    value: entry.text,
+                    label: collapsePreview(entry.text),
+                })),
+                prefix: '',
+            };
+        });
+    }
+    applyCompletion(_lines, _cursorLine, _cursorCol, item, _prefix) {
+        var _a, _b;
+        const lines = item.value.split('\n');
+        const cursorLine = Math.max(0, lines.length - 1);
+        return {
+            lines,
+            cursorLine,
+            cursorCol: (_b = (_a = lines[cursorLine]) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0,
+        };
+    }
+}
+export function installPromptHistorySearch(editor, history, includeBash) {
+    if (searchInstalledEditors.has(editor) || !supportsInlineAutocomplete(editor)) {
+        return;
+    }
+    searchInstalledEditors.add(editor);
+    const handleInput = editor.handleInput.bind(editor);
+    let originalProvider;
+    let searching = false;
+    const restoreProvider = () => {
+        if (!searching || !originalProvider) {
+            return;
+        }
+        editor.setAutocompleteProvider(originalProvider);
+        originalProvider = undefined;
+        searching = false;
+    };
+    const requestSuggestions = () => {
+        editor.requestAutocomplete({ force: false, explicitTab: true });
+    };
+    editor.handleInput = (data) => {
+        const keybindings = getKeybindings();
+        if (matchesKey(data, 'ctrl+r')) {
+            if (searching) {
+                if (editor.isShowingAutocomplete()) {
+                    handleInput(DOWN_KEY_INPUT);
+                }
+                else {
+                    requestSuggestions();
+                }
+                return;
+            }
+            originalProvider = editor.autocompleteProvider;
+            searching = true;
+            editor.setAutocompleteProvider(new PromptHistoryAutocompleteProvider(history.getEntries(), includeBash));
+            requestSuggestions();
+            return;
+        }
+        if (!searching) {
+            handleInput(data);
+            return;
+        }
+        if (keybindings.matches(data, 'tui.select.cancel')) {
+            if (editor.isShowingAutocomplete()) {
+                handleInput(data);
+            }
+            restoreProvider();
+            return;
+        }
+        if (keybindings.matches(data, 'tui.select.confirm') ||
+            keybindings.matches(data, 'tui.input.submit') ||
+            keybindings.matches(data, 'tui.input.tab')) {
+            if (editor.isShowingAutocomplete()) {
+                handleInput(data);
+                restoreProvider();
+            }
+            return;
+        }
+        handleInput(data);
+        if (!editor.isShowingAutocomplete()) {
+            requestSuggestions();
+        }
+    };
+}
+export function installPromptHistoryEditor(editor, history) {
+    installPromptHistorySearch(editor, history, true);
+    if (recordingInstalledEditors.has(editor)) {
+        return;
+    }
+    recordingInstalledEditors.add(editor);
+    const submit = editor.onSubmit;
+    if (submit) {
+        editor.onSubmit = (text) => __awaiter(this, void 0, void 0, function* () {
+            const normalized = text.trim();
+            if (normalized) {
+                history.record(normalized, isBashInput(normalized) ? 'bash' : 'standard');
+            }
+            yield submit(text);
+        });
+    }
+}
+//# sourceMappingURL=prompt-history-search.js.map

package/lib/agent/interactive/prompt-history-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-history-search.js","sourceRoot":"","sources":["../../../src/agent/interactive/prompt-history-search.ts"],"names":[],"mappings":"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"}

package/lib/agent/interactive/prompt-history-store.d.ts

@@ -0,0 +1,38 @@
+export type PromptHistoryKind = 'standard' | 'handoff' | 'bash';
+export interface PromptHistoryEntry {
+    text: string;
+    kind: PromptHistoryKind;
+    timestamp: number;
+}
+export interface PromptHistoryRecorder {
+    record(text: string, kind: PromptHistoryKind, timestamp?: number): void;
+}
+export interface PromptHistoryRepository extends PromptHistoryRecorder {
+    getEntries(): readonly PromptHistoryEntry[];
+}
+export interface PromptHistorySearchOptions {
+    includeBash: boolean;
+    limit?: number;
+}
+export interface FilePromptHistoryOptions {
+    maxEntries?: number;
+    trimRecordCount?: number;
+    maxFileBytes?: number;
+}
+export declare function searchPromptHistoryEntries(entries: readonly PromptHistoryEntry[], query: string, options: PromptHistorySearchOptions): PromptHistoryEntry[];
+export declare class FilePromptHistory implements PromptHistoryRepository {
+    private readonly filePath;
+    private readonly maxEntries;
+    private readonly trimRecordCount;
+    private readonly maxFileBytes;
+    private entries;
+    private recordCount;
+    private fileBytes;
+    constructor(filePath: string, options?: FilePromptHistoryOptions);
+    getEntries(): readonly PromptHistoryEntry[];
+    record(text: string, kind: PromptHistoryKind, timestamp?: number): void;
+    private load;
+    private rotate;
+}
+export declare function getPromptHistoryPath(agentDir: string): string;
+//# sourceMappingURL=prompt-history-store.d.ts.map

package/lib/agent/interactive/prompt-history-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-history-store.d.ts","sourceRoot":"","sources":["../../../src/agent/interactive/prompt-history-store.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAEhE,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IAClC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3E;AAED,MAAM,WAAW,uBAAwB,SAAQ,qBAAqB;IAClE,UAAU,IAAI,SAAS,kBAAkB,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,0BAA0B;IACvC,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AA6CD,wBAAgB,0BAA0B,CACtC,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,0BAA0B,GACpC,kBAAkB,EAAE,CAgBtB;AAED,qBAAa,iBAAkB,YAAW,uBAAuB;IASzD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,SAAS,CAAK;gBAGD,QAAQ,EAAE,MAAM,EACjC,OAAO,GAAE,wBAA6B;IAW1C,UAAU,IAAI,SAAS,kBAAkB,EAAE;IAI3C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,SAAa,GAAG,IAAI;IA6B3E,OAAO,CAAC,IAAI;IA0BZ,OAAO,CAAC,MAAM;CAsCjB;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/lib/agent/interactive/prompt-history-store.js

@@ -0,0 +1,156 @@
+import { appendFileSync, chmodSync, mkdirSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync, } from 'node:fs';
+import path from 'node:path';
+import { fuzzyFilter } from '@earendil-works/pi-tui';
+const DEFAULT_MAX_ENTRIES = 10000;
+const DEFAULT_TRIM_RECORD_COUNT = 20000;
+const DEFAULT_MAX_FILE_BYTES = 16 * 1024 * 1024;
+const DEFAULT_SEARCH_LIMIT = 10;
+function isPromptHistoryKind(value) {
+    return value === 'standard' || value === 'handoff' || value === 'bash';
+}
+function parseEntry(line) {
+    try {
+        const value = JSON.parse(line);
+        if (typeof value !== 'object' || value === null) {
+            return undefined;
+        }
+        const record = value;
+        if (typeof record.text !== 'string' ||
+            !record.text.trim() ||
+            !isPromptHistoryKind(record.kind) ||
+            typeof record.timestamp !== 'number' ||
+            !Number.isFinite(record.timestamp)) {
+            return undefined;
+        }
+        return {
+            text: record.text,
+            kind: record.kind,
+            timestamp: record.timestamp,
+        };
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+function serializeEntry(entry) {
+    return `${JSON.stringify(entry)}\n`;
+}
+function positiveInteger(value, fallback) {
+    return value !== undefined && Number.isInteger(value) && value > 0 ? value : fallback;
+}
+export function searchPromptHistoryEntries(entries, query, options) {
+    var _a;
+    const uniqueEntries = [];
+    const seen = new Set();
+    for (const entry of entries) {
+        if ((!options.includeBash && entry.kind === 'bash') || seen.has(entry.text)) {
+            continue;
+        }
+        seen.add(entry.text);
+        uniqueEntries.push(entry);
+    }
+    return fuzzyFilter(uniqueEntries, query, entry => entry.text).slice(0, (_a = options.limit) !== null && _a !== void 0 ? _a : DEFAULT_SEARCH_LIMIT);
+}
+export class FilePromptHistory {
+    constructor(filePath, options = {}) {
+        this.filePath = filePath;
+        this.entries = [];
+        this.recordCount = 0;
+        this.fileBytes = 0;
+        this.maxEntries = positiveInteger(options.maxEntries, DEFAULT_MAX_ENTRIES);
+        this.trimRecordCount = Math.max(this.maxEntries, positiveInteger(options.trimRecordCount, DEFAULT_TRIM_RECORD_COUNT));
+        this.maxFileBytes = positiveInteger(options.maxFileBytes, DEFAULT_MAX_FILE_BYTES);
+        this.load();
+    }
+    getEntries() {
+        return this.entries;
+    }
+    record(text, kind, timestamp = Date.now()) {
+        const normalized = text.trim();
+        if (!normalized) {
+            return;
+        }
+        const entry = { text: normalized, kind, timestamp };
+        const serialized = serializeEntry(entry);
+        this.entries.unshift(entry);
+        if (this.entries.length > this.maxEntries) {
+            this.entries.pop();
+        }
+        try {
+            mkdirSync(path.dirname(this.filePath), { recursive: true });
+            appendFileSync(this.filePath, serialized, { encoding: 'utf8', mode: 0o600 });
+            this.recordCount++;
+            this.fileBytes += Buffer.byteLength(serialized);
+            if (this.recordCount >= this.trimRecordCount ||
+                this.fileBytes >= this.maxFileBytes) {
+                this.rotate();
+            }
+        }
+        catch (_a) {
+            // Prompt history is a best-effort convenience cache.
+        }
+    }
+    load() {
+        let content;
+        try {
+            content = readFileSync(this.filePath, 'utf8');
+            chmodSync(this.filePath, 0o600);
+            this.fileBytes = statSync(this.filePath).size;
+        }
+        catch (_a) {
+            return;
+        }
+        const lines = content.split('\n').filter(line => line.trim().length > 0);
+        this.recordCount = lines.length;
+        this.entries = lines
+            .map(parseEntry)
+            .filter((entry) => entry !== undefined)
+            .slice(-this.maxEntries)
+            .reverse();
+        if (this.recordCount >= this.trimRecordCount ||
+            this.fileBytes >= this.maxFileBytes) {
+            this.rotate();
+        }
+    }
+    rotate() {
+        const retainedNewest = [];
+        let retainedBytes = 0;
+        for (const entry of this.entries) {
+            if (retainedNewest.length >= this.maxEntries) {
+                break;
+            }
+            const bytes = Buffer.byteLength(serializeEntry(entry));
+            if (retainedBytes + bytes > this.maxFileBytes) {
+                break;
+            }
+            retainedNewest.push(entry);
+            retainedBytes += bytes;
+        }
+        const content = retainedNewest
+            .slice()
+            .reverse()
+            .map(serializeEntry)
+            .join('');
+        const temporaryPath = `${this.filePath}.${process.pid}.${Date.now()}.tmp`;
+        try {
+            mkdirSync(path.dirname(this.filePath), { recursive: true });
+            writeFileSync(temporaryPath, content, { encoding: 'utf8', mode: 0o600 });
+            renameSync(temporaryPath, this.filePath);
+            this.entries = retainedNewest;
+            this.recordCount = retainedNewest.length;
+            this.fileBytes = Buffer.byteLength(content);
+        }
+        catch (_a) {
+            try {
+                unlinkSync(temporaryPath);
+            }
+            catch (_b) {
+                // Ignore cleanup failures for the best-effort cache.
+            }
+        }
+    }
+}
+export function getPromptHistoryPath(agentDir) {
+    return path.join(agentDir, 'bkper-input-history.jsonl');
+}
+//# sourceMappingURL=prompt-history-store.js.map

package/lib/agent/interactive/prompt-history-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-history-store.js","sourceRoot":"","sources":["../../../src/agent/interactive/prompt-history-store.ts"],"names":[],"mappings":"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"}

package/lib/agent/interactive/session-keybindings.d.ts

@@ -7,7 +7,7 @@ export type BkperKeybindingsManager = {
 };
 declare const BKPER_SESSION_KEYBINDINGS: {
     readonly 'app.session.resume': "ctrl+s";
-    readonly 'app.session.tree': "ctrl+r";
+    readonly 'app.session.tree': "ctrl+alt+r";
     readonly 'app.session.fork': "ctrl+x";
 };
 export declare function applyBkperSessionKeybindings(keybindings: Pick<BkperKeybindingsManager, 'getUserBindings' | 'setUserBindings'>): void;

package/lib/agent/interactive/session-keybindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-keybindings.d.ts","sourceRoot":"","sources":["../../../src/agent/interactive/session-keybindings.ts"],"names":[],"mappings":"AAEA,KAAK,sBAAsB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;AAC5D,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;AAE3E,MAAM,MAAM,uBAAuB,GAAG;IAClC,eAAe,IAAI,qBAAqB,CAAC;IACzC,eAAe,CAAC,YAAY,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3D,MAAM,IAAI,IAAI,CAAC;CAClB,CAAC;AAEF,QAAA,MAAM,yBAAyB;;;;CAIrB,CAAC;AA8BX,wBAAgB,4BAA4B,CACxC,WAAW,EAAE,IAAI,CAAC,uBAAuB,EAAE,iBAAiB,GAAG,iBAAiB,CAAC,GAClF,IAAI,CAoBN;AAED,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,uBAAuB,GAAG,IAAI,CAWzF;AAED,wBAAgB,iCAAiC,CAC7C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,OAAO,yBAAyB,GACnD,MAAM,CAGR"}
+{"version":3,"file":"session-keybindings.d.ts","sourceRoot":"","sources":["../../../src/agent/interactive/session-keybindings.ts"],"names":[],"mappings":"AAEA,KAAK,sBAAsB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;AAC5D,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;AAE3E,MAAM,MAAM,uBAAuB,GAAG;IAClC,eAAe,IAAI,qBAAqB,CAAC;IACzC,eAAe,CAAC,YAAY,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3D,MAAM,IAAI,IAAI,CAAC;CAClB,CAAC;AAEF,QAAA,MAAM,yBAAyB;;;;CAIrB,CAAC;AAgCX,wBAAgB,4BAA4B,CACxC,WAAW,EAAE,IAAI,CAAC,uBAAuB,EAAE,iBAAiB,GAAG,iBAAiB,CAAC,GAClF,IAAI,CA+BN;AAED,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,uBAAuB,GAAG,IAAI,CAWzF;AAED,wBAAgB,iCAAiC,CAC7C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,OAAO,yBAAyB,GACnD,MAAM,CAGR"}

package/lib/agent/interactive/session-keybindings.js

@@ -1,9 +1,10 @@
 import { keyText } from '@earendil-works/pi-coding-agent';
 const BKPER_SESSION_KEYBINDINGS = {
     'app.session.resume': 'ctrl+s',
-    'app.session.tree': 'ctrl+r',
+    'app.session.tree': 'ctrl+alt+r',
     'app.session.fork': 'ctrl+x',
 };
+const LEGACY_BKPER_TREE_SHORTCUT = 'ctrl+r';
 const installedBkperKeybindingsManagers = new WeakSet();
 function keybindingConfigIncludesShortcut(configuredBinding, shortcut) {
     const normalizedShortcut = shortcut.toLowerCase();
@@ -21,6 +22,14 @@ export function applyBkperSessionKeybindings(keybindings) {
     const nextBindings = Object.assign({}, userBindings);
     let changed = false;
     for (const [keybinding, shortcut] of Object.entries(BKPER_SESSION_KEYBINDINGS)) {
+        if (keybinding === 'app.session.tree' &&
+            typeof nextBindings[keybinding] === 'string' &&
+            nextBindings[keybinding].toLowerCase() === LEGACY_BKPER_TREE_SHORTCUT &&
+            !isShortcutClaimedByUserBinding(userBindings, keybinding, shortcut)) {
+            nextBindings[keybinding] = shortcut;
+            changed = true;
+            continue;
+        }
         if (nextBindings[keybinding] !== undefined ||
             isShortcutClaimedByUserBinding(userBindings, keybinding, shortcut)) {
             continue;

package/lib/agent/interactive/session-keybindings.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-keybindings.js","sourceRoot":"","sources":["../../../src/agent/interactive/session-keybindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,iCAAiC,CAAC;AAWxD,MAAM,yBAAyB,GAAG;IAC9B,oBAAoB,EAAE,QAAQ;IAC9B,kBAAkB,EAAE,QAAQ;IAC5B,kBAAkB,EAAE,QAAQ;CACtB,CAAC;AAEX,MAAM,iCAAiC,GAAG,IAAI,OAAO,EAA2B,CAAC;AAEjF,SAAS,gCAAgC,CACrC,iBAAyC,EACzC,QAAgB;IAEhB,MAAM,kBAAkB,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,mBAAmB,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC;QACxD,CAAC,CAAC,iBAAiB;QACnB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAE1B,OAAO,mBAAmB,CAAC,IAAI,CAC3B,kBAAkB,CAAC,EAAE,CAAC,CAAA,kBAAkB,aAAlB,kBAAkB,uBAAlB,kBAAkB,CAAE,WAAW,EAAE,MAAK,kBAAkB,CACjF,CAAC;AACN,CAAC;AAED,SAAS,8BAA8B,CACnC,YAAmC,EACnC,gBAAwB,EACxB,QAAgB;IAEhB,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CACpC,CAAC,CAAC,UAAU,EAAE,iBAAiB,CAAC,EAAE,EAAE,CAChC,UAAU,KAAK,gBAAgB;QAC/B,gCAAgC,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CACpE,CAAC;AACN,CAAC;AAED,MAAM,UAAU,4BAA4B,CACxC,WAAiF;IAEjF,MAAM,YAAY,GAAG,WAAW,CAAC,eAAe,EAAE,CAAC;IACnD,MAAM,YAAY,qBAA8B,YAAY,CAAC,CAAC;IAC9D,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAC,EAAE,CAAC;QAC7E,IACI,YAAY,CAAC,UAAU,CAAC,KAAK,SAAS;YACtC,8BAA8B,CAAC,YAAY,EAAE,UAAU,EAAE,QAAQ,CAAC,EACpE,CAAC;YACC,SAAS;QACb,CAAC;QAED,YAAY,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC;QACpC,OAAO,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACV,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;AACL,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,WAAoC;IAC/E,IAAI,CAAC,iCAAiC,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,WAAW,CAAC,MAAM,GAAG,GAAG,EAAE;YACtB,MAAM,EAAE,CAAC;YACT,4BAA4B,CAAC,WAAW,CAAC,CAAC;QAC9C,CAAC,CAAC;QACF,iCAAiC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;IAED,4BAA4B,CAAC,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC7C,OAAe,EACf,UAAkD;IAElD,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,QAAQ,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"session-keybindings.js","sourceRoot":"","sources":["../../../src/agent/interactive/session-keybindings.ts"],"names":[],"mappings":"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"}

package/lib/docs/apps/app-listing.md

@@ -49,6 +49,7 @@ To make your app available to all Bkper users, contact us at [support@bkper.com]
 ### What the review involves
 
 - **Functionality check** — The app works correctly and handles errors gracefully
+- **Quality review** — The implementation follows the [App Quality Guidelines](https://bkper.com/docs/build/apps/quality.md)
 - **Security review** — Event handlers are idempotent and include loop prevention
 - **Listing quality** — The app has a clear name, description, logo, and user-facing documentation
 

package/lib/docs/apps/architecture.md

@@ -4,6 +4,8 @@ Bkper platform apps use one Worker bundle per app and environment. The same Work
 
 Treat `/api/*` as the reusable surface for app behavior. The bundled web client is one consumer; scripts, external clients, and agents can call the same routes with bearer authentication.
 
+Follow the [App Quality Guidelines](https://bkper.com/docs/build/apps/quality.md) when implementing, changing, or reviewing an app.
+
 ## Structure
 
 ```txt

package/lib/docs/apps/context-menu.md

@@ -2,6 +2,8 @@
 
 Apps can add context menu items on the Transactions page **More** menu in your Books. This lets you open dynamically built URLs with reference to the current Book's context — the active query, selected account, date range, and more.
 
+Embedded interfaces should follow the [App Quality Guidelines](https://bkper.com/docs/build/apps/quality.md) for visual consistency, startup behavior, and Book-context verification.
+
 ## How it works
 
 Once you install an App with a menu configuration, a new menu item appears in your Book:

package/lib/docs/apps/quality.md

@@ -0,0 +1,86 @@
+# App Quality Guidelines
+
+Use these guidelines when building, changing, or reviewing a Bkper app. They complement the detailed architecture, security, and feature documentation.
+
+After implementation, review the changed code against these guidelines before considering the work complete. Automated checks support this review but do not replace it.
+
+## Bkper behavior
+
+Always:
+
+- Model financial activity as balanced resource movements between Accounts.
+- Keep calculations deterministic and cover financial behavior with focused unit tests.
+- Use canonical Bkper SDK and API types instead of recreating Bkper data structures.
+- Add meaning with properties before introducing new structural complexity.
+
+## User interface
+
+Always:
+
+- Use Web Awesome as the primary component library.
+- Style with Bkper design tokens instead of ad-hoc design constants.
+- Support the active Bkper light or dark theme.
+- Keep interactions accessible and provide clear loading, empty, and error states.
+
+Apps opened from a Book context menu should feel like part of the Book. Keep their layout focused, make them work in the configured sidebar or expanded width, and preserve context when the Book URL changes.
+
+## Startup
+
+Always render the app shell or a meaningful loading state before waiting for authentication, API calls, or other initialization. Start asynchronous work after the first render and update the interface as results arrive.
+
+Prefer loading only the client code and Web Awesome components needed for the initial experience.
+
+## API contracts
+
+When an app exposes its own HTTP API:
+
+- Define and publish its OpenAPI contract at `/openapi.json`.
+- Generate client types from that contract.
+- Call the API through the generated typed boundary rather than duplicating request or response types.
+- Validate untrusted request data at the server boundary.
+- Keep published routes backward compatible or introduce a new API version for breaking changes.
+
+UI-only and event-only apps without an app-owned HTTP API do not need to add one. Direct calls to Bkper should use the canonical Bkper SDK and API types.
+
+## Focused modules
+
+Prefer modules with one clear responsibility, high cohesion, and few dependencies.
+
+- Components render state and communicate user intent. They should delegate API and Bkper operations to client API or service modules.
+- HTTP routes and event handlers adapt transport concerns and delegate app behavior.
+- Business modules contain domain decisions without depending on UI, HTTP, storage, or external-service details.
+- Connectors isolate external APIs and storage concerns from business behavior.
+- Add a repository or another layer when connection or storage complexity justifies it, not by default.
+- Avoid layers that only forward calls without creating a useful boundary.
+
+Split a module when unrelated behavior changes for different reasons or when mixed responsibilities make it difficult to understand or test.
+
+## Security
+
+Keep the security boundary simple and explicit:
+
+- Authorize sensitive app operations on the server.
+- Validate untrusted requests, events, and browser messages at their boundaries.
+- Keep application secrets and privileged credentials out of client bundles.
+- Access only the Book data needed for the operation.
+- Make event handling safe to retry and prevent event loops.
+
+See [App Security](https://bkper.com/docs/build/apps/security.md) and [Event Handlers](https://bkper.com/docs/build/apps/event-handlers.md) for implementation details.
+
+## Verification
+
+After implementation:
+
+1. Review the changed code against these guidelines.
+2. Run the app's deterministic checks, including unit tests, typechecking, and production builds.
+3. Confirm generated API types and contract snapshots are current when the API changed.
+4. Verify user interfaces in their intended Book context, including first rendering, loading, errors, theme, and configured width.
+
+App reviews should report concrete findings with file locations and suggested fixes. If no issues are found, a short confirmation is enough.
+
+## Next Steps
+
+- [App Architecture](https://bkper.com/docs/build/apps/architecture.md) — Client, server, API, and event structure.
+- [App Security](https://bkper.com/docs/build/apps/security.md) — Authentication and authorization boundaries.
+- [Context Menu](https://bkper.com/docs/build/apps/context-menu.md) — Embedded Book context and open modes.
+- [Development Experience](https://bkper.com/docs/build/apps/development.md) — Local development and deterministic checks.

package/lib/docs/apps/security.md

@@ -68,6 +68,7 @@ if (!isInstalled) {
 
 ## Next Steps
 
+- [App Quality Guidelines](https://bkper.com/docs/build/apps/quality.md) — Review cross-cutting app quality and security expectations.
 - [App Architecture](https://bkper.com/docs/build/apps/architecture.md) — Understand client and server authentication flows.
 - [Building & Deploying](https://bkper.com/docs/build/apps/deploying.md#setting-secrets) — Store production and preview secrets.
 - [Event Handlers](https://bkper.com/docs/build/apps/event-handlers.md#authentication) — Understand authentication for platform and self-hosted events.

package/lib/docs/cli/app-management.md

@@ -46,6 +46,8 @@ Sync preserves the existing App identity, activates managed source, configures i
 
 When scaffolding, developing, or deploying an app, verify each step before proceeding. This prevents broken deployments and silent failures.
 
+For app implementation, refactoring, or code review, first read the [App Quality Guidelines](https://bkper.com/docs/build/apps/quality.md). After implementation, review the changed code against the guidelines and run the project's deterministic checks. A successful build does not replace this quality review.
+
 ### 1. Init
 
 ```bash

package/lib/docs/index.md

@@ -4,6 +4,8 @@ Reference docs for Bkper tasks. Load only the specific doc(s) relevant to the ta
 
 For Bkper data, accounting, reporting, tax, or financial-flow tasks, read `core/core-concepts.md` first.
 
+For Bkper app implementation, refactoring, or code review, always read `apps/quality.md` alongside the task-specific references. After implementation, review the changed code against the guidelines before considering the work complete.
+
 - `core/core-concepts.md` — canonical Bkper data model: resources, movements, balances, accounts, groups, books, transactions, properties, and the zero-sum invariant.
 - `cli/data-management.md` — CLI reference for managing financial data and files: books, accounts, groups, files, transactions, per-account balance queries, query operators (on:, after:, before:, account:, group:), output formats (table/json/csv), human-review Bkper UI links, batch operations via stdin/piping, collections.
 - `cli/app-management.md` — CLI reference for building and deploying Bkper apps: init/git clone/credential helpers, dev/build/deploy workflow, app install/uninstall, secrets management, app logs, bkper.yaml configuration reference (identity, branding, events, menu integration, deployment).
@@ -11,6 +13,7 @@ For Bkper data, accounting, reporting, tax, or financial-flow tasks, read `core/
 - `apps/ai.md` — Bkper AI integration for Platform apps: authenticated `/api/*` request flow, outbound authorization and app attribution, live model discovery, strict structured output, response validation, error preservation, data minimization, and unit-test boundaries.
 - `apps/first-app.md` — First-app walkthrough: scaffold, install, run locally, trigger an event, customize the listing, establish shared source, check, and deploy.
 - `apps/architecture.md` — App and template architecture: npm workspace structure, Lit/Vite client, Hono Worker, typed `/api/*` contracts, authentication, `/events`, static assets, and supported app shapes.
+- `apps/quality.md` — Cross-cutting quality guidance for Bkper apps: UI consistency, immediate first rendering, typed API contracts, cohesive low-coupling modules, separation of business behavior from connectors and storage, security, and final implementation review. Load for app implementation, refactoring, or review tasks.
 - `apps/security.md` — App security responsibilities and server-side authorization: platform authentication boundaries, user-domain restrictions, Book permission allowlists, and app installation checks.
 - `apps/configuration.md` — Complete `bkper.yaml` reference: identity, branding, ownership, access, context menus, event subscriptions, property schemas, and single-Worker deployment settings.
 - `apps/development.md` — Local development: Vite and Worker processes, ports, API proxy, local authentication, secrets, KV, generated environment types, development loop, and debugging.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bkper",
-    "version": "4.28.1",
+    "version": "4.29.0",
     "description": "Official Bkper CLI for accounting data, automation, apps, and AI agents",
     "bin": {
         "bkper": "./lib/cli.js"