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

package/lib/types/screens/sessionSupervisor/model.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Pure model for the unified session screen: constants, view types and the
+ * derivations that are testable without a terminal.
+ *
+ * Kept apart from the screen so the hook and the screen can share them without
+ * importing each other, and so a regression can drive them directly. Anything
+ * that needs a channel, the filesystem or a render belongs to the hook instead.
+ */
+import type { SessionSummary } from '../../dsh-adapter/sessions/index.js';
+import type { TuiWorkspaceEntry } from '../../workspaces.js';
+/**
+ * Rows the left rail always keeps: the section header, the hint line, and the
+ * blank rows around them.
+ *
+ * There is no `+` row any more. A workspace enters the ledger by being the
+ * directory a terminal started in (see the startup attach in `plugin.ts`), so
+ * the rail has no creation control to reserve a row for.
+ */
+export declare const RAIL_CHROME_ROWS = 4;
+/** Terminal rows one rail entry occupies; see {@link HomeWorkspaceRow}. */
+export declare const WORKSPACE_ROW_LINES = 2;
+/** Width the rail gets when the terminal is wide enough to show both panes. */
+export declare const RAIL_MIN_TOTAL_COLUMNS = 84;
+export declare const RAIL_WIDTH_MIN = 24;
+export declare const RAIL_WIDTH_MAX = 38;
+/** Two lines per session row (title + facts), plus the filter and notice rows. */
+export declare const SESSION_ROW_LINES = 2;
+/** Chrome the right pane spends on banner, filter, new-session card, notice and hints. */
+export declare const SESSION_PANE_CHROME_ROWS = 8;
+export type MenuAction = 'edit' | 'new' | 'rename' | 'remove';
+export declare const MENU_ACTIONS: readonly MenuAction[];
+export declare const MENU_WIDTH = 30;
+/** One confirm line + its explanation. */
+export declare const MENU_HEIGHT: number;
+export declare const MENU_LABEL_KEYS: {
+    readonly edit: "home-menu-edit";
+    readonly new: "home-menu-new";
+    readonly rename: "home-menu-rename";
+    readonly remove: "home-menu-remove";
+};
+/**
+ * What this terminal knows about one session's live state, from the channel's
+ * agent-view projection. Absent for a session this process never mounted.
+ */
+export interface SupervisorLiveState {
+    /** The row status vocabulary the overview column already uses. */
+    readonly status: 'working' | 'needs-input' | 'idle' | 'completed' | 'failed' | 'stopped';
+    /** True when an agent for this session is alive in THIS process. */
+    readonly live: boolean;
+    /** True when this is the session the terminal is attached to. */
+    readonly current: boolean;
+    /** One-line activity summary. */
+    readonly summary: string;
+}
+/**
+ * One row of the workspace rail: a durable registration, or the fallback group
+ * for sessions whose directory is NOT registered.
+ *
+ * The registry is not the whole session store — a host can run without the
+ * workspace service at all (bare compositions return an empty registry), and a
+ * session keeps existing after its registration is removed. Those sessions are
+ * still resumable, so "no registration" must not read as "no history".
+ */
+export type RailEntry = TuiWorkspaceEntry & {
+    readonly from: 'registry' | 'unregistered';
+};
+/** Synthetic id/path for the fallback group; never persisted. */
+export declare const UNREGISTERED_RAIL_ID = "rail:unregistered";
+export declare function message(error: unknown): string;
+/** Case-insensitive path equality, matching the workspace ledger's own rule. */
+export declare function samePath(left: string, right: string): boolean;
+/**
+ * Case-insensitive substring match over the fields a person searches by.
+ *
+ * Title and label are the obvious ones; the working directory and branch are
+ * included because "which of these three look-alike sessions" is usually
+ * answered by where it ran and what it was on, not by its truncated title.
+ * @param session - The session to test.
+ * @param needle - Lower-cased query; empty matches everything.
+ * @returns True when the session should stay visible.
+ */
+export declare function sessionMatchesQuery(session: SessionSummary, needle: string): boolean;
+//# sourceMappingURL=model.d.ts.map

package/lib/types/screens/sessionSupervisor/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../src/screens/sessionSupervisor/model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAG5D;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,IAAI,CAAA;AACjC,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,IAAI,CAAA;AACpC,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,KAAK,CAAA;AACxC,eAAO,MAAM,cAAc,KAAK,CAAA;AAChC,eAAO,MAAM,cAAc,KAAK,CAAA;AAChC,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAClC,0FAA0F;AAC1F,eAAO,MAAM,wBAAwB,IAAI,CAAA;AAEzC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAC7D,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAAwC,CAAA;AACtF,eAAO,MAAM,UAAU,KAAK,CAAA;AAC5B,0CAA0C;AAC1C,eAAO,MAAM,WAAW,QAA0B,CAAA;AAElD,eAAO,MAAM,eAAe;;;;;CAKlB,CAAA;AAEV;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;IACxF,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,iBAAiB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAAA;CAAE,CAAA;AAE1F,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,sBAAsB,CAAA;AAEvD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE9C;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAUpF"}

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

@@ -0,0 +1,69 @@
+/**
+ * Pure model for the unified session screen: constants, view types and the
+ * derivations that are testable without a terminal.
+ *
+ * Kept apart from the screen so the hook and the screen can share them without
+ * importing each other, and so a regression can drive them directly. Anything
+ * that needs a channel, the filesystem or a render belongs to the hook instead.
+ */
+import { normalizeWorkspaceCwd } from '../../sessions/view.js';
+/**
+ * Rows the left rail always keeps: the section header, the hint line, and the
+ * blank rows around them.
+ *
+ * There is no `+` row any more. A workspace enters the ledger by being the
+ * directory a terminal started in (see the startup attach in `plugin.ts`), so
+ * the rail has no creation control to reserve a row for.
+ */
+export const RAIL_CHROME_ROWS = 4;
+/** Terminal rows one rail entry occupies; see {@link HomeWorkspaceRow}. */
+export const WORKSPACE_ROW_LINES = 2;
+/** Width the rail gets when the terminal is wide enough to show both panes. */
+export const RAIL_MIN_TOTAL_COLUMNS = 84;
+export const RAIL_WIDTH_MIN = 24;
+export const RAIL_WIDTH_MAX = 38;
+/** Two lines per session row (title + facts), plus the filter and notice rows. */
+export const SESSION_ROW_LINES = 2;
+/** Chrome the right pane spends on banner, filter, new-session card, notice and hints. */
+export const SESSION_PANE_CHROME_ROWS = 8;
+export const MENU_ACTIONS = ['edit', 'new', 'rename', 'remove'];
+export const MENU_WIDTH = 30;
+/** One confirm line + its explanation. */
+export const MENU_HEIGHT = MENU_ACTIONS.length + 2;
+export const MENU_LABEL_KEYS = {
+    edit: 'home-menu-edit',
+    new: 'home-menu-new',
+    rename: 'home-menu-rename',
+    remove: 'home-menu-remove',
+};
+/** Synthetic id/path for the fallback group; never persisted. */
+export const UNREGISTERED_RAIL_ID = 'rail:unregistered';
+export function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** Case-insensitive path equality, matching the workspace ledger's own rule. */
+export function samePath(left, right) {
+    return normalizeWorkspaceCwd(left) === normalizeWorkspaceCwd(right);
+}
+/**
+ * Case-insensitive substring match over the fields a person searches by.
+ *
+ * Title and label are the obvious ones; the working directory and branch are
+ * included because "which of these three look-alike sessions" is usually
+ * answered by where it ran and what it was on, not by its truncated title.
+ * @param session - The session to test.
+ * @param needle - Lower-cased query; empty matches everything.
+ * @returns True when the session should stay visible.
+ */
+export function sessionMatchesQuery(session, needle) {
+    if (needle.length === 0)
+        return true;
+    const haystack = [
+        session.title.text,
+        session.label ?? '',
+        session.cwd,
+        session.branch ?? '',
+        session.model ?? '',
+    ].join('\n').toLowerCase();
+    return haystack.includes(needle);
+}

package/lib/types/screens/sessionSupervisor/useSessionSupervisor.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Data, derived state and actions for the unified session screen.
+ *
+ * The screen keeps only assembly and key routing; everything that answers "what
+ * is on screen and what does an action do" lives here. That is what makes the
+ * two panes presentational and the derivations reachable from a regression.
+ *
+ * Two ownership rules must not be duplicated anywhere else:
+ * - the cursor is ONE fact; every index is derived from it, so movement,
+ *   rendering and Enter can never disagree;
+ * - occupancy is re-read from the ledger on this screen own pulse and never
+ *   captured from the parent render.
+ */
+import React from 'react';
+import type { SessionSummary } from '../../dsh-adapter/sessions/index.js';
+import type { TuiWorkspaceEntry, TuiWorkspaceTarget } from '../../workspaces.js';
+import type { ChannelUi as Channel } from '../../adapter/channel/ui-policy.js';
+import { SupervisorLiveState, RailEntry } from './model.js';
+/** Everything the screen owns that the model needs to read. */
+export interface SessionSupervisorInput {
+    readonly channel: Channel;
+    /** Home directory, for collapsing paths to `~`. */
+    readonly home: string;
+    /** Mount a persisted session (the channel unified resume path). */
+    onOpenSession(sessionId: string): Promise<boolean>;
+    /** Start a fresh session in the workspace at `path`. */
+    onNewSession(target: TuiWorkspaceTarget): Promise<boolean>;
+    /** Stop a background session of this terminal; false when it is not ours. */
+    onStopSession(sessionId: string): Promise<boolean>;
+    /** This terminal live state for a session, or undefined when it has none. */
+    liveStateOf(sessionId: string): SupervisorLiveState | undefined;
+    readonly columns: number;
+    readonly rows: number;
+}
+/**
+ * Derive the whole screen model.
+ * @param input - Channel, home, the opening/stop actions and the live lookup.
+ * @returns Every value the screen renders from, plus the action callbacks.
+ */
+export declare function useSessionSupervisor(input: SessionSupervisorInput): {
+    entries: readonly RailEntry[];
+    sessions: readonly SessionSummary[];
+    loading: boolean;
+    notice: {
+        text: string;
+        tone: "info" | "error";
+    } | undefined;
+    setNotice: React.Dispatch<React.SetStateAction<{
+        text: string;
+        tone: "info" | "error";
+    } | undefined>>;
+    query: string;
+    setQuery: React.Dispatch<React.SetStateAction<string>>;
+    holderOf: (sessionId: string) => number | undefined;
+    listedSessions: SessionSummary[];
+    railEntries: readonly RailEntry[];
+    countOf: (entry: RailEntry) => number;
+    railFocus: number;
+    setRailFocus: React.Dispatch<React.SetStateAction<number>>;
+    setFocusSessionId: React.Dispatch<React.SetStateAction<string | undefined>>;
+    activePane: "list" | "rail";
+    pins: ReadonlySet<string>;
+    menu: {
+        path: string;
+        col: number;
+        row: number;
+        item: number;
+    } | undefined;
+    setMenu: React.Dispatch<React.SetStateAction<{
+        path: string;
+        col: number;
+        row: number;
+        item: number;
+    } | undefined>>;
+    rename: {
+        path: string;
+        draft: string;
+    } | undefined;
+    setRename: React.Dispatch<React.SetStateAction<{
+        path: string;
+        draft: string;
+    } | undefined>>;
+    confirmRemove: string | undefined;
+    setConfirmRemove: React.Dispatch<React.SetStateAction<string | undefined>>;
+    railRef: React.RefObject<number>;
+    menuRef: React.RefObject<{
+        path: string;
+        col: number;
+        row: number;
+        item: number;
+    } | undefined>;
+    queryRef: React.RefObject<string>;
+    now: number;
+    reload: () => Promise<void>;
+    selected: RailEntry | undefined;
+    visibleSessions: SessionSummary[];
+    sessionIndex: number;
+    cardFocused: boolean;
+    sessionAt: (index: number) => SessionSummary | undefined;
+    activateList: () => void;
+    activateRail: () => void;
+    railWidth: number;
+    railVisible: boolean;
+    sessionWidth: number;
+    railEntryCapacity: number;
+    sessionListHeight: number;
+    persistPin: (id: string, pinned: boolean) => void;
+    selectEntry: (entry: RailEntry) => void;
+    openSession: (session: SessionSummary) => void;
+    newSessionIn: (entry: TuiWorkspaceEntry) => void;
+    renameEntry: (path: string, title: string) => void;
+    removeEntry: (path: string) => void;
+    stopSession: (session: SessionSummary) => void;
+    closeMenu: () => void;
+    activateMenu: (entry: RailEntry, item: number) => void;
+    moveRail: (by: 1 | -1) => void;
+    moveSession: (by: 1 | -1) => void;
+    focusedSession: SessionSummary | undefined;
+};
+//# sourceMappingURL=useSessionSupervisor.d.ts.map

package/lib/types/screens/sessionSupervisor/useSessionSupervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionSupervisor.d.ts","sourceRoot":"","sources":["../../../../src/screens/sessionSupervisor/useSessionSupervisor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAiD,MAAM,OAAO,CAAA;AAOrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAChF,OAAO,KAAK,EAAE,SAAS,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAA;AAC9E,OAAO,EAAkN,mBAAmB,EAAE,SAAS,EAAgE,MAAM,YAAY,CAAA;AAEzU,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,mEAAmE;IACnE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAClD,wDAAwD;IACxD,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,6EAA6E;IAC7E,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAClD,6EAA6E;IAC7E,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAA;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,sBAAsB;;;;;cAMnB,MAAM;cAAQ,MAAM,GAAG,OAAO;;;cAA9B,MAAM;cAAQ,MAAM,GAAG,OAAO;;;;0BAwB7D,MAAM,KAAG,MAAM,GAAG,SAAS;;;qBA6F/B,SAAS,KAAG,MAAM;;;;;;;cA6Ca,MAAM;aAAO,MAAM;aAAO,MAAM;cAAQ,MAAM;;;cAA9C,MAAM;aAAO,MAAM;aAAO,MAAM;cAAQ,MAAM;;;cAC1C,MAAM;eAAS,MAAM;;;cAArB,MAAM;eAAS,MAAM;;;;;;cADzB,MAAM;aAAO,MAAM;aAAO,MAAM;cAAQ,MAAM;;;;kBA0ClD,OAAO,CAAC,IAAI,CAAC;;;;;uBA+IxC,MAAM,KAAG,cAAc,GAAG,SAAS;wBAWR,IAAI;wBAOJ,IAAI;;;;;;qBA2BL,MAAM,UAAU,OAAO,KAAG,IAAI;yBAS1B,SAAS,KAAG,IAAI;2BAed,cAAc,KAAG,IAAI;0BAmBtB,iBAAiB,KAAG,IAAI;wBAgB1B,MAAM,SAAS,MAAM,KAAG,IAAI;wBAe5B,MAAM,KAAG,IAAI;2BAWV,cAAc,KAAG,IAAI;qBAiB7B,IAAI;0BAKG,SAAS,QAAQ,MAAM,KAAG,IAAI;mBAarC,CAAC,GAAG,CAAC,CAAC,KAAG,IAAI;sBAWV,CAAC,GAAG,CAAC,CAAC,KAAG,IAAI;;EAqEnD"}