@timurproko/a1 0.1.0 → 0.1.1-dev.10

package/dist/src/foundation/pi-engine-adapter/workflows.js

@@ -58,4 +58,3 @@ export const PINNED_PI_SETTINGS_CALLBACKS = [
     "onWarningsChange",
     "onCancel",
 ];
-//# sourceMappingURL=workflows.js.map

package/dist/src/foundation/pi-owned-ui-integration/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./session-shell.js";
+export * from "./route-host.js";

package/dist/src/foundation/pi-owned-ui-integration/index.js

@@ -0,0 +1,2 @@
+export * from "./session-shell.js";
+export * from "./route-host.js";

package/dist/src/foundation/pi-owned-ui-integration/route-host.d.ts

@@ -0,0 +1,29 @@
+import type { PaneMouseEvent } from "../ui-components/index.js";
+/**
+ * The seam between the pinned shell and A1-owned screens. The shell asks whether
+ * a route is claimed, mounts whatever surface it is handed, and forwards keys to
+ * it — it never learns what an app is, and the app layer never reaches into the
+ * shell.
+ */
+export interface UiRouteSurface {
+    readonly id: string;
+    /** Renders exactly `height` rows of at most `width` columns. */
+    render(width: number, height: number): readonly string[];
+    /** True when the key was consumed; false leaves it to the shell. */
+    handleInput(data: string): boolean;
+    /** Mouse report in surface-local coordinates. True when consumed. */
+    handleMouse(event: PaneMouseEvent): boolean;
+    /** True once the surface has asked to be dismissed. */
+    isClosed(): boolean;
+    close(): void;
+    /** Called by the shell when the surface should repaint. */
+    onRenderRequested(listener: () => void): void;
+    /** The surface asks to leave A1 entirely, not merely to close itself. */
+    onExitRequested(listener: () => void): void;
+}
+export interface UiRouteHost {
+    /** True when a declared A1-owned surface claims this route. */
+    claims(route: string): boolean;
+    /** Opens the route's surface, or null when it could not be presented. */
+    open(route: string): UiRouteSurface | null;
+}

package/dist/src/foundation/pi-owned-ui-integration/route-host.js

@@ -0,0 +1 @@
+export {};

package/dist/src/{features/owned-ui/pi-session-shell.d.ts → foundation/pi-owned-ui-integration/session-shell.d.ts}

@@ -1,14 +1,23 @@
-import type { OwnedUiSessionViewModel, OwnedUiThinkingLevel } from "../../foundation/owned-ui-contracts/index.js";
-import { type AdapterCommandResult, type PiEngineAdapter, type PiWorkflowRequest, type PiWorkflowResult } from "../../foundation/pi-engine-adapter/index.js";
-import { type PiShellComponentPort, type PiShellEditorPort, type PiShellExtensionRendererResolver, type PiShellHeaderOptions, type PiShellHeaderPort, type PiShellLoadedResourcesPort, type PiShellSelectorOption, type PiShellTranscriptComponentPort } from "../../foundation/pi-component-adapter/index.js";
-import { PiTuiRuntimeAdapter, type PiTuiComponentPort, type PiTuiLayoutNode, type PiTuiOverlayHandle, type PiTuiTerminalPort } from "../../foundation/pi-tui-runtime-adapter/index.js";
-export interface PiSessionShellOptions {
-    readonly adapter: PiEngineAdapter;
+import type { OwnedUiSessionViewModel, OwnedUiThinkingLevel } from "../owned-ui-contracts/index.js";
+import type { UiRouteHost } from "./route-host.js";
+import { type AdapterCommandResult, type PiEngineAdapter, type PiWorkflowRequest, type PiWorkflowResult } from "../pi-engine-adapter/index.js";
+import { type PiShellComponentPort, type PiShellEditorPort, type PiShellExtensionRendererResolver, type PiShellHeaderOptions, type PiShellHeaderPort, type PiShellLoadedResourcesPort, type PiShellSelectorOption, type PiShellTranscriptComponentPort } from "../pi-component-adapter/index.js";
+import { PiTuiRuntimeAdapter, type PiTuiComponentPort, type PiTuiLayoutNode, type PiTuiOverlayHandle, type PiTuiTerminalPort } from "../pi-tui-runtime-adapter/index.js";
+type OwnedUiBackendPort = PiEngineAdapter;
+type OwnedUiTerminalPort = PiTuiTerminalPort;
+type OwnedUiStartupOptions = PiShellHeaderOptions;
+export interface OwnedUiSessionShellOptions {
+    readonly backend: OwnedUiBackendPort;
     readonly cwd: string;
-    readonly terminal?: PiTuiTerminalPort;
-    readonly startup?: PiShellHeaderOptions;
+    readonly terminal?: OwnedUiTerminalPort;
+    readonly startup?: OwnedUiStartupOptions;
+    /**
+     * Declared A1-owned routes. A route this host claims resolves to its app;
+     * every other route continues to the pinned workflow table unchanged.
+     */
+    readonly routeHost?: UiRouteHost;
 }
-export declare class PiSessionShellRoot implements PiTuiComponentPort {
+export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     #private;
     readonly editor: PiShellEditorPort;
     readonly header: PiShellHeaderPort;
@@ -54,12 +63,12 @@ export declare class PiSessionShellRoot implements PiTuiComponentPort {
     setFocused(focused: boolean): void;
     dispose(): void;
 }
-export declare class PiSessionShell {
+export declare class OwnedUiSessionShell {
     #private;
-    readonly adapter: PiEngineAdapter;
-    readonly root: PiSessionShellRoot;
+    readonly backend: OwnedUiBackendPort;
+    readonly root: OwnedUiSessionShellRoot;
     readonly runtime: PiTuiRuntimeAdapter;
-    constructor(options: PiSessionShellOptions);
+    constructor(options: OwnedUiSessionShellOptions);
     view(): OwnedUiSessionViewModel;
     start(): void;
     onView(listener: (view: OwnedUiSessionViewModel) => void): () => void;
@@ -94,4 +103,4 @@ export declare class PiSessionShell {
     showScopedModelsSelector(): void;
     dispose(): Promise<void>;
 }
-//# sourceMappingURL=pi-session-shell.d.ts.map
+export {};

package/dist/src/{features/owned-ui/pi-session-shell.js → foundation/pi-owned-ui-integration/session-shell.js}

@@ -1,7 +1,8 @@
-import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES, } from "../../foundation/pi-engine-adapter/index.js";
-import { createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellStatus, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, piTheme, renderPiShellStatusText, renderPiShellTranscriptBlock, } from "../../foundation/pi-component-adapter/index.js";
-import { PiTuiRuntimeAdapter, } from "../../foundation/pi-tui-runtime-adapter/index.js";
-export class PiSessionShellRoot {
+import { MOUSE_TRACKING_OFF, MOUSE_TRACKING_ON, parseMouseInput } from "../ui-components/index.js";
+import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES, } from "../pi-engine-adapter/index.js";
+import { createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellStatus, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, piTheme, renderPiShellStatusText, renderPiShellTranscriptBlock, } from "../pi-component-adapter/index.js";
+import { PiTuiRuntimeAdapter, } from "../pi-tui-runtime-adapter/index.js";
+export class OwnedUiSessionShellRoot {
     editor;
     header;
     resources;
@@ -495,8 +496,8 @@ function layoutPort(render, invalidate, handleInput) {
         ...(handleInput === undefined ? {} : { handleInput }),
     };
 }
-function shellResourceEntries(adapter) {
-    const resources = adapter.nonVisualResources().map(resource => ({
+function shellResourceEntries(backend) {
+    const resources = backend.nonVisualResources().map(resource => ({
         section: resource.kind === "skill"
             ? "Skills"
             : resource.kind === "prompt-template"
@@ -512,7 +513,7 @@ function shellResourceEntries(adapter) {
         sourcePath: resource.sourcePath,
         diagnostic: resource.diagnostic,
     }));
-    for (const extension of adapter.extensionResources()) {
+    for (const extension of backend.extensionResources()) {
         if (extension.hidden)
             continue;
         resources.push({
@@ -531,8 +532,8 @@ function compactResourceLabel(path) {
         return segments.at(-2) ?? leaf;
     return leaf;
 }
-export class PiSessionShell {
-    adapter;
+export class OwnedUiSessionShell {
+    backend;
     root;
     runtime;
     #cwd;
@@ -542,6 +543,7 @@ export class PiSessionShell {
     #stopped;
     #resolveStopped;
     #dialogId;
+    #routeHost;
     #dialogHandle;
     #sequence = 0;
     #started = false;
@@ -551,14 +553,15 @@ export class PiSessionShell {
     #activeLoginDialog;
     #sessionGeneration;
     constructor(options) {
-        this.adapter = options.adapter;
-        this.#sessionGeneration = this.adapter.sessionGeneration;
+        this.backend = options.backend;
+        this.#sessionGeneration = this.backend.sessionGeneration;
         this.#cwd = options.cwd;
+        this.#routeHost = options.routeHost ?? null;
         this.#stopped = new Promise(resolve => {
             this.#resolveStopped = resolve;
         });
         let runtime;
-        this.root = new PiSessionShellRoot(this.adapter.view(), options.cwd, {
+        this.root = new OwnedUiSessionShellRoot(this.backend.view(), options.cwd, {
             getColumns: () => runtime?.viewport().columns ?? options.terminal?.columns ?? 80,
             getRows: () => runtime?.viewport().rows ?? options.terminal?.rows ?? 24,
             requestRender: () => runtime?.requestRender(),
@@ -578,15 +581,15 @@ export class PiSessionShell {
             onDequeue: () => this.restoreQueuedInput(),
         }, {
             ...options.startup,
-            resources: options.startup?.resources ?? shellResourceEntries(this.adapter),
-        }, this.adapter.agentDir, {
-            getMessageRenderer: customType => this.adapter.pinnedMessageRenderer(customType),
-            getToolDefinition: toolName => this.adapter.pinnedToolDefinition(toolName),
+            resources: options.startup?.resources ?? shellResourceEntries(this.backend),
+        }, this.backend.agentDir, {
+            getMessageRenderer: customType => this.backend.pinnedMessageRenderer(customType),
+            getToolDefinition: toolName => this.backend.pinnedToolDefinition(toolName),
         });
-        const tuiMode = this.adapter.disposed ? "regular" : this.adapter.pinnedSettingsSnapshot().tuiMode;
+        const tuiMode = this.backend.disposed ? "regular" : this.backend.pinnedSettingsSnapshot().tuiMode;
         const runtimeOptions = options.terminal === undefined
-            ? { root: this.root, mode: tuiMode, layoutRoot: this.root.layoutRoot(), hardwareCursor: this.adapter.view().terminal.hardwareCursor }
-            : { root: this.root, mode: tuiMode, layoutRoot: this.root.layoutRoot(), terminal: options.terminal, hardwareCursor: this.adapter.view().terminal.hardwareCursor };
+            ? { root: this.root, mode: tuiMode, layoutRoot: this.root.layoutRoot(), hardwareCursor: this.backend.view().terminal.hardwareCursor }
+            : { root: this.root, mode: tuiMode, layoutRoot: this.root.layoutRoot(), terminal: options.terminal, hardwareCursor: this.backend.view().terminal.hardwareCursor };
         runtime = new PiTuiRuntimeAdapter(runtimeOptions);
         this.runtime = runtime;
         this.#extensionBridge = createPiExtensionUiBridge({
@@ -595,7 +598,7 @@ export class PiSessionShell {
                 getRows: () => this.runtime.viewport().rows,
                 requestRender: () => this.runtime.requestRender(),
             },
-            agentDir: this.adapter.agentDir,
+            agentDir: this.backend.agentDir,
             setInputSurface: component => this.root.setInputSurface(component),
             showOverlay: (component, overlayOptions) => this.runtime.showOverlay(component, overlayOptions),
             listenInput: handler => this.runtime.addInputListener(handler),
@@ -615,32 +618,32 @@ export class PiSessionShell {
             getToolsExpanded: () => this.root.toolsExpanded,
             setToolsExpanded: expanded => this.root.setToolsExpanded(expanded),
         });
-        this.adapter.setWorkflowInteractionHost({
+        this.backend.setWorkflowInteractionHost({
             startLogin: request => this.#startWorkflowLogin(request),
             prompt: request => this.#requestWorkflowInput(request),
             notify: event => this.#notifyWorkflowLogin(event),
             finishLogin: () => this.#finishWorkflowLogin(),
         });
-        this.root.editor.setAutocompleteCommands(this.adapter.workflowAutocompleteCommands());
-        this.#unsubscribe = this.adapter.onEvent(event => {
+        this.root.editor.setAutocompleteCommands(this.backend.workflowAutocompleteCommands());
+        this.#unsubscribe = this.backend.onEvent(event => {
             this.#syncView();
             if (this.view().lifecycle === "ready" && this.#compactionQueue.length > 0)
                 void this.#flushCompactionQueue();
             if (event.type === "session-lifecycle" && event.lifecycle === "stopped")
                 this.#resolveStopped?.();
         });
-        if (this.adapter.view().lifecycle === "stopped")
+        if (this.backend.view().lifecycle === "stopped")
             this.#resolveStopped?.();
     }
     view() {
-        return this.adapter.view();
+        return this.backend.view();
     }
     start() {
         if (this.#started)
             return;
         this.#started = true;
         this.runtime.start();
-        void this.adapter.bindExtensionUi(this.#extensionBridge.context, () => { void this.shutdown(); });
+        void this.backend.bindExtensionUi(this.#extensionBridge.context, () => { void this.shutdown(); });
         this.#syncView();
     }
     onView(listener) {
@@ -663,7 +666,7 @@ export class PiSessionShell {
             if (command) {
                 this.root.editor.addToHistory(input);
                 try {
-                    const result = await this.adapter.executeBashWorkflow(command, excludeFromContext);
+                    const result = await this.backend.executeBashWorkflow(command, excludeFromContext);
                     const workflow = {
                         command: "debug",
                         outcome: result.cancelled ? "cancelled" : result.exitCode === 0 || result.exitCode === undefined ? "completed" : "failed",
@@ -694,7 +697,7 @@ export class PiSessionShell {
         return this.#execute({
             type,
             correlationId: this.#correlation(type),
-            sessionId: this.adapter.sessionId,
+            sessionId: this.backend.sessionId,
             text: input,
         });
     }
@@ -731,7 +734,7 @@ export class PiSessionShell {
         return this.#execute({
             type: "resume-session",
             correlationId: this.#correlation("resume"),
-            sessionId: this.adapter.sessionId,
+            sessionId: this.backend.sessionId,
             sessionPath,
         });
     }
@@ -739,7 +742,7 @@ export class PiSessionShell {
         return this.#execute({
             type: "set-model",
             correlationId: this.#correlation("model"),
-            sessionId: this.adapter.sessionId,
+            sessionId: this.backend.sessionId,
             model: { providerId, modelId, displayName: modelId },
         });
     }
@@ -747,7 +750,7 @@ export class PiSessionShell {
         return this.#execute({
             type: "set-thinking-level",
             correlationId: this.#correlation("thinking"),
-            sessionId: this.adapter.sessionId,
+            sessionId: this.backend.sessionId,
             thinkingLevel,
         });
     }
@@ -757,7 +760,7 @@ export class PiSessionShell {
         return this.setThinkingLevel(levels[(current + 1) % levels.length] ?? "off");
     }
     async cycleModel(direction) {
-        const result = await this.adapter.cycleModelWorkflow(direction);
+        const result = await this.backend.cycleModelWorkflow(direction);
         this.root.appendWorkflowResult(result);
         if (result.outcome === "completed")
             this.#showDaxnutsForActiveModel();
@@ -777,12 +780,12 @@ export class PiSessionShell {
         return this.#execute({
             type: "follow-up",
             correlationId: this.#correlation("follow-up"),
-            sessionId: this.adapter.sessionId,
+            sessionId: this.backend.sessionId,
             text,
         });
     }
     restoreQueuedInput() {
-        const queued = [...this.adapter.clearQueuedWorkflows(), ...this.#compactionQueue.map(item => item.text)];
+        const queued = [...this.backend.clearQueuedWorkflows(), ...this.#compactionQueue.map(item => item.text)];
         this.#compactionQueue = [];
         if (queued.length === 0)
             return;
@@ -810,7 +813,7 @@ export class PiSessionShell {
         return handle;
     }
     showModelSelector() {
-        const context = this.adapter.pinnedModelSelectorContext();
+        const context = this.backend.pinnedModelSelectorContext();
         const close = () => {
             this.root.setInputSurface(null);
             this.runtime.requestRender();
@@ -832,7 +835,7 @@ export class PiSessionShell {
         this.runtime.requestRender();
     }
     showForkSelector() {
-        const options = this.adapter.pinnedForkOptions();
+        const options = this.backend.pinnedForkOptions();
         if (options.length === 0) {
             this.root.appendWorkflowResult({ command: "fork", outcome: "failed", message: "No user messages available to fork from" });
             this.runtime.requestRender();
@@ -850,7 +853,7 @@ export class PiSessionShell {
         this.runtime.requestRender();
     }
     async showLogoutSelector() {
-        const options = await this.adapter.pinnedLogoutOptions();
+        const options = await this.backend.pinnedLogoutOptions();
         if (options.length === 0) {
             this.root.appendWorkflowStatus("No authenticated providers available.");
             this.runtime.requestRender();
@@ -868,7 +871,7 @@ export class PiSessionShell {
         this.runtime.requestRender();
     }
     showLoginMethodSelector(providerReference) {
-        const method = this.adapter.pinnedLoginMethodOptions(providerReference);
+        const method = this.backend.pinnedLoginMethodOptions(providerReference);
         if (method.options.length === 0) {
             this.root.appendWorkflowResult({ command: "login", outcome: "failed", message: `No authentication methods available for ${providerReference}` });
             this.runtime.requestRender();
@@ -896,7 +899,7 @@ export class PiSessionShell {
         this.runtime.requestRender();
     }
     showTreeSelector(initialSelectedId) {
-        const context = this.adapter.pinnedTreeSelectorContext();
+        const context = this.backend.pinnedTreeSelectorContext();
         if (context.tree.length === 0) {
             this.root.appendWorkflowStatus("No entries in session");
             this.runtime.requestRender();
@@ -941,7 +944,7 @@ export class PiSessionShell {
         this.runtime.requestRender();
     }
     showLoginProviderSelector(authType) {
-        const options = this.adapter.pinnedLoginOptions(authType);
+        const options = this.backend.pinnedLoginOptions(authType);
         if (options.length === 0) {
             this.root.appendWorkflowStatus(authType === "oauth" ? "No subscription providers available." : "No API key providers available.");
             this.runtime.requestRender();
@@ -962,7 +965,7 @@ export class PiSessionShell {
         this.runtime.requestRender();
     }
     showSessionSelector() {
-        const context = this.adapter.pinnedSessionSelectorContext();
+        const context = this.backend.pinnedSessionSelectorContext();
         const close = () => {
             this.root.setInputSurface(null);
             this.runtime.requestRender();
@@ -987,7 +990,7 @@ export class PiSessionShell {
         this.runtime.requestRender();
     }
     showSettingsSelector() {
-        const snapshot = this.adapter.pinnedSettingsSnapshot();
+        const snapshot = this.backend.pinnedSettingsSnapshot();
         const close = () => {
             this.root.setInputSurface(null);
             this.runtime.requestRender();
@@ -1013,7 +1016,7 @@ export class PiSessionShell {
                         return;
                     }
                 }
-                const result = this.adapter.applyPinnedSettingValue(callback, value);
+                const result = this.backend.applyPinnedSettingValue(callback, value);
                 if (result.outcome === "failed")
                     this.root.appendWorkflowResult(result);
                 else if (callback === "onTuiModeChange")
@@ -1091,7 +1094,7 @@ export class PiSessionShell {
         }
         let result;
         try {
-            result = await this.adapter.executeWorkflow(request);
+            result = await this.backend.executeWorkflow(request);
         }
         finally {
             if (operationSurface) {
@@ -1109,7 +1112,7 @@ export class PiSessionShell {
             return { outcome: "failed", diagnostic: `Owned controller missing for ${request.command}` };
         }
         if (request.command === "reload" && result.outcome === "completed") {
-            this.root.editor.setAutocompleteCommands(this.adapter.workflowAutocompleteCommands());
+            this.root.editor.setAutocompleteCommands(this.backend.workflowAutocompleteCommands());
         }
         this.root.appendWorkflowResult(result);
         if (request.command === "model" && result.outcome === "completed")
@@ -1118,7 +1121,7 @@ export class PiSessionShell {
         return workflowAdapterResult(result);
     }
     showTrustSelector() {
-        const context = this.adapter.pinnedProjectTrustContext();
+        const context = this.backend.pinnedProjectTrustContext();
         const close = () => {
             this.root.setInputSurface(null);
             this.runtime.requestRender();
@@ -1127,7 +1130,7 @@ export class PiSessionShell {
             ...context,
             onSelect: selection => {
                 try {
-                    this.adapter.persistProjectTrust(selection.updates);
+                    this.backend.persistProjectTrust(selection.updates);
                     close();
                     this.root.appendWorkflowStatus(`Saved trust decision: ${selection.trusted ? "trusted" : "untrusted"}. Restart pi for this to take effect.`);
                 }
@@ -1143,7 +1146,7 @@ export class PiSessionShell {
         this.runtime.requestRender();
     }
     showScopedModelsSelector() {
-        const initial = this.adapter.pinnedScopedModelsContext();
+        const initial = this.backend.pinnedScopedModelsContext();
         let currentEnabledIds = initial.enabledModelIds === null ? null : [...initial.enabledModelIds];
         let selectionChanged = false;
         let disposed = false;
@@ -1167,12 +1170,12 @@ export class PiSessionShell {
             onChange: enabledIds => {
                 selectionChanged = true;
                 currentEnabledIds = enabledIds === null ? null : [...enabledIds];
-                this.adapter.updateScopedModels(currentEnabledIds);
+                this.backend.updateScopedModels(currentEnabledIds);
                 this.runtime.requestRender();
             },
             onPersist: enabledIds => {
                 currentEnabledIds = enabledIds === null ? null : [...enabledIds];
-                this.adapter.persistScopedModels(currentEnabledIds);
+                this.backend.persistScopedModels(currentEnabledIds);
                 this.root.appendWorkflowStatus("Model selection saved to settings");
                 this.runtime.requestRender();
             },
@@ -1189,7 +1192,7 @@ export class PiSessionShell {
         };
         this.root.setInputSurface(component);
         this.runtime.requestRender();
-        void this.adapter.refreshScopedModels(controller.signal).then(refreshed => {
+        void this.backend.refreshScopedModels(controller.signal).then(refreshed => {
             if (disposed)
                 return;
             if (!selectionChanged) {
@@ -1198,7 +1201,7 @@ export class PiSessionShell {
             }
             else {
                 component.updateModels(refreshed.models);
-                this.adapter.updateScopedModels(currentEnabledIds);
+                this.backend.updateScopedModels(currentEnabledIds);
             }
             component.setRefreshStatus(timedOut ? "Model refresh timed out; showing cached models." : refreshed.status, timedOut ? "warning" : refreshed.statusKind);
             this.runtime.requestRender();
@@ -1223,14 +1226,14 @@ export class PiSessionShell {
         this.#disposed = true;
         this.#unsubscribe();
         this.#dialogHandle?.hide();
-        await this.adapter.unbindExtensionUi();
+        await this.backend.unbindExtensionUi();
         this.#extensionBridge.dispose();
         await this.runtime.dispose();
     }
     #syncView() {
         const view = this.view();
-        if (this.adapter.sessionGeneration !== this.#sessionGeneration) {
-            this.#sessionGeneration = this.adapter.sessionGeneration;
+        if (this.backend.sessionGeneration !== this.#sessionGeneration) {
+            this.#sessionGeneration = this.backend.sessionGeneration;
             this.#activeLoginDialog = undefined;
             this.#extensionBridge.reset();
             this.root.setInputSurface(null);
@@ -1243,6 +1246,69 @@ export class PiSessionShell {
         for (const listener of this.#listeners)
             listener(view);
     }
+    #openOwnedRoute(route) {
+        const surface = this.#routeHost?.open(route) ?? null;
+        if (surface === null)
+            return { outcome: "failed", diagnostic: `route is unavailable: ${route}` };
+        if (!this.runtime.active)
+            return { outcome: "failed", diagnostic: "runtime is not active" };
+        this.#dialogHandle?.hide();
+        // Any-event reporting: hover and drag are what the screen is driven by, and
+        // it also stops the terminal treating a drag as a text selection.
+        this.runtime.writeControl(MOUSE_TRACKING_ON);
+        // The interrupt chord is global, so it is watched on raw input rather than
+        // through the overlay: the pinned shell handles that key before an overlay
+        // ever sees it, which is why an owned screen must not rely on being asked.
+        let armedAt = 0;
+        const removeInterruptWatch = this.runtime.addInputListener(data => {
+            if (!data.includes(INTERRUPT))
+                return undefined;
+            const now = Date.now();
+            if (armedAt !== 0 && now - armedAt <= INTERRUPT_CHORD_MS) {
+                armedAt = 0;
+                closeSurface();
+                void this.shutdown();
+                return { consume: true };
+            }
+            armedAt = now;
+            this.runtime.requestRender();
+            // The presented screen owns the chord, so the pinned shell never sees a
+            // stray interrupt while it is up.
+            return { consume: true };
+        });
+        const closeSurface = () => {
+            removeInterruptWatch();
+            this.runtime.writeControl(MOUSE_TRACKING_OFF);
+            this.#dialogHandle?.hide();
+            this.#dialogHandle = undefined;
+            this.#dialogId = undefined;
+        };
+        const rows = () => Math.max(1, this.runtime.viewport().rows);
+        const component = {
+            render: (width) => [...surface.render(Math.max(1, width), rows())],
+            handleInput: (data) => {
+                const { events, rest } = parseMouseInput(data);
+                for (const event of events)
+                    surface.handleMouse(event);
+                if (rest.length > 0)
+                    surface.handleInput(rest);
+                if (surface.isClosed()) {
+                    closeSurface();
+                    return;
+                }
+                this.runtime.requestRender();
+            },
+            invalidate: () => this.runtime.requestRender(),
+        };
+        surface.onRenderRequested(() => this.runtime.requestRender());
+        surface.onExitRequested(() => {
+            closeSurface();
+            void this.shutdown();
+        });
+        this.#dialogHandle = this.runtime.showOverlay(component, { width: "100%", maxHeight: "100%", anchor: "top-left" });
+        this.#dialogId = surface.id;
+        return { outcome: "completed", diagnostic: null };
+    }
     #syncDialog(dialog) {
         if (!this.runtime.active)
             return;
@@ -1273,6 +1339,8 @@ export class PiSessionShell {
         const separator = body.search(/\s/);
         const name = separator < 0 ? body : body.slice(0, separator);
         const argument = separator < 0 ? "" : body.slice(separator + 1).trimStart();
+        if (this.#routeHost?.claims(name))
+            return this.#openOwnedRoute(name);
         if (isWorkflowRoute(name))
             return this.runWorkflow({ command: name, argument });
         // Unknown slash input, prompt templates, skills, and extension commands remain Pi prompt input.
@@ -1280,7 +1348,7 @@ export class PiSessionShell {
         return this.#execute({
             type: this.view().lifecycle === "busy" ? "steer" : "prompt",
             correlationId: this.#correlation("prompt-command"),
-            sessionId: this.adapter.sessionId,
+            sessionId: this.backend.sessionId,
             text,
         });
     }
@@ -1362,7 +1430,7 @@ export class PiSessionShell {
             ? dialog.showManualInput(request.message)
             : dialog.showPrompt(request.message, request.placeholder);
         this.runtime.requestRender();
-        return response.then(value => value.trim() || null, () => null);
+        return response.then(value => value, () => null);
     }
     #notifyWorkflowLogin(event) {
         const dialog = this.#activeLoginDialog;
@@ -1396,16 +1464,16 @@ export class PiSessionShell {
             await this.#execute({
                 type: item.type,
                 correlationId: this.#correlation(`compaction-${item.type}`),
-                sessionId: this.adapter.sessionId,
+                sessionId: this.backend.sessionId,
                 text: item.text,
             });
         }
     }
     async #execute(command) {
-        return this.adapter.execute(command);
+        return this.backend.execute(command);
     }
     #simple(type) {
-        return { type, correlationId: this.#correlation(type), sessionId: this.adapter.sessionId };
+        return { type, correlationId: this.#correlation(type), sessionId: this.backend.sessionId };
     }
     #correlation(prefix) {
         this.#sequence += 1;
@@ -1430,8 +1498,9 @@ function workflowAdapterResult(result) {
         return { outcome: "failed", diagnostic: result.message };
     return { outcome: "rejected", diagnostic: result.message };
 }
+const INTERRUPT = "\u0003";
+const INTERRUPT_CHORD_MS = 1_500;
 function isWorkflowRoute(value) {
     return PINNED_PI_WORKFLOW_COMMAND_NAMES.includes(value)
         || PINNED_PI_HIDDEN_COMMAND_NAMES.includes(value);
 }
-//# sourceMappingURL=pi-session-shell.js.map

package/dist/src/foundation/pi-tui-runtime-adapter/adapter.d.ts

@@ -20,6 +20,12 @@ export declare class PiTuiRuntimeAdapter {
     setFocus(component: PiTuiComponentPort | null): void;
     showOverlay(component: PiTuiComponentPort, options?: PiTuiOverlayOptions): PiTuiOverlayHandle;
     hasOverlay(): boolean;
+    /**
+     * Writes a terminal control sequence. Used to enable and disable mouse
+     * reporting while an A1-owned application is presented, and for nothing else:
+     * the transparent and pinned paths never call it.
+     */
+    writeControl(data: string): void;
     addInputListener(listener: PiTuiInputListener): () => void;
     switchMode(mode: "regular" | "fullscreen"): boolean;
     setHardwareCursor(enabled: boolean): void;
@@ -31,4 +37,3 @@ export declare class PiTuiRuntimeAdapter {
     stop(options?: PiTuiStopOptions): Promise<void>;
     dispose(options?: PiTuiStopOptions): Promise<void>;
 }
-//# sourceMappingURL=adapter.d.ts.map

package/dist/src/foundation/pi-tui-runtime-adapter/adapter.js

@@ -230,6 +230,15 @@ export class PiTuiRuntimeAdapter {
     hasOverlay() {
         return this.#tui.hasOverlay();
     }
+    /**
+     * Writes a terminal control sequence. Used to enable and disable mouse
+     * reporting while an A1-owned application is presented, and for nothing else:
+     * the transparent and pinned paths never call it.
+     */
+    writeControl(data) {
+        this.#assertRunning("control sequence");
+        this.#terminal.write(data);
+    }
     addInputListener(listener) {
         this.#assertRunning("input listener");
         if (this.#inputListeners.has(listener))
@@ -482,4 +491,3 @@ function toOverlayOptions(options) {
         mapped.nonCapturing = options.nonCapturing;
     return mapped;
 }
-//# sourceMappingURL=adapter.js.map