dsh-ssh-tui 0.5.4 → 0.5.5

package/lib/types/copy-text.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Plain-text extraction for /copy. Kept off tui.ts so tests do not load SshTui.
+ */
+import type { CollapsibleBlock, Row } from './transcript-types.js';
+export declare function copyTextFromRow(row: Row | CollapsibleBlock | undefined): string;
+export declare function copyTextFromTranscript(rows: readonly Row[], focused: Row | CollapsibleBlock | null): {
+    text: string;
+    source: 'focused' | 'assistant' | 'empty';
+};

package/lib/types/dsh-compat.d.ts

@@ -1,17 +1,21 @@
 /**
- * Dual-stack shims for dsh 0.1.1-rc.2 and 0.1.2-rc.1.
+ * Dual-stack shims for dsh 0.1.2-rc.1 and 0.1.5-rc.1 (and the 0.1.5-alpha
+ * handle API that landed with it).
  *
- * 0.1.2 turned the settings free functions into `SettingsProvider` methods,
- * replaced `Session.events` with on-demand readers, and started branding
- * namespaces at the type level only. Every shim here keeps the same runtime
- * value on both hosts and picks the API shape that is actually present.
+ * 0.1.2 turned settings free functions into `SettingsProvider` methods and
+ * replaced `Session.events` with on-demand readers. 0.1.5 replaced
+ * `SessionPersistence.list`/`inspect`/`locate` with snapshot `list` plus
+ * per-session `open` handles, and moved live tokens from durable
+ * `assistant/chunk` events to process-local `agent/assistant-stream`.
+ * Every shim here picks the API that is actually present so one build
+ * runs on either host.
  */
 import type { Context } from '@deepseek-ai/cordis';
 import type { SessionEvent } from '@deepseek-ai/dsh-session';
 import type { SettingsNamespace, SettingsSectionHooks } from '@deepseek-ai/dsh-settings';
 import type z from '@deepseek-ai/schemastery';
 /**
- * 0.1.1-rc.2 wraps namespaces via `settingsNamespace()`; 0.1.2 brands them at
+ * 0.1.1-rc.2 wraps namespaces via `settingsNamespace()`; 0.1.2+ brands them at
  * the type level and takes the plain string at runtime. A cast covers both.
  */
 export declare function settingsNamespace(value: string): SettingsNamespace;
@@ -28,3 +32,71 @@ export declare function installSettingsSection<T>(ctx: Context, ns: SettingsName
  * property with on-demand readers; 0.1.1-rc.2 still exposes the property.
  */
 export declare function sessionEvents(session: object): readonly SessionEvent[];
+/**
+ * Walk the durable log without copying it. Prefer `eventAt` so resume does
+ * not materialize a second array of every chunk.
+ */
+export declare function forEachSessionEvent(session: object, visit: (event: SessionEvent) => void): void;
+/** Header fields the picker and resume path actually read. */
+export interface SessionHeaderLike {
+    id: string;
+    createdAt: number;
+    cwd?: string;
+    origin?: string;
+    delegationDepth?: number;
+}
+/** Logical log plus the header it belongs to. */
+export interface SessionInspectionLike {
+    events: readonly unknown[];
+    meta?: SessionHeaderLike;
+    header?: SessionHeaderLike;
+}
+/**
+ * 0.1.2 `list()` returns headers; 0.1.5 returns `{ header, revision, … }`
+ * snapshots. Normalize to headers so the picker does not care which host
+ * it is talking to.
+ */
+export declare function listPersistenceHeaders(persistence: object): Promise<SessionHeaderLike[]>;
+/**
+ * 0.1.2 `inspect(id)` returns `{ meta, events }`. 0.1.5 dropped inspect in
+ * favour of `open(id, 'read')` + `handle.read()`. Close the handle so a
+ * listing pass does not pin write ownership.
+ */
+export declare function inspectPersistenceSession(persistence: object, id: unknown): Promise<SessionInspectionLike>;
+/** 0.1.2 owns `locate(header)`; 0.1.5 hid it on the JSONL backend. */
+export declare function persistenceLocate(persistence: object, meta: object): {
+    path?: string;
+} | undefined;
+/**
+ * 0.1.2 command input advertised `images`; 0.1.5 renamed the flag to
+ * `attachments`. Either true means the slash command accepts composer files.
+ */
+export declare function commandAcceptsAttachments(input: unknown): boolean;
+/** One model stream chunk, from either `assistant/chunk` or `agent/assistant-stream`. */
+export interface StreamChunkLike {
+    type: string;
+    text?: string;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+}
+/** Durable `assistant/chunk` payload, or a live stream frame's inner chunk. */
+export declare function streamChunkOf(eventOrFrame: unknown): {
+    chunk: StreamChunkLike;
+    turn: number;
+    step: number;
+    time: number;
+} | undefined;
+/** Durable event type as a plain string so 0.1.5 hosts can omit `assistant/chunk`. */
+export declare function sessionEventType(event: unknown): string;
+/** True when this event is a live-or-durable assistant token that replay should skip. */
+export declare function isAssistantStreamEvent(event: unknown): boolean;
+/**
+ * Subscribe to a host event that may not exist on the compile-time Events
+ * map. 0.1.5 emits `agent/assistant-stream`; 0.1.2 never does. Cordis
+ * still accepts the string; the listener is simply never called on 0.1.2.
+ */
+export declare function listenHostEvent(ctx: {
+    on: (event: never, handler: never) => unknown;
+}, event: string, handler: (...args: unknown[]) => unknown): () => void;

package/lib/types/paint.d.ts

@@ -76,3 +76,5 @@ export declare function parseCursorPositionReply(text: string): {
 export declare function probeTerminalRttMs(stdin?: NodeJS.ReadStream, stdout?: NodeJS.WriteStream, timeoutMs?: number): Promise<number | undefined>;
 /** Sliding window of `windowSize` items that keeps `cursor` visible. */
 export declare function pickerWindowStart(cursor: number, total: number, windowSize?: number): number;
+/** Immediate first-frame chrome so a 2–3s Host boot is not a blank TTY. */
+export declare function writeBootSplash(message: string, color?: boolean): void;

package/lib/types/picker.d.ts

@@ -37,6 +37,8 @@ export interface SessionPickerState {
      * shortcuts. Set automatically by the first letter, or by `/` / Ctrl+F.
      */
     filterActive: boolean;
+    /** Older logs are still being inspected in the background. */
+    loading?: boolean;
 }
 /** One key / control action against {@link SessionPickerState}. */
 export type SessionPickerAction = {

package/lib/types/session-index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Disk cache of picker labels so listing history does not inspect every
+ * session.jsonl.zstd on each launch. Invalidated by file mtime/size.
+ */
+/** One cached picker row for a stored session. */
+export interface SessionIndexEntry {
+    id: string;
+    label: string;
+    updatedAt: number;
+    cwd: string;
+    hasUserInput: boolean;
+    hasReply: boolean;
+    unreadable?: boolean;
+    mtimeMs: number;
+    size: number;
+}
+/** First page of recent sessions inspected after the header sketch paints. */
+export declare const PICKER_PRIORITY_COUNT = 9;
+export declare function sessionIndexPath(dshHome?: string): string;
+/** Artifact fingerprint used as the cache key. Missing files return zeros. */
+export declare function sessionArtifactStat(persistence: object, meta: object): {
+    mtimeMs: number;
+    size: number;
+};
+export declare function indexEntryMatchesStat(entry: SessionIndexEntry | undefined, stat: {
+    mtimeMs: number;
+    size: number;
+}): boolean;
+export declare function loadSessionIndex(path: string): Promise<Map<string, SessionIndexEntry>>;
+export declare function saveSessionIndex(path: string, entries: ReadonlyMap<string, SessionIndexEntry>): Promise<void>;
+/** Drop ids that are no longer in the store so the file cannot grow forever. */
+export declare function pruneSessionIndex(entries: Map<string, SessionIndexEntry>, keepIds: ReadonlySet<string>): void;

package/lib/types/session-list.d.ts

@@ -3,7 +3,6 @@
  * in-app `/resume` command use the same candidates, labels, and ordering, so
  * both surfaces offer the same sessions.
  */
-import type { SessionPersistence } from '@deepseek-ai/dsh-session-persistence';
 import { listAttachableHosts } from './session-lock.js';
 /** Last path segment for the footer chip (`\root\genshin\srv` → `srv`). */
 export declare function sessionCwdLabel(cwd: string): string;
@@ -38,6 +37,13 @@ export interface ResumableSession {
 }
 /** `MM-DD HH:mm` local-time label for session lists. */
 export declare function formatSessionTime(timestamp: number): string;
+/** Incremental listing so the picker can paint before older logs are parsed. */
+export interface ResumableSessionListing {
+    /** Sessions already inspected (or restored from the disk cache). */
+    sessions: ResumableSession[];
+    /** Whether older logs are still being inspected. */
+    pending: boolean;
+}
 /**
  * List resumable top-level sessions, newest first.
  *
@@ -51,4 +57,18 @@ export declare function formatSessionTime(timestamp: number): string;
  * @returns every resumable candidate in display order (attachable live
  *   hosts first, then readable logs, then unreadable).
  */
-export declare function listResumableSessions(persistence: SessionPersistence, currentId: string, listHosts?: typeof listAttachableHosts): Promise<ResumableSession[]>;
+export declare function listResumableSessions(persistence: object, currentId: string, listHosts?: typeof listAttachableHosts): Promise<ResumableSession[]>;
+/**
+ * List resumable sessions, painting the recent page first.
+ *
+ * `onUpdate` fires after the priority page (cached + newest logs) and again
+ * after each later inspect batch. Unchanged logs reuse `$DSH_HOME/tui-session-index.json`.
+ */
+export declare function listResumableSessionsProgressive(persistence: object, currentId: string, options?: {
+    listHosts?: typeof listAttachableHosts;
+    onUpdate?: (listing: ResumableSessionListing) => void;
+    indexPath?: string;
+    priorityCount?: number;
+}): Promise<ResumableSessionListing & {
+    complete: ResumableSession[];
+}>;

package/lib/types/term-text.d.ts

@@ -84,12 +84,31 @@ export declare function paintSegmentedLine(line: string, start: number, end: num
 /** Wrap `text` and color each output line by overlapping `segments`. */
 export declare function wrapSegmented(text: string, width: number, segments: readonly TextSegment[]): string[];
 export declare function truncate(text: string, maxLines: number): string;
+/** One OSC-8 hyperlink span in a painted row, in display columns. */
+export interface PaintedLinkHit {
+    href: string;
+    startCol: number;
+    endCol: number;
+}
+export declare function osc8Open(href: string): string;
+export declare function osc8Close(): string;
+/** True when OSC 8 hyperlinks should be painted. Off when DSH_TUI_OSC8=0/false. */
+export declare function osc8Enabled(env?: NodeJS.ProcessEnv): boolean;
+/** OSC 52 clipboard write. Empty payload clears. ST is ESC \\ so a following CSI cannot be eaten as OSC payload. */
+export declare function osc52Clipboard(text: string): string;
+export declare function stripAnsi(text: string): string;
+/**
+ * Locate OSC 8 hyperlinks in a painted ANSI line. Columns are 0-based
+ * display cells of the visible glyphs (not counting the sequences).
+ */
+export declare function paintedLinkHits(line: string): PaintedLinkHit[];
+export declare function hrefAtColumn(hits: readonly PaintedLinkHit[], col: number): string | undefined;
 /**
  * Render workspace markdown into width-bounded terminal rows. Assistant
- * replies get a bold-white base; code blocks, headings, quotes, lists, rules,
- * links and inline spans keep their own ANSI treatment.
+ * replies use a normal-white base so inline bold can contrast; code blocks,
+ * headings, quotes, lists, rules, links and inline spans keep their own ANSI.
  */
-export declare function renderMarkdownLines(text: string, width: number, color: boolean): string[];
+export declare function renderMarkdownLines(text: string, width: number, color: boolean, hyperlinks?: boolean): string[];
 /** Cut one line to fit a width, appending an ellipsis when truncated. */
 export declare function truncateToWidth(text: string, width: number): string;
 /**

package/lib/types/tui.d.ts

@@ -24,11 +24,13 @@ import { type SubagentSelectionRef } from './subagent-model.js';
 import { type AskUserQuestionAnswer, type AskUserQuestionRequest } from '@deepseek-ai/dsh-user-questions';
 import type { ApprovalOutcome, ApprovalRequest } from '@deepseek-ai/dsh-user-approval';
 import type { CollapsibleBlock, DisconnectPolicyName } from './transcript-types.js';
+import { paintedLinkHits } from './term-text.js';
 export type { CollapsibleBlock, DisplayKind, DisconnectPolicyName, PlanTodoItem, Row, SubagentLogEntry, ToolDiffHunk, } from './transcript-types.js';
-export { clipAnsiToWidth, displayWidth, foldInputView, fmtElapsedCompact, padAnsiToWidth, padToWidth, renderMarkdownLines, repeatToWidth, shimmerText, truncateToWidth, visibleWidth, waitCardCopy, waitSummaryFromReasoning, wrapWaitDetails, } from './term-text.js';
-export { captureHangupSignals, composePaintOutput, detectSshSession, formatLinkQualityChip, ignoreFurtherHangupSignals, isEscapePrefix, isHangupErrno, linkQualityOf, linkSignalPips, paintIntervalForRtt, paintLinkLabel, parseCursorPositionReply, pickerWindowStart, probeTerminalRttMs, releaseHangupSignals, resolvePaintIntervalMs, waitUntilIdleOrTimeout, type LinkQuality, type PaintLinkKind, } from './paint.js';
+export { clipAnsiToWidth, cursorVisualPosition, displayWidth, foldInputView, hrefAtColumn, osc52Clipboard, osc8Enabled, paintedLinkHits, fmtElapsedCompact, padAnsiToWidth, padToWidth, renderMarkdownLines, repeatToWidth, shimmerText, truncateToWidth, visibleWidth, waitCardCopy, waitSummaryFromReasoning, wrapWaitDetails, } from './term-text.js';
+export { captureHangupSignals, composePaintOutput, detectSshSession, formatLinkQualityChip, ignoreFurtherHangupSignals, isEscapePrefix, isHangupErrno, linkQualityOf, linkSignalPips, paintIntervalForRtt, paintLinkLabel, parseCursorPositionReply, pickerWindowStart, probeTerminalRttMs, releaseHangupSignals, resolvePaintIntervalMs, waitUntilIdleOrTimeout, writeBootSplash, type LinkQuality, type PaintLinkKind, } from './paint.js';
 export { CONTEXT_IDLE_COMPACT_RATIO, CONTEXT_PRESSURE_DANGER_RATIO, CONTEXT_PRESSURE_WARN_RATIO, CONTEXT_RING_EMPTY, CONTEXT_RING_SEGMENTS, contextPressureAlertText, contextPressureRingColor, contextPressureUsedTokens, contextPressureView, describeProviderRoute, dropFooterQuotaPlanName, fitFooterStatsLine, fitFooterStatusLine, footerActivity, footerIdentityParts, footerStatsGroups, formatContextPressureChip, formatContextPressureRing, formatContextPressureStatusLine, formatDuration, formatFooterQuota, formatQuotaBar, formatStatusReport, formatTokens, formatTokensPerSecond, parseContextPressure, promptPressureTokens, providerShortCode, providerUsesLocalOAuth, shouldIdleAutoCompact, type ContextPressureSample, type ContextPressureView, type FooterActivityKind, type FooterStatsInput, type FooterStatusInput, type StatusReportInput, } from './footer.js';
 export { crossedQuotaThresholds, formatAccountBalance, formatFooterBalance, formatOpenCodeGoUsage, formatQuotaSnapshot, formatQuotaStatusLine, joinUrl, openCodeSourceFor, parseDeepSeekBalance, parseOpenAiCompatibleBalance, parseOpenCodeGoQuota, parseSuperGrokBilling, quotaAlertText, quotaRefreshEverySteps, quotaRefreshEveryTurns, remainingPercentFromUsed, tightestQuotaWindow, type AccountBalanceLine, type AccountBalanceSnapshot, type OpenCodeFlavor, type OpenCodeSource, type QuotaPeriod, type QuotaSnapshot, type QuotaWindow, } from './quota.js';
+export { commandAcceptsAttachments, forEachSessionEvent, isAssistantStreamEvent, listPersistenceHeaders, inspectPersistenceSession, sessionEventType, sessionEvents, settingsNamespace, streamChunkOf, } from './dsh-compat.js';
 export { applyTurnEndToPlan, askSummary, cardCategoryOf, compactionHeaderText, formatCompactCommandError, isPromptInjectionMessage, matchTranscriptRows, parseFindQuery, parsePlanTodos, planCloseNudgeText, planDockNote, planIsLive, planTitleFromMarkdown, planTurnLeftOpen, promptInjectionSources, promptInjectionTitle, subagentHeaderText, todoProgressLabel, todoSummary, type CardCategory, } from './plan.js';
 export { buildToolHeader, canMergeToolCall, compactEditPath, compactToolBursts, compactToolGroups, countDiffAddDel, countDiffLines, countOutputLines, diffMetaDiffs, diffStatToken, friendlyJsonLines, parseExitStatus, presentToolCall, READ_TOOL_NAMES, renderToolDiff, toolBodyFitsWorkspace, toolBodyLines, toolStateColor, toolStateLabel, wrappedToolBodyLineCount, } from './tool-present.js';
 /** Presentation configuration for the terminal channel. */
@@ -184,6 +186,12 @@ export declare class SshTui {
     private lastStatsTurn;
     private scrollOffset;
     private readonly clickableRows;
+    private readonly paintedLinkHitsByRow;
+    private copyYank;
+    /** Last OSC-52 payload (tests; empty when nothing has been copied). */
+    get lastCopiedText(): string;
+    /** Screen-row → OSC 8 hits from the last paint (tests). */
+    get linkHitsByRow(): Map<number, ReturnType<typeof paintedLinkHits>>;
     private streamingReasoning;
     private escapeBuffer;
     private escapeTimer;
@@ -191,9 +199,13 @@ export declare class SshTui {
     private waitStartedAt;
     private completionSignaled;
     private replaying;
+    /** Display-line budget for the first paint after resume; 0 = full transcript. */
+    private paintTailBudget;
     private completedAt;
     private lastTitleUpdateAt;
     private lastPaintRows;
+    private lastPaintCursorColumn;
+    private lastPaintCursorRow;
     private lastChromeKey;
     private lastPaintWidth;
     private lastPaintHeight;
@@ -284,6 +296,10 @@ export declare class SshTui {
     private exitProcess;
     /** Capture one painted frame. Used by README screenshot fixtures. */
     captureFrame(columns?: number, rows?: number): string[];
+    /** Last CSI cursor column written by {@link paint} (1-based). Tests only. */
+    lastPaintedCursorColumn(): number;
+    /** Last CSI cursor row written by {@link paint} (1-based). Tests only. */
+    lastPaintedCursorRow(): number;
     private screenColumns;
     private screenRows;
     private write;
@@ -362,6 +378,18 @@ export declare class SshTui {
     private playCompletionSignal;
     private render;
     private styleLine;
+    /**
+     * Fold one live or durable stream chunk into the in-progress assistant
+     * row. 0.1.2 hosts append `assistant/chunk`; 0.1.5 emits the same chunk
+     * on `agent/assistant-stream` and never writes it to the log.
+     */
+    private applyStreamChunk;
+    /**
+     * 0.1.5 live tokens arrive as process-local `agent/assistant-stream`
+     * frames (start / chunk / end). Chunk frames carry the same
+     * `StreamChunk` the 0.1.2 log used to store as `assistant/chunk`.
+     */
+    readonly handleAssistantStream: (...args: unknown[]) => void;
     /**
      * Apply the TUI's subagent model selection to every child-agent request.
      * The parent request is left untouched (its own `/model` waterfall already
@@ -550,8 +578,10 @@ export declare class SshTui {
     /** Idempotently source $DSH_HOME/env.sh from the user's POSIX shell rc files. */
     private ensurePosixEnvHook;
     private handleEscape;
-    /** Toggle the collapsible row under a click on the transcript area. */
-    handleMouseClick(y: number): void;
+    /** Toggle the collapsible row under a click, or copy an OSC-8 link. */
+    handleMouseClick(y: number, x?: number): void;
+    private copyPlainText;
+    copyFocusedCard(): boolean;
     private scrollInspectOrTranscript;
     private handleCtrlC;
     private submit;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ssh-tui",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "SSH-friendly interactive terminal TUI plugin for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",
@@ -56,12 +56,14 @@
       "patch": "./cordis.patch.yml"
     },
     "compatibility": {
-      "dsh": ">=0.1.1-rc.2 <0.1.3",
+      "dsh": ">=0.1.2-rc.1 <0.1.6",
       "dshReleases": {
         "0.1.2-rc.1": "compatible",
         "0.1.3-alpha.1": "unknown",
-        "0.1.3-alpha.2": "incompatible",
-        "0.1.5-alpha.1": "incompatible"
+        "0.1.3-alpha.2": "compatible",
+        "0.1.5-alpha.1": "compatible",
+        "0.1.5-alpha.2": "compatible",
+        "0.1.5-rc.1": "compatible"
       },
       "profiles": ["tui"]
     }
@@ -90,20 +92,20 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": ">=0.1.1-rc.2 || >=0.1.2-a",
-    "@deepseek-ai/dsh-agent-default-model": ">=0.1.1-rc.2 || >=0.1.2-a",
-    "@deepseek-ai/dsh-agent-loop": ">=0.1.1-rc.2 || >=0.1.2-a",
-    "@deepseek-ai/dsh-agent-presets": ">=0.1.1-rc.2 || >=0.1.2-a",
-    "@deepseek-ai/dsh-cmdline": ">=0.1.1-rc.2 || >=0.1.2-a",
-    "@deepseek-ai/dsh-commands": ">=0.1.1-rc.2 || >=0.1.2-a",
-    "@deepseek-ai/dsh-credentials": ">=0.1.1-rc.2 || >=0.1.2-a",
-    "@deepseek-ai/dsh-llm": ">=0.1.1-rc.2 || >=0.1.2-a",
-    "@deepseek-ai/dsh-session": ">=0.1.1-rc.2 || >=0.1.2-a",
-    "@deepseek-ai/dsh-settings": ">=0.1.1-rc.2 || >=0.1.2-a",
-    "@deepseek-ai/dsh-subagent": ">=0.1.1-rc.2 || >=0.1.2-a",
-    "@deepseek-ai/dsh-user-approval": ">=0.1.1-rc.2 || >=0.1.2-a",
-    "@deepseek-ai/dsh-user-questions": ">=0.1.1-rc.2 || >=0.1.2-a",
-    "@deepseek-ai/dsh-session-persistence": ">=0.1.1-rc.2 || >=0.1.2-a"
+    "@deepseek-ai/dsh-agent": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-agent-default-model": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-agent-loop": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-agent-presets": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-cmdline": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-commands": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-credentials": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-subagent": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-user-approval": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-user-questions": ">=0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-persistence": ">=0.1.2-rc.1"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-user-approval": {