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

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.
@@ -187,29 +230,30 @@ a1 update --develop 0.1.8-dev.107       # install that exact full preview versio
 ### Stable
 
 ```sh
-npm run release -- patch     # 0.1.8-dev -> 0.1.8; already-stable 0.1.8 -> 0.1.9
+npm run release -- patch     # 0.1.8-dev -> 0.1.8
 npm run release -- minor     # 0.1.8-dev -> 0.2.0
 npm run release -- major     # 0.1.8-dev -> 1.0.0
 npm run release -- 0.4.0     # an exact stable version
 ```
 
-Run from the repository root on a clean `develop` matching `origin/develop`.
-A target is required; bare `npm run release` displays usage and releases nothing.
-`patch` promotes the current prerelease rather than skipping its stable version.
-
-The command prepares a version-only PR in an isolated detached worktree, prints
-its URL, and waits for you to validate and **merge it manually**. Neither this PR
-nor the next-development PR is auto-merged, and green CI alone does not advance
-the release. After the stable PR merges, the command dispatches publication for
-that exact authoritative commit and waits for success. CI validates the packed
-release on Windows, Linux, and macOS, publishes to npm `latest` with provenance,
-then writes the `v<version>` tag and GitHub Release and fast-forwards `master`.
-
-Only after confirmed publication of `0.1.8` does the command prepare the separate
-`0.1.9-dev` PR. It reports development reopened only after you manually merge that
-PR too. Work added to your checkout during either wait is preserved, not reset.
-If publication fails or is uncertain, no reopening PR is prepared. If publication
-succeeded but reopening failed, inspect the reported phase and PR; do not republish
-the immutable stable version.
+Run from the repository root on a clean `develop` matching `origin/develop` that
+declares the open `-dev` version. A target is required; bare `npm run release`
+displays usage and releases nothing. `patch` promotes the current prerelease rather
+than skipping its stable version.
+
+The stable version is never committed. The command dispatches publication for the
+exact authoritative `develop` commit with the stable version named in the request,
+and waits for success. CI stamps that version on the checked-out source before
+packing, validates the packed release on Windows, Linux, and macOS, publishes to
+npm `latest` with provenance, then writes the `v<version>` tag on that same
+`develop` commit, records the GitHub Release, and fast-forwards `master`.
+
+Only after confirmed publication of `0.1.8` does the command prepare the one
+version-only PR, `0.1.9-dev`, in an isolated detached worktree, print its URL, and
+wait for you to **merge it manually**. It is not auto-merged, and green CI alone does
+not advance the release. Work added to your checkout during the wait is preserved,
+not reset. If publication fails or is uncertain, no reopening PR is prepared. If
+publication succeeded but reopening failed, merge or repair the reported PR by
+hand; do not republish the immutable stable version.
 
 `docs/ci-release-runbook.md` has the full picture.

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;