dsh-ssh-tui 0.3.1 → 0.3.3

package/lib/types/tui.d.ts

@@ -7,7 +7,8 @@
  *
  * The renderer uses plain ANSI and coalesces each frame into one stdout
  * write of dirty rows only — jump-host / proxied SSH should see one packet
- * per paint, not one per line. Cadence is DSH_TUI_PAINT_MS (default 120).
+ * per paint, not one per line. Cadence is DSH_TUI_PAINT_MS, else local 80 ms
+ * or an SSH tier from a CSI 6n round-trip (default 160 ms).
  */
 import type { Agent, ModelSelection, ModelSelectionRef } from '@deepseek-ai/dsh-agent';
 import type { Context } from '@deepseek-ai/cordis';
@@ -53,7 +54,7 @@ export interface TuiConfig {
     /**
      * Minimum milliseconds between paints while a turn is streaming.
      * Jump-host / proxied SSH can raise this so token ticks do not flood the
-     * link. Defaults from `DSH_TUI_PAINT_MS` (120).
+     * link. Defaults from `DSH_TUI_PAINT_MS` (160).
      */
     paintIntervalMs?: number;
 }
@@ -121,6 +122,11 @@ type Row = {
     expanded: boolean;
     /** When true the plan stays in the scrolling transcript, not the dock. */
     archived?: boolean;
+    /**
+     * Display-only: the last turn ended while todos were still open.
+     * Does not rewrite the session log.
+     */
+    turnLeftOpen?: boolean;
 } | {
     kind: 'question';
     questionId: string;
@@ -155,11 +161,21 @@ interface ToolDiffHunk {
 export interface TuiController {
     dispose(): Promise<void>;
 }
+export type PaintLinkKind = 'local' | 'ssh';
 /**
- * Paint cadence for jump-host / proxied SSH. Token ticks coalesce into one
- * frame; the default stays snappy, slower links raise `DSH_TUI_PAINT_MS`.
+ * Explicit env/config always wins. Otherwise local TTYs stay snappy and SSH
+ * sessions pick a tier from a measured round-trip (CSI 6n), falling back to
+ * 160 ms when the probe is missing.
  */
-export declare function resolvePaintIntervalMs(configured?: number, env?: NodeJS.ProcessEnv): number;
+export declare function resolvePaintIntervalMs(configured?: number, env?: NodeJS.ProcessEnv, options?: {
+    ssh?: boolean;
+    rttMs?: number;
+}): number;
+/** True when this process is attached to an SSH session (jump host / proxy). */
+export declare function detectSshSession(env?: NodeJS.ProcessEnv): boolean;
+/** Map a CSI-6n round-trip to a paint cadence. Unknown RTT uses the SSH default. */
+export declare function paintIntervalForRtt(rttMs: number | undefined): number;
+export declare function paintLinkLabel(kind: PaintLinkKind, intervalMs: number, probed: boolean): string;
 /** One incremental paint as a single stdout write (one SSH packet when corked). */
 export declare function composePaintOutput(options: {
     width: number;
@@ -249,6 +265,17 @@ export declare function openCodeSourceFor(provider: string, llmPiAiSection: unkn
 export declare function formatOpenCodeGoUsage(payload: unknown, source: OpenCodeSource): string;
 /** Whether `text` could still grow into a recognized escape sequence. */
 export declare function isEscapePrefix(text: string): boolean;
+/** Parse a Device Status Report cursor reply (`CSI row;col R`). */
+export declare function parseCursorPositionReply(text: string): {
+    row: number;
+    column: number;
+} | undefined;
+/**
+ * Round-trip to the attached terminal via CSI 6n. Returns undefined when the
+ * reply never arrives (dumb pipe, blocked DSR). Does not interpret the
+ * coordinates — only the elapsed milliseconds matter.
+ */
+export declare function probeTerminalRttMs(stdin?: NodeJS.ReadStream, stdout?: NodeJS.WriteStream, timeoutMs?: number): Promise<number | undefined>;
 /** True while a plan still belongs in the dock (latest incomplete work). */
 export declare function planIsLive(plan: {
     active: boolean;
@@ -257,6 +284,19 @@ export declare function planIsLive(plan: {
     planMarkdown?: string;
     archived?: boolean;
 }): boolean;
+/** Open todos left behind when a turn ends without a completing todo_write. */
+export declare function planTurnLeftOpen(plan: {
+    todos: readonly PlanTodoItem[];
+}): boolean;
+/** Mark leftover in-progress/pending todos as display-stale after turn/end. */
+export declare function applyTurnEndToPlan<T extends {
+    todos: PlanTodoItem[];
+    turnLeftOpen?: boolean;
+}>(plan: T): T;
+/** Follow-up that asks the model to close leftover todos. One per open list. */
+export declare function planCloseNudgeText(plan: {
+    todos: readonly PlanTodoItem[];
+}): string;
 export type CardCategory = 'thinking' | 'plan' | 'subagent' | 'reply' | 'tool' | 'question' | 'goal';
 /** Category for jump / search. Assistant replies are not collapsible cards. */
 export declare function cardCategoryOf(row: {
@@ -275,6 +315,7 @@ export declare function planDockNote(plan: {
     pending: boolean;
     todos: readonly PlanTodoItem[];
     planMarkdown?: string;
+    turnLeftOpen?: boolean;
 }): string;
 /** Compact per-status counts matching the web plan strip. */
 export declare function todoProgressLabel(todos: readonly PlanTodoItem[]): string;
@@ -404,13 +445,19 @@ export declare class SshTui {
     private lastChromeKey;
     private lastPaintWidth;
     private lastPaintHeight;
-    private readonly paintIntervalMs;
+    private paintIntervalMs;
+    private paintLink;
+    private paintProbed;
     private searchHits;
     private searchIndex;
     private searchQuery;
+    private planNudgePending;
+    private pendingReveal;
     constructor(ctx: Context, agent: Agent, config: TuiConfig);
     /** Enter raw mode, switch to the alternate screen, and start listening. */
     start(): void;
+    private startRenderTimer;
+    private calibratePaintInterval;
     /** Replay the durable session log so a resumed session renders its history. */
     replayHistory(): void;
     /** Show the first-launch provider/API-key onboarding when nothing is configured. */
@@ -438,6 +485,8 @@ export declare class SshTui {
     private upsertPlanRow;
     /** Whether the live plan strip should occupy the workspace footer. */
     private shouldDockPlan;
+    /** One follow-up per leftover list; replay and cancelled turns stay quiet. */
+    private queuePlanCloseNudge;
     /** Compact web-style plan strip pinned above the input, not in the transcript. */
     private paintPlanDock;
     private paintCollapsibleHeader;
@@ -447,6 +496,8 @@ export declare class SshTui {
     private toggleCollapsible;
     /** Expand all collapsible blocks, or collapse them again when all are open. */
     private toggleAllCollapsible;
+    private highlightSearchLine;
+    private revealRow;
     private focusCard;
     /** Jump to the newest card in a category (thinking / plan / subagent / reply). */
     private jumpToCategory;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ssh-tui",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "SSH-friendly interactive terminal TUI plugin for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",
@@ -42,7 +42,10 @@
     "cordis.patch.yml",
     "README.md",
     "README.en.md",
-    "docs/screenshots",
+    "docs/screenshots/compare.png",
+    "docs/screenshots/headless.png",
+    "docs/screenshots/workspace.png",
+    "docs/screenshots/slow-link.gif",
     "LICENSE"
   ],
   "license": "MIT",
@@ -63,7 +66,8 @@
     "install:npm": "bash scripts/install-npm.sh",
     "uninstall:dsh": "bash scripts/uninstall.sh",
     "verify:dsh": "bash scripts/verify.sh",
-    "screenshots": "npm run build && node scripts/capture-readme-frames.mjs"
+    "screenshots": "npm run build && node scripts/capture-readme-frames.mjs",
+    "screenshots:slow": "npm run build && node scripts/capture-slow-link.mjs"
   },
   "engines": {
     "node": ">=22.19"