@agi-fans/dsh-tui 0.17.0 → 0.19.0

package/lib/runtime/tool-presentation.js

@@ -1,7 +1,10 @@
 /** Harness ToolDefinition presentation bridge for live events and replay. */
 export const name = 'omdsh-tool-presentation';
 export const inject = ['tools'];
+/** Decode a `tool/call` argument string; PTC dispatch events already carry a value. */
 function parsedArguments(raw) {
+    if (typeof raw !== 'string')
+        return raw;
     try {
         return JSON.parse(raw);
     }
@@ -31,43 +34,28 @@ class HarnessToolPresentation {
         }
         return this.#event(agent, event, undefined);
     }
-    #event(agent, event, callIndex) {
-        if (event.type === 'tool/call') {
-            const definition = this.#ctx.tools.get(event.data.name, agent);
-            if (definition?.presentCall === undefined)
-                return undefined;
-            try {
-                const call = definition.presentCall(parsedArguments(event.data.arguments));
-                return call === undefined ? undefined : { call };
-            }
-            catch {
-                return undefined;
-            }
-        }
-        if (event.type !== 'tool/result')
-            return undefined;
-        const callId = event.data.message.source.callId;
-        const callEvent = callIndex?.get(callId)
-            ?? this.#liveCalls.get(agent.session)?.get(callId)
-            ?? agent.session.snapshotEvents().findLast(candidate => candidate.type === 'tool/call' && candidate.data.callId === callId);
-        if (callEvent?.type !== 'tool/call')
+    #presentCall(agent, name, args) {
+        const definition = this.#ctx.tools.get(name, agent);
+        if (definition?.presentCall === undefined)
             return undefined;
-        const definition = this.#ctx.tools.get(callEvent.data.name, agent);
-        const args = parsedArguments(callEvent.data.arguments);
-        let call;
-        let result;
         try {
-            call = definition?.presentCall?.(args);
+            return definition.presentCall(args);
         }
         catch {
-            call = undefined;
+            return undefined;
         }
+    }
+    /** Resolve the call and result cards for one settled invocation. */
+    #present(agent, name, rawArgs, content, isError, meta) {
+        const args = parsedArguments(rawArgs);
+        const call = this.#presentCall(agent, name, args);
+        let result;
         try {
-            const block = event.data.message.content[0];
-            result = definition?.presentResult?.(args, {
-                content: block.content,
-                isError: block.isError === true,
-                ...(event.data.meta === undefined ? {} : { meta: event.data.meta }),
+            result = this.#ctx.tools.get(name, agent)?.presentResult?.(args, {
+                // The harness freezes message content; `ToolResult` declares a mutable array.
+                content: [...content],
+                isError,
+                ...(meta === undefined ? {} : { meta }),
             });
         }
         catch {
@@ -78,6 +66,31 @@ class HarnessToolPresentation {
             ...(result === undefined ? {} : { result }),
         };
     }
+    #event(agent, event, callIndex) {
+        // A PTC sub-dispatch carries the tool name and its normalized arguments on
+        // both halves of the pair, so it resolves a card without a call index — the
+        // same cards a native call of the same tool would get.
+        if (event.type === 'tool/ptc-dispatch-start') {
+            const call = this.#presentCall(agent, event.data.name, event.data.arguments);
+            return call === undefined ? undefined : { call };
+        }
+        if (event.type === 'tool/ptc-dispatch') {
+            return this.#present(agent, event.data.name, event.data.arguments, event.data.content, event.data.isError, undefined);
+        }
+        if (event.type === 'tool/call') {
+            const call = this.#presentCall(agent, event.data.name, parsedArguments(event.data.arguments));
+            return call === undefined ? undefined : { call };
+        }
+        if (event.type !== 'tool/result')
+            return undefined;
+        const callId = event.data.message.source.callId;
+        const callEvent = callIndex?.get(callId)
+            ?? this.#liveCalls.get(agent.session)?.get(callId)
+            ?? agent.session.snapshotEvents().findLast(candidate => candidate.type === 'tool/call' && candidate.data.callId === callId);
+        if (callEvent?.type !== 'tool/call')
+            return undefined;
+        return this.#present(agent, callEvent.data.name, callEvent.data.arguments, event.data.message.content, event.data.message.isError === true, event.data.meta);
+    }
     session(agent, events) {
         // One pass builds a callId index instead of the per-result backwards
         // log scan, keeping replay linear in the event count.

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

@@ -4,7 +4,11 @@
  * @module @agi-fans/dsh-tui/job-notice
  */
 import type { Agent } from '@deepseek-ai/dsh-agent';
-import type { JobKind, JobStatus } from '@deepseek-ai/dsh-jobs';
+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. */
@@ -20,7 +24,7 @@ export declare function formatJobNotice(snapshot: {
  * owned by another session is not this terminal's business.
  */
 export declare function jobNoticeFor(snapshot: {
-    readonly kind: JobKind;
+    readonly kind: JobView['kind'];
     readonly id: string;
     readonly label: string;
     readonly status: JobStatus;

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

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

@@ -1,8 +1,5 @@
 /** Agent-preset configuration and composition guards for one session. */
 import { type Session } from '@deepseek-ai/dsh-session';
-import type { ToolPresentationMode } from '@deepseek-ai/dsh-tools';
-/** PTC uses Code presentation; every other preset exposes native functions. */
-export declare function toolPresentationForPreset(agentPreset: string): ToolPresentationMode;
 /** Agent composition may change only before any model-visible history exists. */
 export declare function isBlankSession(session: Session): boolean;
 export declare function formatAgentPreset(id: string): string;

package/lib/session/session-configuration.js

@@ -8,10 +8,6 @@ function registerLegacyOmdshSessionEvents() {
     KNOWN_SESSION_EVENT_TYPES.add('omdsh/tools-selected');
 }
 registerLegacyOmdshSessionEvents();
-/** PTC uses Code presentation; every other preset exposes native functions. */
-export function toolPresentationForPreset(agentPreset) {
-    return agentPreset === 'code' ? 'ptc' : 'native';
-}
 /** Agent composition may change only before any model-visible history exists. */
 export function isBlankSession(session) {
     if (session.deriveMessages().length > 0)

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,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"}
+{"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;AAElF;;;GAGG;AACH,SAAS,gCAAgC;IACtC,yBAAyC,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;AACxE,CAAC;AAED,gCAAgC,EAAE,CAAA;AAElC,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

@@ -8,11 +8,11 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import { type Agent, type ModelSelection } from '@deepseek-ai/dsh-agent';
-import type { AgentPreset } from '@deepseek-ai/dsh-agent-presets';
+import type { AgentPreset } from '@deepseek-ai/dsh-agent-preset-registry';
 import { type LlmResolvedModelInfo, type UserMessage } from '@deepseek-ai/dsh-llm';
 import type { ImageAttachmentRef, SaveImageAttachment, StoredImageAttachment } from '@deepseek-ai/dsh-attachment';
 import type { CommandSubmitAttachment } from '@deepseek-ai/dsh-commands';
-import type { PermissionSelect } from '@deepseek-ai/dsh-permission-presets/types';
+import type { PermissionSelection } 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';
@@ -28,7 +28,7 @@ export interface TuiStatsProjection {
     contextPressure?: ContextPressureProjection;
     contextBreakdown?: ContextBreakdownProjection;
     plan?: PlanProjection;
-    permissions?: PermissionSelect;
+    permissions?: PermissionSelection;
     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;
@@ -101,7 +101,9 @@ export declare function restoreSubmissionMessage(message: UserMessage, attachmen
 /** Own one switchable top-level Agent and project it onto a TuiService. */
 export declare class SessionRuntime {
     #private;
-    constructor(ctx: Context, tui: TuiService);
+    constructor(ctx: Context, tui: TuiService, options?: {
+        stateDir?: string;
+    });
     get agent(): Agent | undefined;
     /**
      * Interrupt the visible continuable child when one is inspected.