@timurproko/a1 0.1.8-dev.528 → 0.1.8-dev.544

package/dist/foundation/release/index.d.ts

@@ -21,11 +21,11 @@ export type { RestartSeal, RestartValidationEvent } from "./restart-certificatio
 export { STABLE_RELEASE_SCHEMA, createStableReleaseEvidence, verifyStableRegistry } from "./stable-release.js";
 export type { StableRegistryState, StableRegistryVerificationOptions, StableReleaseEvidence, StableReleaseEvidenceInput } from "./stable-release.js";
 export { PRODUCT_PACKAGE, assertUpdatePerformanceBudget, createNpmProcessRunner, createUpdateLifecycleCoordinator, planUpdateOwnership, renderUpdateProgressBar, runSelfUpdate, } from "./update.js";
-export type { ProcessRequest, ProcessResult, SelfUpdateOptions, UpdateActivationPhase, UpdateChannel, UpdateFileSystem, UpdateLifecycleCoordinator, UpdateMaterializationProgress, UpdateMeasuredPhase, UpdateOutput, UpdateOwnershipAction, UpdatePackageReplacementInput, UpdatePerformanceEvidence, UpdatePhaseTimingEvent, UpdateProcessRunner, UpdateTransactionJournal, } from "./update.js";
+export type { ProcessRequest, ProcessResult, SelfUpdateOptions, UpdateActivationPhase, UpdateChannel, UpdateFileMetadata, UpdateFileSystem, UpdateLifecycleCoordinator, UpdateMaterializationProgress, UpdateMeasuredPhase, UpdateOutput, UpdateOwnershipAction, UpdatePackageReplacementInput, UpdatePerformanceEvidence, UpdatePhaseTimingEvent, UpdateProcessRunner, UpdateTransactionJournal, } from "./update.js";
 export { UPDATE_ACTIVATION_CONTRACT, UPDATE_ACTIVATION_ENTRY, UPDATE_ACTIVATION_MANIFEST_FIELD, activateInstalledRelease, delegateActivation, readActivationContracts, runActivationEntry, } from "./update-activation.js";
 export type { UpdateActivationCallbacks, UpdateActivationEvent, UpdateActivationRequest } from "./update-activation.js";
 export { selectSupervisorLaunchReleaseId, selectUpdateLaunchRelease } from "./update-launch.js";
-export { UPDATE_RECOVERY_SCHEMA, cleanupUpdateRecoveryCapsules, inspectUpdateLauncherSet, prepareUpdateRecoveryCapsule, readUpdateRecoveryCapsule, removeUpdateRecoveryCapsule, runProtectedPackageReplacement, updateLauncherPaths, } from "./update-recovery.js";
+export { UPDATE_RECOVERY_SCHEMA, cleanupUpdateRecoveryCapsules, inspectUpdateLauncherSet, npmPrefixForGlobalRoot, prepareUpdateRecoveryCapsule, readUpdateRecoveryCapsule, removeUpdateRecoveryCapsule, runProtectedPackageReplacement, updateLauncherPaths, updateNpmInstallArguments, } from "./update-recovery.js";
 export type { ProtectedPackageReplacementOptions, ProtectedPackageReplacementResult, UpdateRecoveryCapsule, UpdateRecoveryResult } from "./update-recovery.js";
 export { UPDATE_JOURNAL_SCHEMA, UpdateTransactionStore } from "./update-transaction.js";
 export type { UpdateRecoveryState, UpdateTransaction, UpdateTransactionPhase } from "./update-transaction.js";

package/dist/foundation/release/index.js

@@ -12,6 +12,6 @@ export { STABLE_RELEASE_SCHEMA, createStableReleaseEvidence, verifyStableRegistr
 export { PRODUCT_PACKAGE, assertUpdatePerformanceBudget, createNpmProcessRunner, createUpdateLifecycleCoordinator, planUpdateOwnership, renderUpdateProgressBar, runSelfUpdate, } from "./update.js";
 export { UPDATE_ACTIVATION_CONTRACT, UPDATE_ACTIVATION_ENTRY, UPDATE_ACTIVATION_MANIFEST_FIELD, activateInstalledRelease, delegateActivation, readActivationContracts, runActivationEntry, } from "./update-activation.js";
 export { selectSupervisorLaunchReleaseId, selectUpdateLaunchRelease } from "./update-launch.js";
-export { UPDATE_RECOVERY_SCHEMA, cleanupUpdateRecoveryCapsules, inspectUpdateLauncherSet, prepareUpdateRecoveryCapsule, readUpdateRecoveryCapsule, removeUpdateRecoveryCapsule, runProtectedPackageReplacement, updateLauncherPaths, } from "./update-recovery.js";
+export { UPDATE_RECOVERY_SCHEMA, cleanupUpdateRecoveryCapsules, inspectUpdateLauncherSet, npmPrefixForGlobalRoot, prepareUpdateRecoveryCapsule, readUpdateRecoveryCapsule, removeUpdateRecoveryCapsule, runProtectedPackageReplacement, updateLauncherPaths, updateNpmInstallArguments, } from "./update-recovery.js";
 export { UPDATE_JOURNAL_SCHEMA, UpdateTransactionStore } from "./update-transaction.js";
 export { warmMaterializedRelease } from "./warmup.js";

package/dist/foundation/release/update-recovery.d.ts

@@ -39,6 +39,8 @@ export interface UpdateRecoveryResult {
 export interface ProtectedPackageReplacementOptions {
     readonly dataDir: string;
     readonly globalRoot: string;
+    /** Root used only to locate the active npm implementation; installation remains pinned to globalRoot. */
+    readonly npmCliRoot?: string;
     readonly packageRoot: string;
     readonly transaction: UpdateTransaction;
     readonly priorRelease: {
@@ -58,7 +60,11 @@ export interface ProtectedPackageReplacementOptions {
 export interface ProtectedPackageReplacementResult extends UpdateRecoveryResult {
     readonly recovery: UpdateRecoveryState;
 }
-/** Resolve the complete public launcher set npm owns for the active platform. */
+/** Derive the only npm prefix that can own a platform's canonical global package root. */
+export declare function npmPrefixForGlobalRoot(globalRoot: string, platform?: NodeJS.Platform): string;
+/** Fixed replacement arguments pin npm to the installation that owns the invoked launcher. */
+export declare function updateNpmInstallArguments(globalRoot: string, targetVersion: string, platform?: NodeJS.Platform): readonly string[];
+/** Resolve the complete public launcher set npm owns for the selected platform and prefix. */
 export declare function updateLauncherPaths(globalRoot: string, platform?: NodeJS.Platform): readonly string[];
 /** Validate transaction-scoped recovery authority without trusting npm temporary names. */
 export declare function readUpdateRecoveryCapsule(manifestPath: string, platform?: NodeJS.Platform): Promise<UpdateRecoveryCapsule>;

package/dist/foundation/release/update-recovery.js

@@ -1,7 +1,7 @@
 import { createHash, randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
 import { chmod, lstat, mkdir, open, readFile, readdir, realpath, rename, rm, writeFile } from "node:fs/promises";
-import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
+import { basename, dirname, isAbsolute, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { PRODUCT_IDENTITY, PRODUCT_TEXT } from "../../product-identity.js";
 import { processIsAlive } from "./process-cleanup.js";
@@ -9,9 +9,29 @@ import { PRIVATE_LAUNCH_CONTRACT, assertCurrentLaunchContract } from "../launch-
 export const UPDATE_RECOVERY_SCHEMA = "a1-update-recovery-v1";
 const WORKER_TIMEOUT_MS = 15 * 60 * 1_000;
 const POLL_MS = 50;
-/** Resolve the complete public launcher set npm owns for the active platform. */
+/** Derive the only npm prefix that can own a platform's canonical global package root. */
+export function npmPrefixForGlobalRoot(globalRoot, platform = process.platform) {
+    const root = resolve(globalRoot);
+    if (!sameSegment(basename(root), "node_modules", platform))
+        throw new Error(`npm global root has an unsupported layout: ${globalRoot}`);
+    if (platform === "win32")
+        return dirname(root);
+    const libraryRoot = dirname(root);
+    if (!sameSegment(basename(libraryRoot), "lib", platform))
+        throw new Error(`npm global root has an unsupported layout: ${globalRoot}`);
+    return dirname(libraryRoot);
+}
+/** Fixed replacement arguments pin npm to the installation that owns the invoked launcher. */
+export function updateNpmInstallArguments(globalRoot, targetVersion, platform = process.platform) {
+    return [
+        "install", "--global", "--prefix", npmPrefixForGlobalRoot(globalRoot, platform),
+        "--loglevel=error", "--no-fund", "--no-audit", `${PRODUCT_TEXT.packageName}@${targetVersion}`,
+    ];
+}
+/** Resolve the complete public launcher set npm owns for the selected platform and prefix. */
 export function updateLauncherPaths(globalRoot, platform = process.platform) {
-    const launcherRoot = platform === "win32" ? dirname(globalRoot) : resolve(globalRoot, "..", "..", "bin");
+    const prefix = npmPrefixForGlobalRoot(globalRoot, platform);
+    const launcherRoot = platform === "win32" ? prefix : resolve(prefix, "bin");
     return platform === "win32"
         ? [resolve(launcherRoot, "a1"), resolve(launcherRoot, "a1.cmd"), resolve(launcherRoot, "a1.ps1")]
         : [resolve(launcherRoot, "a1")];
@@ -33,9 +53,11 @@ export async function readUpdateRecoveryCapsule(manifestPath, platform = process
     const expectedPackage = resolve(canonicalGlobal, ...capsule.packageName.split("/"));
     if (!samePath(canonicalPackage, expectedPackage) || !containedBy(canonicalGlobal, canonicalPackage))
         throw new Error("recovery package root is outside npm global root");
-    const expectedNpmArguments = ["install", "--global", "--loglevel=error", "--no-fund", "--no-audit", `${capsule.packageName}@${capsule.targetVersion}`];
-    if (JSON.stringify(capsule.npmArguments) !== JSON.stringify(expectedNpmArguments))
-        throw new Error("recovery npm arguments differ from the selected target");
+    const expectedNpmArguments = updateNpmInstallArguments(canonicalGlobal, capsule.targetVersion, platform);
+    const legacyNpmArguments = ["install", "--global", "--loglevel=error", "--no-fund", "--no-audit", `${capsule.packageName}@${capsule.targetVersion}`];
+    if (![expectedNpmArguments, legacyNpmArguments].some(arguments_ => sameArguments(capsule.npmArguments, arguments_))) {
+        throw new Error("recovery npm arguments differ from the selected target and prefix");
+    }
     const expectedLaunchers = updateLauncherPaths(canonicalGlobal, platform);
     if (JSON.stringify(capsule.launchers.map(path => resolve(path))) !== JSON.stringify(expectedLaunchers.map(path => resolve(path)))) {
         throw new Error("recovery launcher set differs from the canonical npm launcher set");
@@ -94,8 +116,10 @@ export async function prepareUpdateRecoveryCapsule(options) {
         await chmod(candidateEntry, 0o500);
         const canonicalGlobal = await realpath(options.globalRoot);
         const platform = options.platform ?? process.platform;
-        const launcherRoot = platform === "win32" ? dirname(canonicalGlobal) : resolve(canonicalGlobal, "..", "..", "bin");
-        const npmCli = await resolveNpmCli(canonicalGlobal, options.environment ?? process.env);
+        const prefix = npmPrefixForGlobalRoot(canonicalGlobal, platform);
+        const launcherRoot = platform === "win32" ? prefix : resolve(prefix, "bin");
+        const npmCliRoot = await realpath(options.npmCliRoot ?? canonicalGlobal);
+        const npmCli = await resolveNpmCli(npmCliRoot, options.environment ?? process.env);
         const capsule = {
             schema: UPDATE_RECOVERY_SCHEMA,
             launchContract: PRIVATE_LAUNCH_CONTRACT,
@@ -114,7 +138,7 @@ export async function prepareUpdateRecoveryCapsule(options) {
             recoveryEntryDigest: createHash("sha256").update(entryBytes).digest("hex"),
             nodeExecutable: process.execPath,
             npmCli,
-            npmArguments: ["install", "--global", "--loglevel=error", "--no-fund", "--no-audit", `${PRODUCT_TEXT.packageName}@${options.transaction.targetVersion}`],
+            npmArguments: updateNpmInstallArguments(canonicalGlobal, options.transaction.targetVersion, platform),
             cancellationPath: resolve(finalRoot, "cancel.json"),
             resultPath: resolve(finalRoot, "result.json"),
             ownerPath: resolve(finalRoot, "owner.json"),
@@ -341,6 +365,12 @@ async function readJson(path) { return JSON.parse(await readFile(path, "utf8"));
 function samePath(left, right) {
     return process.platform === "win32" ? resolve(left).toLowerCase() === resolve(right).toLowerCase() : resolve(left) === resolve(right);
 }
+function sameSegment(left, right, platform) {
+    return platform === "win32" ? left.toLowerCase() === right.toLowerCase() : left === right;
+}
+function sameArguments(left, right) {
+    return left.length === right.length && left.every((value, index) => value === right[index]);
+}
 function containedBy(parent, child) {
     const fromParent = relative(parent, child);
     return fromParent.length > 0 && fromParent !== ".." && !fromParent.startsWith(`..${sep}`) && !isAbsolute(fromParent);

package/dist/foundation/release/update.d.ts

@@ -13,9 +13,15 @@ export interface ProcessResult {
     stderr?: string;
 }
 export type UpdateProcessRunner = (command: string, arguments_: readonly string[], request: ProcessRequest) => Promise<ProcessResult>;
+export interface UpdateFileMetadata {
+    readonly mode: number;
+    isFile(): boolean;
+    isSymbolicLink(): boolean;
+}
 export interface UpdateFileSystem {
     readFile(path: string): Promise<string>;
     realpath(path: string): Promise<string>;
+    lstat?(path: string): Promise<UpdateFileMetadata>;
     access?(path: string): Promise<void>;
 }
 export interface UpdateOutput {
@@ -85,6 +91,7 @@ export interface UpdateTransactionJournal {
 export interface UpdatePackageReplacementInput {
     readonly dataDir: string;
     readonly globalRoot: string;
+    readonly npmCliRoot: string;
     readonly packageRoot: string;
     readonly transaction: UpdateTransaction;
     readonly priorRelease: {

package/dist/foundation/release/update.js

@@ -1,7 +1,7 @@
 import { spawn } from "node:child_process";
-import { access, readFile, realpath } from "node:fs/promises";
+import { access, lstat, readFile, realpath } from "node:fs/promises";
 import { connect } from "node:net";
-import { isAbsolute, relative, resolve, sep } from "node:path";
+import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
 import crossSpawn from "cross-spawn";
 import { valid as validSemver } from "semver";
 import { PRODUCT_IDENTITY, PRODUCT_TEXT } from "../../product-identity.js";
@@ -15,12 +15,13 @@ import { materializeRelease, readMaterializedRelease } from "./release-store.js"
 import { scheduleReleaseCleanup } from "./release-gc.js";
 import { UPDATE_ACTIVATION_CONTRACT, activateInstalledRelease, delegateActivation, readActivationContracts, } from "./update-activation.js";
 import { UpdateTransactionStore } from "./update-transaction.js";
-import { removeUpdateRecoveryCapsule, runProtectedPackageReplacement } from "./update-recovery.js";
+import { npmPrefixForGlobalRoot, removeUpdateRecoveryCapsule, runProtectedPackageReplacement, updateLauncherPaths, updateNpmInstallArguments, } from "./update-recovery.js";
 export const PRODUCT_PACKAGE = PRODUCT_TEXT.packageName;
 const UPDATE_DIST_TAGS = { stable: "latest", next: "next" };
 const defaultFileSystem = {
     async readFile(path) { return await readFile(path, "utf8"); },
     realpath,
+    lstat,
     access,
 };
 const defaultOutput = {
@@ -308,6 +309,106 @@ async function resolveRequestedPreview(runner, requested, output) {
     output.stderr(`${PRODUCT_TEXT.diagnostic(`published no preview for ${requested}.`)}\n`);
     return { version: null, exitCode: 1 };
 }
+async function resolveManagedNpmInstallation(requestedPackageRoot, fileSystem, runner, output) {
+    const rootLookup = await runNpm(runner, ["root", "--global"], true, output, "resolve npm's global package root");
+    if (rootLookup.result === null)
+        return { installation: null, exitCode: rootLookup.exitCode };
+    const activeRootText = rootLookup.result.stdout.trim();
+    if (activeRootText.length === 0) {
+        output.stderr(`${PRODUCT_TEXT.diagnostic("could not verify its installation because npm returned an empty global package root.")}\n`);
+        return { installation: null, exitCode: 1 };
+    }
+    let packageRoot;
+    let activeGlobalRoot;
+    try {
+        [packageRoot, activeGlobalRoot] = await Promise.all([fileSystem.realpath(requestedPackageRoot), fileSystem.realpath(activeRootText)]);
+    }
+    catch (error) {
+        output.stderr(`${PRODUCT_TEXT.diagnostic(`could not canonicalize the running and global npm paths: ${errorMessage(error)}`)}\n`);
+        return { installation: null, exitCode: 1 };
+    }
+    const expectedActivePackage = resolve(activeGlobalRoot, ...PRODUCT_PACKAGE.split("/"));
+    if (samePath(packageRoot, expectedActivePackage)) {
+        try {
+            npmPrefixForGlobalRoot(activeGlobalRoot);
+            return {
+                installation: {
+                    packageRoot,
+                    globalRoot: activeGlobalRoot,
+                    npmCliRoot: activeGlobalRoot,
+                },
+                exitCode: 0,
+            };
+        }
+        catch (error) {
+            output.stderr(`${PRODUCT_TEXT.diagnostic(`could not verify npm's active global package layout: ${errorMessage(error)}`)}\n`);
+            return { installation: null, exitCode: 1 };
+        }
+    }
+    let candidateGlobalRoot = packageRoot;
+    for (const _segment of PRODUCT_PACKAGE.split("/"))
+        candidateGlobalRoot = dirname(candidateGlobalRoot);
+    let candidatePrefix;
+    try {
+        candidatePrefix = npmPrefixForGlobalRoot(candidateGlobalRoot);
+    }
+    catch {
+        reportUnmanagedInstallation(output, packageRoot, activeGlobalRoot);
+        return { installation: null, exitCode: 1 };
+    }
+    if (!samePath(packageRoot, resolve(candidateGlobalRoot, ...PRODUCT_PACKAGE.split("/")))) {
+        reportUnmanagedInstallation(output, packageRoot, activeGlobalRoot);
+        return { installation: null, exitCode: 1 };
+    }
+    const confirmation = await runNpm(runner, ["root", "--global", "--prefix", candidatePrefix], true, output, "confirm npm ownership of the running installation");
+    if (confirmation.result === null)
+        return { installation: null, exitCode: confirmation.exitCode };
+    const confirmedRootText = confirmation.result.stdout.trim();
+    if (confirmedRootText.length === 0) {
+        output.stderr(`${PRODUCT_TEXT.diagnostic("could not verify its installation because npm returned an empty global package root for the inferred prefix.")}\n`);
+        return { installation: null, exitCode: 1 };
+    }
+    let confirmedRoot;
+    try {
+        confirmedRoot = await fileSystem.realpath(confirmedRootText);
+    }
+    catch (error) {
+        output.stderr(`${PRODUCT_TEXT.diagnostic(`could not canonicalize npm's confirmed global package root: ${errorMessage(error)}`)}\n`);
+        return { installation: null, exitCode: 1 };
+    }
+    if (!samePath(confirmedRoot, candidateGlobalRoot)
+        || !await launchersOwnPackage(candidateGlobalRoot, fileSystem)) {
+        reportUnmanagedInstallation(output, packageRoot, activeGlobalRoot);
+        return { installation: null, exitCode: 1 };
+    }
+    return {
+        installation: {
+            packageRoot,
+            globalRoot: candidateGlobalRoot,
+            npmCliRoot: activeGlobalRoot,
+        },
+        exitCode: 0,
+    };
+}
+async function launchersOwnPackage(globalRoot, fileSystem) {
+    const token = `node_modules/${PRODUCT_PACKAGE}/bin/cli.js`;
+    try {
+        for (const launcher of updateLauncherPaths(globalRoot)) {
+            const metadata = await (fileSystem.lstat ?? lstat)(launcher);
+            if (!metadata.isFile() || metadata.isSymbolicLink() || (process.platform !== "win32" && (metadata.mode & 0o111) === 0))
+                return false;
+            if (!(await fileSystem.readFile(launcher)).replaceAll("\\", "/").includes(token))
+                return false;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function reportUnmanagedInstallation(output, packageRoot, activeGlobalRoot) {
+    output.stderr(`${PRODUCT_TEXT.diagnostic(`refused to update automatically because ${packageRoot} could not be verified as an npm-managed ${PRODUCT_PACKAGE} installation; npm's active global package root is ${activeGlobalRoot}. Run npm install --global ${PRODUCT_PACKAGE} to install it manually.`)}\n`);
+}
 export async function runSelfUpdate(options) {
     const fileSystem = options.fileSystem ?? defaultFileSystem;
     const output = options.output ?? defaultOutput;
@@ -328,6 +429,8 @@ export async function runSelfUpdate(options) {
     try {
         const packageJson = JSON.parse(await measure("package-version", async () => await fileSystem.readFile(resolve(options.packageRoot, "package.json"))));
         const parsedVersion = typeof packageJson.version === "string" ? validSemver(packageJson.version) : null;
+        if (packageJson.name !== PRODUCT_PACKAGE)
+            throw new Error(`package.json does not identify ${PRODUCT_PACKAGE}`);
         if (parsedVersion === null)
             throw new Error("package.json does not contain a valid semantic version");
         runningVersion = parsedVersion;
@@ -347,26 +450,10 @@ export async function runSelfUpdate(options) {
     // and a trailing one reads as part of the version rather than as punctuation.
     output.stdout(`${PRODUCT_TEXT.commandName} update: ${runningVersion} → ${targetVersion}\n`);
     const progress = createUpdateProgress(output, options.progress ?? (options.output === undefined && process.stdout.isTTY === true));
-    const rootLookup = await measure("global-root", async () => await runNpm(runner, ["root", "--global"], true, output, "resolve npm's global package root"));
-    if (rootLookup.result === null)
-        return rootLookup.exitCode;
-    if (rootLookup.result.stdout.trim().length === 0) {
-        output.stderr(`${PRODUCT_TEXT.diagnostic("could not verify its installation because npm returned an empty global package root.")}\n`);
-        return 1;
-    }
-    let packageRoot;
-    let globalRoot;
-    try {
-        [packageRoot, globalRoot] = await Promise.all([fileSystem.realpath(options.packageRoot), fileSystem.realpath(rootLookup.result.stdout.trim())]);
-    }
-    catch (error) {
-        output.stderr(`${PRODUCT_TEXT.diagnostic(`could not canonicalize the running and global npm paths: ${errorMessage(error)}`)}\n`);
-        return 1;
-    }
-    if (!isContainedBy(globalRoot, packageRoot)) {
-        output.stderr(`${PRODUCT_TEXT.diagnostic(`refused to update automatically because ${packageRoot} is not managed beneath npm's global package root ${globalRoot}.`)}\n`);
-        return 1;
-    }
+    const managed = await measure("global-root", async () => await resolveManagedNpmInstallation(options.packageRoot, fileSystem, runner, output));
+    if (managed.installation === null)
+        return managed.exitCode;
+    const { packageRoot, globalRoot, npmCliRoot } = managed.installation;
     const environment = options.environment ?? process.env;
     const paths = resolveProductPaths(environment);
     const lifecycle = options.lifecycle ?? createUpdateLifecycleCoordinator(environment, fileSystem, output);
@@ -427,6 +514,7 @@ export async function runSelfUpdate(options) {
                 const replacement = await measure("npm-install", async () => await (options.packageReplacement ?? runProtectedPackageReplacement)({
                     dataDir: paths.dataDir,
                     globalRoot,
+                    npmCliRoot,
                     packageRoot,
                     transaction: replacementTransaction,
                     priorRelease,
@@ -453,7 +541,7 @@ export async function runSelfUpdate(options) {
                 }
             }
             else {
-                const installation = await measure("npm-install", async () => await runNpm(runner, ["install", "--global", "--loglevel=error", "--no-fund", "--no-audit", `${PRODUCT_PACKAGE}@${targetVersion}`], true, output, "start the global npm installation", false));
+                const installation = await measure("npm-install", async () => await runNpm(runner, updateNpmInstallArguments(globalRoot, targetVersion), true, output, "start the global npm installation", false));
                 if (installation.result === null)
                     throw new UpdateFailure(installation.exitCode, "npm process failed");
                 if (installation.result.code !== 0) {
@@ -624,6 +712,9 @@ async function canonicalImmutableRoot(dataDir, releaseRoot) {
         return false;
     }
 }
+function samePath(left, right) {
+    return process.platform === "win32" ? resolve(left).toLowerCase() === resolve(right).toLowerCase() : resolve(left) === resolve(right);
+}
 function isContainedBy(parent, child) {
     const pathFromParent = relative(parent, child);
     return pathFromParent.length > 0 && pathFromParent !== ".." && !pathFromParent.startsWith(`..${sep}`) && !isAbsolute(pathFromParent);

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

@@ -10,7 +10,7 @@ export const STARTUP_DESCRIPTOR = Object.freeze({
   ],
   "generatedArtifact": {
     "path": "dist/integrations/pi/startup-public.js",
-    "sha256": "2e2d8f9a19e4c8546f9fe48c940ee369b386fcb393d615b7c41023d6c9cdd001"
+    "sha256": "fdd81188cf24be1f187fdcc18d131e7432b114c2094dc51543ef27edbe99b23c"
   },
   "dependencyLayerIdentity": {
     "source": "A1_RELEASE_LAYERS",
@@ -19,7 +19,7 @@ export const STARTUP_DESCRIPTOR = Object.freeze({
   "compileCacheNamespace": {
     "strategy": "node-abi-version-and-ordered-layer-sha256-v1"
   },
-  "identity": "faaa1fcd4379153d81e962bdc003e44bc81a93a91fbd851341dc2dc498dd8b96"
+  "identity": "4bf2be3027c6230ec34cfd8dab3df61030de6715ed1f1e9e9dd1fb83edba8522"
 });
 
 export function loadDeclaredStartupGraph() {

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

@@ -2,7 +2,9 @@ export { adaptPiAssistantMessage, adaptPiToolExecution, adaptPiUserMessage } fro
 export { loadHistoryEditor, type HistoryEditorConstructor } from "./history-editor-loader.js";
 export { PiComponentConformanceError, runPiComponentConformance } from "./conformance.js";
 export type { PiComponentConformanceReport, PiComponentConformanceResult } from "./conformance.js";
-export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellThinkingSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
+export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.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, PiShellEditorPort, PiShellEditorTextRange, PiShellExtensionRendererResolver, PiShellHeaderOptions, PiShellHeaderPort, PiShellHotkeysPresentation, PiShellImageAssetResolver, PiShellLoadedResourcesPort, PiShellLoginDialogPort, PiShellModelSelectorOptions, PiShellModelsDialogOptions, PiShellModelsDialogPort, PiShellOperationLoaderPort, 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, currentPiThemeName, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piTheme, resolvePiThemeSetting, stopPiThemeWatcher, } from "./theme.js";
 export type { PiColorMode, PiTerminalTheme, PiTerminalThemeDetection, PiTerminalThemeDetector, PiThemeBackground, PiThemeResult } from "./theme.js";

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

@@ -1,7 +1,8 @@
 export { adaptPiAssistantMessage, adaptPiToolExecution, adaptPiUserMessage } from "./components.js";
 export { loadHistoryEditor } from "./history-editor-loader.js";
 export { PiComponentConformanceError, runPiComponentConformance } from "./conformance.js";
-export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellThinkingSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
+export { OWNED_BUILTIN_SLASH_COMMANDS, PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellSkillsSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellChangelogLines, renderPiShellCommandMessage, renderPiShellHotkeysLines, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
+export { renderPiShellHotkeySections } from "./shell-hotkey-sections.js";
 export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeInstance, currentPiThemeName, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piTheme, resolvePiThemeSetting, stopPiThemeWatcher, } from "./theme.js";
 export { OwnedPiThemeController } from "./upstream/theme/theme-controller.js";
 export { ModelsDialogComponent } from "./models-dialog.js";

package/dist/integrations/pi/components/shell-editor-autocomplete.d.ts

@@ -1,5 +1,9 @@
 import { type PiShellEditorPort, type PiShellEditorOptions } from "./shell-shared-facade.js";
 export declare const PINNED_PI_BUILTIN_SLASH_COMMANDS: ({
+    readonly name: "thinking";
+    readonly description: "Set thinking level";
+    readonly argumentHint: "<level>";
+} | {
     name: string;
     description: string;
     argumentHint?: never;
@@ -8,8 +12,12 @@ export declare const PINNED_PI_BUILTIN_SLASH_COMMANDS: ({
     description: string;
     argumentHint: string;
 })[];
-/** Bare A1's built-in catalog: one `models` command replaces the pinned `model` and `scoped-models` entries. */
+/** Bare A1's built-in catalog: `models` replaces the pinned pair and is followed by `thinking`. */
 export declare const OWNED_BUILTIN_SLASH_COMMANDS: ({
+    readonly name: "thinking";
+    readonly description: "Set thinking level";
+    readonly argumentHint: "<level>";
+} | {
     name: string;
     description: string;
     argumentHint?: never;

package/dist/integrations/pi/components/shell-editor-autocomplete.js

@@ -7,13 +7,14 @@ import { OwnedEditorUxInterception, createPromptSelectionInterceptor, editorVisu
 import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
 import { createTuiFacade, ensureTheme, isAutocompleteProvider, } from "./shell-shared-facade.js";
 import { SKILLS_COMMAND_NAME, collapseSkillCommands, createSkillsTunnelProvider, } from "./skills-command.js";
-/** A selected tunnel row: the accent label, then at least two spaces, then the description. */
-const SELECTED_TUNNEL_ROW = /^(→ skills:\S+)(\s{2,}.*)$/u;
+/** A selected autocomplete row: the accent primary column, then the aligned description. */
+const SELECTED_DESCRIBED_ROW = /^(→ .*?\S)(\s{2,}.*)$/u;
+const THINKING_SLASH_COMMAND = { name: "thinking", description: "Set thinking level", argumentHint: "<level>" };
 export const PINNED_PI_BUILTIN_SLASH_COMMANDS = [
     { name: "settings", description: "Open settings menu" },
     { name: "model", description: "Select model (opens selector UI)", argumentHint: "<provider/model>" },
     { name: "tree", description: "Navigate session tree (switch branches)" },
-    { name: "thinking", description: "Set thinking level", argumentHint: "<level>" },
+    THINKING_SLASH_COMMAND,
     { name: "scoped-models", description: "Enable/disable models for Ctrl+P cycling" },
     { name: "export", description: "Export session (HTML default, or specify path: .html/.jsonl)" },
     { name: "import", description: "Import and resume a session from a JSONL file" },
@@ -34,10 +35,10 @@ export const PINNED_PI_BUILTIN_SLASH_COMMANDS = [
     { name: "reload", description: "Reload keybindings, extensions, skills, prompts, themes, and context files" },
     { name: "quit", description: "Quit" },
 ];
-/** Bare A1's built-in catalog: one `models` command replaces the pinned `model` and `scoped-models` entries. */
+/** Bare A1's built-in catalog: `models` replaces the pinned pair and is followed by `thinking`. */
 export const OWNED_BUILTIN_SLASH_COMMANDS = PINNED_PI_BUILTIN_SLASH_COMMANDS.flatMap(command => command.name === "model"
-    ? [{ name: "models", description: "Switch models and manage scoped model cycling" }]
-    : command.name === "scoped-models" ? [] : [command]);
+    ? [{ name: "models", description: "Switch models and manage scoped model cycling" }, THINKING_SLASH_COMMAND]
+    : command.name === "thinking" || command.name === "scoped-models" ? [] : [command]);
 export function createPiShellEditor(options) {
     ensureTheme();
     const tui = createTuiFacade(options);
@@ -64,9 +65,9 @@ export function createPiShellEditor(options) {
                 return selectListTheme.scrollInfo(text);
             },
             selectedText: text => {
-                // Rationale: a selected tunnel row keeps its description muted like the unselected rows (v2 behavior);
-                // the pinned list styles the whole selected row, so the split happens in the owned theme.
-                const row = tunnelSkills.length === 0 ? null : SELECTED_TUNNEL_ROW.exec(text);
+                // Rationale: the pinned list styles a whole selected row at once. Bare A1 keeps the
+                // actionable primary column accented while every aligned description remains muted.
+                const row = SELECTED_DESCRIBED_ROW.exec(text);
                 return row === null ? selectListTheme.selectedText(text) : selectListTheme.selectedText(row[1]) + selectListTheme.description(row[2]);
             },
         },

package/dist/integrations/pi/components/shell-footer-status.d.ts

@@ -3,5 +3,5 @@ import { type PiShellViewComponentPort, type PiShellStatusPort, type PiShellQueu
 export declare function createPiShellHeader(options?: PiShellHeaderOptions): PiShellHeaderPort;
 export declare function createPiShellLoadedResources(resources: readonly PiShellResourceEntry[], initialExpanded?: boolean): PiShellLoadedResourcesPort;
 export declare function createPiShellStatus(view: OwnedUiSessionViewModel, formatProgressStatus: (message: string) => string, runtime?: Pick<PiShellEditorOptions, "getColumns" | "getRows" | "requestRender">): PiShellStatusPort;
-export declare function createPiShellFooter(view: OwnedUiSessionViewModel, cwd: string, profile?: "pi" | "a1"): PiShellViewComponentPort;
+export declare function createPiShellFooter(view: OwnedUiSessionViewModel, cwd: string, profile?: "pi" | "a1", showLevel?: () => boolean): PiShellViewComponentPort;
 export declare function createPiQueuedInputStatus(submissions: readonly string[], presentation?: "pinned" | "custom-viewport"): PiShellQueuedInputPort;

package/dist/integrations/pi/components/shell-footer-status.js

@@ -128,9 +128,9 @@ export function createPiShellStatus(view, formatProgressStatus, runtime) {
         },
     };
 }
-export function createPiShellFooter(view, cwd, profile = "pi") {
+export function createPiShellFooter(view, cwd, profile = "pi", showLevel = () => true) {
     ensureTheme();
-    const footer = new SessionFooter(() => view, cwd, profile);
+    const footer = new SessionFooter(() => view, cwd, profile, showLevel);
     return {
         render: width => footer.render(width),
         invalidate: () => footer.invalidate(),

package/dist/integrations/pi/components/shell-hotkey-sections.d.ts

@@ -0,0 +1,7 @@
+import { type PiShellHotkeysPresentation } from "./shell-presenters-info.js";
+export interface PiShellHotkeySection {
+    readonly title: string;
+    readonly rows: readonly string[];
+}
+/** Turns heading-led hotkeys Markdown into reusable grouped-document data before row rendering. */
+export declare function renderPiShellHotkeySections(presentation: PiShellHotkeysPresentation, width: number): readonly PiShellHotkeySection[];

package/dist/integrations/pi/components/shell-hotkey-sections.js

@@ -0,0 +1,29 @@
+import { getMarkdownTheme } from "../startup-public.js";
+import { Markdown } from "@earendil-works/pi-tui";
+import { ensureTheme } from "./shell-shared-facade.js";
+import { hotkeysMarkdown } from "./shell-presenters-info.js";
+/** Turns heading-led hotkeys Markdown into reusable grouped-document data before row rendering. */
+export function renderPiShellHotkeySections(presentation, width) {
+    ensureTheme();
+    const shortcuts = presentation.getShortcuts ?? (() => []);
+    const markdown = hotkeysMarkdown(presentation.bindings, shortcuts, presentation.profile ?? "pi");
+    const sections = [];
+    for (const line of markdown.split("\n")) {
+        const heading = /^\*\*(.+)\*\*$/.exec(line)?.[1];
+        if (heading !== undefined)
+            sections.push({ title: heading, lines: [] });
+        else
+            sections.at(-1)?.lines.push(line);
+    }
+    for (const section of sections)
+        while (section.lines.at(-1) === "")
+            section.lines.pop();
+    return sections.map(section => {
+        const rows = [...new Markdown(section.lines.join("\n"), 1, 1, getMarkdownTheme()).render(width)];
+        while (rows[0]?.trim().length === 0)
+            rows.shift();
+        while (rows.at(-1)?.trim().length === 0)
+            rows.pop();
+        return { title: section.title, rows };
+    });
+}

package/dist/integrations/pi/components/shell-presenters-info.d.ts

@@ -70,3 +70,4 @@ export interface PiShellHotkeysPresentation {
 export declare function createPiShellHotkeys(bindings?: KeybindingsConfig, getShortcuts?: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile?: "pi" | "a1"): PiShellComponentPort;
 /** The keyboard-shortcut document rows the feed presenter shows, without its spacer, borders, and heading. */
 export declare function renderPiShellHotkeysLines(presentation: PiShellHotkeysPresentation, width: number): readonly string[];
+export declare function hotkeysMarkdown(bindings: KeybindingsConfig | undefined, getShortcuts: NonNullable<PiShellExtensionRendererResolver["getShortcuts"]>, profile: "pi" | "a1"): string;

package/dist/integrations/pi/components/shell-presenters-info.js

@@ -166,7 +166,7 @@ export function renderPiShellHotkeysLines(presentation, width) {
 function hotkeysMarkdownComponent(markdown) {
     return new Markdown(markdown, 1, 1, getMarkdownTheme());
 }
-function hotkeysMarkdown(bindings, getShortcuts, profile) {
+export function hotkeysMarkdown(bindings, getShortcuts, profile) {
     const keys = profile === "a1" ? KeybindingsManager.fromOwnedBindings(bindings) : new KeybindingsManager(bindings);
     // Compatibility: the owned viewport consumes these physical chords before editor actions.
     const display = (action) => keys.getKeys(action)

package/dist/integrations/pi/components/shell-selectors-dialogs.d.ts

@@ -126,7 +126,6 @@ export interface PiShellAuthProviderOption extends PiShellSelectorOption {
 }
 export declare function createPiShellAuthProviderSelector(mode: "login" | "logout", providers: readonly PiShellAuthProviderOption[], onSelect: (id: string) => void, onCancel: () => void, initialSearchInput?: string): PiShellComponentPort;
 export declare function createPiShellExtensionSelector(title: string, options: readonly string[], onSelect: (value: string) => void, onCancel: () => void): PiShellComponentPort;
-export declare function createPiShellThinkingSelector(currentLevel: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max", availableLevels: readonly ("off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max")[], onSelect: (level: string) => void, onCancel: () => void, onSelectAsDefault?: (level: string) => void, defaultLevel?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max"): PiShellComponentPort;
 export declare function createPiShellThemeSelector(currentTheme: string, onSelect: (theme: string) => void, onCancel: () => void, onPreview: (theme: string) => void): PiShellComponentPort;
 export declare function createPiShellShowImagesSelector(currentValue: boolean, onSelect: (show: boolean) => void, onCancel: () => void): PiShellComponentPort;
 export declare function createPiShellDialog(dialog: OwnedUiDialog, handlers?: {

package/dist/integrations/pi/components/shell-selectors-dialogs.js

@@ -1,4 +1,4 @@
-import { ArminComponent, BorderedLoader, DynamicBorder, ExtensionSelectorComponent, getSelectListTheme, LoginDialogComponent, ModelSelectorComponent, OAuthSelectorComponent, SettingsSelectorComponent, ShowImagesSelectorComponent, ThemeSelectorComponent, ThinkingSelectorComponent, UserMessageSelectorComponent, } from "../startup-public.js";
+import { ArminComponent, BorderedLoader, DynamicBorder, ExtensionSelectorComponent, getSelectListTheme, LoginDialogComponent, ModelSelectorComponent, OAuthSelectorComponent, SettingsSelectorComponent, ShowImagesSelectorComponent, ThemeSelectorComponent, UserMessageSelectorComponent, } from "../startup-public.js";
 import { DaxnutsComponent, } from "./upstream/components/daxnuts.js";
 import { EarendilAnnouncementComponent, } from "./upstream/components/earendil-announcement.js";
 import { Box, Container, SelectList, Spacer, Text, } from "@earendil-works/pi-tui";
@@ -200,12 +200,6 @@ export function createPiShellExtensionSelector(title, options, onSelect, onCance
     ensureTheme();
     return componentPort(new ExtensionSelectorComponent(title, [...options], onSelect, onCancel));
 }
-export function createPiShellThinkingSelector(currentLevel, availableLevels, onSelect, onCancel, onSelectAsDefault, defaultLevel) {
-    ensureTheme();
-    const selector = new ThinkingSelectorComponent(currentLevel, [...availableLevels], onSelect, onCancel, onSelectAsDefault, defaultLevel);
-    const list = selector.getSelectList();
-    return componentPort(selector, data => list.handleInput(data));
-}
 export function createPiShellThemeSelector(currentTheme, onSelect, onCancel, onPreview) {
     ensureTheme();
     const selector = new ThemeSelectorComponent(currentTheme, onSelect, onCancel, onPreview);

package/dist/integrations/pi/components/thinking-selector-dialog.d.ts

@@ -0,0 +1,8 @@
+import { type ThinkingSelectorLevel } from "./upstream/components/thinking-selector.js";
+import { type PiShellComponentPort } from "./shell-shared-facade.js";
+export interface PiShellThinkingSelectorPresentation {
+    readonly profile: "bare";
+    readonly cycleBinding: string | readonly string[];
+}
+/** Lazily loaded because thinking-selector code does not belong to the startup graph before `/thinking` opens. */
+export declare function createPiShellThinkingSelector(currentLevel: ThinkingSelectorLevel, availableLevels: readonly ThinkingSelectorLevel[], onSelect: (level: string) => void, onCancel: () => void, onSelectAsDefault?: (level: string) => void, defaultLevel?: ThinkingSelectorLevel, presentation?: PiShellThinkingSelectorPresentation): PiShellComponentPort;