@agi-fans/dsh-tui 0.18.0 → 0.19.0

package/lib/runtime/tool-presentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-presentation.js","sourceRoot":"","sources":["../../src/runtime/tool-presentation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-presentation.js","sourceRoot":"","sources":["../../src/runtime/tool-presentation.ts"],"names":[],"mappings":"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"}

package/lib/session/feature-toggles.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Optional product features and the Profile-patch block that turns them off.
+ *
+ * A feature is a composition row a deployment may not want: it costs context,
+ * runtime, or transcript noise. The row's `disabled` field is a Loader option
+ * rather than plugin config, so the settings service cannot write it — the
+ * Loader does read a Profile patch's `disabled`, and that patch is the
+ * documented, user-authored surface for exactly this.
+ *
+ * The writes therefore maintain one clearly delimited block in the Profile
+ * patch and touch nothing else in the file, so hand-written rows, `!!js`
+ * expressions, and comments all survive a toggle. Toggling takes effect on the
+ * next launch: the Harness reads the patch once while composing the tree.
+ * @module @agi-fans/dsh-tui
+ */
+/** One optional product feature, addressed by the row id it disables. */
+export interface FeatureToggle {
+    /** Composition row id; the key a Profile patch keys its override by. */
+    id: string;
+    /** Short row label for the settings overlay. */
+    label: string;
+    /** What the feature does, and what turning it off costs. */
+    description: string;
+    /** Whether the shipped composition mounts it. */
+    enabledByDefault: boolean;
+}
+/**
+ * Features this build can turn off.
+ *
+ * Rows that make the agent non-functional (`tool-fs`, `tool-bash`, `todo`), rows
+ * that back a command (`session-query` backs `/sessions`, `workspace` backs
+ * `@` mentions), and rows that are already conditional at no cost
+ * (`mcp-resources` appears only with a connected MCP server) are deliberately
+ * absent. `tool-web` is absent for a different reason: `web_search` and
+ * `web_fetch` share one row, so no row-level toggle can express "search off,
+ * fetch on".
+ */
+export declare const FEATURE_TOGGLES: readonly FeatureToggle[];
+/** Opening delimiter of the block this module owns. */
+export declare const FEATURE_BLOCK_BEGIN = "# >>> omdsh feature toggles >>>";
+/** Closing delimiter of the block this module owns. */
+export declare const FEATURE_BLOCK_END = "# <<< omdsh feature toggles <<<";
+/** Current on/off state of every feature, keyed by row id. */
+export type FeatureStates = Readonly<Record<string, boolean>>;
+/** The shipped composition's state, before any Profile patch override. */
+export declare function defaultFeatureStates(features?: readonly FeatureToggle[]): Record<string, boolean>;
+/**
+ * Apply the `disabled` rows a Profile patch declares on top of the defaults.
+ *
+ * Only rows this build knows a feature for are read: a patch may disable any
+ * row for its own reasons, and an unknown id is not a feature toggle.
+ *
+ * @param states - the shipped defaults.
+ * @param disabled - row ids the patch marks `disabled: true`.
+ * @returns a new state map with those features off.
+ */
+export declare function applyDisabledRows(states: Record<string, boolean>, disabled: readonly string[]): Record<string, boolean>;
+/**
+ * Row ids that must be disabled to make `states` true, ignoring rows already
+ * off in the shipped composition.
+ *
+ * @param states - desired feature state.
+ * @returns the row ids a patch has to mark `disabled: true`.
+ */
+export declare function rowsToDisable(states: FeatureStates): string[];
+/**
+ * Render the managed block for the features that are off.
+ *
+ * The block is written unconditionally so it always states the full set the
+ * build manages; re-enabling a feature is removing its row from here.
+ *
+ * @param states - desired feature state.
+ * @returns the block text, including a trailing newline.
+ */
+export declare function renderFeatureBlock(states: FeatureStates): string;
+/**
+ * Replace the managed block, leaving every other byte of the patch untouched.
+ *
+ * A patch that carries no block is simply appended to, so a file the user has
+ * been editing by hand keeps its formatting, comments, and `!!js` expressions.
+ *
+ * @param text - current patch file contents.
+ * @param block - the block to install.
+ * @returns the new patch file contents.
+ */
+export declare function replaceFeatureBlock(text: string, block: string): string;
+/**
+ * Read the feature state a patch file currently declares.
+ *
+ * Only the managed block is parsed, by row id, so a hand-written
+ * `disabled: true` elsewhere in the file is left for the composition to honour
+ * and is not double-counted as a feature toggle.
+ *
+ * @param text - patch file contents.
+ * @param features - known features; defaults to the shipped registry.
+ * @returns the state the block declares over the shipped defaults.
+ */
+export declare function featureStatesFromPatch(text: string, features?: readonly FeatureToggle[]): Record<string, boolean>;
+/** Absolute path of the Profile patch this build edits. */
+export declare function featurePatchPath(dshHome: string): string;

package/lib/session/feature-toggles.js

@@ -0,0 +1,170 @@
+/**
+ * Optional product features and the Profile-patch block that turns them off.
+ *
+ * A feature is a composition row a deployment may not want: it costs context,
+ * runtime, or transcript noise. The row's `disabled` field is a Loader option
+ * rather than plugin config, so the settings service cannot write it — the
+ * Loader does read a Profile patch's `disabled`, and that patch is the
+ * documented, user-authored surface for exactly this.
+ *
+ * The writes therefore maintain one clearly delimited block in the Profile
+ * patch and touch nothing else in the file, so hand-written rows, `!!js`
+ * expressions, and comments all survive a toggle. Toggling takes effect on the
+ * next launch: the Harness reads the patch once while composing the tree.
+ * @module @agi-fans/dsh-tui
+ */
+import { join } from 'node:path';
+/**
+ * Features this build can turn off.
+ *
+ * Rows that make the agent non-functional (`tool-fs`, `tool-bash`, `todo`), rows
+ * that back a command (`session-query` backs `/sessions`, `workspace` backs
+ * `@` mentions), and rows that are already conditional at no cost
+ * (`mcp-resources` appears only with a connected MCP server) are deliberately
+ * absent. `tool-web` is absent for a different reason: `web_search` and
+ * `web_fetch` share one row, so no row-level toggle can express "search off,
+ * fetch on".
+ */
+export const FEATURE_TOGGLES = [
+    {
+        id: 'workspace-changes',
+        label: 'Changed-file summary',
+        description: 'End every turn with the files it changed and their line counts. Off skips two Git snapshots per turn and the transcript row.',
+        enabledByDefault: true,
+    },
+    {
+        id: 'tool-session-query',
+        label: 'Session history tools',
+        description: 'Five tools that let the model search, trace and read its own earlier sessions. Off removes five tool schemas from every request.',
+        enabledByDefault: true,
+    },
+    {
+        id: 'tool-ralph',
+        label: 'Ralph loop',
+        description: 'Let the model re-run a task until it reports completion. Off by default because the tool is a self-report, not an evaluation.',
+        enabledByDefault: false,
+    },
+    {
+        id: 'repeat-tool-reminder',
+        label: 'Repeat-tool reminder',
+        description: 'Nudge the model out of identical tool-call loops. Off removes the advisory text those nudges add to the context.',
+        enabledByDefault: true,
+    },
+];
+/** Opening delimiter of the block this module owns. */
+export const FEATURE_BLOCK_BEGIN = '# >>> omdsh feature toggles >>>';
+/** Closing delimiter of the block this module owns. */
+export const FEATURE_BLOCK_END = '# <<< omdsh feature toggles <<<';
+/** The shipped composition's state, before any Profile patch override. */
+export function defaultFeatureStates(features = FEATURE_TOGGLES) {
+    return Object.fromEntries(features.map(feature => [feature.id, feature.enabledByDefault]));
+}
+/**
+ * Apply the `disabled` rows a Profile patch declares on top of the defaults.
+ *
+ * Only rows this build knows a feature for are read: a patch may disable any
+ * row for its own reasons, and an unknown id is not a feature toggle.
+ *
+ * @param states - the shipped defaults.
+ * @param disabled - row ids the patch marks `disabled: true`.
+ * @returns a new state map with those features off.
+ */
+export function applyDisabledRows(states, disabled) {
+    const known = new Set(FEATURE_TOGGLES.map(feature => feature.id));
+    const next = { ...states };
+    for (const id of disabled)
+        if (known.has(id))
+            next[id] = false;
+    return next;
+}
+/**
+ * Row ids that must be disabled to make `states` true, ignoring rows already
+ * off in the shipped composition.
+ *
+ * @param states - desired feature state.
+ * @returns the row ids a patch has to mark `disabled: true`.
+ */
+export function rowsToDisable(states) {
+    return FEATURE_TOGGLES
+        .filter(feature => feature.enabledByDefault && states[feature.id] === false)
+        .map(feature => feature.id);
+}
+/**
+ * Render the managed block for the features that are off.
+ *
+ * The block is written unconditionally so it always states the full set the
+ * build manages; re-enabling a feature is removing its row from here.
+ *
+ * @param states - desired feature state.
+ * @returns the block text, including a trailing newline.
+ */
+export function renderFeatureBlock(states) {
+    const off = FEATURE_TOGGLES
+        .filter(feature => feature.enabledByDefault && states[feature.id] === false)
+        .map(feature => feature.id);
+    const lines = [FEATURE_BLOCK_BEGIN];
+    for (const id of off)
+        lines.push(`- id: ${id}`, '  disabled: true');
+    lines.push(FEATURE_BLOCK_END, '');
+    return lines.join('\n');
+}
+/**
+ * Replace the managed block, leaving every other byte of the patch untouched.
+ *
+ * A patch that carries no block is simply appended to, so a file the user has
+ * been editing by hand keeps its formatting, comments, and `!!js` expressions.
+ *
+ * @param text - current patch file contents.
+ * @param block - the block to install.
+ * @returns the new patch file contents.
+ */
+export function replaceFeatureBlock(text, block) {
+    const begin = text.indexOf(FEATURE_BLOCK_BEGIN);
+    const end = text.indexOf(FEATURE_BLOCK_END);
+    if (begin < 0 || end < 0 || end < begin) {
+        const head = text.trimEnd();
+        return head === '' ? block : `${head}\n\n${block}`;
+    }
+    const before = text.slice(0, begin).trimEnd();
+    const after = text.slice(end + FEATURE_BLOCK_END.length).replace(/^\n+/, '');
+    const head = before === '' ? '' : `${before}\n\n`;
+    const tail = after.trim() === '' ? '' : `\n${after}`;
+    return `${head}${block.trimEnd()}${tail}\n`;
+}
+/**
+ * Read the feature state a patch file currently declares.
+ *
+ * Only the managed block is parsed, by row id, so a hand-written
+ * `disabled: true` elsewhere in the file is left for the composition to honour
+ * and is not double-counted as a feature toggle.
+ *
+ * @param text - patch file contents.
+ * @param features - known features; defaults to the shipped registry.
+ * @returns the state the block declares over the shipped defaults.
+ */
+export function featureStatesFromPatch(text, features = FEATURE_TOGGLES) {
+    const begin = text.indexOf(FEATURE_BLOCK_BEGIN);
+    const end = text.indexOf(FEATURE_BLOCK_END);
+    const states = Object.fromEntries(features.map(f => [f.id, f.enabledByDefault]));
+    if (begin < 0 || end < 0 || end < begin)
+        return states;
+    let current;
+    for (const raw of text.slice(begin, end).split('\n')) {
+        const id = raw.match(/^\s*-\s*id:\s*(\S+)\s*$/u);
+        if (id !== null) {
+            current = id[1];
+            continue;
+        }
+        if (/^\s*disabled:\s*true\s*$/u.test(raw) && current !== undefined) {
+            if (Object.hasOwn(states, current))
+                states[current] = false;
+            current = undefined;
+        }
+    }
+    return states;
+}
+/** Absolute path of the Profile patch this build edits. */
+export function featurePatchPath(dshHome) {
+    return join(dshHome, 'profiles', 'omdsh', 'cordis.patch.yml');
+}
+//# sourceMappingURL=feature-toggles.js.map

package/lib/session/feature-toggles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-toggles.js","sourceRoot":"","sources":["../../src/session/feature-toggles.ts"],"names":[],"mappings":"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"}

package/lib/session/fold-policy.d.ts

@@ -0,0 +1,21 @@
+/** Compatibility for stored transcript preferences from earlier versions. */
+export declare const FOLD_DENSITIES: readonly ["compact", "standard", "detailed", "verbose"];
+export type FoldDensity = typeof FOLD_DENSITIES[number];
+/** @deprecated Turns now use one presentation policy. */
+export interface FoldPolicy {
+    groups: boolean;
+    tools: boolean;
+    reasoning: boolean;
+    detail: boolean;
+    subject: boolean;
+}
+export declare const DEFAULT_FOLD_DENSITY: FoldDensity;
+/** All legacy values resolve to the current turn presentation. */
+export declare function foldPolicy(_density: FoldDensity): FoldPolicy;
+export declare function isFoldDensity(value: string): value is FoldDensity;
+/** Old preferences remain readable but no longer select a different layout. */
+export declare function resolveFoldDensity(_prefs: {
+    foldDensity?: FoldDensity;
+    expandTools?: boolean;
+}): FoldDensity;
+export declare function foldPolicyKey(_policy: FoldPolicy): string;

package/lib/session/fold-policy.js

@@ -0,0 +1,15 @@
+/** Compatibility for stored transcript preferences from earlier versions. */
+export const FOLD_DENSITIES = ['compact', 'standard', 'detailed', 'verbose'];
+export const DEFAULT_FOLD_DENSITY = 'standard';
+const TURN_POLICY = { groups: true, tools: true, reasoning: false, detail: false, subject: true };
+/** All legacy values resolve to the current turn presentation. */
+export function foldPolicy(_density) { return TURN_POLICY; }
+export function isFoldDensity(value) {
+    return FOLD_DENSITIES.includes(value);
+}
+/** Old preferences remain readable but no longer select a different layout. */
+export function resolveFoldDensity(_prefs) {
+    return DEFAULT_FOLD_DENSITY;
+}
+export function foldPolicyKey(_policy) { return 'turn'; }
+//# sourceMappingURL=fold-policy.js.map

package/lib/session/fold-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-policy.js","sourceRoot":"","sources":["../../src/session/fold-policy.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAU,CAAA;AAYrF,MAAM,CAAC,MAAM,oBAAoB,GAAgB,UAAU,CAAA;AAC3D,MAAM,WAAW,GAAe,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AAE7G,kEAAkE;AAClE,MAAM,UAAU,UAAU,CAAC,QAAqB,IAAgB,OAAO,WAAW,CAAA,CAAC,CAAC;AAEpF,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAQ,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC9D,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,MAA4D;IAC7F,OAAO,oBAAoB,CAAA;AAC7B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAmB,IAAY,OAAO,MAAM,CAAA,CAAC,CAAC"}

package/lib/session/job-notice.d.ts

@@ -5,6 +5,10 @@
  */
 import type { Agent } from '@deepseek-ai/dsh-agent';
 import type { JobStatus, JobView } from '@deepseek-ai/dsh-jobs';
+import type { TuiNoticeOptions } from '../definition.ts';
+import type { TranscriptState } from '../views/transcript-types.ts';
+/** Merge only an identified job or an unambiguous command still awaiting its result. */
+export declare function mergeJobSettlement(state: TranscriptState, job: NonNullable<TuiNoticeOptions['job']>): TranscriptState | undefined;
 /** Past- or present-tense word for one lifecycle status. */
 export declare const JOB_STATUS_WORD: Record<JobStatus, string>;
 /** One human-facing completion line for a background job. */

package/lib/session/job-notice.js

@@ -3,6 +3,45 @@
  * notice, so one job reads the same in both surfaces.
  * @module @agi-fans/dsh-tui/job-notice
  */
+import { toolArgsObject } from "../chrome/tool-args.js";
+import { truncateToWidth, visibleWidth } from "../chrome/width.js";
+/** Merge only an identified job or an unambiguous command still awaiting its result. */
+export function mergeJobSettlement(state, job) {
+    const identified = [];
+    const pending = [];
+    state.blocks.forEach((block, index) => {
+        if (block.kind !== 'tool')
+            return;
+        if (!/^(bash|shell|pwsh|exec)$/u.test(block.name) && block.presentation?.call?.card !== 'terminal')
+            return;
+        const explicitId = /^started background job (\S+)\s*$/u.exec(block.output)?.[1]
+            ?? /\[still running after \d+ms; moved to background job ([^\s\]]+)\]/u.exec(block.output)?.[1];
+        const id = block.job?.id ?? explicitId;
+        if (id !== undefined) {
+            if (id === job.id)
+                identified.push(index);
+            return;
+        }
+        const args = toolArgsObject(block.args);
+        if (block.status === 'running' && block.startedAt !== undefined && block.startedAt <= job.startedAt
+            && typeof args?.['command'] === 'string' && args['command'] === job.label)
+            pending.push(index);
+    });
+    const matches = identified.length > 0 ? identified : pending;
+    if (matches.length !== 1)
+        return undefined;
+    const index = matches[0];
+    const block = state.blocks[index];
+    if (block.kind !== 'tool')
+        return undefined;
+    const blocks = [...state.blocks];
+    blocks[index] = {
+        ...block,
+        status: job.status === 'completed' && block.status !== 'error' ? 'ok' : 'error',
+        job: { id: job.id, status: job.status, detail: job.detail?.trim() || JOB_STATUS_WORD[job.status] },
+    };
+    return { ...state, blocks };
+}
 /** Past- or present-tense word for one lifecycle status. */
 export const JOB_STATUS_WORD = {
     running: 'running',
@@ -13,9 +52,11 @@ export const JOB_STATUS_WORD = {
 };
 /** One human-facing completion line for a background job. */
 export function formatJobNotice(snapshot) {
-    const label = snapshot.label.trim();
-    const detail = snapshot.detail === undefined ? '' : snapshot.detail.trim();
-    return `Background job ${snapshot.id} ${JOB_STATUS_WORD[snapshot.status]}`
+    const head = `Background job ${snapshot.id} ${JOB_STATUS_WORD[snapshot.status]}`;
+    const detail = truncateToWidth(snapshot.detail?.trim().split('\n')[0] ?? '', 28);
+    const room = Math.max(0, 76 - visibleWidth(head) - (detail === '' ? 0 : visibleWidth(detail) + 3) - 3);
+    const label = room < 8 ? '' : truncateToWidth(snapshot.label.trim().split('\n')[0] ?? '', room);
+    return head
         + (label === '' ? '' : ` · ${label}`)
         + (detail === '' ? '' : ` · ${detail}`);
 }

package/lib/session/job-notice.js.map

@@ -1 +1 @@
-{"version":3,"file":"job-notice.js","sourceRoot":"","sources":["../../src/session/job-notice.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,4DAA4D;AAC5D,MAAM,CAAC,MAAM,eAAe,GAA8B;IACxD,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,QAAQ;CACjB,CAAA;AAED,6DAA6D;AAC7D,MAAM,UAAU,eAAe,CAAC,QAK/B;IACC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;IACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;IAC1E,OAAO,kBAAkB,QAAQ,CAAC,EAAE,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;UACtE,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC;UACnC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,CAAC,CAAA;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,QAA+I,EAC/I,KAAwB,EACxB,MAAyB;IAEzB,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,SAAS,CAAA;IAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,SAAS,CAAA;IAC7D,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAA;AAClC,CAAC"}
+{"version":3,"file":"job-notice.js","sourceRoot":"","sources":["../../src/session/job-notice.ts"],"names":[],"mappings":"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"}

package/lib/session/session-controller.js

@@ -460,8 +460,16 @@ export class SessionRuntime {
                     return;
                 const owner = event.job.owner === undefined ? undefined : this.#ctx.get('agents')?.get(event.job.owner);
                 const notice = jobNoticeFor(event.job, owner, this.#active?.handle.agent);
-                if (notice !== undefined)
-                    tui.notice(notice);
+                if (notice !== undefined) {
+                    const job = event.job;
+                    tui.notice(notice, {
+                        process: true, processSource: `job:${job.id}`,
+                        ...(/^(bash|pwsh)$/u.test(job.kind) && (job.status === 'completed' || job.status === 'failed' || job.status === 'killed')
+                            ? { job: { id: job.id, label: job.label, status: job.status, startedAt: job.startedAt, ...(job.detail === undefined ? {} : { detail: job.detail }) } }
+                            : {}),
+                        ...(job.status === 'failed' || job.status === 'killed' ? { level: 'error' } : {}),
+                    });
+                }
             }));
         }
         this.#off.push(ctx.on('agent/status', (payload) => {
@@ -494,6 +502,8 @@ export class SessionRuntime {
                 if (this.#inspectedId === undefined) {
                     tui.event(event, ctx.get('tuiToolPresentation')?.event(active.handle.agent, event));
                 }
+                if (event.type === 'workspace/changes')
+                    this.#serveWorkspaceSummary(ctx, tui, session, event);
                 if (event.type === 'subagent/catalog')
                     this.#tracker.observeCatalog(session, [event]);
                 if (shouldRefreshSessionInfoAfter(event))
@@ -579,7 +589,7 @@ export class SessionRuntime {
         if (defaults === undefined)
             throw new Error('agent default model is unavailable');
         await this.refreshRecent();
-        await this.#activate(await this.#create(defaults));
+        await this.#activate(await this.#create(defaults), 'initial');
     }
     /** Submit one human composer value; active turns retain it as a later follow-up. */
     async send(input, agent = this.#requiredAgent()) {
@@ -640,9 +650,9 @@ export class SessionRuntime {
             this.#tui.restoreInput({ text: line, images });
         if (result.text !== undefined) {
             if (result.kind === 'error')
-                this.#tui.notice(result.text, { level: 'error' });
+                this.#tui.notice(result.text, { level: 'error', focus: true });
             else
-                this.#tui.commandOutput(parsed.name, result.text);
+                this.#tui.commandOutput(parsed.name, result.text, { focus: true });
         }
         return true;
     }
@@ -681,7 +691,7 @@ export class SessionRuntime {
     /** Start a new top-level session with the current model selection. */
     async newSession(agent) {
         this.assertActive(agent);
-        await this.#activate(await this.#create(this.selection(agent)));
+        await this.#activate(await this.#create(this.selection(agent)), 'new');
         await this.refreshRecent();
     }
     /** Replace the active top-level session with one durable session. */
@@ -901,6 +911,34 @@ export class SessionRuntime {
         this.#pushSessionInfo();
         return outcome;
     }
+    /**
+     * Resolve and attach the changed-file summary a `workspace/changes` event
+     * announces.
+     *
+     * The Harness appends the event and only then files the summary under its
+     * sequence, so a listener running inside that append always reads
+     * `undefined`. The lookup is therefore deferred by one microtask, which runs
+     * after the recorder's own synchronous store, and enriches the turn-only
+     * block the transcript already rendered. A session without the plugin, or a
+     * recorder that has already been disposed, simply keeps the fallback.
+     *
+     * @param ctx - host context carrying the optional service.
+     * @param tui - the mounted presentation service.
+     * @param session - the Session that appended the event.
+     * @param event - the `workspace/changes` event.
+     */
+    #serveWorkspaceSummary(ctx, tui, session, event) {
+        const service = ctx.get('workspaceChanges');
+        if (service === undefined)
+            return;
+        const { id } = session;
+        const { seq, data } = event;
+        queueMicrotask(() => {
+            const summary = service.summary(id, seq);
+            if (summary !== undefined)
+                tui.setWorkspaceSummary(data.turn, summary);
+        });
+    }
     /**
      * Publish a current-format generation for every stored session an earlier
      * release wrote. A read open never upgrades a log, so without this pass
@@ -1106,7 +1144,7 @@ export class SessionRuntime {
             return undefined;
         }
     }
-    async #activate(next) {
+    async #activate(next, reason = 'open') {
         // Reject a late create before it publishes UI on a disposed tree.
         if (this.#disposed) {
             this.#releaseHandle(next.handle);
@@ -1117,7 +1155,7 @@ export class SessionRuntime {
         this.#active = next;
         void this.#claimWorkspace(next);
         try {
-            this.#presentAgent(next);
+            this.#presentAgent(next, reason);
             const selected = this.selection(next.handle.agent);
             const info = await this.#resolveModelInfo(selected);
             if (this.#disposed || this.#activationEpoch !== epoch) {
@@ -1178,7 +1216,7 @@ export class SessionRuntime {
             this.#releaseHandle(previous.handle);
     }
     /** Show one active session on the terminal: transcript, tools, controls, model. */
-    #presentAgent(active) {
+    #presentAgent(active, reason = 'open') {
         const agent = active.handle.agent;
         this.#inspectedId = undefined;
         this.#tui.setInspectedSubagent(undefined);
@@ -1187,7 +1225,7 @@ export class SessionRuntime {
         // Seed welcome metadata before replaceSession commits the startup header to
         // native scrollback; later updates cannot rewrite that frozen first frame.
         this.#pushSessionInfo();
-        this.#replaceTranscript(agent);
+        this.#replaceTranscript(agent, reason);
         this.#pushTools();
         this.#pushCommands();
         const selected = this.selection(agent);
@@ -1309,10 +1347,10 @@ export class SessionRuntime {
             controls: this.#sessionControls(active, projection),
         });
     }
-    #replaceTranscript(agent) {
+    #replaceTranscript(agent, reason = 'refresh') {
         const events = agent.session.snapshotEvents();
         this.#tracker.observeCatalog(agent.session, events);
-        this.#tui.replaceSession(events, this.#ctx.get('tuiToolPresentation')?.session(agent, events), agent.status);
+        this.#tui.replaceSession(events, this.#ctx.get('tuiToolPresentation')?.session(agent, events), agent.status, reason);
         this.#replayLivePrefix(agent.session.id);
     }
     #replaceVisibleTranscript() {
@@ -1367,7 +1405,7 @@ export class SessionRuntime {
             return;
         this.#inspectedId = id;
         const child = this.#ctx.get('agents')?.get(SessionId(id));
-        this.#tui.replaceSession(events, child === undefined ? undefined : this.#ctx.get('tuiToolPresentation')?.session(child, events), child?.status ?? 'idle');
+        this.#tui.replaceSession(events, child === undefined ? undefined : this.#ctx.get('tuiToolPresentation')?.session(child, events), child?.status ?? 'idle', 'refresh');
         this.#replayLivePrefix(id);
         this.#tui.setInspectedSubagent(this.#inspectView(id, child?.status === 'running' ? 'running' : 'waiting'));
         this.#tui.setStatus(child?.status ?? 'idle');