@wrongstack/tui 1.0.0 → 1.0.3

package/dist/app-action-type.d.ts

@@ -4,7 +4,7 @@ import type { SddBoardSnapshot } from '@wrongstack/sdd';
 import type { State } from './app-state.js';
 import type { DraftEntry, GoalSummary, QueueItem, ResumeSessionEntry, SlashCommandMatch } from './app-state-core-types.js';
 import type { FleetEntry } from './app-state-fleet.js';
-import type { AuthCatalogRow, AuthConfirmAction, AuthLocalPresetRow, AuthPanelView, AuthProviderRow } from './auth-panel-model.js';
+import type { AuthCatalogRow, AuthConfirmAction, AuthFormFieldId, AuthFormState, AuthLocalPresetRow, AuthPanelView, AuthProviderRow } from './auth-panel-model.js';
 import type { BrainLogEntry, BrainRiskLevel } from './brain-contracts.js';
 import type { BrainPanelSettings } from './brain-panel-model.js';
 import type { StatuslineItem } from './components/statusline-picker.js';
@@ -27,6 +27,17 @@ export type Action = {
     cursor: number;
 } | {
     type: 'clearInput';
+}
+/**
+ * Flip the composer into bash mode (`!` pressed on an empty draft): the
+ * input becomes a shell-command line and Enter runs it via the `!` path.
+ */
+ | {
+    type: 'bashModeEnter';
+}
+/** Leave bash mode and restore the normal chat composer. */
+ | {
+    type: 'bashModeExit';
 } | {
     type: 'clearHistory';
     model?: string | undefined;
@@ -659,6 +670,7 @@ export type Action = {
     view?: Extract<AuthPanelView, 'list' | 'oauth'> | undefined;
     providers?: AuthProviderRow[] | undefined;
     presets?: AuthLocalPresetRow[] | undefined;
+    oauthStrategies?: import('./auth-panel-model.js').AuthOAuthStrategyRow[] | undefined;
 } | {
     type: 'authClose';
 } | {
@@ -708,6 +720,15 @@ export type Action = {
     action: AuthConfirmAction;
 } | {
     type: 'authConfirmEnd';
+} | {
+    type: 'authFormStart';
+    form: AuthFormState;
+} | {
+    type: 'authFormChange';
+    field: AuthFormFieldId;
+    value: string;
+} | {
+    type: 'authFormCancel';
 } | {
     type: 'projectPickerOpen';
     items: ProjectPickerItem[];

package/dist/app-key-handler.d.ts

@@ -44,7 +44,9 @@ interface AppKeyHandlerOptions {
         cursor: number;
     }>;
     setDraft: (buffer: string, cursor: number) => void;
-    submit: () => void;
+    /** Submits the composer. `overrideRaw` bypasses the buffer (bash mode
+     *  forwards its draft through the `!` shell path this way). */
+    submit: (overrideRaw?: string) => void;
     mouseMode: boolean;
     termRows: number;
     terminalColumns: number;

package/dist/app-state.d.ts

@@ -62,6 +62,14 @@ export type State = {
     resumeLoad: ResumeLoadState | null;
     buffer: string;
     cursor: number;
+    /**
+     * Bash mode: the composer is dedicated to shell commands. Entered by
+     * pressing `!` on an empty draft, exited by Esc / Backspace-on-empty (or a
+     * successful run). While on, Enter submits the draft through the `!` shell
+     * path (`/dev`) instead of sending it to the model, and the composer rail
+     * relabels itself so the mode is unmistakable.
+     */
+    bashMode: boolean;
     streamingText: string;
     /**
      * Live tail of the currently streaming tool's stdout/progress text. Mirrors

package/dist/auth-panel-model.d.ts

@@ -36,7 +36,15 @@ export interface AuthLocalPresetRow {
     noAuth: boolean;
     hint: string;
 }
-export type AuthOAuthKind = 'chatgpt' | 'claude' | 'copilot';
+/** UI-safe interactive-login descriptor supplied by the CLI host. */
+export interface AuthOAuthStrategyRow {
+    id: string;
+    providerId: string;
+    label: string;
+    description?: string | undefined;
+}
+/** Strategy ids are runtime-extensible. */
+export type AuthOAuthKind = string;
 /**
  * Bridge the CLI flows use to talk to the panel while a flow runs.
  * `prompt` REJECTS when the user cancels (Esc) — flows treat a thrown
@@ -120,6 +128,7 @@ export interface AuthPanelHost {
     listProviders(): Promise<AuthProviderRow[]>;
     listCatalog(): Promise<AuthCatalogRow[]>;
     localPresets(): AuthLocalPresetRow[];
+    oauthStrategies?: (() => AuthOAuthStrategyRow[]) | undefined;
     setActiveKey(providerId: string, label: string): Promise<string | null>;
     deleteKey(providerId: string, label: string): Promise<string | null>;
     removeProvider(providerId: string): Promise<string | null>;
@@ -153,7 +162,17 @@ export interface AuthPanelHost {
     resetModelToCatalog(providerId: string, modelId: string): Promise<string | null>;
     addCatalogProvider(catalogId: string, io: AuthFlowIo): Promise<AuthFlowResult>;
     addCustomProvider(io: AuthFlowIo): Promise<AuthFlowResult>;
-    addLocal(presetId: string, io: AuthFlowIo): Promise<AuthFlowResult>;
+    /**
+     * Probe-and-add a local preset. With `opts` present (the form path) no
+     * interactive prompts run — the form supplies the base URL and the key
+     * decision (empty apiKey string = save without a key). Without `opts`
+     * the flow prompts for the URL, and runAuthLocal prompts for the
+     * optional key itself. The health probe still streams into the flow log.
+     */
+    addLocal(presetId: string, io: AuthFlowIo, opts?: {
+        baseUrl?: string;
+        apiKey?: string;
+    }): Promise<AuthFlowResult>;
     oauthLogin(kind: AuthOAuthKind, io: AuthFlowIo): Promise<AuthFlowResult>;
     /**
      * Form-shaped counterparts to the `io`-driven flows above: the panel hands
@@ -168,7 +187,7 @@ export interface AuthPanelHost {
     saveModelEdit(edit: AuthModelEdit): Promise<string | null>;
     saveKeyEdit(edit: AuthKeyEdit): Promise<string | null>;
 }
-export type AuthPanelView = 'list' | 'provider' | 'models' | 'catalog' | 'local' | 'oauth' | 'flow';
+export type AuthPanelView = 'list' | 'provider' | 'models' | 'catalog' | 'local' | 'oauth' | 'flow' | 'form';
 export type AuthConfirmAction = {
     kind: 'delete-key';
     providerId: string;
@@ -188,6 +207,7 @@ export interface AuthPanelState {
     hint?: string | undefined;
     providers: AuthProviderRow[];
     presets: AuthLocalPresetRow[];
+    oauthStrategies?: AuthOAuthStrategyRow[] | undefined;
     catalog: AuthCatalogRow[];
     /** Cursor index into `authPanelRows(state)` for the current view. */
     selected: number;
@@ -211,6 +231,53 @@ export interface AuthPanelState {
         question: string;
         action: AuthConfirmAction;
     } | undefined;
+    /**
+     * Live add/edit form (view === 'form'). The form lists every input
+     * field vertically on one screen with a Cancel/Save row at the bottom.
+     * `authFormStart` opens it with pre-filled defaults; `authFormChange`
+     * updates fields; `authFormCancel` / `authView` clear it.
+     */
+    form?: AuthFormState | undefined;
+}
+/**
+ * Provider-add / provider-edit form. Every input field sits on its own
+ * row above a Cancel/Save pair at the bottom — no question-and-answer
+ * prompt bridge, no per-field modal.
+ *
+ * `kind` chooses which fields are editable:
+ *   - `setup`: full add form (catalog prefilled or fully custom).
+ *   - `edit`: non-secret settings of an existing provider.
+ *
+ * The `family` field is cycled with left/right arrow keys in the key
+ * router; the text fields accept printable input + backspace.
+ */
+export interface AuthFormState {
+    kind: 'setup' | 'edit' | 'local';
+    /** Provider being edited (`edit` only). */
+    providerId?: string;
+    /** Local preset being added (`local` only). */
+    presetId?: string;
+    /** Pre-filled defaults the user can edit in place. */
+    fields: AuthFormFields;
+}
+export type AuthFormFieldId = 'type' | 'name' | 'family' | 'baseUrl' | 'alias' | 'keyLabel' | 'apiKey' | 'models' | 'envVars';
+/**
+ * Mirrors `validateFamily` in packages/cli/src/auth-menu/shared.ts.
+ * Kept in sync by the shared form screen — a new value requires both
+ * sites to change. The list drives the ←/→ cycling on the family row.
+ */
+export declare const WIRE_FAMILIES: readonly ['anthropic', 'openai', 'openai-compatible', 'google'];
+export type WireFamily = (typeof WIRE_FAMILIES)[number];
+export interface AuthFormFields {
+    type: string;
+    name: string;
+    family: WireFamily | '';
+    baseUrl: string;
+    alias: string;
+    keyLabel: string;
+    apiKey: string;
+    models: string;
+    envVars: string;
 }
 export declare const AUTH_PANEL_INITIAL: AuthPanelState;
 export type AuthPanelRow = {
@@ -224,7 +291,7 @@ export type AuthPanelRow = {
     keyRow: AuthKeyRow;
 } | {
     kind: 'provider-action';
-    action: 'add-key' | 'edit-family' | 'edit-base-url' | 'edit-models' | 'edit-model-details' | 'add-model' | 'reset-model-to-catalog' | 'remove' | 'back-to-list';
+    action: 'add-key' | 'edit-provider' | 'edit-model-details' | 'add-model' | 'reset-model-to-catalog' | 'remove' | 'back-to-list';
 } | {
     kind: 'model-row';
     providerId: string;
@@ -238,7 +305,19 @@ export type AuthPanelRow = {
     preset: AuthLocalPresetRow;
 } | {
     kind: 'oauth-option';
-    oauth: AuthOAuthKind;
+    oauth: AuthOAuthStrategyRow;
+} | {
+    kind: 'form-field';
+    field: AuthFormFieldId;
+    /** One-line field label shown on the left of the row. */
+    label: string;
+    /** Text fields render their value verbatim; family shows the active family; secret masks the value. */
+    value: string;
+    /** True for the API-key field — masked on screen, raw in panel state. */
+    secret: boolean;
+} | {
+    kind: 'form-action';
+    action: 'cancel' | 'save';
 };
 /** Case-insensitive substring filter over id + name + family. */
 export declare function filterAuthCatalog(catalog: AuthCatalogRow[], filter: string): AuthCatalogRow[];

package/dist/components/input.d.ts

@@ -13,6 +13,14 @@ export interface InputProps {
     hint?: string | undefined;
     /** Label embedded in the composer's top rail. */
     title?: string | undefined;
+    /** Glyph shown before the title in the top rail (defaults to the brand glyph). */
+    railIcon?: string | undefined;
+    /**
+     * Frame/prompt color override for a special composer mode (e.g. the warn
+     * color while bash mode is active). Defaults to the theme brand colors;
+     * `disabled` still wins with the error color.
+     */
+    accent?: string | undefined;
     /**
      * Right-aligned live status descriptor for the composer's top rail. Renders
      * as an animated {@link ComposerStatusChip} (the thinking word while working,
@@ -83,5 +91,5 @@ export interface KeyEvent {
     fn?: number | undefined;
 }
 export declare const EMPTY_KEY: KeyEvent;
-export declare const Input: React.MemoExoticComponent<({ prompt, value, cursor, disabled, hint, title, status, animationStyle, workingTime, footerHint, hidden, placeholderHeight, onKey, maxWidth, }: InputProps) => React.ReactElement>;
+export declare const Input: React.MemoExoticComponent<({ prompt, value, cursor, disabled, hint, title, railIcon, accent, status, animationStyle, workingTime, footerHint, hidden, placeholderHeight, onKey, maxWidth, }: InputProps) => React.ReactElement>;
 //# sourceMappingURL=input.d.ts.map

package/dist/components/provider-colors.d.ts

@@ -15,7 +15,7 @@ export declare function badgeForKind(kind: 'oauth' | 'api_key' | 'session_token'
     label: string;
     color: string;
 } | undefined;
-/** Colors for the three OAuth kinds shown in the auth panel. */
+/** Brand colors for known OAuth strategies; unknown plugin strategies use the fallback. */
 export declare const OAUTH_KIND_COLORS: Record<string, string>;
 /** Semantic UI colors used across auth / model panels. */
 export declare const UI_COLORS: {

package/dist/components/status-bar-icons.d.ts

@@ -26,6 +26,7 @@ export declare const STATUSLINE_ICONS: {
     readonly processes: string;
     readonly project: string;
     readonly prompt_variant: string;
+    readonly quota: string;
     readonly queue: string;
     readonly sessions: string;
     readonly side_effects: string;

package/dist/components/status-bar-rails-common.d.ts

@@ -1,9 +1,10 @@
-import type { StatuslineDensity } from "@wrongstack/core/statusline";
-import type React from "react";
-import type { AnimationStyle } from "./animation-style.js";
-import type { RailSpanEntry } from "./powerline-rail.js";
-import type { FleetAgentDetail, MailboxStatus, StatusBarProps } from "./status-bar-types.js";
-import type { StatuslineItem } from "./statusline-picker.js";
+import type { StatuslineDensity } from '@wrongstack/core/statusline';
+import type React from 'react';
+import type { ProviderQuotaChip } from '../hooks/use-provider-quota.js';
+import type { AnimationStyle } from './animation-style.js';
+import type { RailSpanEntry } from './powerline-rail.js';
+import type { FleetAgentDetail, MailboxStatus, StatusBarProps } from './status-bar-types.js';
+import type { StatuslineItem } from './statusline-picker.js';
 export interface StatusBarRailBuildParams {
     showChip: (item: StatuslineItem) => boolean;
     /** Resolved density for a chip ('auto' unless the user pinned one). */
@@ -38,6 +39,13 @@ export interface StatusBarRailBuildParams {
     queueCount?: number | undefined;
     hint?: string | undefined;
     breakerCountdown?: StatusBarProps['breakerCountdown'];
+    /**
+     * Most-consumed subscription window across every metered provider, or
+     * undefined until one has reported. Resolved inside `<StatusBar />` from the
+     * provider-neutral quota store, not threaded from app state: the value is
+     * push-driven and belongs to no single session.
+     */
+    quota?: ProviderQuotaChip | undefined;
     projectName?: string | undefined;
     workingDir?: string | undefined;
     git?: StatusBarProps['git'];

package/dist/components/status-bar-rails-safety.d.ts

@@ -1,5 +1,5 @@
-import type { RailSpanEntry } from "./powerline-rail.js";
-import { type StatusBarRailBuildParams } from "./status-bar-rails-common.js";
+import type { RailSpanEntry } from './powerline-rail.js';
+import { type StatusBarRailBuildParams } from './status-bar-rails-common.js';
 /**
  * Standing posture (is this session dangerous? is it throttled?) followed by
  * the work in flight. A reader scans this rail left-to-right to answer

package/dist/history-entry.d.ts

@@ -117,6 +117,13 @@ export type HistoryEntry = {
     ok: boolean;
     input?: unknown | undefined;
     output?: string | undefined;
+    /**
+     * Canonical result text used only for clipboard operations. `output`
+     * belongs to the bounded display cache and may be shortened by history
+     * retention or by the visual renderer; this field must keep the exact
+     * tool_result content that was sent back to the model.
+     */
+    copyOutput?: string | undefined;
     /**
      * SAGE Memory Injector block for this call — `--- SAGE: … ---` header
      * plus one line per injected memory — carried beside `output` because
@@ -136,8 +143,9 @@ export type HistoryEntry = {
      */
     sageStats?: string | undefined;
     /** Full byte length of the result body the model actually received
-     *  (post-cap, post-scrub). Carried separately because `output` is a
-     *  ~400-char preview — `outputBytes` is what the model paid for. */
+     *  (post-cap, post-scrub). Carried separately because rendering and
+     *  display retention may shorten `output`; this is what the model paid
+     *  for. */
     outputBytes?: number | undefined;
     /** ~3.5 chars/token estimate over `outputBytes`. Cheap to render in
      *  the chip; the authoritative count lives in provider.response.usage. */

package/dist/hooks/use-bug-hunt-loop.d.ts

@@ -1,5 +1,5 @@
 import type { Action } from '../app-reducer.js';
-/** Coordinates bounded or user-stopped `/bughunt` rounds in the TUI. */
+/** Coordinates single-round or explicitly bounded `/bughunt` runs in the TUI. */
 export declare function useBugHuntLoop(dispatch: (action: Action) => void, submit: (command: string) => void, historyGen?: number): {
     onBugHuntStarted: (command: string, totalRounds?: number) => void;
     onRunFinished: (status: 'done' | 'aborted' | 'failed' | 'max_iterations') => void;

package/dist/hooks/use-provider-quota.d.ts

@@ -0,0 +1,32 @@
+/**
+ * useProviderQuota — the one quota number a status bar has room for.
+ *
+ * Subscription-metered providers report their remaining plan budget into the
+ * provider-neutral store in `@wrongstack/core/quota`. A statusline chip cannot
+ * show every window of every provider, so this hook reduces the store to the
+ * single reading that would change what the user does next: the most-consumed
+ * window anywhere, with its countdown.
+ *
+ * It subscribes rather than polling. Quota changes only when a request
+ * completes, so a timer would either lag the reading or repaint a quiet
+ * terminal for nothing — and this terminal stays quiet by directive.
+ *
+ * The countdown is deliberately NOT re-rendered every second. A reset is hours
+ * away; ticking it once a second would repaint the whole status bar 3,600 times
+ * to move one digit. The value is recomputed whenever a new reading lands,
+ * which is exactly when it can have meaningfully changed.
+ */
+/** What the chip renders. Absent until some provider has reported. */
+export interface ProviderQuotaChip {
+    /** Provider that reported this window, e.g. `openai-codex`. */
+    providerId: string;
+    /** Window name: `5h`, `7d`, or the provider's own label. */
+    windowLabel: string;
+    usedPercent: number;
+    /** `4h 12m`, when the provider published a reset time. */
+    resetIn?: string | undefined;
+    /** True when this window is the one currently cutting the account off. */
+    reached: boolean;
+}
+export declare function useProviderQuota(): ProviderQuotaChip | undefined;
+//# sourceMappingURL=use-provider-quota.d.ts.map

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export type { Settings } from './app.js';
 export { buildGoalPreamble } from './app.js';
-export type { AuthCatalogRow, AuthFlowIo, AuthFlowResult, AuthKeyEdit, AuthKeyRow, AuthLocalPresetRow, AuthModelEdit, AuthOAuthKind, AuthPanelHost, AuthProviderEdit, AuthProviderRow, AuthProviderSetup, } from './auth-panel-model.js';
+export type { AuthCatalogRow, AuthFlowIo, AuthFlowResult, AuthKeyEdit, AuthKeyRow, AuthLocalPresetRow, AuthModelEdit, AuthOAuthKind, AuthOAuthStrategyRow, AuthPanelHost, AuthProviderEdit, AuthProviderRow, AuthProviderSetup, } from './auth-panel-model.js';
 export type { BrainDenyIsTerminal, BrainHeuristicKey, BrainPanelHeuristics, BrainPanelHost, BrainPanelPersona, BrainPanelSettings, BrainPanelVoter, BrainTerminalPolicyValue, BrainTraceContent, } from './brain-panel-model.js';
 export { replaySessionMessages } from './components/history/replay.js';
 export type { ProviderOption } from './components/model-picker.js';