@timurproko/a1 0.2.7-dev.810 → 0.2.7-dev.828

package/dist/integrations/pi/components/upstream/components/session-footer.js

@@ -1,13 +1,10 @@
 /**
  * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/components/footer.ts.
- * Modifications: Consumes neutral owned-UI view data instead of a fabricated concrete AgentSession;
- * preserves the latest physical route for virtual models; an explicit bare-A1 profile colors the
- * thinking-level name, renders its repository-context path, and reserves its linked pull-request badge
- * before path truncation while preserving the remaining footer layout and formatting; replacement
- * surfaces may suppress a thinking level they already present; a resident tab whose chip already shows
- * the session name may suppress its path-row suffix.
- * Deviations: owned-status-level-color, owned-pull-request-badge, owned-resident-session-name.
+ * Modifications: Owned UI/routing; A1 level color, linked PRs, resident names, dim ellipsis and model
+ * priority; Pi unchanged.
+ * Deviations: owned-status-level-color, owned-pull-request-badge, owned-resident-session-name,
+ * owned-footer-ellipsis, owned-footer-model-priority.
  */
 import { isAbsolute, relative, resolve, sep } from "node:path";
 import { hyperlink, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
@@ -31,6 +28,7 @@ export class SessionFooter {
         const view = this.getView();
         const usage = view.status.usage;
         const theme = piTheme();
+        const dimEllipsis = theme.fg("dim", this.profile === "a1" ? "…" : "...");
         const input = usage?.input ?? 0;
         const output = usage?.output ?? 0;
         const cacheRead = usage?.cacheRead ?? 0;
@@ -38,8 +36,8 @@ export class SessionFooter {
         const cost = usage?.cost ?? 0;
         const contextWindow = usage?.contextWindow ?? 0;
         const contextPercentValue = usage?.contextPercent ?? 0;
-        const contextPercentSource = usage?.contextAvailable === false ? undefined : usage?.contextPercent;
-        const contextPercent = contextPercentSource !== null ? contextPercentValue.toFixed(1) : "?";
+        const contextPercent = usage?.contextAvailable !== false && usage?.contextPercent === null
+            ? "?" : contextPercentValue.toFixed(1);
         const repositoryPath = this.profile === "a1" ? view.status.footer?.repositoryPath ?? this.cwd : this.cwd;
         let pwd = formatCwd(repositoryPath, process.env.HOME || process.env.USERPROFILE);
         const branch = view.status.footer?.branch;
@@ -48,7 +46,7 @@ export class SessionFooter {
         const sessionName = this.showSessionName ? view.status.footer?.sessionName : null;
         const pullRequest = this.profile === "a1" ? view.status.footer?.pullRequest : null;
         let pathRow;
-        if (pullRequest === undefined || pullRequest === null) {
+        if (pullRequest == null) {
             pathRow = theme.fg("dim", sessionName ? `${pwd} • ${sessionName}` : pwd);
         }
         else {
@@ -59,12 +57,10 @@ export class SessionFooter {
             if (visibleWidth(full) <= width)
                 pathRow = full;
             else if (visibleWidth(badge) <= width) {
-                const pathWidth = Math.max(0, width - visibleWidth(badge));
-                const path = pathWidth === 0 ? "" : truncateToWidth(theme.fg("dim", pwd), pathWidth, theme.fg("dim", "..."));
-                pathRow = path + badge;
+                pathRow = truncateToWidth(theme.fg("dim", pwd), width - visibleWidth(badge), dimEllipsis) + badge;
             }
             else {
-                pathRow = truncateToWidth(badge, width, theme.fg("dim", "..."));
+                pathRow = truncateToWidth(badge, width, dimEllipsis);
             }
         }
         const parts = [];
@@ -88,7 +84,7 @@ export class SessionFooter {
         let left = parts.join(" ");
         let leftWidth = visibleWidth(left);
         if (leftWidth > width) {
-            left = truncateToWidth(left, width, "...");
+            left = truncateToWidth(left, width, this.profile === "a1" ? dimEllipsis : "...");
             leftWidth = visibleWidth(left);
         }
         const modelName = view.activeModel?.modelId ?? "no-model";
@@ -96,6 +92,7 @@ export class SessionFooter {
             ? view.activeModel === null || !this.show() ? theme.fg("dim", modelName)
                 : theme.fg("dim", `${modelName} • `) + theme.getThinkingBorderColor(view.thinkingLevel)(view.thinkingLevel)
             : view.activeModel === null || view.thinkingLevel === "off" || !this.show() ? modelName : `${modelName} • ${view.thinkingLevel}`;
+        const modelLevel = rightWithoutProvider;
         const routed = view.routedModel;
         if (routed) {
             const level = routed.thinkingLevel === undefined ? "" : ` • ${routed.thinkingLevel}`;
@@ -109,9 +106,18 @@ export class SessionFooter {
             if (leftWidth + 2 + visibleWidth(right) > width)
                 right = rightWithoutProvider;
         }
+        if (this.profile === "a1" && leftWidth + 2 + visibleWidth(right) > width) {
+            right = [rightWithoutProvider, modelLevel].find(value => visibleWidth(value) + 2 <= width)
+                ?? truncateToWidth(theme.fg("dim", modelName), width, dimEllipsis);
+            left = truncateToWidth(left, Math.max(0, width - visibleWidth(right) - 2), dimEllipsis);
+            leftWidth = visibleWidth(left);
+        }
         const rightWidth = visibleWidth(right);
         let line;
-        if (leftWidth + 2 + rightWidth <= width) {
+        if (this.profile === "a1" && leftWidth === 0) {
+            line = " ".repeat(Math.max(0, width - rightWidth)) + right;
+        }
+        else if (leftWidth + 2 + rightWidth <= width) {
             line = left + " ".repeat(width - leftWidth - rightWidth) + right;
         }
         else {
@@ -124,13 +130,13 @@ export class SessionFooter {
                 line = left;
         }
         const lines = [
-            truncateToWidth(pathRow, width, theme.fg("dim", "...")),
+            truncateToWidth(pathRow, width, dimEllipsis),
             theme.fg("dim", left) + (this.profile === "a1" ? line.slice(left.length) : theme.fg("dim", line.slice(left.length))),
         ];
         const statuses = view.status.footer?.extensionStatuses ?? [];
         if (statuses.length > 0) {
             const status = [...statuses].sort(([leftKey], [rightKey]) => leftKey.localeCompare(rightKey)).map(([, text]) => sanitize(text)).join(" ");
-            lines.push(truncateToWidth(status, width, theme.fg("dim", "...")));
+            lines.push(truncateToWidth(status, width, dimEllipsis));
         }
         return lines;
     }
@@ -150,11 +156,8 @@ function formatTokens(count) {
 function formatCwd(cwd, home) {
     if (!home)
         return cwd;
-    const resolvedCwd = resolve(cwd);
-    const resolvedHome = resolve(home);
-    const relativeToHome = relative(resolvedHome, resolvedCwd);
-    const inside = relativeToHome === "" || (relativeToHome !== ".." && !relativeToHome.startsWith(`..${sep}`) && !isAbsolute(relativeToHome));
-    if (!inside)
+    const relativeToHome = relative(resolve(home), resolve(cwd));
+    if (isAbsolute(relativeToHome) || relativeToHome === ".." || relativeToHome.startsWith(`..${sep}`))
         return cwd;
     return relativeToHome === "" ? "~" : `~${sep}${relativeToHome}`;
 }

package/dist/integrations/pi/components/upstream/components/session-selector.js

@@ -7,11 +7,12 @@
  * keybindings/theme, canonical path handling, reverse-Tab scope cycling, and the shared bare-A1 modal
  * frame with standalone title, standard outer rules, stable filter/status row, progressive result
  * paging, aligned result columns, Session Tree selection roles, quiet in-field query syntax guidance,
- * and one-line bottom dynamic feedback and searchable-dialog shortcut footer. Selected session rows
- * use the blue selection surface while preserving title and metadata foregrounds; the active session
- * title uses success green independently of keyboard selection, with ordinary text weight.
+ * an accent dialog-search marker, and one-line bottom dynamic feedback and searchable-dialog shortcut
+ * footer. Selected session rows use the blue selection surface while preserving title and metadata
+ * foregrounds; the active session title uses success green independently of keyboard selection, with
+ * ordinary text weight.
  * Deviations: owned-modal-shortcut-hints, owned-resume-session-dialog,
- * owned-standard-dialog-selection.
+ * owned-standard-dialog-selection, owned-dialog-search-marker.
  */
 import { spawnSync } from "node:child_process";
 import { existsSync, realpathSync } from "node:fs";
@@ -20,7 +21,7 @@ import * as os from "node:os";
 import { Container, getKeybindings, Input, matchesKey, sliceByColumn, Spacer, Text, truncateToWidth, visibleWidth, } from "@earendil-works/pi-tui";
 import { KeybindingsManager } from "../adjacent/core/keybindings.js";
 import { DynamicBorder } from "../../../startup-public.js";
-import { addPiModalHeader, adoptPiModalFrame } from "../../modal-frame.js";
+import { addPiModalHeader, adoptPiModalFrame, renderPiModalSearchInput } from "../../modal-frame.js";
 import { DIALOG_CLOSE_SHORTCUT_HINT, paintPiBorder, piTheme, renderPiModalShortcutHints } from "../../theme.js";
 const theme = new Proxy({}, {
     get(_target, property) {
@@ -408,7 +409,7 @@ class SessionList {
     render(width) {
         const lines = [];
         // Render search input
-        lines.push(...this.searchInput.render(width));
+        lines.push(...renderPiModalSearchInput(this.searchInput, width));
         lines.push(""); // Blank line after search
         if (this.filteredSessions.length === 0) {
             let emptyMessage;

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

@@ -8,13 +8,14 @@
  * levels, and rendering exclusive radio-style default markers before level names, an item-adjacent
  * active checkmark, and aligned muted descriptions. Bare A1 persists defaults immediately on Space,
  * closes through the implicit Ctrl+C-capable selection-cancel action, and uses the shared compact
- * semantic shortcut row with Type/search guidance without advertising that alias. All list and border
- * colors use the owned theme and its explicit color mode. Selected rows use the shared bare-A1 blue
- * selection surface only around the rendered item span, with the existing accent arrow, normal-text
- * level, and preserved current/default/description roles. The comparison profile retains the public
- * pinned component.
+ * semantic shortcut row with Type/search guidance and an accent search marker without advertising that
+ * alias. All list and border colors use the owned theme and its explicit color mode. Selected rows use
+ * the shared bare-A1 blue selection surface only around the rendered item span, with the existing
+ * accent arrow, normal-text level, and preserved current/default/description roles. The comparison
+ * profile retains the public pinned component.
  * Deviations: owned-modal-shortcut-hints, owned-level-cycle-shortcut, owned-thinking-selector-heading,
- * owned-thinking-selector-controls, owned-dialog-ctrl-c-cancel, owned-standard-dialog-selection.
+ * owned-thinking-selector-controls, owned-dialog-ctrl-c-cancel, owned-standard-dialog-selection,
+ * owned-dialog-search-marker.
  */
 import { Container, type Focusable, SelectList } from "@earendil-works/pi-tui";
 export type ThinkingSelectorLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";

package/dist/integrations/pi/components/upstream/components/thinking-selector.js

@@ -8,17 +8,18 @@
  * levels, and rendering exclusive radio-style default markers before level names, an item-adjacent
  * active checkmark, and aligned muted descriptions. Bare A1 persists defaults immediately on Space,
  * closes through the implicit Ctrl+C-capable selection-cancel action, and uses the shared compact
- * semantic shortcut row with Type/search guidance without advertising that alias. All list and border
- * colors use the owned theme and its explicit color mode. Selected rows use the shared bare-A1 blue
- * selection surface only around the rendered item span, with the existing accent arrow, normal-text
- * level, and preserved current/default/description roles. The comparison profile retains the public
- * pinned component.
+ * semantic shortcut row with Type/search guidance and an accent search marker without advertising that
+ * alias. All list and border colors use the owned theme and its explicit color mode. Selected rows use
+ * the shared bare-A1 blue selection surface only around the rendered item span, with the existing
+ * accent arrow, normal-text level, and preserved current/default/description roles. The comparison
+ * profile retains the public pinned component.
  * Deviations: owned-modal-shortcut-hints, owned-level-cycle-shortcut, owned-thinking-selector-heading,
- * owned-thinking-selector-controls, owned-dialog-ctrl-c-cancel, owned-standard-dialog-selection.
+ * owned-thinking-selector-controls, owned-dialog-ctrl-c-cancel, owned-standard-dialog-selection,
+ * owned-dialog-search-marker.
  */
 import { Container, fuzzyFilter, getKeybindings, Input, SelectList, Spacer, Text, } from "@earendil-works/pi-tui";
 import { DynamicBorder } from "../../../startup-public.js";
-import { addPiModalHeader, adoptPiModalFrame } from "../../modal-frame.js";
+import { addPiModalHeader, addPiModalSearchInput, adoptPiModalFrame } from "../../modal-frame.js";
 import { DIALOG_CLOSE_SHORTCUT_HINT, piTheme, renderPiModalListRow, renderPiModalShortcutHints } from "../../theme.js";
 const THINKING_SELECT_LIST_LAYOUT = {
     minPrimaryColumnWidth: 12,
@@ -88,7 +89,7 @@ export class OwnedThinkingSelectorComponent extends Container {
         this.addChild(new Spacer(1));
         this.searchInput = new Input();
         this.searchInput.onSubmit = () => this.selectList.handleInput("\r");
-        this.addChild(this.searchInput);
+        addPiModalSearchInput(this, this.searchInput);
         this.addChild(new Spacer(1));
         const initialList = this.buildSelectList(this.allItems, currentLevel);
         this.selectList = initialList.list;

package/dist/integrations/pi/components/upstream/components/tool-execution.js

@@ -3,13 +3,15 @@
  * packages/coding-agent/src/modes/interactive/components/tool-execution.ts.
  * Modifications: Retain pinned shell/public renderers. Own image conversion; replace private APIs with
  * public/local equivalents. Use bare-A1 secondary-accent read ranges and concise collapse shortcut
- * hints. Restore the enclosing default-shell background after nested renderer resets. See
+ * hints. Restore the enclosing default-shell background after nested renderer resets. Omit
+ * non-actionable image fallback rows when the terminal has no image protocol. See
  * docs/architecture/tool-image-presentation.md.
  * Deviations: current-tool-image-conversion-ownership, read-range-secondary-accent,
- * concise-tool-expand-shortcut-hint, default-shell-background-reset-scoping.
+ * concise-tool-expand-shortcut-hint, default-shell-background-reset-scoping,
+ * unsupported-image-fallback-omission.
  */
 import { stripVTControlCharacters } from "node:util";
-import { Box, Container, getCapabilities, getImageDimensions, imageFallback, MouseRegion, Spacer, Text } from "@earendil-works/pi-tui";
+import { Box, Container, getImageDimensions, imageFallback, MouseRegion, Spacer, Text } from "@earendil-works/pi-tui";
 import { createReadToolDefinition, createBashToolDefinition, createEditToolDefinition, createWriteToolDefinition, createGrepToolDefinition, createFindToolDefinition, createLsToolDefinition, keyHint, keyText, } from "../../../startup-public.js";
 import { renderPiModalShortcutHints } from "../../theme.js";
 import { isPiAccentProjectionEnabled, piTheme } from "../theme/theme.js";
@@ -379,7 +381,7 @@ export class ToolExecutionComponent extends Container {
         if (!this.result)
             return "";
         const text = this.result.content.filter(part => part.type === "text").map(part => stripVTControlCharacters(part.text ?? "").replace(/[\u0000-\u0008\u000b-\u001f\ufff9-\ufffb]/gu, "")).join("\n");
-        if (getCapabilities().images && this.showImages)
+        if (this.showImages)
             return text;
         const indicators = this.result.content.filter(part => part.type === "image").map(part => imageFallback(part.mimeType ?? "image/unknown", part.data && part.mimeType ? getImageDimensions(part.data, part.mimeType) ?? undefined : undefined)).join("\n");
         return text && indicators ? `${text}\n${indicators}` : text || indicators;

package/dist/integrations/pi/components/upstream/components/tree-selector.d.ts

@@ -4,15 +4,15 @@
  * Modifications: Port remaps public types/components plus owned keybindings/theme helpers while
  * preserving tree behavior; bare A1 uses compact modal chrome and label editing, four-mode
  * Models-style filter status with Tab/Shift+Tab directional cycling and concise all-first presentation
- * excluding internal bookkeeping, standard search input, blue full-row menu-arrow selection that
- * preserves per-entry semantic foregrounds and has no path bullets, accent entry labels, bracketed
- * timestamps, numeric result counters without duplicate label-time status, and a stateful time on/off
- * shortcut, semantic role colors with session naming for the system root, standard
- * paging/first-last/non-root containing-branch folding keys with a permanently expanded system session
- * entry even behind hidden metadata, single-character ellipses on both clipped edges with
- * bracket-delimiter preservation and selected-fragment highlighting, and Models-ordered semantic
+ * excluding internal bookkeeping, a standard accent-marked search input, blue full-row menu-arrow
+ * selection that preserves per-entry semantic foregrounds and has no path bullets, accent entry
+ * labels, bracketed timestamps, numeric result counters without duplicate label-time status, and a
+ * stateful time on/off shortcut, semantic role colors with session naming for the system root,
+ * standard paging/first-last/non-root containing-branch folding keys with a permanently expanded
+ * system session entry even behind hidden metadata, single-character ellipses on both clipped edges
+ * with bracket-delimiter preservation and selected-fragment highlighting, and Models-ordered semantic
  * Type/search shortcut footers without a redundant select hint.
- * Deviations: owned-modal-shortcut-hints, owned-session-tree-dialog.
+ * Deviations: owned-modal-shortcut-hints, owned-session-tree-dialog, owned-dialog-search-marker.
  */
 import { type Component, Container, type Focusable } from "@earendil-works/pi-tui";
 import { type SessionTreeNode } from "@earendil-works/pi-coding-agent";

package/dist/integrations/pi/components/upstream/components/tree-selector.js

@@ -4,20 +4,20 @@
  * Modifications: Port remaps public types/components plus owned keybindings/theme helpers while
  * preserving tree behavior; bare A1 uses compact modal chrome and label editing, four-mode
  * Models-style filter status with Tab/Shift+Tab directional cycling and concise all-first presentation
- * excluding internal bookkeeping, standard search input, blue full-row menu-arrow selection that
- * preserves per-entry semantic foregrounds and has no path bullets, accent entry labels, bracketed
- * timestamps, numeric result counters without duplicate label-time status, and a stateful time on/off
- * shortcut, semantic role colors with session naming for the system root, standard
- * paging/first-last/non-root containing-branch folding keys with a permanently expanded system session
- * entry even behind hidden metadata, single-character ellipses on both clipped edges with
- * bracket-delimiter preservation and selected-fragment highlighting, and Models-ordered semantic
+ * excluding internal bookkeeping, a standard accent-marked search input, blue full-row menu-arrow
+ * selection that preserves per-entry semantic foregrounds and has no path bullets, accent entry
+ * labels, bracketed timestamps, numeric result counters without duplicate label-time status, and a
+ * stateful time on/off shortcut, semantic role colors with session naming for the system root,
+ * standard paging/first-last/non-root containing-branch folding keys with a permanently expanded
+ * system session entry even behind hidden metadata, single-character ellipses on both clipped edges
+ * with bracket-delimiter preservation and selected-fragment highlighting, and Models-ordered semantic
  * Type/search shortcut footers without a redundant select hint.
- * Deviations: owned-modal-shortcut-hints, owned-session-tree-dialog.
+ * Deviations: owned-modal-shortcut-hints, owned-session-tree-dialog, owned-dialog-search-marker.
  */
 import { Container, Input, matchesKey, Spacer, sliceByColumn, Text, truncateToWidth, visibleWidth, wrapTextWithAnsi, } from "@earendil-works/pi-tui";
 import { DynamicBorder, formatReadLineRange } from "../../../startup-public.js";
 import { KeybindingsManager } from "../adjacent/core/keybindings.js";
-import { addPiModalHeader, adoptPiModalFrame } from "../../modal-frame.js";
+import { addPiModalHeader, adoptPiModalFrame, renderPiModalSearchInput } from "../../modal-frame.js";
 import { DIALOG_CLOSE_SHORTCUT_HINT, paintPiBorder, piTheme, renderPiModalShortcutHints } from "../../theme.js";
 const theme = new Proxy({}, {
     get(_target, property) {
@@ -1077,7 +1077,7 @@ class TreeSearchInput {
             this.input.handleInput(query);
             this.renderedQuery = query;
         }
-        return this.input.render(width);
+        return renderPiModalSearchInput(this.input, width);
     }
 }
 /** Models-style summary of the active tree filter. */

package/dist/integrations/pi/components/upstream/history/editor-core.js

@@ -287,6 +287,8 @@ export class HistoryEditorCore {
                 delete this.onHistoryChange; };
         },
         reset: () => this.resetHistoryBrowsing(),
+        restoreDraft: () => { while (this.historyIndex >= 0)
+            this.navigateHistory(1); },
     };
     persistentHistory = false;
     styleHistoryLabel;

package/dist/integrations/pi/components/upstream/theme/theme.d.ts

@@ -43,6 +43,8 @@ export interface PiAccentProjection {
     readonly selectedBg: Color;
     readonly userMessageBg: Color;
 }
+/** Canonical named color used by both the interactive theme and pre-load palette generation. */
+export declare function namedPiAccent(color: UiAccentColor, appearance: PiTerminalTheme): Color;
 /** Derive the complete semantic family from any primary accent, including future custom colors. */
 export declare function derivePiAccentProjection(accent: Color, appearance: PiTerminalTheme): PiAccentProjection;
 declare let packageBorderProjectionEnabled: boolean;

package/dist/integrations/pi/components/upstream/theme/theme.js

@@ -46,6 +46,10 @@ const ACCENT_PALETTE = Object.freeze({
     orange: Object.freeze({ dark: okhslColor(48, 0.75, 0.67), light: okhslColor(48, 0.90, 0.47) }),
     pink: Object.freeze({ dark: okhslColor(337, 0.72, 0.67), light: okhslColor(337, 0.75, 0.48) }),
 });
+/** Canonical named color used by both the interactive theme and pre-load palette generation. */
+export function namedPiAccent(color, appearance) {
+    return ACCENT_PALETTE[color][appearance];
+}
 function clamp(value, minimum, maximum) {
     return Math.max(minimum, Math.min(maximum, value));
 }
@@ -75,7 +79,7 @@ let activeBaseTheme;
 let activeTheme;
 let activeThemeName;
 let activeThemeMode;
-let activeAccentColor = "purple";
+let activeAccentColor = "blue";
 let packageBorderProjectionEnabled = true;
 let themeWatcher;
 let themeReloadTimer;

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

@@ -211,8 +211,13 @@ export class PiEngineAdapter {
     #announceReleaseUpdate(release) {
         if (this.#disposed)
             return;
-        const changelog = release.changelogUrl === null ? "" : `\nChangelog: ${release.changelogUrl}`;
-        this.#addDiagnostic("info", "release-update", `New version ${release.version} is available. Run ${release.command}${changelog}`, true);
+        if (release.status === "installed") {
+            this.#addDiagnostic("info", "release-update-installed", `Update ${release.version} installed; restart to update.`, true);
+        }
+        else {
+            const changelog = release.changelogUrl === null ? "" : `\nChangelog: ${release.changelogUrl}`;
+            this.#addDiagnostic("info", "release-update", `New version ${release.version} is available. Run ${release.command}${changelog}`, true);
+        }
         this.#emitView();
     }
     suggestionReasoningPolicy() {

package/dist/integrations/pi/engine/offline-settings-port.d.ts

@@ -0,0 +1,23 @@
+import { resolvePiProjectTrustPreflight } from "./project-trust-preflight.js";
+import { PiSettingsBridge, type PiSettingKey } from "./settings-bridge.js";
+import { ModelRuntime, SettingsManager } from "../startup-public.js";
+export interface OfflinePiSettingsPortOptions {
+    readonly cwd: string;
+    readonly agentDir: string;
+    readonly resolveTrust?: typeof resolvePiProjectTrustPreflight;
+    readonly createSettingsManager?: (cwd: string, agentDir: string, projectTrusted: boolean) => SettingsManager;
+    readonly createModelRuntime?: (options: Parameters<typeof ModelRuntime.create>[0]) => Promise<Pick<ModelRuntime, "getAvailableSnapshot">>;
+}
+export interface OfflinePiSettingsPort {
+    readonly port: PiSettingsBridge;
+    readonly manager: SettingsManager;
+    /** Resolves after the local auth/model catalog has populated the per-model choices. */
+    readonly modelsReady: Promise<void>;
+}
+/**
+ * Pi settings for the resident Settings utility tab. It reads the same persisted manager as an
+ * Agent, but every bound live effect is persistence-only because each Agent process owns its effect.
+ */
+export declare function createOfflinePiSettingsPort(options: OfflinePiSettingsPortOptions): Promise<OfflinePiSettingsPort>;
+/** Keys the slim Settings port intentionally binds and exposes in bare mode. */
+export declare function offlinePiSettingKeys(): readonly PiSettingKey[];

package/dist/integrations/pi/engine/offline-settings-port.js

@@ -0,0 +1,53 @@
+import { join } from "node:path";
+import { resolvePiProjectTrustPreflight } from "./project-trust-preflight.js";
+import { PI_SETTING_EFFECTS, PiSettingsBridge, supportedThinkingLevels, } from "./settings-bridge.js";
+import { ModelRuntime, SettingsManager } from "../startup-public.js";
+const PERSIST_ONLY_OWNERS = ["shell", "startup", "agent", "terminal"];
+/**
+ * Pi settings for the resident Settings utility tab. It reads the same persisted manager as an
+ * Agent, but every bound live effect is persistence-only because each Agent process owns its effect.
+ */
+export async function createOfflinePiSettingsPort(options) {
+    let modelRuntime = null;
+    const createModelRuntime = options.createModelRuntime ?? (input => ModelRuntime.create(input));
+    const modelsReady = createModelRuntime({
+        authPath: join(options.agentDir, "auth.json"),
+        modelsPath: join(options.agentDir, "models.json"),
+        allowModelNetwork: false,
+    }).then(runtime => { modelRuntime = runtime; }, () => undefined);
+    const trust = await (options.resolveTrust ?? resolvePiProjectTrustPreflight)({
+        cwd: options.cwd,
+        agentDir: options.agentDir,
+    });
+    const manager = (options.createSettingsManager
+        ?? ((cwd, agentDir, projectTrusted) => SettingsManager.create(cwd, agentDir, { projectTrusted })))(options.cwd, options.agentDir, trust.trusted);
+    const port = new PiSettingsBridge(manager, {
+        productMode: "bare",
+        models: () => modelChoices(modelRuntime?.getAvailableSnapshot() ?? [], manager.getAllModelThinkingLevels?.() ?? {}),
+    });
+    for (const owner of PERSIST_ONLY_OWNERS)
+        port.bindOwner(owner, persistOnlyHandlers(owner));
+    return { port, manager, modelsReady };
+}
+function persistOnlyHandlers(owner) {
+    return Object.fromEntries(Object.entries(PI_SETTING_EFFECTS)
+        .filter(([, definition]) => definition.owner === owner && definition.hiddenInBare !== true)
+        .map(([key]) => [key, { apply() { } }]));
+}
+function modelChoices(models, overrides) {
+    return models.map(model => {
+        const key = `${model.provider}/${model.id}`;
+        return {
+            key,
+            label: `${model.id} [${model.provider}]`,
+            description: overrides[key] === undefined ? "global default" : `override: ${overrides[key]}`,
+            levels: supportedThinkingLevels(model),
+        };
+    });
+}
+/** Keys the slim Settings port intentionally binds and exposes in bare mode. */
+export function offlinePiSettingKeys() {
+    return Object.entries(PI_SETTING_EFFECTS)
+        .filter(([, definition]) => PERSIST_ONLY_OWNERS.includes(definition.owner) && definition.hiddenInBare !== true)
+        .map(([key]) => key);
+}

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

@@ -37,7 +37,7 @@ export interface PiEngineAdapterPorts {
 export interface EnginePortParts {
     readonly sessionId: string;
     readonly agentDir: string;
-    readonly engine: Pick<PiEngineRuntime, "cwd" | "generation" | "bindingGeneration" | "currentSessionResumeMetadata" | "currentSessionFile">;
+    readonly engine: Pick<PiEngineRuntime, "cwd" | "generation" | "bindingGeneration" | "currentSessionResumeMetadata" | "currentSessionFile" | "session">;
     readonly contexts: PiWorkflowContexts;
     readonly workflows: PiWorkflowRunner;
     readonly settings: PiEngineSettings;

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

@@ -11,6 +11,10 @@ export function createEnginePorts(parts) {
             get disposed() { return parts.disposed(); },
             currentSessionResumeMetadata: () => engine.currentSessionResumeMetadata(),
             currentSessionFile: () => engine.currentSessionFile(),
+            currentHistorySessionId: () => {
+                const id = engine.session?.sessionManager?.getSessionId?.();
+                return typeof id === "string" && id.length > 0 && id.length <= 256 && !id.includes("\0") ? id : null;
+            },
         },
         session: parts.session,
         workflows: {

package/dist/integrations/pi/engine/settings-bridge.d.ts

@@ -80,6 +80,11 @@ export interface PiSettingsModelChoice {
     readonly description: string;
     readonly levels: readonly string[];
 }
+/** The engine's rule: no reasoning means "off" only; xhigh and max exist only where the model maps them. */
+export declare function supportedThinkingLevels(model: {
+    readonly reasoning?: boolean;
+    readonly thinkingLevelMap?: Readonly<Record<string, unknown>>;
+}): readonly string[];
 /** The choice that clears a per-model override; the engine then applies its global default. */
 export declare const MODEL_THINKING_DEFAULT = "default";
 export declare const AUTOMATIC_THEME = "automatic";

package/dist/integrations/pi/engine/settings-bridge.js

@@ -252,6 +252,19 @@ function outcome(status, application, storedValue, effectiveValue, failure, limi
 function describe(error) {
     return error instanceof Error ? error.message : String(error);
 }
+/** The engine's rule: no reasoning means "off" only; xhigh and max exist only where the model maps them. */
+export function supportedThinkingLevels(model) {
+    if (!model.reasoning)
+        return ["off"];
+    return ["off", "minimal", "low", "medium", "high", "xhigh", "max"].filter(level => {
+        const mapped = model.thinkingLevelMap?.[level];
+        if (mapped === null)
+            return false;
+        if (level === "xhigh" || level === "max")
+            return mapped !== undefined;
+        return true;
+    });
+}
 /** The choice that clears a per-model override; the engine then applies its global default. */
 export const MODEL_THINKING_DEFAULT = "default";
 export const AUTOMATIC_THEME = "automatic";

package/dist/integrations/pi/engine/settings-port.js

@@ -1,6 +1,6 @@
 import { isRecord, readThinkingLevel, stringProperty } from "./message-values.js";
 import { collectionResult } from "./resource-catalog.js";
-import { MODEL_THINKING_DEFAULT, PiSettingsBridge } from "./settings-bridge.js";
+import { MODEL_THINKING_DEFAULT, PiSettingsBridge, supportedThinkingLevels } from "./settings-bridge.js";
 import { workflowResult } from "./workflow-support.js";
 import { PINNED_PI_SETTINGS_CALLBACKS } from "./workflows.js";
 /**
@@ -361,19 +361,6 @@ function agentJsonValue(value) {
 function isThinkingLevel(value) {
     return typeof value === "string" && ["off", "minimal", "low", "medium", "high", "xhigh", "max"].includes(value);
 }
-/** The engine's own rule: no reasoning means "off" only; xhigh and max exist only where the model maps them. */
-function supportedThinkingLevels(model) {
-    if (!model.reasoning)
-        return ["off"];
-    return ["off", "minimal", "low", "medium", "high", "xhigh", "max"].filter(level => {
-        const mapped = model.thinkingLevelMap?.[level];
-        if (mapped === null)
-            return false;
-        if (level === "xhigh" || level === "max")
-            return mapped !== undefined;
-        return true;
-    });
-}
 function settingLabel(callback) {
     return callback
         .replace(/^on/, "")

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

@@ -456,8 +456,8 @@ export class PiWorkflowRunner {
                         : workflowResult(request.command, "failed", "Usage: /name <name>", undefined, "warning");
                 }
                 requireCapability(session.setSessionName, "setSessionName").call(session, argument);
-                const normalized = manager?.getSessionName();
-                const actual = typeof normalized === "string" ? normalized : argument;
+                this.#ports.emitView();
+                const actual = sessionNameOr(manager?.getSessionName(), argument);
                 return workflowResult(request.command, "completed", `Session name set: ${actual}`, actual === argument ? undefined : `Session name was normalized from ${JSON.stringify(argument)} to ${JSON.stringify(actual)}`);
             }
             case "session": {
@@ -597,3 +597,10 @@ export class PiWorkflowRunner {
         }
     }
 }
+/**
+ * The name the session normalized the request to, or the request when it reports none. `/name`
+ * publishes a view right after setting it, so a resident tab takes the name as its tab name.
+ */
+function sessionNameOr(normalized, requested) {
+    return typeof normalized === "string" ? normalized : requested;
+}

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

@@ -7,7 +7,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-10-23T09:16:51.110Z",
+  "builtAt": "2026-10-27T13:50:09.001Z",
   "artifact": {
     "filename": "process-guardian.node",
     "sha256": "a87eaaffcd986b624c8b044b756446cc1bdaf4334a1775b97820542fe34f9fb7",

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

@@ -9,11 +9,11 @@
   "architecture": "arm64",
   "target": "aarch64-apple-darwin",
   "capability": "supported",
-  "builtAt": "2026-10-23T09:19:57.936Z",
+  "builtAt": "2026-10-27T13:53:57.855Z",
   "artifact": {
     "filename": "terminal-host.node",
-    "sha256": "62c8a0656c7496194cd20649e3f2011f460cb381da2a04fde7ce54cbd38d5a50",
-    "size": 5748592
+    "sha256": "2e31d2b83999aec568d7b892e71b5590034d8322c574d773f347c494fc8fe2b8",
+    "size": 6001616
   },
   "entry": {
     "filename": "dist/foundation/resident-tabs/host-entry.js",

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

@@ -7,7 +7,7 @@
   "platform": "darwin",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-23T09:16:58.302Z",
+  "builtAt": "2026-10-27T13:50:17.798Z",
   "artifact": {
     "filename": "process-guardian.node",
     "sha256": "783a65f0de287a1c02cd5429dbe97bc8633f4cc8a7b92e3e961180b9bdcff814",

package/dist/native/darwin-x64/terminal-host.manifest.json

@@ -9,11 +9,11 @@
   "architecture": "x64",
   "target": "x86_64-apple-darwin",
   "capability": "supported",
-  "builtAt": "2026-10-23T09:22:31.367Z",
+  "builtAt": "2026-10-27T13:56:22.634Z",
   "artifact": {
     "filename": "terminal-host.node",
-    "sha256": "f74aafbd050eaba8737a9e5bd82b2836f86e8b73168310e7c3316af99442e1f2",
-    "size": 6272408
+    "sha256": "84ec54e9cc77f0f2b75f52e3618a5c2d02bbecdfa417d52ee1dc99243ea1fe5d",
+    "size": 6548664
   },
   "entry": {
     "filename": "dist/foundation/resident-tabs/host-entry.js",