dsh-ssh-tui 0.7.0-rc.2 → 0.7.0

package/lib/types/footer.d.ts

@@ -1,7 +1,7 @@
 /**
  * Footer stats, status identity, context-pressure chips, and `/status` report.
  */
-import { type QuotaSnapshot } from './quota.js';
+import { type QuotaPeriod, type QuotaSnapshot, type QuotaSource } from './quota.js';
 import type { DisconnectPolicyName } from './transcript-types.js';
 export declare const WAIT_INDICATOR_MS = 8000;
 /** Compact token count, matching the web stats line (517 / 12.2K / 1.2M). */
@@ -135,6 +135,10 @@ export interface FooterStatusInput {
     subEffort?: string;
     quotaCode?: string;
     quotaPercent?: number;
+    /** Which rolling window `quotaPercent` belongs to: tagged `5Hr`/`1Wk`/`1Mo`. */
+    quotaPeriod?: QuotaPeriod;
+    /** The provider has a quota surface but no reading yet: paint `░░░░░░░░ ?%`. */
+    quotaUnknown?: boolean;
     contextChip?: string;
     balanceText?: string;
     search?: {
@@ -154,15 +158,62 @@ export declare function footerActivity(input: FooterStatusInput): {
 /** Short remaining-quota bar: 8 pips, filled from the left. */
 export declare function formatQuotaBar(remainingPercent: number, width?: number): string;
 /**
- * `sub:<model>` chip for the identity row, mirroring the pre-0.3.6 footer:
- * an explicit `/submodel` provider is prefixed (`sub:xai/grok-4.5`) and an
- * explicit `/subeffort` is appended in parentheses (`sub:grok-4.5(xhigh)`).
- * An inherited provider stays implicit — it is the parent's route.
+ * `sub:<model>` chip for the identity row: `sub:grok-4.5`, or
+ * `sub:grok-4.5(xhigh)` when an explicit `/subeffort` is set.
+ *
+ * It shows the model name only, like the parent's own chip: a `provider/model`
+ * prefix on both chips doubled the same route and pushed the quota badge towards
+ * the drop edge. The provider is not lost — `/submodel` and `/status` report it,
+ * and the child's model name is the part that differs from the parent's.
  */
 export declare function subagentRouteLabel(model: string, provider?: string, effort?: string): string;
+/**
+ * The model as the footer shows it: the model's own name, without a
+ * `provider/model` route prefix.
+ *
+ * Some providers carry the vendor in the model id (`xai/grok-4.6`,
+ * `deepseek-official/deepseek-v4-flash`). The route is worth a row in the header
+ * and in `/status`; in the status line it spent cells on something the reader
+ * already knows, and it pushed the quota badge towards the drop edge.
+ * `sub:` routes keep their provider on purpose — that is a *different* route
+ * from the parent's, and hiding it would make the two indistinguishable.
+ */
+export declare function shortModelName(model: string): string;
 export declare function footerIdentityParts(input: FooterStatusInput): string[];
-/** `SuperGrok ███████░ 82%`, or just the bar + percent when `code` is omitted. */
-export declare function formatFooterQuota(percent: number, code?: string): string;
+/**
+ * `SuperGrok 5Hr ███████░ 82%` — short plan badge, the window the number belongs
+ * to, then the bar.
+ *
+ * The tags are fixed technical labels (`5Hr` / `1Wk` / `1Mo`) rather than
+ * localized words: they sit in a footer that is already fighting for cells, and
+ * a window tag that changes with the locale would be unreadable in a screenshot
+ * or a bug report. Everything else about the window (label, reset time, detail)
+ * stays in `/quota`.
+ */
+export declare function formatFooterQuota(percent: number, code?: string, period?: QuotaPeriod): string;
+/**
+ * The quota widget before the first reading arrives, or while the provider
+ * cannot be reached: an empty bar and a question mark.
+ *
+ * Deliberately not `0%`: an unreachable quota API is not a used-up quota, and a
+ * number the footer cannot back up is worse than no number. The bar is there
+ * from the first frame so the row does not jump when the reading lands.
+ */
+export declare function formatQuotaUnknown(): string;
+/** Fixed-width tag for the window a footer quota number belongs to. */
+export declare function quotaWindowTag(period: QuotaPeriod | undefined): string;
+/**
+ * The badge the footer shows instead of the billing plan's own label:
+ * `SuperGrok`, `OC·GO` (OpenCode Go), `CC·GOAT` (Command Code Goat).
+ *
+ * The long names live in `/quota`; this one has to survive next to a model id.
+ * Without a `source` (a hand-built snapshot) the plan label is matched instead,
+ * so old callers and tests keep a sensible badge.
+ */
+export declare function shortQuotaPlanName(snapshot: {
+    plan: string;
+    source?: QuotaSource;
+}): string;
 /**
  * Drop the Go / SuperGrok plan name from a quota identity part, keeping the
  * remaining-percent bar. Returns true when a part was rewritten.
@@ -198,3 +249,12 @@ export declare function describeProviderRoute(provider: string): {
 };
 /** Routes that authenticate without a harness API-key credential. */
 export declare function providerUsesLocalOAuth(provider: string): boolean;
+/**
+ * Whether a provider has a quota surface at all, without asking it.
+ *
+ * The footer paints a quota widget from the first frame — an empty bar and `?%`
+ * until a reading arrives — so it needs to tell "this provider will have one"
+ * from "this provider reports a balance instead" (DeepSeek) or nothing at all.
+ * Every branch is a synchronous settings read, so a repaint never does IO.
+ */
+export declare function providerHasQuotaSurface(provider: string, llmPiAiSection: unknown): boolean;

package/lib/types/quota.d.ts

@@ -62,6 +62,12 @@ export interface CommandCodeSource {
  */
 export declare function commandCodeSourceFor(provider: string, llmPiAiSection: unknown): CommandCodeSource | null;
 export type QuotaPeriod = 'hourly' | 'weekly' | 'monthly' | 'unknown';
+/**
+ * Which billing surface a snapshot came from. The footer shows a short plan
+ * badge (`SuperGrok` / `OC·GO` / `CC·GOAT`), and the provider string alone is
+ * not enough to tell the three apart.
+ */
+export type QuotaSource = 'supergrok' | 'opencode-go' | 'command-code';
 export interface QuotaWindow {
     label: string;
     period: QuotaPeriod;
@@ -74,6 +80,8 @@ export interface QuotaWindow {
 export interface QuotaSnapshot {
     provider: string;
     plan: string;
+    /** Billing surface, for the footer's short badge. Absent on hand-built snapshots. */
+    source?: QuotaSource;
     windows: QuotaWindow[];
 }
 export declare function remainingPercentFromUsed(usedPercent: number): number;
@@ -118,6 +126,15 @@ export declare function formatQuotaSnapshot(snapshot: QuotaSnapshot): string;
 export declare function formatQuotaStatusLine(snapshot: QuotaSnapshot | undefined): string;
 /** Tightest remaining window — used for threshold alerts. */
 export declare function tightestQuotaWindow(snapshot: QuotaSnapshot): QuotaWindow | undefined;
+/**
+ * The window the footer shows by default: the *finest* one, not the tightest.
+ *
+ * A five-hour cap is what runs out first inside a working session, so it is the
+ * number a glance should find; a monthly window at 12% would otherwise hide a
+ * five-hour window at 3%. Ties (and a provider that reports only one window)
+ * fall back to the lowest remaining percent.
+ */
+export declare function preferredQuotaWindow(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 {

package/lib/types/transcript-types.d.ts

@@ -87,6 +87,14 @@ export type Row = {
      * Does not rewrite the session log.
      */
     turnLeftOpen?: boolean;
+    /**
+     * Display-only: the one leftover-todo reminder for this open list has
+     * been sent. The model's answer is itself a `todo_write`, so this must
+     * survive that patch — otherwise every turn end asks again, and each ask
+     * is another model turn. Reset when the list closes, so a list that opens
+     * again gets its own single reminder.
+     */
+    nudged?: boolean;
 } | {
     kind: 'question';
     questionId: string;

package/lib/types/tui.d.ts

@@ -28,8 +28,8 @@ import { paintedLinkHits } from './term-text.js';
 export type { CollapsibleBlock, DisplayKind, DisconnectPolicyName, PlanTodoItem, Row, SubagentLogEntry, ToolDiffHunk, } from './transcript-types.js';
 export { clipAnsiToWidth, cursorVisualPosition, displayWidth, foldInputView, hrefAtColumn, osc52Clipboard, osc8Enabled, paintedLinkHits, fmtElapsedCompact, padAnsiToWidth, padToWidth, renderMarkdownLines, repeatToWidth, shimmerText, truncateToWidth, visibleWidth, waitCardCopy, waitSummaryFromReasoning, wrapWaitDetails, } from './term-text.js';
 export { captureHangupSignals, composePaintOutput, detectSshSession, formatLinkQualityChip, ignoreFurtherHangupSignals, isEscapePrefix, findCursorPositionReply, isHangupErrno, linkQualityOf, linkSignalPips, paintIntervalForRtt, paintLinkLabel, parseCursorPositionReply, pickerWindowStart, probeTerminalRttMs, releaseHangupSignals, resolvePaintIntervalMs, waitUntilIdleOrTimeout, writeBootSplash, type LinkQuality, type PaintLinkKind, } from './paint.js';
-export { CONTEXT_IDLE_COMPACT_RATIO, CONTEXT_PRESSURE_DANGER_RATIO, CONTEXT_PRESSURE_WARN_RATIO, CONTEXT_RING_EMPTY, CONTEXT_RING_SEGMENTS, contextPressureAlertText, contextPressureRingColor, contextPressureUsedTokens, contextPressureView, describeProviderRoute, dropFooterQuotaPlanName, fitFooterStatsLine, fitFooterStatusLine, footerActivity, footerIdentityParts, footerStatsGroups, formatContextPressureChip, formatContextPressureRing, formatContextPressureStatusLine, formatDuration, formatFooterQuota, formatQuotaBar, formatStatusReport, formatTokens, formatTokensPerSecond, parseContextPressure, promptPressureTokens, providerShortCode, providerUsesLocalOAuth, shouldIdleAutoCompact, subagentRouteLabel, type ContextPressureSample, type ContextPressureView, type FooterActivityKind, type FooterStatsInput, type FooterStatusInput, type StatusReportInput, } from './footer.js';
-export { commandCodePeriodStart, commandCodeSourceFor, crossedQuotaThresholds, formatAccountBalance, formatFooterBalance, formatOpenCodeGoUsage, formatQuotaSnapshot, formatQuotaStatusLine, joinUrl, openCodeSourceFor, parseCommandCodeQuota, parseDeepSeekBalance, parseOpenAiCompatibleBalance, parseOpenCodeGoQuota, parseSuperGrokBilling, quotaAlertText, quotaRefreshEverySteps, quotaRefreshEveryTurns, remainingPercentFromUsed, tightestQuotaWindow, type AccountBalanceLine, type AccountBalanceSnapshot, type CommandCodeSource, type OpenCodeFlavor, type OpenCodeSource, type QuotaPeriod, type QuotaSnapshot, type QuotaWindow, } from './quota.js';
+export { CONTEXT_IDLE_COMPACT_RATIO, CONTEXT_PRESSURE_DANGER_RATIO, CONTEXT_PRESSURE_WARN_RATIO, CONTEXT_RING_EMPTY, CONTEXT_RING_SEGMENTS, contextPressureAlertText, contextPressureRingColor, contextPressureUsedTokens, contextPressureView, describeProviderRoute, dropFooterQuotaPlanName, fitFooterStatsLine, fitFooterStatusLine, footerActivity, footerIdentityParts, footerStatsGroups, formatContextPressureChip, formatContextPressureRing, formatContextPressureStatusLine, formatDuration, formatFooterQuota, formatQuotaBar, formatQuotaUnknown, formatStatusReport, providerHasQuotaSurface, quotaWindowTag, shortModelName, shortQuotaPlanName, formatTokens, formatTokensPerSecond, parseContextPressure, promptPressureTokens, providerShortCode, providerUsesLocalOAuth, shouldIdleAutoCompact, subagentRouteLabel, type ContextPressureSample, type ContextPressureView, type FooterActivityKind, type FooterStatsInput, type FooterStatusInput, type StatusReportInput, } from './footer.js';
+export { commandCodePeriodStart, commandCodeSourceFor, crossedQuotaThresholds, formatAccountBalance, formatFooterBalance, formatOpenCodeGoUsage, formatQuotaSnapshot, formatQuotaStatusLine, joinUrl, openCodeSourceFor, parseCommandCodeQuota, parseDeepSeekBalance, parseOpenAiCompatibleBalance, parseOpenCodeGoQuota, parseSuperGrokBilling, preferredQuotaWindow, quotaAlertText, quotaRefreshEverySteps, quotaRefreshEveryTurns, remainingPercentFromUsed, tightestQuotaWindow, type AccountBalanceLine, type AccountBalanceSnapshot, type CommandCodeSource, type OpenCodeFlavor, type OpenCodeSource, type QuotaPeriod, type QuotaSnapshot, type QuotaWindow, } from './quota.js';
 export { commandAcceptsAttachments, forEachSessionEvent, isAssistantStreamEvent, isTokenDeltaChunk, listPersistenceHeaders, inspectPersistenceSession, sessionEventType, sessionEvents, settingsNamespace, streamChunkOf, streamFirstTokenTime, streamFrameAttemptId, streamFrameOwner, } from './dsh-compat.js';
 export { applyTurnEndToPlan, askSummary, cardCategoryOf, compactionHeaderText, formatCompactCommandError, isPromptInjectionMessage, matchTranscriptRows, parseFindQuery, parsePlanTodos, planCloseNudgeText, planDockNote, planIsLive, planTitleFromMarkdown, planTurnLeftOpen, promptInjectionSources, promptInjectionTitle, subagentHeaderText, todoProgressLabel, todoSummary, type CardCategory, } from './plan.js';
 export { buildToolHeader, canMergeToolCall, compactEditPath, compactToolBursts, compactToolGroups, countDiffAddDel, countDiffLines, countOutputLines, diffMetaDiffs, diffStatToken, friendlyJsonLines, parseExitStatus, presentToolCall, READ_TOOL_NAMES, renderToolDiff, toolBodyFitsWorkspace, toolBodyLines, toolStateColor, toolStateLabel, wrappedToolBodyLineCount, } from './tool-present.js';
@@ -329,6 +329,13 @@ export declare class SshTui {
     private quotaAlerted;
     private quotaStepsSinceRefresh;
     private quotaRefreshInFlight;
+    /**
+     * While the first reading is missing, ask again on this cadence instead of
+     * waiting for the next step: a quota API that was down at boot is usually up a
+     * few seconds later, and until then the footer shows `?%`.
+     */
+    private quotaRetryMs;
+    private quotaRetryTimer;
     private contextPressure;
     private contextAlertLevel;
     private idleCompactInFlight;
@@ -840,6 +847,16 @@ export declare class SshTui {
     /** /usage and /balance: remaining quota or prepaid balance for the current provider. */
     private runUsageCommand;
     private applyQuotaSnapshot;
+    /** Stop the first-reading retry; the normal cadence owns the refresh now. */
+    private clearQuotaRetry;
+    /** Ask again soon, but only while the footer still has nothing to show. */
+    private armQuotaRetry;
+    /**
+     * Whether this provider has a quota surface at all. `false` means the footer
+     * shows no quota widget — a balance line covers DeepSeek, and a provider with
+     * neither gets nothing.
+     */
+    private hasQuotaSurface;
     private refreshQuota;
     private fetchAccountBalance;
     private fetchQuotaSnapshot;

package/package.json

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