dsh-ssh-tui 0.3.5 → 0.3.7

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;
@@ -286,16 +359,22 @@ export interface QuotaSnapshot {
     windows: QuotaWindow[];
 }
 export declare function remainingPercentFromUsed(usedPercent: number): number;
-/** Cross a remaining-percent threshold from above (50 / 25 / 10 / 5). */
+/** Cross a remaining-percent threshold from above (50 / 25 / 10 / 5).
+ *  Only the tightest (lowest) crossed threshold is returned, so one drop
+ *  never paints 50/25/10 as three identical warnings. */
 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.
+ * Counted in model steps (not conversation turns): a turn with several
+ * tool/LLM steps should refresh more often because it spends more quota.
+ * Hourly/5h: every 10 steps, every 4 when near a threshold.
+ * Weekly: every 50 steps, every 10 when near.
+ * Monthly: every 80 steps, every 20 when near.
  */
-export declare function quotaRefreshEveryTurns(window: QuotaWindow | undefined): number;
+export declare function quotaRefreshEverySteps(window: QuotaWindow | undefined): number;
+/** @deprecated Same cadence as {@link quotaRefreshEverySteps}; the name predates step accounting. */
+export declare const quotaRefreshEveryTurns: typeof quotaRefreshEverySteps;
 export declare function parseSuperGrokBilling(payload: unknown): QuotaSnapshot;
 export declare function parseOpenCodeGoQuota(payload: unknown, provider: string): QuotaSnapshot;
 export declare function formatQuotaSnapshot(snapshot: QuotaSnapshot): string;
@@ -303,6 +382,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 +513,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,14 +582,17 @@ export declare class SshTui {
     private lastChromeKey;
     private lastPaintWidth;
     private lastPaintHeight;
+    private lastChromeStart;
+    private lastTranscriptStart;
     private paintIntervalMs;
     private paintLink;
     private paintProbed;
+    private paintRttMs;
     private sessionTitle;
     private llmRetry;
     private quotaSnapshot;
     private quotaAlerted;
-    private quotaTurnsSinceRefresh;
+    private quotaStepsSinceRefresh;
     private quotaRefreshInFlight;
     private searchHits;
     private searchIndex;
@@ -564,7 +658,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 +735,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 +752,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). */
@@ -661,7 +762,7 @@ export declare class SshTui {
     private runSubmodelCommand;
     /** /subeffort: pick the reasoning effort subagent children use. */
     private runSubeffortCommand;
-    /** /mode: pick an agent preset (standard / minimal / code / cordis / routing-suite / ...). */
+    /** /mode: pick an agent preset (standard / minimal / ptc / cordis / routing-suite / ...). */
     private runModeCommand;
     /** /resume: switch to a past session, or open a picker when no id is given. */
     private runResumeCommand;
@@ -673,10 +774,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.7",
   "description": "SSH-friendly interactive terminal TUI plugin for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",
@@ -80,20 +80,20 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-agent-default-model": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-cmdline": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-commands": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-credentials": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-subagent": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-user-approval": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-user-questions": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.1-rc.2"
+    "@deepseek-ai/dsh-agent": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent-default-model": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent-loop": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent-presets": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-cmdline": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-commands": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-credentials": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-session": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-subagent": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-user-approval": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-user-questions": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-session-persistence": ">=0.1.1-rc.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-user-approval": {
@@ -111,21 +111,21 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-agent-default-model": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-cmdline": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-commands": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-credentials": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-subagent": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-user-approval": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-user-questions": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent-default-model": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent-loop": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent-presets": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-cmdline": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-commands": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-credentials": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-session": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-subagent": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-user-approval": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-user-questions": ">=0.1.1-rc.2",
     "@types/node": "^24.0.0",
     "typescript": "^5.9.0",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.1-rc.2"
+    "@deepseek-ai/dsh-session-persistence": ">=0.1.1-rc.2"
   }
 }