dsh-ssh-tui 0.3.2 → 0.3.4

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';
@@ -142,6 +143,17 @@ type Row = {
     phase: 'active' | 'paused' | 'blocked' | 'complete' | 'cleared';
     blockedReason?: string;
     expanded: boolean;
+} | {
+    kind: 'compaction';
+    compactionId: string;
+    status: 'running' | 'ok' | 'error';
+    startedAt: number;
+    endedAt?: number;
+    pruneCount: number;
+    prunedTokens: number;
+    summary?: string;
+    error?: string;
+    expanded: boolean;
 } | {
     kind: 'system';
     text: string;
@@ -160,11 +172,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;
@@ -250,10 +272,50 @@ export interface OpenCodeSource {
  * routes are recognized by their `opencode.ai` base URL.
  */
 export declare function openCodeSourceFor(provider: string, llmPiAiSection: unknown): OpenCodeSource | null;
+export type QuotaPeriod = 'hourly' | 'weekly' | 'monthly' | 'unknown';
+export interface QuotaWindow {
+    label: string;
+    period: QuotaPeriod;
+    /** Remaining percent of the window (100 = unused). */
+    remainingPercent: number;
+    resetsAt?: string;
+}
+export interface QuotaSnapshot {
+    provider: string;
+    plan: string;
+    windows: QuotaWindow[];
+}
+export declare function remainingPercentFromUsed(usedPercent: number): number;
+/** Cross a remaining-percent threshold from above (50 / 25 / 10 / 5). */
+export declare function crossedQuotaThresholds(previousRemaining: number | undefined, remaining: number): number[];
+export declare function quotaAlertText(snapshot: QuotaSnapshot, window: QuotaWindow): string;
+/**
+ * How often to re-fetch quota, based on the tightest window.
+ * Hourly/5h: every 10 turns, every 4 when near a threshold.
+ * Weekly: every 50 turns, every 10 when near.
+ * Monthly: every 80 turns, every 20 when near.
+ */
+export declare function quotaRefreshEveryTurns(window: QuotaWindow | undefined): number;
+export declare function parseSuperGrokBilling(payload: unknown): QuotaSnapshot;
+export declare function parseOpenCodeGoQuota(payload: unknown, provider: string): QuotaSnapshot;
+export declare function formatQuotaSnapshot(snapshot: QuotaSnapshot): string;
+/** Tightest remaining window — used for threshold alerts. */
+export declare function tightestQuotaWindow(snapshot: QuotaSnapshot): QuotaWindow | undefined;
 /** Render the OpenCode Go quota payload as a transcript block. */
 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;
@@ -285,6 +347,12 @@ export declare function parseFindQuery(raw: string): {
     category?: CardCategory;
     query: string;
 };
+export declare function compactionHeaderText(row: {
+    status: 'running' | 'ok' | 'error';
+    pruneCount: number;
+    prunedTokens: number;
+    error?: string;
+}): string;
 /** Transcript rows matching a `/find` query, newest last. */
 export declare function matchTranscriptRows(rows: readonly Row[], raw: string): Row[];
 /** One-line note under an expanded plan strip. */
@@ -423,7 +491,15 @@ export declare class SshTui {
     private lastChromeKey;
     private lastPaintWidth;
     private lastPaintHeight;
-    private readonly paintIntervalMs;
+    private paintIntervalMs;
+    private paintLink;
+    private paintProbed;
+    private sessionTitle;
+    private llmRetry;
+    private quotaSnapshot;
+    private quotaAlerted;
+    private quotaTurnsSinceRefresh;
+    private quotaRefreshInFlight;
     private searchHits;
     private searchIndex;
     private searchQuery;
@@ -432,6 +508,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. */
@@ -512,6 +590,10 @@ export declare class SshTui {
     private readonly handleDisposed;
     /** Plan-mode / command / team events that plugins merge into SessionEventMap. */
     private handleExtensionEvent;
+    private findCompactionRow;
+    private handleCompactionEvent;
+    private handleCommandRun;
+    private handleCommandDone;
     private handleGoalChange;
     private handleSubagentExtensionEvent;
     /** Fold a live subagent's own session events into that child's card. */
@@ -590,8 +672,13 @@ export declare class SshTui {
     private fetchOpenCodeGoUsage;
     /** Explain Zen metered billing instead of pretending it has a quota. */
     private zenUsageText;
-    /** /usage and /quota: show Zen billing info or live Go quota usage. */
+    /** /usage and /quota: remaining quota for the current subscription provider. */
     private runUsageCommand;
+    private applyQuotaSnapshot;
+    private refreshQuota;
+    private fetchQuotaSnapshot;
+    private resolveSuperGrokToken;
+    private fetchJson;
     private readonly handleData;
     /** Handle one data chunk that may contain bracketed-paste markers. */
     private processPasteChunk;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ssh-tui",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "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"