dsh-ssh-tui 0.6.3 → 0.6.4

package/lib/types/context-window.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Route context-window sizing for hand-declared gateways.
+ *
+ * A gateway whose `GET /models` discloses no capacity leaves every model on the
+ * route at the harness default (262,144), so a long session compacts far
+ * earlier than the endpoint requires. `/setup` closes that gap from two
+ * sources, in order: the listing's own `context_length`, then the installed
+ * pi-ai catalog, which sizes 1,200-odd models under its own provider ids.
+ *
+ * A gateway id is rarely a catalog id verbatim — `gemini-claude-sonnet-4-6`
+ * proxies `claude-sonnet-4-6`, `deepseek/deepseek-v4.1-flash` is namespaced,
+ * `gemini-3.6-flash-high` names its thinking level — so the lookup normalizes
+ * before it matches, and reports nothing rather than guessing a window it
+ * never found.
+ *
+ * @module dsh-ssh-tui/context-window
+ */
+import type { CatalogPreset } from './provider-catalog.js';
+/**
+ * Catalog ids to try for one gateway model id, most specific first.
+ * @param raw - the id the endpoint advertises.
+ * @returns lowercased candidates, deduplicated and order-preserving.
+ */
+export declare function catalogIdCandidates(raw: string): string[];
+/**
+ * Every catalog window, keyed by lowercased model id. The first provider to
+ * size an id wins, so a shared id keeps one stable answer.
+ * @param presets - the read catalog presets.
+ * @returns the lookup index.
+ */
+export declare function catalogWindowIndex(presets: readonly CatalogPreset[]): Map<string, number>;
+/**
+ * The catalog window for one gateway model id.
+ * @param id - the id the endpoint advertises.
+ * @param index - {@link catalogWindowIndex} for the loaded catalog.
+ * @returns the window, or `undefined` when no candidate names a sized model.
+ */
+export declare function catalogContextWindow(id: string, index: ReadonlyMap<string, number>): number | undefined;
+/**
+ * The route-level default to persist: the smallest window discovered for the
+ * route's selected models. A model neither the listing nor the catalog sizes
+ * then inherits a value the route already proved it serves, never more.
+ * @param windows - the per-model windows discovered so far.
+ * @returns the window, or `undefined` when nothing was discovered.
+ */
+export declare function suggestedRouteContextWindow(windows: Iterable<number>): number | undefined;

package/lib/types/dialogs.d.ts

@@ -67,10 +67,11 @@ export type QuestionSubmit = {
     kind: 'none';
 };
 /**
- * What Enter means for a question dialog. A single-select list with nothing
- * highlighted cancels (the user must not accidentally answer with the first
- * option); a multi-select list may answer with an empty selection. With no
- * options at all, the typed text is the answer.
+ * What Enter means for a question dialog. A single-select list answers with the
+ * option its highlight sits on: the list opens on the first option, so Enter
+ * without arrowing answers that default instead of cancelling, and Esc stays the
+ * explicit cancel. A multi-select list may answer with an empty selection. With
+ * no options at all, the typed text is the answer.
  */
 export declare function questionSubmit(dialog: QuestionDialog, input: string): QuestionSubmit;
 /** y/n/ctrl-c/esc answers for a confirm prompt. */

package/lib/types/job-label.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Friendly display names for background jobs.
+ *
+ * `job_*` cards otherwise read as the raw tool vocabulary (`job_output`,
+ * `job_id: bash-1`), which is both untranslated and hard to talk about out
+ * loud. Each job id instead gets a two-word alias — "蔚蓝水獭", "azure otter" —
+ * derived from the id itself rather than from a random draw, so the same job
+ * keeps one name across its call card, its result card, and every later
+ * `job_output` / `job_kill` mention. The model-facing id stays authoritative;
+ * the alias is presentation only.
+ *
+ * @module dsh-ssh-tui/job-label
+ */
+/**
+ * One stable alias for a background job, or `undefined` when the id is empty
+ * or the locale carries no vocabulary.
+ * @param jobId - the native job id (`bash-1`, `pwsh-2`, …).
+ * @returns the locale-formatted alias, e.g. `蔚蓝水獭` / `azure otter`.
+ */
+export declare function jobAlias(jobId: string): string | undefined;

package/lib/types/provider-catalog.d.ts

@@ -3,6 +3,8 @@ export interface CatalogPreset {
     name: string;
     baseUrl: string;
     modelIds: string[];
+    /** Context capacity the catalog records, by lowercased model id; absent when it sizes none. */
+    capacities?: Record<string, number>;
 }
 /** Filter presets by a case-insensitive substring match on id or name. */
 export declare function filterCatalogPresets(presets: readonly CatalogPreset[], query: string): CatalogPreset[];

package/lib/types/quota.d.ts

@@ -27,6 +27,15 @@ export declare const OPENCODE_GO_USAGE_URL = "https://opencode.ai/zen/go/v1/usag
 export declare const OPENCODE_ZEN_BASE_URL = "https://opencode.ai/zen/v1";
 export declare const SUPERGROK_BILLING_URL = "https://cli-chat-proxy.grok.com/v1/billing?format=credits";
 export declare const DEEPSEEK_PUBLIC_BASE_URL = "https://api.deepseek.com";
+/**
+ * Command Code's billing surface sits on the API root, not under the
+ * `/provider/v1` route its chat requests use, so these are fixed: a configured
+ * base URL only decides whether the canonical host is the right one to ask.
+ */
+export declare const COMMAND_CODE_BASE_URL = "https://api.commandcode.ai";
+export declare const COMMAND_CODE_CREDITS_URL = "https://api.commandcode.ai/alpha/billing/credits";
+export declare const COMMAND_CODE_SUBSCRIPTIONS_URL = "https://api.commandcode.ai/alpha/billing/subscriptions";
+export declare const COMMAND_CODE_USAGE_URL = "https://api.commandcode.ai/alpha/usage/summary";
 /** OpenAI-completions gateways: probe these relative to the configured base URL. */
 export declare const OPENAI_COMPAT_BALANCE_PATHS: readonly ["/user/balance", "/dashboard/billing/credit_grants", "/v1/dashboard/billing/credit_grants", "/v1/dashboard/billing/subscription"];
 /**
@@ -35,6 +44,23 @@ export declare const OPENAI_COMPAT_BALANCE_PATHS: readonly ["/user/balance", "/d
  * routes are recognized by their `opencode.ai` base URL.
  */
 export declare function openCodeSourceFor(provider: string, llmPiAiSection: unknown): OpenCodeSource | null;
+/** A recognized Command Code route, used by the quota poller. */
+export interface CommandCodeSource {
+    provider: string;
+    apiKeyEnv: string;
+    label: string;
+}
+/**
+ * Classify one route as Command Code's quota surface.
+ *
+ * Recognized by provider id or by a canonical base URL. The billing requests
+ * always target the canonical host, so a lookalike base URL never receives the
+ * credential even when the route keeps Command Code's provider id.
+ * @param provider - the selected provider route.
+ * @param llmPiAiSection - the `llm-pi-ai` settings section, if readable.
+ * @returns the credential reference to use, or `null` for another provider.
+ */
+export declare function commandCodeSourceFor(provider: string, llmPiAiSection: unknown): CommandCodeSource | null;
 export type QuotaPeriod = 'hourly' | 'weekly' | 'monthly' | 'unknown';
 export interface QuotaWindow {
     label: string;
@@ -42,6 +68,8 @@ export interface QuotaWindow {
     /** Remaining percent of the window (100 = unused). */
     remainingPercent: number;
     resetsAt?: string;
+    /** Extra human-readable fact beside the percent, e.g. remaining USD credits. */
+    detail?: string;
 }
 export interface QuotaSnapshot {
     provider: string;
@@ -64,6 +92,27 @@ export declare function quotaRefreshEverySteps(window: QuotaWindow | undefined):
 export declare const quotaRefreshEveryTurns: typeof quotaRefreshEverySteps;
 export declare function parseSuperGrokBilling(payload: unknown): QuotaSnapshot;
 export declare function parseOpenCodeGoQuota(payload: unknown, provider: string): QuotaSnapshot;
+/** The billing-period start used to scope the spend query, when reported. */
+export declare function commandCodePeriodStart(subscription: unknown): string | undefined;
+export interface CommandCodeQuotaPayload {
+    /** Required `/alpha/billing/credits` reply. */
+    credits: unknown;
+    /** Optional `/alpha/billing/subscriptions` reply, for the plan and period. */
+    subscription?: unknown;
+    /** Optional `/alpha/usage/summary` reply, for period spend. */
+    summary?: unknown;
+}
+/**
+ * Parse Command Code's credits reply into the shared quota snapshot.
+ *
+ * The rolling five-hour and weekly windows report used/cap; the credit pool
+ * reports a remaining USD balance, which becomes a third window whose percent
+ * divides period spend by spend plus remaining balance.
+ * @param payload - the billing replies already fetched.
+ * @param provider - the route the snapshot is labeled with.
+ * @throws Error when no window could be read.
+ */
+export declare function parseCommandCodeQuota(payload: CommandCodeQuotaPayload, provider: string): QuotaSnapshot;
 export declare function formatQuotaSnapshot(snapshot: QuotaSnapshot): string;
 /** Compact `/status` quota line: tightest window first, then the rest. */
 export declare function formatQuotaStatusLine(snapshot: QuotaSnapshot | undefined): string;

package/lib/types/term-text.d.ts

@@ -46,15 +46,44 @@ export declare function wrapWaitDetails(detail: string, width: number, maxLines?
  * those ambiguous glyphs as two made `repeatToWidth('─', cols)` paint a
  * half-width rule and parked the input cursor half a cell past the text.
  *
- * Emoji-bearing symbols are the exception: an emoji font draws them two cells
- * wide even where wcwidth says one, and ✔ / ✖ from `npm test` spilled a row
- * into the next card. Variation selectors are zero-width, so ✔️ counts once
- * for the base plus nothing for VS16.
+ * Emoji-bearing symbols are the exception: a terminal with an emoji font draws
+ * a symbol the monospace font lacks with a colour glyph that is wider than the
+ * cell it advances, so they are budgeted two cells. {@link pinEmojiCells} makes
+ * the terminal actually spend both: VS15 asks for the narrow text form, and a
+ * reserving space clears the second cell when the run does not already end in
+ * one. Budgeting two cells without clearing the second is what left `✖`
+ * overlapping the `|` beside it while every `▶` row came up a cell short.
  *
  * Overflow into the input box is handled by clipping/padding painted rows to
  * the measured column count, not by inflating glyph width.
  */
 export declare function displayWidth(text: string): number;
+/**
+ * Make a painted row spend the two cells {@link displayWidth} budgets for every
+ * BMP emoji symbol.
+ *
+ * The monospace font of the terminal this was measured on covers `▶` but not
+ * `✖` or `ℹ`, so the two fall back to a colour emoji glyph about 1.6 cells wide
+ * while still advancing one cell: the `|` and `^` beside them were drawn under
+ * the glyph, and the row ended short because the second budgeted cell was never
+ * spent. The fix has two halves:
+ *
+ * - VS15 asks for the narrow text form (`emoji-variation-sequences.txt`,
+ *   Unicode 17.0, lists `2139 FE0E` and `2716 FE0E` among 371 such sequences).
+ *   Terminals that ignore it fall back to the colour glyph, which the next
+ *   bullet still contains.
+ * - A reserving space supplies the second cell, always emitted even when the run
+ *   already has one. That keeps the budget and the terminal in step for every
+ *   shape: the table counts the symbol as two cells plus every space the text
+ *   carries, and the terminal spends one cell of glyph advance, one for the
+ *   reserving space, and one for each of those spaces.
+ *
+ * A symbol whose Unicode default presentation is emoji already advances two
+ * cells, so it is left untouched.
+ * @param text - one already-padded, already-clipped row.
+ * @returns the row with the text request and the second cell filled in.
+ */
+export declare function pinEmojiCells(text: string): string;
 /** Pad or clip one already-sanitized line so it occupies exactly `width` cells. */
 export declare function padToWidth(text: string, width: number): string;
 /**

package/lib/types/tool-present.d.ts

@@ -6,6 +6,7 @@ import { type TextSegment } from './term-text.js';
 import type { DisplayKind, Row, ToolDiffHunk } from './transcript-types.js';
 export declare const SHELL_TOOL_NAMES: Set<string>;
 export declare const DIFF_TOOL_NAMES: Set<string>;
+export declare const JOB_TOOL_NAMES: Set<string>;
 /** Format a model list compactly: show the first few entries and an ellipsis. */
 export declare function formatModelList(models: readonly string[], max?: number): string;
 /** Prefer the fields a human scans for; fall back to the first scalar pairs. */

package/lib/types/tui.d.ts

@@ -29,7 +29,7 @@ export type { CollapsibleBlock, DisplayKind, DisconnectPolicyName, PlanTodoItem,
 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 { crossedQuotaThresholds, formatAccountBalance, formatFooterBalance, formatOpenCodeGoUsage, formatQuotaSnapshot, formatQuotaStatusLine, joinUrl, openCodeSourceFor, parseDeepSeekBalance, parseOpenAiCompatibleBalance, parseOpenCodeGoQuota, parseSuperGrokBilling, quotaAlertText, quotaRefreshEverySteps, quotaRefreshEveryTurns, remainingPercentFromUsed, tightestQuotaWindow, type AccountBalanceLine, type AccountBalanceSnapshot, type OpenCodeFlavor, type OpenCodeSource, type QuotaPeriod, type QuotaSnapshot, type QuotaWindow, } from './quota.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 { 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';
@@ -94,6 +94,31 @@ export interface TuiController {
 }
 export type WorkspaceView = 'detailed' | 'compact';
 export declare function parseDisconnectPolicy(raw: string): DisconnectPolicyName | undefined;
+/**
+ * The `reasoningEfforts` map `/setup` writes for a hand-declared
+ * OpenAI-compatible route.
+ *
+ * Such a route is absent from pi-ai's catalog, so `defaultReasoningEffort`
+ * resolves nothing before the profile is saved and the model would land as a
+ * bare `{ id }` entry. The Harness then reports that model as non-reasoning
+ * (`levels [off]`) and refuses every effort the TUI itself offers for an
+ * undeclared model. Declaring the offered vocabulary up front keeps the model
+ * dispatchable; no parameter is sent until an effort is selected.
+ * @returns the level-to-wire map, with `off` meaning "send no parameter".
+ */
+export declare function handDeclaredReasoningEfforts(): Record<string, string | null>;
+/**
+ * The `reasoningEfforts` map `/setup` persists for one model entry.
+ *
+ * A hand-declared OpenAI-compatible completions route always receives the
+ * offered vocabulary; a catalog-backed route keeps whatever live model info
+ * resolved, preserving the existing behavior of redeclaring only the chosen
+ * default.
+ * @param providerType - the wizard template that produced the route.
+ * @param defaultEffort - the level resolved from live model info, if any.
+ * @returns the level-to-wire map, or `undefined` to declare nothing.
+ */
+export declare function onboardingReasoningEfforts(providerType: string, defaultEffort: string | undefined): Record<string, string | null> | undefined;
 /** Parse `/effort high` / `/subeffort default`. Empty or unknown → undefined. */
 export declare function parseEffortArg(raw: string): {
     kind: 'default';
@@ -119,6 +144,8 @@ export declare class SshTui {
     /** Web-aligned provider presets from the host's pi-ai catalog (undefined until loaded / when unreachable). */
     private catalogPresets;
     private catalogLoad;
+    /** Memoized id→window index over {@link catalogPresets}. */
+    private catalogWindows;
     private input;
     private cursor;
     private inputFolded;
@@ -563,6 +590,20 @@ export declare class SshTui {
     private runSubmodelCommand;
     /** /effort: pick or set the reasoning effort for the current model. */
     private runEffortCommand;
+    /**
+     * Persist one explicitly chosen level as a model's `reasoningEfforts`.
+     *
+     * `/effort` offers `low`…`max` for a model whose route declares nothing, but
+     * the selection alone cannot make the request legal: the Harness still
+     * resolves the model as non-reasoning and refuses it. Writing the chosen
+     * level — merged with whatever the entry already declares — keeps the
+     * selection and the declaration consistent. Only a route that explicitly
+     * speaks OpenAI Completions is amended: its dialect omits the parameter for
+     * `off` and was verified against a gateway, while another protocol may
+     * materialize an unset level as a value its endpoint refuses.
+     * @returns whether the entry now declares the level.
+     */
+    private declareReasoningEffort;
     private setReasoningEffort;
     /** /subeffort: pick the reasoning effort subagent children use. */
     private runSubeffortCommand;
@@ -588,6 +629,16 @@ export declare class SshTui {
     private resolveCredential;
     /** Query the OpenCode Go quota endpoint. */
     private fetchOpenCodeGoUsage;
+    /**
+     * Command Code's quota: the rolling 5h/weekly windows and credit pool off
+     * `/alpha/billing/credits`, enriched by the subscription period and spend.
+     * Only the credits read is required; the two enrichment reads are
+     * best-effort so one failing endpoint cannot hide the windows.
+     * @param source - the recognized Command Code route.
+     */
+    private fetchCommandCodeQuota;
+    /** Best-effort JSON read for quota enrichment; a failure leaves the field out. */
+    private tryFetchJson;
     /** Explain Zen metered billing instead of pretending it has a quota. */
     private zenUsageText;
     /** /usage and /balance: remaining quota or prepaid balance for the current provider. */
@@ -614,6 +665,16 @@ export declare class SshTui {
      */
     private mergedProviderEntries;
     private moveProviderCursor;
+    /** The installed catalog's id→window index, built once per catalog load. */
+    private catalogWindowIndexSource;
+    /**
+     * Size the wizard's picked models from the installed catalog, filling in the
+     * capacities the endpoint's listing did not disclose and recording them on
+     * the wizard state so the saved entries carry them.
+     * @param state - the wizard state whose `models` are being sized.
+     * @returns the windows discovered for this pick, by model id.
+     */
+    private sizeOnboardingModels;
     private handleOnboardingChar;
     private advanceOnboarding;
     /** Fetch the endpoint's model list into the onboarding wizard's models step. */

package/package.json

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