dsh-ssh-tui 0.3.2 → 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 160).
+ * 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';
@@ -160,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;
@@ -254,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;
@@ -423,7 +445,9 @@ 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;
@@ -432,6 +456,8 @@ export declare class SshTui {
     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. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ssh-tui",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "SSH-friendly interactive terminal TUI plugin for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",
@@ -45,6 +45,7 @@
     "docs/screenshots/compare.png",
     "docs/screenshots/headless.png",
     "docs/screenshots/workspace.png",
+    "docs/screenshots/slow-link.gif",
     "LICENSE"
   ],
   "license": "MIT",
@@ -65,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"