@timurproko/a1 0.2.4-dev.673 → 0.2.5-dev.683

package/README.md

@@ -12,187 +12,198 @@
   <a href="https://agentnumberone.dev"><img alt="Website" src="https://img.shields.io/badge/web-agentnumberone.dev-2638d2?style=flat-square"></a>
 </p>
 
+<p align="center">
+  <a href="#install">Install</a> ·
+  <a href="#launch">Launch</a> ·
+  <a href="#update">Update</a> ·
+  <a href="#extensions">Extensions</a> ·
+  <a href="#develop">Develop</a> ·
+  <a href="#publish">Publish</a>
+</p>
+
 ## Install
 
 Release:
 
-```sh
+```text
 npm x -y -- @timurproko/a1-install
 ```
 
 Develop:
 
-```sh
+```text
 npm x -y -- @timurproko/a1-install --develop
 ```
 
 Preview number:
 
-```sh
+```text
 npm x -y -- @timurproko/a1-install --develop 107
 ```
 
 Exact preview:
 
-```sh
+```text
 npm x -y -- @timurproko/a1-install --develop 0.1.8-dev.107
 ```
 
-<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/terminal-dark.svg"><img src="docs/assets/readme/terminal.svg" alt="" width="240"></picture></p>
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/separator-dark.svg"><img src="docs/assets/readme/separator.svg" alt="" width="280"></picture></p>
 
-## Use
+## Launch
 
 Launch A1 (profile: `~/.a1/agent`):
 
-```sh
+```text
 a1
 ```
 
 Show all commands:
 
-```sh
+```text
 a1 help
 ```
 
 Show the current and latest versions:
 
-```sh
+```text
 a1 version
 ```
 
 Vanilla Pi oracle (`~/.pi/agent`):
 
-```sh
+```text
 a1 pi
 ```
 
-### Update
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/separator-dark.svg"><img src="docs/assets/readme/separator.svg" alt="" width="280"></picture></p>
+
+## Update
 
 Install the release:
 
-```sh
+```text
 a1 update
 ```
 
 Install develop:
 
-```sh
+```text
 a1 update --develop
 ```
 
 Install preview 107:
 
-```sh
+```text
 a1 update --develop 107
 ```
 
 Install that exact preview:
 
-```sh
+```text
 a1 update --develop 0.1.8-dev.107
 ```
 
 Refresh A1's model catalogs:
 
-```sh
+```text
 a1 update --models
 ```
 
 Stuck on `0.2.2` and `a1 update` fails? Run the installer once, then use `a1 update` as usual:
 
-```sh
+```text
 npm x -y -- @timurproko/a1-install
 ```
 
 A1 shows an `Update Available` notice at most once a day and never installs anything by itself. Turn it off in Settings (`Update check`) or with `A1_SKIP_VERSION_CHECK=1`.
 
-<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/plugins-dark.svg"><img src="docs/assets/readme/plugins.svg" alt="" width="240"></picture></p>
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/separator-dark.svg"><img src="docs/assets/readme/separator.svg" alt="" width="280"></picture></p>
 
 ## Extensions
 
 Install a package:
 
-```sh
+```text
 a1 install npm:pi-mcp-adapter
 ```
 
 Remove it (alias: `a1 uninstall`):
 
-```sh
+```text
 a1 remove npm:pi-mcp-adapter
 ```
 
 List installed packages:
 
-```sh
+```text
 a1 list
 ```
 
 Update every installed package:
 
-```sh
+```text
 a1 update --extensions
 ```
 
 Update one:
 
-```sh
+```text
 a1 update npm:pi-mcp-adapter
 ```
 
-<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/gears-dark.svg"><img src="docs/assets/readme/gears.svg" alt="" width="240"></picture></p>
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/separator-dark.svg"><img src="docs/assets/readme/separator.svg" alt="" width="280"></picture></p>
 
 ## Develop
 
 Install exact locked dependencies:
 
-```sh
+```text
 npm ci
 ```
 
 Compile TypeScript and the process guardian into `dist`:
 
-```sh
+```text
 npm run build
 ```
 
 Build and launch a source `a1`:
 
-```sh
+```text
 npm start
 ```
 
 Build and launch a source `a1 pi`:
 
-```sh
+```text
 npm run start:pi
 ```
 
 Typecheck + fast suite (alias: `npm test`):
 
-```sh
+```text
 npm run test:fast
 ```
 
 Complete non-physical suite:
 
-```sh
+```text
 npm run test:full
 ```
 
 Report Node, npm, git, Rust, and dependency readiness:
 
-```sh
+```text
 npm run doctor
 ```
 
 Preview the README as GitHub renders it, in your browser (needs `gh`):
 
-```sh
+```text
 npm run preview:readme
 ```
 
-<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/rocket-dark.svg"><img src="docs/assets/readme/rocket.svg" alt="" width="240"></picture></p>
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/separator-dark.svg"><img src="docs/assets/readme/separator.svg" alt="" width="280"></picture></p>
 
 ## Publish
 
@@ -200,25 +211,25 @@ npm run preview:readme
 
 Request the preview publish:
 
-```sh
+```text
 npm run develop
 ```
 
 ### Release
 
-```sh
+```text
 npm run release -- patch               # 0.1.8-dev -> 0.1.8
 ```
 
-```sh
+```text
 npm run release -- minor               # 0.1.8-dev -> 0.2.0
 ```
 
-```sh
+```text
 npm run release -- major               # 0.1.8-dev -> 1.0.0
 ```
 
-```sh
+```text
 npm run release -- 0.4.0               # prepare an exact stable version
 ```
 

package/bin/pinned-pi-public.js

@@ -49,9 +49,9 @@ export function resolvePinnedPiImport(specifier) {
   if (match === null) throw new Error(`pinned Pi import is invalid: ${specifier}`);
   const packageName = match[1] ?? "";
   const subpath = match[2]?.slice(1) ?? "";
-  const packageRoot = resolve(root, "node_modules", ...packageName.split("/"));
+  const packageRoot = findDependencyRoot(root, packageName);
+  if (packageRoot === undefined) throw new Error(`pinned Pi dependency is unavailable: ${packageName}`);
   const manifestPath = resolve(packageRoot, "package.json");
-  if (!existsSync(manifestPath)) throw new Error(`pinned Pi dependency is unavailable: ${packageName}`);
   const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
   const declaredTarget = exportedTarget(manifest.exports, subpath) ?? (subpath.length === 0 ? manifest.module ?? manifest.main : undefined);
   const target = typeof declaredTarget === "string" && !declaredTarget.startsWith(".") ? `./${declaredTarget}` : declaredTarget;
@@ -61,6 +61,24 @@ export function resolvePinnedPiImport(specifier) {
   return pathToFileURL(path).href;
 }
 
+/**
+ * Follow Node's package lookup shape so npm may either nest a Pi dependency or
+ * deduplicate it into an ancestor node_modules directory.
+ * @param {string} root
+ * @param {string} packageName
+ * @returns {string | undefined}
+ */
+function findDependencyRoot(root, packageName) {
+  let current = root;
+  while (true) {
+    const candidate = resolve(current, "node_modules", ...packageName.split("/"));
+    if (existsSync(resolve(candidate, "package.json"))) return candidate;
+    const parent = dirname(current);
+    if (parent === current) return undefined;
+    current = parent;
+  }
+}
+
 function pinnedRoot() {
   if (configuredRoot === undefined) throw new Error("pinned Pi public package directory is not configured");
   if (!existsSync(resolve(configuredRoot, "package.json"))) throw new Error("pinned Pi public package directory is unavailable");

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

@@ -257,13 +257,13 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     setViewportOverlaySurfaces(surfaces: readonly PiTuiPointerSurface[] | null): void;
     viewportInputGeometryReady(width: number, height: number): boolean;
     handleViewportPreInput(data: string, allowWheel?: boolean, now?: number, editorActive?: boolean): SessionViewportInputResult;
+    dismissNotice(): void;
     layoutRoot(): PiTuiLayoutNode;
     transcriptComponent(id: string): PiShellTranscriptComponentPort | undefined;
     exitTranscript(width: number): string;
     appendWorkflowStatus(message: string): void;
     appendWorkflowMessage(message: PiWorkflowMessage, errorCode?: ImageAttachmentError["code"]): void;
     appendWorkflowResult(result: PiWorkflowResult, errorCode?: ImageAttachmentError["code"]): void;
-    appendDaxnuts(): void;
     toggleThinkingVisibility(): void;
     get toolsExpanded(): boolean;
     setToolsExpanded(expanded: boolean): void;

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

@@ -9,7 +9,7 @@ import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES } from
 import { createPiExtensionUiBridge } from "../../integrations/pi/components/shell-extension-ui.js";
 import { createPiShellEditor } from "../../integrations/pi/components/shell-editor-autocomplete.js";
 import { createPiQueuedInputStatus, createPiShellFooter, createPiShellHeader, createPiShellLoadedResources, createPiShellStatus, } from "../../integrations/pi/components/shell-footer-status.js";
-import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
+import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
 import { createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellCommandMessage, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStatusText, } from "../../integrations/pi/components/shell-presenters-info.js";
 import { createPiShellTranscriptComponent, isPiPromptStyleCompaction, paintPiSubmittedPromptTimestamp, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, } from "../../integrations/pi/components/shell-presenters-transcript.js";
 import { onPiThemeChange, PINNED_PI_LAYOUT, piTheme } from "../../integrations/pi/components/upstream/theme/theme.js";
@@ -86,7 +86,7 @@ export class OwnedUiSessionShellRoot {
     #imageSubmissionsSending = 0;
     constructor(view, cwd, handlers, startup = {}, agentDir, extensionRenderers = {
         getMessageRenderer: () => undefined,
-        getToolDefinition: () => undefined,
+        getToolRenderers: () => undefined,
     }, sessionLayout = "pinned", imageAssets) {
         this.#view = view;
         this.#customViewport = sessionLayout === "custom-viewport";
@@ -286,7 +286,7 @@ export class OwnedUiSessionShellRoot {
     reconcilePromptImageLimitNotice(text = this.editor.getText()) {
         if (this.#dockNotice?.errorCode !== "image-count" || !this.#promptChips.imageLimitState(text).corrected)
             return false;
-        this.#dismissDockNotice();
+        this.dismissNotice();
         return true;
     }
     hasPendingPastes(text) { return this.#promptChips.hasPending(text); }
@@ -375,7 +375,7 @@ export class OwnedUiSessionShellRoot {
         // Invariant: the notice answers the reader's last command, so only their next prompt or
         // shell command retires it; assistant, tool, and compaction blocks streaming in keep it.
         if (block.kind === "user" || block.kind === "bash")
-            this.#dismissDockNotice();
+            this.dismissNotice();
         const created = createPiShellTranscriptComponent(block, this.#cwd, this.#extensionRenderers, this.#submittedPromptComposer, this.#outputPad, !this.#thinkingVisible, this.#mermaidRenderingMode, this.#showImages, this.#imageWidthCells, this.#imageAssets, { ...this.#componentRuntime, changed: () => {
                 if (this.#transcript.get(block.id) !== created)
                     return;
@@ -659,7 +659,7 @@ export class OwnedUiSessionShellRoot {
         }
         return renderPiShellCommandMessage({ kind: notice.kind, message: notice.message }, width, this.#outputPad);
     }
-    #dismissDockNotice() {
+    dismissNotice() {
         if (this.#dockNotice === undefined)
             return;
         this.#dockNotice = undefined;
@@ -984,11 +984,6 @@ export class OwnedUiSessionShellRoot {
             : result.message;
         this.appendWorkflowStatus(message);
     }
-    appendDaxnuts() {
-        this.#lastWorkflowStatusId = undefined;
-        const daxnuts = createPiShellDaxnuts(this.#componentRuntime);
-        this.#appendAnchoredWorkflowComponent(width => ["", ...daxnuts.render(width)], () => daxnuts.dispose?.());
-    }
     toggleThinkingVisibility() {
         this.setHideThinkingBlock(this.#thinkingVisible);
     }
@@ -1252,7 +1247,7 @@ export class OwnedUiSessionShellRoot {
     }
     #appendAnchoredWorkflowComponent(render, dispose) {
         // Invariant: transcript-bound workflow output supersedes a pending acknowledgement.
-        this.#dismissDockNotice();
+        this.dismissNotice();
         this.#workflowTranscriptSequence += 1;
         const id = `workflow-status-${this.#workflowTranscriptSequence}`;
         const component = {

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

@@ -14,7 +14,7 @@ import { createPiExtensionUiBridge } from "../../integrations/pi/components/shel
 import { createPiShellEditor } from "../../integrations/pi/components/shell-editor-autocomplete.js";
 import { SKILLS_COMMAND_NAME, findSkillByArgument, rewriteSkillsTunnelSubmission, skillPrompt, skillsFromCommands, } from "../../integrations/pi/components/skills-command.js";
 import { createPiQueuedInputStatus, createPiShellFooter, createPiShellHeader, createPiShellLoadedResources, createPiShellStatus, } from "../../integrations/pi/components/shell-footer-status.js";
-import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellSkillsSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
+import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellSkillsSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
 import { createPiShellChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellPackageUpdateNotice, renderPiShellStatusText, } from "../../integrations/pi/components/shell-presenters-info.js";
 import { createPiShellTranscriptComponent, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, } from "../../integrations/pi/components/shell-presenters-transcript.js";
 import { onPiThemeChange, piTheme } from "../../integrations/pi/components/upstream/theme/theme.js";
@@ -233,7 +233,7 @@ export class OwnedUiSessionShell {
             resources: startup?.resources ?? shellResourceEntries(this.backend),
         }, this.backend.agentDir, {
             getMessageRenderer: customType => this.backend.pinnedMessageRenderer(customType),
-            getToolDefinition: toolName => this.backend.pinnedToolDefinition(toolName),
+            getToolRenderers: toolName => this.backend.pinnedToolRenderers(toolName),
             getShortcuts: bindings => this.backend.pinnedShortcutDescriptions(bindings),
         }, sessionLayout, {
             resolve: assetId => this.backend.resolveTranscriptImage(assetId),
@@ -358,12 +358,13 @@ export class OwnedUiSessionShell {
             ? this.runtime.addPreInputListener(data => {
                 if (inputPresentation?.coordination === false)
                     this.#streamPresentation.noteImmediatePresentation();
-                // Compatibility: Pi's fullscreen renderer also intercepts plain Home/End.
-                // Deliver them to the focused owned input before that outer scroll handler;
-                // overlays retain Pi's normal dispatch, and comparison profiles never enter here.
+                // Compatibility: route boundary keys before Pi.
+                const isDefault = this.root.usesDefaultInputSurface();
                 if (!this.runtime.hasOverlay() && (this.root.editor.matchesTerminalKey(data, "home")
-                    || this.root.editor.matchesTerminalKey(data, "end"))) {
-                    if (this.root.usesDefaultInputSurface())
+                    || this.root.editor.matchesTerminalKey(data, "end")
+                    || !isDefault && (this.root.editor.matchesTerminalKey(data, "ctrl+home")
+                        || this.root.editor.matchesTerminalKey(data, "ctrl+end")))) {
+                    if (isDefault)
                         this.root.handleViewportPreInput(data, true);
                     this.root.handleInput(data);
                     this.runtime.requestRender();
@@ -823,8 +824,6 @@ export class OwnedUiSessionShell {
     async cycleModel(direction) {
         const result = await this.backend.cycleModelWorkflow(direction);
         this.root.appendWorkflowResult(result);
-        if (result.outcome === "completed")
-            this.#showDaxnutsForActiveModel();
         this.runtime.requestRender();
         return workflowAdapterResult(result);
     }
@@ -1345,8 +1344,6 @@ export class OwnedUiSessionShell {
             this.#installAutocompleteCommands();
         }
         this.root.appendWorkflowResult(result);
-        if ((request.command === "model" || request.command === "models") && result.outcome === "completed")
-            this.#showDaxnutsForActiveModel();
         this.runtime.requestRender();
         return workflowAdapterResult(result);
     }
@@ -1536,12 +1533,6 @@ export class OwnedUiSessionShell {
             this.runtime.requestRender();
         }).finally(() => clearTimeout(timeout));
     }
-    #showDaxnutsForActiveModel() {
-        const model = this.view().activeModel;
-        if (model?.providerId === "opencode" && model.modelId.toLowerCase().includes("kimi-k2.5")) {
-            this.root.appendDaxnuts();
-        }
-    }
     // Invariant: pointer reporting is disabled on every path that ends the owning screen.
     #setPointerReporting(enabled, forceOff = false) {
         const effective = forceOff ? false : this.#customViewport || enabled;
@@ -1778,6 +1769,7 @@ export class OwnedUiSessionShell {
             return { outcome: "failed", diagnostic: `route is unavailable: ${route}` };
         if (!this.runtime.active)
             return { outcome: "failed", diagnostic: "runtime is not active" };
+        this.root.dismissNotice();
         this.#dialogHandle?.hide();
         this.#dialogSource = "route";
         // Protocol: any-event reporting: hover and drag are what the screen is driven by, and

package/dist/composition/owned-ui.js

@@ -82,6 +82,7 @@ export async function composeOwnedUi(options = {}) {
             const { renderPiShellHotkeySections } = await import("../integrations/pi/components/shell-hotkey-sections.js");
             return { sections: width => renderPiShellHotkeySections(presentation, width) };
         },
+        session: () => import("./session-info-reference.js").then(m => m.loadSessionInfoReference(adapter)),
     };
     const routeHost = settings === null || !ownedSurfaces ? null : createOwnedRouteHost(settings, references);
     const viewportSettings = settings === null || !ownedSurfaces ? null : {

package/dist/composition/session-info-reference.d.ts

@@ -0,0 +1,4 @@
+import type { ReferenceDocumentProvider } from "../features/owned-ui/reference-screen-app.js";
+import type { PiEngineAdapter } from "../integrations/pi/engine/adapter.js";
+/** Captures one current session snapshot and adapts it to the neutral reference document. */
+export declare function loadSessionInfoReference(adapter: PiEngineAdapter): Promise<ReferenceDocumentProvider>;

package/dist/composition/session-info-reference.js

@@ -0,0 +1,20 @@
+import { renderPiShellSessionInfoReferenceDocument } from "../integrations/pi/components/shell-session-info-reference.js";
+/** Captures one current session snapshot and adapts it to the neutral reference document. */
+export async function loadSessionInfoReference(adapter) {
+    const result = await adapter.executeWorkflow({ command: "session", argument: "" });
+    if (result.outcome !== "completed")
+        throw new Error(result.message);
+    if (result.presentation?.kind !== "session-info")
+        throw new Error("Session workflow returned no structured information");
+    const presentation = result.presentation;
+    let cached = null;
+    const document = (width) => {
+        if (cached?.width !== width)
+            cached = { width, document: renderPiShellSessionInfoReferenceDocument(presentation, width) };
+        return cached.document;
+    };
+    return {
+        preamble: width => document(width).preamble,
+        sections: width => document(width).sections,
+    };
+}

package/dist/composition/settings-route-host.d.ts

@@ -7,10 +7,7 @@ export type OwnedReferenceRows = NonNullable<ReferenceDocumentProvider["rows"]>;
 export interface OwnedReferenceProviders {
     changelog(input?: UiRouteInput): Promise<ReferenceDocumentProvider>;
     hotkeys(): Promise<ReferenceDocumentProvider>;
+    session(): Promise<ReferenceDocumentProvider>;
 }
-/**
- * Declares the A1-owned settings route, and the changelog and hotkeys reference
- * routes when their documents are supplied, without evaluating their presentation
- * graphs during startup. Opening a route retains input while the optional module loads.
- */
+/** Declares settings and lazy document routes. */
 export declare function createOwnedRouteHost(settings: OwnedSettingsManager, references?: OwnedReferenceProviders): UiRouteHost;

package/dist/composition/settings-route-host.js

@@ -1,14 +1,10 @@
-import { CHANGELOG_APP_ID, CHANGELOG_ROUTE, CHANGELOG_TITLE, HOTKEYS_APP_ID, HOTKEYS_ROUTE, HOTKEYS_TITLE, } from "../features/owned-ui/reference-routes.js";
+import { CHANGELOG_ROUTE, CHANGELOG_TITLE, HOTKEYS_ROUTE, HOTKEYS_TITLE, } from "../features/owned-ui/reference-routes.js";
 import { SETTINGS_APP_ID, SETTINGS_ROUTE } from "../features/owned-ui/settings-route.js";
 import { piTheme } from "../integrations/pi/components/upstream/theme/theme.js";
 import { faint } from "../ui/components/text.js";
-/**
- * Declares the A1-owned settings route, and the changelog and hotkeys reference
- * routes when their documents are supplied, without evaluating their presentation
- * graphs during startup. Opening a route retains input while the optional module loads.
- */
+/** Declares settings and lazy document routes. */
 export function createOwnedRouteHost(settings, references) {
-    const routes = new Set([SETTINGS_ROUTE, ...(references === undefined ? [] : [CHANGELOG_ROUTE, HOTKEYS_ROUTE])]);
+    const routes = new Set([SETTINGS_ROUTE, ...(references === undefined ? [] : [CHANGELOG_ROUTE, HOTKEYS_ROUTE, "session"])]);
     return {
         claims: route => routes.has(route),
         open: (route, input) => {
@@ -18,10 +14,10 @@ export function createOwnedRouteHost(settings, references) {
                 return deferredSurface(SETTINGS_APP_ID, "settings", () => loadSettingsSurface(settings));
             }
             const changelog = route === CHANGELOG_ROUTE;
-            const id = changelog ? CHANGELOG_APP_ID : HOTKEYS_APP_ID;
-            const title = changelog ? CHANGELOG_TITLE : HOTKEYS_TITLE;
-            const document = changelog ? references.changelog(input) : references.hotkeys();
-            return deferredSurface(id, title, () => loadReferenceSurface(settings, id, route, title, document));
+            const session = route === "session";
+            const title = session ? "Session Info" : changelog ? CHANGELOG_TITLE : HOTKEYS_TITLE;
+            const document = session ? references.session() : changelog ? references.changelog(input) : references.hotkeys();
+            return deferredSurface(route, title, () => loadReferenceSurface(settings, route, route, title, document));
         },
     };
 }

package/dist/features/owned-ui/reference-screen-app.d.ts

@@ -11,6 +11,8 @@ export interface ReferenceDocumentSection {
 export interface ReferenceDocumentProvider {
     /** Flat rows for this width, or null while the document is not available yet. */
     readonly rows?: (width: number) => readonly string[] | null;
+    /** Rows between the screen title and structured groups, absent for group-only documents. */
+    readonly preamble?: (width: number) => readonly string[] | null;
     /** Structured groups opt into shared Settings-style headers and pinning. */
     readonly sections?: (width: number) => readonly ReferenceDocumentSection[] | null;
     /** Settles once the selected content provider answers; absent when available at once. */

package/dist/features/owned-ui/reference-screen-app.js

@@ -222,10 +222,16 @@ export class ReferenceScreenApp {
         if (cached !== null && cached.width === width)
             return this.#withTitle(cached.content, title);
         const sections = this.#document.sections?.(width);
-        if (sections === null)
+        const preamble = sections === undefined ? undefined : this.#document.preamble?.(width);
+        if (sections === null || preamble === null)
             return { kind: "flat", rows: [title, "", LOADING_NOTICE] };
         if (sections !== undefined) {
             const rows = [];
+            if (preamble !== undefined && preamble.length > 0) {
+                for (const row of preamble)
+                    rows.push({ kind: "note", group: "", text: row });
+                rows.push({ kind: "spacer" });
+            }
             sections.forEach((section, sectionIndex) => {
                 if (sectionIndex > 0)
                     rows.push({ kind: "spacer" });

package/dist/features/owned-ui/resources/release-notes.json

@@ -1,6 +1,10 @@
 {
   "schema": "a1-release-notes-v1",
   "releases": [
+    {
+      "version": "0.2.4",
+      "markdown": "## [0.2.4] - 2026-10-05\n\n### Changed\n\n- upgrade pinned Pi to 1.0.0 ([#658](https://github.com/timurproko/a1/pull/658))\n- upgrade pinned Pi to 1.0.2 ([#669](https://github.com/timurproko/a1/pull/669))\n- add animated mark, section art, and browser preview ([#665](https://github.com/timurproko/a1/pull/665))\n- keep the hero mark still and link only it to the site ([#666](https://github.com/timurproko/a1/pull/666))\n- pick dark-mode art via picture sources ([#668](https://github.com/timurproko/a1/pull/668))\n\n### Fixed\n\n- make self-update upgrades reliable ([#664](https://github.com/timurproko/a1/pull/664))\n- restore the terminal and print a resume hint when a1 is killed ([#667](https://github.com/timurproko/a1/pull/667))\n- align progress with Pi accent ([#671](https://github.com/timurproko/a1/pull/671))\n- support Git URL rewrites ([#673](https://github.com/timurproko/a1/pull/673))\n- support repository relocation ([#675](https://github.com/timurproko/a1/pull/675))\n- prevent bottom control gutter bleed ([#677](https://github.com/timurproko/a1/pull/677))\n"
+    },
     {
       "version": "0.2.3",
       "markdown": "## [0.2.3] - 2026-10-03\n\n### Changed\n\n- upgrade pinned Pi to 0.99.1 ([#642](https://github.com/timurproko/a1/pull/642))\n- upgrade pinned Pi to 0.99.2 ([#652](https://github.com/timurproko/a1/pull/652))\n- match changelog link decoration ([#649](https://github.com/timurproko/a1/pull/649))\n- rename stable wrapper ([#655](https://github.com/timurproko/a1/pull/655))\n\n### Fixed\n\n- restore documentation auto-merge ([#653](https://github.com/timurproko/a1/pull/653))\n- allow development publication startup ([#654](https://github.com/timurproko/a1/pull/654))\n- bound Windows backlog setup ([#656](https://github.com/timurproko/a1/pull/656))\n- resolve bundled npm entry ([#657](https://github.com/timurproko/a1/pull/657))\n- verify exact npm resources ([#659](https://github.com/timurproko/a1/pull/659))\n"

package/dist/foundation/release/progress-palette.generated.d.ts

@@ -1,5 +1,5 @@
 /**
- * Generated by scripts/pi/sync-progress-palette.ts from @earendil-works/pi-coding-agent 1.0.0
- * (MIT), commit a13d35a742c6ef8462812a28fbe1d8c8b7431c32. Do not edit directly.
+ * Generated by scripts/pi/sync-progress-palette.ts from @earendil-works/pi-coding-agent 1.0.4
+ * (MIT), commit 7c10bd4337495ee613f2224843ecdf349b80d1df. Do not edit directly.
  */
 export declare const SHARED_PROGRESS_ACCENT_ANSI = "\u001B[38;2;167;152;215m";

package/dist/foundation/release/progress-palette.generated.js

@@ -1,5 +1,5 @@
 /**
- * Generated by scripts/pi/sync-progress-palette.ts from @earendil-works/pi-coding-agent 1.0.0
- * (MIT), commit a13d35a742c6ef8462812a28fbe1d8c8b7431c32. Do not edit directly.
+ * Generated by scripts/pi/sync-progress-palette.ts from @earendil-works/pi-coding-agent 1.0.4
+ * (MIT), commit 7c10bd4337495ee613f2224843ecdf349b80d1df. Do not edit directly.
  */
 export const SHARED_PROGRESS_ACCENT_ANSI = "\u001b[38;2;167;152;215m";

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": "cb2331c550009704bce2614f2f7fb6e1b45ed00403be804da3b83c1ea90a17c4"
+    "sha256": "2adac500d8cebd5f7805c18a549ec0c6b23f13bd10ee5f3f463a6758f489e410"
   },
   "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": "54cea64be46c7a0d36ab6a1889206f79813dba6b9884387b391440fe30a1fdee"
+  "identity": "b010b97970c6c40fe160224121793bf0b26d7c77e7860d8e787aaeb912333100"
 });
 
 export function loadDeclaredStartupGraph() {

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

@@ -2,7 +2,7 @@ export { adaptPiAssistantMessage, adaptPiToolExecution, adaptPiUserMessage } fro
 export { loadHistoryEditor, type HistoryEditorConstructor } from "./history-editor-loader.js";
 export { PiComponentConformanceError, runPiComponentConformance } from "./conformance.js";
 export type { PiComponentConformanceReport, PiComponentConformanceResult } from "./conformance.js";
-export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
+export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
 export { renderPiShellHotkeySections } from "./shell-hotkey-sections.js";
 export type { PiShellHotkeySection } from "./shell-hotkey-sections.js";
 export type { PiExtensionUiBridge, PiExtensionUiBridgeHost, PiShellAuthProviderOption, PiShellAutocompleteCommand, PiShellClipboardContent, PiShellCommandMessagePresentation, PiShellComponentPort, PiShellEditorBodyGeometry, PiShellEditorOptions, PiShellEditorPointerEvent, PiShellEditorPort, PiShellEditorTextRange, PiShellExtensionRendererResolver, PiShellHeaderOptions, PiShellHeaderPort, PiShellHotkeysPresentation, PiShellImageAssetResolver, PiShellLoadedResourcesPort, PiShellLoginDialogPort, PiShellModelSelectorOptions, PiShellModelsDialogOptions, PiShellModelsDialogPort, PiShellOperationLoaderPort, PiShellPasteReservation, PiShellQueuedInputPort, PiShellResourceEntry, PiShellResourceSection, PiShellScopedModelDescriptor, PiShellScopedModelsSelectorOptions, PiShellScopedModelsSelectorPort, PiShellSelectorOption, PiShellSelectorOptions, PiShellSessionInfoPresentation, PiShellSettingsSelectorOptions, PiShellStartupNotice, PiShellStatusPlacement, PiShellStatusPort, PiShellSubmittedPromptComposer, PiShellTranscriptComponentPort, PiShellViewComponentPort, } from "./shell-components.js";