dsh-ssh-tui 0.3.4 → 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/session-lock.d.ts

@@ -0,0 +1,26 @@
+export interface SessionLockInfo {
+    pid: number;
+    sessionId: string;
+    startedAt: string;
+    tty?: string;
+}
+export declare class SessionLockHeldError extends Error {
+    readonly lock: SessionLockInfo;
+    readonly path: string;
+    constructor(lock: SessionLockInfo, path: string);
+}
+export declare function sessionLockPath(sessionId: string, dshHome?: string): string;
+export declare function parseSessionLock(raw: string): SessionLockInfo | undefined;
+/** True when `pid` still exists on this machine (best-effort). */
+export declare function processIsAlive(pid: number): boolean;
+export declare function formatLockHeldMessage(lock: SessionLockInfo): string;
+export declare function sessionLockDisabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function acquireSessionLock(sessionId: string, options?: {
+    pid?: number;
+    tty?: string | null;
+    dshHome?: string;
+}): Promise<{
+    path: string;
+    info: SessionLockInfo;
+}>;
+export declare function releaseSessionLock(path: string, pid?: number): Promise<void>;

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;
@@ -508,6 +595,7 @@ 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 notifyPluginUpdate;
     private startRenderTimer;
     private calibratePaintInterval;
     /** Replay the durable session log so a resumed session renders its history. */
@@ -563,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;
@@ -640,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;
@@ -652,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). */
@@ -672,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/lib/types/update-check.d.ts

@@ -0,0 +1,4 @@
+export declare function compareSemver(a: string, b: string): number;
+export declare function formatUpdateNotice(current: string, latest: string): string;
+export declare function fetchLatestNpmVersion(fetchImpl?: typeof fetch): Promise<string | undefined>;
+export declare function checkForPluginUpdate(current: string): Promise<string | undefined>;

package/lib/update-check.js

@@ -0,0 +1,49 @@
+/**
+ * Best-effort npm latest check. Never auto-upgrades; failures stay quiet.
+ */
+const NPM_REGISTRY = 'https://registry.npmjs.org/dsh-ssh-tui/latest';
+const CHECK_TIMEOUT_MS = 4000;
+export function compareSemver(a, b) {
+    const parse = (value) => {
+        const core = value.trim().replace(/^v/u, '').split('-')[0] ?? '0';
+        const parts = core.split('.').map(part => Number.parseInt(part, 10));
+        return [0, 1, 2].map(i => Number.isFinite(parts[i]) ? parts[i] : 0);
+    };
+    const left = parse(a);
+    const right = parse(b);
+    for (let i = 0; i < 3; i++) {
+        if (left[i] !== right[i])
+            return left[i] - right[i];
+    }
+    return 0;
+}
+export function formatUpdateNotice(current, latest) {
+    return `发现新版本 dsh-ssh-tui ${latest}（当前 ${current}）。更新：dsh plugin --profile tui add dsh-ssh-tui`;
+}
+export async function fetchLatestNpmVersion(fetchImpl = fetch) {
+    try {
+        const response = await fetchImpl(NPM_REGISTRY, {
+            headers: { accept: 'application/json' },
+            signal: AbortSignal.timeout(CHECK_TIMEOUT_MS),
+        });
+        if (!response.ok)
+            return undefined;
+        const body = await response.json();
+        return typeof body.version === 'string' && body.version.trim() !== '' ? body.version.trim() : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function checkForPluginUpdate(current) {
+    if (process.env.DSH_TUI_NO_UPDATE_CHECK === '1' || process.env.DSH_TUI_NO_UPDATE_CHECK === 'true') {
+        return undefined;
+    }
+    const latest = await fetchLatestNpmVersion();
+    if (latest === undefined)
+        return undefined;
+    if (compareSemver(latest, current) <= 0)
+        return undefined;
+    return formatUpdateNotice(current, latest);
+}
+//# sourceMappingURL=update-check.js.map

package/lib/update-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,YAAY,GAAG,+CAA+C,CAAA;AACpE,MAAM,gBAAgB,GAAG,IAAI,CAAA;AAE7B,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAY,EAAE;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAA;QACjE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAA;QACpE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACtE,CAAC,CAAA;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACrB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,CAAC,CAAE,KAAK,KAAK,CAAC,CAAC,CAAE;YAAE,OAAO,IAAI,CAAC,CAAC,CAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;IACzD,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,MAAc;IAChE,OAAO,qBAAqB,MAAM,OAAO,OAAO,+CAA+C,CAAA;AACjG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,YAA0B,KAAK;IAE/B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,YAAY,EAAE;YAC7C,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;YACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC;SAC9C,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,SAAS,CAAA;QAClC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA2B,CAAA;QAC3D,OAAO,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;IACzG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAe;IACxD,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,MAAM,EAAE,CAAC;QAClG,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAA;IAC5C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC1C,IAAI,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IACzD,OAAO,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AAC5C,CAAC"}

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "dsh-ssh-tui",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "SSH-friendly interactive terminal TUI plugin for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",
     "dsh",
+    "dsh-plugin",
     "plugin",
     "tui",
     "terminal",
-    "ssh"
+    "ssh",
+    "cordis"
   ],
   "author": "cyjyyd",
   "repository": {