@deepseek-harness-tui/dsh-tui 0.14.1 → 0.16.0

package/lib/types/screens/sessionSupervisor/useSessionSupervisor.js

@@ -203,6 +203,27 @@ export function useSessionSupervisor(input) {
     const [selectedPath, setSelectedPath] = useState(undefined);
     /** True once the user picked a rail row by hand; see the selection effect. */
     const [selectionManual, setSelectionManual] = useState(false);
+    /** The rail row whose sessions the pane is showing (or the fallback group). */
+    const selected = useMemo(() => {
+        const registered = railEntries.find(entry => entry.from === 'registry' && selectedPath !== undefined && samePath(entry.path, selectedPath));
+        if (registered !== undefined)
+            return registered;
+        if (selectedUnregisteredId !== undefined)
+            return railEntries.find(entry => entry.id === selectedUnregisteredId);
+        return railEntries.find(entry => samePath(entry.path, channel.cwd)) ?? railEntries[0];
+    }, [railEntries, selectedPath, selectedUnregisteredId, channel.cwd]);
+    // Recency chooses the default even when an older live row sorts above it.
+    const mostRecentIn = useCallback((path) => {
+        const needle = query.trim().toLowerCase();
+        let recent;
+        for (const session of groupedEntries.get(path) ?? []) {
+            if (sessionMatchesQuery(session, needle)
+                && (recent === undefined || session.updatedAt > recent.updatedAt))
+                recent = session;
+        }
+        return recent?.id;
+    }, [groupedEntries, query]);
+    const recentSessionId = useMemo(() => selected === undefined ? undefined : mostRecentIn(selected.path), [selected?.path, mostRecentIn]);
     /**
      * The session column's cursor, as ONE fact.
      *
@@ -224,13 +245,24 @@ export function useSessionSupervisor(input) {
      * {@link focusIndex} is derived from it for the render, for movement and for
      * Enter alike.
      */
-    const [focusSessionId, setFocusSessionId] = useState(undefined);
+    const [focusSessionId, setFocusSessionIdState] = useState(recentSessionId);
+    const initialFocusPending = useRef(true);
+    const setFocusSessionId = useCallback((id) => {
+        initialFocusPending.current = false;
+        setFocusSessionIdState(id);
+    }, []);
+    // Keep the workspace's default current until the user chooses a list row.
+    React.useEffect(() => {
+        if (!initialFocusPending.current)
+            return;
+        setFocusSessionIdState(recentSessionId);
+    }, [recentSessionId]);
     /**
      * Which column owns the keyboard, and therefore which column draws the `❯`
      * cursor. Exactly one at a time: two cursors mean "where does Enter go?" has
      * no answer, and ←/→ is how this screen answers it.
      */
-    const [activePane, setActivePane] = useState('rail');
+    const [activePane, setActivePane] = useState('list');
     const [pins, setPins] = useState(() => readSessionPins(pinsDir));
     /** A stored session being renamed / confirmed for deletion (non-DSH rows). */
     const [sessionRename, setSessionRename] = useState(undefined);
@@ -295,11 +327,12 @@ export function useSessionSupervisor(input) {
                         slot.rows = slot.rows?.map(row => row.id === enriched.id ? enriched : row);
                         setSessions(current => current.map(row => row.id === enriched.id ? enriched : row));
                     }, partial => {
-                        // Keep a complete cached list over a partial cold scan. With no
-                        // snapshot, show useful rows now rather than waiting for every log.
-                        if (slot.requestGeneration !== generation || slot.rows !== undefined)
+                        // Fresh workspace rows supersede cached metadata immediately;
+                        // retain other cached workspaces until the full listing arrives.
+                        if (slot.requestGeneration !== generation)
                             return;
-                        setSessions(partial);
+                        setSessions(current => [...new Map([...current, ...partial].map(row => [row.id, row])).values()]
+                            .sort((left, right) => right.updatedAt - left.updatedAt));
                         setLoading(false);
                     });
                     // Recorded only after success: a failed listing keeps the previous
@@ -338,7 +371,7 @@ export function useSessionSupervisor(input) {
             setLoading(false);
             setRefreshing(false);
         }
-    }, [channel, workspaceLedger]);
+    }, [channel, workspaceLedger, channel.cwd, channel.ready]);
     React.useEffect(() => {
         void reload();
     }, [reload]);
@@ -402,15 +435,6 @@ export function useSessionSupervisor(input) {
     React.useEffect(() => {
         setRailFocus(current => Math.min(current, Math.max(0, railEntries.length - 1)));
     }, [railEntries.length]);
-    /** The rail row whose sessions the pane is showing (or the fallback group). */
-    const selected = useMemo(() => {
-        const registered = railEntries.find(entry => entry.from === 'registry' && selectedPath !== undefined && samePath(entry.path, selectedPath));
-        if (registered !== undefined)
-            return registered;
-        if (selectedUnregisteredId !== undefined)
-            return railEntries.find(entry => entry.id === selectedUnregisteredId);
-        return railEntries[0];
-    }, [railEntries, selectedPath, selectedUnregisteredId]);
     /**
      * Sessions whose recorded cwd is the selected workspace, minus the search
      * filter. Live sessions in this workspace sort above stopped ones, then by
@@ -456,18 +480,10 @@ export function useSessionSupervisor(input) {
     const cardFocused = activePane === 'list' && sessionIndex === 0;
     /** The new-session card is the list's row 0; sessions start at 1. */
     const sessionAt = useCallback((index) => visibleSessions[index - 1], [visibleSessions]);
-    /**
-     * Enter the session column: land the cursor on the session this terminal is
-     * attached to (that is the one the user most likely means), else on the top
-     * row — which is the new-session card when the list sorted its live rows
-     * lower. A cursor that stayed put while the list scrolled elsewhere would act
-     * on a row the user never looked at.
-     */
+    /** Enter the session column without changing its selected row. */
     const activateList = useCallback(() => {
         setActivePane('list');
-        const current = visibleSessions.find(session => liveStateOf(session.id)?.current === true);
-        setFocusSessionId(current?.id);
-    }, [liveStateOf, visibleSessions]);
+    }, []);
     /** Enter the workspace column. */
     const activateRail = useCallback(() => {
         setActivePane('rail');
@@ -549,11 +565,17 @@ export function useSessionSupervisor(input) {
             .catch(error => report(t(archiveSessions ? 'session-archive-failed' : 'session-delete-failed', { err: message(error) }), 'error'));
     }, [archiveSessions, channel, holderOf, liveStateOf, reload, report]);
     const selectEntry = useCallback((entry) => {
+        setActivePane('rail');
         setSelectedPath(entry.from === 'registry' ? entry.path : undefined);
         setSelectedUnregisteredId(entry.from === 'unregistered' ? entry.id : undefined);
         setSelectionManual(true);
-        setFocusSessionId(undefined);
-    }, []);
+        if (selected === undefined || !samePath(selected.path, entry.path)) {
+            // One selection belongs to the current workspace, without a per-workspace
+            // memory. A cold group's default follows incoming rows until list movement.
+            initialFocusPending.current = true;
+            setFocusSessionIdState(mostRecentIn(entry.path));
+        }
+    }, [selected, mostRecentIn]);
     /**
      * Mount a session, refusing one another terminal holds.
      *
@@ -686,7 +708,7 @@ export function useSessionSupervisor(input) {
         // put `❯` on the first session while the user had selected the card.
         const landed = sessionAt(next);
         setFocusSessionId(landed?.id);
-    }, [visibleSessions, sessionAt, sessionIndex]);
+    }, [visibleSessions, sessionAt, sessionIndex, setFocusSessionId]);
     /** The session under the cursor, or undefined while the card (row 0) holds it. */
     const focusedSession = sessionAt(sessionIndex);
     return {

package/lib/types/sessionHistory.d.ts

@@ -17,6 +17,11 @@ export declare function readResumeTarget(): string | undefined;
  * verbatim and never parses them into DSH_TUI_RESUME_SESSION, so the
  * in-profile plugin reads them itself. A bare flag with no id defers to the
  * exit-time marker, exactly like the bin. An app-level `--` ends option parsing.
+ *
+ * A bare flag whose fallback is empty yields `undefined` here — the caller decides
+ * what that means, and both callers fail closed: the launcher reports "no session
+ * to resume" and exits non-zero, the boot treats it as "no target" only because the
+ * launcher already refused (roadmap §6 item 11). Never invent a fallback.
  * @param argv - the app arguments from cmdlineArgs, after the host's own options.
  * @returns The requested session id, or undefined when none was given.
  */

package/lib/types/sessionHistory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionHistory.d.ts","sourceRoot":"","sources":["../../src/sessionHistory.ts"],"names":[],"mappings":"AAyCA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGzD;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAOrD;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,MAAM,EAAE;AACvB;wEACwE;AACxE,YAAY,GAAE,MAAM,MAAM,GAAG,SAA4B,GACxD,MAAM,GAAG,SAAS,CAgBpB;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAejE;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyB/D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAUpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAYrD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiBxE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAQ7D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAU9D"}
+{"version":3,"file":"sessionHistory.d.ts","sourceRoot":"","sources":["../../src/sessionHistory.ts"],"names":[],"mappings":"AAyCA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGzD;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAOrD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,MAAM,EAAE;AACvB;wEACwE;AACxE,YAAY,GAAE,MAAM,MAAM,GAAG,SAA4B,GACxD,MAAM,GAAG,SAAS,CAgBpB;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAejE;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyB/D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAUpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAYrD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiBxE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAQ7D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAU9D"}

package/lib/types/sessionHistory.js

@@ -73,6 +73,11 @@ export function readResumeTarget() {
  * verbatim and never parses them into DSH_TUI_RESUME_SESSION, so the
  * in-profile plugin reads them itself. A bare flag with no id defers to the
  * exit-time marker, exactly like the bin. An app-level `--` ends option parsing.
+ *
+ * A bare flag whose fallback is empty yields `undefined` here — the caller decides
+ * what that means, and both callers fail closed: the launcher reports "no session
+ * to resume" and exits non-zero, the boot treats it as "no target" only because the
+ * launcher already refused (roadmap §6 item 11). Never invent a fallback.
  * @param argv - the app arguments from cmdlineArgs, after the host's own options.
  * @returns The requested session id, or undefined when none was given.
  */

package/lib/types/sessionModes.d.ts

@@ -68,13 +68,15 @@ export declare function resolveSessionModes(raw: readonly SessionModeSpec[] | un
     modes: readonly SessionModeSpec[];
     dropped: readonly string[];
 };
-/** Display name: explicit `label` > built-in i18n (`mode-default`/
- *  `mode-plan`/`mode-full` for those ids) > the raw id. */
+/** Display name: a dynamic runtime preset's label (localized at render time
+ *  for presets the TUI owns, so `/lang` applies without a roster rebuild) >
+ *  explicit `label` > built-in i18n (`mode-default`/`mode-plan`/`mode-full`
+ *  for those ids) > the raw id. */
 export declare function modeDisplayName(spec: SessionModeSpec): string;
 /**
  * One dynamic Shift+Tab entry for a runtime permission preset. The id is
  * namespaced so it can never collide with a configured mode id, the label
- * carries the registry's display name, and the entry declares NO atoms: a
+ * carries the registry's display name (see modeDisplayName), and the entry declares NO atoms: a
  * dynamic preset is selected through its durable `permission/preset`
  * identity only, never by an atom wildcard match (which would steal the
  * indicator on sessions that never held that identity).

package/lib/types/sessionModes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionModes.d.ts","sourceRoot":"","sources":["../../src/sessionModes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAYzE;gEACgE;AAChE,eAAO,MAAM,qBAAqB,EAAE,SAAS,eAAe,EAI3D,CAAA;AAED;;;0CAG0C;AAC1C,eAAO,MAAM,4BAA4B,EAAE,WAAW,CAAC,MAAM,CAI3D,CAAA;AAEF,8DAA8D;AAC9D,eAAO,MAAM,4BAA4B,EAAE,SAAS;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,WAAW,GAAG,iBAAiB,GAAG,oBAAoB,CAAA;IAC/D,QAAQ,EAAE,KAAK,GAAG,OAAO,CAAA;CAC1B,EAIA,CAAA;AAED,0EAA0E;AAC1E,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAAiC,CAAA;AAE7F;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,GAAG,iBAAiB,GAAG,oBAAoB,EAC/D,QAAQ,EAAE,KAAK,GAAG,OAAO,EACzB,MAAM,CAAC,EAAE,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,WAAW,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAA;CAAE,EAAE,GAClI,MAAM,GAAG,SAAS,CAQpB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,SAAS,MAAM,EAAE,CAiBnB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,0BAA0B,EAClC,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAC,GACzC;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAK9F;AAED;;;;;;;kEAOkE;AAClE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GAAG;IAChF,KAAK,EAAE,SAAS,eAAe,EAAE,CAAA;IACjC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B,CAgBA;AAED;2DAC2D;AAC3D,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAM7D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,0BAA0B,GAAG,eAAe,CAEtF"}
+{"version":3,"file":"sessionModes.d.ts","sourceRoot":"","sources":["../../src/sessionModes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAazE;gEACgE;AAChE,eAAO,MAAM,qBAAqB,EAAE,SAAS,eAAe,EAI3D,CAAA;AAED;;;0CAG0C;AAC1C,eAAO,MAAM,4BAA4B,EAAE,WAAW,CAAC,MAAM,CAI3D,CAAA;AAEF,8DAA8D;AAC9D,eAAO,MAAM,4BAA4B,EAAE,SAAS;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,WAAW,GAAG,iBAAiB,GAAG,oBAAoB,CAAA;IAC/D,QAAQ,EAAE,KAAK,GAAG,OAAO,CAAA;CAC1B,EAIA,CAAA;AAED,0EAA0E;AAC1E,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAAiC,CAAA;AAE7F;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,GAAG,iBAAiB,GAAG,oBAAoB,EAC/D,QAAQ,EAAE,KAAK,GAAG,OAAO,EACzB,MAAM,CAAC,EAAE,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,WAAW,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAA;CAAE,EAAE,GAClI,MAAM,GAAG,SAAS,CAQpB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,SAAS,MAAM,EAAE,CAiBnB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,0BAA0B,EAClC,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAC,GACzC;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,0BAA0B,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAK9F;AAED;;;;;;;kEAOkE;AAClE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GAAG;IAChF,KAAK,EAAE,SAAS,eAAe,EAAE,CAAA;IACjC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B,CAgBA;AAED;;;mCAGmC;AACnC,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAS7D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,0BAA0B,GAAG,eAAe,CAEtF"}

package/lib/types/sessionModes.js

@@ -8,6 +8,7 @@
  * `plan`, but not with `sandbox` or `approval`.
  */
 import { t } from './i18n.js';
+import { permissionPresetLabel } from './permissionPresetLabels.js';
 /** The shipped cycle when cordis.yml pins no `modes` — array order IS the
  *  Shift+Tab cycle order; index 0 is the unmarked base mode. */
 export const DEFAULT_SESSION_MODES = [
@@ -115,9 +116,14 @@ export function resolveSessionModes(raw) {
     });
     return modes.length === 0 ? { modes: DEFAULT_SESSION_MODES, dropped } : { modes, dropped };
 }
-/** Display name: explicit `label` > built-in i18n (`mode-default`/
- *  `mode-plan`/`mode-full` for those ids) > the raw id. */
+/** Display name: a dynamic runtime preset's label (localized at render time
+ *  for presets the TUI owns, so `/lang` applies without a roster rebuild) >
+ *  explicit `label` > built-in i18n (`mode-default`/`mode-plan`/`mode-full`
+ *  for those ids) > the raw id. */
 export function modeDisplayName(spec) {
+    if (spec.permission !== undefined && spec.label !== undefined && spec.id === `permission:${spec.permission}`) {
+        return permissionPresetLabel({ value: spec.permission, name: spec.label });
+    }
     if (spec.label !== undefined)
         return spec.label;
     if (spec.id === 'default')
@@ -131,7 +137,7 @@ export function modeDisplayName(spec) {
 /**
  * One dynamic Shift+Tab entry for a runtime permission preset. The id is
  * namespaced so it can never collide with a configured mode id, the label
- * carries the registry's display name, and the entry declares NO atoms: a
+ * carries the registry's display name (see modeDisplayName), and the entry declares NO atoms: a
  * dynamic preset is selected through its durable `permission/preset`
  * identity only, never by an atom wildcard match (which would steal the
  * indicator on sessions that never held that identity).

package/lib/types/sessions/listSnapshot.d.ts

@@ -0,0 +1,6 @@
+import type { SessionSummary } from '../adapter/ports/channel-session.js';
+/** Undefined is unknown; an empty snapshot is a successful empty listing. */
+export declare function readListingSnapshot(key: string): readonly SessionSummary[] | undefined;
+/** Capture ordering before async work, including across distinct Context proxies. */
+export declare function beginListingSnapshot(key: string): (rows: readonly SessionSummary[]) => void;
+//# sourceMappingURL=listSnapshot.d.ts.map

package/lib/types/sessions/listSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listSnapshot.d.ts","sourceRoot":"","sources":["../../../src/sessions/listSnapshot.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAiCzE,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE,GAAG,SAAS,CAEtF;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,KAAK,IAAI,CAe3F"}

package/lib/types/sessions/listSnapshot.js

@@ -0,0 +1,67 @@
+/** Last successful listing for first paint only; the backend still refreshes it. */
+import { createHash } from 'node:crypto';
+import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { DATA_DIR } from '../utils/paths.js';
+const directory = join(DATA_DIR, 'session-lists');
+const generations = new Map();
+const record = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const finite = (value) => typeof value === 'number' && Number.isFinite(value);
+const optionalText = (value) => value === undefined || typeof value === 'string';
+function isSummary(value) {
+    if (!record(value) || typeof value.id !== 'string' || !value.id || typeof value.cwd !== 'string' ||
+        !finite(value.createdAt) || !finite(value.updatedAt) || typeof value.hasPrompt !== 'boolean' ||
+        !finite(value.childCount) || value.childCount < 0 ||
+        (value.bytes !== undefined && (!finite(value.bytes) || value.bytes < 0)) ||
+        !['backendId', 'agentPreset', 'model', 'label', 'branch'].every(key => optionalText(value[key])))
+        return false;
+    const { title, kind } = value;
+    if (!record(title) || typeof title.text !== 'string' || typeof title.source !== 'string' ||
+        !['renamed', 'auto', 'prompt', 'fallback'].includes(title.source) || !record(kind))
+        return false;
+    return kind.kind === 'root' ||
+        (kind.kind === 'fork' && typeof kind.parent === 'string') ||
+        (kind.kind === 'subagent' && optionalText(kind.parent) && finite(kind.depth) && kind.depth >= 0);
+}
+function fileOf(key) {
+    return join(directory, createHash('sha256').update(key).digest('hex') + '.json');
+}
+function read(key) {
+    try {
+        const value = JSON.parse(readFileSync(fileOf(key), 'utf8'));
+        if (!record(value) || value.version !== 1 || value.source !== key || !Array.isArray(value.rows) || !value.rows.every(isSummary))
+            return undefined;
+        if (new Set(value.rows.map(row => row.id)).size !== value.rows.length)
+            return undefined;
+        return value.rows;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Undefined is unknown; an empty snapshot is a successful empty listing. */
+export function readListingSnapshot(key) {
+    return read(key);
+}
+/** Capture ordering before async work, including across distinct Context proxies. */
+export function beginListingSnapshot(key) {
+    const generation = (generations.get(key) ?? 0) + 1;
+    generations.set(key, generation);
+    return rows => {
+        if (generations.get(key) !== generation)
+            return;
+        const file = fileOf(key);
+        const temporary = file + '.' + process.pid + '.tmp';
+        try {
+            mkdirSync(directory, { recursive: true, mode: 0o700 });
+            writeFileSync(temporary, JSON.stringify({ version: 1, source: key, rows }), { mode: 0o600 });
+            renameSync(temporary, file);
+        }
+        catch {
+            try {
+                rmSync(temporary, { force: true });
+            }
+            catch { /* A cache never blocks listing. */ }
+        }
+    };
+}

package/lib/types/settings/definitions.d.ts

@@ -225,6 +225,18 @@ export declare const SETTING_DEFINITIONS: {
             };
         }[];
     };
+    launchpad: {
+        label: string;
+        descriptions: {
+            zh: string;
+        };
+        group: string;
+        hint: string;
+        hintDescriptions: {
+            zh: string;
+        };
+        kind: "boolean";
+    };
     mathImageBacking: {
         label: string;
         descriptions: {
@@ -306,6 +318,25 @@ export declare const SETTING_DEFINITIONS: {
         };
         kind: "boolean";
     };
+    notificationMethod: {
+        label: string;
+        descriptions: {
+            zh: string;
+        };
+        group: string;
+        hint: string;
+        hintDescriptions: {
+            zh: string;
+        };
+        kind: "select";
+        options: {
+            value: string;
+            label: string;
+            descriptions: {
+                zh: string;
+            };
+        }[];
+    };
     pageMargin: {
         label: string;
         descriptions: {
@@ -657,6 +688,25 @@ export declare const SETTING_DEFINITIONS: {
         kind: "boolean";
         group: string;
     };
+    taskNotifications: {
+        label: string;
+        descriptions: {
+            zh: string;
+        };
+        group: string;
+        hint: string;
+        hintDescriptions: {
+            zh: string;
+        };
+        kind: "select";
+        options: {
+            value: string;
+            label: string;
+            descriptions: {
+                zh: string;
+            };
+        }[];
+    };
     terminalImages: {
         label: string;
         descriptions: {

package/lib/types/settings/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/settings/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAA;AAG5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,cAAc,GAAG,MAAM,GAAG,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAA;AAE7I,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgfa,CAAA;AAE7C,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,mBAAmB,CAAA;AAEzD;;;;;;;;;yCASyC;AACzC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASjB,CAAA;AAEV;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAEjD,CAAA;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,iBAAiB,GAAG;IAAE,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAE7F;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,gBAAgB,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,CAuGnK,CAAA"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/settings/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAA;AAG5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,cAAc,GAAG,MAAM,GAAG,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAA;AAE7I,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkhBa,CAAA;AAE7C,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,mBAAmB,CAAA;AAEzD;;;;;;;;;yCASyC;AACzC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASjB,CAAA;AAEV;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAEjD,CAAA;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,iBAAiB,GAAG;IAAE,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAE7F;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,gBAAgB,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,CAuGnK,CAAA"}

package/lib/types/settings/definitions.js

@@ -42,8 +42,8 @@ export const SETTING_DEFINITIONS = {
         label: 'Companion skin',
         descriptions: { zh: '宠物皮肤' },
         group: 'splash',
-        hint: 'Look of the companion panel pet (the panel is enabled by default and can be changed in sidePanel.panels): deepy (default, the deepy whale kit), whale (the same layered pixel whale as the splash) or whaleGirl (the user-provided whale-girl sticker pack, 22 animations). Applies immediately.',
-        hintDescriptions: { zh: '伙伴面板里宠物的外形（面板默认启用，可在 sidePanel.panels 中调整）：deepy（默认，deepy 小鲸鱼素材包）、whale（与开屏同款的分层像素鲸鱼）或 whaleGirl（用户提供的鲸娘表情包，22 个动画）。立即生效。' },
+        hint: 'DeepSeek brand: whale allows the maid portrait; deepy/whaleGirl replace it. Claude uses its own art; Codex uses its own raster portrait or maid character-art fallback. Look of the companion panel pet (the panel is enabled by default and can be changed in sidePanel.panels): deepy (default, the deepy whale kit), whale (the same layered pixel whale as the splash) or whaleGirl (the user-provided whale-girl sticker pack, 22 animations). Applies immediately.',
+        hintDescriptions: { zh: 'DeepSeek 品牌：whale 才能用女仆娘立绘；deepy/whaleGirl 会替换它。Claude 使用自己的图案；Codex 优先显示自己的真图，不可用时回落女仆娘字符画。伙伴面板里宠物的外形（面板默认启用，可在 sidePanel.panels 中调整）：deepy（默认，deepy 小鲸鱼素材包）、whale（与开屏同款的分层像素鲸鱼）或 whaleGirl（用户提供的鲸娘表情包，22 个动画）。立即生效。' },
         kind: 'select',
         options: [
             { value: 'deepy', label: 'Deepy', descriptions: { zh: 'Deepy 小鲸鱼' } },
@@ -140,6 +140,14 @@ export const SETTING_DEFINITIONS = {
             { value: 'en', label: 'English', descriptions: { zh: '英文' } },
         ],
     },
+    'launchpad': {
+        label: 'Launchpad on boot',
+        descriptions: { zh: '启动页（落地页）' },
+        group: 'splash',
+        hint: 'On: an ordinary launch (no --resume, no first prompt) starts on the launchpad — the landing page where the first sentence gets typed, with the Continue / Sessions / Settings / Kernel row. Off: boots straight into the chat page. A resume target always skips the launchpad either way. On by default. Restart to apply.',
+        hintDescriptions: { zh: '开启：普通启动（不带 --resume、不带首句）先落启动页——输入第一句话的落地页，带「继续上次 / 会话与工作区 / 设置 / 内核」一行；关闭：直接进入聊天页。无论开关，指定恢复的会话总是直接打开。默认开启。重启生效。' },
+        kind: 'boolean',
+    },
     'mathImageBacking': {
         label: 'Formula image background',
         descriptions: { zh: '公式图片底色' },
@@ -195,6 +203,19 @@ export const SETTING_DEFINITIONS = {
         hintDescriptions: { zh: '只精简界面：隐藏开屏头部、emoji 状态符与装饰性配色，底栏只留模型与目录；代码高亮与工具配色保留。这是界面开关，不是 Agent 预设——模型能用哪些工具由内核预设决定（见 /preset）。' },
         kind: 'boolean',
     },
+    'notificationMethod': {
+        label: 'Notification method',
+        descriptions: { zh: '通知方式' },
+        group: 'conversation',
+        hint: 'Auto uses separate title/body notifications on Ghostty and WezTerm (OSC 777) and Kitty (OSC 99). iTerm2 and Warp use OSC 9 with a title prefix; other terminals ring the bell. Explicit OSC 9 also uses the title prefix. Delivery depends on terminal settings. In tmux, OSC notifications need allow-passthrough on. Applies immediately.',
+        hintDescriptions: { zh: '自动：Ghostty、WezTerm 使用 OSC 777，Kitty 使用 OSC 99，分别显示标题与正文；iTerm2、Warp 使用 OSC 9，将标题放在正文前；其他终端响铃。显式 OSC 9 同样使用标题前缀。实际提醒取决于终端设置；tmux 中 OSC 通知需要开启 allow-passthrough。立即生效。' },
+        kind: 'select',
+        options: [
+            { value: 'auto', label: 'Auto', descriptions: { zh: '自动' } },
+            { value: 'osc9', label: 'OSC 9', descriptions: { zh: 'OSC 9' } },
+            { value: 'bel', label: 'Terminal bell', descriptions: { zh: '终端响铃' } },
+        ],
+    },
     'pageMargin': {
         label: 'Page margin',
         descriptions: { zh: '页边距' },
@@ -258,8 +279,8 @@ export const SETTING_DEFINITIONS = {
         label: 'Chat column width',
         descriptions: { zh: '聊天列占比' },
         group: 'side-panel',
-        hint: 'Chat column as a fraction of the content width: 0.1-0.95, default 0.68. Type a decimal such as `0.6`; while the panel has focus the +/- shortcuts nudge it live for the current session. Applies immediately.',
-        hintDescriptions: { zh: '聊天列占内容宽度的比例：0.1-0.95，默认 0.68。输入小数如 `0.6`；面板获得焦点时可用 +/- 在会话内实时微调。立即生效。' },
+        hint: 'Chat column as a fraction of the content width: 0.1-0.95, default 0.68. Type a decimal such as `0.6`; drag the divider or use +/- while the panel has focus to resize for the current session. Applies immediately.',
+        hintDescriptions: { zh: '聊天列占内容宽度的比例：0.1-0.95，默认 0.68。输入小数如 `0.6`；拖拽分隔线，或在面板获得焦点时用 +/-，可在当前会话内实时调宽。立即生效。' },
         kind: 'number',
     },
     'sidePanel.splitEnabled': {
@@ -431,6 +452,19 @@ export const SETTING_DEFINITIONS = {
         kind: 'boolean',
         group: 'status-bar',
     },
+    'taskNotifications': {
+        label: 'Task completion notifications',
+        descriptions: { zh: '任务完成通知' },
+        group: 'conversation',
+        hint: 'Notify when successful live work finishes with no queued follow-up or active goal. The title is dsh-TUI · Task complete; the body previews the latest reply as plain text in one line, with Markdown formatting removed, up to 200 characters. OSC 777/9 may shorten it further to fit a 2048-byte sequence budget without splitting characters. No reply shows only the title; BEL only rings. Default: only while the terminal is unfocused. Off disables notifications; Always also notifies while focused or when focus reporting is unavailable. Replay, cancellation and errors stay quiet. Applies immediately.',
+        hintDescriptions: { zh: '实时任务成功结束、没有排队的后续输入或活动目标时提醒。标题为「dsh-TUI · 任务已完成」，正文显示最新回复的单行纯文本摘要，去掉 Markdown 样式，最多 200 字符；OSC 777/9 还会按完整序列的 2048 字节预算截短，不拆字符；没有回复时只显示标题，BEL 只响铃。默认仅在终端失去焦点时通知；关闭可禁用，每次完成则在终端聚焦或不支持焦点报告时也通知。回放、取消和失败不通知。立即生效。' },
+        kind: 'select',
+        options: [
+            { value: 'unfocused', label: 'When unfocused', descriptions: { zh: '仅失焦时' } },
+            { value: 'always', label: 'Always', descriptions: { zh: '每次完成' } },
+            { value: 'off', label: 'Off', descriptions: { zh: '关闭' } },
+        ],
+    },
     'terminalImages': {
         label: 'Terminal image previews',
         descriptions: { zh: '终端图片预览' },
@@ -476,16 +510,16 @@ export const SETTING_DEFINITIONS = {
         label: 'Header art',
         descriptions: { zh: '标题图形 logo' },
         group: 'splash',
-        hint: 'Show the header splash art — the pixel whale, or the maid portrait when the setting below is on. Off leaves a text-only header.',
-        hintDescriptions: { zh: '开屏头部显示图形 logo：像素鲸鱼（打开下方「女仆娘立绘」时显示女仆娘）。关闭则只留文字标题。' },
+        hint: 'Header art. DeepSeek follows Companion skin and the maid toggle; Claude uses its own art; Codex uses its own raster portrait or maid character-art fallback. Off leaves a text-only header.',
+        hintDescriptions: { zh: '标题图形：DeepSeek 品牌随宠物皮肤与女仆娘开关，Claude 使用自己的图案；Codex 优先显示自己的真图，不可用时回落女仆娘字符画。关闭则只留文字标题。' },
         kind: 'boolean',
     },
     'whaleGirl': {
         label: 'Maid portrait',
         descriptions: { zh: '女仆娘立绘' },
         group: 'splash',
-        hint: 'Swap the header splash\'s pixel whale for the author-designed maid portrait, rendered FIRST as a real raster through the terminal image protocols (Kitty/Sixel); terminals without graphics support fall back to the character-art maid.',
-        hintDescriptions: { zh: '把开屏头部的像素鲸鱼换成项目作者绘制的女仆娘立绘，最优先走终端图像协议（Kitty/Sixel）的真图渲染；终端不支持时回落到字符画版女仆娘。' },
+        hint: 'DeepSeek brand: choose whale in Companion skin, then enable this toggle. Claude uses its own art; Codex uses its own raster portrait or maid character-art fallback. Swaps the pixel whale for the author-designed maid portrait, preferring the real raster (Kitty/Sixel) with character-art fallback.',
+        hintDescriptions: { zh: 'DeepSeek 品牌：选 whale 皮肤并开启本项。Claude 使用自己的图案；Codex 优先显示自己的真图，不可用时回落女仆娘字符画。把像素鲸鱼换成项目作者绘制的女仆娘立绘，优先用终端图像协议（Kitty/Sixel）渲染真图，不支持时回落字符画。' },
         kind: 'boolean',
     },
     'whaleIdle': {

package/lib/types/terminal-utils/cjk-emphasis.d.ts

@@ -0,0 +1,28 @@
+/**
+ * CJK-adjacent strong emphasis for the shared `marked` instance.
+ *
+ * CommonMark cannot close `**label：**text` in CJK prose: the closing
+ * delimiter run must be right-flanking, and a run preceded by a
+ * punctuation mark (the fullwidth colon/period/quote that ends a Chinese
+ * label) only qualifies when whitespace or more punctuation follows.
+ * Chinese does not space after punctuation, so the exact shape models
+ * write for emphasis labels — `**证据与影响：**源码中…` — keeps literal
+ * asterisks on GitHub and every strict CommonMark renderer alike.
+ *
+ * The tokenizer below takes over exactly that shape: a `**` pair whose
+ * body ends with a Unicode punctuation mark and whose closer is
+ * immediately followed by a CJK ideograph, kana, hangul syllable or
+ * fullwidth form. Every other case is declined, so the built-in em
+ * tokenizer keeps its behavior — including the ASCII one
+ * (`**note:**see`), which stays literal to stay consistent with GitHub.
+ *
+ * Deliberately left literal (same gap upstream, rarer):
+ * - `***` triple runs (em+strong) and single-`*` emphasis — terminal
+ *   italics are barely legible for CJK anyway;
+ * - bodies containing a backtick, where the pair could straddle a code
+ *   span (the math tokenizer guards `$` bodies the same way).
+ */
+import type { TokenizerExtension } from 'marked';
+/** Tokenizer extensions for `marked.use({ extensions })`. */
+export declare const CJK_EMPHASIS_EXTENSIONS: readonly TokenizerExtension[];
+//# sourceMappingURL=cjk-emphasis.d.ts.map

package/lib/types/terminal-utils/cjk-emphasis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cjk-emphasis.d.ts","sourceRoot":"","sources":["../../../src/terminal-utils/cjk-emphasis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAU,MAAM,QAAQ,CAAA;AAaxD,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB,EAAE,SAAS,kBAAkB,EAoBhE,CAAA"}

package/lib/types/terminal-utils/cjk-emphasis.js

@@ -0,0 +1,31 @@
+/** Scripts whose prose does not space after punctuation. CJK punctuation
+ * itself is excluded: a closer followed by punctuation is already
+ * right-flanking per CommonMark, so the built-in tokenizer closes it. */
+const AFTER_CLOSER = '[\u3040-\u30FF\u3400-\u4DBF\u4E00-\u9FFF\uAC00-\uD7AF\uFF00-\uFFEF]';
+/** `**body<punct>**` glued to the scripts above. The body excludes `*`
+ * (triple runs stay with the built-in tokenizer), line breaks and
+ * backticks (code-span straddling). */
+const CJK_STRONG = new RegExp('^\\*\\*([^*\\n`]+?\\p{P})\\*\\*(?=' + AFTER_CLOSER + ')', 'u');
+/** Tokenizer extensions for `marked.use({ extensions })`. */
+export const CJK_EMPHASIS_EXTENSIONS = [
+    {
+        name: 'cjkStrong',
+        level: 'inline',
+        start: (source) => {
+            const index = source.indexOf('**');
+            return index >= 0 ? index : undefined;
+        },
+        tokenizer(src) {
+            const match = CJK_STRONG.exec(src);
+            if (match === null)
+                return undefined;
+            const text = match[1];
+            return {
+                type: 'strong',
+                raw: match[0],
+                text,
+                tokens: this.lexer.inlineTokens(text, []),
+            };
+        },
+    },
+];

package/lib/types/terminal-utils/markdown.d.ts

@@ -24,7 +24,9 @@ export declare function stripPromptXMLTags(content: string): string;
  * Configure the shared `marked` instance once. Strikethrough stays on
  * marked's built-in del tokenizer, which only matches double-tilde pairs —
  * single tildes (`~100`, models' "approximate") never pair up and render
- * literally. LaTeX math becomes `math`/`mathBlock` tokens (see math.ts).
+ * literally. LaTeX math becomes `math`/`mathBlock` tokens (see math.ts),
+ * and CJK-adjacent strong emphasis (`**标签：**中文`, unclosable under
+ * CommonMark's flanking rule) closes via cjk-emphasis.ts.
  * Every lexer caller — Markdown and StreamingMarkdown's boundary
  * lex — must run this first so both agree on block boundaries.
  */

package/lib/types/terminal-utils/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/terminal-utils/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAA4B,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAA;AAO1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AA4CrD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO1D;AAID;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAOtC;AAmFD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,EACZ,SAAS,SAAI,EACb,iBAAiB,GAAE,MAAM,GAAG,IAAW,EACvC,MAAM,GAAE,KAAK,GAAG,IAAW,EAC3B,SAAS,GAAE,YAAY,GAAG,IAAW,GACpC,MAAM,CASR;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,YAAY,GAAG,IAAW,GACpC,MAAM,CAiBR;AA8HD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,GAAG,MAAM,CAE1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,CA2BzF;AA8BD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK1E;AA2RD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GACpD,MAAM,CAUR"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/terminal-utils/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAA4B,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAA;AAO1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AA6CrD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO1D;AAID;;;;;;;;;GASG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAStC;AAmFD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,EACZ,SAAS,SAAI,EACb,iBAAiB,GAAE,MAAM,GAAG,IAAW,EACvC,MAAM,GAAE,KAAK,GAAG,IAAW,EAC3B,SAAS,GAAE,YAAY,GAAG,IAAW,GACpC,MAAM,CASR;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,YAAY,GAAG,IAAW,GACpC,MAAM,CAiBR;AA8HD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,GAAG,MAAM,CAE1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI,GAAG,MAAM,CA2BzF;AA8BD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK1E;AA2RD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GACpD,MAAM,CAUR"}

package/lib/types/terminal-utils/markdown.js

@@ -24,6 +24,7 @@ import { createHyperlink } from './hyperlink.js';
 import { fileLinkUrl, linkifyFilePaths, looksLikeFilePath } from '../utils/fileTarget.js';
 import { getMathRendering } from '../tuiDisplayPrefs.js';
 import { noteCodeHighlight, noteFormatToken } from '../ink/render-stats.js';
+import { CJK_EMPHASIS_EXTENSIONS } from './cjk-emphasis.js';
 import { isMathBlockToken, isMathToken, MATH_MARKDOWN_EXTENSIONS, renderInlineMath, } from './math.js';
 // '\n' is used unconditionally — os.EOL is '\r\n' on Windows, and the stray
 // '\r' breaks the character-to-segment mapping in applyStylesToWrappedText,
@@ -67,7 +68,9 @@ let markedInitialized = false;
  * Configure the shared `marked` instance once. Strikethrough stays on
  * marked's built-in del tokenizer, which only matches double-tilde pairs —
  * single tildes (`~100`, models' "approximate") never pair up and render
- * literally. LaTeX math becomes `math`/`mathBlock` tokens (see math.ts).
+ * literally. LaTeX math becomes `math`/`mathBlock` tokens (see math.ts),
+ * and CJK-adjacent strong emphasis (`**标签：**中文`, unclosable under
+ * CommonMark's flanking rule) closes via cjk-emphasis.ts.
  * Every lexer caller — Markdown and StreamingMarkdown's boundary
  * lex — must run this first so both agree on block boundaries.
  */
@@ -76,7 +79,9 @@ export function configureMarked() {
         return;
     markedInitialized = true;
     marked.use({
-        extensions: [...MATH_MARKDOWN_EXTENSIONS],
+        // Math first: a $…$ body holding emphasis-looking ** stays a formula;
+        // the CJK strong pass only sees what math declined.
+        extensions: [...MATH_MARKDOWN_EXTENSIONS, ...CJK_EMPHASIS_EXTENSIONS],
     });
 }
 /** Inline code is painted with the active theme's permission accent. */