@timurproko/a1 0.2.7-dev.1265 → 0.2.7-dev.1268

package/dist/features/session-naming/controller.js

@@ -0,0 +1,148 @@
+import { generateSessionName } from "./generate.js";
+function contextKey(context) {
+    return JSON.stringify([context.cwd.replace(/\\/g, "/"), context.branch, context.revision]);
+}
+/** One background naming chain per eligible prompt/context; owns no timers or engine objects. */
+export class SessionNamingController {
+    #options;
+    #unsubscribe;
+    #binding;
+    #seen = new Set();
+    #signature;
+    #epoch = 0;
+    #run;
+    #work;
+    #attempted;
+    #disposed = false;
+    constructor(options) {
+        this.#options = options;
+        this.#binding = options.backend.identity.sessionBindingGeneration;
+        this.#rememberTranscript();
+        this.#unsubscribe = options.backend.session.onEvent(event => this.#event(event));
+    }
+    settingsChanged() { if (!this.#options.enabled())
+        this.#invalidate(); }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#unsubscribe();
+        this.#invalidate();
+    }
+    #invalidate() {
+        this.#epoch++;
+        this.#attempted = undefined;
+        this.#run?.abort.abort();
+        this.#run = undefined;
+        this.#work?.abort.abort();
+        this.#work = undefined;
+    }
+    #rememberTranscript() {
+        this.#seen = new Set(this.#options.backend.session.view().transcript.filter(block => block.kind === "user").map(block => block.id));
+    }
+    #event(event) {
+        if (this.#disposed)
+            return;
+        const { backend } = this.#options;
+        if (this.#binding !== backend.identity.sessionBindingGeneration) {
+            this.#binding = backend.identity.sessionBindingGeneration;
+            this.#invalidate();
+            this.#attempted = undefined;
+            this.#signature = undefined;
+            this.#rememberTranscript();
+        }
+        if (event.type === "session-view") {
+            const footer = event.view.status.footer;
+            const signature = JSON.stringify([footer?.repositoryPath, footer?.branch, footer?.repositoryRevision]);
+            if (this.#signature !== undefined && signature !== this.#signature)
+                this.#checkContext();
+            this.#signature = signature;
+            if (this.#run)
+                for (const block of event.view.transcript)
+                    if (block.kind === "user")
+                        this.#prompt(block.id, block.text);
+        }
+        if (event.type === "agent-run-started") {
+            this.#run?.abort.abort();
+            const run = { epoch: this.#epoch, abort: new AbortController() };
+            this.#run = run;
+            if (!this.#options.enabled())
+                return;
+            const state = this.#options.naming.state();
+            if (!state)
+                return;
+            run.state = state;
+            void this.#options.withContext(context => context, run.abort.signal).then(context => {
+                if (this.#run !== run || run.epoch !== this.#epoch || run.abort.signal.aborted
+                    || state.binding !== backend.identity.sessionBindingGeneration)
+                    return;
+                run.context = context;
+                if (this.#work && this.#work.key !== contextKey(context)) {
+                    this.#work.abort.abort();
+                    this.#work = undefined;
+                }
+                this.#launch(run);
+            }).catch(() => { });
+            for (const block of backend.session.view().transcript)
+                if (block.kind === "user")
+                    this.#prompt(block.id, block.text);
+        }
+        if (event.type === "transcript-block" && event.block.kind === "user")
+            this.#prompt(event.block.id, event.block.text);
+        if (event.type === "agent-run-settled" && this.#run?.prompt === undefined) {
+            this.#run?.abort.abort();
+            this.#run = undefined;
+        }
+        if (event.type === "session-lifecycle" && ["stopping", "stopped", "failed"].includes(event.lifecycle))
+            this.#invalidate();
+    }
+    #checkContext() {
+        const run = this.#run;
+        if (!run)
+            return;
+        run.checking = true;
+        void this.#options.withContext(context => context, run.abort.signal).then(current => {
+            if (this.#run !== run || run.abort.signal.aborted || this.#disposed)
+                return;
+            if (run.context && contextKey(current) !== contextKey(run.context)) {
+                this.#invalidate();
+                return;
+            }
+            run.checking = false;
+            this.#launch(run);
+        }).catch(() => { });
+    }
+    #prompt(id, text) {
+        if (this.#seen.has(id))
+            return;
+        this.#seen.add(id);
+        const run = this.#run;
+        if (!run || !text.trim() || text.trimStart().startsWith("/"))
+            return;
+        run.prompt = text.trim();
+        this.#launch(run);
+    }
+    #launch(run) {
+        const { context, state, prompt } = run;
+        if (!context || !state || !prompt || run.checking || this.#disposed || !this.#options.enabled()
+            || run.abort.signal.aborted || run.epoch !== this.#epoch || state.source === "user")
+            return;
+        const repositoryKey = contextKey(context);
+        const key = JSON.stringify([state.sessionFile, repositoryKey]);
+        if (state.completedContext === key || this.#attempted === key || this.#work)
+            return;
+        this.#attempted = key;
+        const work = new AbortController();
+        this.#work = { abort: work, key: repositoryKey };
+        void generateSessionName(prompt, `${context.cwd.split(/[\\/]/).at(-1) ?? ""} (${context.branch ?? "no branch"})`, request => this.#options.naming.complete(request), work.signal).then(name => {
+            if (work.signal.aborted || this.#disposed || !this.#options.enabled())
+                return;
+            return this.#options.withContext(current => {
+                if (contextKey(current) !== repositoryKey || work.signal.aborted || this.#disposed || !this.#options.enabled())
+                    return false;
+                return this.#options.naming.apply(state, name, key);
+            }, work.signal);
+        }).catch(() => { }).finally(() => { if (this.#work?.abort === work)
+            this.#work = undefined; });
+    }
+}

package/dist/features/session-naming/generate.d.ts

@@ -0,0 +1,3 @@
+import type { OwnedUiSessionNameCompletion } from "../../contracts/owned-ui/index.js";
+/** Two bounded tool-free attempts; cancellation never becomes an automatic fallback. */
+export declare function generateSessionName(prompt: string, hints: string, complete: (request: OwnedUiSessionNameCompletion) => Promise<string | null>, signal: AbortSignal, timeoutMs?: number): Promise<string>;

package/dist/features/session-naming/generate.js

@@ -0,0 +1,44 @@
+function normalize(value) {
+    const name = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+    if (!name)
+        return null;
+    if (name.length <= 16)
+        return name;
+    const boundary = name.slice(0, 17).lastIndexOf("-");
+    return (boundary >= 4 ? name.slice(0, boundary) : name.slice(0, 16)).replace(/-+$/g, "") || null;
+}
+/** Two bounded tool-free attempts; cancellation never becomes an automatic fallback. */
+export async function generateSessionName(prompt, hints, complete, signal, timeoutMs = 30_000) {
+    for (const maxTokens of [4_096, 32_768]) {
+        signal.throwIfAborted();
+        const deadline = new AbortController();
+        const attempt = AbortSignal.any([signal, deadline.signal]);
+        const timer = setTimeout(() => deadline.abort(), timeoutMs);
+        timer.unref?.();
+        let aborted;
+        try {
+            const cancelled = new Promise((_, reject) => {
+                aborted = () => reject(attempt.reason);
+                attempt.addEventListener("abort", aborted, { once: true });
+            });
+            const response = await Promise.race([complete({
+                    prompt: `Name this coding task with a lowercase hyphenated title of at most 16 characters. Reply only with the title.\nRepository hints: ${hints.slice(0, 300)}\n<task>\n${prompt.slice(0, 500)}\n</task>`,
+                    maxTokens, signal: attempt,
+                }), cancelled]);
+            signal.throwIfAborted();
+            const name = response === null ? null : normalize(response);
+            if (name !== null)
+                return name;
+        }
+        catch {
+            signal.throwIfAborted();
+        }
+        finally {
+            clearTimeout(timer);
+            if (aborted)
+                attempt.removeEventListener("abort", aborted);
+        }
+    }
+    signal.throwIfAborted();
+    return normalize((prompt.toLowerCase().match(/[a-z0-9]+/g) ?? []).slice(0, 3).join("-")) ?? "new-task";
+}

package/dist/features/session-naming/index.d.ts

@@ -0,0 +1,2 @@
+export { SessionNamingController } from "./controller.js";
+export type { SessionNamingContext } from "./controller.js";

package/dist/features/session-naming/index.js

@@ -0,0 +1 @@
+export { SessionNamingController } from "./controller.js";

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

@@ -5,5 +5,5 @@ export { resolveProductPaths } from "./paths.js";
 export type { ProductPaths } from "./paths.js";
 export { parseSessionSelection, sessionSelectionArguments } from "./session-selection.js";
 export type { SessionSelection } from "./session-selection.js";
-export { PRIMARY_SESSION_AGENT_ID, activateSessionRepositoryContext, clearSessionRepositoryContext, listSessionRepositoryWorktrees, readSessionRepositoryContext, registerSessionRepositoryRuntime, releaseSessionRepositoryRuntime, setSessionRepositoryContext, } from "./session-repository-context.js";
-export type { SessionRepositoryContext, SessionRepositoryContextOptions, SessionRepositoryIdentity, SessionWorktreeInventoryEntry, SessionWorktreeStatus, } from "./session-repository-context.js";
+export { PRIMARY_SESSION_AGENT_ID, activateSessionRepositoryContext, clearSessionRepositoryContext, listSessionRepositoryWorktrees, readSessionRepositoryContext, registerSessionRepositoryRuntime, releaseSessionRepositoryRuntime, setSessionRepositoryContext, withSessionRepositoryObservation, } from "./session-repository-context.js";
+export type { SessionRepositoryContext, SessionRepositoryContextOptions, SessionRepositoryIdentity, SessionRepositoryObservation, SessionWorktreeInventoryEntry, SessionWorktreeStatus, } from "./session-repository-context.js";

package/dist/foundation/lifecycle/index.js

@@ -2,4 +2,4 @@ export { assertLaunchProfileId } from "./model.js";
 export { PID_LIVENESS_IDENTITY, inspectLiveProcess } from "./process-liveness.js";
 export { resolveProductPaths } from "./paths.js";
 export { parseSessionSelection, sessionSelectionArguments } from "./session-selection.js";
-export { PRIMARY_SESSION_AGENT_ID, activateSessionRepositoryContext, clearSessionRepositoryContext, listSessionRepositoryWorktrees, readSessionRepositoryContext, registerSessionRepositoryRuntime, releaseSessionRepositoryRuntime, setSessionRepositoryContext, } from "./session-repository-context.js";
+export { PRIMARY_SESSION_AGENT_ID, activateSessionRepositoryContext, clearSessionRepositoryContext, listSessionRepositoryWorktrees, readSessionRepositoryContext, registerSessionRepositoryRuntime, releaseSessionRepositoryRuntime, setSessionRepositoryContext, withSessionRepositoryObservation, } from "./session-repository-context.js";

package/dist/foundation/lifecycle/session-repository-context.d.ts

@@ -37,5 +37,17 @@ export declare function setSessionRepositoryContext(identity: SessionRepositoryI
 export declare function clearSessionRepositoryContext(identity: SessionRepositoryIdentity, options?: SessionRepositoryContextOptions): Promise<void>;
 /** Read and revalidate a persisted association; malformed or stale state fails closed to absence. */
 export declare function readSessionRepositoryContext(identity: SessionRepositoryIdentity, options?: SessionRepositoryContextOptions): Promise<SessionRepositoryContext | null>;
+/** A verified naming context. Revision changes on explicit association transitions, not heartbeats. */
+export interface SessionRepositoryObservation {
+    readonly cwd: string;
+    readonly branch: string | null;
+    readonly revision: string;
+}
+/**
+ * Observe and synchronously consume a context under the existing mutation gate. Missing records
+ * mean unlinked; malformed, inaccessible, or invalid associations throw instead of inventing exits.
+ * The callback must not perform asynchronous work; provider I/O never holds this gate.
+ */
+export declare function withSessionRepositoryObservation<T>(identity: SessionRepositoryIdentity, consume: (context: SessionRepositoryObservation) => T, options?: SessionRepositoryContextOptions): Promise<T>;
 /** List same-repository worktrees without acquiring, releasing, or repairing a claim. */
 export declare function listSessionRepositoryWorktrees(identity: SessionRepositoryIdentity, options?: SessionRepositoryContextOptions): Promise<readonly SessionWorktreeInventoryEntry[]>;

package/dist/foundation/lifecycle/session-repository-context.js

@@ -86,9 +86,12 @@ export async function setSessionRepositoryContext(identity, worktreePath, option
         if (status === "unverifiable")
             throw contextError("worktree ownership cannot be verified", "worktree-owner-unverifiable");
         const prior = await readContextRecord(header, options);
+        const unchanged = prior !== null && samePath(prior.worktreeGitDir, selected.gitDir)
+            && await validateContextRecord(header, prior, options.signal).then(() => true, () => false);
+        const revision = unchanged ? prior.revision ?? randomUUID() : randomUUID();
         await writeClaim(header, selected, owner, processIdentityOf(runtime), options);
         try {
-            await writeContextRecord(header, startup, selected, options);
+            await writeContextRecord(header, startup, selected, revision, options);
         }
         catch (error) {
             if (status !== "current")
@@ -106,7 +109,7 @@ export async function setSessionRepositoryContext(identity, worktreePath, option
 export async function clearSessionRepositoryContext(identity, options = {}) {
     const header = await readSessionHeader(identity);
     if (options.runtimeId === undefined) {
-        await rm(contextRecordPath(header, options), { force: true });
+        await withClaimLock(options, async () => { await rm(contextRecordPath(header, options), { force: true }); });
         return;
     }
     const owner = { runtimeId: requireRuntimeId(options), agentId: requireAgentId(options) };
@@ -131,6 +134,57 @@ export async function readSessionRepositoryContext(identity, options = {}) {
     const selected = await validateContextRecord(header, record, options.signal).catch(() => null);
     return selected === null ? null : { cwd: selected.root, branch: requireBranch(selected) };
 }
+/**
+ * Observe and synchronously consume a context under the existing mutation gate. Missing records
+ * mean unlinked; malformed, inaccessible, or invalid associations throw instead of inventing exits.
+ * The callback must not perform asynchronous work; provider I/O never holds this gate.
+ */
+export async function withSessionRepositoryObservation(identity, consume, options = {}) {
+    const header = await readSessionHeader(identity);
+    return await withClaimLock(options, async () => {
+        let record = null;
+        try {
+            const path = contextRecordPath(header, options);
+            const metadata = await lstat(path);
+            if (!metadata.isFile() || metadata.isSymbolicLink() || metadata.size > MAX_RECORD_BYTES)
+                throw new Error("invalid repository context");
+            const value = JSON.parse(await readFile(path, { encoding: "utf8", signal: options.signal }));
+            if (!isContextRecord(value))
+                throw new Error("invalid repository context");
+            record = value;
+        }
+        catch (error) {
+            if (!(error instanceof Error && "code" in error && error.code === "ENOENT"))
+                throw error;
+        }
+        let context;
+        if (record !== null) {
+            const selected = await validateContextRecord(header, record, options.signal);
+            const revision = record.revision ?? randomUUID();
+            if (record.revision === undefined)
+                await atomicWrite(contextRecordPath(header, options), { ...record, revision });
+            context = { cwd: selected.root, branch: selected.branch, revision };
+        }
+        else {
+            let cwd = await realpath(header.cwd);
+            let branch;
+            try {
+                const selected = await readGitWorktreeIdentity(cwd, false, options.signal);
+                cwd = selected.root;
+                const result = await executeGit(["branch", "--show-current"], cwd, 4_096, options.signal);
+                branch = result.stdout.trim() || null;
+            }
+            catch (error) {
+                if (!(error instanceof Error && "stderr" in error && String(error.stderr).includes("not a git repository")))
+                    throw error;
+                branch = null;
+            }
+            context = { cwd, branch, revision: "unlinked" };
+        }
+        options.signal?.throwIfAborted();
+        return consume(context);
+    });
+}
 /** List same-repository worktrees without acquiring, releasing, or repairing a claim. */
 export async function listSessionRepositoryWorktrees(identity, options = {}) {
     const header = await readSessionHeader(identity);
@@ -223,9 +277,10 @@ async function writeRuntimeRecord(header, runtimeId, agentId, runtimeIdentity, o
     };
     await atomicWrite(runtimeRecordPath({ runtimeId, agentId }, options), record);
 }
-async function writeContextRecord(header, startup, selected, options) {
+async function writeContextRecord(header, startup, selected, revision, options) {
     const record = {
         schema: CONTEXT_SCHEMA,
+        revision,
         sessionId: header.id,
         sessionFile: header.file,
         startupRoot: startup.root,
@@ -554,6 +609,7 @@ function validPath(value) {
 }
 function isContextRecord(value) {
     return isRecord(value) && value.schema === CONTEXT_SCHEMA && validSessionId(value.sessionId)
+        && (value.revision === undefined || validSessionId(value.revision))
         && validPath(value.sessionFile) && validPath(value.startupRoot) && validPath(value.startupCommonDir)
         && validPath(value.worktreeRoot) && validPath(value.worktreeCommonDir) && validPath(value.worktreeGitDir)
         && typeof value.updatedAt === "string";

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

@@ -142,6 +142,7 @@ export function createPiShellFooter(view, cwd, profile = "pi", showLevel = () =>
     const footer = new SessionFooter(() => view, cwd, profile, showLevel);
     return {
         render: width => footer.render(width),
+        setNameReveal: frame => footer.setNameReveal(frame),
         invalidate: () => footer.invalidate(),
         update(next) { view = next; },
         dispose: () => footer.dispose(),

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

@@ -123,20 +123,17 @@ function withTranscriptImages(component, block, assets, showImages, imageWidthCe
     if (component instanceof ToolExecutionComponent)
         return component;
     const references = block.imageReferences ?? [];
-    if (references.length === 0)
+    if (!showImages || references.length === 0)
         return component;
     const container = new Container();
     container.addChild(component);
     const imageProtocolUnavailable = getCapabilities().images === null;
     for (const reference of references) {
-        if (showImages && imageProtocolUnavailable)
+        if (imageProtocolUnavailable)
             continue;
         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) {
+        if (asset === null) {
             container.addChild(new Text(piTheme().fg("warning", `[Image unavailable: ${reference.mimeType}]`), 1, 0));
         }
         else {

package/dist/integrations/pi/components/upstream/components/session-footer.d.ts

@@ -1,6 +1,7 @@
 import { type Component } from "@earendil-works/pi-tui";
 import type { OwnedUiSessionViewModel } from "../../../../../contracts/owned-ui/index.js";
 export declare class SessionFooter implements Component {
+    #private;
     private readonly getView;
     private readonly cwd;
     private readonly profile;
@@ -8,5 +9,9 @@ export declare class SessionFooter implements Component {
     constructor(getView: () => OwnedUiSessionViewModel, cwd: string, profile?: "pi" | "a1", show?: () => boolean);
     invalidate(): void;
     dispose(): void;
+    setNameReveal(frame: {
+        readonly from: string;
+        readonly elapsed: number;
+    } | null): boolean;
     render(width: number): string[];
 }

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

@@ -1,19 +1,22 @@
 /**
  * Provenance: @earendil-works/pi-coding-agent 1.5.0 (MIT), commit f9a26365568127461c47a07a37dcb42c140a3ac5,
  * packages/coding-agent/src/modes/interactive/components/footer.ts.
- * Modifications: Owned UI/routing; A1 level color, linked PRs, dim ellipsis and model priority; Pi
- * unchanged.
+ * Modifications: Owned UI/routing; A1 level color, linked PRs, dim ellipsis, model priority, and
+ * secondary-accent name reveals after stats; Pi unchanged.
  * Deviations: owned-status-level-color, owned-pull-request-badge, owned-footer-ellipsis,
- * owned-footer-model-priority.
+ * owned-footer-model-priority, owned-session-name-reveal.
  */
 import { isAbsolute, relative, resolve, sep } from "node:path";
 import { hyperlink, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { piTheme } from "../../theme.js";
+import { sessionNameFrame } from "../../../../../ui/components/session-name-frame.js";
 export class SessionFooter {
     getView;
     cwd;
     profile;
     show;
+    #reveal = null;
+    #nameBudget = Number.MAX_SAFE_INTEGER;
     constructor(getView, cwd, profile = "pi", show = () => true) {
         this.getView = getView;
         this.cwd = cwd;
@@ -21,7 +24,33 @@ export class SessionFooter {
         this.show = show;
     }
     invalidate() { }
-    dispose() { }
+    dispose() { this.#reveal = null; }
+    setNameReveal(frame) {
+        this.#reveal = this.profile === "a1" ? frame : null;
+        if (this.#reveal && this.#nameFrame(this.getView().status.footer?.sessionName ?? "", this.#nameBudget).done)
+            this.#reveal = null;
+        return this.#reveal !== null;
+    }
+    #nameFrame(name, width) {
+        const theme = piTheme();
+        const secondary = rgb(theme.getFgAnsi("mdHeading"));
+        const settled = rgb(theme.getFgAnsi("dim"));
+        if (!this.#reveal)
+            return { text: theme.fg("dim", truncateToWidth(name, width, "…")), done: true };
+        return sessionNameFrame({
+            ...this.#reveal, to: name, width,
+            truecolor: theme.getColorMode() === "truecolor" && secondary !== null && settled !== null,
+            measure: visibleWidth, clip: (text, columns) => truncateToWidth(text, columns, "…"),
+            dim: text => theme.fg("dim", text),
+            paint: (text, brightness, progress) => {
+                const channels = secondary.map((value, index) => {
+                    const bright = value + (235 - value) * brightness;
+                    return Math.round(bright + (settled[index] - bright) * progress);
+                });
+                return `\u001b[38;2;${channels.join(";")}m${text}\u001b[39m`;
+            },
+        });
+    }
     render(width) {
         const view = this.getView();
         const usage = view.status.usage;
@@ -45,13 +74,12 @@ export class SessionFooter {
         const pullRequest = this.profile === "a1" ? view.status.footer?.pullRequest : null;
         let pathRow;
         if (pullRequest == null) {
-            pathRow = theme.fg("dim", sessionName ? `${pwd} • ${sessionName}` : pwd);
+            pathRow = theme.fg("dim", this.profile === "pi" && sessionName ? `${pwd} • ${sessionName}` : pwd);
         }
         else {
             const badge = theme.fg("dim", " ")
                 + hyperlink(theme.fg("mdLink", `#${pullRequest.number}`), pullRequest.url);
-            const sessionSuffix = sessionName ? theme.fg("dim", ` • ${sessionName}`) : "";
-            const full = theme.fg("dim", pwd) + badge + sessionSuffix;
+            const full = theme.fg("dim", pwd) + badge;
             if (visibleWidth(full) <= width)
                 pathRow = full;
             else if (visibleWidth(badge) <= width) {
@@ -111,6 +139,11 @@ export class SessionFooter {
             leftWidth = visibleWidth(left);
         }
         const rightWidth = visibleWidth(right);
+        this.#nameBudget = Math.max(0, width - leftWidth - rightWidth - 2 - 3);
+        if (this.profile === "a1" && sessionName && this.#nameBudget > 0) {
+            left += theme.fg("dim", " • ") + this.#nameFrame(sessionName, this.#nameBudget).text;
+            leftWidth = visibleWidth(left);
+        }
         let line;
         if (this.profile === "a1" && leftWidth === 0) {
             line = " ".repeat(Math.max(0, width - rightWidth)) + right;
@@ -139,6 +172,10 @@ export class SessionFooter {
         return lines;
     }
 }
+function rgb(ansi) {
+    const match = /\u001b\[38;2;(\d+);(\d+);(\d+)m/u.exec(ansi);
+    return match ? match.slice(1).map(Number) : null;
+}
 function sanitize(text) { return text.replace(/[\r\n\t]/g, " ").replace(/ +/g, " ").trim(); }
 function formatTokens(count) {
     if (count < 1000)

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

@@ -4,14 +4,14 @@
  * 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. Omit
- * non-actionable image fallback rows when the terminal has no image protocol. See
+ * non-actionable image fallback rows when images are hidden or 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,
- * unsupported-image-fallback-omission.
+ * unsupported-image-fallback-omission, hidden-image-fallback-omission.
  */
 import { stripVTControlCharacters } from "node:util";
-import { Box, Container, getImageDimensions, imageFallback, MouseRegion, Spacer, Text } from "@earendil-works/pi-tui";
+import { Box, Container, 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";
@@ -392,11 +392,7 @@ export class ToolExecutionComponent extends Container {
     getTextOutput() {
         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 (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;
+        return this.result.content.filter(part => part.type === "text").map(part => stripVTControlCharacters(part.text ?? "").replace(/[\u0000-\u0008\u000b-\u001f\ufff9-\ufffb]/gu, "")).join("\n");
     }
     formatToolExecution() {
         const theme = piTheme();

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

@@ -1,9 +1,10 @@
 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 { PiWorkflowHost, PiWorkflowInteractionHost, PiWorkflowRequest, PiWorkflowResult } from "./workflows.js";
+import type { PiWorkflowHost, PiWorkflowRequest, PiWorkflowResult } from "./workflows.js";
 import type { PiSettingsBridge } from "./settings-bridge.js";
 import type { PiProjectTrustPreflightPrompt } from "./project-trust-preflight.js";
 import type { PiSessionForkPrompt, PiSessionSelection } from "./session-selection.js";
 import { type AdapterCommandResult } from "./command-dispatch.js";
+import { PiSessionNaming } from "./session-naming.js";
 import { type PiEnginePackageUpdateProbe, type PiEngineRuntimeFactory, type PiRepositoryContextReader } from "./session-runtime.js";
 import { type PiEngineHostSessionPorts } from "./host-ports.js";
 import { type PiEngineAnnouncements, type PiSessionPresentationSource } from "./ports.js";
@@ -60,7 +61,7 @@ export declare class PiEngineAdapter implements OwnedUiSessionBackend, OwnedUiPr
     get announcements(): PiEngineAnnouncements;
     /** The Pi objects behind pinned selectors and renderers, for the session presenters owner only. */
     presentationSource(): PiSessionPresentationSource;
-    setWorkflowInteractionHost(interaction: PiWorkflowInteractionHost): void;
+    get naming(): PiSessionNaming;
     suggestionReasoningPolicy(): OwnedUiPromptSuggestionReasoning;
     generate(request: OwnedUiPromptSuggestionRequest): Promise<OwnedUiPromptSuggestionResult>;
     start(): Promise<OwnedUiSessionViewModel>;