@deepseek-harness-tui/dsh-tui 0.10.2 → 0.11.1

package/lib/types/components/sessions/SessionListRow.d.ts

@@ -2,6 +2,7 @@ import React from 'react';
 import type { ClickEvent } from '../../ink/events/click-event.js';
 import type { ContextMenuEvent } from '../../ink/events/context-menu-event.js';
 import type { SessionSummary } from '../../dsh-adapter/sessions/index.js';
+import type { AgentViewStatus } from '../../adapter/ports/channel-view.js';
 /**
  * One session in the browser's list: a title line and a metadata line.
  *
@@ -15,7 +16,7 @@ import type { SessionSummary } from '../../dsh-adapter/sessions/index.js';
  * stay exactly two lines at every terminal width, and a row that wraps
  * destroys the alignment that lets the eye scan a list at all.
  */
-export declare function SessionListRow({ session, width, depth, focused, pinned, now, onClick, onContextMenu, onTogglePin, }: {
+export declare function SessionListRow({ session, width, depth, focused, pinned, now, onClick, onContextMenu, onTogglePin, liveStatus, current, occupiedPid, spinner, }: {
     session: SessionSummary;
     /** Columns available to the row, indentation included. */
     width: number;
@@ -32,5 +33,26 @@ export declare function SessionListRow({ session, width, depth, focused, pinned,
     onContextMenu?(event: ContextMenuEvent): void;
     /** 点击行内 ★/☆（fullscreen）：切换固定状态，不冒泡成"打开会话"。 */
     onTogglePin?(): void;
+    /**
+     * Live status of an agent THIS terminal is running, when there is one.
+     * `working` animates instead of holding a static glyph, so a busy session
+     * is legible at a glance — the same vocabulary the session overview uses,
+     * which is what lets the two surfaces read as one feature.
+     */
+    liveStatus?: AgentViewStatus;
+    /** True when this is the session the terminal is attached to. */
+    current?: boolean;
+    /**
+     * The pid of ANOTHER TUI terminal holding this session, when one does. The
+     * row turns red and says so: the session stays visible but cannot be
+     * entered, which is the honest presentation of a claim this process must
+     * not break. Undefined means free, or already ours.
+     */
+    occupiedPid?: number;
+    /** Shared animation clock for the working glyph. */
+    spinner?: {
+        frame: number;
+        time: number;
+    };
 }): React.ReactNode;
 //# sourceMappingURL=SessionListRow.d.ts.map

package/lib/types/components/sessions/SessionListRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionListRow.d.ts","sourceRoot":"","sources":["../../../../src/components/sessions/SessionListRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAA;AAGvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAU9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAEzE;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,KAAK,EACL,KAAK,EACL,OAAO,EACP,MAAM,EACN,GAAG,EACH,OAAO,EACP,aAAa,EACb,WAAW,GACZ,EAAE;IACD,OAAO,EAAE,cAAc,CAAA;IACvB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,sEAAsE;IACtE,MAAM,EAAE,OAAO,CAAA;IACf,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAA;IACX,4CAA4C;IAC5C,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACjC,gDAAgD;IAChD,aAAa,CAAC,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC7C,8CAA8C;IAC9C,WAAW,CAAC,IAAI,IAAI,CAAA;CACrB,GAAG,KAAK,CAAC,SAAS,CA8ElB"}
+{"version":3,"file":"SessionListRow.d.ts","sourceRoot":"","sources":["../../../../src/components/sessions/SessionListRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAA;AAGvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAY9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AA0B1E;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,KAAK,EACL,KAAK,EACL,OAAO,EACP,MAAM,EACN,GAAG,EACH,OAAO,EACP,aAAa,EACb,WAAW,EACX,UAAU,EACV,OAAO,EACP,WAAW,EACX,OAAO,GACR,EAAE;IACD,OAAO,EAAE,cAAc,CAAA;IACvB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,sEAAsE;IACtE,MAAM,EAAE,OAAO,CAAA;IACf,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAA;IACX,4CAA4C;IAC5C,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACjC,gDAAgD;IAChD,aAAa,CAAC,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC7C,8CAA8C;IAC9C,WAAW,CAAC,IAAI,IAAI,CAAA;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oDAAoD;IACpD,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1C,GAAG,KAAK,CAAC,SAAS,CA6HlB"}

package/lib/types/components/sessions/SessionListRow.js

@@ -3,7 +3,31 @@ import { useState } from 'react';
 import { Box, Text } from '../../ui.js';
 import { t } from '../../i18n.js';
 import { useTooltip } from '../Tooltip.js';
+import { SpinnerGlyph } from '../Spinner/SpinnerGlyph.js';
+import { stringWidth } from '../../ink/stringWidth.js';
 import { formatAbsolute, formatBytes, formatWhen, kindMark, titleColor, truncateWidth, } from '../../sessions/format.js';
+/**
+ * State presentation for a session this terminal is running: one glyph and one
+ * theme colour per status, matching the session overview's own vocabulary so
+ * the same session never looks like two different things on two screens.
+ * `stopped` is the "not running here" spelling and draws dim.
+ */
+const LIVE_STATUS_GLYPH = {
+    'needs-input': '✻',
+    working: '✽',
+    completed: '✓',
+    failed: '✕',
+    idle: '∙',
+    stopped: '∙',
+};
+const LIVE_STATUS_COLOR = {
+    'needs-input': 'warning',
+    working: 'suggestion',
+    completed: 'success',
+    failed: 'error',
+    idle: undefined,
+    stopped: undefined,
+};
 /**
  * One session in the browser's list: a title line and a metadata line.
  *
@@ -17,7 +41,7 @@ import { formatAbsolute, formatBytes, formatWhen, kindMark, titleColor, truncate
  * stay exactly two lines at every terminal width, and a row that wraps
  * destroys the alignment that lets the eye scan a list at all.
  */
-export function SessionListRow({ session, width, depth, focused, pinned, now, onClick, onContextMenu, onTogglePin, }) {
+export function SessionListRow({ session, width, depth, focused, pinned, now, onClick, onContextMenu, onTogglePin, liveStatus, current, occupiedPid, spinner, }) {
     const indent = depth * 2;
     // Two cells for the focus marker, plus the indent for a nested run.
     const body = Math.max(8, width - 2 - indent);
@@ -30,10 +54,28 @@ export function SessionListRow({ session, width, depth, focused, pinned, now, on
     // and never the working directory, so that pair is always new information
     // for telling look-alike sessions apart.
     const titleText = session.label ?? session.title.text;
-    const titleBudget = body - 2 - (mark === undefined ? 0 : 2);
-    const shownTitle = truncateWidth(titleText, titleBudget);
+    /**
+     * The state cell holds EXACTLY two columns on every row, occupied or not,
+     * for the same reason the pin slot does: a column that appears only when a
+     * session is busy would shift every title on screen each time one starts or
+     * stops working.
+     */
+    const occupied = occupiedPid !== undefined;
+    const stateGlyph = occupied ? '⊘' : LIVE_STATUS_GLYPH[liveStatus ?? 'stopped'];
+    const stateColor = occupied
+        ? 'error'
+        : liveStatus === undefined
+            ? undefined
+            : LIVE_STATUS_COLOR[liveStatus];
+    const occupiedText = occupied ? ` ${t('supervisor-occupied-badge', { pid: occupiedPid })}` : '';
+    const currentText = current === true ? ` ${t('supervisor-current')}` : '';
+    const titleBudget = body - 2 - (mark === undefined ? 0 : 2) - 2
+        - stringWidth(occupiedText) - stringWidth(currentText);
+    const shownTitle = truncateWidth(titleText, Math.max(4, titleBudget));
     const titleTooltip = useTooltip(() => {
         const parts = [];
+        if (occupied)
+            parts.push(t('session-mount-occupied-short', { pid: occupiedPid }));
         if (shownTitle !== titleText)
             parts.push(titleText);
         parts.push(formatAbsolute(session.updatedAt));
@@ -52,10 +94,15 @@ export function SessionListRow({ session, width, depth, focused, pinned, now, on
     if (session.childCount > 0 && depth === 0) {
         facts.push(t('session-children', { n: session.childCount }));
     }
-    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, onClick: onClick, onContextMenu: onContextMenu, onMouseEnter: onClick !== undefined || onContextMenu !== undefined ? () => setHovered(true) : undefined, onMouseLeave: onClick !== undefined || onContextMenu !== undefined ? () => setHovered(false) : undefined, backgroundColor: focused || hovered ? 'userMessageBackgroundHover' : undefined, children: [_jsxs(Box, { children: [_jsx(Text, { color: focused ? 'suggestion' : 'subtle', children: `${' '.repeat(indent)}${focused ? '❯ ' : '  '}` }), _jsx(Box, { ...pinTooltip, onClick: onTogglePin === undefined ? undefined : (event) => {
+    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, onClick: onClick, onContextMenu: onContextMenu, onMouseEnter: onClick !== undefined || onContextMenu !== undefined ? () => setHovered(true) : undefined, onMouseLeave: onClick !== undefined || onContextMenu !== undefined ? () => setHovered(false) : undefined, 
+        // Hover is the BLUE prompt — pointer feedback and nothing else. Selection
+        // is green and never blue: a row the keyboard cursor is on must not look
+        // like a row the mouse happens to be over, so the two never share a
+        // background and a selected row keeps its own colour while hovered.
+        backgroundColor: hovered && !focused ? 'userMessageBackgroundHover' : undefined, children: [_jsxs(Box, { children: [_jsx(Text, { color: focused ? 'success' : 'subtle', children: `${' '.repeat(indent)}${focused ? '❯ ' : '  '}` }), _jsx(Box, { ...pinTooltip, onClick: onTogglePin === undefined ? undefined : (event) => {
                             // The star is a control on the row, not the row: a click here
                             // toggles the pin and must never fall through to resume.
                             event.stopImmediatePropagation();
                             onTogglePin();
-                        }, children: _jsx(Text, { color: pinned ? 'remember' : undefined, dimColor: !pinned, children: pinned ? '★ ' : '☆ ' }) }), mark !== undefined && _jsx(Text, { color: mark.color, children: `${mark.glyph} ` }), _jsx(Box, { ...titleTooltip, children: _jsx(Text, { color: titleColor(session.title.source, focused), bold: focused, children: shownTitle }) })] }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: `${' '.repeat(indent + 2)}${truncateWidth(facts.join(' · '), body)}` }) })] }));
+                        }, children: _jsx(Text, { color: pinned ? 'remember' : undefined, dimColor: !pinned, children: pinned ? '★ ' : '☆ ' }) }), _jsx(Box, { children: liveStatus === 'working' && !occupied && spinner !== undefined ? (_jsx(SpinnerGlyph, { frame: spinner.frame, messageColor: "suggestion", reducedMotion: false, time: spinner.time })) : (_jsx(Text, { color: stateColor, dimColor: liveStatus === undefined && !occupied, children: `${stateGlyph} ` })) }), mark !== undefined && _jsx(Text, { color: mark.color, children: `${mark.glyph} ` }), _jsx(Box, { ...titleTooltip, children: _jsx(Text, { color: occupied ? 'error' : titleColor(session.title.source, focused), bold: focused, children: shownTitle }) }), occupiedText !== '' && _jsx(Text, { color: "error", children: occupiedText }), currentText !== '' && _jsx(Text, { color: "success", children: currentText })] }), _jsx(Box, { children: _jsx(Text, { color: focused ? 'success' : undefined, dimColor: !focused, children: `${' '.repeat(indent + 2)}${truncateWidth(facts.join(' · '), body)}` }) })] }));
 }

package/lib/types/components/workspaces/HomeWorkspaceRow.d.ts

@@ -0,0 +1,49 @@
+import React from 'react';
+import type { ClickEvent } from '../../ink/events/click-event.js';
+import type { ContextMenuEvent } from '../../ink/events/context-menu-event.js';
+/**
+ * One workspace in the home screen's left rail.
+ *
+ * Two lines, like every other navigable row in this app: the name line is what
+ * the user named it, the detail line is where it actually is and how much is in
+ * it. The path is not decoration — two workspaces can carry the same basename
+ * (`.../a/work` and `.../b/work`), and the ledger allows duplicate titles, so
+ * the path is the only thing that tells them apart.
+ *
+ * Widths are resolved here rather than left to flexbox for the same reason the
+ * session rows resolve them: a row must be exactly two lines at every terminal
+ * width, and a wrapped row destroys the alignment a list is scanned by.
+ */
+export declare function HomeWorkspaceRow({ title, path, home, sessionCount, present, selected, focused, width, onSelect, onMenu, }: {
+    title: string;
+    /** Canonical directory path recorded in the ledger. */
+    path: string;
+    /** Home directory, for collapsing the path to `~`. */
+    home: string;
+    sessionCount: number;
+    /** False when the recorded directory no longer exists. */
+    present: boolean;
+    /** Whether this workspace's sessions are the ones on the right. */
+    selected: boolean;
+    /** Keyboard cursor. */
+    focused: boolean;
+    /** Columns available to the row. */
+    width: number;
+    /** Left click: show this workspace's sessions (same path as Enter). */
+    onSelect?(event: ClickEvent): void;
+    /** Right click: open the workspace action menu. */
+    onMenu?(event: ContextMenuEvent): void;
+}): React.ReactNode;
+/**
+ * The `+` row that opens the directory picker.
+ *
+ * Deliberately the FIRST row of the rail and always clickable: adding a
+ * workspace is the rail's only creation action, and a control that is only
+ * reachable by keyboard is a control most users never find in a terminal.
+ */
+export declare function HomeAddWorkspaceRow({ focused, width, onOpen, }: {
+    focused: boolean;
+    width: number;
+    onOpen?(event: ClickEvent): void;
+}): React.ReactNode;
+//# sourceMappingURL=HomeWorkspaceRow.d.ts.map

package/lib/types/components/workspaces/HomeWorkspaceRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HomeWorkspaceRow.d.ts","sourceRoot":"","sources":["../../../../src/components/workspaces/HomeWorkspaceRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAA;AAGvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAG9E;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,OAAO,EACP,KAAK,EACL,QAAQ,EACR,MAAM,GACP,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAA;IAChB,mEAAmE;IACnE,QAAQ,EAAE,OAAO,CAAA;IACjB,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,QAAQ,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IAClC,mDAAmD;IACnD,MAAM,CAAC,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;CACvC,GAAG,KAAK,CAAC,SAAS,CAuClB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,KAAK,EACL,MAAM,GACP,EAAE;IACD,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;CACjC,GAAG,KAAK,CAAC,SAAS,CAoBlB"}

package/lib/types/components/workspaces/HomeWorkspaceRow.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Box, Text } from '../../ui.js';
+import { t } from '../../i18n.js';
+import { formatProject, spreadRow, truncateWidth } from '../../sessions/format.js';
+/**
+ * One workspace in the home screen's left rail.
+ *
+ * Two lines, like every other navigable row in this app: the name line is what
+ * the user named it, the detail line is where it actually is and how much is in
+ * it. The path is not decoration — two workspaces can carry the same basename
+ * (`.../a/work` and `.../b/work`), and the ledger allows duplicate titles, so
+ * the path is the only thing that tells them apart.
+ *
+ * Widths are resolved here rather than left to flexbox for the same reason the
+ * session rows resolve them: a row must be exactly two lines at every terminal
+ * width, and a wrapped row destroys the alignment a list is scanned by.
+ */
+export function HomeWorkspaceRow({ title, path, home, sessionCount, present, selected, focused, width, onSelect, onMenu, }) {
+    const [hovered, setHovered] = useState(false);
+    const body = Math.max(8, width - 4);
+    // The presence marker leads the badge on purpose: `spreadRow` may truncate
+    // the right-hand segment, and "this directory is gone" is the one fact that
+    // must never be the part that gets cut (the session count is also visible in
+    // the pane, the missing directory is not).
+    const count = t('home-sessions-count', { n: sessionCount });
+    const badge = present ? count : `${t('home-workspace-missing')} · ${count}`;
+    const heading = spreadRow(`${selected ? '▣' : '▢'} ${title}`, `${selected ? '✓ ' : ''}${badge}`, body);
+    const detail = formatProject(path, home);
+    // The cursor (green) outranks the selection ring (green); both outrank the
+    // idle colour. Blue is not part of this ladder at all — see the background.
+    const headingColor = (focused || selected) ? 'success' : present ? 'text' : 'inactive';
+    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, paddingX: 1, onClick: onSelect, onContextMenu: onMenu, onMouseEnter: onSelect === undefined && onMenu === undefined ? undefined : () => setHovered(true), onMouseLeave: onSelect === undefined && onMenu === undefined ? undefined : () => setHovered(false), 
+        // Hover is the BLUE prompt — pointer feedback and nothing else, so it
+        // never marks the focused or the selected row. Selection itself is green
+        // in the text, which is why this row draws no box while selected.
+        backgroundColor: hovered && !focused ? 'userMessageBackgroundHover' : undefined, children: [_jsxs(Box, { height: 1, flexShrink: 0, overflow: "hidden", children: [_jsx(Text, { color: focused ? 'success' : 'subtle', children: focused ? '❯ ' : '  ' }), _jsx(Text, { color: headingColor, bold: focused || selected, children: heading.left }), _jsx(Text, { dimColor: !focused, children: `${' '.repeat(heading.gap)}${heading.right}` })] }), _jsx(Text, { color: (focused || selected) ? 'success' : undefined, dimColor: !(focused || selected), wrap: "truncate-end", children: `  ${truncateWidth(detail, body - 2)}` })] }));
+}
+/**
+ * The `+` row that opens the directory picker.
+ *
+ * Deliberately the FIRST row of the rail and always clickable: adding a
+ * workspace is the rail's only creation action, and a control that is only
+ * reachable by keyboard is a control most users never find in a terminal.
+ */
+export function HomeAddWorkspaceRow({ focused, width, onOpen, }) {
+    const [hovered, setHovered] = useState(false);
+    const body = Math.max(8, width - 4);
+    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, paddingX: 1, onClick: onOpen, onMouseEnter: onOpen === undefined ? undefined : () => setHovered(true), onMouseLeave: onOpen === undefined ? undefined : () => setHovered(false), backgroundColor: focused || hovered ? 'userMessageBackgroundHover' : undefined, children: [_jsxs(Box, { height: 1, flexShrink: 0, overflow: "hidden", children: [_jsx(Text, { color: focused ? 'suggestion' : 'subtle', children: focused ? '❯ ' : '  ' }), _jsx(Text, { color: "remember", bold: true, children: `＋ ${t('home-add-workspace')}` })] }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: `  ${truncateWidth(t('home-add-hint'), body - 2)}` })] }));
+}

package/lib/types/dsh-adapter/activity-store.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Session-scoped activity snapshots for the working-status line.
+ *
+ * The line's *semantics* belong to the `dsh-working-activity` plugin: it folds
+ * durable session events and live model frames into a **session projection**
+ * (`workingActivity`) that any client can read — the browser reads it, and so
+ * does this TUI. Consuming the projection is what removes the second tracker
+ * this app used to run: one semantic owner, and a value that arrives already
+ * scoped to a session, so a background session can no longer overwrite the line
+ * of the session on screen.
+ *
+ * Two properties of the transport shape this module:
+ *
+ * 1. **It is event-driven.** A value changes when a committed event folds, never
+ *    on its own. `updatedAt` is the timestamp of the last folded event (session
+ *    time, so it survives a restart) and `live` says whether `line` counts
+ *    elapsed time. A renderer that wants the counter to move must derive it from
+ *    `turnStartedAt` / `phaseStartedAt` instead of re-rendering `line`.
+ * 2. **The value is host data, not plugin API.** The shape below is a local
+ *    structural copy of the plugin's wire value, the same discipline the channel
+ *    port already applies to the activity state: this app must not import the
+ *    plugin's internals to display a line.
+ * @module dsh-tui/dsh-adapter/activity-store
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** The projection key the activity plugin publishes. */
+export declare const ACTIVITY_PROJECTION_KEY = "workingActivity";
+/** Phases the plugin's line can be in (`idle` renders nothing). */
+export type ActivityPhase = 'idle' | 'waiting' | 'thinking' | 'tool' | 'done';
+/**
+ * One session's activity value, as the plugin publishes it.
+ *
+ * Structural copy of `dsh-working-activity`'s `WorkingActivityView`.
+ */
+export interface ActivityView {
+    readonly phase: ActivityPhase;
+    /** The line as the host rendered it at `updatedAt`. */
+    readonly line: string;
+    /** Whether `line` counts elapsed time (a renderer ticks it from the stamps). */
+    readonly live: boolean;
+    /** Tool action verb, when the line describes a running tool. */
+    readonly label?: string;
+    /** Tool detail fragment (path / command / pattern), when there is one. */
+    readonly detail?: string;
+    /** The playful phrase or `⏵` self-narration currently shown, when any. */
+    readonly phrase?: string;
+    /** Tools completed in the current turn. */
+    readonly toolCount: number;
+    /** Wall clock the current phase began. */
+    readonly phaseStartedAt: number;
+    /** Wall clock the current turn began (0 when no turn has started). */
+    readonly turnStartedAt: number;
+    /** Timestamp of the last folded event — the value's freshness signal. */
+    readonly updatedAt: number;
+    /** Language the line was rendered in. */
+    readonly lang: 'zh' | 'en';
+}
+/** The slice of the host projection registry this module uses. */
+export interface ProjectionRegistryLike {
+    onChanged(listener: (session: {
+        readonly id: unknown;
+    }, key: string, value: unknown, seq: number) => void): () => void;
+    snapshot(session: unknown, keys?: readonly string[]): {
+        readonly values: Record<string, unknown>;
+    };
+}
+/**
+ * Narrow one projection value: anything that is not an activity view is
+ * dropped rather than rendered half-formed.
+ * @param value - Raw projection value.
+ * @returns the value as an activity view, or `undefined`.
+ */
+export declare function asActivityView(value: unknown): ActivityView | undefined;
+/**
+ * The latest activity value for the session on screen, with a subscription
+ * for renderers.
+ *
+ * The store is effectively single-current: binding a session ({@link
+ * ActivityStore.seed}) names the session the UI is showing, and every other
+ * id is dropped — values, session objects and read-failure counts alike. A
+ * registry-less store (the UI's fallback, test rigs) has no current session
+ * and keeps today's accept-all behavior.
+ */
+export declare class ActivityStore {
+    private readonly values;
+    /** Session objects seen for each id, so a live value can be re-read. */
+    private readonly sessions;
+    /** Consecutive failed reads per session id; reset by a successful read. */
+    private readonly readFailures;
+    /** Sessions already warned about (see {@link noteReadFailure}): once each. */
+    private readonly warned;
+    private readonly listeners;
+    /** The session the UI is showing (the last {@link seed}); the only id kept. */
+    private currentId;
+    /** Host registry, remembered so a bind can read a baseline on demand. */
+    private registry;
+    /** Warn sink (see {@link noteReadFailure}); injected by the composition root. */
+    private readonly warn;
+    constructor(warn?: (message: string) => void);
+    /** Remember the host registry (see {@link seed} and {@link refreshLive}). */
+    attachRegistry(registry: ProjectionRegistryLike): void;
+    /**
+     * Seed one session from the registry's current snapshot and make it the
+     * current one.
+     *
+     * A value only *arrives* when it changes, so a session opened after its last
+     * change — a resume, or a window reattached to a running agent — would show
+     * nothing until the next event without this read. The bind also defines the
+     * session on screen: every other id is pruned, so a later event — or the
+     * tick — for a session the user switched away from can no longer fill this
+     * store or keep a timer armed.
+     * @param session - Session being bound.
+     */
+    seed(session: unknown): void;
+    /**
+     * Note the session object behind an id, so a live value can be re-read.
+     * Dropped for any id other than the current one (see {@link seed}). */
+    remember(sessionId: string, session: unknown): void;
+    /**
+     * Re-read the current session's value while it is still counting time.
+     *
+     * The host renders the value when it is *read*, so this is what makes the
+     * elapsed seconds advance between committed events — with the host's own copy
+     * and language, since nothing is re-rendered here. A value that has settled
+     * (`live` false: idle, or a finished turn) is deliberately skipped: its text
+     * cannot change on its own. Only the current session can be live (see
+     * {@link seed}), so the tick never polls a session the user left.
+     */
+    refreshLive(): void;
+    /** Whether the current session's value is still counting time (see {@link refreshLive}). */
+    hasLive(): boolean;
+    /** The current value for one session, stable between updates. */
+    get(sessionId: string | undefined): ActivityView | undefined;
+    /**
+     * Record one projection value. Dropped for any id other than the current
+     * one (see {@link seed}).
+     * @param sessionId - Session the value belongs to.
+     * @param view - The published value.
+     */
+    update(sessionId: string, view: ActivityView): void;
+    /** Forget one session (disposed, or left behind by a reset). */
+    clear(sessionId: string): void;
+    /** A read succeeded: this session's consecutive-failure count restarts. */
+    noteReadSuccess(sessionId: string): void;
+    /**
+     * A read failed. The failure is reported to the warn sink ONCE per session
+     * (the sink is the composition root's logger — this module stays free of
+     * cordis types), and after {@link MAX_READ_FAILURES} consecutive failures
+     * the value is cleared so the tick disarms instead of polling a registry
+     * that will never answer.
+     * @param sessionId - Session whose read failed.
+     * @param detail - What the failed read threw.
+     */
+    noteReadFailure(sessionId: string, detail: string): void;
+    /** Drop every id that is not the current one; emit when a value went. */
+    private pruneToCurrent;
+    /** Subscribe to value changes; returns the unsubscribe function. */
+    subscribe(listener: () => void): () => void;
+    private emit;
+}
+/**
+ * The change-feed listener for one store.
+ *
+ * Only this plugin's key is read, and only values that narrow to an activity
+ * view are accepted: the feed is host-wide, so every other unit's change and
+ * every malformed value must be dropped here rather than inside a renderer.
+ * @param store - Store to fill.
+ * @returns the listener to hand to `ProjectionRegistry.onChanged`.
+ */
+export declare function createActivityFeed(store: ActivityStore): (session: {
+    readonly id: unknown;
+}, key: string, value: unknown) => void;
+/** How often a value that is still counting time is re-read from the host. */
+export declare const LIVE_TICK_MS = 500;
+/**
+ * Wire one store to the host's projection registry.
+ *
+ * Registration is deferred through `inject` because the plugin that *publishes*
+ * the unit is mounted alongside this one: the registry may not exist yet, and
+ * the unit may not be registered until later still. Both absences are normal —
+ * a composition without the activity plugin simply never fills the store, and
+ * the line falls back to whatever else the UI has.
+ *
+ * The feed is event-driven, so a value only lands when a committed event folds;
+ * its elapsed text would therefore freeze for the length of a long tool. The
+ * host renders a value when it is READ, so a timer re-reads the live ones: the
+ * seconds advance, the copy and language stay the plugin's, and a settled value
+ * (idle, or a finished turn) stops the timer instead of being polled forever.
+ * @param ctx - Host context of the composition root.
+ * @param store - Store to fill.
+ */
+export declare function attachActivityProjection(ctx: Context, store: ActivityStore): void;
+/**
+ * Create the composition root's activity store and wire it to the host.
+ * @param ctx - Host context of the composition root.
+ * @param enabled - Whether the working line is shown at all (cordis.yml
+ *   `activity`; a static, config-time switch — the runtime `/activity` command
+ *   only changes the preset). With the line off, nothing attaches: no feed,
+ *   no registry, and therefore no 500ms tick for a line nobody renders.
+ * @returns the store the UI reads from.
+ */
+export declare function createActivityStore(ctx: Context, enabled: boolean): ActivityStore;
+/**
+ * Read one session's activity value in a component.
+ * @param store - Store to read.
+ * @param sessionId - Session the UI is showing.
+ * @returns the current value, or `undefined` when there is none.
+ */
+export declare function useActivity(store: ActivityStore, sessionId: string | undefined): ActivityView | undefined;
+/**
+ * Seed one session's value from the registry's current snapshot.
+ *
+ * A value only *arrives* when it changes, so a session opened after its last
+ * change — a resume, or a window reattached to a running agent — would show
+ * nothing until the next event without this read.
+ * @param registry - Host projection registry.
+ * @param store - Store to fill.
+ * @param session - Session to read.
+ */
+export declare function seedActivity(registry: ProjectionRegistryLike | undefined, store: ActivityStore, session: unknown): void;
+//# sourceMappingURL=activity-store.d.ts.map

package/lib/types/dsh-adapter/activity-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-store.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/activity-store.ts"],"names":[],"mappings":"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"}