@wrongstack/tui 1.0.17 → 1.0.24

package/dist/components/tools-picker.d.ts

@@ -11,12 +11,14 @@ export interface ToolPickerItem {
     description: string;
 }
 interface ToolsPickerProps {
+    maxRows?: number | undefined;
+    columns?: number | undefined;
     items: ToolPickerItem[];
     selected: number;
     busy?: boolean | undefined;
     hint?: string | undefined;
     filter?: string | undefined;
 }
-export declare function ToolsPicker({ items, selected, busy, hint, filter, }: ToolsPickerProps): React.ReactElement;
+export declare function ToolsPicker({ items, selected, busy, hint, filter, maxRows, columns, }: ToolsPickerProps): React.ReactElement;
 export {};
 //# sourceMappingURL=tools-picker.d.ts.map

package/dist/components/user-input-prompt.d.ts

@@ -14,9 +14,11 @@ type AnswerDraft = {
 };
 type Draft = Record<string, AnswerDraft>;
 export declare function usePendingUserInput(events: EventBus): PendingUserInput | null;
-export declare function UserInputPrompt({ pending }: {
+interface UserInputPromptProps {
     pending: PendingUserInput;
-}): React.ReactElement;
+    onInterrupt?: (() => void) | undefined;
+}
+export declare function UserInputPrompt(props: UserInputPromptProps): React.ReactElement;
 export declare function initialDraft(request: UserInputRequest): Draft;
 export declare function validateDraft(questions: UserInputQuestion[], draft: Draft): {
     valid: boolean;

package/dist/connection-actions.d.ts

@@ -0,0 +1,20 @@
+import type { ConnectionHealthServiceId } from './connections-health.js';
+export interface ConnectionActionResult {
+    serviceId: ConnectionHealthServiceId;
+    action: 'shutdown' | 'restart';
+    success: boolean;
+    message: string;
+}
+export declare const RESTARTABLE_SERVICES: readonly ConnectionHealthServiceId[];
+export declare function isRestartableService(serviceId: ConnectionHealthServiceId): boolean;
+export declare function isEndpointAlive(endpoint: string): Promise<boolean>;
+export declare function waitForShutdown(probe?: () => Promise<boolean> | boolean): Promise<void>;
+export declare function executeConnectionAction(serviceId: ConnectionHealthServiceId, action: 'shutdown' | 'restart', projectRoot: string, indexDir?: string | undefined): Promise<ConnectionActionResult>;
+export declare function restartAllConnectionServices(projectRoot: string, indexDir?: string | undefined): Promise<ConnectionActionResult[]>;
+export declare function killSessionCatalogServer(projectRoot: string, action: 'shutdown' | 'restart'): Promise<ConnectionActionResult>;
+export declare function killKanbanServer(projectRoot: string, action: 'shutdown' | 'restart'): Promise<ConnectionActionResult>;
+export declare function killSageServer(projectRoot: string, action: 'shutdown' | 'restart'): Promise<ConnectionActionResult>;
+export declare function killChronicleServer(projectRoot: string, action: 'shutdown' | 'restart'): Promise<ConnectionActionResult>;
+export declare function killCodebaseIndexServer(projectRoot: string, indexDir: string | undefined, action: 'shutdown' | 'restart'): Promise<ConnectionActionResult>;
+export declare function killMailboxServer(projectRoot: string, action: 'shutdown' | 'restart'): Promise<ConnectionActionResult>;
+//# sourceMappingURL=connection-actions.d.ts.map

package/dist/connections-health.d.ts

@@ -9,8 +9,9 @@
  * `@wrongstack/tools`).
  */
 export type ConnectionHealthStatus = 'healthy' | 'degraded' | 'offline' | 'unavailable' | 'error';
+export type ConnectionHealthServiceId = 'session-catalog' | 'chronicle' | 'codebase-index' | 'sage' | 'kanban' | 'mailbox' | 'governance';
 export interface ConnectionHealthService {
-    id: 'chronicle' | 'codebase-index' | 'sage' | 'kanban' | 'mailbox';
+    id: ConnectionHealthServiceId;
     label: string;
     status: ConnectionHealthStatus;
     required: boolean;
@@ -29,6 +30,12 @@ export interface ConnectionHealthService {
         watchedFiles?: number | undefined;
     } | undefined;
     lastError?: string | undefined;
+    control?: 'restart' | 'none' | undefined;
+    advisory?: {
+        code: string;
+        operatorAction: string;
+        executionDisposition: string;
+    } | undefined;
 }
 export interface ConnectionsHealthReport {
     checkedAt: number;

package/dist/esc-close-panels.d.ts

@@ -14,7 +14,6 @@
  *
  * Excluded panels (own their own Esc):
  *  - worktreeMonitor  — `isWorktreeMonitorCloseKey` in WorktreeMonitor.tsx
- *  - goalRun monitor — PhaseMonitor owns Esc via its own useInput
  *  - kanbanPanel       — `key.escape || 'q' → onClose` in KanbanPanel.tsx
  *  - goalKanbanPanel   — `key.escape || 'q' → onClose` in GoalKanbanPanel.tsx
  *

package/dist/f-key-panels.d.ts

@@ -1,5 +1,9 @@
 import type { Action } from './app-action-type.js';
+import type { State } from './app-state.js';
 import type { StatuslineItem } from './components/statusline-picker.js';
+import type { PanelPositionMap } from './ui-contracts.js';
+/** The bottom panel owns input; sidebar twins leave the composer available. */
+export declare function activeBottomFKeyPanel(state: State, positions: PanelPositionMap): number | null;
 export type FKeyPanelAction = 'projectPickerOpen' | 'toggleMonitor' | 'toggleAgentsMonitor' | 'toggleWorktreeMonitor' | 'togglePlanPanel' | 'toggleTodosMonitor' | 'toggleQueuePanel' | 'toggleProcessList' | 'toggleKanbanPanel' | 'toggleGoalPanel' | 'toggleSessionsPanel' | 'toggleCoordinatorMonitor' | 'toggleCronMonitor' | 'toggleConnectionsPanel' | 'statuslineOpen';
 /** Host-side action keys that require work beyond a reducer dispatch. */
 type FKeyHostAction = 'openProjectPicker' | 'loadLiveSessions' | 'openStatuslinePicker';

package/dist/hooks/use-active-theme.d.ts

@@ -4,7 +4,8 @@ import { type Theme } from '../theme.js';
  * current `theme` snapshot. Used by the App shell to force a re-render
  * when `setActiveTheme()` mutates the global theme — child components
  * read `theme` directly via destructuring, so the parent re-render
- * propagates the new palette into the whole tree.
+ * propagates the new palette into ordinary children. Memoized boundaries
+ * subscribe separately: unchanged props must not keep an old palette alive.
  *
  * The hook itself returns the live `theme` reference; callers don't
  * typically need to use it (they can keep reading `theme` directly),

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

@@ -46,7 +46,7 @@ export declare function useAppPanelsState(params: {
     brainCtl: import("./use-brain-panel.js").BrainPanelController;
     openBrainPanel: () => void;
     changeBrainRisk: (delta: number) => void;
-    openShadowPanel: () => void;
+    openShadowPanel: () => boolean;
     handleShadowStart: () => Promise<void>;
     handleShadowStop: () => Promise<void>;
     subagentModelsCtl: import("./use-subagent-models-panel.js").SubagentModelsPanelController;

package/dist/hooks/use-app-picker-keys.d.ts

@@ -11,6 +11,7 @@ import type { usePanelControllers } from './use-panel-controllers.js';
 import type { useStatusbarViewModel } from './use-statusbar-view-model.js';
 import type { useTuiEnvironmentState } from './use-tui-environment-state.js';
 interface UseAppPickerKeysOptions {
+    sessionGenerationRef?: MutableRefObject<number> | undefined;
     host: AppProps;
     state: State;
     dispatch: Dispatch<Action>;
@@ -36,6 +37,6 @@ interface UseAppPickerKeysOptions {
     onThemePickerEnter?: () => void;
     setPromptFavorite: (slug: string, favorite: boolean) => Promise<void>;
 }
-export declare function useAppPickerKeys({ host, state, dispatch, environment, statusbar, panelControllers, authPanelController, brainController, lastEnterAtRef, inputGateRef, submitRef, promptUsageRef, setDraft, acceptSlashPickerSelection, changeBrainRisk, handleModelPicked, handleShadowStart, handleShadowStop, subagentModelsController, statuslineHiddenForPicker, onPickerEnter, onThemePickerEnter, setPromptFavorite, }: UseAppPickerKeysOptions): (input: string, key: import("../components/input.js").KeyEvent, isEnter: boolean) => boolean;
+export declare function useAppPickerKeys({ sessionGenerationRef, host, state, dispatch, environment, statusbar, panelControllers, authPanelController, brainController, lastEnterAtRef, inputGateRef, submitRef, promptUsageRef, setDraft, acceptSlashPickerSelection, changeBrainRisk, handleModelPicked, handleShadowStart, handleShadowStop, subagentModelsController, statuslineHiddenForPicker, onPickerEnter, onThemePickerEnter, setPromptFavorite, }: UseAppPickerKeysOptions): (input: string, key: import("../components/input.js").KeyEvent, isEnter: boolean) => boolean;
 export {};
 //# sourceMappingURL=use-app-picker-keys.d.ts.map

package/dist/hooks/use-fleet-generation-gate.d.ts

@@ -3,9 +3,10 @@
  *
  * Fleet event bridges must discard events from subagents that were spawned
  * before the last `/clear`. This shared hook encapsulates that logic so any
- * bridge can apply it consistently. Currently consumed by
- * `useDirectorFleetBridge` (Director FleetBus streaming); `useSubagentEvents`
- * (EventBus lifecycle) does not gate on generation today.
+ * bridge can apply it consistently. Both consumers wire it: `useDirectorFleetBridge`
+ * (Director FleetBus streaming) and `useSubagentEvents` (EventBus lifecycle —
+ * instantiated at use-subagent-events.ts:126, `gate.track` on spawn, `gate.isLive`
+ * on every subagent event handler, `gate.forget` on removal).
  *
  * Usage:
  * ```ts

package/dist/hooks/use-panel-controllers.d.ts

@@ -14,7 +14,7 @@ interface PanelControllersOptions {
     openAuthPanel: (view?: 'list' | 'oauth') => boolean;
     openModePicker: () => void | Promise<void>;
     openBrainPanel: () => void | Promise<void>;
-    openShadowPanel: () => void | Promise<void>;
+    openShadowPanel: () => void | boolean;
     /** Opens the `/subagent-models` lane panel; omitted when the host wires no plan. */
     openSubagentModelsPanel?: (() => void) | undefined;
     openHelpPanel: () => void | Promise<void>;

package/dist/hooks/use-picker-keys-types.d.ts

@@ -43,6 +43,7 @@ export interface PickerKeysHost {
     onResumePickerEnter: (() => Promise<void>) | undefined;
     onSessionsPanelEnter: (() => Promise<void>) | undefined;
     onProjectPickerEnter: (() => Promise<void>) | undefined;
+    onSkillMentionPick?: ((name: string) => void) | undefined;
     onSlashPickerEnter: (() => void) | undefined;
     onSettingsPickerEnter: (() => void) | undefined;
     onPluginPickerToggle: (() => Promise<void> | void) | undefined;

package/dist/hooks/use-shadow-panel.d.ts

@@ -10,7 +10,7 @@ interface ShadowPanelHost {
     onShadowStop?: (() => Promise<string | undefined>) | undefined;
 }
 export declare function useShadowPanel(dispatch: React.Dispatch<Action>, host: ShadowPanelHost): {
-    openShadowPanel: () => void;
+    openShadowPanel: () => boolean;
     handleShadowStart: () => Promise<void>;
     handleShadowStop: () => Promise<void>;
 };

package/dist/hooks/use-sidebar-panel-data.d.ts

@@ -9,10 +9,10 @@
  * Each hook is self-contained: it manages its own refresh interval and
  * cleanup. The hooks must be called unconditionally (rules of hooks), but
  * polling is gated by the `enabled` flag — app-view passes whether the
- * twin currently occupies a visible sidebar slot. While a panel is closed
- * or routed to the bottom region no polling runs (the bottom panels run
- * their own polling when open), so the session pays no IPC probes or disk
- * reads for panels nobody is looking at. Each hook performs an immediate
+ * twin currently occupies a visible sidebar slot. Connections also supplies
+ * the persistent icon strip, so it polls whenever the sidebar is visible.
+ * Hidden surfaces do not poll (bottom panels run their own polling when open).
+ * Each hook performs an immediate
  * first read when enabled, so data is fresh the moment the twin mounts.
  */
 interface SidebarProcess {
@@ -30,7 +30,9 @@ export declare function useSidebarProcessList(enabled?: boolean): {
     totalCount: number;
     processes: readonly SidebarProcess[];
 };
-interface SidebarConnection {
+export interface SidebarConnection {
+    id?: import('../connections-health.js').ConnectionHealthServiceId | undefined;
+    healthStatus?: import('../connections-health.js').ConnectionHealthStatus | undefined;
     name: string;
     status: 'ok' | 'warn' | 'down' | 'unknown';
     latencyMs?: number | undefined;

package/dist/hooks/use-skill-mention-picker.d.ts

@@ -0,0 +1,6 @@
+import type { SkillLoader } from '@wrongstack/core/types';
+import { type Dispatch } from 'react';
+import type { Action } from '../app-action-type.js';
+import type { State } from '../app-state.js';
+export declare function useSkillMentionPicker(state: State, loader: SkillLoader | undefined, dispatch: Dispatch<Action>): void;
+//# sourceMappingURL=use-skill-mention-picker.d.ts.map

package/dist/hooks/use-statusbar-view-model.d.ts

@@ -34,12 +34,12 @@ interface StatusbarViewModelOptions {
      */
     tokenRefresh?: TokenRefreshData;
 }
-interface PlanCounts {
+export interface PlanCounts {
     open: number;
     inProgress: number;
     done: number;
 }
-interface TaskCounts {
+export interface TaskCounts {
     pending: number;
     inProgress: number;
     completed: number;

package/dist/hooks/use-windowed-picker.d.ts

@@ -61,7 +61,7 @@ export interface UseWindowedPickerOptions {
      * 24-row terminal even when the input bar or status bar grows.
      */
     readonly maxRows?: number | undefined;
-    /** Minimum visible options even on a tiny terminal. Defaults to 3. */
+    /** Legacy minimum without a measured maxRows budget. Defaults to 3. */
     readonly minVisible?: number | undefined;
 }
 export interface WindowedPickerSlice {
@@ -82,9 +82,8 @@ export interface WindowedPickerSlice {
  * Behavior contract:
  *   - Visible count is `floor((available - chrome - markers) / rowSpan)`
  *     where `available` is either `maxRows` (measured) or
- *     `rows - shellReservedRows` (guessed), clamped to `[minVisible, total]`.
- *     A 1-row terminal always shows at least `minVisible` options even if
- *     that overflows — better to bleed than to hide the focused row.
+ *     `rows - shellReservedRows` (guessed). Measured budgets show at least
+ *     one focused option; only the legacy guessed budget uses minVisible.
  *   - The window stays centered on `selected` once the picker is past the
  *     first page; on the first page it stays top-aligned so the user sees
  *     the list start. `selected < 0 || selected >= total` is treated as no