@timurproko/a1 0.2.7-dev.1249 → 0.2.7-dev.1255

package/dist/foundation/session-writer-lock/index.js

@@ -1,10 +1,8 @@
-import { closeSync, existsSync, mkdirSync, openSync, readFileSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
-import { createRequire } from "node:module";
+import { existsSync, mkdirSync, realpathSync, statSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { basename, dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
 import { createHash } from "node:crypto";
-import { PRODUCT_IDENTITY } from "../../product-identity.js";
+import lockfile from "proper-lockfile";
 /** Reports that a canonical session identity already has a live writer. */
 export class SessionWriterConflict extends Error {
     path;
@@ -16,107 +14,60 @@ export class SessionWriterConflict extends Error {
         this.holderKind = holderKind;
     }
 }
+/**
+ * A crashed writer is not released by the kernel; its lock becomes stale once its holder stops
+ * refreshing it. The bound keeps resume after a crash a matter of seconds.
+ */
+export const SESSION_WRITER_STALE_MS = 10_000;
 let backendOverride;
 let cachedBackend;
-/** Security: a release that carries its own terminal-host addon never loads one chosen by cwd. */
-export function nativeCandidates(moduleUrl = import.meta.url, env = process.env, cwd = process.cwd(), exists = existsSync) {
-    const addon = `${PRODUCT_IDENTITY.artifacts.terminalHostAddon}.node`;
-    // Invariant: this module sits at dist/foundation/session-writer-lock/ inside the release root.
-    const own = resolve(fileURLToPath(new URL("../../../", moduleUrl)), "dist", "native", `${process.platform}-${process.arch}`, addon);
-    const override = env[PRODUCT_IDENTITY.environment.developmentInstanceId]
-        ? env[PRODUCT_IDENTITY.environment.terminalHostPath]?.trim() || undefined
-        : undefined;
-    const local = exists(own)
-        ? [own]
-        : [resolve(cwd, "dist", "native", `${process.platform}-${process.arch}`, addon), resolve(cwd, ".artifacts", "terminal-host", addon)];
-    return override ? [override, ...local] : local;
-}
-function loadNativeBackend() {
-    const require = createRequire(import.meta.url);
-    for (const candidate of nativeCandidates()) {
-        if (!existsSync(candidate))
-            continue;
-        try {
-            const loaded = require(candidate);
-            if (loaded.SessionLock?.acquire)
-                return loaded.SessionLock;
-        }
-        catch {
-            // Compatibility: an addon for another Node ABI is unusable; try the next location.
-        }
-    }
-    return undefined;
-}
-function processIsLive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/** Development fallback. Installed releases carry the verified Node-API lock resolved above. */
-function portableBackend() {
-    const root = join(tmpdir(), "a1-session-writer-locks");
-    mkdirSync(root, { recursive: true, mode: 0o700 });
+/**
+ * Locks live in one per-user directory keyed by canonical identity, not beside the session, so two
+ * spellings of one file (case, short names, links, hard links) contend for the same lock.
+ */
+export function lockfileBackend(root = join(tmpdir(), "a1-session-writer-locks"), staleMs = SESSION_WRITER_STALE_MS) {
     const authorityPath = (kind, key) => join(root, `${createHash("sha256").update(`${kind}\0${key}`).digest("hex")}.lock`);
+    // Platform: Windows file names are case-insensitive, and realpath canonicalizes only existing parents.
     const locationKey = (path) => `${realpathSync.native(dirname(path))}\0${process.platform === "win32" ? basename(path).toLowerCase() : basename(path)}`;
     const identityKey = (path) => {
-        const physical = realpathSync.native(path);
-        const metadata = statSync(physical, { bigint: true });
+        const metadata = statSync(realpathSync.native(path), { bigint: true });
         return `${metadata.dev}:${metadata.ino}`;
     };
     const acquireAuthority = (path) => {
-        for (let attempt = 0; attempt < 2; attempt += 1) {
-            try {
-                const descriptor = openSync(path, "wx", 0o600);
-                writeFileSync(descriptor, JSON.stringify({ pid: process.pid, kind: process.env.A1_TAB_ID ? "resident tab" : "another A1 process" }));
-                closeSync(descriptor);
-                return;
-            }
-            catch (error) {
-                if (attempt === 0) {
-                    try {
-                        const record = JSON.parse(readFileSync(path, "utf8"));
-                        if (typeof record.pid === "number" && !processIsLive(record.pid)) {
-                            rmSync(path, { force: true });
-                            continue;
-                        }
-                    }
-                    catch {
-                        // Security: malformed or racing lock evidence remains authoritative and fails closed.
-                    }
-                }
-                throw error;
-            }
-        }
+        mkdirSync(root, { recursive: true, mode: 0o700 });
+        // Rationale: the lock directory is the authority; no target file exists or is needed.
+        return lockfile.lockSync(path, {
+            realpath: false,
+            lockfilePath: path,
+            stale: staleMs,
+            // Rationale: a missed refresh means this process stalled; the next writer takes over, and the
+            // stalled one must not crash for it.
+            onCompromised: () => { },
+        });
     };
     return {
         acquire(requested) {
             const absolute = resolve(requested);
-            const location = authorityPath("location", locationKey(absolute));
-            acquireAuthority(location);
-            let identity;
-            let identityAcquired = false;
+            let releaseCurrent = acquireAuthority(authorityPath("location", locationKey(absolute)));
             let bound = false;
-            try {
-                if (existsSync(absolute)) {
-                    const key = identityKey(absolute);
-                    identity = authorityPath("identity", key);
-                    acquireAuthority(identity);
-                    identityAcquired = true;
-                    if (identityKey(absolute) !== key) {
-                        throw new Error("session identity changed while its writer lock was acquired");
-                    }
-                    rmSync(location, { force: true });
-                    bound = true;
+            const bindTo = () => {
+                const key = identityKey(absolute);
+                const releaseIdentity = acquireAuthority(authorityPath("identity", key));
+                if (identityKey(absolute) !== key) {
+                    releaseIdentity();
+                    throw new Error("session identity changed while its writer lock was acquired");
                 }
+                // Invariant: the identity lock is held before the location lock goes, so there is no gap.
+                releaseCurrent();
+                releaseCurrent = releaseIdentity;
+                bound = true;
+            };
+            try {
+                if (existsSync(absolute))
+                    bindTo();
             }
             catch (error) {
-                rmSync(location, { force: true });
-                if (identityAcquired && identity !== undefined)
-                    rmSync(identity, { force: true });
+                releaseCurrent();
                 throw error;
             }
             let released = false;
@@ -126,29 +77,23 @@ function portableBackend() {
                     if (bound || resolve(created) !== absolute || !existsSync(absolute)) {
                         throw new Error("created session does not match its reservation");
                     }
-                    const key = identityKey(absolute);
-                    identity = authorityPath("identity", key);
-                    acquireAuthority(identity);
-                    if (identityKey(absolute) !== key) {
-                        rmSync(identity, { force: true });
-                        identity = undefined;
-                        throw new Error("created session identity changed during bind");
-                    }
-                    rmSync(location, { force: true });
-                    bound = true;
+                    bindTo();
                 },
                 release() {
                     if (released)
                         throw new Error("session lock was already released");
                     released = true;
-                    rmSync(bound ? identity : location, { force: true });
+                    try {
+                        releaseCurrent();
+                    }
+                    catch { /* Compatibility: a reclaimed stale lock is already gone. */ }
                 },
             };
         },
     };
 }
 function backend() {
-    return backendOverride ?? (cachedBackend ??= loadNativeBackend() ?? portableBackend());
+    return backendOverride ?? (cachedBackend ??= lockfileBackend());
 }
 function acquire(path) {
     const absolute = resolve(path);
@@ -157,7 +102,7 @@ function acquire(path) {
         lock = backend().acquire(absolute);
     }
     catch {
-        throw new SessionWriterConflict(absolute, process.env.A1_TAB_ID ? "a resident tab" : "another A1 process");
+        throw new SessionWriterConflict(absolute);
     }
     let released = false;
     return {
@@ -196,7 +141,7 @@ export function bind(handle, createdPath) {
 export function release(handle) {
     handle.release();
 }
-/** Test-only backend seam; passing undefined restores native discovery. */
+/** Test-only backend seam; passing undefined restores the default backend. */
 export function setSessionWriterLockBackendForTest(value) {
     backendOverride = value;
     cachedBackend = undefined;

package/dist/foundation/startup/startup-budget.d.ts

@@ -1,7 +1,7 @@
 import type { StartupTraceEvent } from "./startup-runtime.js";
 export interface StartupPerformanceEvidence {
     readonly profileId: "a1" | "pi";
-    readonly launchKind: "post-update" | "no-live-supervisor" | "warm";
+    readonly launchKind: "post-update" | "restart" | "warm";
     readonly events: readonly StartupTraceEvent[];
     readonly moduleGraph?: {
         readonly loadedFiles: number;
@@ -15,7 +15,7 @@ export interface StartupPerformanceEvidence {
 }
 export interface StartupBudgetViolation {
     readonly profileId: "a1" | "pi";
-    readonly launchKind: "post-update" | "no-live-supervisor" | "warm";
+    readonly launchKind: "post-update" | "restart" | "warm";
     readonly elapsedMs: number;
     readonly budgetMs: number;
     readonly dominantPhases: readonly {
@@ -27,13 +27,13 @@ export interface StartupBudgetViolation {
 /** Resolve the declared budget for one launch kind so measurement and reporting never restate the numbers. */
 export declare function resolveStartupBudgetMs(launchKind: StartupPerformanceEvidence["launchKind"], budgets?: {
     readonly postUpdateMs: number;
-    readonly noSupervisorMs: number;
+    readonly restartMs: number;
     readonly warmMs: number;
 }): number;
 /** Compare measured startup evidence with its budget without deciding whether the channel enforces it. */
 export declare function evaluateStartupPerformanceBudget(evidence: StartupPerformanceEvidence, budgets?: {
     readonly postUpdateMs: number;
-    readonly noSupervisorMs: number;
+    readonly restartMs: number;
     readonly warmMs: number;
 }): StartupBudgetViolation | null;
 /** Render one budget violation as the single message used by failures, evidence, and run summaries. */
@@ -41,6 +41,6 @@ export declare function formatStartupBudgetViolation(violation: StartupBudgetVio
 /** Enforce the startup budget in a channel that fails on an overrun. */
 export declare function assertStartupPerformanceBudget(evidence: StartupPerformanceEvidence, budgets?: {
     readonly postUpdateMs: number;
-    readonly noSupervisorMs: number;
+    readonly restartMs: number;
     readonly warmMs: number;
 }): void;

package/dist/foundation/startup/startup-budget.js

@@ -1,7 +1,7 @@
-const STARTUP_PERFORMANCE_BUDGETS = { postUpdateMs: 2_000, noSupervisorMs: 2_500, warmMs: 2_000 };
+const STARTUP_PERFORMANCE_BUDGETS = { postUpdateMs: 2_000, restartMs: 2_500, warmMs: 2_000 };
 /** Resolve the declared budget for one launch kind so measurement and reporting never restate the numbers. */
 export function resolveStartupBudgetMs(launchKind, budgets = STARTUP_PERFORMANCE_BUDGETS) {
-    return launchKind === "warm" ? budgets.warmMs : launchKind === "no-live-supervisor" ? budgets.noSupervisorMs : budgets.postUpdateMs;
+    return launchKind === "warm" ? budgets.warmMs : launchKind === "restart" ? budgets.restartMs : budgets.postUpdateMs;
 }
 /** Compare measured startup evidence with its budget without deciding whether the channel enforces it. */
 export function evaluateStartupPerformanceBudget(evidence, budgets = STARTUP_PERFORMANCE_BUDGETS) {

package/dist/foundation/startup/startup-runtime.d.ts

@@ -1,5 +1,5 @@
 import { PRODUCT_IDENTITY } from "../../product-identity.js";
-export type StartupPhase = "command-invoked" | "bootstrap-start" | "bootstrap-selected" | "durable-validation-start" | "durable-validation-complete" | "replacement-supervisor-start" | "replacement-supervisor-ready" | "guardian-start" | "guardian-connected" | "ui-entry" | "ui-modules-loaded" | "pi-services" | "resource-discovery" | "session-created" | "settings-loaded" | "first-input-ready-render";
+export type StartupPhase = "command-invoked" | "bootstrap-start" | "bootstrap-selected" | "durable-validation-start" | "durable-validation-complete" | "ui-entry" | "ui-modules-loaded" | "pi-services" | "resource-discovery" | "session-created" | "settings-loaded" | "first-input-ready-render";
 export interface StartupTraceEvent {
     readonly schema: typeof PRODUCT_IDENTITY.evidence.startupTraceSchema;
     readonly traceId: string;

package/dist/foundation/terminal-cleanup/exit-notice.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The launcher's half of the unclean-exit protocol. The UI arms a notice file while it runs and
+ * removes it on a clean exit, so a notice that is still present when the UI ends means the UI was
+ * stopped unexpectedly: restore the terminal, print the notice as plain text, and consume it.
+ */
+export declare function deliverExitNotice(path: string, write: (text: string) => void, restore?: () => void): boolean;

package/dist/foundation/terminal-cleanup/exit-notice.js

@@ -0,0 +1,36 @@
+import { readFileSync, rmSync } from "node:fs";
+import { restoreProcessTerminal } from "./terminal-reset.js";
+/** Notices are a few plain lines; anything larger is not one this build wrote. */
+const MAX_NOTICE_BYTES = 4096;
+/**
+ * The launcher's half of the unclean-exit protocol. The UI arms a notice file while it runs and
+ * removes it on a clean exit, so a notice that is still present when the UI ends means the UI was
+ * stopped unexpectedly: restore the terminal, print the notice as plain text, and consume it.
+ */
+export function deliverExitNotice(path, write, restore = restoreProcessTerminal) {
+    let text;
+    try {
+        const bytes = readFileSync(path);
+        text = bytes.byteLength > MAX_NOTICE_BYTES ? "" : bytes.toString("utf8");
+    }
+    catch {
+        return false;
+    }
+    try {
+        rmSync(path, { force: true });
+    }
+    catch { }
+    // Security: the notice is printed after the UI is gone, so it must not carry terminal controls.
+    const lines = text.split(/\r?\n/u).map(line => line.replace(/[\x00-\x1f\x7f-\x9f]/gu, "")).filter(line => line.length > 0);
+    if (lines.length === 0)
+        return false;
+    try {
+        restore();
+    }
+    catch { }
+    try {
+        write(`\n${lines.join("\n")}\n`);
+    }
+    catch { }
+    return true;
+}

package/dist/foundation/terminal-cleanup/index.d.ts

@@ -1,3 +1,4 @@
-export { CLEAR_EXIT_INTERVAL_MS, EMERGENCY_TERMINAL_RESET, RESIDENT_DETACH_INTERVAL_MS, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
+export { CLEAR_EXIT_INTERVAL_MS, EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
+export { deliverExitNotice } from "./exit-notice.js";
 export { installFatalExit, writeFatalDiagnostic } from "./fatal-exit.js";
 export type { FatalExitOptions } from "./fatal-exit.js";

package/dist/foundation/terminal-cleanup/index.js

@@ -1,2 +1,3 @@
-export { CLEAR_EXIT_INTERVAL_MS, EMERGENCY_TERMINAL_RESET, RESIDENT_DETACH_INTERVAL_MS, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
+export { CLEAR_EXIT_INTERVAL_MS, EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
+export { deliverExitNotice } from "./exit-notice.js";
 export { installFatalExit, writeFatalDiagnostic } from "./fatal-exit.js";

package/dist/foundation/terminal-cleanup/terminal-reset.d.ts

@@ -1,9 +1,4 @@
 export declare const CLEAR_EXIT_INTERVAL_MS = 500;
-/**
- * How long a first `Ctrl+C` keeps the resident attach client's detach chord armed. It matches the
- * owned dialogs' interrupt chord so an unhurried double press leaves resident tabs from any tab.
- */
-export declare const RESIDENT_DETACH_INTERVAL_MS = 1500;
 export declare const EMERGENCY_TERMINAL_RESET: string;
 export declare function restoreProcessTerminal(): void;
 export declare function restoreAfterOwnedExit(ownsTerminal: boolean, code: number | null, signal: string | null, restore?: () => void): number;

package/dist/foundation/terminal-cleanup/terminal-reset.js

@@ -1,10 +1,5 @@
 import { writeSync } from "node:fs";
 export const CLEAR_EXIT_INTERVAL_MS = 500;
-/**
- * How long a first `Ctrl+C` keeps the resident attach client's detach chord armed. It matches the
- * owned dialogs' interrupt chord so an unhurried double press leaves resident tabs from any tab.
- */
-export const RESIDENT_DETACH_INTERVAL_MS = 1_500;
 // Protocol: reset modes on both screens; setting keyboard flags to zero is idempotent,
 // unlike repeatedly popping a keyboard-protocol stack owned by a parent application.
 // Resetting parent-screen margins homes the cursor, so preserve its restored position.

package/dist/integrations/pi/components/editor-interaction.d.ts

@@ -1,5 +1,6 @@
+import type { OwnedUiShellEditorRecall } from "../../../contracts/owned-ui/index.js";
 import type { Editor } from "@earendil-works/pi-tui";
-export interface EditorInteractionState {
+interface EditorInteractionState {
     lines: string[];
     cursorLine: number;
     cursorCol: number;
@@ -17,17 +18,7 @@ export interface EditorInteractionPort {
     }>;
     setSegmentTransform(transform: (text: string, mode: "word" | "grapheme", segments: Iterable<Intl.SegmentData>) => Iterable<Intl.SegmentData>): void;
 }
-export interface EditorRecallPort {
-    replace(entries: readonly string[]): void;
-    position(): {
-        readonly index: number;
-        readonly total: number;
-    };
-    observe(listener: () => void): () => void;
-    reset(): void;
-    /** Exit a recall browse cycle by restoring the unsent draft rather than keeping the recalled entry. */
-    restoreDraft?(): void;
-}
+export type EditorRecallPort = OwnedUiShellEditorRecall;
 export interface EditorSurface extends Pick<Editor, Exclude<keyof Editor, "setText" | "render" | "handleInput">> {
     setText(text: string): void;
     render(width: number): string[];
@@ -38,3 +29,4 @@ export interface EditorSurface extends Pick<Editor, Exclude<keyof Editor, "setTe
 export type SelectionEditor = Pick<Editor, "getText" | "getCursor" | "setText" | "insertTextAtCursor" | "invalidate" | "onChange" | "getPaddingX" | "isShowingAutocomplete"> & {
     readonly interaction?: EditorInteractionPort;
 };
+export {};

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

@@ -1,16 +1,22 @@
-export { adaptPiAssistantMessage, adaptPiToolExecution, adaptPiUserMessage } from "./components.js";
 export { loadHistoryEditor, type HistoryEditorConstructor } from "./history-editor-loader.js";
-export { PiComponentConformanceError, runPiComponentConformance } from "./conformance.js";
-export type { PiComponentConformanceReport, PiComponentConformanceResult } from "./conformance.js";
 export { createPiShellOperationLoader, createPiShellShareOperationDialog, type PiShellOperationLoaderPort, } from "./share-operation-dialog.js";
-export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, createPiKeybindingsHost, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
+export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, createPiShellEditor, } from "./shell-editor-autocomplete.js";
+export { componentFromPort, componentPort, createTuiFacade, createPiKeybindingsHost, ensureTheme, formatSessionTokens, isAutocompleteProvider, isRecord, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, } from "./shell-shared-facade.js";
+export { createPiExtensionUiBridge, } from "./shell-extension-ui.js";
+export { createPiQueuedInputStatus, createPiShellFooter, createPiShellHeader, createPiShellLoadedResources, createPiShellStatus, } from "./shell-footer-status.js";
+export { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellThemeSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "./shell-selectors-dialogs.js";
+export { createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStatusText, } from "./shell-presenters-info.js";
+export { createPiShellTranscriptComponent, isPiPromptStyleCompaction, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-presenters-transcript.js";
 export { renderPiShellHotkeySections } from "./shell-hotkey-sections.js";
 export type { PiShellHotkeySection } from "./shell-hotkey-sections.js";
-export type { PiExtensionUiBridge, PiExtensionUiBridgeHost, PiShellAuthProviderOption, PiShellAutocompleteCommand, PiShellClipboardContent, PiShellCommandMessagePresentation, PiShellComponentPort, PiShellEditorBodyGeometry, PiShellEditorOptions, PiShellEditorPointerEvent, PiKeybindingsHost, PiShellEditorPort, PiShellEditorTextRange, PiShellExtensionRendererResolver, PiShellHeaderOptions, PiShellHeaderPort, PiShellHotkeysPresentation, PiShellImageAssetResolver, PiShellLoadedResourcesPort, PiShellLoginDialogPort, PiShellModelSelectorOptions, PiShellModelsDialogOptions, PiShellModelsDialogPort, PiShellPasteReservation, PiShellQueuedInputPort, PiShellResourceEntry, PiShellResourceSection, PiShellScopedModelDescriptor, PiShellScopedModelsSelectorOptions, PiShellScopedModelsSelectorPort, PiShellSelectorOption, PiShellSelectorOptions, PiShellSessionInfoPresentation, PiShellSettingsSelectorOptions, PiShellStartupNotice, PiShellStatusPlacement, PiShellStatusPort, PiShellSubmittedPromptComposer, PiShellTranscriptComponentPort, PiShellViewComponentPort, } from "./shell-components.js";
-export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeInstance, currentPiAccentColor, currentPiThemeName, derivePiAccentProjection, derivePiCanvasBackground, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, getPiSelectListTheme, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piCanvasBackgroundAnsi, piTheme, resolvePiThemeSetting, setPiAccentColor, setPiPackageBorderProjectionEnabled, stopPiThemeWatcher, } from "./theme.js";
-export type { PiAccentProjection, PiColorMode, PiTerminalTheme, PiTerminalThemeDetection, PiTerminalThemeDetector, PiThemeBackground, PiThemeResult } from "./theme.js";
-export { OwnedPiThemeController } from "./upstream/theme/theme-controller.js";
-export type { PiThemeRuntimePort, PiThemeSettingsPort } from "./upstream/theme/theme-controller.js";
+export type { PiExtensionUiBridge, PiExtensionUiBridgeHost, } from "./shell-extension-ui.js";
+export type { PiShellAuthProviderOption, PiShellLoginDialogPort, PiShellModelSelectorOptions, PiShellModelsDialogOptions, PiShellModelsDialogPort, PiShellScopedModelDescriptor, PiShellScopedModelsSelectorOptions, PiShellScopedModelsSelectorPort, PiShellSettingsSelectorOptions, } from "./shell-selectors-dialogs.js";
+export type { PiShellAutocompleteCommand, PiShellClipboardContent, PiShellComponentPort, PiShellEditorBodyGeometry, PiShellEditorOptions, PiShellEditorPointerEvent, PiKeybindingsHost, PiShellEditorPort, PiShellEditorTextRange, PiShellExtensionRendererResolver, PiShellHeaderOptions, PiShellHeaderPort, PiShellImageAssetResolver, PiShellLoadedResourcesPort, PiShellPasteReservation, PiShellQueuedInputPort, PiShellResourceEntry, PiShellResourceSection, PiShellSelectorOption, PiShellSelectorOptions, PiShellStartupNotice, PiShellStatusPlacement, PiShellStatusPort, PiShellTranscriptComponentPort, PiShellViewComponentPort, } from "./shell-shared-facade.js";
+export type { PiShellCommandMessagePresentation, PiShellHotkeysPresentation, PiShellSessionInfoPresentation, } from "./shell-presenters-info.js";
+export type { PiShellSubmittedPromptComposer, } from "./shell-presenters-transcript.js";
+export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeInstance, currentPiAccentColor, currentPiThemeName, derivePiAccentProjection, derivePiCanvasBackground, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piCanvasBackgroundAnsi, piTheme, resolvePiThemeSetting, setPiAccentColor, setPiPackageBorderProjectionEnabled, stopPiThemeWatcher, } from "./upstream/theme/theme.js";
+export type { PiAccentProjection, PiColorMode, PiTerminalTheme, PiTerminalThemeDetection, PiTerminalThemeDetector, PiThemeBackground, PiThemeResult } from "./upstream/theme/theme.js";
+export { PI_THEME_SOURCE, getPiSelectListTheme, piUiTheme } from "./theme.js";
 export { PI_MODAL_CONTENT_PADDING_X, PiModalFrame, PiModalHeader, addPiModalHeader, adoptPiModalFrame, adoptPiModalHeader, } from "./modal-frame.js";
 export { ModelsDialogComponent } from "./models-dialog.js";
 export type { ModelsDialogCallbacks, ModelsDialogConfig, ModelsDialogFilter, ModelsDialogModel } from "./models-dialog.js";

package/dist/integrations/pi/components/index.js

@@ -1,11 +1,15 @@
-export { adaptPiAssistantMessage, adaptPiToolExecution, adaptPiUserMessage } from "./components.js";
 export { loadHistoryEditor } from "./history-editor-loader.js";
-export { PiComponentConformanceError, runPiComponentConformance } from "./conformance.js";
 export { createPiShellOperationLoader, createPiShellShareOperationDialog, } from "./share-operation-dialog.js";
-export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, createPiKeybindingsHost, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
+export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, createPiShellEditor, } from "./shell-editor-autocomplete.js";
+export { componentFromPort, componentPort, createTuiFacade, createPiKeybindingsHost, ensureTheme, formatSessionTokens, isAutocompleteProvider, isRecord, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, } from "./shell-shared-facade.js";
+export { createPiExtensionUiBridge, } from "./shell-extension-ui.js";
+export { createPiQueuedInputStatus, createPiShellFooter, createPiShellHeader, createPiShellLoadedResources, createPiShellStatus, } from "./shell-footer-status.js";
+export { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellThemeSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "./shell-selectors-dialogs.js";
+export { createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStatusText, } from "./shell-presenters-info.js";
+export { createPiShellTranscriptComponent, isPiPromptStyleCompaction, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-presenters-transcript.js";
 export { renderPiShellHotkeySections } from "./shell-hotkey-sections.js";
-export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeInstance, currentPiAccentColor, currentPiThemeName, derivePiAccentProjection, derivePiCanvasBackground, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, getPiSelectListTheme, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piCanvasBackgroundAnsi, piTheme, resolvePiThemeSetting, setPiAccentColor, setPiPackageBorderProjectionEnabled, stopPiThemeWatcher, } from "./theme.js";
-export { OwnedPiThemeController } from "./upstream/theme/theme-controller.js";
+export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeInstance, currentPiAccentColor, currentPiThemeName, derivePiAccentProjection, derivePiCanvasBackground, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piCanvasBackgroundAnsi, piTheme, resolvePiThemeSetting, setPiAccentColor, setPiPackageBorderProjectionEnabled, stopPiThemeWatcher, } from "./upstream/theme/theme.js";
+export { PI_THEME_SOURCE, getPiSelectListTheme, piUiTheme } from "./theme.js";
 export { PI_MODAL_CONTENT_PADDING_X, PiModalFrame, PiModalHeader, addPiModalHeader, adoptPiModalFrame, adoptPiModalHeader, } from "./modal-frame.js";
 export { ModelsDialogComponent } from "./models-dialog.js";
 export { CountdownTimer } from "./upstream/components/countdown-timer.js";

package/dist/integrations/pi/components/lazy-selectors.d.ts

@@ -1,9 +1,7 @@
 import type { PiShellComponentPort } from "./shell-shared-facade.js";
 import type { ThinkingSelectorLevel } from "./upstream/components/thinking-selector.js";
 import type { FilterMode } from "./upstream/components/tree-selector.js";
-type ThinkingSelectorModule = typeof import("./thinking-selector-dialog.js");
-type TreeSelectorModule = typeof import("./upstream/components/tree-selector.js");
-export interface PiShellLazyThinkingSelectorOptions {
+interface PiShellLazyThinkingSelectorOptions {
     readonly currentLevel: ThinkingSelectorLevel;
     readonly availableLevels: readonly ThinkingSelectorLevel[];
     readonly onSelect: (level: ThinkingSelectorLevel) => void;
@@ -15,7 +13,7 @@ export interface PiShellLazyThinkingSelectorOptions {
         readonly cycleBinding: string | readonly string[];
     };
 }
-export interface PiShellLazyTreeSelectorOptions {
+interface PiShellLazyTreeSelectorOptions {
     readonly tree: readonly unknown[];
     readonly currentLeafId: string | null;
     readonly terminalHeight: number;
@@ -31,12 +29,6 @@ export interface PiShellLazySelectorLoader {
     createThinking(options: PiShellLazyThinkingSelectorOptions): Promise<PiShellComponentPort>;
     createTree(options: PiShellLazyTreeSelectorOptions): Promise<PiShellComponentPort>;
 }
-export interface PiShellLazySelectorImports {
-    readonly thinking: () => Promise<ThinkingSelectorModule>;
-    readonly tree: () => Promise<TreeSelectorModule>;
-}
-/** Builds one idempotent selector loader; fulfilled, in-flight, and rejected imports remain shared. */
-export declare function createPiShellLazySelectorLoader(imports?: PiShellLazySelectorImports): PiShellLazySelectorLoader;
 /** Production selector loader, dynamically reached only after the first input-ready frame. */
 export declare const piShellLazySelectors: PiShellLazySelectorLoader;
 export {};

package/dist/integrations/pi/components/lazy-selectors.js

@@ -4,7 +4,7 @@ const DEFAULT_IMPORTS = {
     tree: () => import("./upstream/components/tree-selector.js"),
 };
 /** Builds one idempotent selector loader; fulfilled, in-flight, and rejected imports remain shared. */
-export function createPiShellLazySelectorLoader(imports = DEFAULT_IMPORTS) {
+function createPiShellLazySelectorLoader(imports = DEFAULT_IMPORTS) {
     let thinkingSelectorModule;
     let treeSelectorModule;
     const loadThinkingSelector = () => thinkingSelectorModule ??= imports.thinking();

package/dist/integrations/pi/components/modal-frame.d.ts

@@ -1,31 +1,13 @@
-import { Container, Input, type Component, type Focusable, type TUI, type TuiMouseEvent, type TuiMouseEventResult } from "@earendil-works/pi-tui";
+import { Container, Input, type Component, type Focusable } from "@earendil-works/pi-tui";
 export declare const PI_MODAL_CONTENT_PADDING_X = 1;
 /** Paints the standard Pi Input prompt as a live-themed dialog-search marker. */
 export declare function renderPiModalSearchInput(input: Input, width: number): string[];
-/** Keeps Pi Input behavior and geometry while owning only its standard dialog-search presentation. */
-export declare class PiModalSearchInput implements Component, Focusable {
-    #private;
-    constructor(input: Input);
-    get focused(): boolean;
-    set focused(value: boolean);
-    invalidate(): void;
-    render(width: number): string[];
-    handleMouse(event: TuiMouseEvent): TuiMouseEventResult | undefined;
-}
 /** Replaces one explicitly identified direct Input child with the standard search presentation. */
-export declare function adoptPiModalSearchInput(container: Container, input: Component): PiModalSearchInput;
+export declare function adoptPiModalSearchInput(container: Container, input: Component): Component & Focusable;
 /** Adds one standard dialog-search presentation while callers retain the Input controller. */
-export declare function addPiModalSearchInput(container: Container, input: Input): PiModalSearchInput;
+export declare function addPiModalSearchInput(container: Container, input: Input): Component & Focusable;
 /** Adds the standard navigation/select/close footer before a dependency component's bottom rule. */
 export declare function addPiModalSelectFooter(container: Container): void;
-/** Owned cancellable operation frame with the canonical dialog close guidance. */
-export declare class PiCancellableOperationFrame extends Container {
-    #private;
-    constructor(tui: TUI, message: string);
-    get signal(): AbortSignal;
-    handleInput(data: string): void;
-    dispose(): void;
-}
 /** The semantic top rule/title pair used while a modal assembles its frame. */
 export declare class PiModalHeader implements Component {
     readonly rule: Component;
@@ -46,7 +28,7 @@ export declare class PiModalFrame implements Component {
 }
 /** Add compact titled-modal chrome while a component assembles its semantic body. */
 export declare function addPiModalHeader(container: Container, rule: Component, title: Component): PiModalHeader;
-export interface PiModalFrameAdoption {
+interface PiModalFrameAdoption {
     readonly topIndex: number;
     readonly bottomIndex: number;
     readonly header?: PiModalHeader;
@@ -65,3 +47,4 @@ export declare function adoptPiModalFrame(container: Container, adoption: PiModa
  * never inspected or rewritten. The pinned comparison profile does not call this adapter.
  */
 export declare function adoptPiModalHeader(container: Container, ruleIndex: number, titleIndex: number): PiModalHeader;
+export {};

package/dist/integrations/pi/components/modal-frame.js

@@ -1,7 +1,6 @@
-import { CancellableLoader, Container, Input, Spacer, Text, } from "@earendil-works/pi-tui";
+import { Container, Input, Spacer, Text, } from "@earendil-works/pi-tui";
 import { DIALOG_CONTENT_PADDING_X, dialogFrameGeometry, insetDialogContent } from "../../../contracts/presentation/index.js";
-import { DynamicBorder } from "../startup-public.js";
-import { DIALOG_CLOSE_SHORTCUT_HINT, paintPiBorder, piTheme, renderPiModalShortcutHints } from "./theme.js";
+import { DIALOG_CLOSE_SHORTCUT_HINT, piTheme, renderPiModalShortcutHints } from "./theme.js";
 export const PI_MODAL_CONTENT_PADDING_X = DIALOG_CONTENT_PADDING_X;
 /** Paints the standard Pi Input prompt as a live-themed dialog-search marker. */
 export function renderPiModalSearchInput(input, width) {
@@ -14,7 +13,7 @@ export function renderPiModalSearchInput(input, width) {
     });
 }
 /** Keeps Pi Input behavior and geometry while owning only its standard dialog-search presentation. */
-export class PiModalSearchInput {
+class PiModalSearchInput {
     #input;
     constructor(input) {
         this.#input = input;
@@ -48,25 +47,6 @@ export function addPiModalSelectFooter(container) {
         { key: "↑↓", action: "navigate" }, { key: "enter", action: "select" }, DIALOG_CLOSE_SHORTCUT_HINT,
     ]), 0, 0));
 }
-/** Owned cancellable operation frame with the canonical dialog close guidance. */
-export class PiCancellableOperationFrame extends Container {
-    #loader;
-    constructor(tui, message) {
-        super();
-        const theme = piTheme();
-        this.#loader = new CancellableLoader(tui, text => theme.fg("accent", text), text => theme.fg("muted", text), message);
-        this.addChild(new DynamicBorder(paintPiBorder));
-        this.addChild(this.#loader);
-        this.addChild(new Spacer(1));
-        this.addChild(new Text(renderPiModalShortcutHints([DIALOG_CLOSE_SHORTCUT_HINT]), 0, 0));
-        this.addChild(new Spacer(1));
-        this.addChild(new DynamicBorder(paintPiBorder));
-        adoptPiModalFrame(this, { topIndex: 0, bottomIndex: this.children.length - 1 });
-    }
-    get signal() { return this.#loader.signal; }
-    handleInput(data) { this.#loader.handleInput(data); }
-    dispose() { this.#loader.dispose(); }
-}
 /** The semantic top rule/title pair used while a modal assembles its frame. */
 export class PiModalHeader {
     rule;

package/dist/integrations/pi/components/owned-editor-ux.d.ts

@@ -7,7 +7,7 @@ import type { PiShellClipboardContent, PiShellEditorTextRange, PiShellPasteReser
  * vanilla Pi renders. This keeps owned UX additions out of the synchronized
  * Pi editor port and gives future interactions one registration point.
  */
-export interface OwnedEditorUxInterceptor {
+interface OwnedEditorUxInterceptor {
     handleInput(data: string, next: (data?: string) => void): void;
     render(width: number, next: () => string[]): string[];
     reset(): void;
@@ -18,7 +18,7 @@ export interface OwnedEditorUxInterceptor {
     pasteClipboard?(): boolean;
     cancelPendingPastes?(): void;
 }
-export interface OwnedEditorPointerEvent {
+interface OwnedEditorPointerEvent {
     readonly kind: "press" | "motion" | "release";
     readonly button: number;
     readonly column: number;
@@ -45,7 +45,7 @@ export declare class OwnedEditorUxInterception {
     ownsPointer(): boolean;
     pasteClipboard(): boolean;
 }
-export interface PromptSelectionUxOptions {
+interface PromptSelectionUxOptions {
     readonly copyText: (text: string, cut: boolean) => void;
     readonly readClipboardContent: () => Promise<PiShellClipboardContent | null>;
     readonly beginClipboardPaste?: () => PiShellPasteReservation;
@@ -77,3 +77,4 @@ export declare function createPromptSelectionInterceptor(editor: Editor, keybind
 export declare function editorInsertedText(data: string): string | undefined;
 /** Shares the existing atomic-aware body layout with prompt/menu composition. */
 export declare function editorVisualLineCount(editor: Editor, width: number): number | undefined;
+export {};