@timurproko/a1 0.2.6 → 0.2.7-dev.1221

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

@@ -1,23 +1,23 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/components/tree-selector.ts.
  * 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 } from "../../../startup-public.js";
+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) {
@@ -814,15 +814,7 @@ class TreeList {
         switch (name) {
             case "read": {
                 const path = shortenPath(String(args.path || args.file_path || ""));
-                const offset = args.offset;
-                const limit = args.limit;
-                let display = path;
-                if (offset !== undefined || limit !== undefined) {
-                    const start = offset ?? 1;
-                    const end = limit !== undefined ? start + limit - 1 : "";
-                    display += `:${start}${end ? `-${end}` : ""}`;
-                }
-                return `[read: ${display}]`;
+                return `[read: ${path}${formatReadLineRange(args.offset, args.limit)}]`;
             }
             case "write": {
                 const path = shortenPath(String(args.path || args.file_path || ""));
@@ -1085,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/components/trust-selector.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/components/trust-selector.ts.
  * Modifications: Mechanical source-synchronized trust selector port with injected public
  * ProjectTrustStore-derived options, remapped owned theme imports, the shared bare-A1 modal shortcut

package/dist/integrations/pi/components/upstream/external-editor.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/external-editor.ts.
  * Modifications: Mechanical port: retain temporary prompt file, asynchronous inherited-stdio editor
  * process, completion readback, and best-effort cleanup behind the owned extension-editor component.

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

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-tui 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-tui 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/tui/src/components/editor.ts.
  * Modifications: Owned editor core or minimal editor-local helper subset; public imports, strict
  * types, typed persistent-history hooks, semantic border state with the user-approved numeric-only
@@ -9,7 +9,7 @@
  * Deviations: compact-history-counter-label, history-overflow-cue-separation,
  * history-recall-cursor-retention, persistent-history-owned-editor-boundary.
  */
-import { type AutocompleteProvider, type Component, type Focusable, type TUI, type TuiMouseEvent, type TuiMouseEventResult, type SelectListTheme } from "@earendil-works/pi-tui";
+import { type AutocompleteProvider, type Component, type Focusable, type SelectListTheme, type TUI, type TuiMouseEvent, type TuiMouseEventResult } from "@earendil-works/pi-tui";
 import type { EditorInteractionPort, EditorRecallPort } from "../../editor-interaction.js";
 /**
  * Represents a chunk of text for word-wrap layout.

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

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-tui 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-tui 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/tui/src/components/editor.ts.
  * Modifications: Owned editor core or minimal editor-local helper subset; public imports, strict
  * types, typed persistent-history hooks, semantic border state with the user-approved numeric-only
@@ -9,11 +9,11 @@
  * Deviations: compact-history-counter-label, history-overflow-cue-separation,
  * history-recall-cursor-retention, persistent-history-owned-editor-boundary.
  */
-import { getKeybindings, matchesKey, CURSOR_MARKER, sliceByColumn, truncateToWidth, visibleWidth, SelectList } from "@earendil-works/pi-tui";
+import { CURSOR_MARKER, SelectList, getKeybindings, matchesKey, renderFakeCursor, sliceByColumn, truncateToWidth, visibleWidth, } from "@earendil-works/pi-tui";
 import { decodePrintableKey } from "./printable-key.js";
 import { KillRing } from "./kill-ring.js";
 import { UndoStack } from "./undo-stack.js";
-import { autocompleteBoundaryRegex, autocompleteSeparatorRegex, cjkBreakRegex, getGraphemeSegmenter, getWordSegmenter, isWhitespaceChar } from "./text-helpers.js";
+import { autocompleteBoundaryRegex, autocompleteSeparatorRegex, cjkBreakRegex, getGraphemeSegmenter, getWordSegmenter, isWhitespaceChar, } from "./text-helpers.js";
 import { findWordBackward, findWordForward } from "./word-navigation.js";
 const graphemeSegmenter = getGraphemeSegmenter();
 const wordSegmenter = getWordSegmenter();
@@ -287,6 +287,8 @@ export class HistoryEditorCore {
                 delete this.onHistoryChange; };
         },
         reset: () => this.resetHistoryBrowsing(),
+        restoreDraft: () => { while (this.historyIndex >= 0)
+            this.navigateHistory(1); },
     };
     persistentHistory = false;
     styleHistoryLabel;
@@ -574,13 +576,13 @@ export class HistoryEditorCore {
                     const afterGraphemes = [...this.segment(after, "grapheme")];
                     const firstGrapheme = afterGraphemes[0]?.segment || "";
                     const restAfter = after.slice(firstGrapheme.length);
-                    const cursor = `\x1b[7m${firstGrapheme}\x1b[0m`;
+                    const cursor = renderFakeCursor(firstGrapheme);
                     displayText = before + marker + cursor + restAfter;
                     // lineVisibleWidth stays the same - we're replacing, not adding
                 }
                 else {
                     // Cursor is at the end - add highlighted space
-                    const cursor = "\x1b[7m \x1b[0m";
+                    const cursor = renderFakeCursor(" ");
                     displayText = before + marker + cursor;
                     lineVisibleWidth = lineVisibleWidth + 1;
                     // If cursor overflows content width into the padding, flag it

package/dist/integrations/pi/components/upstream/history/kill-ring.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-tui 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-tui 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/tui/src/kill-ring.ts.
  * Modifications: Owned editor core or minimal editor-local helper subset; public imports, strict
  * types, typed persistent-history hooks, and semantic border state. Public terminal runtime/exports

package/dist/integrations/pi/components/upstream/history/kill-ring.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-tui 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-tui 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/tui/src/kill-ring.ts.
  * Modifications: Owned editor core or minimal editor-local helper subset; public imports, strict
  * types, typed persistent-history hooks, and semantic border state. Public terminal runtime/exports

package/dist/integrations/pi/components/upstream/history/printable-key.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-tui 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-tui 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/tui/src/keys.ts.
  * Modifications: Owned editor core or minimal editor-local helper subset; public imports, strict
  * types, typed persistent-history hooks, and semantic border state. Public terminal runtime/exports

package/dist/integrations/pi/components/upstream/history/text-helpers.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-tui 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-tui 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/tui/src/utils.ts.
  * Modifications: Owned editor core or minimal editor-local helper subset; public imports, strict
  * types, typed persistent-history hooks, and semantic border state. Public terminal runtime/exports

package/dist/integrations/pi/components/upstream/history/undo-stack.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-tui 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-tui 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/tui/src/undo-stack.ts.
  * Modifications: Owned editor core or minimal editor-local helper subset; public imports, strict
  * types, typed persistent-history hooks, and semantic border state. Public terminal runtime/exports

package/dist/integrations/pi/components/upstream/history/undo-stack.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-tui 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-tui 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/tui/src/undo-stack.ts.
  * Modifications: Owned editor core or minimal editor-local helper subset; public imports, strict
  * types, typed persistent-history hooks, and semantic border state. Public terminal runtime/exports

package/dist/integrations/pi/components/upstream/history/word-navigation.js

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-tui 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-tui 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/tui/src/word-navigation.ts.
  * Modifications: Owned editor core or minimal editor-local helper subset; public imports, strict
  * types, typed persistent-history hooks, and semantic border state. Public terminal runtime/exports

package/dist/integrations/pi/components/upstream/model-search.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/model-search.ts.
  * Modifications: Mechanical source-synchronized port preserving pinned model search terms for stateful
  * scoped-model filtering.

package/dist/integrations/pi/components/upstream/program-status-reporter.d.ts

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/program-status-reporter.ts.
  * Modifications: Remap Pi session events to A1's neutral run events, inject the terminal reporter, use
  * A1's application identity, and clear dialog state when the owned session changes.

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

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/theme/theme-controller.ts.
  * Modifications: Source-synchronized controller port: renamed owner class, injected dependency-free
  * settings/runtime ports, remapped private theme helpers to the public-backed A1 theme adapter, and

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

@@ -43,8 +43,11 @@ 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;
 export declare function ensurePiTheme(): Theme;
 export declare function piTheme(): Theme;
 export declare function currentPiThemeName(): string;
@@ -55,6 +58,8 @@ export declare function renderPiAccentPreview(color: string, text: string): stri
 export declare function derivePiCanvasBackground(style: OwnedUiBackgroundStyle, accent: Color): Color | null;
 /** Resolves the selected canvas through the active accent and terminal color mode. */
 export declare function piCanvasBackgroundAnsi(style: OwnedUiBackgroundStyle): string | null;
+/** Read-only live view of whether bare A1's semantic accent family is active. */
+export { packageBorderProjectionEnabled as isPiAccentProjectionEnabled };
 /** Keeps the complete comparison theme unmodified while bare A1 projects its semantic accent family. */
 export declare function setPiPackageBorderProjectionEnabled(enabled: boolean): void;
 /** Reprojects the active base theme; repeated changes never derive from an earlier projection. */

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

@@ -1,5 +1,5 @@
 /**
- * Provenance: @earendil-works/pi-coding-agent 1.1.0 (MIT), commit abe508e1b89912adde45528136c3221eb69acdd7,
+ * Provenance: @earendil-works/pi-coding-agent 1.4.0 (MIT), commit 4a080252f06caf63a525d7873c5d94d3c23887e0,
  * packages/coding-agent/src/modes/interactive/theme/theme.ts.
  * Modifications: Source-synchronized theme port: retain pinned theme schema, variable/color
  * resolution, built-in and custom loading, terminal detection, and layout defaults while constructing
@@ -32,6 +32,9 @@ const FOREGROUND_COLORS = [
 const BACKGROUND_COLORS = [
     "selectedBg", "searchMatchBg", "userMessageBg", "customMessageBg", "toolPendingBg", "toolSuccessBg", "toolErrorBg",
 ];
+const THEME_ROOT_KEYS = new Set(["$schema", "name", "appearance", "vars", "colors", "export"]);
+const THEME_COLOR_KEYS = new Set([...FOREGROUND_COLORS, ...BACKGROUND_COLORS]);
+const THEME_EXPORT_KEYS = new Set(["pageBg", "cardBg", "infoBg"]);
 const ACCENT_PALETTE = Object.freeze({
     purple: Object.freeze({
         dark: Object.freeze({ kind: "rgb", r: 167, g: 152, b: 215 }),
@@ -43,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));
 }
@@ -72,7 +79,7 @@ let activeBaseTheme;
 let activeTheme;
 let activeThemeName;
 let activeThemeMode;
-let activeAccentColor = "purple";
+let activeAccentColor = "blue";
 let packageBorderProjectionEnabled = true;
 let themeWatcher;
 let themeReloadTimer;
@@ -122,6 +129,8 @@ export function piCanvasBackgroundAnsi(style) {
     const background = derivePiCanvasBackground(style, accent);
     return background === null ? null : backgroundAnsi(background, base.getColorMode());
 }
+/** Read-only live view of whether bare A1's semantic accent family is active. */
+export { packageBorderProjectionEnabled as isPiAccentProjectionEnabled };
 /** Keeps the complete comparison theme unmodified while bare A1 projects its semantic accent family. */
 export function setPiPackageBorderProjectionEnabled(enabled) {
     if (packageBorderProjectionEnabled === enabled)
@@ -471,6 +480,22 @@ function validateThemeJson(label, value) {
         || (value.vars !== undefined && !isRecord(value.vars))) {
         throw new Error(`Invalid theme "${label}": expected name, colors, and optional vars objects`);
     }
+    const unsupportedRootKey = Object.keys(value).find(key => !THEME_ROOT_KEYS.has(key));
+    if (unsupportedRootKey !== undefined) {
+        throw new Error(`Invalid theme "${label}": unsupported property ${unsupportedRootKey}`);
+    }
+    if (value.$schema !== undefined && typeof value.$schema !== "string") {
+        throw new Error(`Invalid theme "${label}": $schema must be a string`);
+    }
+    if (value.export !== undefined) {
+        if (!isRecord(value.export))
+            throw new Error(`Invalid theme "${label}": export must be an object`);
+        for (const [key, color] of Object.entries(value.export)) {
+            if (!THEME_EXPORT_KEYS.has(key))
+                throw new Error(`Invalid theme "${label}": unsupported export color ${key}`);
+            validateColor(color, `${label}.export.${key}`);
+        }
+    }
     if (value.name.includes("/"))
         throw new Error(`Invalid theme name "${value.name}"`);
     if (value.appearance !== undefined && value.appearance !== "dark" && value.appearance !== "light") {
@@ -486,6 +511,8 @@ function validateThemeJson(label, value) {
     }
     const colors = {};
     for (const [key, color] of Object.entries(value.colors)) {
+        if (!THEME_COLOR_KEYS.has(key))
+            throw new Error(`Invalid theme "${label}": unsupported color ${key}`);
         validateColor(color, `${label}.colors.${key}`);
         colors[key] = color;
     }

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

@@ -1,38 +1,17 @@
-import { type AgentSession } from "../startup-public.js";
-import { type OwnedUiCommand, type OwnedUiExtensionPort, type OwnedUiExtensionUiPort, type OwnedUiImageAttachment, type OwnedUiPromptSuggestionGeneratorPort, type OwnedUiPromptSuggestionReasoning, type OwnedUiPromptSuggestionRequest, type OwnedUiPromptSuggestionResult, type OwnedUiEvent, type OwnedUiReleaseUpdate, type OwnedUiSessionBackend, type OwnedUiSessionCatalogPort, type OwnedUiSessionIdentityPort, type OwnedUiSessionPort, type OwnedUiSessionSettingsPort, type OwnedUiSessionViewModel, type OwnedUiSnapshot, type OwnedUiWorkflowPort } from "../../../contracts/owned-ui/index.js";
-import type { PiAuthenticationProviderOption, PiBashWorkflowResult, PiModelsContext, PiModelsRefreshResult, PiPinnedSettingsCallback, PiPinnedSettingsSnapshot, PiProjectTrustContext, PiProjectTrustUpdate, PiScopedModelsContext, PiScopedModelsRefreshResult, PiSessionResumeMetadata, PiSessionSelectorContext, PiTreeSelectorContext, PiWorkflowAutocompleteCommand, PiWorkflowHost, PiWorkflowInteractionHost, PiWorkflowOption, PiWorkflowRequest, PiWorkflowResult } from "./workflows.js";
+import { type OwnedUiCommand, type OwnedUiExtensionPort, type OwnedUiPromptSuggestionGeneratorPort, type OwnedUiPromptSuggestionReasoning, type OwnedUiPromptSuggestionRequest, type OwnedUiPromptSuggestionResult, type OwnedUiEvent, type OwnedUiSessionBackend, type OwnedUiSessionCatalogPort, type OwnedUiSessionIdentityPort, type OwnedUiSessionPort, type OwnedUiSessionSettingsPort, type OwnedUiSessionViewModel, type OwnedUiSnapshot, type OwnedUiWorkflowPort } from "../../../contracts/owned-ui/index.js";
+import type { PiPinnedSettingsSnapshot, PiWorkflowHost, PiWorkflowInteractionHost, PiWorkflowRequest, PiWorkflowResult } from "./workflows.js";
 import type { PiSettingsBridge } from "./settings-bridge.js";
-import type { PiSettingOwnerHandlers } from "./settings-bridge.js";
 import type { PiProjectTrustPreflightPrompt } from "./project-trust-preflight.js";
 import type { PiSessionForkPrompt, PiSessionSelection } from "./session-selection.js";
-import type { AgentSettingOwner } from "../../../contracts/agent-engine/index.js";
 import { type AdapterCommandResult } from "./command-dispatch.js";
-import { type OwnedPiVisualExtensionSupport } from "./extension-ui-binding.js";
-import { type OwnedPiExtensionResourceSummary, type OwnedPiResourceSummary } from "./resource-catalog.js";
 import { type PiEnginePackageUpdateProbe, type PiEngineRuntimeFactory, type PiRepositoryContextReader } from "./session-runtime.js";
 import { type PiEngineHostSessionPorts } from "./host-ports.js";
-import { PiWorkflowContexts } from "./workflow-contexts.js";
+import { type PiSessionPresentationSource } from "./ports.js";
 export type { OwnedPiExtensionResourceSummary, OwnedPiExtensionSourceSummary, OwnedPiResourceSummary } from "./resource-catalog.js";
 export type { PiEngineRuntimeFactory, PiEngineRuntimeFactoryInput } from "./session-runtime.js";
 export type { AdapterCommandResult } from "./command-dispatch.js";
 export type { OwnedPiVisualExtensionSupport } from "./extension-ui-binding.js";
-/**
- * The Pi objects pinned selectors and transcript renderers are built from. They are not part of the
- * session backend contract; only the session presenters owner reads them.
- */
-export interface PiSessionPresentationSource {
-    pinnedModelSelectorContext(): ReturnType<PiWorkflowContexts["pinnedModelSelectorContext"]>;
-    pinnedSessionSelectorContext(): PiSessionSelectorContext;
-    pinnedTreeSelectorContext(): PiTreeSelectorContext;
-    pinnedMessageRenderer(customType: string): unknown;
-    pinnedToolRenderers(toolName: string): unknown;
-    pinnedShortcutDescriptions(bindings: Parameters<AgentSession["extensionRunner"]["getShortcuts"]>[0]): readonly {
-        readonly key: string;
-        readonly description: string;
-    }[];
-    pinnedSettingsModels(): Pick<PiPinnedSettingsSnapshot, "currentModel" | "availableDefaultModels">;
-    applyPinnedSettingValue(callback: PiPinnedSettingsCallback, value: unknown): Promise<PiWorkflowResult>;
-}
+export type { PiSessionPresentationSource } from "./ports.js";
 /** Explicit flush failure when required delivery was interrupted rather than completed. */
 export declare class EngineDeliveryError extends Error {
     constructor();
@@ -80,24 +59,9 @@ export declare class PiEngineAdapter implements OwnedUiSessionBackend, OwnedUiPr
     /** The Pi objects behind pinned selectors and renderers, for the session presenters owner only. */
     presentationSource(): PiSessionPresentationSource;
     setWorkflowInteractionHost(interaction: PiWorkflowInteractionHost): void;
-    get sessionId(): string;
-    get sessionGeneration(): number;
-    /** Actual session replacements, excluding delivery-only invalidation of callbacks. */
-    get sessionBindingGeneration(): number;
-    get cwd(): string;
-    get agentDir(): string;
-    resolveTranscriptImage(assetId: string): OwnedUiImageAttachment | null;
-    currentSessionFile(): string | null;
-    currentSessionResumeMetadata(): PiSessionResumeMetadata | null;
-    get disposed(): boolean;
-    /**
-     * Report a newer A1 release found by the startup check. The shell renders the diagnostic as
-     * pinned Pi's `Update Available` notice; it arrives whenever the check resolves, so a late
-     * result is appended to the transcript like Pi's own fire-and-forget version check.
-     */
-    announceReleaseUpdate(release: OwnedUiReleaseUpdate): void;
     suggestionReasoningPolicy(): OwnedUiPromptSuggestionReasoning;
     generate(request: OwnedUiPromptSuggestionRequest): Promise<OwnedUiPromptSuggestionResult>;
+    generateResidentTabName(instruction: string, maxTokens: number, signal: AbortSignal): Promise<string | null>;
     start(): Promise<OwnedUiSessionViewModel>;
     /** Announce pinned Pi's changelog since the profile's last seen version; the host calls this once per process. */
     announceStartupChangelog(): Promise<void>;
@@ -119,51 +83,15 @@ export declare class PiEngineAdapter implements OwnedUiSessionBackend, OwnedUiPr
         peakBytes: number;
     };
     flushEvents(): Promise<void>;
-    nonVisualResources(): readonly OwnedPiResourceSummary[];
-    extensionResources(): readonly OwnedPiExtensionResourceSummary[];
-    workflowAutocompleteCommands(): readonly PiWorkflowAutocompleteCommand[];
-    visualExtensionSupport(): OwnedPiVisualExtensionSupport;
-    bindExtensionUi(ui: OwnedUiExtensionUiPort, shutdown?: () => void | Promise<void>): Promise<void>;
-    unbindExtensionUi(): Promise<void>;
-    cycleModelWorkflow(direction: "forward" | "backward"): Promise<PiWorkflowResult>;
-    pinnedProjectTrustContext(): PiProjectTrustContext;
-    persistProjectTrust(updates: readonly PiProjectTrustUpdate[]): void;
-    pinnedScopedModelsContext(): PiScopedModelsContext;
-    updateScopedModels(enabledModelIds: readonly string[] | null): void;
-    persistScopedModels(enabledModelIds: readonly string[] | null): void;
-    refreshScopedModels(signal: AbortSignal): Promise<PiScopedModelsRefreshResult>;
-    modelsContext(): PiModelsContext;
-    setSessionModelScope(scopeIds: readonly string[]): void;
-    persistModelScope(scopeIds: readonly string[]): void;
-    refreshModels(signal: AbortSignal): Promise<PiModelsRefreshResult>;
-    pinnedLoginOptions(authType?: "oauth" | "api_key"): readonly PiAuthenticationProviderOption[];
-    pinnedLoginMethodOptions(providerReference: string): {
-        readonly title: string;
-        readonly options: readonly PiWorkflowOption[];
-    };
-    pinnedAmbientAuthentication(selection: string): ReturnType<PiWorkflowContexts["pinnedAmbientAuthentication"]>;
-    pinnedLogoutOptions(): Promise<readonly PiAuthenticationProviderOption[]>;
-    pinnedForkOptions(): readonly PiWorkflowOption[];
-    /** Bind the owned UI's clipboard lifecycle without changing the comparison host. True means acknowledged delivery. */
-    bindClipboardWriter(writer: (text: string) => Promise<boolean>): () => void;
-    /** Workflow and tree copying share the active owner's write fence and delivery acknowledgment. */
-    copyWorkflowText(text: string): Promise<boolean>;
     abortBashWorkflow(): void;
-    executeBashWorkflow(command: string, excludeFromContext: boolean): Promise<PiBashWorkflowResult>;
-    reloadBlockedResult(): PiWorkflowResult | null;
     executeWorkflow(request: PiWorkflowRequest): Promise<PiWorkflowResult>;
     /**
      * The theme the engine is configured with, in the engine's own grammar: a
      * theme's name, or a `light/dark` pair meaning "follow the terminal".
      */
     configuredTheme(): string | undefined;
-    /** Persist the global thinking default without changing the live session level. */
-    setDefaultThinkingLevel(level: PiPinnedSettingsSnapshot["defaultThinkingLevel"]): void;
     /** Settings port for the live runtime, or null before the runtime is available. */
     settingsPort(): PiSettingsBridge | null;
-    /** Which settings surface this adapter serves; hidden-in-bare effects are unbindable in bare mode. */
-    get settingsProductMode(): "bare" | "comparison";
-    bindSettingsOwner(owner: AgentSettingOwner, handlers: PiSettingOwnerHandlers): () => void;
     pinnedSettingsSnapshot(): PiPinnedSettingsSnapshot;
     clearQueuedWorkflows(): readonly string[];
     view(): OwnedUiSessionViewModel;