dsh-ssh-tui 0.3.5 → 0.3.6

package/lib/types/route-memory.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Remember the last model/effort per provider so /model and /setup can switch
+ * routes without wiping the previous provider's choice.
+ */
+import z from '@deepseek-ai/schemastery';
+import type { Context } from '@deepseek-ai/cordis';
+export declare const ROUTE_MEMORY_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+/** Settings schema for `$DSH_HOME/settings.yaml` under ssh-tui-routes. */
+export declare const ROUTE_MEMORY_SCHEMA: z<Schemastery.ObjectS<{
+    providers: z<import("@deepseek-ai/cosmokit").Dict<{
+        model?: string | null | undefined;
+        reasoningEffort?: string | null | undefined;
+    } & import("@deepseek-ai/cosmokit").Dict, string>, import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<{
+        model: z<string, string>;
+        reasoningEffort: z<string, string>;
+    }>, string>>;
+}>, Schemastery.ObjectT<{
+    providers: z<import("@deepseek-ai/cosmokit").Dict<{
+        model?: string | null | undefined;
+        reasoningEffort?: string | null | undefined;
+    } & import("@deepseek-ai/cosmokit").Dict, string>, import("@deepseek-ai/cosmokit").Dict<Schemastery.ObjectT<{
+        model: z<string, string>;
+        reasoningEffort: z<string, string>;
+    }>, string>>;
+}>>;
+export interface RememberedRoute {
+    model: string;
+    reasoningEffort?: string;
+}
+export type RouteMemoryMap = Record<string, RememberedRoute>;
+export declare function parseRouteMemory(raw: unknown): RouteMemoryMap;
+export declare function rememberedRouteFor(memory: RouteMemoryMap, provider: string): RememberedRoute | undefined;
+/** Register the route-memory settings section so /model and /provider can persist. */
+export declare function installRouteMemory(ctx: Context): void;
+export declare function upsertRememberedRoute(memory: RouteMemoryMap, provider: string, route: RememberedRoute): RouteMemoryMap;

package/lib/types/tui.d.ts

@@ -173,6 +173,11 @@ export interface TuiController {
     dispose(): Promise<void>;
 }
 export type PaintLinkKind = 'local' | 'ssh';
+/** Compact token count, matching the web stats line (517 / 12.2K / 1.2M). */
+export declare function formatTokens(n: number): string;
+/** Compact duration, matching the web stats line (45.2s / 2m42s). */
+export declare function formatDuration(ms: number): string;
+export declare function formatTokensPerSecond(tokensPerSecond: number): string;
 /**
  * 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
@@ -187,6 +192,73 @@ 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;
+export type LinkQuality = 'local' | 'good' | 'ok' | 'slow' | 'poor' | 'unknown';
+/** Signal-bar quality from a measured SSH round-trip, or local TTY. */
+export declare function linkQualityOf(kind: PaintLinkKind, rttMs: number | undefined): LinkQuality;
+/** How many filled signal pips: 4 local/fast, 3 ok, 2 slow, 1 poor, 0 unknown. */
+export declare function linkSignalPips(quality: LinkQuality): number;
+/** Compact footer chip: `SSH ●●●○ 90ms` — 1 pip red, 2 yellow, 3+ green. */
+export declare function formatLinkQualityChip(kind: PaintLinkKind, intervalMs: number, rttMs: number | undefined, probed: boolean, color?: boolean): string;
+export declare function providerShortCode(provider: string): string;
+export interface FooterStatsInput {
+    turns: number;
+    steps: number;
+    llmMs: number;
+    toolMs: number;
+    ttftMs: number;
+    ttftSteps: number;
+    decodeMs: number;
+    decodeTokens: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+}
+/** Stats groups in drop order (last is dropped first when the row is too wide). */
+export declare function footerStatsGroups(stats: FooterStatsInput): string[];
+export declare function fitFooterStatsLine(chip: string, groups: readonly string[], width: number): string;
+export type FooterActivityKind = 'plan-review' | 'waiting' | 'compacting' | 'retry' | 'subagents' | 'tools' | 'plan-open' | 'plan-pending' | 'goal' | 'waiting-llm' | 'idle';
+export interface FooterStatusInput {
+    running: boolean;
+    planReview: boolean;
+    waitingQuestion: boolean;
+    compacting: boolean;
+    retry?: {
+        retry: number;
+        maxRetries: number;
+    };
+    subagents: number;
+    tools: number;
+    planLeftOpen: boolean;
+    planPending: boolean;
+    planActive: boolean;
+    goalPhase?: 'active' | 'paused' | 'blocked';
+    idleMs: number;
+    model: string;
+    effort?: string;
+    preset?: string;
+    provider: string;
+    parentModel: string;
+    subModel: string;
+    subDiffers: boolean;
+    quotaCode?: string;
+    quotaPercent?: number;
+    search?: {
+        index: number;
+        total: number;
+    };
+    foldedInput: boolean;
+    multiLineInput: boolean;
+    queued: number;
+}
+export declare function footerActivity(input: FooterStatusInput): {
+    kind: FooterActivityKind;
+    text: string;
+};
+/** Short remaining-quota bar: 8 pips, filled from the left. */
+export declare function formatQuotaBar(remainingPercent: number, width?: number): string;
+export declare function footerIdentityParts(input: FooterStatusInput): string[];
+export declare function fitFooterStatusLine(activity: string, identity: readonly string[], width: number): string;
 /** One incremental paint as a single stdout write (one SSH packet when corked). */
 export declare function composePaintOutput(options: {
     width: number;
@@ -196,6 +268,7 @@ export declare function composePaintOutput(options: {
     sizeChanged: boolean;
     chromeChanged: boolean;
     chromeStart: number;
+    previousChromeStart?: number;
     cursorRow: number;
     cursorColumn: number;
 }): string;
@@ -303,6 +376,23 @@ export declare function formatQuotaSnapshot(snapshot: QuotaSnapshot): string;
 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;
+export interface AccountBalanceLine {
+    label: string;
+    amount: string;
+    currency?: string;
+}
+export interface AccountBalanceSnapshot {
+    provider: string;
+    plan: string;
+    available?: boolean;
+    lines: AccountBalanceLine[];
+    sourcePath?: string;
+}
+export declare function joinUrl(base: string, path: string): string;
+export declare function parseDeepSeekBalance(payload: unknown, provider?: string): AccountBalanceSnapshot;
+/** Best-effort parse of OpenAI-compatible credit/balance JSON. */
+export declare function parseOpenAiCompatibleBalance(payload: unknown, provider: string, path: string): AccountBalanceSnapshot | undefined;
+export declare function formatAccountBalance(snapshot: AccountBalanceSnapshot): 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`). */
@@ -417,11 +507,6 @@ export declare function parseExitStatus(text: string): {
     exitCode?: number;
     signal?: string;
 };
-/** Compact token count, matching the web stats line (517 / 12.2K / 1.2M). */
-export declare function formatTokens(n: number): string;
-/** Compact duration, matching the web stats line (45.2s / 2m42s). */
-export declare function formatDuration(ms: number): string;
-export declare function formatTokensPerSecond(tokensPerSecond: number): string;
 /** Owns one interactive terminal channel and its agent event wiring. */
 export declare class SshTui {
     private readonly ctx;
@@ -491,9 +576,11 @@ export declare class SshTui {
     private lastChromeKey;
     private lastPaintWidth;
     private lastPaintHeight;
+    private lastChromeStart;
     private paintIntervalMs;
     private paintLink;
     private paintProbed;
+    private paintRttMs;
     private sessionTitle;
     private llmRetry;
     private quotaSnapshot;
@@ -564,7 +651,7 @@ export declare class SshTui {
     private currentSelectionLabel;
     /** Replace one step's usage sample so a repeated report never double counts. */
     private recordUsage;
-    /** The web-aligned session stats strip: counts, timings, cache, tokens. */
+    /** Compact session stats groups for the first footer row. */
     private statsText;
     /** Refresh the terminal window title (throttled while running). */
     private updateTerminalTitle;
@@ -641,9 +728,14 @@ export declare class SshTui {
     private listSelectableProviders;
     /** Built-in SuperGrok catalog used when the live adapter list is still warming up. */
     private static readonly XAI_FALLBACK_MODELS;
-    /** /model: stay on the current provider by default; switching providers is opt-in. */
+    private loadModelOptions;
+    /** /model: models and effort for the current provider only. */
     private runModelCommand;
+    /** /provider: pick a provider, then its model (remembered route pre-filled). */
+    private runProviderCommand;
     /** Persist a provider/model/effort choice and keep the subagent on the same family. */
+    private rememberedRoute;
+    private rememberRoute;
     private applyModelSelection;
     /** Provider route the next subagent request should use. */
     private effectiveSubagentProvider;
@@ -653,6 +745,8 @@ export declare class SshTui {
      * switching to xAI is treated as stale.
      */
     private syncSubagentToProvider;
+    private promptSubagentAfterProviderSwitch;
+    private clearQuotaForProvider;
     /** Persist one subagent selection and publish it to the live request waterfall. */
     private saveSubagentSelection;
     /** Resolve the picker model list for one provider (endpoint first, then catalog). */
@@ -673,10 +767,11 @@ export declare class SshTui {
     private fetchOpenCodeGoUsage;
     /** Explain Zen metered billing instead of pretending it has a quota. */
     private zenUsageText;
-    /** /usage and /quota: remaining quota for the current subscription provider. */
+    /** /usage and /balance: remaining quota or prepaid balance for the current provider. */
     private runUsageCommand;
     private applyQuotaSnapshot;
     private refreshQuota;
+    private fetchAccountBalance;
     private fetchQuotaSnapshot;
     private resolveSuperGrokToken;
     private fetchJson;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ssh-tui",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "SSH-friendly interactive terminal TUI plugin for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",