@timurproko/a1 0.1.8-dev.157 → 0.1.8-dev.214

package/dist/foundation/release/update.js

@@ -96,18 +96,18 @@ export function createUpdateLifecycleCoordinator(environment = process.env, file
                 await removeEndpointArtifacts(owner.paths.endpointMetadataPath, owner.paths.endpoint);
                 return { priorActiveVersion };
             }
-            // Leaving sessions alone is the expected outcome, and saying so mid-update tears
+            // Rationale: leaving sessions alone is the expected outcome, and saying so mid-update tears
             // the progress bar; only ending a session (below) is worth interrupting it for.
             if (plan === "leave-running")
                 return { priorActiveVersion };
-            // Say whose work is ending before it ends.
+            // Rationale: say whose work is ending before it ends.
             const live = endpoint.ownership.liveInstanceIds.length;
             if (live > 0) {
                 output.stderr(`${PRODUCT_TEXT.diagnostic(`ending ${live === 1 ? "one session" : `${live} sessions`} that run from the installation being replaced; a session started by an installed release would have been left alone.`)}\n`);
             }
             const identity = await requestUpdateShutdown(endpoint, targetVersion, 2_000);
             if (!identity.accepted && processIsAlive(endpoint.pid)) {
-                // Explicit update consent permits bounded cleanup of an authenticated
+                // Security: explicit update consent permits bounded cleanup of an authenticated
                 // older owner that predates the update-shutdown message.
                 const cleanup = await cleanupVerifiedOwner(endpoint, { allowLiveInstances: true, reason: "legacy-mutable-install" });
                 if (!cleanup.terminated)
@@ -133,7 +133,7 @@ export function createUpdateLifecycleCoordinator(environment = process.env, file
                 await rename(probe, packageRoot);
             }
             catch (error) {
-                // Best-effort rollback if the first rename succeeded and the second did not.
+                // Invariant: best-effort rollback runs if the first rename succeeded and the second did not.
                 await rename(probe, packageRoot).catch(() => { });
                 throw new Error(PRODUCT_TEXT.diagnostic(`package remains locked after verified shutdown: ${errorMessage(error)}`));
             }
@@ -214,7 +214,7 @@ function createUpdateProgress(output, enabled) {
             draw();
             if (creepTo <= current)
                 return;
-            // Creep asymptotically toward (but never reach) the next milestone so
+            // Rationale: creep asymptotically toward (but never reach) the next milestone so
             // long opaque phases such as npm install still show visible motion. The
             // ceiling stays a whole point below the milestone: settling on `creepTo`
             // itself would render as that milestone and make arriving at it invisible,
@@ -225,7 +225,7 @@ function createUpdateProgress(output, enabled) {
             }, PROGRESS_TICK_MS);
             timer.unref?.();
         },
-        // The bar exists to say the update is still moving. Once it has finished
+        // Rationale: the bar exists to say the update is still moving. Once it has finished
         // there is a better line to occupy that row — the one naming what is now
         // installed — so the bar gives the row back rather than leaving a full
         // meter above a message that already implies it.
@@ -283,7 +283,7 @@ async function resolveRequestedPreview(runner, requested, output) {
     const versions = (Array.isArray(published) ? published : [published]).filter((value) => typeof value === "string");
     const exact = versions.find(version => version === requested);
     if (exact !== undefined) {
-        // Naming a release here would install it through the preview path, which is a
+        // Rationale: naming a release here would install it through the preview path, which is a
         // different command with a different meaning.
         if (!exact.includes("-dev.")) {
             output.stderr(`${PRODUCT_TEXT.diagnostic(`${exact} is a release, not a preview; run ${PRODUCT_TEXT.commandName} update to move to the current release.`)}\n`);
@@ -336,7 +336,7 @@ export async function runSelfUpdate(options) {
     if (resolved.version === null)
         return resolved.exitCode;
     const targetVersion = resolved.version;
-    // No full stop after a version: it already ends in a dot-separated identifier,
+    // Rationale: no full stop after a version: it already ends in a dot-separated identifier,
     // and a trailing one reads as part of the version rather than as punctuation.
     output.stdout(`${PRODUCT_TEXT.commandName} update: ${runningVersion} → ${targetVersion}\n`);
     const progress = createUpdateProgress(output, options.progress ?? (options.output === undefined && process.stdout.isTTY === true));
@@ -375,7 +375,7 @@ export async function runSelfUpdate(options) {
             output.stdout(`${PRODUCT_TEXT.commandName} is up to date — no update needed.\n`);
             return 0;
         }
-        // The bar first appears here so a no-change run never flashes it.
+        // Rationale: the bar first appears here so a no-change run never flashes it.
         progress.set(3, 15);
         const cohortState = await new CohortStateStore(paths.dataDir).read();
         transaction = await transactionStore.begin({
@@ -403,7 +403,7 @@ export async function runSelfUpdate(options) {
             }
             transaction = await transactionStore.advance("package-installed");
         }
-        // npm 12 blocks install scripts unless allowScripts covers the package, so
+        // Compatibility: npm 12 blocks install scripts unless allowScripts covers the package, so
         // the postinstall that points the #pi-tui proxy at the tree npm just built
         // may never have run. Run the shipped script directly: the proxy must be
         // correct before the release store copies this tree. A failure is reported
@@ -417,7 +417,7 @@ export async function runSelfUpdate(options) {
             output.stderr(`${PRODUCT_TEXT.diagnostic(`could not point the #pi-tui proxy at the installed tree: ${errorMessage(error)}`)}\n`);
         }
         progress.set(70, 75);
-        // Ownership can be reacquired after an interrupted installation (for
+        // Concurrency: ownership can be reacquired after an interrupted installation (for
         // example, if bare A1 is launched before the update is resumed). Recheck
         // immediately before activation so recovery cannot start a second cohort.
         await measure("ownership-release", async () => { await lifecycle.shutdownVerifiedOwners(targetVersion); });
@@ -530,7 +530,7 @@ async function rollbackPriorCohort(dataDir, environment, priorReleaseId) {
     }
     const release = await readMaterializedRelease(prior.releaseRoot);
     const paths = resolveProductPaths(environment);
-    // Rollback re-points the active reference and starts the prior cohort on its own endpoint;
+    // Invariant: rollback re-points the active reference and starts the prior cohort on its own endpoint;
     // a cohort that survived the update keeps serving the work it already had.
     await startSupervisor(release, environment);
     await waitForVerifiedEndpoint(resolveCohortEndpoint(paths, release.releaseId, environment).endpointMetadataPath, release, 8_000);

package/dist/foundation/storage/control-store.d.ts

@@ -14,6 +14,7 @@ export interface StoredWorkspaceAgent {
     readonly agent: ManagedAgentDescriptor;
     readonly presentation: WorkspaceAgentPresentation;
 }
+/** Owns WAL-backed control persistence and reconciles prior-boot records before current use. */
 export declare class ControlStore {
     #private;
     readonly bootNonce: string | null;

package/dist/foundation/storage/control-store.js

@@ -6,6 +6,7 @@ import { assertManagedAgentDescriptor, assertRecoveryAuthority, assertTerminalSe
 import { assertLaunchInstance, assertLaunchInstanceOutcome, assertNativeProcessIdentity, assertProcessContainmentIdentity, } from "../lifecycle/index.js";
 export const DEFAULT_WORKSPACE_ID = "workspace-default";
 const INITIAL_WORKSPACE_ID = DEFAULT_WORKSPACE_ID;
+/** Owns WAL-backed control persistence and reconciles prior-boot records before current use. */
 export class ControlStore {
     bootNonce;
     database;

package/dist/foundation/structured-agent-runtime/backpressure.d.ts

@@ -33,6 +33,7 @@ export type StructuredBackpressureReleaseResult = {
     readonly code: "unknown-lease" | "invalid-request";
     readonly diagnostic: string;
 };
+/** Issues bounded resource leases and selects the negotiated backpressure action on exhaustion. */
 export declare class StructuredBackpressureController {
     #private;
     readonly adapterId: string;

package/dist/foundation/structured-agent-runtime/backpressure.js

@@ -1,4 +1,5 @@
 import { assertStructuredCapability, } from "../../contracts/workspace/index.js";
+/** Issues bounded resource leases and selects the negotiated backpressure action on exhaustion. */
 export class StructuredBackpressureController {
     adapterId;
     #budgets;

package/dist/foundation/structured-agent-runtime/commands.d.ts

@@ -38,6 +38,7 @@ export type StructuredCommandOutcomeResult = {
     readonly code: string;
     readonly diagnostic: string;
 };
+/** Tracks structured commands by correlation identity through one idempotent terminal outcome. */
 export declare class StructuredCommandTracker {
     #private;
     readonly agentId: string;

package/dist/foundation/structured-agent-runtime/commands.js

@@ -1,4 +1,5 @@
 import { assertStructuredCapability, assertWorkspaceCommand, } from "../../contracts/workspace/index.js";
+/** Tracks structured commands by correlation identity through one idempotent terminal outcome. */
 export class StructuredCommandTracker {
     agentId;
     #capability;

package/dist/foundation/structured-agent-runtime/reconnection.d.ts

@@ -30,6 +30,7 @@ export type StructuredReconnectionResult = {
     readonly code: string;
     readonly diagnostic: string;
 };
+/** Accepts a recovery boundary once after validating negotiated identity, proof, and protocol continuity. */
 export declare class StructuredReconnectionManager {
     #private;
     constructor(capability: StructuredCapabilityContract);

package/dist/foundation/structured-agent-runtime/reconnection.js

@@ -1,5 +1,6 @@
 import { WORKSPACE_CONTRACT_VERSION, assertRecoveryAuthority, assertStructuredAgentSnapshot, assertStructuredCapability, } from "../../contracts/workspace/index.js";
 import { StructuredEventReducer } from "./state.js";
+/** Accepts a recovery boundary once after validating negotiated identity, proof, and protocol continuity. */
 export class StructuredReconnectionManager {
     #capability;
     #acceptedBoundaries = new Set();

package/dist/foundation/structured-agent-runtime/state.d.ts

@@ -44,6 +44,7 @@ export type StructuredSnapshotApplyResult = {
     readonly code: string;
     readonly diagnostic: string;
 };
+/** Applies ordered structured events and snapshots while exposing gaps as explicit resynchronization. */
 export declare class StructuredEventReducer {
     #private;
     readonly agentId: string;

package/dist/foundation/structured-agent-runtime/state.js

@@ -1,4 +1,5 @@
 import { assertStructuredAgentSnapshot, assertStructuredCapability, assertWorkspaceEvent, } from "../../contracts/workspace/index.js";
+/** Applies ordered structured events and snapshots while exposing gaps as explicit resynchronization. */
 export class StructuredEventReducer {
     agentId;
     #capability;

package/dist/foundation/supervision/main.js

@@ -19,7 +19,7 @@ export async function runSupervisor() {
         throw new Error(PRODUCT_TEXT.diagnostic("supervisor must be launched from a verified immutable release"));
     const release = await readCertifiedReleaseManifest({ releaseRoot, releaseId, contentDigest }, resolve(paths.dataDir, "releases"));
     await assertImmutableExecutionRoot(release, paths.dataDir);
-    // One endpoint per cohort: a superseded cohort keeps serving what it already has while the
+    // Protocol: one endpoint per cohort: a superseded cohort keeps serving what it already has while the
     // installed release listens on its own address.
     paths = { ...productPaths, ...resolveCohortEndpoint(productPaths, release.releaseId) };
     const bootNonce = randomUUID();

package/dist/foundation/supervision/server.d.ts

@@ -2,6 +2,7 @@ import { type SupervisorSnapshot } from "../lifecycle/index.js";
 import { type MaterializedRelease } from "../release/index.js";
 import { ControlStore } from "../storage/index.js";
 import { type ProductPaths } from "./paths.js";
+/** Owns one release-cohort endpoint and the authenticated launch instances registered through it. */
 export declare class SupervisorServer {
     #private;
     readonly store: ControlStore;

package/dist/foundation/supervision/server.js

@@ -8,6 +8,7 @@ import { processIsAlive } from "../release/index.js";
 import { ControlStore } from "../storage/index.js";
 import { resolveProductPaths } from "./paths.js";
 import { PRODUCT_IDENTITY, PRODUCT_TEXT } from "../../product-identity.js";
+/** Owns one release-cohort endpoint and the authenticated launch instances registered through it. */
 export class SupervisorServer {
     store;
     release;
@@ -90,10 +91,7 @@ export class SupervisorServer {
             this.#supersededPoll = poll;
         }
     }
-    /**
-     * Notices that another release has become the one new sessions start on. Nothing is
-     * interrupted by that: this cohort finishes what it is holding and then leaves.
-     */
+    // Invariant: superseding a cohort never interrupts its held instances; it retires only when empty.
     async #refreshCohortRole() {
         if (this.#closing || !this.readActiveReleaseId)
             return;
@@ -327,7 +325,7 @@ export class SupervisorServer {
         this.#uncertainInstances.delete(stored.id);
         this.#unbindOwner(stored.id, socket);
         this.#mutated();
-        // The last session on a superseded cohort has left; there is nothing here to keep.
+        // Invariant: the last session on a superseded cohort has left; there is nothing here to keep.
         if (this.#superseded && this.#instances.size === 0)
             void this.retire();
     }
@@ -421,7 +419,7 @@ export class SupervisorServer {
         const deadline = Date.now() + timeoutMs;
         while (Date.now() < deadline) {
             if (this.#instances.size === 0) {
-                // Let the terminal command result flush before closing owner sockets.
+                // Concurrency: allow the terminal command result to flush before closing owner sockets.
                 await new Promise(resolvePromise => setTimeout(resolvePromise, 25));
                 return this.#instances.size === 0;
             }

package/dist/integrations/pi/components/conformance.d.ts

@@ -10,6 +10,7 @@ export interface PiComponentConformanceReport {
     readonly componentResults: readonly PiComponentConformanceResult[];
     readonly componentFamilies: readonly string[];
 }
+/** Identifies the Pi presentation-conformance stage that failed against the pinned component surface. */
 export declare class PiComponentConformanceError extends Error {
     readonly stage: "theme" | "components";
     constructor(stage: "theme" | "components", cause: unknown);

package/dist/integrations/pi/components/conformance.js

@@ -5,6 +5,7 @@ import { AssistantMessageComponent, ExtensionSelectorComponent, initTheme, Login
 import { OWNED_UI_CONTRACT_VERSION } from "../../../contracts/owned-ui/index.js";
 import { createTuiFacade, validatedAssistantMessage } from "./shell-components.js";
 import { PRODUCT_IDENTITY } from "../../../product-identity.js";
+/** Identifies the Pi presentation-conformance stage that failed against the pinned component surface. */
 export class PiComponentConformanceError extends Error {
     stage;
     constructor(stage, cause) {

package/dist/integrations/pi/components/shell-components.d.ts

@@ -2,5 +2,6 @@ export * from "./shell-shared-facade.js";
 export * from "./shell-editor-autocomplete.js";
 export * from "./shell-selectors-dialogs.js";
 export * from "./shell-presenters-transcript.js";
+export * from "./shell-presenters-info.js";
 export * from "./shell-footer-status.js";
 export * from "./shell-extension-ui.js";

package/dist/integrations/pi/components/shell-components.js

@@ -2,5 +2,6 @@ export * from "./shell-shared-facade.js";
 export * from "./shell-editor-autocomplete.js";
 export * from "./shell-selectors-dialogs.js";
 export * from "./shell-presenters-transcript.js";
+export * from "./shell-presenters-info.js";
 export * from "./shell-footer-status.js";
 export * from "./shell-extension-ui.js";

package/dist/integrations/pi/components/shell-editor-autocomplete.js

@@ -158,6 +158,16 @@ export function createPiShellEditor(options) {
         setSubmitHandler: handler => { submitHandler = handler; },
         setInterruptHandler: handler => { interruptHandler = handler; },
         setAutocompleteCommands,
+        setPaddingX(padding) {
+            editor.setPaddingX(padding);
+            editor.invalidate();
+            tui.requestRender();
+        },
+        setAutocompleteMaxVisible(maxVisible) {
+            editor.setAutocompleteMaxVisible(maxVisible);
+            editor.invalidate();
+            tui.requestRender();
+        },
         addAutocompleteProvider(factory) {
             if (typeof factory !== "function")
                 throw new TypeError("extension autocomplete factory must be a function");

package/dist/integrations/pi/components/shell-footer-status.d.ts

@@ -2,6 +2,6 @@ import type { OwnedUiSessionViewModel } from "../../../contracts/owned-ui/index.
 import { type PiShellViewComponentPort, type PiShellStatusPort, type PiShellQueuedInputPort, type PiShellHeaderPort, type PiShellResourceEntry, type PiShellLoadedResourcesPort, type PiShellHeaderOptions, type PiShellEditorOptions } from "./shell-shared-facade.js";
 export declare function createPiShellHeader(options?: PiShellHeaderOptions): PiShellHeaderPort;
 export declare function createPiShellLoadedResources(resources: readonly PiShellResourceEntry[], initialExpanded?: boolean): PiShellLoadedResourcesPort;
-export declare function createPiShellStatus(view: OwnedUiSessionViewModel, runtime?: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellStatusPort;
+export declare function createPiShellStatus(view: OwnedUiSessionViewModel, formatProgressStatus: (message: string) => string, runtime?: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellStatusPort;
 export declare function createPiShellFooter(view: OwnedUiSessionViewModel, cwd: string): PiShellViewComponentPort;
 export declare function createPiQueuedInputStatus(submissions: readonly string[], presentation?: "pinned" | "custom-viewport"): PiShellQueuedInputPort;

package/dist/integrations/pi/components/shell-footer-status.js

@@ -67,20 +67,21 @@ export function createPiShellLoadedResources(resources, initialExpanded = false)
         invalidate() { },
     };
 }
-export function createPiShellStatus(view, runtime) {
+export function createPiShellStatus(view, formatProgressStatus, runtime) {
     ensureTheme();
     const statusUi = createTuiFacade(runtime ?? { getColumns: () => 80, getRows: () => 24, requestRender() { } });
     let workingOverride;
-    let component = statusComponent(view, statusUi, workingOverride);
-    let signature = statusSignature(view, workingOverride);
+    let outputPad = PINNED_PI_LAYOUT.outputPad;
+    let component = statusComponent(view, statusUi, workingOverride, outputPad, formatProgressStatus);
+    let signature = statusSignature(view, workingOverride, outputPad);
     const rebuild = () => {
-        const nextSignature = statusSignature(view, workingOverride);
+        const nextSignature = statusSignature(view, workingOverride, outputPad);
         if (nextSignature === signature)
             return;
         if (component !== undefined && "dispose" in component && typeof component.dispose === "function")
             component.dispose();
         signature = nextSignature;
-        component = statusComponent(view, statusUi, workingOverride);
+        component = statusComponent(view, statusUi, workingOverride, outputPad, formatProgressStatus);
     };
     return {
         render: width => component?.render(width) ?? [],
@@ -93,6 +94,10 @@ export function createPiShellStatus(view, runtime) {
             workingOverride = message;
             rebuild();
         },
+        setOutputPad(padding) {
+            outputPad = padding;
+            rebuild();
+        },
         dispose() {
             if (component !== undefined && "dispose" in component && typeof component.dispose === "function")
                 component.dispose();
@@ -121,19 +126,20 @@ export function createPiQueuedInputStatus(submissions, presentation = "pinned")
         },
     };
 }
-function statusComponent(view, ui, workingOverride) {
-    if (view.lifecycle === "busy")
-        return new WorkingStatusIndicator(ui, workingOverride ?? view.status.workingMessage ?? "Working...");
+function statusComponent(view, ui, workingOverride, outputPad, formatProgressStatus) {
+    if (view.lifecycle === "busy") {
+        return new WorkingStatusIndicator(ui, formatProgressStatus(workingOverride ?? view.status.workingMessage ?? "Working"));
+    }
     if (view.lifecycle === "failed") {
-        return new Text(piTheme().fg("error", view.status.diagnostics.at(-1) ?? "Session failed"), PINNED_PI_LAYOUT.outputPad, 0);
+        return new Text(piTheme().fg("error", view.status.diagnostics.at(-1) ?? "Session failed"), outputPad, 0);
     }
     if (view.status.workingMessage !== null) {
-        return new Text(piTheme().fg("muted", view.status.workingMessage), PINNED_PI_LAYOUT.outputPad, 0);
+        return new Text(piTheme().fg("muted", view.status.workingMessage), outputPad, 0);
     }
     return undefined;
 }
-function statusSignature(view, workingOverride) {
-    return `${view.lifecycle}\u0000${workingOverride ?? ""}\u0000${view.status.workingMessage ?? ""}\u0000${view.status.diagnostics.at(-1) ?? ""}`;
+function statusSignature(view, workingOverride, outputPad) {
+    return `${outputPad}\u0000${view.lifecycle}\u0000${workingOverride ?? ""}\u0000${view.status.workingMessage ?? ""}\u0000${view.status.diagnostics.at(-1) ?? ""}`;
 }
 function queuedInputText(submissions, presentation) {
     if (submissions.length === 0)
@@ -144,7 +150,7 @@ function queuedInputText(submissions, presentation) {
     }
     const messages = submissions.map(submission => theme.fg("dim", `Steering: ${submission.replaceAll("\n", " ⏎ ")}`));
     const dequeueHint = theme.fg("dim", "↳ Alt+Up to edit all queued messages");
-    // The custom viewport matches Pi's interactive queue presentation while the
+    // Compatibility: the custom viewport matches Pi's interactive queue presentation while the
     // comparison shell remains byte-for-byte compatible with its pinned fixture.
     return ["", ...messages, dequeueHint].join("\n");
 }

package/dist/integrations/pi/components/shell-presenters-info.d.ts

@@ -0,0 +1,36 @@
+import { type PiShellComponentPort } from "./shell-shared-facade.js";
+export interface PiShellSessionInfoPresentation {
+    readonly sessionName?: string;
+    readonly stats: {
+        readonly sessionFile?: string;
+        readonly sessionId: string;
+        readonly userMessages: number;
+        readonly assistantMessages: number;
+        readonly toolCalls: number;
+        readonly toolResults: number;
+        readonly totalMessages: number;
+        readonly tokens: {
+            readonly input: number;
+            readonly output: number;
+            readonly cacheRead: number;
+            readonly cacheWrite: number;
+            readonly total: number;
+        };
+        readonly cost: number;
+    };
+    readonly cacheWaste: {
+        readonly missedTokens: number;
+        readonly missedCost: number;
+        readonly missCount: number;
+    };
+    readonly usageBreakdown: readonly {
+        readonly key: string;
+        readonly cost: number;
+        readonly tokens: number;
+    }[];
+}
+export declare function renderPiShellStatusText(message: string, width: number, outputPad?: 0 | 1): readonly string[];
+export declare function createPiShellSessionInfo(presentation: PiShellSessionInfoPresentation): PiShellComponentPort;
+export declare function createPiShellCollapsedChangelog(): PiShellComponentPort;
+export declare function createPiShellChangelog(markdown: string): PiShellComponentPort;
+export declare function createPiShellHotkeys(): PiShellComponentPort;

package/dist/integrations/pi/components/shell-presenters-info.js

@@ -0,0 +1,78 @@
+import { DynamicBorder, getMarkdownTheme } from "@earendil-works/pi-coding-agent";
+import { Container, Markdown, Spacer, Text } from "#pi-tui";
+import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
+import { PINNED_PI_LAYOUT, piTheme } from "./theme.js";
+import { componentPort, ensureTheme, formatSessionTokens } from "./shell-shared-facade.js";
+export function renderPiShellStatusText(message, width, outputPad = PINNED_PI_LAYOUT.outputPad) {
+    ensureTheme();
+    return new Text(piTheme().fg("dim", message), outputPad, 0).render(width);
+}
+export function createPiShellSessionInfo(presentation) {
+    ensureTheme();
+    const { stats, sessionName, cacheWaste, usageBreakdown } = presentation;
+    let info = `${piTheme().bold("Session Info")}\n\n`;
+    if (sessionName)
+        info += `${piTheme().fg("dim", "Name:")} ${sessionName}\n`;
+    info += `${piTheme().fg("dim", "File:")} ${stats.sessionFile ?? "In-memory"}\n${piTheme().fg("dim", "ID:")} ${stats.sessionId}\n\n`;
+    info += `${piTheme().bold("Messages")}\n${piTheme().fg("dim", "Total:")} ${stats.totalMessages}\n${piTheme().fg("dim", "User:")} ${stats.userMessages}\n`;
+    info += `${piTheme().fg("dim", "Assistant:")} ${stats.assistantMessages}\n${piTheme().fg("dim", "Tools:")} ${stats.toolCalls} calls, ${stats.toolResults} results\n\n`;
+    info += `${piTheme().bold("Tokens")}\n`;
+    const { input, cacheRead, cacheWrite } = stats.tokens;
+    const promptTokens = input + cacheRead + cacheWrite;
+    info += `${piTheme().fg("dim", "Input:")} ${promptTokens.toLocaleString()}\n`;
+    if (promptTokens > 0 && (cacheRead > 0 || cacheWrite > 0)) {
+        info += `  ${piTheme().fg("dim", "Cached:")} ${cacheRead.toLocaleString()} ${piTheme().fg("dim", `(${((cacheRead / promptTokens) * 100).toFixed(1)}%)`)}\n`;
+        const written = cacheWrite > 0 ? ` ${piTheme().fg("dim", `(${cacheWrite.toLocaleString()} written to cache)`)}` : "";
+        info += `  ${piTheme().fg("dim", "Uncached:")} ${(input + cacheWrite).toLocaleString()}${written}\n`;
+    }
+    info += `${piTheme().fg("dim", "Output:")} ${stats.tokens.output.toLocaleString()}\n${piTheme().fg("dim", "Total:")} ${stats.tokens.total.toLocaleString()}\n`;
+    if (stats.cost > 0 || cacheWaste.missedTokens > 0) {
+        info += `\n${piTheme().bold("Cost")}\n${piTheme().fg("dim", "Total:")} $${stats.cost.toFixed(3)}`;
+        if (usageBreakdown.length > 1)
+            for (const entry of usageBreakdown)
+                info += `\n  ${piTheme().fg("dim", `${entry.key}:`)} $${entry.cost.toFixed(3)} ${piTheme().fg("dim", `(${formatSessionTokens(entry.tokens)} tokens)`)}`;
+        if (cacheWaste.missedTokens > 0) {
+            const detail = `${cacheWaste.missedTokens.toLocaleString()} tokens, ${cacheWaste.missCount === 1 ? "1 miss" : `${cacheWaste.missCount} misses`}`;
+            info += cacheWaste.missedCost >= 0.0001 ? `\n${piTheme().fg("dim", "Cache Re-billed:")} $${cacheWaste.missedCost.toFixed(3)} ${piTheme().fg("dim", `(${detail})`)}` : `\n${piTheme().fg("dim", "Cache Re-billed:")} ${detail}`;
+        }
+    }
+    const container = new Container();
+    container.addChild(new Spacer(1));
+    container.addChild(new Text(info, 1, 0));
+    return componentPort(container);
+}
+export function createPiShellCollapsedChangelog() {
+    ensureTheme();
+    const container = new Container();
+    container.addChild(new Spacer(1));
+    container.addChild(new DynamicBorder());
+    container.addChild(new Text(`${piTheme().bold(piTheme().fg("accent", "What's New"))}\n${piTheme().fg("muted", "Run /changelog to view the full release notes.")}`, 1, 0));
+    container.addChild(new DynamicBorder());
+    return componentPort(container);
+}
+export function createPiShellChangelog(markdown) {
+    ensureTheme();
+    const container = new Container();
+    container.addChild(new Spacer(1));
+    container.addChild(new DynamicBorder());
+    container.addChild(new Text(piTheme().bold(piTheme().fg("accent", "What's New")), 1, 0));
+    container.addChild(new Spacer(1));
+    container.addChild(new Markdown(markdown.trim() || "No changelog entries found.", 1, 1, getMarkdownTheme()));
+    container.addChild(new DynamicBorder());
+    return componentPort(container);
+}
+export function createPiShellHotkeys() {
+    ensureTheme();
+    const keys = new KeybindingsManager();
+    const display = (action) => keys.getKeys(action).map(key => key.split("+").map(part => part.charAt(0).toUpperCase() + part.slice(1)).join("+")).join("/");
+    const row = (actions, description) => `| ${actions.map(action => `\`${display(action)}\``).join(" / ")} | ${description} |`;
+    const markdown = ["**Navigation**", "| Key | Action |", "|-----|--------|", row(["tui.editor.cursorUp", "tui.editor.cursorDown", "tui.editor.cursorLeft", "tui.editor.cursorRight"], "Move cursor / browse history"), row(["tui.editor.cursorWordLeft", "tui.editor.cursorWordRight"], "Move by word"), row(["tui.editor.cursorLineStart"], "Start of line"), row(["tui.editor.cursorLineEnd"], "End of line"), row(["tui.editor.jumpForward"], "Jump forward to character"), row(["tui.editor.jumpBackward"], "Jump backward to character"), row(["tui.editor.pageUp", "tui.editor.pageDown"], "Scroll by page"), "", "**Editing**", "| Key | Action |", "|-----|--------|", row(["tui.input.submit"], "Send message"), row(["tui.input.newLine"], `New line${process.platform === "win32" ? " (Ctrl+Enter on Windows Terminal)" : ""}`), row(["tui.editor.deleteWordBackward"], "Delete word backwards"), row(["tui.editor.deleteWordForward"], "Delete word forwards"), row(["tui.editor.deleteToLineStart"], "Delete to start of line"), row(["tui.editor.deleteToLineEnd"], "Delete to end of line"), row(["tui.editor.yank"], "Paste the most-recently-deleted text"), row(["tui.editor.yankPop"], "Cycle through the deleted text after pasting"), row(["tui.editor.undo"], "Undo"), "", "**Other**", "| Key | Action |", "|-----|--------|", row(["tui.input.tab"], "Path completion / accept autocomplete"), row(["app.interrupt"], "Cancel autocomplete / abort streaming"), row(["app.clear"], "Clear editor (first) / exit (second)"), row(["app.exit"], "Exit (when editor is empty)"), row(["app.suspend"], "Suspend to background"), row(["app.thinking.cycle"], "Cycle thinking level"), row(["app.model.cycleForward", "app.model.cycleBackward"], "Cycle models"), row(["app.model.select"], "Open model selector"), row(["app.tools.expand"], "Toggle tool output expansion"), row(["app.thinking.toggle"], "Toggle thinking block visibility"), row(["app.editor.external"], "Edit message in external editor"), row(["app.message.copy"], "Copy last assistant message"), row(["app.message.followUp"], "Queue follow-up message"), row(["app.message.dequeue"], "Restore queued messages"), row(["app.clipboard.pasteImage"], "Paste image or text from clipboard"), "| `/` | Slash commands |", "| `!` | Run bash command |", "| `!!` | Run bash command (excluded from context) |"].join("\n");
+    const container = new Container();
+    container.addChild(new Spacer(1));
+    container.addChild(new DynamicBorder());
+    container.addChild(new Text(piTheme().bold(piTheme().fg("accent", "Keyboard Shortcuts")), 1, 0));
+    container.addChild(new Spacer(1));
+    container.addChild(new Markdown(markdown, 1, 1, getMarkdownTheme()));
+    container.addChild(new DynamicBorder());
+    return componentPort(container);
+}

package/dist/integrations/pi/components/shell-presenters-transcript.d.ts

@@ -1,43 +1,10 @@
 import { AssistantMessageComponent } from "@earendil-works/pi-coding-agent";
+import { type MermaidRenderingMode } from "./upstream/components/mermaid.js";
 import type { OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
 import { type PiShellSubmittedPromptComposer } from "./submitted-prompt-adapter.js";
 export type { PiShellSubmittedPromptComposer } from "./submitted-prompt-adapter.js";
-import { type PiShellComponentPort, type PiShellExtensionRendererResolver, type PiShellTranscriptComponentPort } from "./shell-shared-facade.js";
-export interface PiShellSessionInfoPresentation {
-    readonly sessionName?: string;
-    readonly stats: {
-        readonly sessionFile?: string;
-        readonly sessionId: string;
-        readonly userMessages: number;
-        readonly assistantMessages: number;
-        readonly toolCalls: number;
-        readonly toolResults: number;
-        readonly totalMessages: number;
-        readonly tokens: {
-            readonly input: number;
-            readonly output: number;
-            readonly cacheRead: number;
-            readonly cacheWrite: number;
-            readonly total: number;
-        };
-        readonly cost: number;
-    };
-    readonly cacheWaste: {
-        readonly missedTokens: number;
-        readonly missedCost: number;
-        readonly missCount: number;
-    };
-    readonly usageBreakdown: readonly {
-        readonly key: string;
-        readonly cost: number;
-        readonly tokens: number;
-    }[];
-}
-export declare function renderPiShellStatusText(message: string, width: number): readonly string[];
-export declare function createPiShellSessionInfo(presentation: PiShellSessionInfoPresentation): PiShellComponentPort;
-export declare function createPiShellChangelog(markdown: string): PiShellComponentPort;
-export declare function createPiShellHotkeys(): PiShellComponentPort;
-export declare function createPiShellTranscriptComponent(initial: OwnedUiTranscriptBlock, cwd: string, extensions?: PiShellExtensionRendererResolver, submittedPrompt?: PiShellSubmittedPromptComposer): PiShellTranscriptComponentPort;
+import { type PiShellExtensionRendererResolver, type PiShellImageAssetResolver, type PiShellTranscriptComponentPort } from "./shell-shared-facade.js";
+export declare function createPiShellTranscriptComponent(initial: OwnedUiTranscriptBlock, cwd: string, extensions?: PiShellExtensionRendererResolver, submittedPrompt?: PiShellSubmittedPromptComposer, initialOutputPad?: 0 | 1, initialHideThinkingBlock?: boolean, initialMermaidRenderingMode?: MermaidRenderingMode, initialShowImages?: boolean, initialImageWidthCells?: number, imageAssets?: PiShellImageAssetResolver): PiShellTranscriptComponentPort;
 export declare function renderPiShellTranscriptBlock(block: OwnedUiTranscriptBlock, width: number, cwd: string): readonly string[];
 /**
  * Pinned Pi's CLI prints startup diagnostics with `reportDiagnostics` before