@timurproko/a1 0.1.8-dev.151 → 0.1.8-dev.182

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

@@ -1,147 +1,106 @@
 import { AssistantMessageComponent, BashExecutionComponent, CompactionSummaryMessageComponent, CustomMessageComponent, DynamicBorder, getMarkdownTheme, parseSkillBlock, ToolExecutionComponent, UserMessageComponent, } from "@earendil-works/pi-coding-agent";
 import { SkillInvocationMessageComponent } from "./upstream/components/skill-invocation-message.js";
-import { Container, Markdown, Spacer, Text, } from "#pi-tui";
+import { createMermaidMarkdownTransformer } from "./upstream/components/mermaid.js";
+import { Container, Image, Spacer, Text, } from "#pi-tui";
 import { PRODUCT_TEXT } from "../../../product-identity.js";
 import { createPiSubmittedPromptComponent, } from "./submitted-prompt-adapter.js";
-import { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
 import { PINNED_PI_LAYOUT, piTheme, } from "./theme.js";
-import { componentPort, createTuiFacade, ensureTheme, formatSessionTokens, isRecord, } from "./shell-shared-facade.js";
-export function renderPiShellStatusText(message, width) {
-    ensureTheme();
-    return new Text(piTheme().fg("dim", message), PINNED_PI_LAYOUT.outputPad, 0).render(width);
-}
-export function createPiShellSessionInfo(presentation) {
-    ensureTheme();
-    const { stats, sessionName, cacheWaste, usageBreakdown } = presentation;
-    let info = `${piTheme().bold("Session Info")}\n\n`;
-    if (sessionName)
-        info += `${piTheme().fg("dim", "Name:")} ${sessionName}\n`;
-    info += `${piTheme().fg("dim", "File:")} ${stats.sessionFile ?? "In-memory"}\n`;
-    info += `${piTheme().fg("dim", "ID:")} ${stats.sessionId}\n\n`;
-    info += `${piTheme().bold("Messages")}\n`;
-    info += `${piTheme().fg("dim", "Total:")} ${stats.totalMessages}\n`;
-    info += `${piTheme().fg("dim", "User:")} ${stats.userMessages}\n`;
-    info += `${piTheme().fg("dim", "Assistant:")} ${stats.assistantMessages}\n`;
-    info += `${piTheme().fg("dim", "Tools:")} ${stats.toolCalls} calls, ${stats.toolResults} results\n\n`;
-    info += `${piTheme().bold("Tokens")}\n`;
-    const { input, cacheRead, cacheWrite } = stats.tokens;
-    const promptTokens = input + cacheRead + cacheWrite;
-    info += `${piTheme().fg("dim", "Input:")} ${promptTokens.toLocaleString()}\n`;
-    if (promptTokens > 0 && (cacheRead > 0 || cacheWrite > 0)) {
-        const hitRate = piTheme().fg("dim", `(${((cacheRead / promptTokens) * 100).toFixed(1)}%)`);
-        info += `  ${piTheme().fg("dim", "Cached:")} ${cacheRead.toLocaleString()} ${hitRate}\n`;
-        const written = cacheWrite > 0 ? ` ${piTheme().fg("dim", `(${cacheWrite.toLocaleString()} written to cache)`)}` : "";
-        info += `  ${piTheme().fg("dim", "Uncached:")} ${(input + cacheWrite).toLocaleString()}${written}\n`;
-    }
-    info += `${piTheme().fg("dim", "Output:")} ${stats.tokens.output.toLocaleString()}\n`;
-    info += `${piTheme().fg("dim", "Total:")} ${stats.tokens.total.toLocaleString()}\n`;
-    if (stats.cost > 0 || cacheWaste.missedTokens > 0) {
-        info += `\n${piTheme().bold("Cost")}\n`;
-        info += `${piTheme().fg("dim", "Total:")} $${stats.cost.toFixed(3)}`;
-        if (usageBreakdown.length > 1) {
-            for (const entry of usageBreakdown) {
-                info += `\n  ${piTheme().fg("dim", `${entry.key}:`)} $${entry.cost.toFixed(3)} ${piTheme().fg("dim", `(${formatSessionTokens(entry.tokens)} tokens)`)}`;
-            }
-        }
-        if (cacheWaste.missedTokens > 0) {
-            const missLabel = cacheWaste.missCount === 1 ? "1 miss" : `${cacheWaste.missCount} misses`;
-            const detail = `${cacheWaste.missedTokens.toLocaleString()} tokens, ${missLabel}`;
-            info += cacheWaste.missedCost >= 0.0001
-                ? `\n${piTheme().fg("dim", "Cache Re-billed:")} $${cacheWaste.missedCost.toFixed(3)} ${piTheme().fg("dim", `(${detail})`)}`
-                : `\n${piTheme().fg("dim", "Cache Re-billed:")} ${detail}`;
-        }
-    }
-    const container = new Container();
-    container.addChild(new Spacer(1));
-    container.addChild(new Text(info, 1, 0));
-    return componentPort(container);
-}
-export function createPiShellChangelog(markdown) {
-    ensureTheme();
-    const container = new Container();
-    container.addChild(new Spacer(1));
-    container.addChild(new DynamicBorder());
-    container.addChild(new Text(piTheme().bold(piTheme().fg("accent", "What's New")), 1, 0));
-    container.addChild(new Spacer(1));
-    container.addChild(new Markdown(markdown.trim() || "No changelog entries found.", 1, 1, getMarkdownTheme()));
-    container.addChild(new DynamicBorder());
-    return componentPort(container);
-}
-export function createPiShellHotkeys() {
-    ensureTheme();
-    const keys = new KeybindingsManager();
-    const display = (action) => keys.getKeys(action)
-        .map(key => key.split("+").map(part => part.charAt(0).toUpperCase() + part.slice(1)).join("+"))
-        .join("/");
-    const row = (actions, description) => `| ${actions.map(action => `\`${display(action)}\``).join(" / ")} | ${description} |`;
-    const markdown = [
-        "**Navigation**", "| Key | Action |", "|-----|--------|",
-        row(["tui.editor.cursorUp", "tui.editor.cursorDown", "tui.editor.cursorLeft", "tui.editor.cursorRight"], "Move cursor / browse history"),
-        row(["tui.editor.cursorWordLeft", "tui.editor.cursorWordRight"], "Move by word"),
-        row(["tui.editor.cursorLineStart"], "Start of line"), row(["tui.editor.cursorLineEnd"], "End of line"),
-        row(["tui.editor.jumpForward"], "Jump forward to character"), row(["tui.editor.jumpBackward"], "Jump backward to character"),
-        row(["tui.editor.pageUp", "tui.editor.pageDown"], "Scroll by page"), "",
-        "**Editing**", "| Key | Action |", "|-----|--------|",
-        row(["tui.input.submit"], "Send message"),
-        row(["tui.input.newLine"], `New line${process.platform === "win32" ? " (Ctrl+Enter on Windows Terminal)" : ""}`),
-        row(["tui.editor.deleteWordBackward"], "Delete word backwards"), row(["tui.editor.deleteWordForward"], "Delete word forwards"),
-        row(["tui.editor.deleteToLineStart"], "Delete to start of line"), row(["tui.editor.deleteToLineEnd"], "Delete to end of line"),
-        row(["tui.editor.yank"], "Paste the most-recently-deleted text"), row(["tui.editor.yankPop"], "Cycle through the deleted text after pasting"),
-        row(["tui.editor.undo"], "Undo"), "", "**Other**", "| Key | Action |", "|-----|--------|",
-        row(["tui.input.tab"], "Path completion / accept autocomplete"), row(["app.interrupt"], "Cancel autocomplete / abort streaming"),
-        row(["app.clear"], "Clear editor (first) / exit (second)"), row(["app.exit"], "Exit (when editor is empty)"),
-        row(["app.suspend"], "Suspend to background"), row(["app.thinking.cycle"], "Cycle thinking level"),
-        row(["app.model.cycleForward", "app.model.cycleBackward"], "Cycle models"), row(["app.model.select"], "Open model selector"),
-        row(["app.tools.expand"], "Toggle tool output expansion"), row(["app.thinking.toggle"], "Toggle thinking block visibility"),
-        row(["app.editor.external"], "Edit message in external editor"), row(["app.message.copy"], "Copy last assistant message"),
-        row(["app.message.followUp"], "Queue follow-up message"), row(["app.message.dequeue"], "Restore queued messages"),
-        row(["app.clipboard.pasteImage"], "Paste image or text from clipboard"),
-        "| `/` | Slash commands |", "| `!` | Run bash command |", "| `!!` | Run bash command (excluded from context) |",
-    ].join("\n");
-    const container = new Container();
-    container.addChild(new Spacer(1));
-    container.addChild(new DynamicBorder());
-    container.addChild(new Text(piTheme().bold(piTheme().fg("accent", "Keyboard Shortcuts")), 1, 0));
-    container.addChild(new Spacer(1));
-    container.addChild(new Markdown(markdown, 1, 1, getMarkdownTheme()));
-    container.addChild(new DynamicBorder());
-    return componentPort(container);
-}
-export function createPiShellTranscriptComponent(initial, cwd, extensions, submittedPrompt) {
+import { componentPort, createTuiFacade, ensureTheme, isRecord, } from "./shell-shared-facade.js";
+export function createPiShellTranscriptComponent(initial, cwd, extensions, submittedPrompt, initialOutputPad = PINNED_PI_LAYOUT.outputPad, initialHideThinkingBlock = false, initialMermaidRenderingMode = "off", initialShowImages = true, initialImageWidthCells = 80, imageAssets) {
     ensureTheme();
     let block = initial;
     let expanded = false;
-    let component = transcriptComponent(block, cwd, expanded, extensions, submittedPrompt);
+    let outputPad = initialOutputPad;
+    let hideThinkingBlock = initialHideThinkingBlock;
+    let mermaidRenderingMode = initialMermaidRenderingMode;
+    let showImages = initialShowImages;
+    let imageWidthCells = initialImageWidthCells;
+    const rebuild = () => withTranscriptImages(transcriptComponent(block, cwd, expanded, extensions, submittedPrompt, outputPad, hideThinkingBlock, mermaidRenderingMode, showImages, imageWidthCells), block, imageAssets, showImages, imageWidthCells);
+    let component = rebuild();
     return {
         get id() { return block.id; },
         get revision() { return block.revision; },
-        render: width => component.render(width),
+        render: width => renderWithOutputPad(component, block.kind, width, outputPad),
         invalidate: () => component.invalidate(),
         update(next) {
             if (next.id !== block.id)
                 throw new TypeError("Pi transcript component identity cannot change");
             const previous = block;
             block = next;
-            if (!updateTranscriptComponent(component, previous, next, expanded)) {
-                component = transcriptComponent(block, cwd, expanded, extensions, submittedPrompt);
-            }
+            if (!updateTranscriptComponent(component, previous, next, expanded))
+                component = rebuild();
         },
         setExpanded(next) {
             if (expanded === next)
                 return;
             expanded = next;
-            if ("setExpanded" in component && typeof component.setExpanded === "function") {
+            if ("setExpanded" in component && typeof component.setExpanded === "function")
                 component.setExpanded(expanded);
+            else
+                component = rebuild();
+        },
+        setOutputPad(padding) {
+            if (outputPad === padding)
+                return;
+            outputPad = padding;
+            component = rebuild();
+        },
+        setHideThinkingBlock(hidden) {
+            if (hideThinkingBlock === hidden)
+                return;
+            hideThinkingBlock = hidden;
+            component = rebuild();
+        },
+        setMermaidRenderingMode(mode) {
+            if (mermaidRenderingMode === mode)
+                return;
+            mermaidRenderingMode = mode;
+            component = rebuild();
+        },
+        setImagePresentation(show, width) {
+            showImages = show;
+            imageWidthCells = width;
+            if (component instanceof ToolExecutionComponent) {
+                component.setShowImages(show);
+                component.setImageWidthCells(width);
             }
-            else {
-                component = transcriptComponent(block, cwd, expanded, extensions, submittedPrompt);
-            }
+            else
+                component = rebuild();
         },
     };
 }
+function withTranscriptImages(component, block, assets, showImages, imageWidthCells) {
+    const references = block.imageReferences ?? [];
+    if (references.length === 0)
+        return component;
+    const container = new Container();
+    container.addChild(component);
+    for (const reference of references) {
+        container.addChild(new Spacer(1));
+        const asset = assets?.resolve(reference.assetId) ?? null;
+        if (!showImages) {
+            container.addChild(new Text(piTheme().fg("muted", `[Image hidden: ${reference.mimeType}, ${reference.byteLength} bytes]`), 1, 0));
+        }
+        else if (asset === null) {
+            container.addChild(new Text(piTheme().fg("warning", `[Image unavailable: ${reference.mimeType}]`), 1, 0));
+        }
+        else {
+            container.addChild(new Image(asset.data, asset.mimeType, {
+                fallbackColor: text => piTheme().fg("muted", text),
+            }, { maxWidthCells: imageWidthCells, filename: reference.assetId }));
+        }
+    }
+    return container;
+}
+function renderWithOutputPad(component, kind, width, outputPad) {
+    const rows = component.render(width);
+    if (outputPad !== 0 || (kind !== "tool-call" && kind !== "tool-result" && kind !== "bash"))
+        return rows;
+    return rows.map(row => row.startsWith(" ") ? row.slice(1) : row);
+}
 export function renderPiShellTranscriptBlock(block, width, cwd) {
     ensureTheme();
-    return transcriptComponent(block, cwd, true).render(width);
+    return transcriptComponent(block, cwd, true, undefined, undefined, PINNED_PI_LAYOUT.outputPad, false, "off", true, 80).render(width);
 }
 /**
  * Pinned Pi's CLI prints startup diagnostics with `reportDiagnostics` before
@@ -176,7 +135,7 @@ export function renderPiShellPackageUpdateNotice(packages, width) {
     container.addChild(new DynamicBorder(text => theme.fg("warning", text)));
     return container.render(width);
 }
-function transcriptComponent(block, cwd, expanded, extensions, submittedPrompt) {
+function transcriptComponent(block, cwd, expanded, extensions, submittedPrompt, outputPad, hideThinkingBlock, mermaidRenderingMode, showImages, imageWidthCells) {
     switch (block.kind) {
         case "user": {
             const skill = parseSkillBlock(block.text);
@@ -194,10 +153,10 @@ function transcriptComponent(block, cwd, expanded, extensions, submittedPrompt)
         }
         case "assistant":
         case "thinking":
-            return assistantComponent(block);
+            return assistantComponent(block, outputPad, hideThinkingBlock, mermaidRenderingMode);
         case "tool-call":
         case "tool-result": {
-            const component = toolComponent(block, cwd, extensions);
+            const component = toolComponent(block, cwd, extensions, showImages, imageWidthCells);
             component.setExpanded(expanded);
             return component;
         }
@@ -212,13 +171,13 @@ function transcriptComponent(block, cwd, expanded, extensions, submittedPrompt)
             return component;
         }
         case "retry":
-            return new Text(piTheme().fg("warning", `Retry: ${block.text}`), PINNED_PI_LAYOUT.outputPad, 0);
+            return new Text(piTheme().fg("warning", `Retry: ${block.text}`), outputPad, 0);
         case "error":
-            return new Text(piTheme().fg("error", `Error: ${block.text}`), PINNED_PI_LAYOUT.outputPad, 0);
+            return new Text(piTheme().fg("error", `Error: ${block.text}`), outputPad, 0);
         case "system":
-            return new Text(piTheme().fg("dim", block.text), PINNED_PI_LAYOUT.outputPad, 0);
+            return new Text(piTheme().fg("dim", block.text), outputPad, 0);
         case "custom":
-            return customMessageComponent(block, expanded, extensions);
+            return customMessageComponent(block, expanded, extensions, outputPad);
         case "bash":
             return bashExecutionComponent(block, cwd, expanded);
     }
@@ -267,8 +226,9 @@ function updateTranscriptComponent(component, previous, next, expanded) {
     }
     return false;
 }
-function assistantComponent(block) {
-    const component = new AssistantMessageComponent(undefined, false, getMarkdownTheme(), undefined, PINNED_PI_LAYOUT.outputPad);
+function assistantComponent(block, outputPad, hideThinkingBlock, mermaidRenderingMode) {
+    const transformer = createMermaidMarkdownTransformer({ getMode: () => mermaidRenderingMode, theme: piTheme() });
+    const component = new AssistantMessageComponent(undefined, hideThinkingBlock, getMarkdownTheme(), undefined, outputPad, [transformer]);
     component.updateContent(validatedAssistantMessage(block), block.status === "live");
     return component;
 }
@@ -336,12 +296,12 @@ function validatedMessageRenderer(value) {
 function isPiMessageRenderer(value) {
     return typeof value === "function";
 }
-function toolComponent(block, cwd, extensions) {
+function toolComponent(block, cwd, extensions, showImages, imageWidthCells) {
     const payload = blockPayload(block);
     const toolCallId = stringPayload(payload, "toolCallId") ?? block.id;
     const toolName = stringPayload(payload, "toolName") ?? block.title ?? "tool";
     const argumentsPayload = toolArguments(payload);
-    const component = new ToolExecutionComponent(toolName, toolCallId, argumentsPayload, undefined, validatedToolDefinition(extensions?.getToolDefinition(toolName)), createTuiFacade({ getColumns: () => 80, getRows: () => 24, requestRender() { }, onSubmit() { } }), cwd);
+    const component = new ToolExecutionComponent(toolName, toolCallId, argumentsPayload, { showImages, imageWidthCells }, validatedToolDefinition(extensions?.getToolDefinition(toolName)), createTuiFacade({ getColumns: () => 80, getRows: () => 24, requestRender() { }, onSubmit() { } }), cwd);
     if (block.status === "live")
         component.markExecutionStarted();
     if (block.status === "finalized" || payload.argsComplete === true)
@@ -357,7 +317,7 @@ function toolComponent(block, cwd, extensions) {
     }
     return component;
 }
-function customMessageComponent(block, expanded, extensions) {
+function customMessageComponent(block, expanded, extensions, outputPad) {
     const payload = blockPayload(block);
     const message = {
         role: "custom",
@@ -368,7 +328,7 @@ function customMessageComponent(block, expanded, extensions) {
         timestamp: numericPayload(block, "timestamp") || 0,
     };
     const renderer = validatedMessageRenderer(extensions?.getMessageRenderer(message.customType));
-    const component = new CustomMessageComponent(message, renderer, getMarkdownTheme(), PINNED_PI_LAYOUT.outputPad);
+    const component = new CustomMessageComponent(message, renderer, getMarkdownTheme(), outputPad);
     component.setExpanded(expanded);
     return component;
 }

package/dist/integrations/pi/components/shell-shared-facade.d.ts

@@ -1,5 +1,5 @@
 import { visibleWidth, type AutocompleteProvider, type Component, type TUI } from "#pi-tui";
-import type { OwnedUiSessionViewModel, OwnedUiThinkingLevel, OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
+import type { OwnedUiImageAttachment, OwnedUiSessionViewModel, OwnedUiThinkingLevel, OwnedUiTranscriptBlock } from "../../../contracts/owned-ui/index.js";
 import type { PresentationComponentPort } from "../../../contracts/presentation/index.js";
 /** Terminal-cell width authority used by Pi-rendered component rows. */
 export declare const piShellVisibleWidth: typeof visibleWidth;
@@ -37,6 +37,8 @@ export interface PiShellEditorPort extends PiShellComponentPort {
     setSubmitHandler(handler: (text: string) => void): void;
     setInterruptHandler(handler: () => void): void;
     setAutocompleteCommands(commands: readonly PiShellAutocompleteCommand[]): void;
+    setPaddingX(padding: number): void;
+    setAutocompleteMaxVisible(maxVisible: number): void;
     addAutocompleteProvider(factory: unknown): void;
     setThinkingLevel(level: OwnedUiThinkingLevel): void;
     hasSelection(): boolean;
@@ -55,6 +57,7 @@ export interface PiShellViewComponentPort extends PiShellComponentPort {
 }
 export interface PiShellStatusPort extends PiShellViewComponentPort {
     setWorkingOverride(message: string | undefined): void;
+    setOutputPad(padding: 0 | 1): void;
 }
 export interface PiShellQueuedInputPort extends PiShellComponentPort {
     update(submissions: readonly string[]): void;
@@ -73,6 +76,9 @@ export interface PiShellResourceEntry {
 export interface PiShellLoadedResourcesPort extends PiShellComponentPort {
     setExpanded(expanded: boolean): void;
 }
+export interface PiShellImageAssetResolver {
+    resolve(assetId: string): OwnedUiImageAttachment | null;
+}
 export interface PiShellExtensionRendererResolver {
     getMessageRenderer(customType: string): unknown;
     getToolDefinition(toolName: string): unknown;
@@ -82,6 +88,10 @@ export interface PiShellTranscriptComponentPort extends PiShellComponentPort {
     readonly revision: number;
     update(block: OwnedUiTranscriptBlock): void;
     setExpanded(expanded: boolean): void;
+    setOutputPad(padding: 0 | 1): void;
+    setHideThinkingBlock(hidden: boolean): void;
+    setMermaidRenderingMode(mode: "off" | "final" | "streaming"): void;
+    setImagePresentation(showImages: boolean, imageWidthCells: number): void;
 }
 export interface PiShellStartupNotice {
     readonly kind: "info" | "warning" | "error";

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

@@ -1,11 +1,16 @@
 import { type AgentSessionRuntime, type AgentSessionServices, type SessionInfo } from "@earendil-works/pi-coding-agent";
-import { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, type OwnedUiCommand, type OwnedUiCommandOutcome, type OwnedUiEvent, type OwnedUiSessionViewModel, type OwnedUiSnapshot } from "../../../contracts/owned-ui/index.js";
+import { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, type OwnedUiCommand, type OwnedUiCommandOutcome, type OwnedUiImageAttachment, type OwnedUiEvent, type OwnedUiSessionViewModel, type OwnedUiSnapshot } from "../../../contracts/owned-ui/index.js";
 import { type PiAuthenticationProviderOption, type PiBashWorkflowResult, type PiPinnedSettingsCallback, type PiPinnedSettingsSnapshot, type PiWorkflowAutocompleteCommand, type PiWorkflowHost, type PiWorkflowInteractionHost, type PiWorkflowOption, type PiWorkflowRequest, type PiWorkflowResult } from "./workflows.js";
-import type { AgentSettingsPort } from "../../../contracts/agent-engine/index.js";
+import { PiSettingsIntegration } from "./settings-integration.js";
+import type { PiSettingOwnerHandlers } from "./settings-effects.js";
+import type { PiProjectTrustPreflightPrompt } from "./project-trust-preflight.js";
+import type { AgentSettingOwner } from "../../../contracts/agent-engine/index.js";
 export interface PiEngineRuntimeFactoryInput {
     readonly cwd: string;
     readonly agentDir: string;
     readonly sessionId: string;
+    readonly sessionPath?: string;
+    readonly projectTrustPrompt?: PiProjectTrustPreflightPrompt;
 }
 export interface PiScopedModelDescriptor {
     readonly provider: string;
@@ -90,6 +95,7 @@ export interface PiEngineAdapterOptions {
     readonly cwd?: string;
     readonly agentDir?: string;
     readonly sessionId?: string;
+    readonly sessionPath?: string;
     readonly createRuntime?: PiEngineRuntimeFactory;
     readonly workflowHost?: PiWorkflowHost;
     /**
@@ -98,6 +104,8 @@ export interface PiEngineAdapterOptions {
      * offering stay here.
      */
     readonly availableThemes?: () => readonly string[];
+    readonly settingsProductMode?: "bare" | "comparison";
+    readonly projectTrustPrompt?: PiProjectTrustPreflightPrompt;
     /**
      * Startup extension-package update probe, mirroring pinned Pi's interactive
      * mode. Returns display names of packages with updates available.
@@ -115,6 +123,8 @@ export declare class PiEngineAdapter {
     get sessionId(): string;
     get sessionGeneration(): number;
     get agentDir(): string;
+    resolveTranscriptImage(assetId: string): OwnedUiImageAttachment | null;
+    currentSessionFile(): string | null;
     get disposed(): boolean;
     start(): Promise<OwnedUiSessionViewModel>;
     onEvent(listener: (event: OwnedUiEvent) => void): () => void;
@@ -132,7 +142,8 @@ export declare class PiEngineAdapter {
      */
     configuredTheme(): string | undefined;
     /** Settings port for the live runtime, or null before the runtime is available. */
-    settingsPort(): AgentSettingsPort | null;
+    settingsPort(): PiSettingsIntegration | null;
+    bindSettingsOwner(owner: AgentSettingOwner, handlers: PiSettingOwnerHandlers): () => void;
     pinnedModelSelectorContext(): {
         readonly currentModel: unknown;
         readonly settingsManager: unknown;
@@ -160,7 +171,7 @@ export declare class PiEngineAdapter {
     clearQueuedWorkflows(): readonly string[];
     abortBashWorkflow(): void;
     executeBashWorkflow(command: string, excludeFromContext: boolean): Promise<PiBashWorkflowResult>;
-    applyPinnedSettingValue(callback: PiPinnedSettingsCallback, value: unknown): PiWorkflowResult;
+    applyPinnedSettingValue(callback: PiPinnedSettingsCallback, value: unknown): Promise<PiWorkflowResult>;
     executeWorkflow(request: PiWorkflowRequest): Promise<PiWorkflowResult>;
     view(): OwnedUiSessionViewModel;
     snapshot(): OwnedUiSnapshot;