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

package/dist/integrations/pi/engine/workflow-contexts.js

@@ -156,23 +156,67 @@ export class PiWorkflowContexts {
         requireCapability(runtime.services.settingsManager?.setEnabledModels, "setEnabledModels").call(runtime.services.settingsManager, patterns === undefined ? undefined : [...patterns]);
     }
     async refreshScopedModels(signal) {
+        const outcome = await this.#refreshCatalogs(signal);
+        return { ...this.pinnedScopedModelsContext(), ...outcome };
+    }
+    /** The bare-A1 Models dialog's read: catalog, active model, and the session and persisted scopes kept separate. */
+    modelsContext() {
+        const session = this.#requireSession();
+        const runtime = this.#ports.runtime();
+        if (!runtime)
+            throw new Error("engine runtime is unavailable");
+        const models = scopedModelRecords(runtime.services.modelRuntime);
+        const scoped = session.scopedModels;
+        const active = this.#ports.activeModel();
+        const patterns = runtime.services.settingsManager?.getEnabledModels?.();
+        return {
+            models: models.map(item => item.descriptor),
+            activeModelId: active === null ? null : `${active.providerId}/${active.modelId}`,
+            sessionScopeIds: Array.isArray(scoped) ? scoped.map(scopedModelReference).filter((id) => id !== undefined) : [],
+            persistedScopeIds: Array.isArray(patterns)
+                ? resolveConfiguredModelIds(patterns.filter((value) => typeof value === "string"), models)
+                : [],
+        };
+    }
+    /** Replace the session's cycling scope with exactly these available models, in order; empty restores the all-model fallback. */
+    setSessionModelScope(scopeIds) {
+        const session = this.#requireSession();
+        const runtime = this.#ports.runtime();
+        if (!runtime)
+            throw new Error("engine runtime is unavailable");
+        const models = scopedModelRecords(runtime.services.modelRuntime);
+        const scoped = scopeIds.flatMap(id => {
+            const item = models.find(candidate => `${candidate.descriptor.provider}/${candidate.descriptor.id}` === id);
+            return item === undefined ? [] : [{ model: item.model }];
+        });
+        requireCapability(session.setScopedModels, "setScopedModels").call(session, scoped);
+        this.#ports.emitView();
+    }
+    /** Persist the explicit scope as `enabledModels`; an empty scope removes the setting so cycling falls back to every model. */
+    persistModelScope(scopeIds) {
+        const runtime = this.#ports.runtime();
+        if (!runtime)
+            throw new Error("engine runtime is unavailable");
+        requireCapability(runtime.services.settingsManager?.setEnabledModels, "setEnabledModels")
+            .call(runtime.services.settingsManager, scopeIds.length === 0 ? undefined : [...scopeIds]);
+    }
+    async refreshModels(signal) {
+        const outcome = await this.#refreshCatalogs(signal);
+        return { models: this.modelsContext().models, ...outcome };
+    }
+    async #refreshCatalogs(signal) {
         const runtime = this.#ports.runtime();
         if (!runtime)
             throw new Error("engine runtime is unavailable");
         const result = await runtime.services.modelRuntime.refresh?.({ signal });
-        const context = this.pinnedScopedModelsContext();
         if (isRecord(result) && result.aborted === true) {
-            return { ...context, status: "Model refresh timed out; showing cached models.", statusKind: "warning" };
+            return { status: "Model refresh timed out; showing cached models.", statusKind: "warning" };
         }
         const errors = isRecord(result) ? result.errors : undefined;
         if (errors instanceof Map && errors.size > 0) {
-            return {
-                ...context,
-                status: `Could not refresh ${[...errors.keys()].join(", ")}; showing cached models.`,
-                statusKind: "warning",
-            };
+            return { status: `Could not refresh ${[...errors.keys()].join(", ")}; showing cached models.`, statusKind: "warning" };
         }
-        return { ...context, status: "Model catalogs refreshed.", statusKind: "success" };
+        return { status: "Model catalogs refreshed.", statusKind: "success" };
     }
     pinnedLoginMethodOptions(providerReference) {
         const runtime = this.#ports.runtime();

package/dist/integrations/pi/engine/workflow-runner.js

@@ -150,6 +150,86 @@ export class PiWorkflowRunner {
             return workflowResult(request.command, "failed", contextualMessage);
         }
     }
+    async #selectModel(request, reference, options) {
+        const session = this.#requireSession();
+        const runtime = this.#ports.runtime();
+        if (!runtime)
+            throw new Error("engine runtime is unavailable");
+        let model = findExactWorkflowModel(reference, options.pool);
+        const messages = [];
+        const generation = this.#ports.sessionGeneration();
+        const current = () => !this.#ports.disposed() && generation === this.#ports.sessionGeneration();
+        const publish = (message) => {
+            if (!current())
+                return;
+            const interaction = this.#ports.interaction();
+            if (interaction.publish)
+                interaction.publish(message);
+            else
+                messages.push(message);
+        };
+        if (model === undefined && options.refreshOnMiss) {
+            publish({ kind: "status", message: "Refreshing model catalogs…" });
+            const controller = new AbortController();
+            let timedOut = false;
+            const timeout = setTimeout(() => {
+                timedOut = true;
+                controller.abort();
+            }, AUTH_REFRESH_TIMEOUT_MS);
+            try {
+                const refreshed = await runtime.services.modelRuntime.refresh?.({ signal: controller.signal });
+                if (isRecord(refreshed) && refreshed.aborted === true && timedOut) {
+                    publish({ kind: "warning", message: "Model refresh timed out; searching cached models." });
+                }
+                else if (isRecord(refreshed) && refreshed.errors instanceof Map && refreshed.errors.size > 0) {
+                    publish({ kind: "warning", message: `Could not refresh ${[...refreshed.errors.keys()].join(", ")}; searching cached models.` });
+                }
+            }
+            catch (error) {
+                publish({
+                    kind: "warning",
+                    message: timedOut
+                        ? "Model refresh timed out; searching cached models."
+                        : `Could not refresh model catalogs: ${error instanceof Error ? error.message : String(error)}`,
+                });
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+            model = findExactWorkflowModel(reference, [...(runtime.services.modelRuntime.getAvailableSnapshot?.() ?? [])]);
+        }
+        if (!current())
+            return workflowResult(request.command, "cancelled", "Model selection cancelled", undefined, "silent");
+        if (model === undefined) {
+            if (options.onMiss === "failed") {
+                const failure = { kind: "error", message: `Model not found: ${reference}` };
+                return workflowResult(request.command, "failed", failure.message, undefined, "error", messages.length === 0 ? undefined : [...messages, failure]);
+            }
+            return {
+                ...workflowResult(request.command, "requires-selection", "Select a model", reference, "silent"),
+                ...(messages.length === 0 ? {} : { messages: Object.freeze(messages) }),
+            };
+        }
+        try {
+            await session.setModel(model, { persist: options.persist });
+        }
+        catch (error) {
+            if (!current())
+                return workflowResult(request.command, "cancelled", "Model selection cancelled", undefined, "silent");
+            const failure = { kind: "error", message: error instanceof Error ? error.message : String(error) };
+            return workflowResult(request.command, "failed", failure.message, undefined, "error", messages.length === 0 ? undefined : [...messages, failure]);
+        }
+        if (!current())
+            return workflowResult(request.command, "cancelled", "Model selection cancelled", undefined, "silent");
+        const providerId = stringProperty(model, "provider") ?? "unknown";
+        const modelId = stringProperty(model, "id") ?? reference;
+        this.#ports.setActiveModel({ providerId, modelId, displayName: stringProperty(model, "name") ?? modelId });
+        this.#ports.emitView();
+        const resultMessage = { kind: "status", message: options.persist ? `Default model: ${providerId}/${modelId}` : `Model: ${modelId}` };
+        return messages.length === 0
+            ? workflowResult(request.command, "completed", resultMessage.message)
+            : workflowResult(request.command, "completed", resultMessage.message, undefined, "status", [...messages, resultMessage]);
+    }
     async #performWorkflow(request) {
         const session = this.#requireSession();
         const runtime = this.#ports.runtime();
@@ -191,80 +271,24 @@ export class PiWorkflowRunner {
                 const scopedModels = Array.isArray(session.scopedModels)
                     ? session.scopedModels.map(item => item.model)
                     : [];
-                let availableModels = scopedModels.length > 0
-                    ? scopedModels
-                    : [...(runtime.services.modelRuntime.getAvailableSnapshot?.() ?? [])];
-                let model = findExactWorkflowModel(reference, availableModels);
-                const messages = [];
-                const generation = this.#ports.sessionGeneration();
-                const current = () => !this.#ports.disposed() && generation === this.#ports.sessionGeneration();
-                const publish = (message) => {
-                    if (!current())
-                        return;
-                    const interaction = this.#ports.interaction();
-                    if (interaction.publish)
-                        interaction.publish(message);
-                    else
-                        messages.push(message);
-                };
-                if (model === undefined && scopedModels.length === 0) {
-                    publish({ kind: "status", message: "Refreshing model catalogs…" });
-                    const controller = new AbortController();
-                    let timedOut = false;
-                    const timeout = setTimeout(() => {
-                        timedOut = true;
-                        controller.abort();
-                    }, AUTH_REFRESH_TIMEOUT_MS);
-                    try {
-                        const refreshed = await runtime.services.modelRuntime.refresh?.({ signal: controller.signal });
-                        if (isRecord(refreshed) && refreshed.aborted === true && timedOut) {
-                            publish({ kind: "warning", message: "Model refresh timed out; searching cached models." });
-                        }
-                        else if (isRecord(refreshed) && refreshed.errors instanceof Map && refreshed.errors.size > 0) {
-                            publish({ kind: "warning", message: `Could not refresh ${[...refreshed.errors.keys()].join(", ")}; searching cached models.` });
-                        }
-                    }
-                    catch (error) {
-                        publish({
-                            kind: "warning",
-                            message: timedOut
-                                ? "Model refresh timed out; searching cached models."
-                                : `Could not refresh model catalogs: ${error instanceof Error ? error.message : String(error)}`,
-                        });
-                    }
-                    finally {
-                        clearTimeout(timeout);
-                    }
-                    availableModels = [...(runtime.services.modelRuntime.getAvailableSnapshot?.() ?? [])];
-                    model = findExactWorkflowModel(reference, availableModels);
-                }
-                if (!current())
-                    return workflowResult(request.command, "cancelled", "Model selection cancelled", undefined, "silent");
-                if (model === undefined) {
-                    return {
-                        ...workflowResult(request.command, "requires-selection", "Select a model", reference, "silent"),
-                        ...(messages.length === 0 ? {} : { messages: Object.freeze(messages) }),
-                    };
-                }
-                try {
-                    await session.setModel(model, { persist: request.persist === true });
-                }
-                catch (error) {
-                    if (!current())
-                        return workflowResult(request.command, "cancelled", "Model selection cancelled", undefined, "silent");
-                    const failure = { kind: "error", message: error instanceof Error ? error.message : String(error) };
-                    return workflowResult(request.command, "failed", failure.message, undefined, "error", messages.length === 0 ? undefined : [...messages, failure]);
-                }
-                if (!current())
-                    return workflowResult(request.command, "cancelled", "Model selection cancelled", undefined, "silent");
-                const providerId = stringProperty(model, "provider") ?? "unknown";
-                const modelId = stringProperty(model, "id") ?? reference;
-                this.#ports.setActiveModel({ providerId, modelId, displayName: stringProperty(model, "name") ?? modelId });
-                this.#ports.emitView();
-                const resultMessage = { kind: "status", message: request.persist === true ? `Default model: ${providerId}/${modelId}` : `Model: ${modelId}` };
-                return messages.length === 0
-                    ? workflowResult(request.command, "completed", resultMessage.message)
-                    : workflowResult(request.command, "completed", resultMessage.message, undefined, "status", [...messages, resultMessage]);
+                // Compatibility: pinned Pi searches the session scope when one exists and refreshes catalogs only for an unscoped miss.
+                return this.#selectModel(request, reference, {
+                    pool: scopedModels.length > 0 ? scopedModels : [...(runtime.services.modelRuntime.getAvailableSnapshot?.() ?? [])],
+                    refreshOnMiss: scopedModels.length === 0,
+                    persist: request.persist === true,
+                    onMiss: "requires-selection",
+                });
+            }
+            case "models": {
+                // Invariant: the bare dialog seeds its query from the argument; only an explicit selection switches models.
+                if (!selection)
+                    return workflowResult(request.command, "requires-selection", "Select a model", argument || undefined, "silent");
+                return this.#selectModel(request, selection, {
+                    pool: [...(runtime.services.modelRuntime.getAvailableSnapshot?.() ?? [])],
+                    refreshOnMiss: true,
+                    persist: true,
+                    onMiss: "failed",
+                });
             }
             case "scoped-models": {
                 if (!selection)

package/dist/integrations/pi/engine/workflows.d.ts

@@ -3,7 +3,16 @@ export declare const PINNED_PI_WORKFLOW_COMMAND_NAMES: readonly ["settings", "mo
 export declare const PINNED_PI_HIDDEN_COMMAND_NAMES: readonly ["debug", "arminsayshi", "dementedelves"];
 export type PiWorkflowCommandName = typeof PINNED_PI_WORKFLOW_COMMAND_NAMES[number];
 export type PiHiddenWorkflowCommandName = typeof PINNED_PI_HIDDEN_COMMAND_NAMES[number];
-export type PiWorkflowRoute = PiWorkflowCommandName | PiHiddenWorkflowCommandName;
+/** The one bare-A1 model command; it replaces the pinned `model` and `scoped-models` routes there. */
+export declare const OWNED_MODELS_COMMAND_NAME: "models";
+export type OwnedModelsCommandName = typeof OWNED_MODELS_COMMAND_NAME;
+export type OwnedWorkflowCommandName = Exclude<PiWorkflowCommandName, "model" | "scoped-models"> | OwnedModelsCommandName;
+/** Bare A1's advertised command catalog: the pinned catalog with `models` in place of `model` and `scoped-models`. */
+export declare const OWNED_WORKFLOW_COMMAND_NAMES: readonly OwnedWorkflowCommandName[];
+export type PiProductMode = "bare" | "comparison";
+/** The advertised command catalog for a product mode; hidden routes are shared by both. */
+export declare function workflowCommandNames(productMode: PiProductMode): readonly (PiWorkflowCommandName | OwnedModelsCommandName)[];
+export type PiWorkflowRoute = PiWorkflowCommandName | PiHiddenWorkflowCommandName | OwnedModelsCommandName;
 export declare const PINNED_PI_SETTINGS_CALLBACKS: readonly ["onAutoCompactChange", "onShowImagesChange", "onImageWidthCellsChange", "onAutoResizeImagesChange", "onBlockImagesChange", "onEnableSkillCommandsChange", "onSteeringModeChange", "onFollowUpModeChange", "onTransportChange", "onHttpIdleTimeoutMsChange", "onModelThinkingLevelChange", "onModelThinkingLevelRemove", "onThemeChange", "onThemePreview", "onHideThinkingBlockChange", "onMermaidRenderingModeChange", "onShowCacheMissNoticesChange", "onCollapseChangelogChange", "onEnableInstallTelemetryChange", "onQuietStartupChange", "onDefaultProjectTrustChange", "onDoubleEscapeActionChange", "onTreeFilterModeChange", "onShowHardwareCursorChange", "onEditorPaddingXChange", "onOutputPadChange", "onAutocompleteMaxVisibleChange", "onClearOnShrinkChange", "onShowTerminalProgressChange", "onTuiModeChange", "onFullscreenExitOutputChange", "onFullscreenScrollbarChange", "onFullscreenCopyOnSelectChange", "onWarningsChange", "onCancel"];
 export type PiPinnedSettingsCallback = typeof PINNED_PI_SETTINGS_CALLBACKS[number];
 export interface PiPinnedSettingsSnapshot {
@@ -71,7 +80,7 @@ export interface PiWorkflowRequest {
     readonly command: PiWorkflowRoute;
     readonly argument: string;
     readonly selection?: string;
-    /** For the model route: also persist the selection as the default model. */
+    /** For the model route: also persist the selection as the default model. The bare `models` route always persists. */
     readonly persist?: boolean;
     readonly confirmed?: boolean;
     /** Recovery cwd selected after an import/resume source cwd is unavailable. */
@@ -249,3 +258,18 @@ export interface PiScopedModelsRefreshResult extends PiScopedModelsContext {
     readonly status: string;
     readonly statusKind: "success" | "warning";
 }
+/** What the bare-A1 Models dialog reads: the authenticated catalog and the explicit session and persisted scopes, kept apart. */
+export interface PiModelsContext {
+    readonly models: readonly PiScopedModelDescriptor[];
+    /** `provider/id` of the active model, or null before one is set. */
+    readonly activeModelId: string | null;
+    /** Ordered `provider/id` references the session cycles; empty is the all-model fallback, not an explicit full scope. */
+    readonly sessionScopeIds: readonly string[];
+    /** The persisted `enabledModels` patterns resolved against the catalog, in order; unmatched patterns stay verbatim. */
+    readonly persistedScopeIds: readonly string[];
+}
+export interface PiModelsRefreshResult {
+    readonly models: readonly PiScopedModelDescriptor[];
+    readonly status: string;
+    readonly statusKind: "success" | "warning";
+}

package/dist/integrations/pi/engine/workflows.js

@@ -24,6 +24,14 @@ export const PINNED_PI_WORKFLOW_COMMAND_NAMES = [
     "quit",
 ];
 export const PINNED_PI_HIDDEN_COMMAND_NAMES = ["debug", "arminsayshi", "dementedelves"];
+/** The one bare-A1 model command; it replaces the pinned `model` and `scoped-models` routes there. */
+export const OWNED_MODELS_COMMAND_NAME = "models";
+/** Bare A1's advertised command catalog: the pinned catalog with `models` in place of `model` and `scoped-models`. */
+export const OWNED_WORKFLOW_COMMAND_NAMES = Object.freeze(PINNED_PI_WORKFLOW_COMMAND_NAMES.flatMap((name) => name === "model" ? [OWNED_MODELS_COMMAND_NAME] : name === "scoped-models" ? [] : [name]));
+/** The advertised command catalog for a product mode; hidden routes are shared by both. */
+export function workflowCommandNames(productMode) {
+    return productMode === "bare" ? OWNED_WORKFLOW_COMMAND_NAMES : PINNED_PI_WORKFLOW_COMMAND_NAMES;
+}
 export const PINNED_PI_SETTINGS_CALLBACKS = [
     "onAutoCompactChange",
     "onShowImagesChange",

package/dist/native/darwin-arm64/manifest.json

@@ -5,7 +5,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-09-19T13:30:30.983Z",
+  "builtAt": "2026-09-19T16:47:03.520Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "9db1726bbe3fc2e8292f2ead1e7e9d0fd4d7d0dc9217b372582bf354b0f565dc",

package/dist/native/linux-x64/manifest.json

@@ -5,7 +5,7 @@
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-09-19T13:30:39.829Z",
+  "builtAt": "2026-09-19T16:46:51.393Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "d8cda6b0c7cb36c0cc41e90802aceebf6c02eaebbc08a83d7d963d2e918dbd7a",

package/dist/native/win32-x64/manifest.json

@@ -5,10 +5,10 @@
   "platform": "win32",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-09-19T13:31:06.678Z",
+  "builtAt": "2026-09-19T16:47:27.951Z",
   "artifact": {
     "filename": "process-guardian.exe",
-    "sha256": "39cc0b1caeb6d009b118f40db5a66aa58d84e7f6b33443e97670bd3708a83a0e",
+    "sha256": "760dc53aa17d5e0df1c0fa5cbd3be56f73b6cf662b0cef5994edffff68ca9d8f",
     "size": 177664
   },
   "provenance": {

package/dist/ui/apps/contracts.d.ts

@@ -56,9 +56,17 @@ export interface UiRouteSurface {
     /** The surface asks to leave A1 entirely, not merely to close itself. */
     onExitRequested(listener: () => void): void;
 }
+/**
+ * What a shell may hand a route when it opens it. A route that does not use the
+ * input opens exactly as it does without one.
+ */
+export interface UiRouteInput {
+    /** A caller-supplied document for a route that presents documents. */
+    readonly document?: string;
+}
 /** Route lookup seam shared by owned apps and any presentation runtime hosting them. */
 export interface UiRouteHost {
     claims(route: string): boolean;
-    open(route: string): UiRouteSurface | null;
+    open(route: string, input?: UiRouteInput): UiRouteSurface | null;
 }
 export declare function assertAppRegistration(registration: AppRegistration): void;

package/dist/ui/apps/index.d.ts

@@ -1,5 +1,5 @@
 export { assertAppRegistration } from "./contracts.js";
-export type { AppHostServices, AppRegistration, AppSize, UiApp, UiRouteHost, UiRouteSurface } from "./contracts.js";
+export type { AppHostServices, AppRegistration, AppSize, UiApp, UiRouteHost, UiRouteInput, UiRouteSurface } from "./contracts.js";
 export { UiAppHost } from "./host.js";
 export type { AppHostOptions, AppHostSurface } from "./host.js";
 export { UiAppRegistry } from "./registry.js";

package/dist/ui/settings/declarations.d.ts

@@ -1,4 +1,4 @@
-export declare const OWNED_UI_SETTINGS_VERSION = 6;
+export declare const OWNED_UI_SETTINGS_VERSION = 8;
 export type OwnedUiSettingValue = string | number | boolean;
 export type OwnedUiSettingApplication = "live" | "restart";
 export interface OwnedUiSettingDeclaration {
@@ -15,8 +15,6 @@ export interface OwnedUiSettingDeclaration {
     readonly defaultValue: OwnedUiSettingValue;
     readonly allowedValues: readonly OwnedUiSettingValue[];
 }
-/** Playback lengths the quit outro offers, in milliseconds. */
-export declare const QUIT_EFFECT_DURATIONS_MS: readonly number[];
 /**
  * Every A1 setting, keyed by its id. The table is the one declaration: ids, defaults, and allowed
  * values are read from it, and `OwnedSettingValueOf` derives each getter's type from it.
@@ -24,12 +22,12 @@ export declare const QUIT_EFFECT_DURATIONS_MS: readonly number[];
 export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
     readonly quitAnimation: Readonly<{
         id: "quitAnimation";
-        label: "Exit animation";
+        label: "Quit animation";
         section: Readonly<{
             id: "generic";
             title: "Generic";
         }>;
-        description: "Play the quit effect when the session quits. Off returns to the terminal immediately.";
+        description: "Play the fall effect over the last screen when the session quits. Off returns to the terminal immediately.";
         application: "live";
         defaultValue: true;
         allowedValues: readonly [true, false];
@@ -94,30 +92,6 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
         defaultValue: 100;
         allowedValues: readonly [10, 20, 30, 40, 50, 60, 70, 80, 90, 100];
     }>;
-    readonly quitEffect: Readonly<{
-        id: "quitEffect";
-        label: "Effect";
-        section: Readonly<{
-            id: "quit";
-            title: "Quit";
-        }>;
-        description: "Animation played over the last screen when the session quits.";
-        application: "live";
-        defaultValue: "fall";
-        allowedValues: readonly ["fall", "dissolve", "starburst", "waves"];
-    }>;
-    readonly quitEffectDurationMs: Readonly<{
-        id: "quitEffectDurationMs";
-        label: "Duration";
-        section: Readonly<{
-            id: "quit";
-            title: "Quit";
-        }>;
-        description: "Milliseconds the quit animation plays before the terminal is restored.";
-        application: "live";
-        defaultValue: 800;
-        allowedValues: readonly number[];
-    }>;
     readonly promptSuggestions: Readonly<{
         id: "promptSuggestions";
         label: "Prompt suggestions";
@@ -130,6 +104,18 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
         defaultValue: true;
         allowedValues: readonly [true, false];
     }>;
+    readonly skillsPresentation: Readonly<{
+        id: "skillsPresentation";
+        label: "Skills";
+        section: Readonly<{
+            id: "agent";
+            title: "Agent";
+        }>;
+        description: "Collapse offers one /skills command with a searchable dialog and the /skills: shortcut; expand lists every /skill:<name> command directly.";
+        application: "live";
+        defaultValue: "collapse";
+        allowedValues: readonly ["collapse", "expand"];
+    }>;
 }>;
 export type OwnedSettingId = keyof typeof OWNED_SETTING_DECLARATIONS;
 /** The value type a setting's declaration allows: a literal union for a choice, `number` for a stepped range. */

package/dist/ui/settings/declarations.js

@@ -1,12 +1,10 @@
-export const OWNED_UI_SETTINGS_VERSION = 6;
+export const OWNED_UI_SETTINGS_VERSION = 8;
 const MAX_ID_LENGTH = 64;
 const ID_PATTERN = /^[a-z][a-z0-9]*(?:[A-Z][a-z0-9]*)*$/;
 /** Declared first so the settings screen opens on it; sections follow first-declaration order. */
 const GENERIC_SECTION = Object.freeze({ id: "generic", title: "Generic" });
 const SCROLL_SECTION = Object.freeze({ id: "scroll", title: "Scroll" });
-const QUIT_SECTION = Object.freeze({ id: "quit", title: "Quit" });
-/** Playback lengths the quit outro offers, in milliseconds. */
-export const QUIT_EFFECT_DURATIONS_MS = Object.freeze(Array.from({ length: 18 }, (_, index) => 300 + index * 100));
+const AGENT_SECTION = Object.freeze({ id: "agent", title: "Agent" });
 /**
  * Every A1 setting, keyed by its id. The table is the one declaration: ids, defaults, and allowed
  * values are read from it, and `OwnedSettingValueOf` derives each getter's type from it.
@@ -14,9 +12,9 @@ export const QUIT_EFFECT_DURATIONS_MS = Object.freeze(Array.from({ length: 18 },
 export const OWNED_SETTING_DECLARATIONS = Object.freeze({
     quitAnimation: Object.freeze({
         id: "quitAnimation",
-        label: "Exit animation",
+        label: "Quit animation",
         section: GENERIC_SECTION,
-        description: "Play the quit effect when the session quits. Off returns to the terminal immediately.",
+        description: "Play the fall effect over the last screen when the session quits. Off returns to the terminal immediately.",
         application: "live",
         defaultValue: true,
         allowedValues: Object.freeze([true, false]),
@@ -66,33 +64,24 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         defaultValue: 100,
         allowedValues: Object.freeze([10, 20, 30, 40, 50, 60, 70, 80, 90, 100]),
     }),
-    quitEffect: Object.freeze({
-        id: "quitEffect",
-        label: "Effect",
-        section: QUIT_SECTION,
-        description: "Animation played over the last screen when the session quits.",
-        application: "live",
-        defaultValue: "fall",
-        allowedValues: Object.freeze(["fall", "dissolve", "starburst", "waves"]),
-    }),
-    quitEffectDurationMs: Object.freeze({
-        id: "quitEffectDurationMs",
-        label: "Duration",
-        section: QUIT_SECTION,
-        description: "Milliseconds the quit animation plays before the terminal is restored.",
-        application: "live",
-        defaultValue: 800,
-        allowedValues: QUIT_EFFECT_DURATIONS_MS,
-    }),
     promptSuggestions: Object.freeze({
         id: "promptSuggestions",
         label: "Prompt suggestions",
-        section: Object.freeze({ id: "agent", title: "Agent" }),
+        section: AGENT_SECTION,
         description: "Predict likely next prompts with one additional background request using the selected model.",
         application: "live",
         defaultValue: true,
         allowedValues: Object.freeze([true, false]),
     }),
+    skillsPresentation: Object.freeze({
+        id: "skillsPresentation",
+        label: "Skills",
+        section: AGENT_SECTION,
+        description: "Collapse offers one /skills command with a searchable dialog and the /skills: shortcut; expand lists every /skill:<name> command directly.",
+        application: "live",
+        defaultValue: "collapse",
+        allowedValues: Object.freeze(["collapse", "expand"]),
+    }),
 });
 /** The declarations in declaration order, for resolution, persistence, and the settings screen. */
 export const OWNED_UI_SETTING_DECLARATIONS = Object.freeze(Object.values(OWNED_SETTING_DECLARATIONS));

package/dist/ui/settings/index.d.ts

@@ -1,4 +1,4 @@
-export { OWNED_SETTING_DECLARATIONS, OWNED_UI_SETTINGS_VERSION, OWNED_UI_SETTING_DECLARATIONS, QUIT_EFFECT_DURATIONS_MS, assertOwnedUiSettingDeclarations, findOwnedUiSettingDeclaration, isOwnedSettingId, } from "./declarations.js";
+export { OWNED_SETTING_DECLARATIONS, OWNED_UI_SETTINGS_VERSION, OWNED_UI_SETTING_DECLARATIONS, assertOwnedUiSettingDeclarations, findOwnedUiSettingDeclaration, isOwnedSettingId, } from "./declarations.js";
 export type { OwnedSettingId, OwnedSettingValueOf, OwnedUiSettingApplication, OwnedUiSettingDeclaration, OwnedUiSettingValue } from "./declarations.js";
 export { OWNED_UI_SETTINGS_MIGRATIONS, assertOwnedUiSettingsMigrations, migrationsFrom } from "./migrations.js";
 export type { OwnedUiSettingsMigration } from "./migrations.js";

package/dist/ui/settings/index.js

@@ -1,4 +1,4 @@
-export { OWNED_SETTING_DECLARATIONS, OWNED_UI_SETTINGS_VERSION, OWNED_UI_SETTING_DECLARATIONS, QUIT_EFFECT_DURATIONS_MS, assertOwnedUiSettingDeclarations, findOwnedUiSettingDeclaration, isOwnedSettingId, } from "./declarations.js";
+export { OWNED_SETTING_DECLARATIONS, OWNED_UI_SETTINGS_VERSION, OWNED_UI_SETTING_DECLARATIONS, assertOwnedUiSettingDeclarations, findOwnedUiSettingDeclaration, isOwnedSettingId, } from "./declarations.js";
 export { OWNED_UI_SETTINGS_MIGRATIONS, assertOwnedUiSettingsMigrations, migrationsFrom } from "./migrations.js";
 export { documentFrom, parseOwnedUiSettingsDocument, resolveOwnedUiSettings, settingValue } from "./resolution.js";
 export { AGENT_SECTION_ID, buildOwnedUiSettingsSections, findOwnedUiSettingsEntry } from "./sections.js";

package/dist/ui/settings/migrations.js

@@ -49,6 +49,24 @@ export const OWNED_UI_SETTINGS_MIGRATIONS = Object.freeze([
             return migrated;
         },
     }),
+    Object.freeze({
+        to: 7,
+        description: "Drop the quit effect and duration; the outro always plays fall for 800 ms.",
+        migrate(values) {
+            // Invariant: the manager keeps unknown keys, so the retired ids are removed here rather than lingering.
+            const migrated = { ...values };
+            delete migrated.quitEffect;
+            delete migrated.quitEffectDurationMs;
+            return migrated;
+        },
+    }),
+    Object.freeze({
+        to: 8,
+        description: "Introduce the collapsed skills presentation with the collapse default.",
+        migrate(values) {
+            return { ...values };
+        },
+    }),
 ]);
 export function assertOwnedUiSettingsMigrations(migrations, currentVersion = OWNED_UI_SETTINGS_VERSION) {
     const firstProduced = currentVersion - migrations.length + 1;

package/docs/architecture/prompt-suggestions.md

@@ -6,7 +6,7 @@ Bare A1 predicts a short next user input with one isolated request using the sel
 
 The adapter resolves the lowest supported effort from the selected session model's available thinking levels, without changing the main thinking setting. Non-reasoning models omit reasoning controls; supported `off` also omits the optional reasoning argument, matching the model runtime's ordinary completion contract. Other supported efforts are supplied explicitly. Missing capabilities produce `unavailable`, not a guessed provider option. Provider mapping/clamping remains owned by the pinned model runtime; the diagnostic policy describes the applied request option, not inferred server-side computation.
 
-The controller retains the 15-second deadline, does not retry or switch models, and retires a timeout before aborting. A provider that ignores abort cannot revive retired text. A timely candidate remains private until matching settlement. Ghost text is not editor content, approval, or a submission: Tab accepts it into the editor, and Enter must be pressed separately to submit it. Typing, session/model replacement, continuation, or disabling suggestions invalidates unaccepted work. `a1 pi` does not install this feature.
+The controller retains the 15-second deadline, does not retry or switch models, and retires a timeout before aborting. A provider that ignores abort cannot revive retired text. A timely candidate remains private until matching settlement. Ghost text is not editor content, approval, or a submission: Tab accepts it into the editor, and Enter must be pressed separately to submit it. Typing aborts pending generation but keeps a delivered suggestion: the ghost text is hidden while the editor holds a draft and reappears when the draft is cleared. Submission, session/model replacement, continuation, interruption, or disabling suggestions invalidates unaccepted work. `a1 pi` does not install this feature.
 
 ## Opt-in local diagnostics
 

package/docs/architecture/ui-reference-provenance.md

@@ -30,6 +30,7 @@ its own `core` facade layer; A1 is a product, so the port adapts imports and kee
 | `ui-components/mouse.ts` | `core/panes/sgr-mouse.ts` | Same SGR decoding and per-call regex reset; A1 emits its own event shape. |
 | `ui-components/mouse.ts` — tracking sequences | `core/host/pi/providers/host-bridge-surface.ts` | Mouse modes only. A1 does not take the alternate screen, because the Pi TUI owns the screen A1 renders through. |
 | `features/owned-ui/settings-app.ts` — section layout, pointer controls, and scrolling | `settings/impl.ts` — `settingsValueColumn`, block navigation, sticky sections, and pointer hit regions | Setting discovery is A1's own A1/Agent section model. Section navigation and pointer-only numeric controls follow the A1 reference; explicit `/` search, ruled shared input, shortcut-derived hints, hidden description rows, configured wheel cadence, a rail presented through the shared scrollbar settings, `Ctrl+Home`/`Ctrl+End` boundary jumps, and distinct floating scalar menus are reviewed owned interactions. |
+| `pi-components/models-dialog.ts` — the bare-A1 `/models` dialog | `models/index.ts` and `core/editor/components.ts` — `EditorModal` | Keeps the `all`/`scoped` filters, substring search over id/name/provider, provider-then-id ordering, Enter to switch, Space to scope, Ctrl+S to save, the `(unsaved)` marker, and the `●`/`○` scope markers. A1 renders the marker before the id and the active `✓` after `[provider]`, lists the scoped filter in cycling order (saved-but-removed members last), keeps the pinned bulk/provider/reorder bindings, and hands every switch, scope write, save, and catalog refresh to the engine adapter instead of reading settings files itself. |
 
 ## Ported from the pinned engine
 

package/docs/features/modal-content-interaction.md

@@ -14,6 +14,7 @@ The existing [modal transition inventory](../../config/baselines/modal-surface-i
 | --- | --- | --- |
 | `editor.root` | Ordinary editor and viewport | Existing viewport/controller and shell regression cases |
 | `settings.*`, `models.*`, `trust.project` | Shell replacement input, including nested component states | Real settings/thinking, Model Configuration and model selection; generic replacement geometry and gesture tests |
+| A1-owned Skills dialog (`/skills`, not a pinned node) | Shell replacement input, presented like `models.select` | `test/app/session-shell/session-shell-skills.test.ts` apply/cancel/resize cases; shared replacement tests |
 | `session.*`, `tree.*` | Shell replacement input and nested replacement/confirmation controllers | Real fork plus existing resume/tree/missing-directory lifecycle cases; shared replacement tests |
 | `auth.*` | Shell replacement input, including provider and nested prompts | Real login/logout plus existing OAuth/API-key/nested restoration cases; shared replacement tests |
 | `command.import-confirm`, `operation.*` | Shell replacement confirmation/loader | Existing confirmation/loader lifecycle cases; shared replacement tests |
@@ -30,8 +31,8 @@ Focused files:
 
 ## Manual review
 
-Build the exact candidate, then launch it through `./scripts/dev` from its worktree in Windows Terminal/Git Bash. Use `/hotkeys` to populate a long transcript, then open `/scoped-models`. Compare scrolling and drag/word/line selection with the dialog closed and open. Try the rail, copy, and jump-to-bottom; the model dialog must not navigate or close as a side effect of transcript gestures. Copy must not show Pi's `Copied` notification.
+Build the exact candidate, then launch it through `./scripts/dev` from its worktree in Windows Terminal/Git Bash. Populate a long transcript (for example with a few prompts, or `/hotkeys` under `a1 pi`; in bare A1 `/hotkeys` opens a full-screen reference screen and appends nothing), then open `/scoped-models`. Compare scrolling and drag/word/line selection with the dialog closed and open. Try the rail, copy, and jump-to-bottom; the model dialog must not navigate or close as a side effect of transcript gestures. Copy must not show Pi's `Copied` notification.
 
-Repeat with `/model`, settings and a nested settings dialog, and extension-provided docked and floating surfaces. Check that typing, modal buttons and wheel handling, save, and cancel still work. Resize during a drag, close/reopen the modal, and repeat while output streams. A full-cover screen must not allow click-through into hidden transcript cells. `auto` scrollbar visibility remains activity-dependent; `hidden` remains hidden.
+Repeat with `/models`, settings and a nested settings dialog, and extension-provided docked and floating surfaces. Check that typing, modal buttons and wheel handling, save, and cancel still work. Resize during a drag, close/reopen the modal, and repeat while output streams. A full-cover screen must not allow click-through into hidden transcript cells. `auto` scrollbar visibility remains activity-dependent; `hidden` remains hidden.
 
 User confirmation of the exact built candidate is still required before merging the code PR. The baseline's pre-existing selection boundaries and speed are intentionally preserved, as clarified by the user; this change does not attempt to reconcile older specification wording by changing those behaviors.