@caupulican/pi-adaptative 0.93.17 → 0.93.19

package/dist/modes/interactive/runtime-status-controller.d.ts

@@ -0,0 +1,40 @@
+import type { AssistantMessage } from "@caupulican/pi-ai";
+import { type Container, Loader, type LoaderIndicatorOptions, type TUI } from "@caupulican/pi-tui";
+import type { ActivityLaneComponent } from "./components/activity-lane.ts";
+export interface RuntimeStatusControllerHost {
+    readonly ui: TUI;
+    readonly statusContainer: Container;
+    readonly activityLane: ActivityLaneComponent | undefined;
+    readonly hasHumanAudience: boolean;
+    isStreaming(): boolean;
+    isThinkingHidden(): boolean;
+}
+/** Owns the human-facing turn indicator and its loader/activity-lane lifecycle. */
+export declare class RuntimeStatusController {
+    private readonly host;
+    private activeLoader;
+    private workingMessage;
+    private workingVisible;
+    private workingIndicatorOptions;
+    private readonly defaultWorkingMessage;
+    private readonly defaultHiddenThinkingLabel;
+    private hiddenThinkingLabel;
+    private runtimeStatusLabel;
+    constructor(host: RuntimeStatusControllerHost);
+    get loadingAnimation(): Loader | undefined;
+    set loadingAnimation(value: Loader | undefined);
+    get isWorkingVisible(): boolean;
+    set isWorkingVisible(value: boolean);
+    get indicatorOptions(): LoaderIndicatorOptions | undefined;
+    set indicatorOptions(value: LoaderIndicatorOptions | undefined);
+    getWorkingLoaderMessage(): string;
+    createWorkingLoader(): Loader;
+    stopWorkingLoader(): void;
+    setWorkingVisible(visible: boolean): void;
+    setWorkingIndicator(options?: LoaderIndicatorOptions): void;
+    setHiddenThinkingLabel(label?: string): void;
+    updateRuntimeStatus(message?: AssistantMessage): void;
+    setWorkingMessage(message: string | undefined, messageInFlight: AssistantMessage | undefined): void;
+    resetWorkingIndicators(): void;
+}
+//# sourceMappingURL=runtime-status-controller.d.ts.map

package/dist/modes/interactive/runtime-status-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-status-controller.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/runtime-status-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,EAAE,KAAK,sBAAsB,EAAE,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAK3E,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC;IACjB,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,WAAW,IAAI,OAAO,CAAC;IACvB,gBAAgB,IAAI,OAAO,CAAC;CAC5B;AAED,mFAAmF;AACnF,qBAAa,uBAAuB;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IACnD,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,uBAAuB,CAAqC;IACpE,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAgB;IACtD,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAiB;IAC5D,OAAO,CAAC,mBAAmB,CAAmC;IAC9D,OAAO,CAAC,kBAAkB,CAAqB;IAE/C,YAAY,IAAI,EAAE,2BAA2B,EAG5C;IAED,IAAI,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAEzC;IAED,IAAI,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAE7C;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAElC;IAED,IAAI,gBAAgB,IAAI,sBAAsB,GAAG,SAAS,CAEzD;IAED,IAAI,gBAAgB,CAAC,KAAK,EAAE,sBAAsB,GAAG,SAAS,EAE7D;IAED,uBAAuB,IAAI,MAAM,CAEhC;IAED,mBAAmB,IAAI,MAAM,CAQ5B;IAED,iBAAiB,IAAI,IAAI,CASxB;IAED,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4BxC;IAED,mBAAmB,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,CA4B1D;IAED,sBAAsB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAE3C;IAED,mBAAmB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAoBpD;IAED,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,eAAe,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI,CAUlG;IAED,sBAAsB,IAAI,IAAI,CAQ7B;CACD"}

package/dist/modes/interactive/runtime-status-controller.js

@@ -0,0 +1,147 @@
+import { Loader } from "@caupulican/pi-tui";
+import { keyText } from "./components/keybinding-hints.js";
+import { applyRuntimeStatusLabel, resolveHiddenThinkingStatus } from "./runtime-status.js";
+import { theme } from "./theme/theme.js";
+/** Owns the human-facing turn indicator and its loader/activity-lane lifecycle. */
+export class RuntimeStatusController {
+    constructor(host) {
+        this.defaultWorkingMessage = "Working...";
+        this.defaultHiddenThinkingLabel = "Thinking...";
+        this.hiddenThinkingLabel = this.defaultHiddenThinkingLabel;
+        this.host = host;
+        this.workingVisible = host.hasHumanAudience;
+    }
+    get loadingAnimation() {
+        return this.activeLoader;
+    }
+    set loadingAnimation(value) {
+        this.activeLoader = value;
+    }
+    get isWorkingVisible() {
+        return this.workingVisible;
+    }
+    set isWorkingVisible(value) {
+        this.workingVisible = value;
+    }
+    get indicatorOptions() {
+        return this.workingIndicatorOptions;
+    }
+    set indicatorOptions(value) {
+        this.workingIndicatorOptions = value;
+    }
+    getWorkingLoaderMessage() {
+        return this.workingMessage ?? this.defaultWorkingMessage;
+    }
+    createWorkingLoader() {
+        return new Loader(this.host.ui, (spinner) => theme.fg("accent", spinner), (text) => theme.fg("muted", text), this.runtimeStatusLabel ?? this.getWorkingLoaderMessage(), this.workingIndicatorOptions);
+    }
+    stopWorkingLoader() {
+        if (this.activeLoader) {
+            this.activeLoader.stop();
+            this.activeLoader = undefined;
+        }
+        this.host.statusContainer.clear();
+        this.runtimeStatusLabel = undefined;
+        this.host.activityLane?.remove("runtime:routing");
+        this.host.activityLane?.remove("runtime:turn");
+    }
+    setWorkingVisible(visible) {
+        if (!this.host.hasHumanAudience) {
+            this.workingVisible = false;
+            this.stopWorkingLoader();
+            return;
+        }
+        this.workingVisible = visible;
+        if (!visible) {
+            const currentRuntimeStatus = this.runtimeStatusLabel;
+            this.stopWorkingLoader();
+            if (this.host.isStreaming())
+                this.runtimeStatusLabel = currentRuntimeStatus;
+            this.host.ui.requestRender();
+            return;
+        }
+        if (this.host.isStreaming() && !this.activeLoader) {
+            if (this.workingIndicatorOptions) {
+                this.host.statusContainer.clear();
+                this.activeLoader = this.createWorkingLoader();
+                this.host.statusContainer.addChild(this.activeLoader);
+            }
+            else {
+                this.host.activityLane?.start({
+                    id: "runtime:turn",
+                    kind: "runtime",
+                    label: this.runtimeStatusLabel ?? this.getWorkingLoaderMessage(),
+                });
+            }
+        }
+        this.host.ui.requestRender();
+    }
+    setWorkingIndicator(options) {
+        this.workingIndicatorOptions = options;
+        if (!this.host.hasHumanAudience) {
+            this.stopWorkingLoader();
+            return;
+        }
+        if (options) {
+            this.host.activityLane?.remove("runtime:turn");
+            if (this.host.isStreaming() && this.workingVisible) {
+                const currentRuntimeStatus = this.runtimeStatusLabel;
+                this.stopWorkingLoader();
+                this.runtimeStatusLabel = currentRuntimeStatus;
+                this.activeLoader = this.createWorkingLoader();
+                this.host.statusContainer.addChild(this.activeLoader);
+            }
+        }
+        else {
+            this.activeLoader?.stop();
+            this.activeLoader = undefined;
+            this.host.statusContainer.clear();
+            if (this.host.isStreaming() && this.workingVisible) {
+                this.host.activityLane?.start({
+                    id: "runtime:turn",
+                    kind: "runtime",
+                    label: this.runtimeStatusLabel ?? this.getWorkingLoaderMessage(),
+                });
+            }
+        }
+        this.host.ui.requestRender();
+    }
+    setHiddenThinkingLabel(label) {
+        this.hiddenThinkingLabel = label ?? this.defaultHiddenThinkingLabel;
+    }
+    updateRuntimeStatus(message) {
+        if (!this.host.hasHumanAudience)
+            return;
+        const label = message
+            ? resolveHiddenThinkingStatus(message, this.host.isThinkingHidden(), this.hiddenThinkingLabel, this.getWorkingLoaderMessage())
+            : this.getWorkingLoaderMessage();
+        this.runtimeStatusLabel = applyRuntimeStatusLabel({
+            hasHumanAudience: this.host.hasHumanAudience,
+            currentLabel: this.runtimeStatusLabel,
+            loadingAnimation: this.activeLoader,
+            activityLane: this.host.activityLane,
+            requestRender: () => this.host.ui.requestRender(),
+        }, label);
+    }
+    setWorkingMessage(message, messageInFlight) {
+        this.workingMessage = message;
+        if (messageInFlight) {
+            this.updateRuntimeStatus(messageInFlight);
+            return;
+        }
+        if (this.activeLoader) {
+            this.activeLoader.setMessage(message ?? this.defaultWorkingMessage);
+        }
+        this.host.activityLane?.update("runtime:turn", message ?? this.defaultWorkingMessage);
+    }
+    resetWorkingIndicators() {
+        this.workingMessage = undefined;
+        this.workingVisible = this.host.hasHumanAudience;
+        this.setWorkingIndicator();
+        if (this.activeLoader) {
+            this.activeLoader.setMessage(`${this.defaultWorkingMessage} (${keyText("app.interrupt")} to interrupt)`);
+        }
+        this.setHiddenThinkingLabel();
+    }
+}
+//# sourceMappingURL=runtime-status-controller.js.map

package/dist/modes/interactive/runtime-status-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-status-controller.js","sourceRoot":"","sources":["../../../src/modes/interactive/runtime-status-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AssistantMessage } from \"@caupulican/pi-ai\";\nimport { type Container, Loader, type LoaderIndicatorOptions, type TUI } from \"@caupulican/pi-tui\";\nimport type { ActivityLaneComponent } from \"./components/activity-lane.ts\";\nimport { keyText } from \"./components/keybinding-hints.ts\";\nimport { applyRuntimeStatusLabel, resolveHiddenThinkingStatus } from \"./runtime-status.ts\";\nimport { theme } from \"./theme/theme.ts\";\n\nexport interface RuntimeStatusControllerHost {\n\treadonly ui: TUI;\n\treadonly statusContainer: Container;\n\treadonly activityLane: ActivityLaneComponent | undefined;\n\treadonly hasHumanAudience: boolean;\n\tisStreaming(): boolean;\n\tisThinkingHidden(): boolean;\n}\n\n/** Owns the human-facing turn indicator and its loader/activity-lane lifecycle. */\nexport class RuntimeStatusController {\n\tprivate readonly host: RuntimeStatusControllerHost;\n\tprivate activeLoader: Loader | undefined;\n\tprivate workingMessage: string | undefined;\n\tprivate workingVisible: boolean;\n\tprivate workingIndicatorOptions: LoaderIndicatorOptions | undefined;\n\tprivate readonly defaultWorkingMessage = \"Working...\";\n\tprivate readonly defaultHiddenThinkingLabel = \"Thinking...\";\n\tprivate hiddenThinkingLabel = this.defaultHiddenThinkingLabel;\n\tprivate runtimeStatusLabel: string | undefined;\n\n\tconstructor(host: RuntimeStatusControllerHost) {\n\t\tthis.host = host;\n\t\tthis.workingVisible = host.hasHumanAudience;\n\t}\n\n\tget loadingAnimation(): Loader | undefined {\n\t\treturn this.activeLoader;\n\t}\n\n\tset loadingAnimation(value: Loader | undefined) {\n\t\tthis.activeLoader = value;\n\t}\n\n\tget isWorkingVisible(): boolean {\n\t\treturn this.workingVisible;\n\t}\n\n\tset isWorkingVisible(value: boolean) {\n\t\tthis.workingVisible = value;\n\t}\n\n\tget indicatorOptions(): LoaderIndicatorOptions | undefined {\n\t\treturn this.workingIndicatorOptions;\n\t}\n\n\tset indicatorOptions(value: LoaderIndicatorOptions | undefined) {\n\t\tthis.workingIndicatorOptions = value;\n\t}\n\n\tgetWorkingLoaderMessage(): string {\n\t\treturn this.workingMessage ?? this.defaultWorkingMessage;\n\t}\n\n\tcreateWorkingLoader(): Loader {\n\t\treturn new Loader(\n\t\t\tthis.host.ui,\n\t\t\t(spinner) => theme.fg(\"accent\", spinner),\n\t\t\t(text) => theme.fg(\"muted\", text),\n\t\t\tthis.runtimeStatusLabel ?? this.getWorkingLoaderMessage(),\n\t\t\tthis.workingIndicatorOptions,\n\t\t);\n\t}\n\n\tstopWorkingLoader(): void {\n\t\tif (this.activeLoader) {\n\t\t\tthis.activeLoader.stop();\n\t\t\tthis.activeLoader = undefined;\n\t\t}\n\t\tthis.host.statusContainer.clear();\n\t\tthis.runtimeStatusLabel = undefined;\n\t\tthis.host.activityLane?.remove(\"runtime:routing\");\n\t\tthis.host.activityLane?.remove(\"runtime:turn\");\n\t}\n\n\tsetWorkingVisible(visible: boolean): void {\n\t\tif (!this.host.hasHumanAudience) {\n\t\t\tthis.workingVisible = false;\n\t\t\tthis.stopWorkingLoader();\n\t\t\treturn;\n\t\t}\n\t\tthis.workingVisible = visible;\n\t\tif (!visible) {\n\t\t\tconst currentRuntimeStatus = this.runtimeStatusLabel;\n\t\t\tthis.stopWorkingLoader();\n\t\t\tif (this.host.isStreaming()) this.runtimeStatusLabel = currentRuntimeStatus;\n\t\t\tthis.host.ui.requestRender();\n\t\t\treturn;\n\t\t}\n\t\tif (this.host.isStreaming() && !this.activeLoader) {\n\t\t\tif (this.workingIndicatorOptions) {\n\t\t\t\tthis.host.statusContainer.clear();\n\t\t\t\tthis.activeLoader = this.createWorkingLoader();\n\t\t\t\tthis.host.statusContainer.addChild(this.activeLoader);\n\t\t\t} else {\n\t\t\t\tthis.host.activityLane?.start({\n\t\t\t\t\tid: \"runtime:turn\",\n\t\t\t\t\tkind: \"runtime\",\n\t\t\t\t\tlabel: this.runtimeStatusLabel ?? this.getWorkingLoaderMessage(),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t\tthis.host.ui.requestRender();\n\t}\n\n\tsetWorkingIndicator(options?: LoaderIndicatorOptions): void {\n\t\tthis.workingIndicatorOptions = options;\n\t\tif (!this.host.hasHumanAudience) {\n\t\t\tthis.stopWorkingLoader();\n\t\t\treturn;\n\t\t}\n\t\tif (options) {\n\t\t\tthis.host.activityLane?.remove(\"runtime:turn\");\n\t\t\tif (this.host.isStreaming() && this.workingVisible) {\n\t\t\t\tconst currentRuntimeStatus = this.runtimeStatusLabel;\n\t\t\t\tthis.stopWorkingLoader();\n\t\t\t\tthis.runtimeStatusLabel = currentRuntimeStatus;\n\t\t\t\tthis.activeLoader = this.createWorkingLoader();\n\t\t\t\tthis.host.statusContainer.addChild(this.activeLoader);\n\t\t\t}\n\t\t} else {\n\t\t\tthis.activeLoader?.stop();\n\t\t\tthis.activeLoader = undefined;\n\t\t\tthis.host.statusContainer.clear();\n\t\t\tif (this.host.isStreaming() && this.workingVisible) {\n\t\t\t\tthis.host.activityLane?.start({\n\t\t\t\t\tid: \"runtime:turn\",\n\t\t\t\t\tkind: \"runtime\",\n\t\t\t\t\tlabel: this.runtimeStatusLabel ?? this.getWorkingLoaderMessage(),\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t\tthis.host.ui.requestRender();\n\t}\n\n\tsetHiddenThinkingLabel(label?: string): void {\n\t\tthis.hiddenThinkingLabel = label ?? this.defaultHiddenThinkingLabel;\n\t}\n\n\tupdateRuntimeStatus(message?: AssistantMessage): void {\n\t\tif (!this.host.hasHumanAudience) return;\n\t\tconst label = message\n\t\t\t? resolveHiddenThinkingStatus(\n\t\t\t\t\tmessage,\n\t\t\t\t\tthis.host.isThinkingHidden(),\n\t\t\t\t\tthis.hiddenThinkingLabel,\n\t\t\t\t\tthis.getWorkingLoaderMessage(),\n\t\t\t\t)\n\t\t\t: this.getWorkingLoaderMessage();\n\t\tthis.runtimeStatusLabel = applyRuntimeStatusLabel(\n\t\t\t{\n\t\t\t\thasHumanAudience: this.host.hasHumanAudience,\n\t\t\t\tcurrentLabel: this.runtimeStatusLabel,\n\t\t\t\tloadingAnimation: this.activeLoader,\n\t\t\t\tactivityLane: this.host.activityLane,\n\t\t\t\trequestRender: () => this.host.ui.requestRender(),\n\t\t\t},\n\t\t\tlabel,\n\t\t);\n\t}\n\n\tsetWorkingMessage(message: string | undefined, messageInFlight: AssistantMessage | undefined): void {\n\t\tthis.workingMessage = message;\n\t\tif (messageInFlight) {\n\t\t\tthis.updateRuntimeStatus(messageInFlight);\n\t\t\treturn;\n\t\t}\n\t\tif (this.activeLoader) {\n\t\t\tthis.activeLoader.setMessage(message ?? this.defaultWorkingMessage);\n\t\t}\n\t\tthis.host.activityLane?.update(\"runtime:turn\", message ?? this.defaultWorkingMessage);\n\t}\n\n\tresetWorkingIndicators(): void {\n\t\tthis.workingMessage = undefined;\n\t\tthis.workingVisible = this.host.hasHumanAudience;\n\t\tthis.setWorkingIndicator();\n\t\tif (this.activeLoader) {\n\t\t\tthis.activeLoader.setMessage(`${this.defaultWorkingMessage} (${keyText(\"app.interrupt\")} to interrupt)`);\n\t\t}\n\t\tthis.setHiddenThinkingLabel();\n\t}\n}\n"]}

package/dist/modes/interactive/runtime-status.d.ts

@@ -0,0 +1,15 @@
+import type { AssistantMessage } from "@caupulican/pi-ai";
+export interface RuntimeStatusPresentation {
+    hasHumanAudience: boolean;
+    currentLabel: string | undefined;
+    loadingAnimation: {
+        setMessage(message: string): void;
+    } | undefined;
+    activityLane: {
+        update(id: string, label: string): void;
+    } | undefined;
+    requestRender(): void;
+}
+export declare function applyRuntimeStatusLabel(presentation: RuntimeStatusPresentation, label: string): string | undefined;
+export declare function resolveHiddenThinkingStatus(message: AssistantMessage, hideThinkingBlock: boolean, hiddenThinkingLabel: string, workingLabel: string): string;
+//# sourceMappingURL=runtime-status.d.ts.map

package/dist/modes/interactive/runtime-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-status.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/runtime-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,yBAAyB;IACzC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,gBAAgB,EAAE;QAAE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,SAAS,CAAC;IACpE,YAAY,EAAE;QAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,SAAS,CAAC;IACtE,aAAa,IAAI,IAAI,CAAC;CACtB;AAED,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMlH;AAED,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,gBAAgB,EACzB,iBAAiB,EAAE,OAAO,EAC1B,mBAAmB,EAAE,MAAM,EAC3B,YAAY,EAAE,MAAM,GAClB,MAAM,CASR"}

package/dist/modes/interactive/runtime-status.js

@@ -0,0 +1,18 @@
+export function applyRuntimeStatusLabel(presentation, label) {
+    if (!presentation.hasHumanAudience || presentation.currentLabel === label)
+        return presentation.currentLabel;
+    if (presentation.loadingAnimation)
+        presentation.loadingAnimation.setMessage(label);
+    else
+        presentation.activityLane?.update("runtime:turn", label);
+    presentation.requestRender();
+    return label;
+}
+export function resolveHiddenThinkingStatus(message, hideThinkingBlock, hiddenThinkingLabel, workingLabel) {
+    if (!hideThinkingBlock)
+        return workingLabel;
+    const hasThinking = message.content.some((content) => content.type === "thinking" && content.thinking.trim().length > 0);
+    const hasVisibleWork = message.content.some((content) => (content.type === "text" && content.text.trim().length > 0) || content.type === "toolCall");
+    return hasThinking && !hasVisibleWork ? hiddenThinkingLabel : workingLabel;
+}
+//# sourceMappingURL=runtime-status.js.map

package/dist/modes/interactive/runtime-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-status.js","sourceRoot":"","sources":["../../../src/modes/interactive/runtime-status.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,uBAAuB,CAAC,YAAuC,EAAE,KAAa;IAC7F,IAAI,CAAC,YAAY,CAAC,gBAAgB,IAAI,YAAY,CAAC,YAAY,KAAK,KAAK;QAAE,OAAO,YAAY,CAAC,YAAY,CAAC;IAC5G,IAAI,YAAY,CAAC,gBAAgB;QAAE,YAAY,CAAC,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;;QAC9E,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAC9D,YAAY,CAAC,aAAa,EAAE,CAAC;IAC7B,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAC1C,OAAyB,EACzB,iBAA0B,EAC1B,mBAA2B,EAC3B,YAAoB;IAEpB,IAAI,CAAC,iBAAiB;QAAE,OAAO,YAAY,CAAC;IAC5C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CACvC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAC9E,CAAC;IACF,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAC1C,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,CACvG,CAAC;IACF,OAAO,WAAW,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,YAAY,CAAC;AAC5E,CAAC","sourcesContent":["import type { AssistantMessage } from \"@caupulican/pi-ai\";\n\nexport interface RuntimeStatusPresentation {\n\thasHumanAudience: boolean;\n\tcurrentLabel: string | undefined;\n\tloadingAnimation: { setMessage(message: string): void } | undefined;\n\tactivityLane: { update(id: string, label: string): void } | undefined;\n\trequestRender(): void;\n}\n\nexport function applyRuntimeStatusLabel(presentation: RuntimeStatusPresentation, label: string): string | undefined {\n\tif (!presentation.hasHumanAudience || presentation.currentLabel === label) return presentation.currentLabel;\n\tif (presentation.loadingAnimation) presentation.loadingAnimation.setMessage(label);\n\telse presentation.activityLane?.update(\"runtime:turn\", label);\n\tpresentation.requestRender();\n\treturn label;\n}\n\nexport function resolveHiddenThinkingStatus(\n\tmessage: AssistantMessage,\n\thideThinkingBlock: boolean,\n\thiddenThinkingLabel: string,\n\tworkingLabel: string,\n): string {\n\tif (!hideThinkingBlock) return workingLabel;\n\tconst hasThinking = message.content.some(\n\t\t(content) => content.type === \"thinking\" && content.thinking.trim().length > 0,\n\t);\n\tconst hasVisibleWork = message.content.some(\n\t\t(content) => (content.type === \"text\" && content.text.trim().length > 0) || content.type === \"toolCall\",\n\t);\n\treturn hasThinking && !hasVisibleWork ? hiddenThinkingLabel : workingLabel;\n}\n"]}

package/docs/json.md

@@ -62,7 +62,7 @@ Extended messages from [`packages/coding-agent/src/core/messages.ts`](https://gi
 Each line is a JSON object. The first line is the session header:
 
 ```json
-{"type":"session","version":3,"id":"uuid","timestamp":"...","cwd":"/path"}
+{"type":"session","version":4,"id":"uuid","timestamp":"...","cwd":"/path"}
 ```
 
 Followed by events as they occur:

package/docs/keybindings.md

@@ -122,13 +122,14 @@ These actions apply while the built-in `ask_question` interaction has focus. The
 | `app.model.cycleForward` | `ctrl+p` | Cycle to next model |
 | `app.model.cycleBackward` | `shift+ctrl+p` | Cycle to previous model |
 | `app.thinking.cycle` | `shift+tab` | Cycle thinking level |
-| `app.thinking.toggle` | `ctrl+t` | Show or hide thinking blocks (hidden by default) |
+| `app.thinking.toggle` | `shift+pageUp` | Show or hide thinking blocks (hidden by default) |
 
 ### Display and Message Queue
 
 | Keybinding id | Default | Description |
 |--------|---------|-------------|
 | `app.tools.expand` | `ctrl+o` | Expand or collapse tool output (file groups stay as a count + short list until then) |
+| `app.transcript.open` | `ctrl+t` | Open expanded transcript scrollback |
 | `app.history.load` | `ctrl+shift+h` | Load deferred session history into the chat |
 | `app.message.followUp` | `alt+enter` | Queue follow-up message |
 | `app.message.dequeue` | `alt+up` | Restore queued messages to editor |

package/docs/session-format.md

@@ -23,13 +23,14 @@ Sessions have a version field in the header:
 - **Version 1**: Linear entry sequence (legacy, auto-migrated on load)
 - **Version 2**: Tree structure with `id`/`parentId` linking
 - **Version 3**: Renamed `hookMessage` role to `custom` (extensions unification)
+- **Version 4**: Added bounded provider-request, foreground-tool, and compaction lifecycle records for crash recovery
 
-Existing sessions are automatically migrated to the current version (v3) when loaded.
+Existing sessions are automatically migrated to the current version (v4) when loaded.
 
 ## Source Files
 
 Source on GitHub ([pi-mono](https://github.com/earendil-works/pi-mono)):
-- [`packages/coding-agent/src/core/session-manager.ts`](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/core/session-manager.ts) - Session entry types and SessionManager
+- [`packages/agent/src/session/session-manager.ts`](https://github.com/earendil-works/pi-mono/blob/main/packages/agent/src/session/session-manager.ts) - Session entry types and SessionManager
 - [`packages/coding-agent/src/core/messages.ts`](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/core/messages.ts) - Extended message types (BashExecutionMessage, CustomMessage, etc.)
 - [`packages/ai/src/types.ts`](https://github.com/earendil-works/pi-mono/blob/main/packages/ai/src/types.ts) - Base message types (UserMessage, AssistantMessage, ToolResultMessage)
 - [`packages/agent/src/types.ts`](https://github.com/earendil-works/pi-mono/blob/main/packages/agent/src/types.ts) - AgentMessage union type
@@ -188,13 +189,13 @@ interface SessionEntryBase {
 First line of the file. Metadata only, not part of the tree (no `id`/`parentId`).
 
 ```json
-{"type":"session","version":3,"id":"uuid","timestamp":"2024-12-03T14:00:00.000Z","cwd":"/path/to/project"}
+{"type":"session","version":4,"id":"uuid","timestamp":"2024-12-03T14:00:00.000Z","cwd":"/path/to/project"}
 ```
 
 For sessions with a parent (created via `/fork`, `/clone`, or `newSession({ parentSession })`):
 
 ```json
-{"type":"session","version":3,"id":"uuid","timestamp":"2024-12-03T14:00:00.000Z","cwd":"/path/to/project","parentSession":"/path/to/original/session.jsonl"}
+{"type":"session","version":4,"id":"uuid","timestamp":"2024-12-03T14:00:00.000Z","cwd":"/path/to/project","parentSession":"/path/to/original/session.jsonl"}
 ```
 
 ### SessionMessageEntry
@@ -290,6 +291,37 @@ Session metadata (e.g., user-defined display name). Set via `/name`, `--name` /
 
 The session name is displayed in the session selector (`/resume`) instead of the first message when set.
 
+### Lifecycle Entries (v4)
+
+Lifecycle entries make interrupted foreground work recoverable without duplicating provider-visible data. They participate in tree ancestry but are excluded from model context and hidden from ordinary `/tree` views.
+
+`RequestSnapshotEntry` is force-flushed before provider transport. It contains only the accepted model identity, bounded SHA-256 fingerprints, and bounded message-entry IDs; it never stores prompt text, tool arguments, results, credentials, or headers.
+
+```json
+{"type":"request_snapshot","id":"r1","parentId":"u1","timestamp":"2026-08-21T12:00:00.000Z","requestId":"0198...","reason":"initial","api":"anthropic-messages","provider":"amazon-bedrock","modelId":"global.anthropic.claude-haiku-4-5-20251001-v1:0","effectiveConfigFingerprint":"...","systemFingerprint":"...","toolsFingerprint":"...","historyFingerprint":"...","messageEntryIds":["u1"]}
+```
+
+`ForegroundToolStartEntry` is written after validation/policy checks and before a prepared tool body starts. Parallel waves are appended in one bounded batch.
+
+```json
+{"type":"foreground_tool_start","id":"t1","parentId":"a1","timestamp":"2026-08-21T12:00:01.000Z","requestId":"0198...","assistantMessageEntryId":"a1","callId":"toolu_123","toolName":"bash"}
+```
+
+`ForegroundToolTerminalEntry` is written only after the canonical `toolResult` message. Its composite identity is `(requestId, assistantMessageEntryId, callId)`.
+
+```json
+{"type":"foreground_tool_terminal","id":"t2","parentId":"result1","timestamp":"2026-08-21T12:00:02.000Z","requestId":"0198...","assistantMessageEntryId":"a1","callId":"toolu_123","toolName":"bash","outcome":"success","resultMessageEntryId":"result1"}
+```
+
+`CompactionStartEntry` and `CompactionEndEntry` bracket one complete compaction retry ladder. A successful end references the canonical `compaction` entry; interrupted runs are closed as `interrupted` during reopen repair.
+
+```json
+{"type":"compaction_start","id":"c1","parentId":"m1","timestamp":"2026-08-21T12:01:00.000Z","compactionId":"...","firstKeptEntryId":"m1","tokensBefore":50000}
+{"type":"compaction_end","id":"c3","parentId":"c2","timestamp":"2026-08-21T12:01:03.000Z","compactionId":"...","outcome":"success","compactionEntryId":"c2"}
+```
+
+On reopen, deterministic repair distinguishes calls that were never started from started calls whose outcome is unknown. Duplicate, contradictory, ambiguous, or out-of-order records are refused and surfaced for manual review rather than guessed.
+
 ## Tree Structure
 
 Entries form a tree:
@@ -315,6 +347,7 @@ Entries form a tree:
    - Then messages from `firstKeptEntryId` to compaction
    - Then messages after compaction
 4. Converts `BranchSummaryEntry` and `CustomMessageEntry` to appropriate message formats
+5. Ignores lifecycle-only entries while preserving their ancestry for recovery
 
 ## Parsing Example
 
@@ -354,6 +387,21 @@ for (const line of lines) {
     case "thinking_level_change":
       console.log(`[${entry.id}] Thinking: ${entry.thinkingLevel}`);
       break;
+    case "request_snapshot":
+      console.log(`[${entry.id}] Request ${entry.requestId}: ${entry.provider}/${entry.modelId}`);
+      break;
+    case "foreground_tool_start":
+      console.log(`[${entry.id}] Tool started: ${entry.toolName}/${entry.callId}`);
+      break;
+    case "foreground_tool_terminal":
+      console.log(`[${entry.id}] Tool ${entry.outcome}: ${entry.toolName}/${entry.callId}`);
+      break;
+    case "compaction_start":
+      console.log(`[${entry.id}] Compaction started: ${entry.compactionId}`);
+      break;
+    case "compaction_end":
+      console.log(`[${entry.id}] Compaction ${entry.outcome}: ${entry.compactionId}`);
+      break;
   }
 }
 ```
@@ -380,6 +428,7 @@ Key methods for working with sessions programmatically.
 
 ### Instance Methods - Appending (all return entry ID)
 - `appendMessage(message)` - Add message
+- `appendMessageBatch(entries)` - Atomically append a bounded source-order message/custom-message batch
 - `appendThinkingLevelChange(level)` - Record thinking change
 - `appendModelChange(provider, modelId)` - Record model change
 - `appendCompaction(summary, firstKeptEntryId, tokensBefore, details?, fromHook?)` - Add compaction
@@ -387,6 +436,10 @@ Key methods for working with sessions programmatically.
 - `appendSessionInfo(name)` - Set session display name
 - `appendCustomMessageEntry(customType, content, display, details?)` - Extension message (in context)
 - `appendLabelChange(targetId, label)` - Set/clear label
+- `appendRequestSnapshot(snapshot)` - Force-flush a bounded accepted-request record
+- `appendForegroundToolStarts(starts)` - Atomically reserve one prepared tool wave
+- `appendForegroundToolTerminal(...)` - Link a started call to its canonical result
+- `appendCompactionStart(...)` / `appendCompactionEnd(...)` - Bracket a compaction retry ladder
 
 ### Instance Methods - Tree Navigation
 - `getLeafId()` - Current position
@@ -402,6 +455,8 @@ Key methods for working with sessions programmatically.
 
 ### Instance Methods - Context & Info
 - `buildSessionContext()` - Get messages, thinkingLevel, and model for LLM
+- `inspectSessionLifecycle()` - Validate the active branch lifecycle and classify incomplete work
+- `planSessionLifecycleRepair()` - Produce a deterministic repair plan or a refusal with reasons
 - `getEntries()` - All entries (excluding header)
 - `getHeader()` - Session header metadata
 - `getSessionName()` - Get display name from latest session_info entry

package/examples/extensions/custom-provider-anthropic/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-custom-provider",
-  "version": "0.93.17",
+  "version": "0.93.19",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-custom-provider",
-      "version": "0.93.17",
+      "version": "0.93.19",
       "dependencies": {
         "@anthropic-ai/sdk": "^0.52.0"
       }

package/examples/extensions/custom-provider-anthropic/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-custom-provider-anthropic",
   "private": true,
-  "version": "0.93.17",
+  "version": "0.93.19",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/examples/extensions/custom-provider-gitlab-duo/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-custom-provider-gitlab-duo",
   "private": true,
-  "version": "0.93.17",
+  "version": "0.93.19",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/examples/extensions/sandbox/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "pi-extension-sandbox",
-	"version": "0.93.17",
+	"version": "0.93.19",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "pi-extension-sandbox",
-			"version": "0.93.17",
+			"version": "0.93.19",
 			"dependencies": {
 				"@anthropic-ai/sandbox-runtime": "^0.0.26"
 			}

package/examples/extensions/sandbox/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "pi-extension-sandbox",
 	"private": true,
-	"version": "0.93.17",
+	"version": "0.93.19",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/with-deps/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-with-deps",
-  "version": "0.93.17",
+  "version": "0.93.19",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-with-deps",
-      "version": "0.93.17",
+      "version": "0.93.19",
       "dependencies": {
         "ms": "^2.1.3"
       },

package/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-with-deps",
   "private": true,
-  "version": "0.93.17",
+  "version": "0.93.19",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/npm-shrinkwrap.json

@@ -1,17 +1,17 @@
 {
 	"name": "@caupulican/pi-adaptative",
-	"version": "0.93.17",
+	"version": "0.93.19",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@caupulican/pi-adaptative",
-			"version": "0.93.17",
+			"version": "0.93.19",
 			"license": "MIT",
 			"dependencies": {
-				"@caupulican/pi-agent-core": "^0.93.17",
-				"@caupulican/pi-ai": "^0.93.17",
-				"@caupulican/pi-tui": "^0.93.17",
+				"@caupulican/pi-agent-core": "^0.93.19",
+				"@caupulican/pi-ai": "^0.93.19",
+				"@caupulican/pi-tui": "^0.93.19",
 				"@silvia-odwyer/photon-node": "0.3.4",
 				"chalk": "5.6.2",
 				"cross-spawn": "7.0.6",
@@ -506,11 +506,11 @@
 			}
 		},
 		"node_modules/@caupulican/pi-agent-core": {
-			"version": "0.93.17",
-			"resolved": "https://registry.npmjs.org/@caupulican/pi-agent-core/-/pi-agent-core-0.93.17.tgz",
+			"version": "0.93.19",
+			"resolved": "https://registry.npmjs.org/@caupulican/pi-agent-core/-/pi-agent-core-0.93.19.tgz",
 			"license": "MIT",
 			"dependencies": {
-				"@caupulican/pi-ai": "^0.93.17",
+				"@caupulican/pi-ai": "^0.93.19",
 				"ignore": "7.0.5",
 				"typebox": "1.1.38",
 				"yaml": "2.9.0"
@@ -520,8 +520,8 @@
 			}
 		},
 		"node_modules/@caupulican/pi-ai": {
-			"version": "0.93.17",
-			"resolved": "https://registry.npmjs.org/@caupulican/pi-ai/-/pi-ai-0.93.17.tgz",
+			"version": "0.93.19",
+			"resolved": "https://registry.npmjs.org/@caupulican/pi-ai/-/pi-ai-0.93.19.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"@anthropic-ai/sdk": "0.117.1",
@@ -546,8 +546,8 @@
 			}
 		},
 		"node_modules/@caupulican/pi-tui": {
-			"version": "0.93.17",
-			"resolved": "https://registry.npmjs.org/@caupulican/pi-tui/-/pi-tui-0.93.17.tgz",
+			"version": "0.93.19",
+			"resolved": "https://registry.npmjs.org/@caupulican/pi-tui/-/pi-tui-0.93.19.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"get-east-asian-width": "1.6.0",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@caupulican/pi-adaptative",
-	"version": "0.93.17",
+	"version": "0.93.19",
 	"description": "Adaptive fork of Pi coding agent for self-evolving agent harness experiments",
 	"type": "module",
 	"piConfig": {
@@ -89,9 +89,9 @@
 		"postinstall": "node scripts/postinstall-python-runtime.mjs"
 	},
 	"dependencies": {
-		"@caupulican/pi-agent-core": "^0.93.17",
-		"@caupulican/pi-ai": "^0.93.17",
-		"@caupulican/pi-tui": "^0.93.17",
+		"@caupulican/pi-agent-core": "^0.93.19",
+		"@caupulican/pi-ai": "^0.93.19",
+		"@caupulican/pi-tui": "^0.93.19",
 		"@silvia-odwyer/photon-node": "0.3.4",
 		"chalk": "5.6.2",
 		"cross-spawn": "7.0.6",