@wrongstack/tui 1.0.4 → 1.0.5

package/dist/hooks/use-app-environment.d.ts

@@ -0,0 +1,136 @@
+import type { Dispatch } from 'react';
+import React from 'react';
+import type { Action } from '../app-action-type.js';
+import type { AppProps } from '../app-props.js';
+import type { State } from '../app-state.js';
+import type { AppRefSpine } from './use-app-ref-spine.js';
+export interface AppEnvironmentDeps extends Pick<AppProps, 'agent' | 'attachments' | 'configStore' | 'events' | 'memoryStore' | 'model' | 'provider' | 'effectiveMaxContext' | 'yolo' | 'getAutonomy' | 'modeLabel' | 'statuslineHiddenItems' | 'toolCount' | 'getSettings' | 'setStatuslineHiddenItems' | 'saveStatuslineHiddenItems' | 'statuslineLines' | 'titleController' | 'chime' | 'confirmExit' | 'getYolo' | 'getModeLabel' | 'getEternalEngine' | 'getParallelEngine' | 'switchAutonomy' | 'subscribeEternalIteration' | 'subscribeEternalStage' | 'getLiveSessions' | 'mouse' | 'capability' | 'saveSettings'> {
+    state: State;
+    dispatch: Dispatch<Action>;
+    mailboxPanelOpen: boolean;
+    yolo: boolean;
+    chime: NonNullable<AppProps['chime']>;
+    confirmExit: NonNullable<AppProps['confirmExit']>;
+    mouse: NonNullable<AppProps['mouse']>;
+    capability: AppProps['capability'];
+    stateRef: AppRefSpine['stateRef'];
+    builderRef: AppRefSpine['builderRef'];
+    eternalLoopRunningRef: AppRefSpine['eternalLoopRunningRef'];
+    parallelLoopRunningRef: AppRefSpine['parallelLoopRunningRef'];
+    stdout: NodeJS.WriteStream;
+}
+/**
+ * Facade: theme, environment state, live settings, activity display,
+ * layout, mouse/viewport state, and the status sync loop.
+ *
+ * TUI decomposition Phase 4 A2 (docs/decomposition-a0-app-map.md). Owns
+ * useActiveTheme/useThemeState, the useTuiEnvironmentState block, the
+ * lines/densities mirrors, projectRoot/projectName/workingDirChip,
+ * useLiveSettingsState, the sidebar layout derivation (takes
+ * mailboxPanelOpen — the mailbox VM stays with the bridges), the title
+ * sync effect, useTuiActivity (moved from execution — its
+ * refreshGoalSummary feeds the autonomy drivers here), mouse tracking,
+ * history viewport sync, the autonomy drivers + status sync interval
+ * (moved from execution — status sync consumes the driver refs),
+ * statusline hidden/layout syncs, stream chip expiration, git session
+ * status, and settings auto-save.
+ *
+ * Call-order contract: after `useAppState` (needs `state`) and the ref
+ * spine; before consumers of `environment`, layout, mouse, and viewport
+ * state. Fixed and unconditional (behavior contract §0.3 of
+ * docs/decomposition-plan.md).
+ */
+export declare function useAppEnvironment(deps: AppEnvironmentDeps): {
+    environment: {
+        liveModel: string;
+        setLiveModel: (v: string) => void;
+        liveProvider: string;
+        setLiveProvider: (v: string) => void;
+        activeMaxContext: number | undefined;
+        setActiveMaxContext: (v: number | undefined) => void;
+        yoloLive: boolean;
+        setYoloLive: (v: boolean) => void;
+        autonomyLive: import("./use-statusline-state.js").AutonomyStage;
+        setAutonomyLive: (v: import("./use-statusline-state.js").AutonomyStage) => void;
+        liveModeLabel: string;
+        setLiveModeLabel: (v: string) => void;
+        hiddenItems: import("@wrongstack/core/statusline").StatuslineItem[];
+        setHiddenItems: (v: import("@wrongstack/core/statusline").StatuslineItem[]) => void;
+        lines: import("@wrongstack/core/statusline").StatuslineLines;
+        setLines: (v: import("@wrongstack/core/statusline").StatuslineLines) => void;
+        densities: import("@wrongstack/core/statusline").StatuslineDensities;
+        setDensities: (v: import("@wrongstack/core/statusline").StatuslineDensities) => void;
+        sessionCount: number;
+        setSessionCount: (v: number) => void;
+        hiddenItemsRef: React.RefObject<import("@wrongstack/core/statusline").StatuslineItem[]>;
+        memoryContextMonitor: import("../memory-context-monitor.js").MemoryContextMonitorState;
+        setMemoryContextMonitor: Dispatch<React.SetStateAction<import("../memory-context-monitor.js").MemoryContextMonitorState>>;
+        memoryRecordTotal: number | undefined;
+        memoryContextMonitorRef: React.RefObject<import("../memory-context-monitor.js").MemoryContextMonitorState>;
+        memoryRecordTotalRef: React.RefObject<number | undefined>;
+        activeMemoryInContext: number;
+        liveToolCount: number | undefined;
+        setLiveToolCount: Dispatch<React.SetStateAction<number | undefined>>;
+        indexState: {
+            ready: boolean;
+            indexing: boolean;
+            currentFile: number;
+            totalFiles: number;
+            lastError: string | null;
+            server: import("@wrongstack/tools").ProjectIndexServerConnectionState;
+            circuit: import("@wrongstack/tools").CircuitSnapshot;
+        };
+        breakerCountdown: import("@wrongstack/tools").BreakerCountdown | null;
+    };
+    activity: {
+        displayThinkingWord: string;
+        startedAt: number;
+        nowTick: number;
+        setNowTick: Dispatch<React.SetStateAction<number>>;
+        workingTimeMs: number;
+        fleetWorkingTimeMs: number;
+        processMemory: import("@wrongstack/core/utils").HeapSample;
+        cpuPercent: number | undefined;
+        cpuHistory: number[];
+        rssHistory: number[];
+        heapHistory: number[];
+        totalMem: number;
+        enhanceDots: number;
+        refreshGoalSummary: () => void;
+    };
+    refreshGoalSummary: () => void;
+    linesRef: React.RefObject<Partial<Record<import("@wrongstack/core/statusline").StatuslineItem, import("@wrongstack/core/statusline").StatuslineLine>>>;
+    densitiesRef: React.RefObject<Partial<Record<import("@wrongstack/core/statusline").StatuslineItem, import("@wrongstack/core/statusline").StatuslineDensity>>>;
+    projectRoot: string;
+    projectName: string | undefined;
+    workingDirChip: string | undefined;
+    liveSettings: import("../app-settings-type.js").Settings | undefined;
+    liveStatuslineMode: import("../settings-contracts.js").StatuslineMode;
+    liveAnimationStyle: "breathe" | "cycle" | "dots" | "pulse" | "rainbow" | "static" | "wave";
+    liveThinkingWord: string;
+    chimeRef: React.MutableRefObject<boolean>;
+    confirmExitRef: React.MutableRefObject<boolean>;
+    sidebarLayout: import("../app-ui-state.js").SidebarLayoutState;
+    mouseMode: boolean;
+    setMouseMode: (value: boolean) => void;
+    nativeMouse: boolean;
+    setNativeMouse: (value: boolean) => void;
+    bottomRegionRef: React.RefObject<import("ink").DOMElement | null>;
+    statusBarWrapRef: React.RefObject<import("ink").DOMElement | null>;
+    belowStatusBarRef: React.RefObject<import("ink").DOMElement | null>;
+    termRows: number;
+    statusBarRows: number;
+    gitInfo: import("../git-info.js").GitInfo | null;
+    runEternalLoopRef: React.MutableRefObject<() => Promise<void>>;
+    runParallelLoopRef: React.MutableRefObject<() => Promise<void>>;
+    hiddenItems: import("@wrongstack/core/statusline").StatuslineItem[];
+    setHiddenItems: (v: import("@wrongstack/core/statusline").StatuslineItem[]) => void;
+    hiddenItemsRef: React.RefObject<import("@wrongstack/core/statusline").StatuslineItem[]>;
+    setMemoryContextMonitor: Dispatch<React.SetStateAction<import("../memory-context-monitor.js").MemoryContextMonitorState>>;
+    memoryContextMonitorRef: React.RefObject<import("../memory-context-monitor.js").MemoryContextMonitorState>;
+    memoryRecordTotalRef: React.RefObject<number | undefined>;
+    setLiveToolCount: Dispatch<React.SetStateAction<number | undefined>>;
+};
+/** Convenience type: the facade's return (consumed by the App destructure). */
+export type AppEnvironment = ReturnType<typeof useAppEnvironment>;
+//# sourceMappingURL=use-app-environment.d.ts.map

package/dist/hooks/use-app-pipeline-builders.d.ts

@@ -50,6 +50,7 @@ export declare function buildAppPipelineArgs(params: {
     statusBarWrapRef: K['statusBarWrapRef'];
     belowStatusBarRef: K['belowStatusBarRef'];
     statusBarClickMapRef: K['statusBarClickMapRef'];
+    inspectOverlayHeaderRef: K['inspectOverlayHeaderRef'];
     openModelPicker: K['openModelPicker'];
     nextStepsAutoSubmitTimerRef: K['nextStepsAutoSubmitTimerRef'];
     nextStepsAutoSubmitSuggestionRef: K['nextStepsAutoSubmitSuggestionRef'];

package/dist/hooks/use-app-ref-spine.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Facade: every shared ref in App, created exactly once.
+ *
+ * TUI decomposition Phase 4 A1 (docs/decomposition-a0-app-map.md). Owns
+ * the `useAppRuntimeRefs` spine, the history scroll / status-bar click-map
+ * refs, and the enhance runtime refs/countdown state. (The environment
+ * lines/densities mirrors moved to `useAppEnvironment` in A2 — they mirror
+ * environment state the spine does not depend on.)
+ *
+ * Call-order contract: after `useAppState`; before every consumer. Fixed
+ * and unconditional (behavior contract §0.3 of docs/decomposition-plan.md).
+ */
+import type { AppProps } from '../app-props.js';
+import type { State } from '../app-state.js';
+import type { HistoryScrollController } from '../components/scrollable-history.js';
+import type { StatusBarClickMap } from '../components/status-bar-types.js';
+interface AppRefSpineDeps {
+    attachments: AppProps['attachments'];
+    state: State;
+    midRunSendPicker: AppProps['midRunSendPicker'];
+}
+export declare function useAppRefSpine(deps: AppRefSpineDeps): {
+    promptUsageRef: import("react").RefObject<import("@wrongstack/core/storage").PromptUsageStore | null>;
+    builderRef: import("react").RefObject<import("@wrongstack/core/agent").InputBuilder | null>;
+    activeCtrlRef: import("react").RefObject<AbortController | null>;
+    eternalLoopRunningRef: import("react").RefObject<boolean>;
+    parallelLoopRunningRef: import("react").RefObject<boolean>;
+    activeRunSettledRef: import("react").RefObject<Promise<void>>;
+    exitRequestedRef: import("react").RefObject<boolean>;
+    inputGateRef: import("react").RefObject<boolean>;
+    lastEnterAtRef: import("react").RefObject<number>;
+    tokenPreviewsRef: import("react").RefObject<import("../token-previews.js").TokenPreviewStore>;
+    streamingTextRef: import("react").RefObject<string>;
+    streamSegmentsRef: import("react").RefObject<{
+        kind: 'assistant' | 'thinking';
+        text: string;
+    }[]>;
+    pendingDeltaRef: import("react").RefObject<string>;
+    flushTimerRef: import("react").RefObject<NodeJS.Timeout | null>;
+    sessionGenerationRef: import("react").RefObject<number>;
+    activeRunGenerationRef: import("react").RefObject<number>;
+    assistantCommittedThisRunRef: import("react").RefObject<boolean>;
+    stateRef: import("react").RefObject<State>;
+    draftRef: import("react").RefObject<{
+        buffer: string;
+        cursor: number;
+    }>;
+    runBlocksRef: import("react").RefObject<(blocks: import("@wrongstack/core/types").ContentBlock[]) => Promise<void>>;
+    lastEscAtRef: import("react").RefObject<number>;
+    dismissedEscAtRef: import("react").RefObject<number>;
+    submitRef: import("react").RefObject<(text?: string) => void>;
+    enhanceEnabledRef: React.MutableRefObject<boolean>;
+    midRunSendPickerRef: React.MutableRefObject<boolean>;
+    enhanceAbortRef: React.MutableRefObject<AbortController | null>;
+    enhanceCancelledRef: React.MutableRefObject<boolean>;
+    enhanceOriginalRef: React.MutableRefObject<string>;
+    enhanceCountdown: number | null;
+    setEnhanceCountdown: React.Dispatch<React.SetStateAction<number | null>>;
+    enhanceStartedAt: number | null;
+    setEnhanceStartedAt: React.Dispatch<React.SetStateAction<number | null>>;
+    enhanceDurationMs: number | null;
+    setEnhanceDurationMs: React.Dispatch<React.SetStateAction<number | null>>;
+    refineProviderId: string | null;
+    setRefineProviderId: React.Dispatch<React.SetStateAction<string | null>>;
+    refineModel: string | null;
+    setRefineModel: React.Dispatch<React.SetStateAction<string | null>>;
+    historyScrollRef: import("react").RefObject<HistoryScrollController | null>;
+    statusBarClickMapRef: import("react").RefObject<StatusBarClickMap | null>;
+    inspectOverlayHeaderRef: import("react").RefObject<import("ink").DOMElement | null>;
+};
+/** Convenience type: the spine's return (consumed by App destructure). */
+export type AppRefSpine = ReturnType<typeof useAppRefSpine>;
+export {};
+//# sourceMappingURL=use-app-ref-spine.d.ts.map

package/dist/hooks/use-app-state.d.ts

@@ -0,0 +1,20 @@
+import { useAppSessionState } from './use-app-session-state.js';
+/**
+ * Facade: reducer state + dispatch + session todos.
+ *
+ * TUI decomposition Phase 4 A1 (docs/decomposition-a0-app-map.md). Wraps
+ * `useAppSessionState` verbatim and derives the on-screen todo list
+ * (blanked for the length of a `/resume` — see `todosForScreen`).
+ *
+ * Call-order contract: after `useTuiEnvironmentState`, before the ref
+ * spine (`useAppRefSpine`); fixed and unconditional (behavior contract
+ * §0.3 of docs/decomposition-plan.md).
+ */
+export declare function useAppState(deps: Parameters<typeof useAppSessionState>[0]): {
+    state: import("../app-state.js").State;
+    dispatch: import("react").ActionDispatch<[action: import("../app-action-type.js").Action]>;
+    layoutStore: import("../layout-store.js").LayoutStore;
+    sessionTodos: import("@wrongstack/core/agent").TodoItem[];
+    liveTodos: import("@wrongstack/core/agent").TodoItem[];
+};
+//# sourceMappingURL=use-app-state.d.ts.map

package/dist/hooks/use-design-kit-slash-commands.d.ts

@@ -0,0 +1,8 @@
+import type { TuiSlashCommandOptions } from './tui-slash-command-options.js';
+/**
+ * Design-kit-domain slash command (/design), moved verbatim from
+ * useTuiSlashCommands (decomposition Phase 2 — docs/decomposition-plan.md).
+ * Registers at pinned position 4 (tests/slash-registration-enumeration.test.ts).
+ */
+export declare function useDesignKitSlashCommands(deps: TuiSlashCommandOptions): void;
+//# sourceMappingURL=use-design-kit-slash-commands.d.ts.map

package/dist/hooks/use-next-steps-auto-submit.d.ts

@@ -39,6 +39,7 @@ export declare function selectAutoProceedCandidate({ todos, suggestions, autoSug
 export declare function useNextStepsAutoSubmit({ state, autonomyLive, agent, getAutonomy, getSettings, getSuggestions, getAutoSuggestions, getYolo, setSuggestions, autonomyNextPrompt, dispatch, clearDraft, runBlocksRef, }: NextStepsAutoSubmitOptions): {
     nextStepsAutoSubmitCountdown: number | null;
     nextStepsAutoSubmitLabel: string | null;
+    nextStepsAutoSubmitDeadlineMs: number | null;
     setNextStepsAutoSubmitCountdown: Dispatch<SetStateAction<number | null>>;
     setNextStepsAutoSubmitLabel: Dispatch<SetStateAction<string | null>>;
     nextStepsAutoSubmitSuggestionRef: MutableRefObject<string | null>;

package/dist/hooks/use-provider-slash-commands.d.ts

@@ -0,0 +1,13 @@
+import type { TuiSlashCommandOptions } from './tui-slash-command-options.js';
+/**
+ * Provider-domain slash commands (/model, /f), moved verbatim from
+ * useTuiSlashCommands (decomposition Phase 2 — docs/decomposition-plan.md).
+ *
+ * Membership delta recorded per decision D2: /f (the F-key panel picker)
+ * rides in this slice — its position 3 has no dedicated slice among the five
+ * approved domain names, and it sits directly after /model in the pinned
+ * registration order (tests/slash-registration-enumeration.test.ts,
+ * positions 2–3).
+ */
+export declare function useProviderSlashCommands(deps: TuiSlashCommandOptions): void;
+//# sourceMappingURL=use-provider-slash-commands.d.ts.map

package/dist/hooks/use-resource-slash-commands.d.ts

@@ -0,0 +1,11 @@
+import type { TuiSlashCommandOptions } from './tui-slash-command-options.js';
+/**
+ * Resource-domain slash commands (/skill, the seven operational resource-menu
+ * browsers fallback/tier/profile/provider-status/memory/worktree/git, and
+ * cron/prompts), moved verbatim from useTuiSlashCommands (decomposition
+ * Phase 2 — docs/decomposition-plan.md). Registers at pinned positions
+ * 12–21 (tests/slash-registration-enumeration.test.ts), between the session
+ * slice's 'mid' part (10–11) and the settings slice's 'appearance' part (22).
+ */
+export declare function useResourceSlashCommands(deps: TuiSlashCommandOptions): void;
+//# sourceMappingURL=use-resource-slash-commands.d.ts.map

package/dist/hooks/use-session-slash-commands.d.ts

@@ -0,0 +1,17 @@
+import type { TuiSlashCommandOptions } from './tui-slash-command-options.js';
+/** Which slice of the session-domain commands this call registers. */
+export type SessionSlashPart = 'head' | 'mid' | 'tail';
+/**
+ * Session-domain slash commands (/solo, /mailbox, /autonomy, /resume),
+ * moved verbatim from useTuiSlashCommands (decomposition Phase 2 —
+ * docs/decomposition-plan.md).
+ *
+ * `part` selects which slice of the domain registers at this call site, so
+ * the parent can interleave the domains and preserve the pinned 23-command
+ * registration order (tests/slash-registration-enumeration.test.ts):
+ * 'head' → /solo (position 1), 'mid' → /mailbox + /autonomy (10–11),
+ * 'tail' → /resume (23). `part` is a constant literal per call site, so
+ * hook order is stable; non-selected parts return early without registering.
+ */
+export declare function useSessionSlashCommands(deps: TuiSlashCommandOptions, part: SessionSlashPart): void;
+//# sourceMappingURL=use-session-slash-commands.d.ts.map

package/dist/hooks/use-settings-slash-commands.d.ts

@@ -0,0 +1,22 @@
+import type { TuiSlashCommandOptions } from './tui-slash-command-options.js';
+/** Which slice of the settings-domain commands this call registers. */
+export type SettingsSlashPart = 'core' | 'appearance';
+/**
+ * Settings-domain slash commands (/settings, /settings-get, /statusline,
+ * /lite, /full, /theme), moved verbatim from useTuiSlashCommands
+ * (decomposition Phase 2 — docs/decomposition-plan.md).
+ *
+ * `part` selects which slice of the domain registers at this call site, so
+ * the parent can interleave the domains and preserve the pinned 23-command
+ * registration order (tests/slash-registration-enumeration.test.ts):
+ * 'core' → /settings, /settings-get, /statusline, /lite, /full (positions
+ * 5–9), 'appearance' → /theme (position 22). `part` is a constant literal
+ * per call site, so hook order is stable; non-selected parts return early
+ * without registering.
+ *
+ * Membership delta recorded per decision D2: /theme rides with this slice
+ * (settings-adjacent appearance command; position 22 sits inside the
+ * resource run, but the resource slice's last member is /prompts at 21).
+ */
+export declare function useSettingsSlashCommands(deps: TuiSlashCommandOptions, part: SettingsSlashPart): void;
+//# sourceMappingURL=use-settings-slash-commands.d.ts.map

package/dist/hooks/use-tui-slash-commands.d.ts

@@ -1,32 +1,5 @@
-import { type Dispatch, type MutableRefObject, type SetStateAction } from 'react';
-import type { Action } from '../app-action-type.js';
-import type { AppProps } from '../app-props.js';
-import type { State } from '../app-state.js';
-import { type StatuslineItem } from '../components/statusline-picker.js';
-interface TuiSlashCommandOptions {
-    slashRegistry: AppProps['slashRegistry'];
-    skillLoader: AppProps['skillLoader'];
-    getResourceMenu: AppProps['getResourceMenu'];
-    getPickableProviders: AppProps['getPickableProviders'];
-    switchProviderAndModel: AppProps['switchProviderAndModel'];
-    openModelPicker: () => Promise<void>;
-    openFKeyPicker: () => void;
-    projectRoot: string;
-    agent: AppProps['agent'];
-    dispatch: Dispatch<Action>;
-    getSettings: AppProps['getSettings'];
-    saveSettings: AppProps['saveSettings'];
-    openSettings: () => void;
-    state: State;
-    openStatuslinePicker: () => void;
-    setHiddenItems: (items: StatuslineItem[]) => void;
-    hiddenItemsRef: MutableRefObject<StatuslineItem[]>;
-    setMailboxPanelOpen: Dispatch<SetStateAction<boolean>>;
-    switchAutonomy: AppProps['switchAutonomy'];
-    listSessions: AppProps['listSessions'];
-    openPromptPicker: () => Promise<void>;
-}
+import type { TuiSlashCommandOptions } from './tui-slash-command-options.js';
+export type { TuiSlashCommandOptions } from './tui-slash-command-options.js';
 /** Registers TUI-owned slash commands and releases them on dependency changes. */
 export declare function useTuiSlashCommands({ slashRegistry, skillLoader, getResourceMenu, getPickableProviders, switchProviderAndModel, openModelPicker, openFKeyPicker, projectRoot, agent, dispatch, getSettings, saveSettings, openSettings, state, openStatuslinePicker, setHiddenItems, hiddenItemsRef, setMailboxPanelOpen, switchAutonomy, listSessions, openPromptPicker, }: TuiSlashCommandOptions): void;
-export {};
 //# sourceMappingURL=use-tui-slash-commands.d.ts.map