@timurproko/a1 0.1.8-dev.508 → 0.1.8-dev.510

package/README.md

@@ -53,10 +53,40 @@ 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 `/model`. Explicit keybinding overrides
+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
@@ -71,6 +101,19 @@ 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.

package/bin/activate.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+// Protocol: the updater that installed this tree starts this entry with --data-dir and
+// --target-version and reads one JSON progress event per line. The tree activates itself
+// with its own release code, so the updater needs to know nothing else about its layout.
+const { runActivationEntry } = await import("../dist/foundation/release/update-activation.js");
+
+process.exitCode = await runActivationEntry(process.argv.slice(2), import.meta.url);

package/bin/sync-pi-tui-proxy.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+// Compatibility: updaters older than 0.1.8-dev.479 run this entry from the tree they just
+// installed to point a terminal-package proxy that no longer exists at that tree. Those
+// updaters treat a missing file as a failure worth a stack trace on the user's terminal,
+// so the entry stays, does nothing, and exits successfully. Newer updaters never run it.
+process.exitCode = 0;

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

@@ -2,6 +2,6 @@ export { ClipboardDiagnosticCapture } from "./clipboard-diagnostics.js";
 export { ContextualPromptSuggestionController, samePromptSuggestionIdentity } from "./prompt-suggestion-controller.js";
 export type { ContextualPromptSuggestionControllerOptions, ContextualPromptSuggestionSurface } from "./prompt-suggestion-controller.js";
 export { OwnedUiSessionShell, OwnedUiSessionShellRoot, formatSessionResumeCommand, quoteCommandArgument } from "./session-shell.js";
-export type { OwnedUiSessionShellOptions, OwnedUiShellDiagnosticOptions, OwnedUiShellEngineOptions, OwnedUiShellHistoryOptions, OwnedUiShellPresentationOptions, OwnedUiShellSuggestionOptions, SessionResumeCommandMetadata, } from "./session-shell.js";
+export type { OwnedUiSessionShellOptions, OwnedUiShellDiagnosticOptions, OwnedUiShellEngineOptions, OwnedUiShellHistoryOptions, OwnedUiShellPresentationOptions, OwnedUiShellSkillsOptions, OwnedUiShellSuggestionOptions, SessionResumeCommandMetadata, } from "./session-shell.js";
 export { STREAM_PRESENTATION_INTERVAL_MS, StreamPresentationCoalescer } from "./stream-presentation-coalescer.js";
 export type { StreamPresentationScheduler } from "./stream-presentation-coalescer.js";

package/dist/app/session-shell/prompt-suggestion-controller.d.ts

@@ -29,6 +29,8 @@ export declare class ContextualPromptSuggestionController {
     settle(identity: OwnedUiPromptSuggestionIdentity): void;
     accept(): void;
     invalidate(): void;
+    /** Retires only a generating request; a prepared or available suggestion survives the draft edit. */
+    abortPending(): void;
     dispose(): void;
 }
 export declare function samePromptSuggestionIdentity(left: OwnedUiPromptSuggestionIdentity, right: OwnedUiPromptSuggestionIdentity): boolean;

package/dist/app/session-shell/prompt-suggestion-controller.js

@@ -88,6 +88,18 @@ export class ContextualPromptSuggestionController {
     }
     accept() { this.#invalidate(false); }
     invalidate() { this.#invalidate(true); }
+    /** Retires only a generating request; a prepared or available suggestion survives the draft edit. */
+    abortPending() {
+        if (this.#state.status !== "generating")
+            return;
+        const request = this.#request;
+        this.#request = null;
+        this.#state = { status: "idle" };
+        if (request === null)
+            return;
+        this.#finish(request, "cancelled");
+        request.abort.abort();
+    }
     dispose() {
         this.#disposed = true;
         this.invalidate();

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

@@ -4,6 +4,7 @@ import type { UiRouteHost } from "../../ui/apps/contracts.js";
 import type { TranscriptViewportFrame, TranscriptViewportFrameDescriptor } from "../../ui/components/transcript-viewport.js";
 import type { PiEngineAdapter } from "../../integrations/pi/engine/adapter.js";
 import type { PiWorkflowMessage, PiWorkflowResult } from "../../integrations/pi/engine/workflows.js";
+import { type PiShellHotkeysPresentation } from "../../integrations/pi/components/shell-presenters-info.js";
 import { type PiShellClipboardContent, type PiShellComponentPort, type PiShellEditorPort, type PiShellExtensionRendererResolver, type PiShellHeaderOptions, type PiShellHeaderPort, type PiShellImageAssetResolver, type PiShellLoadedResourcesPort, type PiShellResourceEntry, type PiShellTranscriptComponentPort } from "../../integrations/pi/components/shell-shared-facade.js";
 import { type PiTuiInputCoordinationScheduler, type PiTuiInputSurfaceKind } from "../../integrations/pi/tui-runtime/input-presentation-coordinator.js";
 import type { PiTuiComponentPort, PiTuiInputDiagnosticsEvent, PiTuiLayoutNode, PiTuiTerminalPort } from "../../integrations/pi/tui-runtime/contracts.js";
@@ -109,12 +110,19 @@ export interface OwnedUiShellDiagnosticOptions {
     /** Test seams for isolated paste preparation: an in-process starter, or the forked helper's entry. */
     readonly pastePreparation?: Omit<PastePreparationClientOptions, "onEvent" | "spareIdleMs">;
 }
+/** The skills presentation choice: collapse the per-skill commands into one skills command or expand them. */
+export interface OwnedUiShellSkillsOptions {
+    readonly presentation: () => "collapse" | "expand";
+    readonly onChange: (listener: () => void) => () => void;
+}
 /** What composes an owned session shell, grouped by the collaborator that provides each part. */
 export interface OwnedUiSessionShellOptions {
     readonly engine: OwnedUiShellEngineOptions;
     readonly presentation?: OwnedUiShellPresentationOptions;
     readonly history?: OwnedUiShellHistoryOptions;
     readonly suggestions?: OwnedUiShellSuggestionOptions;
+    /** Supplied only to the bare-A1 composition; absent keeps the pinned per-skill command list. */
+    readonly skills?: OwnedUiShellSkillsOptions;
     readonly diagnostics?: OwnedUiShellDiagnosticOptions;
 }
 /** Composes backend session state into the owned transcript, viewport, editor, and dock presentation. */
@@ -152,6 +160,7 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
         readonly captureClipboardPaste?: () => PasteSource;
         readonly pasteDiagnostics?: (event: PasteEvent) => void;
         readonly pastePreparation?: Omit<PastePreparationClientOptions, "onEvent">;
+        readonly skillsPresentation?: () => "collapse" | "expand";
     }, startup?: PiShellHeaderOptions, agentDir?: string, extensionRenderers?: PiShellExtensionRendererResolver, sessionLayout?: "pinned" | "custom-viewport", imageAssets?: PiShellImageAssetResolver);
     setEditorPaddingX(padding: number): void;
     setAutocompleteMaxVisible(maxVisible: number): void;
@@ -244,6 +253,7 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     setExtensionFooter(component: PiShellComponentPort | null): void;
     setExtensionStatus(key: string, text: string | undefined): void;
     setExtensionWorking(message: string | undefined, visible?: boolean): void;
+    hotkeysPresentation(): PiShellHotkeysPresentation;
     resetWorkflowPresentation(): void;
     resetExtensionUi(): void;
     addExtensionNotification(message: string, type: "info" | "warning" | "error"): void;

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

@@ -682,7 +682,9 @@ export class OwnedUiSessionShellRoot {
             .flatMap(diagnostic => renderPiShellPackageUpdateNotice(diagnostic.message.split("\n").filter(line => line.startsWith("- ")).map(line => line.slice(2)), width)));
         rows.push(...diagnostics
             .filter(diagnostic => diagnostic.code === "changelog-collapsed" || diagnostic.code === "changelog-expanded")
-            .flatMap(diagnostic => diagnostic.code === "changelog-collapsed"
+            // Rationale: the custom viewport shows the new entries on the What's New screen, so its feed
+            // carries only the hint for either diagnostic; the pinned layout keeps the full document.
+            .flatMap(diagnostic => diagnostic.code === "changelog-collapsed" || this.#customViewport
             ? createPiShellCollapsedChangelog().render(width)
             : createPiShellChangelog(diagnostic.message).render(width)));
         rows.push(...diagnostics
@@ -809,7 +811,8 @@ export class OwnedUiSessionShellRoot {
         }
         if (result.command === "hotkeys" && result.outcome === "completed") {
             this.#lastWorkflowStatusId = undefined;
-            const hotkeys = createPiShellHotkeys(this.editor.keybindingConfig(), bindings => this.#extensionRenderers.getShortcuts?.(bindings) ?? [], this.#customViewport ? "a1" : "pi");
+            const presentation = this.hotkeysPresentation();
+            const hotkeys = createPiShellHotkeys(presentation.bindings, presentation.getShortcuts, presentation.profile);
             this.#appendAnchoredWorkflowComponent(width => hotkeys.render(width), () => hotkeys.dispose?.());
             return;
         }
@@ -903,6 +906,13 @@ export class OwnedUiSessionShellRoot {
         this.#status.setWorkingOverride(visible ? message : undefined);
         this.invalidate();
     }
+    hotkeysPresentation() {
+        return {
+            bindings: this.editor.keybindingConfig(),
+            getShortcuts: bindings => this.#extensionRenderers.getShortcuts?.(bindings) ?? [],
+            profile: this.#customViewport ? "a1" : "pi",
+        };
+    }
     resetWorkflowPresentation() {
         this.#dockNotice = undefined;
         for (const id of this.#workflowStatusAnchors.keys()) {

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

@@ -1,12 +1,14 @@
 import type { OwnedUiSessionViewModel, OwnedUiThinkingLevel } from "../../contracts/owned-ui/index.js";
 import type { AdapterCommandResult } from "../../integrations/pi/engine/adapter.js";
 import type { PiWorkflowRequest } from "../../integrations/pi/engine/workflows.js";
+import { type PiShellSkillSummary } from "../../integrations/pi/components/skills-command.js";
+import { type PiShellHotkeysPresentation } from "../../integrations/pi/components/shell-presenters-info.js";
 import type { PiShellSelectorOption } from "../../integrations/pi/components/shell-shared-facade.js";
 import { type PiTuiDamageDecision } from "../../integrations/pi/tui-runtime/damage-aware-terminal.js";
 import { PiTuiRuntimeAdapter } from "../../integrations/pi/tui-runtime/adapter.js";
 import type { PiTuiOverlayHandle } from "../../integrations/pi/tui-runtime/contracts.js";
 import { OwnedUiSessionShellRoot, type OwnedUiBackendPort, type OwnedUiSessionShellOptions } from "./session-shell-root.js";
-export { OwnedUiSessionShellRoot, type OwnedUiSessionShellOptions, type OwnedUiShellDiagnosticOptions, type OwnedUiShellEngineOptions, type OwnedUiShellHistoryOptions, type OwnedUiShellPresentationOptions, type OwnedUiShellSuggestionOptions, } from "./session-shell-root.js";
+export { OwnedUiSessionShellRoot, type OwnedUiSessionShellOptions, type OwnedUiShellDiagnosticOptions, type OwnedUiShellEngineOptions, type OwnedUiShellHistoryOptions, type OwnedUiShellPresentationOptions, type OwnedUiShellSkillsOptions, type OwnedUiShellSuggestionOptions, } from "./session-shell-root.js";
 /** Coordinates backend, owned presentation, and Pi TUI lifecycles for one interactive session. */
 export declare class OwnedUiSessionShell {
     #private;
@@ -35,6 +37,8 @@ export declare class OwnedUiSessionShell {
     restoreQueuedInput(): void;
     showSelector(title: string, options: readonly PiShellSelectorOption[], onSelect: (id: string) => void, onCancel?: () => void): PiTuiOverlayHandle;
     showThinkingSelector(): void;
+    /** The Skills dialog: a replacement input like the model selector, applying the chosen skill through the prompt path. */
+    showSkillsSelector(skills?: readonly PiShellSkillSummary[]): void;
     showModelSelector(initialSearchInput?: string): void;
     showForkSelector(): void;
     showLogoutSelector(): Promise<void>;
@@ -48,7 +52,10 @@ export declare class OwnedUiSessionShell {
     runWorkflow(request: PiWorkflowRequest): Promise<AdapterCommandResult>;
     showTrustSelector(): void;
     showScopedModelsSelector(): void;
+    /** The bare-A1 unified Models dialog: switch on Enter, scope on Space, persist on Ctrl+S, all through the engine. */
+    showModelsDialog(initialQuery?: string): void;
     dispose(): Promise<void>;
+    hotkeysPresentation(): PiShellHotkeysPresentation;
 }
 export interface SessionResumeCommandMetadata {
     readonly sessionId: string;

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

@@ -9,12 +9,14 @@ import { assertPromptImages, ImageAttachmentError } from "../../contracts/owned-
 import { ContextualPromptSuggestionController } from "./prompt-suggestion-controller.js";
 import { MOUSE_TRACKING_OFF, MOUSE_TRACKING_ON, parseMouseInput } from "../../ui/components/mouse.js";
 import { readVisibleHyperlinks } from "../../ui/components/visible-hyperlinks.js";
-import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES } from "../../integrations/pi/engine/workflows.js";
+import { PINNED_PI_HIDDEN_COMMAND_NAMES, workflowCommandNames } from "../../integrations/pi/engine/workflows.js";
 import { createPiExtensionUiBridge } from "../../integrations/pi/components/shell-extension-ui.js";
 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, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellThinkingSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
+import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellSkillsSelector, createPiShellThinkingSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
 import { createPiShellChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellStatusText, } from "../../integrations/pi/components/shell-presenters-info.js";
+import { CHANGELOG_ROUTE } from "../../features/owned-ui/reference-routes.js";
 import { createPiShellTranscriptComponent, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, } from "../../integrations/pi/components/shell-presenters-transcript.js";
 import { onPiThemeChange, piTheme } from "../../integrations/pi/components/upstream/theme/theme.js";
 import { DamageAwareTerminalAdapter } from "../../integrations/pi/tui-runtime/damage-aware-terminal.js";
@@ -35,6 +37,9 @@ export class OwnedUiSessionShell {
     #unsubscribe;
     #unsubscribePromptSuggestions;
     #promptSuggestions;
+    #skills;
+    #unsubscribeSkills;
+    #installedCommandSignature = "";
     #promptHistory = null;
     #promptHistoryImageSidecar;
     #extensionBridge;
@@ -51,6 +56,8 @@ export class OwnedUiSessionShell {
     #shutdownPromise;
     #disposePromise;
     #pointerReporting = false;
+    // Invariant: the startup release notes open at most once per shell, whatever the view does later.
+    #startupChangelogHandled = false;
     #customViewport;
     #responseCopy;
     // Rationale: only an executor this shell created owns a spare copy helper worth warming and disposing.
@@ -96,6 +103,8 @@ export class OwnedUiSessionShell {
         let streamPresentation;
         let pendingClipboardWrite = Promise.resolve();
         let promptSuggestionController = null;
+        // Invariant: the collapsed skills presentation is a bare-A1 replacement; comparison profiles keep the pinned list.
+        this.#skills = this.#customViewport ? options.skills ?? null : null;
         const terminalCopy = terminal !== undefined || hasAsyncClipboardOutput();
         this.#responseCopy = this.#customViewport ? new ResponseCopyCoordinator({
             execute: responseCopy?.execute ?? (this.#copyExecutor = createResponseCopyExecutor({
@@ -160,7 +169,7 @@ export class OwnedUiSessionShell {
             onInterrupt: () => { void this.interrupt(); },
             onClear: () => { void this.clearOrExit(); },
             onExit: () => { void this.shutdown(); },
-            onModelSelect: () => this.showModelSelector(),
+            onModelSelect: () => this.#customViewport ? this.showModelsDialog() : this.showModelSelector(),
             onModelCycle: direction => { void this.cycleModel(direction); },
             onThinkingCycle: () => { void this.cycleThinkingLevel(); },
             onThinkingToggle: () => {
@@ -170,7 +179,7 @@ export class OwnedUiSessionShell {
             onMessageCopy: () => { void this.runWorkflow({ command: "copy", argument: "" }); },
             onFollowUp: () => { void this.queueFollowUp().catch(() => this.#reportSubmissionError()); },
             onDequeue: () => this.restoreQueuedInput(),
-            onEditorChange: () => { this.#editorRevision++; promptSuggestionController?.invalidate(); },
+            onEditorChange: () => { this.#editorRevision++; promptSuggestionController?.abortPending(); },
             onPromptSuggestionAccepted: () => promptSuggestionController?.accept(),
             onInputSurfaceChanged: () => {
                 promptSuggestionController?.invalidate();
@@ -207,6 +216,7 @@ export class OwnedUiSessionShell {
             },
             ...(pasteDiagnostics === undefined ? {} : { pasteDiagnostics: pasteDiagnostics }),
             ...(pastePreparation === undefined ? {} : { pastePreparation }),
+            skillsPresentation: () => this.#skills?.presentation() ?? "expand",
         }, {
             ...startup,
             resources: startup?.resources ?? shellResourceEntries(this.backend),
@@ -287,6 +297,15 @@ export class OwnedUiSessionShell {
         this.#unsubscribePromptSuggestions = promptSuggestionOptions === undefined
             ? () => { }
             : promptSuggestionOptions.onChange(enabled => this.#promptSuggestions?.setEnabled(enabled));
+        // Rationale: the same listener refreshes the menu for the A1 presentation choice and for the engine's
+        // skill-command registration, both of which the owned settings manager reports through one change.
+        this.#unsubscribeSkills = this.#skills === null ? () => { } : this.#skills.onChange(() => {
+            // Invariant: reinstalling drops extension provider wrappers, so an unrelated setting change leaves the list alone.
+            if (this.#disposed || this.#commandListSignature() === this.#installedCommandSignature)
+                return;
+            this.#installAutocompleteCommands();
+            this.runtime.requestRender();
+        });
         const initialPiSettings = this.backend.pinnedSettingsSnapshot();
         this.runtime.setHardwareCursor(initialPiSettings.showHardwareCursor);
         this.runtime.setClearOnShrink(initialPiSettings.clearOnShrink);
@@ -453,7 +472,7 @@ export class OwnedUiSessionShell {
             },
             finishLogin: () => this.#finishWorkflowLogin(),
         });
-        this.root.editor.setAutocompleteCommands(this.backend.workflowAutocompleteCommands());
+        this.#installAutocompleteCommands();
         this.#unsubscribe = this.backend.onEvent(event => {
             // Performance: a streamed chunk names one block, and touching only that block is what keeps the
             // cost of a chunk the same in a long session as in a new one. Everything else
@@ -669,7 +688,7 @@ export class OwnedUiSessionShell {
         }, displayInput);
     }
     async clearOrExit(now = Date.now()) {
-        this.#promptSuggestions?.invalidate();
+        this.#promptSuggestions?.abortPending();
         if (now - this.#lastClearTime < 500)
             return this.shutdown();
         this.root.editor.setText("");
@@ -834,6 +853,23 @@ export class OwnedUiSessionShell {
         this.root.setInputSurface(component);
         this.runtime.requestRender();
     }
+    /** The Skills dialog: a replacement input like the model selector, applying the chosen skill through the prompt path. */
+    showSkillsSelector(skills = this.#skillSummaries()) {
+        const close = () => {
+            this.root.setInputSurface(null);
+            this.runtime.requestRender();
+        };
+        const component = createPiShellSkillsSelector({
+            skills,
+            onSelect: name => {
+                close();
+                void this.#submitSkillPrompt(skillPrompt(name), skillPrompt(name)).catch(() => this.#reportSubmissionError());
+            },
+            onCancel: close,
+        });
+        this.root.setInputSurface(component);
+        this.runtime.requestRender();
+    }
     showModelSelector(initialSearchInput) {
         const context = this.backend.pinnedModelSelectorContext();
         const close = () => {
@@ -1139,6 +1175,10 @@ export class OwnedUiSessionShell {
             this.showScopedModelsSelector();
             return { outcome: "completed", diagnostic: null };
         }
+        if (request.command === "models" && request.selection === undefined) {
+            this.showModelsDialog(request.argument.trim() || undefined);
+            return { outcome: "completed", diagnostic: null };
+        }
         if (request.command === "model" && request.selection === undefined && request.confirmed === undefined && request.argument.trim().length === 0) {
             this.showModelSelector();
             return { outcome: "completed", diagnostic: null };
@@ -1247,10 +1287,10 @@ export class OwnedUiSessionShell {
         if (request.command === "reload" && result.outcome === "completed") {
             this.root.resetWorkflowPresentation();
             this.root.editor.reloadKeybindings();
-            this.root.editor.setAutocompleteCommands(this.backend.workflowAutocompleteCommands());
+            this.#installAutocompleteCommands();
         }
         this.root.appendWorkflowResult(result);
-        if (request.command === "model" && result.outcome === "completed")
+        if ((request.command === "model" || request.command === "models") && result.outcome === "completed")
             this.#showDaxnutsForActiveModel();
         this.runtime.requestRender();
         return workflowAdapterResult(result);
@@ -1357,6 +1397,90 @@ export class OwnedUiSessionShell {
             this.runtime.requestRender();
         }).finally(() => clearTimeout(timeout));
     }
+    // Invariant: bare A1 routes `models`; the comparison profile keeps the pinned `model`/`scoped-models` pair. Hidden routes are shared.
+    #isWorkflowRoute(value) {
+        return workflowCommandNames(this.#customViewport ? "bare" : "comparison").includes(value)
+            || PINNED_PI_HIDDEN_COMMAND_NAMES.includes(value);
+    }
+    /** The bare-A1 unified Models dialog: switch on Enter, scope on Space, persist on Ctrl+S, all through the engine. */
+    showModelsDialog(initialQuery) {
+        const context = this.backend.modelsContext();
+        const available = new Set(context.models.map(model => `${model.provider}/${model.id}`));
+        const savedScopeIds = context.persistedScopeIds.filter(id => available.has(id));
+        // Invariant: an explicit session scope wins; otherwise the dialog starts from what is persisted, never from "all rows scoped".
+        const scopeIds = context.sessionScopeIds.length > 0 ? context.sessionScopeIds : savedScopeIds;
+        let disposed = false;
+        let timedOut = false;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => {
+            timedOut = true;
+            controller.abort();
+        }, 15_000);
+        const close = () => {
+            disposed = true;
+            clearTimeout(timeout);
+            controller.abort();
+            this.root.setInputSurface(null);
+            this.runtime.requestRender();
+        };
+        const dialog = createPiShellModelsDialog({
+            models: context.models,
+            activeModelId: context.activeModelId,
+            scopeIds,
+            savedScopeIds,
+            ...(initialQuery === undefined ? {} : { initialQuery }),
+            refreshStatus: "Refreshing model catalogs…",
+            requestRender: () => this.runtime.requestRender(),
+            onSelect: modelId => {
+                void this.runWorkflow({ command: "models", argument: "", selection: modelId }).then(result => {
+                    if (!disposed && result.outcome === "completed")
+                        close();
+                });
+            },
+            onScopeChange: ids => {
+                this.backend.setSessionModelScope(ids);
+                this.runtime.requestRender();
+            },
+            onSave: ids => {
+                try {
+                    this.backend.persistModelScope(ids);
+                }
+                catch (error) {
+                    this.root.appendWorkflowResult({ command: "models", outcome: "failed", message: error instanceof Error ? error.message : String(error) });
+                    this.runtime.requestRender();
+                    throw error;
+                }
+                this.root.appendWorkflowStatus("Model selection saved to settings");
+                this.runtime.requestRender();
+            },
+            onCancel: close,
+        });
+        const component = {
+            ...dialog,
+            dispose: () => {
+                disposed = true;
+                clearTimeout(timeout);
+                controller.abort();
+                dialog.dispose?.();
+            },
+        };
+        this.root.setInputSurface(component);
+        this.runtime.requestRender();
+        void this.backend.refreshModels(controller.signal).then(refreshed => {
+            if (disposed)
+                return;
+            component.updateModels(refreshed.models);
+            component.setRefreshStatus(timedOut ? "Model refresh timed out; showing cached models." : refreshed.status, timedOut ? "warning" : refreshed.statusKind);
+            this.runtime.requestRender();
+        }).catch(error => {
+            if (disposed)
+                return;
+            component.setRefreshStatus(timedOut
+                ? "Model refresh timed out; showing cached models."
+                : `Could not refresh model catalogs: ${error instanceof Error ? error.message : String(error)}`, "warning");
+            this.runtime.requestRender();
+        }).finally(() => clearTimeout(timeout));
+    }
     #showDaxnutsForActiveModel() {
         const model = this.view().activeModel;
         if (model?.providerId === "opencode" && model.modelId.toLowerCase().includes("kimi-k2.5")) {
@@ -1409,6 +1533,7 @@ export class OwnedUiSessionShell {
         attempt(() => this.#streamPresentation.dispose());
         attempt(() => this.#promptSuggestions?.dispose());
         attempt(() => this.#unsubscribePromptSuggestions());
+        attempt(() => this.#unsubscribeSkills());
         attempt(() => this.#unsubscribeSettings());
         let fullscreenExitText = "";
         attempt(() => {
@@ -1453,11 +1578,13 @@ export class OwnedUiSessionShell {
         if (!this.runtime.active || this.runtime.mode !== "fullscreen")
             return null;
         try {
-            const { enabled, effect, durationMs } = outro.snapshot();
-            if (!enabled)
+            if (!outro.snapshot().enabled)
                 return null;
             const viewport = this.runtime.viewport();
-            return { rows: this.#damageTerminal.presentedRows(), columns: viewport.columns, height: viewport.rows, settings: { effect, durationMs } };
+            return {
+                rows: this.#damageTerminal.presentedRows(), columns: viewport.columns, height: viewport.rows,
+                settings: { effect: QUIT_OUTRO_EFFECT, durationMs: QUIT_OUTRO_DURATION_MS },
+            };
         }
         catch {
             return null;
@@ -1550,13 +1677,31 @@ export class OwnedUiSessionShell {
         }
         this.root.update(view);
         this.#syncDialog(view.dialog);
+        this.#presentStartupChangelog(view);
         this.runtime.requestRender();
         for (const listener of this.#listeners)
             listener(view);
         return view;
     }
-    #openOwnedRoute(route) {
-        const surface = this.#routeHost?.open(route) ?? null;
+    // Rationale: the engine has already stored the current version when the diagnostic arrives, so the
+    // entries newer than the last acknowledged one exist only in its message; the screen shows exactly those.
+    #presentStartupChangelog(view) {
+        if (this.#startupChangelogHandled || !this.#customViewport || this.#routeHost === null)
+            return;
+        const diagnostic = view.diagnostics.find(candidate => candidate.code === "changelog-expanded");
+        // Invariant: a view synchronized before the runtime starts is not the moment of arrival; start() replays it.
+        if (diagnostic === undefined || !this.runtime.active)
+            return;
+        this.#startupChangelogHandled = true;
+        // Invariant: a dialog, selector, or owned screen already up keeps the screen; the hint stays in the feed.
+        if (this.#dialogHandle !== undefined || !this.root.usesDefaultInputSurface())
+            return;
+        if (!this.#routeHost.claims(CHANGELOG_ROUTE))
+            return;
+        this.#openOwnedRoute(CHANGELOG_ROUTE, { document: diagnostic.message });
+    }
+    #openOwnedRoute(route, input) {
+        const surface = this.#routeHost?.open(route, input) ?? null;
         if (surface === null)
             return { outcome: "failed", diagnostic: `route is unavailable: ${route}` };
         if (!this.runtime.active)
@@ -1683,6 +1828,9 @@ export class OwnedUiSessionShell {
         });
         this.#dialogId = dialog.id;
     }
+    hotkeysPresentation() {
+        return this.root.hotkeysPresentation();
+    }
     async #slashCommand(text) {
         const body = text.slice(1).trim();
         const separator = body.search(/\s/);
@@ -1690,8 +1838,15 @@ export class OwnedUiSessionShell {
         const argument = separator < 0 ? "" : body.slice(separator + 1).trimStart();
         if (this.#routeHost?.claims(name))
             return this.#openOwnedRoute(name);
-        if (isWorkflowRoute(name))
+        if (this.#isWorkflowRoute(name))
             return this.runWorkflow({ command: name, argument });
+        if (this.#skillsCollapsed()) {
+            if (name === SKILLS_COMMAND_NAME)
+                return this.#runSkillsCommand(text, argument);
+            const rewritten = rewriteSkillsTunnelSubmission(text);
+            if (rewritten !== text)
+                return this.#submitSkillPrompt(rewritten, text);
+        }
         // Compatibility: unknown slash input, prompt templates, skills, and extension commands remain Pi prompt input.
         this.#rememberInput(text, "slash");
         this.root.resumeViewportFollowing();
@@ -1702,6 +1857,51 @@ export class OwnedUiSessionShell {
             text,
         });
     }
+    #installAutocompleteCommands() {
+        this.root.editor.setAutocompleteCommands(this.backend.workflowAutocompleteCommands());
+        this.#installedCommandSignature = this.#commandListSignature();
+    }
+    #commandListSignature() {
+        return JSON.stringify([this.#skills?.presentation() ?? "expand", this.backend.disposed ? [] : this.backend.workflowAutocompleteCommands().map(command => command.name)]);
+    }
+    // Invariant: collapse applies only while the engine registers skill commands; otherwise there is nothing to collapse.
+    #skillsCollapsed() {
+        return this.#skills !== null && this.#skills.presentation() === "collapse"
+            && !this.backend.disposed && this.backend.pinnedSettingsSnapshot().enableSkillCommands;
+    }
+    #skillSummaries() {
+        return skillsFromCommands(this.backend.workflowAutocompleteCommands());
+    }
+    // Protocol: bare "/skills" opens the dialog, "/skills <name> [args]" applies directly, and an unknown name is a command outcome.
+    async #runSkillsCommand(text, argument) {
+        const skills = this.#skillSummaries();
+        const trimmed = argument.trim();
+        if (trimmed.length === 0) {
+            this.showSkillsSelector(skills);
+            return { outcome: "completed", diagnostic: null };
+        }
+        const separator = trimmed.search(/\s/u);
+        const token = separator < 0 ? trimmed : trimmed.slice(0, separator);
+        const skill = findSkillByArgument(skills, token);
+        if (skill === undefined) {
+            const message = "Unknown skill: " + token;
+            this.root.appendWorkflowMessage({ kind: "error", message });
+            this.runtime.requestRender();
+            return { outcome: "failed", diagnostic: message };
+        }
+        return this.#submitSkillPrompt(skillPrompt(skill.name, separator < 0 ? "" : trimmed.slice(separator + 1)), text);
+    }
+    // Rationale: the engine expands "/skill:<name> args" itself; history keeps the form the user typed so recall restores the invocation.
+    #submitSkillPrompt(prompt, typed) {
+        this.#rememberInput(typed, "slash");
+        this.root.resumeViewportFollowing();
+        return this.#execute({
+            type: this.view().lifecycle === "busy" ? "steer" : "prompt",
+            correlationId: this.#correlation("prompt-command"),
+            sessionId: this.backend.sessionId,
+            text: prompt,
+        });
+    }
     async #completeTreeSelection(entryId, skipSummaryPrompt) {
         let summarize = false;
         let customInstructions;
@@ -1911,7 +2111,6 @@ function workflowAdapterResult(result) {
 const INTERRUPT = "\u0003";
 const INTERRUPT_CHORD_MS = 1_500;
 const RELOAD_SURFACE_MIN_VISIBLE_MS = 400;
-function isWorkflowRoute(value) {
-    return PINNED_PI_WORKFLOW_COMMAND_NAMES.includes(value)
-        || PINNED_PI_HIDDEN_COMMAND_NAMES.includes(value);
-}
+// Rationale: the outro is not configurable; the switch only decides whether this plan plays.
+const QUIT_OUTRO_EFFECT = "fall";
+const QUIT_OUTRO_DURATION_MS = 800;

package/dist/composition/index.d.ts

@@ -1,2 +1,2 @@
 export { composeOwnedUi, composeOwnedUiApplication, type OwnedUiComposition, type OwnedUiCompositionOptions, } from "./owned-ui.js";
-export { createOwnedRouteHost } from "./settings-route-host.js";
+export { createOwnedRouteHost, type OwnedReferenceProviders, type OwnedReferenceRows } from "./settings-route-host.js";