@timurproko/a1 0.1.8-dev.521 → 0.1.8-dev.527

package/README.md

@@ -45,97 +45,6 @@ a1 pi                                   # vanilla Pi oracle: ~/.pi/agent
 Unsupported commands exit quietly without launching anything. The removed
 `update:<preview>` forms are not aliases; use `update --develop`.
 
-## Agent input
-
-The agent prompt and Settings search share one input component: neutral white
-bars and an undimmed arrow matching submitted prompts. Thinking-level color is
-shown on the level name in the status bar, not on the input bars.
-
-In bare A1, **Ctrl+L cycles the thinking level**. **Shift+Tab is unassigned** and
-performs no agent-input action, including while a suggestion is visible. Model
-selection has **no default shortcut**; use `/models`. Explicit keybinding overrides
-remain configurable, and `/hotkeys` shows the resolved bindings. The `a1 pi`
-comparison profile keeps its original presentation and shortcuts.
-
-## Models
-
-Bare A1 has one model command, `/models`, which replaces the pinned `/model` and
-`/scoped-models` pair (those remain in the `a1 pi` comparison profile). The dialog
-lists every authenticated model with `all` and `scoped` filters (Tab), a search box,
-a scope marker before each model id, and the active checkmark after `[provider]`.
-Enter switches to the highlighted model and persists it as the default; Space adds or
-removes it from the Ctrl+P cycling scope for this session only; Ctrl+S saves that scope
-to settings. While the scope or its order differs from the last save, the title reads
-`Models (unsaved)`; Escape closes without saving and keeps the session-only scope.
-`/models <text>` seeds the search instead of switching. The bulk, provider, and reorder
-scope actions keep their existing bindings and appear under `/hotkeys`.
-
-## Reference screens
-
-In bare A1, `/changelog` and `/hotkeys` open a full-screen read-only reference
-screen over the session instead of appending a long document to the
-conversation: `What's New` shows the complete pinned changelog and
-`Keyboard Shortcuts` shows the bare-A1 keybinding tables, including extension
-shortcuts as bound when the screen opens. Scroll with ↑/↓, PageUp/PageDown,
-Home/End, the mouse wheel, or the scrollbar rail, which follows the
-`/settings` → Scroll appearance, style, and speed; press `Esc` to close. The
-screen is framed between two border-coloured rules with the hint below, as the
-v2 extension drew it. After
-an upgrade, the release notes newer than the last acknowledged version open the
-same `What's New` screen once at startup while the feed keeps only the
-`Run /changelog to view the full release notes.` hint. If another dialog is up
-at that moment, the screen is not opened for that launch. The `a1 pi`
-comparison profile keeps Pi's in-feed changelog and hotkeys documents.
-
-## Prompt suggestions
-
-Bare A1's `/settings` → Agent → Prompt suggestions controls faint next-prompt
-predictions. It is enabled by default and uses one additional background request
-with the selected model for eligible turns. Disabling it takes effect immediately.
-Tab accepts a suggestion as editable text; Enter submits it afterward. The setting
-remains stored in A1's profile, and `a1 pi` is unchanged.
-
-Suggestions use the selected model's lowest supported reasoning effort without
-changing your main thinking level. Clear next actions such as `archive it` are
-preferred when consistent with your intent; genuinely unclear cases can remain
-empty. [Private diagnostic capture](docs/architecture/prompt-suggestions.md)
-explains how to distinguish skipped, empty, rejected, and timed-out suggestions.
-
-## Skills
-
-Bare A1's `/settings` → Agent → Skills chooses how discovered skills appear in the
-slash-command menu. `collapse` (the default) replaces the per-skill `/skill:<name>`
-entries with one `/skills` command: bare `/skills` opens a searchable Skills dialog,
-`/skills <name> [args]` applies a skill directly (an unknown name reports
-`Unknown skill: <name>`), and typing `/skills:` lists every skill inline so
-`/skills:<name> args` runs as `/skill:<name> args`. With the `skills` row selected in
-the menu, typing `:` completes to `/skills:`. `expand` lists every `/skill:<name>`
-command as before. Both take effect immediately; a typed `/skill:<name>` always
-works, and the engine's own Skill commands toggle still governs whether skills are
-offered at all. The `a1 pi` comparison profile is unchanged.
-
-## Quitting
-
-`/quit`, `Ctrl+C` twice, and `Ctrl+D` on an empty prompt end a bare A1 session.
-The last screen dissolves on the alternate screen, the terminal is restored once,
-and only the dim `To resume this session:` hint is printed; the conversation is
-not echoed into your scrollback. `/settings` → Quit chooses the effect (`fall`,
-`dissolve`, `starburst`, `waves`, or `off`) and its duration (300–2000 ms). The
-`a1 pi` comparison profile keeps Pi's `fullscreenExitOutput` behavior.
-
-## Prompt history
-
-Bare A1 recalls recent unique prompts across sessions with Up/Down. History is
-stored in a separate profile-local SQLite database at
-`~/.a1/data/history/<profile-id>.sqlite3`, or under `<A1_DATA_DIR>/history` when
-explicitly overridden. Other application data stays in its existing location.
-`/settings` → History controls persistence and the 10-100-entry limit (default
-100), effective on next start. The new default starts fresh: old platform history
-is neither imported nor automatically deleted. Ordinary upgrades and npm
-uninstall/reinstall preserve saved history. History is unencrypted user text;
-images are not reattached. See
-[prompt history](docs/features/prompt-history.md) for privacy, storage, and removal.
-
 ## Extensions
 
 Pi extension packages install into A1's own profile (`~/.a1/agent`), so bare `a1`
@@ -160,7 +69,15 @@ project), never `~/.pi/agent`. Configure MCP with `/mcp setup` inside bare `a1`.
 
 ## Develop
 
+A source build needs Node.js `>=22.19.0 <25`, npm 11, git, and Rust/Cargo 1.85 or
+newer—the build compiles the `native/process-guardian` crate. Publishing a release
+or a pull request additionally needs an authenticated [GitHub CLI](https://cli.github.com).
+`npm run doctor` reports every prerequisite with the exact command that installs
+whatever is missing, and `npm run build` runs the same check first so a fresh clone
+fails by name instead of inside a resolver or Cargo.
+
 ```sh
+npm run doctor          # report Node, npm, git, Rust, and dependency readiness
 npm ci                  # install exact locked dependencies
 npm run build           # compile TypeScript and the process guardian into dist
 npm start               # build and launch a development `a1`
@@ -174,33 +91,6 @@ Create every task worktree at `{working-dir}/.worktrees/<task-id>`, where
 `D:/Git/a1`, use `D:/Git/a1/.worktrees/<task-id>`—never a sibling such as
 `D:/Git/a1-<task-id>`. The primary worktree remains on `develop` for integration only.
 
-## Pull request integration
-
-Pull requests whose complete diff is only under `openspec/**`, under `docs/**`,
-exactly the root `README.md`, or a combination of those paths are automatically
-squash-merged after `Development validation required` succeeds. The automation
-reads the complete GitHub changed-file list, including both sides of renames, and
-runs only for trusted branches in this repository.
-
-Any other path makes the pull request code/operational. That includes source, tests,
-scripts, workflows, configuration, generated baselines, arbitrary root Markdown,
-and a mixed documentation-plus-code change. Those pull requests remain open after
-CI for local maintainer validation and explicit manual merge; automation disables
-auto-merge if it was armed. Documentation remains exempt from product builds and
-tests, but docs-sensitive generated governance and strict OpenSpec consistency are
-checked before integration.
-
-After any same-repository pull request into `develop` merges, trusted automation
-reconciles its remote topic branch. Human merges use the close-event workflow;
-documentation merges authored by `GITHUB_TOKEN` use a synchronous fallback because
-GitHub suppresses recursive workflow events. Both delete only an unprotected live
-ref that still equals the pull request's exact merged head SHA. Fork, advanced,
-reserved, protected, malformed, and unmerged refs are preserved and reported.
-
-Specification approval and implementation remain separate pull requests. An
-implementation starts from updated `origin/develop` only after its specification
-has merged and implementation was explicitly requested.
-
 ## Release
 
 Two channels, both published by CI from the exact bytes it validated — never from

package/dist/app/session-shell/session-shell-root.js

@@ -849,7 +849,7 @@ export class OwnedUiSessionShellRoot {
             this.#appendAnchoredWorkflowComponent(width => ["", ...announcement.render(width)], () => announcement.dispose?.());
             return;
         }
-        // Rationale: pinned 0.85.1 links both share URLs; the workflow result carries the plain URLs.
+        // Rationale: the pinned engine links both share URLs; the workflow result carries the plain URLs.
         const message = result.command === "share" && result.detail
             ? `${linkShareUrl(result.message)}\nGist: ${piShellHyperlink(result.detail)}`
             : result.message;

package/dist/app/session-shell/session-shell.d.ts

@@ -43,10 +43,10 @@ export declare class OwnedUiSessionShell {
     showForkSelector(): void;
     showLogoutSelector(): Promise<void>;
     showLoginMethodSelector(providerReference: string): void;
-    showTreeSelector(initialSelectedId?: string): void;
+    showTreeSelector(initialSelectedId?: string): Promise<void>;
     showLoginAuthTypeSelector(): void;
     showLoginProviderSelector(authType?: "oauth" | "api_key", initialSearchInput?: string): void;
-    showSessionSelector(): void;
+    showSessionSelector(): Promise<void>;
     showSettingsSelector(): void;
     shutdown(): Promise<AdapterCommandResult>;
     runWorkflow(request: PiWorkflowRequest): Promise<AdapterCommandResult>;

package/dist/app/session-shell/session-shell.js

@@ -717,7 +717,7 @@ export class OwnedUiSessionShell {
         if (now - this.#lastEscapeTime < 500) {
             this.#lastEscapeTime = 0;
             if (action === "tree")
-                this.showTreeSelector();
+                await this.showTreeSelector();
             else
                 this.showForkSelector();
             return { outcome: "completed", diagnostic: null };
@@ -972,7 +972,7 @@ export class OwnedUiSessionShell {
         this.root.setInputSurface(component);
         this.runtime.requestRender();
     }
-    showTreeSelector(initialSelectedId) {
+    async showTreeSelector(initialSelectedId) {
         const context = this.backend.pinnedTreeSelectorContext();
         if (context.tree.length === 0) {
             this.root.appendWorkflowStatus("No entries in session");
@@ -983,7 +983,7 @@ export class OwnedUiSessionShell {
             this.root.setInputSurface(null);
             this.runtime.requestRender();
         };
-        const component = createPiShellTreeSelector({
+        const component = await createPiShellTreeSelector({
             tree: context.tree,
             currentLeafId: context.currentLeafId,
             terminalHeight: this.runtime.viewport().rows,
@@ -1058,13 +1058,13 @@ export class OwnedUiSessionShell {
         this.root.setInputSurface(component);
         this.runtime.requestRender();
     }
-    showSessionSelector() {
+    async showSessionSelector() {
         const context = this.backend.pinnedSessionSelectorContext();
         const close = () => {
             this.root.setInputSurface(null);
             this.runtime.requestRender();
         };
-        const component = createPiShellSessionSelector({
+        const component = await createPiShellSessionSelector({
             currentSessionsLoader: context.loadCurrentSessions,
             allSessionsLoader: context.loadAllSessions,
             currentSessionFilePath: context.currentSessionFilePath,
@@ -1200,7 +1200,7 @@ export class OwnedUiSessionShell {
             return { outcome: "completed", diagnostic: null };
         }
         if (request.command === "resume" && request.selection === undefined && request.confirmed === undefined && request.argument.trim().length === 0) {
-            this.showSessionSelector();
+            await this.showSessionSelector();
             return { outcome: "completed", diagnostic: null };
         }
         if (request.command === "login" && request.selection === undefined && request.confirmed === undefined) {
@@ -1215,7 +1215,7 @@ export class OwnedUiSessionShell {
             return { outcome: "completed", diagnostic: null };
         }
         if (request.command === "tree" && request.selection === undefined && request.confirmed === undefined && request.argument.trim().length === 0) {
-            this.showTreeSelector();
+            await this.showTreeSelector();
             return { outcome: "completed", diagnostic: null };
         }
         if (request.command === "reload") {
@@ -1913,7 +1913,7 @@ export class OwnedUiSessionShell {
                     "Summarize with custom prompt",
                 ]);
                 if (choice === undefined) {
-                    this.showTreeSelector(entryId);
+                    await this.showTreeSelector(entryId);
                     return;
                 }
                 summarize = choice !== "No summary";
@@ -1935,7 +1935,7 @@ export class OwnedUiSessionShell {
             },
         });
         if (result.diagnostic === "Branch summarization cancelled")
-            this.showTreeSelector(entryId);
+            await this.showTreeSelector(entryId);
     }
     #startWorkflowLogin(request) {
         this.#finishWorkflowLogin();

package/dist/foundation/startup/startup-descriptor.js

@@ -10,7 +10,7 @@ export const STARTUP_DESCRIPTOR = Object.freeze({
   ],
   "generatedArtifact": {
     "path": "dist/integrations/pi/startup-public.js",
-    "sha256": "8782a192051008e2d99edaa7abc2eb47bd37a8b8ebda1b7fbd62a74f990e6d48"
+    "sha256": "540d60a56c6f2934d243f81dce09bc91e191371bed154b7620d15d22a855697d"
   },
   "dependencyLayerIdentity": {
     "source": "A1_RELEASE_LAYERS",
@@ -19,7 +19,7 @@ export const STARTUP_DESCRIPTOR = Object.freeze({
   "compileCacheNamespace": {
     "strategy": "node-abi-version-and-ordered-layer-sha256-v1"
   },
-  "identity": "24b9db93df1ea18ef3fc7f669a9f45587750eb50c6de2ed7f57541c26c42ff0e"
+  "identity": "a14fa5abdb33493d6a8d11fb1f2e62eff1ddbce083e997187d88531927ca1c24"
 });
 
 export function loadDeclaredStartupGraph() {

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

@@ -12,6 +12,8 @@ const SELECTED_TUNNEL_ROW = /^(→ skills:\S+)(\s{2,}.*)$/u;
 export const PINNED_PI_BUILTIN_SLASH_COMMANDS = [
     { name: "settings", description: "Open settings menu" },
     { name: "model", description: "Select model (opens selector UI)", argumentHint: "<provider/model>" },
+    { name: "tree", description: "Navigate session tree (switch branches)" },
+    { name: "thinking", description: "Set thinking level", argumentHint: "<level>" },
     { name: "scoped-models", description: "Enable/disable models for Ctrl+P cycling" },
     { name: "export", description: "Export session (HTML default, or specify path: .html/.jsonl)" },
     { name: "import", description: "Import and resume a session from a JSONL file" },
@@ -23,7 +25,6 @@ export const PINNED_PI_BUILTIN_SLASH_COMMANDS = [
     { name: "hotkeys", description: "Show all keyboard shortcuts" },
     { name: "fork", description: "Create a new fork from a previous user message" },
     { name: "clone", description: "Duplicate the current session at the current position" },
-    { name: "tree", description: "Navigate session tree (switch branches)" },
     { name: "trust", description: "Save project trust decision for future sessions" },
     { name: "login", description: "Configure provider authentication", argumentHint: "<provider>" },
     { name: "logout", description: "Remove provider authentication" },

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

@@ -29,6 +29,25 @@ export interface PiShellSessionInfoPresentation {
         readonly cost: number;
         readonly tokens: number;
     }[];
+    readonly cacheWarming: PiShellCacheWarmingPresentation;
+}
+export interface PiShellCacheWarmingPresentation {
+    readonly mode: string;
+    readonly status?: {
+        readonly state: "inactive" | "scheduled" | "refreshing";
+        readonly reason?: string;
+        readonly nextWarmAt?: number;
+        readonly extensionOverride?: boolean;
+        readonly decision?: {
+            readonly phase: "streaming" | "idle";
+            readonly action: string;
+            readonly warmCost: number;
+            readonly missCost: number;
+            readonly continuationProbability: number;
+            readonly expectedSavings: number;
+            readonly economicsAvailable: boolean;
+        };
+    };
 }
 export declare function renderPiShellStatusText(message: string, width: number, outputPad?: 0 | 1): readonly string[];
 export interface PiShellCommandMessagePresentation {

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

@@ -23,9 +23,55 @@ export function renderPiShellCommandMessage(presentation, width, outputPad = PIN
         ...text.render(width),
     ];
 }
+const CACHE_WARMING_MINIMUM_EXPECTED_SAVINGS = 0.05;
+function formatWarmingDollars(value) {
+    return value < 0 ? `-${Math.abs(value).toFixed(3)}` : `${value.toFixed(3)}`;
+}
+function formatWarmingEconomics(decision) {
+    if (!decision.economicsAvailable)
+        return "cache economics unavailable";
+    const probability = Math.round(decision.continuationProbability * 100);
+    const probabilityText = decision.phase === "streaming"
+        ? `${probability}% continuation probability while agent is running`
+        : `${probability}% continuation probability`;
+    const comparison = decision.action === "warm" ? ">=" : "<";
+    return `${probabilityText}, expected savings ${formatWarmingDollars(decision.expectedSavings)} ${comparison} ${CACHE_WARMING_MINIMUM_EXPECTED_SAVINGS.toFixed(3)}`;
+}
+function formatWarmingDecisionTime(nextWarmAt, now) {
+    if (nextWarmAt === undefined || nextWarmAt <= now)
+        return "Decision now";
+    let remainingSeconds = Math.ceil((nextWarmAt - now) / 1000);
+    const hours = Math.floor(remainingSeconds / 3600);
+    remainingSeconds %= 3600;
+    const minutes = Math.floor(remainingSeconds / 60);
+    const seconds = remainingSeconds % 60;
+    const parts = [];
+    if (hours > 0)
+        parts.push(`${hours}h`);
+    if (minutes > 0)
+        parts.push(`${minutes}m`);
+    if (seconds > 0 || parts.length === 0)
+        parts.push(`${seconds}s`);
+    return `Decision in ${parts.join(" ")}`;
+}
+/** The one-line warming status the pinned session report shows; a decision is attached once warming acted. */
+function formatCacheWarmingStatus(status, now = Date.now()) {
+    const decision = status.decision;
+    if (!decision || (status.state === "inactive" && !decision.economicsAvailable && !status.extensionOverride)) {
+        return `Inactive (${status.reason ?? "unknown reason"})`;
+    }
+    const details = status.extensionOverride
+        ? `extension override, ${formatWarmingEconomics(decision)}`
+        : `${formatWarmingEconomics(decision)} -> ${decision.action}`;
+    if (status.state === "inactive")
+        return `Stopped (${details})`;
+    if (status.state === "refreshing")
+        return `Warming cache (${details})`;
+    return `${formatWarmingDecisionTime(status.nextWarmAt, now)} (${details})`;
+}
 export function createPiShellSessionInfo(presentation) {
     ensureTheme();
-    const { stats, sessionName, cacheWaste, usageBreakdown } = presentation;
+    const { stats, sessionName, cacheWaste, usageBreakdown, cacheWarming } = presentation;
     let info = `${piTheme().bold("Session Info")}\n\n`;
     if (sessionName)
         info += `${piTheme().fg("dim", "Name:")} ${sessionName}\n`;
@@ -42,6 +88,14 @@ export function createPiShellSessionInfo(presentation) {
         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`;
+    const warmingStatus = cacheWarming.status;
+    info += `\n${piTheme().bold("Cache Warming")}\n${piTheme().fg("dim", "Mode:")} ${cacheWarming.mode}\n`;
+    info += `${piTheme().fg("dim", "Status:")} ${warmingStatus ? formatCacheWarmingStatus(warmingStatus) : "Inactive (cache warming unavailable)"}\n`;
+    const warmingDecision = warmingStatus?.decision;
+    if (warmingDecision?.economicsAvailable) {
+        info += `${piTheme().fg("dim", "Cache miss penalty:")} $${warmingDecision.missCost.toFixed(3)}\n`;
+        info += `${piTheme().fg("dim", "Refresh cost:")} $${warmingDecision.warmCost.toFixed(3)}\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)
@@ -124,7 +178,7 @@ function hotkeysMarkdown(bindings, getShortcuts, profile) {
             ? action === "app.model.select" ? "Unbound (`/models`)" : "Unbound"
             : `\`${label}\``;
     }).join(" / ")} | ${description} |`;
-    let 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"], profile === "a1" ? "Start of prompt line" : "Start of line"), row(["tui.editor.cursorLineEnd"], profile === "a1" ? "End of prompt line" : "End of line"), ...(profile === "a1" ? ["| `Ctrl+Home` | Start of content |", "| `Ctrl+End` | End of content / follow output |"] : []), 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"], profile === "a1" ? "Open the Models dialog" : "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) |", ...(profile === "a1" ? ["", "**Models dialog**", "| Key | Action |", "|-----|--------|", "| `Space` | Toggle the selected model in the cycling scope |", "| `Tab` | Switch the all/scoped filter |", row(["app.models.save"], "Save the scope to settings"), row(["app.models.enableAll"], "Scope every listed model"), row(["app.models.clearAll"], "Clear the listed models from the scope"), row(["app.models.toggleProvider"], "Toggle the selected model's provider"), row(["app.models.reorderUp", "app.models.reorderDown"], "Reorder the cycling scope")] : [])].join("\n");
+    let 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"], profile === "a1" ? "Start of prompt line" : "Start of line"), row(["tui.editor.cursorLineEnd"], profile === "a1" ? "End of prompt line" : "End of line"), ...(profile === "a1" ? ["| `Ctrl+Home` | Start of content |", "| `Ctrl+End` | End of content / follow output |"] : []), 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"], profile === "a1" ? "Open the Models dialog" : "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 selection or 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) |", ...(profile === "a1" ? ["", "**Models dialog**", "| Key | Action |", "|-----|--------|", "| `Space` | Toggle the selected model in the cycling scope |", "| `Tab` | Switch the all/scoped filter |", row(["app.models.save"], "Save the scope to settings"), row(["app.models.enableAll"], "Scope every listed model"), row(["app.models.clearAll"], "Clear the listed models from the scope"), row(["app.models.toggleProvider"], "Toggle the selected model's provider"), row(["app.models.reorderUp", "app.models.reorderDown"], "Reorder the cycling scope")] : [])].join("\n");
     const shortcuts = getShortcuts(bindings ?? keys.getEffectiveConfig());
     if (shortcuts.length > 0) {
         markdown += "\n\n**Extensions**\n| Key | Action |\n|-----|--------|\n";

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

@@ -67,16 +67,18 @@ export declare function createPiShellTrustSelector(options: {
     }) => void;
     readonly onCancel: () => void;
 }): PiShellComponentPort;
+/** Mirrors the pinned session manager's progress callback, including its partial results. */
+type SessionListProgress = (loaded: number, total: number, partialSessions?: readonly SessionInfo[]) => void;
 export declare function createPiShellSessionSelector(options: {
-    readonly currentSessionsLoader: (onProgress?: (loaded: number, total: number) => void) => Promise<SessionInfo[]>;
-    readonly allSessionsLoader: (onProgress?: (loaded: number, total: number) => void) => Promise<SessionInfo[]>;
+    readonly currentSessionsLoader: (onProgress?: SessionListProgress) => Promise<SessionInfo[]>;
+    readonly allSessionsLoader: (onProgress?: SessionListProgress) => Promise<SessionInfo[]>;
     readonly onSelect: (path: string) => void;
     readonly onCancel: () => void;
     readonly onExit: () => void;
     readonly requestRender: () => void;
     readonly renameSession: (sessionFilePath: string, nextName: string | undefined) => Promise<void>;
     readonly currentSessionFilePath: string | undefined;
-}): PiShellComponentPort;
+}): Promise<PiShellComponentPort>;
 export declare function createPiShellTreeSelector(options: {
     readonly tree: readonly unknown[];
     readonly currentLeafId: string | null;
@@ -87,7 +89,7 @@ export declare function createPiShellTreeSelector(options: {
     readonly onCopy?: (text: string | undefined) => void;
     readonly initialSelectedId?: string;
     readonly initialFilterMode?: "default" | "no-tools" | "user-only" | "labeled-only" | "all";
-}): PiShellComponentPort;
+}): Promise<PiShellComponentPort>;
 export declare function createPiShellUserMessageSelector(messages: readonly PiShellSelectorOption[], onSelect: (id: string) => void, onCancel: () => void, initialSelectedId?: string): PiShellComponentPort;
 export interface PiShellLoginDialogPort extends PiShellComponentPort {
     showAuth(url: string, instructions?: string): void;

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

@@ -1,8 +1,6 @@
 import { ArminComponent, BorderedLoader, DynamicBorder, ExtensionSelectorComponent, getSelectListTheme, LoginDialogComponent, ModelSelectorComponent, OAuthSelectorComponent, SettingsSelectorComponent, ShowImagesSelectorComponent, ThemeSelectorComponent, ThinkingSelectorComponent, UserMessageSelectorComponent, } from "../startup-public.js";
 import { DaxnutsComponent, } from "./upstream/components/daxnuts.js";
 import { EarendilAnnouncementComponent, } from "./upstream/components/earendil-announcement.js";
-import { SessionSelectorComponent, } from "./upstream/components/session-selector.js";
-import { TreeSelectorComponent, } from "./upstream/components/tree-selector.js";
 import { Box, Container, SelectList, Spacer, Text, } from "@earendil-works/pi-tui";
 import { ScopedModelsSelectorComponent, } from "./upstream/components/scoped-models-selector.js";
 import { ModelsDialogComponent, } from "./models-dialog.js";
@@ -40,6 +38,7 @@ export function createPiShellSettingsSelector(options) {
         onFollowUpModeChange: change("onFollowUpModeChange"),
         onTransportChange: change("onTransportChange"),
         onHttpIdleTimeoutMsChange: change("onHttpIdleTimeoutMsChange"),
+        onCacheWarmingModeChange: change("onCacheWarmingModeChange"),
         onModelThinkingLevelChange: change("onModelThinkingLevelChange"),
         onModelThinkingLevelRemove: change("onModelThinkingLevelRemove"),
         onThemeChange: change("onThemeChange"),
@@ -120,13 +119,15 @@ export function createPiShellTrustSelector(options) {
     ensureTheme();
     return componentPort(new TrustSelectorComponent(options));
 }
-export function createPiShellSessionSelector(options) {
+export async function createPiShellSessionSelector(options) {
     ensureTheme();
+    const { SessionSelectorComponent } = await import("./upstream/components/session-selector.js");
     const selector = new SessionSelectorComponent(options.currentSessionsLoader, options.allSessionsLoader, options.onSelect, options.onCancel, options.onExit, options.requestRender, { renameSession: options.renameSession, showRenameHint: true }, options.currentSessionFilePath);
     return componentPort(selector);
 }
-export function createPiShellTreeSelector(options) {
+export async function createPiShellTreeSelector(options) {
     ensureTheme();
+    const { TreeSelectorComponent } = await import("./upstream/components/tree-selector.js");
     const selector = new TreeSelectorComponent([...options.tree], options.currentLeafId, options.terminalHeight, options.onSelect, options.onCancel, options.onLabelChange, options.initialSelectedId, options.initialFilterMode);
     if (options.onCopy)
         selector.onCopy = options.onCopy;

package/dist/integrations/pi/components/upstream/adjacent/core/keybindings.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 0.85.1 (MIT), commit d981de1229ef899957bbe968bc8dcda02a21f477,
+ * Provenance: @earendil-works/pi-coding-agent 0.86.1 (MIT), commit 13cbf77df2396303013a41646bcfa77b4271ae56,
  * packages/coding-agent/src/core/keybindings.ts.
  * Modifications: Mechanical source port with Node import prefixes, public package-root agent-directory
  * resolution, and an opt-in bare-A1 input profile including Ctrl+L level cycling and unbound model
@@ -136,7 +136,7 @@ export declare const KEYBINDINGS: {
     };
     readonly "app.message.copy": {
         readonly defaultKeys: "ctrl+x";
-        readonly description: "Copy message to clipboard";
+        readonly description: "Copy selection or last assistant message";
     };
     readonly "app.message.followUp": {
         readonly defaultKeys: "ctrl+q" | "alt+enter";

package/dist/integrations/pi/components/upstream/adjacent/core/keybindings.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 0.85.1 (MIT), commit d981de1229ef899957bbe968bc8dcda02a21f477,
+ * Provenance: @earendil-works/pi-coding-agent 0.86.1 (MIT), commit 13cbf77df2396303013a41646bcfa77b4271ae56,
  * packages/coding-agent/src/core/keybindings.ts.
  * Modifications: Mechanical source port with Node import prefixes, public package-root agent-directory
  * resolution, and an opt-in bare-A1 input profile including Ctrl+L level cycling and unbound model
@@ -72,7 +72,7 @@ export const KEYBINDINGS = {
     },
     "app.message.copy": {
         defaultKeys: "ctrl+x",
-        description: "Copy message to clipboard",
+        description: "Copy selection or last assistant message",
     },
     "app.message.followUp": {
         defaultKeys: windowsKeybindings ? "ctrl+q" : "alt+enter",

package/dist/integrations/pi/components/upstream/assets/earendil-image.json

@@ -1,8 +1,8 @@
 {
     "sourcePackage": "@earendil-works/pi-coding-agent",
-    "sourceVersion": "0.85.1",
+    "sourceVersion": "0.86.1",
     "upstreamRepository": "https://github.com/earendil-works/pi.git",
-    "upstreamCommit": "d981de1229ef899957bbe968bc8dcda02a21f477",
+    "upstreamCommit": "13cbf77df2396303013a41646bcfa77b4271ae56",
     "sourcePath": "dist/modes/interactive/assets/clankolas.png",
     "sourceSha256": "169acd0dfe6fbb8d8742ed24a3fc654fd0b2e2d4223c733249c5493723f1b72d",
     "license": "MIT",

package/dist/integrations/pi/components/upstream/components/countdown-timer.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 0.85.1 (MIT), commit d981de1229ef899957bbe968bc8dcda02a21f477,
+ * Provenance: @earendil-works/pi-coding-agent 0.86.1 (MIT), commit 13cbf77df2396303013a41646bcfa77b4271ae56,
  * packages/coding-agent/src/modes/interactive/components/countdown-timer.ts.
  * Modifications: Mechanical source port with ECMAScript private fields; imports remain on the public
  * Pi TUI package root.

package/dist/integrations/pi/components/upstream/components/daxnuts.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 0.85.1 (MIT), commit d981de1229ef899957bbe968bc8dcda02a21f477,
+ * Provenance: @earendil-works/pi-coding-agent 0.86.1 (MIT), commit 13cbf77df2396303013a41646bcfa77b4271ae56,
  * packages/coding-agent/src/modes/interactive/components/daxnuts.ts.
  * Modifications: Mechanical pinned source port with private imports remapped to public package-root
  * types/APIs and A1-owned theme boundaries; behavior remains acceptance-tested.

package/dist/integrations/pi/components/upstream/components/daxnuts.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 0.85.1 (MIT), commit d981de1229ef899957bbe968bc8dcda02a21f477,
+ * Provenance: @earendil-works/pi-coding-agent 0.86.1 (MIT), commit 13cbf77df2396303013a41646bcfa77b4271ae56,
  * packages/coding-agent/src/modes/interactive/components/daxnuts.ts.
  * Modifications: Mechanical pinned source port with private imports remapped to public package-root
  * types/APIs and A1-owned theme boundaries; behavior remains acceptance-tested.

package/dist/integrations/pi/components/upstream/components/earendil-announcement.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 0.85.1 (MIT), commit d981de1229ef899957bbe968bc8dcda02a21f477,
+ * Provenance: @earendil-works/pi-coding-agent 0.86.1 (MIT), commit 13cbf77df2396303013a41646bcfa77b4271ae56,
  * packages/coding-agent/src/modes/interactive/components/earendil-announcement.ts.
  * Modifications: Mechanical pinned source port with private imports remapped to public package-root
  * types/APIs and A1-owned theme boundaries. The unchanged image is loaded lazily from its attributed,

package/dist/integrations/pi/components/upstream/components/extension-editor.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 0.85.1 (MIT), commit d981de1229ef899957bbe968bc8dcda02a21f477,
+ * Provenance: @earendil-works/pi-coding-agent 0.86.1 (MIT), commit 13cbf77df2396303013a41646bcfa77b4271ae56,
  * packages/coding-agent/src/modes/interactive/components/extension-editor.ts.
  * Modifications: Mechanical port: remap pi-tui to the root public singleton, use owned
  * keybindings/theme and external-editor seams, preserve editor layout, hints, focus, submission,
@@ -15,6 +15,7 @@ export declare class ExtensionEditorComponent extends Container {
     constructor(tui: TUI, keybindings: KeybindingsManager, title: string, prefill: string | undefined, onSubmit: (value: string) => void, onCancel: () => void, options?: {
         readonly paddingX?: number;
         readonly autocompleteMaxVisible?: number;
+        readonly description?: string;
     }, externalEditorCommand?: string);
     handleInput(data: string): void;
 }

package/dist/integrations/pi/components/upstream/components/extension-editor.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 0.85.1 (MIT), commit d981de1229ef899957bbe968bc8dcda02a21f477,
+ * Provenance: @earendil-works/pi-coding-agent 0.86.1 (MIT), commit 13cbf77df2396303013a41646bcfa77b4271ae56,
  * packages/coding-agent/src/modes/interactive/components/extension-editor.ts.
  * Modifications: Mechanical port: remap pi-tui to the root public singleton, use owned
  * keybindings/theme and external-editor seams, preserve editor layout, hints, focus, submission,
@@ -36,14 +36,19 @@ export class ExtensionEditorComponent extends Container {
             || process.env.VISUAL
             || process.env.EDITOR
             || (process.platform === "win32" ? "notepad" : "nano");
+        const { description, ...editorOptions } = options ?? {};
         this.addChild(new DynamicBorder());
         this.addChild(new Spacer(1));
         this.addChild(new Text(piTheme().fg("accent", title), 1, 0));
+        if (description) {
+            this.addChild(new Spacer(1));
+            this.addChild(new Text(piTheme().fg("text", description), 1, 0));
+        }
         this.addChild(new Spacer(1));
         this.#editor = new Editor(tui, {
             borderColor: text => piTheme().fg("borderMuted", text),
             selectList: getSelectListTheme(),
-        }, options);
+        }, editorOptions);
         if (prefill)
             this.#editor.setText(prefill);
         this.#editor.onSubmit = onSubmit;

package/dist/integrations/pi/components/upstream/components/mermaid.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 0.85.1 (MIT), commit d981de1229ef899957bbe968bc8dcda02a21f477,
+ * Provenance: @earendil-works/pi-coding-agent 0.86.1 (MIT), commit 13cbf77df2396303013a41646bcfa77b4271ae56,
  * packages/coding-agent/src/modes/interactive/components/mermaid.ts.
  * Modifications: Mechanical pinned source port with private imports remapped to public package-root
  * types/APIs and A1-owned theme boundaries; behavior remains acceptance-tested.

package/dist/integrations/pi/components/upstream/components/owned-editor.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 0.85.1 (MIT), commit d981de1229ef899957bbe968bc8dcda02a21f477,
+ * Provenance: @earendil-works/pi-coding-agent 0.86.1 (MIT), commit 13cbf77df2396303013a41646bcfa77b4271ae56,
  * packages/coding-agent/src/modes/interactive/components/custom-editor.ts.
  * Modifications: A1-owned class name and synchronized A1 keybinding contract replace the nominal
  * private upstream keybinding constructor dependency; bare A1 injects the shared Settings/agent input

package/dist/integrations/pi/components/upstream/components/owned-editor.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 0.85.1 (MIT), commit d981de1229ef899957bbe968bc8dcda02a21f477,
+ * Provenance: @earendil-works/pi-coding-agent 0.86.1 (MIT), commit 13cbf77df2396303013a41646bcfa77b4271ae56,
  * packages/coding-agent/src/modes/interactive/components/custom-editor.ts.
  * Modifications: A1-owned class name and synchronized A1 keybinding contract replace the nominal
  * private upstream keybinding constructor dependency; bare A1 injects the shared Settings/agent input