@agi-fans/dsh-tui 0.14.0 → 0.15.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/job-notice.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Human-facing job wording shared by the `/jobs` panel and the completion
+ * notice, so one job reads the same in both surfaces.
+ * @module @agi-fans/dsh-tui/job-notice
+ */
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { JobKind, JobStatus } from '@deepseek-ai/dsh-jobs';
+/** 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. */
+export declare function formatJobNotice(snapshot: {
+    readonly id: string;
+    readonly label: string;
+    readonly status: JobStatus;
+    readonly detail?: string;
+}): string;
+/**
+ * Completion notice for one settlement, or `undefined` when it must stay
+ * silent: subagent work is already reported by the live roster, and a job
+ * owned by another session is not this terminal's business.
+ */
+export declare function jobNoticeFor(snapshot: {
+    readonly kind: JobKind;
+    readonly id: string;
+    readonly label: string;
+    readonly status: JobStatus;
+    readonly detail?: string;
+}, owner: Agent | undefined, active: Agent | undefined): string | undefined;

package/lib/session/job-notice.js

@@ -0,0 +1,34 @@
+/**
+ * Human-facing job wording shared by the `/jobs` panel and the completion
+ * notice, so one job reads the same in both surfaces.
+ * @module @agi-fans/dsh-tui/job-notice
+ */
+/** Past- or present-tense word for one lifecycle status. */
+export const JOB_STATUS_WORD = {
+    running: 'running',
+    stopping: 'stopping',
+    completed: 'completed',
+    killed: 'stopped',
+    failed: 'failed',
+};
+/** 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]}`
+        + (label === '' ? '' : ` · ${label}`)
+        + (detail === '' ? '' : ` · ${detail}`);
+}
+/**
+ * Completion notice for one settlement, or `undefined` when it must stay
+ * silent: subagent work is already reported by the live roster, and a job
+ * owned by another session is not this terminal's business.
+ */
+export function jobNoticeFor(snapshot, owner, active) {
+    if (snapshot.kind === 'subagent')
+        return undefined;
+    if (owner === undefined || owner !== active)
+        return undefined;
+    return formatJobNotice(snapshot);
+}
+//# sourceMappingURL=job-notice.js.map

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

@@ -0,0 +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,QAAuI,EACvI,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"}

package/lib/session/live-attempt-tracker.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Dense `agent/assistant-stream` frame state for live transcript folding.
+ *
+ * Upstream advances `revision` on every emitted frame (start, each chunk, and
+ * end) and `index` per chunk, dense from zero. A real run therefore delivers
+ * start(rev N, index -), chunk(rev N+1, index 0), chunk(rev N+2, index 1), …
+ * and end(rev N+k+1). The tracker keeps the per-attempt continuation state,
+ * buffers every accepted delta for transcript rebuilds, and drops the stream
+ * on a revision or index gap until the next start frame.
+ * @module @agi-fans/dsh-tui/live-attempt-tracker
+ */
+import type { StreamChunk } from '@deepseek-ai/dsh-llm';
+import type { StreamDelta } from '../views/event-views.ts';
+/**
+ * One keyed attempt at a time per agent session; the caller owns the key
+ * (`${sessionId}:${attemptId}`) and the frame routing.
+ */
+export declare class LiveAttemptTracker {
+    #private;
+    /** Record the opening start frame, replacing any prior attempt under the same key. */
+    start(key: string, frame: {
+        readonly revision: number;
+        readonly turn: number;
+        readonly step: number;
+    }): void;
+    /**
+     * Fold one chunk frame.
+     * @returns the live delta to present, or `undefined` when the frame broke
+     *   continuation (revision jump or index gap) and the attempt was dropped.
+     */
+    chunk(key: string, frame: {
+        readonly revision: number;
+        readonly index: number;
+        readonly time: number;
+        readonly chunk: StreamChunk;
+    }): StreamDelta | undefined;
+    /** Clear one attempt at its end frame or disposal. */
+    end(key: string): void;
+    /** Buffered deltas for one attempt, for replaying a rebuilt transcript. */
+    deltas(key: string): readonly StreamDelta[];
+    /** Live attempt keys currently tracked. */
+    activeKeys(): IterableIterator<string>;
+}

package/lib/session/live-attempt-tracker.js

@@ -0,0 +1,58 @@
+/**
+ * Dense `agent/assistant-stream` frame state for live transcript folding.
+ *
+ * Upstream advances `revision` on every emitted frame (start, each chunk, and
+ * end) and `index` per chunk, dense from zero. A real run therefore delivers
+ * start(rev N, index -), chunk(rev N+1, index 0), chunk(rev N+2, index 1), …
+ * and end(rev N+k+1). The tracker keeps the per-attempt continuation state,
+ * buffers every accepted delta for transcript rebuilds, and drops the stream
+ * on a revision or index gap until the next start frame.
+ * @module @agi-fans/dsh-tui/live-attempt-tracker
+ */
+/**
+ * One keyed attempt at a time per agent session; the caller owns the key
+ * (`${sessionId}:${attemptId}`) and the frame routing.
+ */
+export class LiveAttemptTracker {
+    #attempts = new Map();
+    /** Record the opening start frame, replacing any prior attempt under the same key. */
+    start(key, frame) {
+        this.#attempts.set(key, {
+            turn: frame.turn,
+            step: frame.step,
+            deltas: [],
+            nextRevision: frame.revision + 1,
+            nextIndex: 0,
+        });
+    }
+    /**
+     * Fold one chunk frame.
+     * @returns the live delta to present, or `undefined` when the frame broke
+     *   continuation (revision jump or index gap) and the attempt was dropped.
+     */
+    chunk(key, frame) {
+        const attempt = this.#attempts.get(key);
+        if (attempt === undefined || frame.revision !== attempt.nextRevision || frame.index !== attempt.nextIndex) {
+            this.#attempts.delete(key);
+            return undefined;
+        }
+        attempt.nextRevision += 1;
+        attempt.nextIndex += 1;
+        const delta = { turn: attempt.turn, step: attempt.step, chunk: frame.chunk };
+        attempt.deltas.push(delta);
+        return delta;
+    }
+    /** Clear one attempt at its end frame or disposal. */
+    end(key) {
+        this.#attempts.delete(key);
+    }
+    /** Buffered deltas for one attempt, for replaying a rebuilt transcript. */
+    deltas(key) {
+        return this.#attempts.get(key)?.deltas ?? [];
+    }
+    /** Live attempt keys currently tracked. */
+    activeKeys() {
+        return this.#attempts.keys();
+    }
+}
+//# sourceMappingURL=live-attempt-tracker.js.map

package/lib/session/live-attempt-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-attempt-tracker.js","sourceRoot":"","sources":["../../src/session/live-attempt-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACpB,SAAS,GAAG,IAAI,GAAG,EAAuB,CAAA;IAEnD,sFAAsF;IACtF,KAAK,CAAC,GAAW,EAAE,KAAkF;QACnG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,EAAE;YACV,YAAY,EAAE,KAAK,CAAC,QAAQ,GAAG,CAAC;YAChC,SAAS,EAAE,CAAC;SACb,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAW,EAAE,KAKlB;QACC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACvC,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,SAAS,EAAE,CAAC;YAC1G,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAC1B,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,OAAO,CAAC,YAAY,IAAI,CAAC,CAAA;QACzB,OAAO,CAAC,SAAS,IAAI,CAAC,CAAA;QACtB,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAA;QACzF,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC1B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,sDAAsD;IACtD,GAAG,CAAC,GAAW;QACb,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,EAAE,CAAA;IAC9C,CAAC;IAED,2CAA2C;IAC3C,UAAU;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;IAC9B,CAAC;CACF"}

package/lib/session/project-context.d.ts

@@ -11,3 +11,5 @@ export interface ProjectContext {
 export type GitRunner = (cwd: string, args: readonly string[]) => string;
 /** Resolve a cwd to its worktree root, branch, and compact dirty counters. */
 export declare function resolveProjectContext(cwd: string, runner?: GitRunner): ProjectContext;
+/** Re-resolve one cwd immediately, refreshing the default-cache entry. */
+export declare function refreshProjectContext(cwd: string, runner?: GitRunner): ProjectContext;

package/lib/session/project-context.js

@@ -4,6 +4,8 @@ const runGit = (cwd, args) => execFileSync('git', ['-C', cwd, ...args], {
     encoding: 'utf8',
     stdio: ['ignore', 'pipe', 'ignore'],
 });
+/** Bounded freshness so an agent checkpoint or checkout is reflected without a restart. */
+const PROJECT_CONTEXT_TTL_MS = 15_000;
 const defaultCache = new Map();
 function attempt(runner, cwd, args) {
     try {
@@ -16,15 +18,27 @@ function attempt(runner, cwd, args) {
 }
 /** Resolve a cwd to its worktree root, branch, and compact dirty counters. */
 export function resolveProjectContext(cwd, runner = runGit) {
-    const cached = runner === runGit ? defaultCache.get(cwd) : undefined;
-    if (cached !== undefined)
-        return cached;
+    if (runner === runGit) {
+        const cached = defaultCache.get(cwd);
+        if (cached !== undefined && Date.now() - cached.at < PROJECT_CONTEXT_TTL_MS)
+            return cached.value;
+    }
+    const result = resolveProjectContextFresh(cwd, runner);
+    if (runner === runGit)
+        defaultCache.set(cwd, { at: Date.now(), value: result });
+    return result;
+}
+/** Re-resolve one cwd immediately, refreshing the default-cache entry. */
+export function refreshProjectContext(cwd, runner = runGit) {
+    const result = resolveProjectContextFresh(cwd, runner);
+    if (runner === runGit)
+        defaultCache.set(cwd, { at: Date.now(), value: result });
+    return result;
+}
+function resolveProjectContextFresh(cwd, runner) {
     const root = attempt(runner, cwd, ['rev-parse', '--show-toplevel']);
     if (root === undefined) {
-        const result = { root: cwd, modified: 0, untracked: 0 };
-        if (runner === runGit)
-            defaultCache.set(cwd, result);
-        return result;
+        return { root: cwd, modified: 0, untracked: 0 };
     }
     const branch = attempt(runner, root, ['symbolic-ref', '--quiet', '--short', 'HEAD'])
         ?? attempt(runner, root, ['rev-parse', '--short', 'HEAD'])
@@ -44,9 +58,6 @@ export function resolveProjectContext(cwd, runner = runGit) {
     const gitLabel = branch
         + (modified > 0 ? ` *${modified}` : '')
         + (untracked > 0 ? ` ?${untracked}` : '');
-    const result = { root, branch, modified, untracked, gitLabel };
-    if (runner === runGit)
-        defaultCache.set(cwd, result);
-    return result;
+    return { root, branch, modified, untracked, gitLabel };
 }
 //# sourceMappingURL=project-context.js.map

package/lib/session/project-context.js.map

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

package/lib/session/session-configuration.js

@@ -20,7 +20,7 @@ export function isBlankSession(session) {
         || event.type === 'request/context'
         || event.type === 'turn/start'
         || event.type === 'step/start'
-        || event.type === 'assistant/chunk'
+        || event.type === 'assistant/attempt'
         || event.type === 'tool/call'
         || event.type === 'tool/result');
 }

package/lib/session/session-configuration.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-configuration.js","sourceRoot":"","sources":["../../src/session/session-configuration.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,EAAE,yBAAyB,EAAgB,MAAM,0BAA0B,CAAA;AAGlF;;;GAGG;AACH,SAAS,gCAAgC;IACtC,yBAAyC,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;AACxE,CAAC;AAED,gCAAgC,EAAE,CAAA;AAElC,+EAA+E;AAC/E,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,OAAO,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;AAClD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IACrD,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB;WACzE,KAAK,CAAC,IAAI,KAAK,iBAAiB;WAChC,KAAK,CAAC,IAAI,KAAK,YAAY;WAC3B,KAAK,CAAC,IAAI,KAAK,YAAY;WAC3B,KAAK,CAAC,IAAI,KAAK,iBAAiB;WAChC,KAAK,CAAC,IAAI,KAAK,WAAW;WAC1B,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,IAAI,EAAE,KAAK,UAAU;QAAE,OAAO,UAAU,CAAA;IACxC,IAAI,EAAE,KAAK,MAAM;QAAE,OAAO,KAAK,CAAA;IAC/B,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACtC,IAAI,EAAE,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IACpC,OAAO,EAAE,CAAA;AACX,CAAC"}
+{"version":3,"file":"session-configuration.js","sourceRoot":"","sources":["../../src/session/session-configuration.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,EAAE,yBAAyB,EAAgB,MAAM,0BAA0B,CAAA;AAGlF;;;GAGG;AACH,SAAS,gCAAgC;IACtC,yBAAyC,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;AACxE,CAAC;AAED,gCAAgC,EAAE,CAAA;AAElC,+EAA+E;AAC/E,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,OAAO,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;AAClD,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IACrD,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB;WACzE,KAAK,CAAC,IAAI,KAAK,iBAAiB;WAChC,KAAK,CAAC,IAAI,KAAK,YAAY;WAC3B,KAAK,CAAC,IAAI,KAAK,YAAY;WAC3B,KAAK,CAAC,IAAI,KAAK,mBAAmB;WAClC,KAAK,CAAC,IAAI,KAAK,WAAW;WAC1B,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,IAAI,EAAE,KAAK,UAAU;QAAE,OAAO,UAAU,CAAA;IACxC,IAAI,EAAE,KAAK,MAAM;QAAE,OAAO,KAAK,CAAA;IAC/B,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACtC,IAAI,EAAE,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAA;IACpC,OAAO,EAAE,CAAA;AACX,CAAC"}

package/lib/session/session-controller.d.ts

@@ -11,13 +11,14 @@ import { type Agent, type ModelSelection } from '@deepseek-ai/dsh-agent';
 import type { AgentPreset } from '@deepseek-ai/dsh-agent-presets';
 import { type LlmResolvedModelInfo, type UserMessage } from '@deepseek-ai/dsh-llm';
 import type { ImageAttachmentRef, SaveImageAttachment, StoredImageAttachment } from '@deepseek-ai/dsh-attachment';
-import type { EncodedImageAttachment } from '@deepseek-ai/dsh-attachment/types';
+import type { CommandSubmitAttachment } from '@deepseek-ai/dsh-commands';
 import type { PermissionSelect } from '@deepseek-ai/dsh-permission-presets/types';
 import type { PlanProjection } from '@deepseek-ai/dsh-plan-mode/types';
 import { type SkillSummary } from '@deepseek-ai/dsh-skill';
 import type { SessionStatsProjection } from '@deepseek-ai/dsh-session-stats/types';
 import type { ContextBreakdownProjection, ContextPressureProjection, TokenUsageProjection } from '@deepseek-ai/dsh-token-meter/client';
 import { type SessionEvent } from '@deepseek-ai/dsh-session';
+import type { GoalProjection } from '@deepseek-ai/dsh-goal/types';
 import type { TuiCommand, TuiRecentSession, TuiService, TuiSessionControls, TuiSessionStats, TuiSubmission, TuiInputImage } from '../definition.ts';
 import type { ContextDiagnostics } from './context-diagnostics.ts';
 /** Projection values consumed as one consistent snapshot when the units exist. */
@@ -28,6 +29,9 @@ export interface TuiStatsProjection {
     contextBreakdown?: ContextBreakdownProjection;
     plan?: PlanProjection;
     permissions?: PermissionSelect;
+    goal?: GoalProjection | null;
+    /** Last logged sandbox-mode override, or null before one; outranks the preset while set. */
+    sandboxMode?: 'read-only' | 'workspace-write' | 'danger-full-access' | null;
 }
 /** Present only the session controls whose owning Harness plugins are composed. */
 export declare function sessionControls(projection?: TuiStatsProjection): TuiSessionControls;
@@ -91,7 +95,7 @@ export declare function createSubmissionMessage(submission: TuiSubmission, attac
     };
 } & Pick<UserMessage, "id" | "role">>;
 /** Encode composer drafts for `ctx.commands.execute`. */
-export declare function encodeComposerImages(images: readonly TuiInputImage[]): EncodedImageAttachment[];
+export declare function encodeCommandAttachments(images: readonly TuiInputImage[]): CommandSubmitAttachment[];
 /** Rehydrate one durable human inbox message into an editable composer draft. */
 export declare function restoreSubmissionMessage(message: UserMessage, attachments?: RestoreAttachmentStore): Promise<TuiSubmission>;
 /** Own one switchable top-level Agent and project it onto a TuiService. */
@@ -117,8 +121,10 @@ export declare class SessionRuntime {
     get recentSessions(): readonly TuiRecentSession[];
     /** Current model selection for the active Agent. */
     selection(agent?: Agent): ModelSelection;
-    /** Replace the active Agent's selection and persist it as the next default. */
-    changeSelection(agent: Agent, selection: ModelSelection, info?: LlmResolvedModelInfo): Promise<void>;
+    /** Replace the active Agent's selection, optionally persisting it as the next default. */
+    changeSelection(agent: Agent, selection: ModelSelection, info?: LlmResolvedModelInfo, options?: {
+        persist?: boolean;
+    }): Promise<void>;
     /** Start a new top-level session with the current model selection. */
     newSession(agent: Agent): Promise<void>;
     /** Replace the active top-level session with one durable session. */