@sayknow-cli/coding-agent 0.4.1 → 0.4.3

package/dist/types/modes/components/plugin-settings.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Plugin settings UI components.
+ *
+ * Provides a hierarchical settings interface:
+ * - Plugin list (shows all installed plugins)
+ *   - Plugin detail (enable/disable, features, config)
+ *     - Feature toggles
+ *     - Config value editor
+ */
+import { Container } from "@sayknow-cli/tui";
+import { PluginManager } from "../../extensibility/plugins/manager";
+import type { InstalledPlugin } from "../../extensibility/plugins/types";
+/**
+ * Forwards a keystroke to `input`, but cancels via `onCancel` when the user presses Escape.
+ */
+export declare function handleInputOrEscape(data: string, input: {
+    handleInput(data: string): void;
+}, onCancel: () => void): void;
+export interface PluginListCallbacks {
+    onPluginSelect: (plugin: InstalledPlugin) => void;
+    onCancel: () => void;
+}
+/**
+ * Shows list of installed plugins with enable/disable status.
+ * Selecting a plugin opens its detail view.
+ */
+export declare class PluginListComponent extends Container {
+    #private;
+    private readonly plugins;
+    constructor(plugins: InstalledPlugin[], callbacks: PluginListCallbacks);
+    handleInput(data: string): void;
+}
+export interface PluginDetailCallbacks {
+    onEnabledChange: (enabled: boolean) => void;
+    onFeatureChange: (feature: string, enabled: boolean) => void;
+    onConfigChange: (key: string, value: unknown) => void;
+    onBack: () => void;
+}
+/**
+ * Shows detail settings for a single plugin:
+ * - Enable/disable toggle
+ * - Feature toggles
+ * - Config settings
+ */
+export declare class PluginDetailComponent extends Container {
+    #private;
+    private plugin;
+    private readonly manager;
+    private readonly callbacks;
+    constructor(plugin: InstalledPlugin, manager: PluginManager, callbacks: PluginDetailCallbacks);
+    handleInput(data: string): void;
+}
+export interface PluginSettingsCallbacks {
+    onClose: () => void;
+    onPluginChanged: () => void;
+}
+/**
+ * Top-level plugin settings component.
+ * Manages navigation between plugin list and plugin detail views.
+ */
+export declare class PluginSettingsComponent extends Container {
+    #private;
+    private readonly callbacks;
+    constructor(cwd: string, callbacks: PluginSettingsCallbacks);
+    handleInput(data: string): void;
+}

package/dist/types/modes/components/provider-onboarding-selector.d.ts

@@ -0,0 +1,7 @@
+import { Container } from "@sayknow-cli/tui";
+export type ProviderOnboardingAction = "custom-provider-wizard" | "oauth-login" | "import-credentials" | "api-guide";
+export declare class ProviderOnboardingSelectorComponent extends Container {
+    #private;
+    constructor(onSelect: (action: ProviderOnboardingAction) => void, onCancel: () => void);
+    handleInput(keyData: string): void;
+}

package/dist/types/modes/components/queue-mode-selector.d.ts

@@ -0,0 +1,9 @@
+import { Container, type SelectList } from "@sayknow-cli/tui";
+/**
+ * Component that renders a queue mode selector with borders
+ */
+export declare class QueueModeSelectorComponent extends Container {
+    #private;
+    constructor(currentMode: "all" | "one-at-a-time", onSelect: (mode: "all" | "one-at-a-time") => void, onCancel: () => void);
+    getSelectList(): SelectList;
+}

package/dist/types/modes/components/queue-pane.d.ts

@@ -0,0 +1,12 @@
+import { Container } from "@sayknow-cli/tui";
+import type { QueuedMessageEditEntry } from "../../session/agent-session";
+export declare class QueuePaneComponent extends Container {
+    #private;
+    constructor(entries: QueuedMessageEditEntry[], options: {
+        selectedIndex?: number;
+        onDelete: (entry: QueuedMessageEditEntry, index: number) => void;
+        onMove: (entry: QueuedMessageEditEntry, index: number, direction: "up" | "down") => void;
+        onClose: () => void;
+    });
+    handleInput(keyData: string): void;
+}

package/dist/types/modes/components/queued-message-selector.d.ts

@@ -0,0 +1,12 @@
+import { Container, SelectList } from "@sayknow-cli/tui";
+import type { QueuedMessageEditEntry } from "../../session/agent-session";
+type QueuedMessageMoveDirection = "up" | "down";
+export type { QueuedMessageMoveDirection };
+export declare class QueuedMessageSelectorComponent extends Container {
+    #private;
+    constructor(entries: QueuedMessageEditEntry[], onSelect: (entry: QueuedMessageEditEntry) => void, onDelete: (entry: QueuedMessageEditEntry, selectedIndex: number) => void, onMove: (entry: QueuedMessageEditEntry, selectedIndex: number, direction: QueuedMessageMoveDirection) => void, onCancel: () => void, options?: {
+        selectedIndex?: number;
+    });
+    handleInput(keyData: string): void;
+    getSelectList(): SelectList;
+}

package/dist/types/modes/components/read-tool-group.d.ts

@@ -0,0 +1,36 @@
+import type { Component } from "@sayknow-cli/tui";
+import { Container } from "@sayknow-cli/tui";
+import type { ToolExecutionHandle } from "./tool-execution";
+export declare function readArgsHaveTarget(args: unknown): boolean;
+export declare function readArgsTargetInternalUrl(args: unknown): boolean;
+type ReadRenderArgs = {
+    path?: string;
+    file_path?: string;
+    sel?: string;
+};
+type ReadToolGroupOptions = {
+    showContentPreview?: boolean;
+};
+export declare class ReadToolGroupComponent extends Container implements ToolExecutionHandle {
+    #private;
+    constructor(options?: ReadToolGroupOptions);
+    updateArgs(args: ReadRenderArgs, toolCallId?: string): void;
+    updateResult(result: {
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+        details?: unknown;
+        isError?: boolean;
+    }, isPartial?: boolean, toolCallId?: string): void;
+    setArgsComplete(_toolCallId?: string): void;
+    /** Applies automatic expansion unless this renderer instance has an explicit fold choice. */
+    setExpanded(expanded: boolean): void;
+    /**
+     * Applies and pins an explicit fold choice for this renderer instance only.
+     * Transcript rebuilds recreate components from global state and drop this pin.
+     */
+    setManuallyExpanded(expanded: boolean): void;
+    getComponent(): Component;
+}
+export {};

package/dist/types/modes/components/runtime-mcp-add-wizard.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MCP Add Wizard Component
+ *
+ * Interactive multi-step wizard for adding MCP servers.
+ */
+import { Container } from "@sayknow-cli/tui";
+import type { MCPServerConfig } from "../../runtime-mcp/types";
+type Scope = "user" | "project";
+/**
+ * Result of the wizard's OAuth callback. `credentialId` is mandatory;
+ * `clientId`/`clientSecret` are populated when the OAuth provider performed
+ * dynamic client registration (or when the caller pre-supplied them) so the
+ * wizard can fold them into the final `mcp.json` entry for refresh.
+ */
+export interface MCPAddWizardOAuthResult {
+    credentialId: string;
+    clientId?: string;
+    clientSecret?: string;
+}
+export declare class MCPAddWizard extends Container {
+    #private;
+    constructor(onComplete: (name: string, config: MCPServerConfig, scope: Scope) => void, onCancel: () => void, onOAuth?: (authUrl: string, tokenUrl: string, clientId: string, clientSecret: string, scopes: string) => Promise<MCPAddWizardOAuthResult>, onTestConnection?: (config: MCPServerConfig) => Promise<void>, onRender?: () => void, initialName?: string);
+    dispose(): void;
+    handleInput(keyData: string): void;
+}
+export {};

package/dist/types/modes/components/sayknow-pet-widget.d.ts

@@ -0,0 +1,60 @@
+import { type Component, type Container, type PetMode, type PetSkinId, type TUI } from "@sayknow-cli/tui";
+import type { CustomEditor } from "./custom-editor";
+/** Re-exported from the tui skin registry so widget-relative imports stay valid. */
+export type { PetMode, PetSkinId };
+/**
+ * Wraps the composer editor, reserving a right-side area beside it where the
+ * real-pixel pet is drawn. The editor just renders narrower; the pet pixels
+ * are emitted separately as an absolute-positioned overlay.
+ */
+export declare class PetFramedEditor implements Component {
+    #private;
+    constructor(editor: CustomEditor);
+    setReserve(columns: number): void;
+    canFit(width: number): boolean;
+    invalidate(): void;
+    render(width: number): string[];
+}
+/**
+ * The sayknow pet: a 16x16 real-pixel sprite living in a reserved area beside
+ * the composer. It is nearest-neighbor scaled to the two terminal rows occupied
+ * by an empty one-line composer and lifted one row so its feet meet the input
+ * box's bottom edge.
+ *
+ * Rendering has two paths that share one payload builder:
+ * - a post-render emitter re-draws the sprite after every TUI write (line
+ *   renders clear the pet cells, so the overlay must be re-applied), and
+ * - frame advances write the payload directly to the terminal, because the
+ *   TUI skips writes entirely when no component line changed.
+ *
+ * Requires a sixel- or kitty-graphics terminal (`pixelProtocol()`).
+ */
+export declare class SayknowPetWidget {
+    #private;
+    constructor(options: {
+        ui: TUI;
+        editor: CustomEditor;
+        editorContainer: Container;
+        floorContainer: Container;
+        isWorking: () => boolean;
+        /** Rows rendered below the composer box (pet floor + hook widgets). */
+        getComposerBottomOffset: () => number;
+        forcePixelProtocol?: "sixel" | "kitty";
+        /** Random [min, max] ms between auto-flexes; null disables. */
+        autoFlexGapMs?: [number, number] | null;
+    });
+    /** Protocol available for the real-pixel pet, if any. */
+    static pixelProtocol(): "sixel" | "kitty" | null;
+    get mode(): PetMode;
+    get isFlexing(): boolean;
+    setMode(mode: PetMode): void;
+    /** Live preview during a selector: change the sprite without re-mounting the
+     *  composer editor (that would tear down the open overlay). After a short idle
+     *  eye-roll it fires the signature burst once (RedSayknow flex, BlueSayknow para-para
+     *  then sob) so the selector demos the animation instead of waiting the random gap. */
+    previewMode(mode: PetMode): void;
+    commitPreviewMode(mode: PetMode): void;
+    dispose(): void;
+    /** Re-mount the composer editor (framed when a skin is active) after an overlay. */
+    remountComposer(): void;
+}

package/dist/types/modes/components/session-observer-overlay.d.ts

@@ -0,0 +1,12 @@
+import type { KeyId } from "../../config/keybindings";
+import type { SessionMessageEntry } from "../../session/session-manager";
+import type { SessionObserverRegistry } from "../session-observer-registry";
+import { type TranscriptViewerEntry, TranscriptViewerOverlay } from "./transcript-viewer-overlay";
+/** Session-observer adapter. The shared viewer owns navigation and fold state. */
+export declare class SessionObserverOverlayComponent extends TranscriptViewerOverlay {
+    #private;
+    constructor(registry: SessionObserverRegistry, onDone: () => void, observeKeys: KeyId[]);
+    refreshFromRegistry(): void;
+    handleInput(keyData: string): void;
+}
+export declare function entriesFromMessages(entries: readonly SessionMessageEntry[]): TranscriptViewerEntry[];

package/dist/types/modes/components/session-selector.d.ts

@@ -0,0 +1,43 @@
+import { type Component, Container } from "@sayknow-cli/tui";
+import type { ResumeSessionIdentity, ResumeTailInspection, SessionInfo } from "../../session/session-manager";
+export interface SelectedSession {
+    kind: "selected";
+    path: string;
+    identity: ResumeSessionIdentity;
+    action: "continue-tail" | "open-idle";
+}
+export interface CancelledSessionSelection {
+    kind: "cancelled";
+}
+export type SessionSelectionResult = SelectedSession | CancelledSessionSelection;
+export type SessionInspector = (sessionPath: string) => Promise<ResumeTailInspection>;
+declare class SessionList implements Component {
+    #private;
+    private readonly allSessions;
+    private readonly showCwd;
+    onSelect?: (session: SessionInfo) => void;
+    onCancel?: () => void;
+    onExit: () => void;
+    onDeleteRequest?: (session: SessionInfo) => void;
+    constructor(allSessions: SessionInfo[], showCwd?: boolean);
+    setInputFrozen(frozen: boolean): void;
+    removeSession(sessionPath: string): void;
+    invalidate(): void;
+    render(width: number): string[];
+    handleInput(keyData: string): void;
+}
+/** A one-shot resume consent selector. It never opens or mutates sessions. */
+export declare class SessionSelectorComponent extends Container {
+    #private;
+    private readonly onSelect;
+    private readonly onCancel;
+    private readonly onExit;
+    private readonly onDelete?;
+    private readonly inspector?;
+    private readonly onSelection?;
+    constructor(sessions: SessionInfo[], onSelect: (sessionPath: string) => void, onCancel: () => void, onExit: () => void, onDelete?: ((session: SessionInfo) => Promise<boolean>) | undefined, inspector?: SessionInspector | undefined, onSelection?: ((selection: SessionSelectionResult) => void) | undefined);
+    setOnRequestRender(callback: () => void): void;
+    handleInput(keyData: string): void;
+    getSessionList(): SessionList;
+}
+export {};

package/dist/types/modes/components/sessions-dashboard.d.ts

@@ -0,0 +1,32 @@
+import { Container } from "@sayknow-cli/tui";
+import type { SessionInfo } from "../../session/session-manager";
+export type SessionLiveness = "active" | "stale" | "unknown";
+export interface DashboardSession {
+    id: string;
+    cwd: string;
+    title: string;
+    modified: Date;
+    messageCount: number;
+    messageCountIsEstimate?: boolean;
+    liveness: SessionLiveness;
+}
+/**
+ * Reads the opt-in presence sidecar beside a session transcript. A missing or
+ * malformed sidecar deliberately means unknown: transcript modification time is
+ * not a process-liveness signal.
+ */
+export declare function sessionLivenessFromPresence(sessionPath: string, readFile?: (filePath: string) => string, now?: number): SessionLiveness;
+export declare function dashboardSessions(sessions: readonly SessionInfo[], options?: {
+    readFile?: (filePath: string) => string;
+    now?: number;
+}): DashboardSession[];
+/** Read-only top-level inventory. This component never opens, resumes, or mutates a session. */
+export declare class SessionsDashboardComponent extends Container {
+    #private;
+    private readonly sessions;
+    private readonly onClose;
+    private readonly requestRender?;
+    constructor(sessions: readonly DashboardSession[], onClose: () => void, requestRender?: (() => void) | undefined);
+    render(width: number): string[];
+    handleInput(keyData: string): void;
+}

package/dist/types/modes/components/settings-defs.d.ts

@@ -0,0 +1,50 @@
+/**
+ * UI adapter over the schema. Reads `ui.options` declared inline in
+ * settings-schema.ts and produces typed widget definitions for the
+ * settings selector.
+ *
+ * To add a new setting to the UI: declare it in `settings-schema.ts`
+ * with a `ui` block. If it needs a submenu, include `options: [...]`
+ * (or `options: "runtime"` for runtime-injected lists like themes).
+ */
+import { type SettingPath, type SettingTab, type SubmenuOption } from "../../config/settings-schema";
+export type SettingValue = boolean | string;
+interface BaseSettingDef {
+    path: SettingPath;
+    label: string;
+    description: string;
+    tab: SettingTab;
+    /**
+     * Optional visibility predicate. When supplied and returning false, the
+     * setting is hidden from the UI. Applies to every variant — booleans,
+     * enums, submenus, and text inputs.
+     */
+    condition?: () => boolean;
+}
+export interface BooleanSettingDef extends BaseSettingDef {
+    type: "boolean";
+}
+export interface EnumSettingDef extends BaseSettingDef {
+    type: "enum";
+    values: readonly string[];
+}
+type OptionList = ReadonlyArray<SubmenuOption>;
+export interface SubmenuSettingDef extends BaseSettingDef {
+    type: "submenu";
+    options: OptionList;
+    onPreview?: (value: string) => void;
+    onPreviewCancel?: (originalValue: string) => void;
+}
+export interface TextInputSettingDef extends BaseSettingDef {
+    type: "text";
+}
+export type SettingDef = BooleanSettingDef | EnumSettingDef | SubmenuSettingDef | TextInputSettingDef;
+/** Get all setting definitions with UI */
+export declare function getAllSettingDefs(): SettingDef[];
+/** Get settings for a specific tab */
+export declare function getSettingsForTab(tab: SettingTab): SettingDef[];
+/** Get a setting definition by path */
+export declare function getSettingDef(path: SettingPath): SettingDef | undefined;
+/** Get default value for display */
+export declare function getDisplayDefault(path: SettingPath): string;
+export {};

package/dist/types/modes/components/settings-selector.d.ts

@@ -0,0 +1,77 @@
+import { type ThinkingLevel as ThinkingLevelValue } from "@sayknow-cli/agent-core";
+import type { Effort } from "@sayknow-cli/ai";
+import { type Component, Container } from "@sayknow-cli/tui";
+import { type SettingPath } from "../../config/settings";
+import type { StatusLinePreset, StatusLineSegmentId, StatusLineSeparatorStyle } from "../../config/settings-schema";
+import { type NotificationsEditorOperations } from "./notifications-settings-editor";
+import type { StatusLineSegmentOptions } from "./tool-status-header";
+/**
+ * Dynamic context for settings that need runtime data.
+ * Some settings (like thinking level) are managed by the session, not Settings.
+ */
+export interface SettingsRuntimeContext {
+    /** Available thinking levels (from session) */
+    availableThinkingLevels: Effort[];
+    /** Current thinking level (from session) */
+    thinkingLevel: ThinkingLevelValue | undefined;
+    /** Available themes */
+    availableThemes: string[];
+    /** Available model profile names (from the model registry) */
+    availableModelProfiles: string[];
+    /** Working directory for plugins tab */
+    cwd: string;
+    /** Whether this terminal can render the pet overlay. */
+    petAvailable?: boolean;
+    /** Terminal environment used to select unavailable-pet guidance. Omitted in production to use Bun.env. */
+    terminalEnv?: NodeJS.ProcessEnv;
+}
+/** Status line settings subset for preview */
+export interface StatusLinePreviewSettings {
+    preset?: StatusLinePreset;
+    leftSegments?: StatusLineSegmentId[];
+    rightSegments?: StatusLineSegmentId[];
+    separator?: StatusLineSeparatorStyle;
+    segmentOptions?: StatusLineSegmentOptions;
+    previewHighlightSegment?: StatusLineSegmentId;
+    sessionAccent?: boolean;
+    maxRows?: number;
+}
+export interface SettingsCallbacks {
+    /** Called when any setting value changes */
+    onChange: (path: SettingPath, newValue: unknown) => void;
+    /** Called for theme preview while browsing theme settings */
+    onThemePreview?: (theme: string) => void | Promise<void>;
+    /** Called to restore the rendered theme when theme settings preview is cancelled */
+    onThemePreviewCancel?: (theme: string) => void | Promise<void>;
+    /** Called to live-preview the sayknow pet skin while browsing the pet setting. */
+    onPetPreview?: (mode: string) => void;
+    /**
+     * Commit a pet mode through the shared result-returning policy. The policy
+     * rechecks capability immediately before mutation and owns persistence, so
+     * the settings surface never persists `pet.mode` ahead of acceptance.
+     * Returns whether the commit was accepted.
+     */
+    onPetCommit?: (mode: string) => boolean;
+    /** Called for status line preview while configuring */
+    onStatusLinePreview?: (settings: StatusLinePreviewSettings) => void;
+    /** Get current rendered status line for inline preview */
+    getStatusLinePreview?: (width?: number) => string;
+    /** Called when plugins change */
+    onPluginsChanged?: () => void;
+    /** Called when settings panel is closed */
+    onCancel: () => void;
+}
+/**
+ * Main tabbed settings selector component.
+ * Uses declarative settings definitions from settings-defs.ts.
+ */
+export declare class SettingsSelectorComponent extends Container {
+    #private;
+    private readonly context;
+    private readonly callbacks;
+    private readonly notificationsOperations?;
+    constructor(context: SettingsRuntimeContext, callbacks: SettingsCallbacks, notificationsOperations?: NotificationsEditorOperations | undefined);
+    getFocusComponent(): Component;
+    dispose(): void;
+    handleInput(data: string): void;
+}

package/dist/types/modes/components/show-images-selector.d.ts

@@ -0,0 +1,9 @@
+import { Container, type SelectList } from "@sayknow-cli/tui";
+/**
+ * Component that renders a show images selector with borders
+ */
+export declare class ShowImagesSelectorComponent extends Container {
+    #private;
+    constructor(currentValue: boolean, onSelect: (show: boolean) => void, onCancel: () => void);
+    getSelectList(): SelectList;
+}

package/dist/types/modes/components/skill-hud/render.d.ts

@@ -0,0 +1,2 @@
+import { type SkillActiveEntry } from "../../../skill-state/active-state";
+export declare function renderSkillHudBar(entries: readonly SkillActiveEntry[], width: number): string | null;

package/dist/types/modes/components/skill-message.d.ts

@@ -0,0 +1,10 @@
+import { Container } from "@sayknow-cli/tui";
+import type { CustomMessage, SkillPromptDetails } from "../../session/messages";
+export declare class SkillMessageComponent extends Container {
+    #private;
+    private readonly message;
+    constructor(message: CustomMessage<SkillPromptDetails>);
+    setExpanded(expanded: boolean): void;
+    invalidate(): void;
+    render(width: number): string[];
+}

package/dist/types/modes/components/status-line/context-thresholds.d.ts

@@ -0,0 +1,4 @@
+import type { ThemeColor } from "../../../modes/theme/theme";
+export type ContextUsageLevel = "normal" | "warning" | "purple" | "error";
+export declare function getContextUsageLevel(contextPercent: number, contextWindow: number): ContextUsageLevel;
+export declare function getContextUsageThemeColor(level: ContextUsageLevel): ThemeColor;

package/dist/types/modes/components/status-line/git-utils.d.ts

@@ -0,0 +1,28 @@
+import type { GitHeadState } from "../../../utils/git";
+/**
+ * Extract "owner/repo" from a GitHub remote URL.
+ * Handles HTTPS, SSH (scp-style), and git:// protocols.
+ *
+ * @returns "owner/repo" or null if the URL isn't a recognized GitHub remote.
+ */
+export declare function parseGitHubRepo(remoteUrl: string): string | null;
+/**
+ * Extract the branch name from a remote HEAD ref like "origin/main".
+ * Returns the portion after the first "/" or the whole string if no "/" is present.
+ */
+export declare function parseDefaultBranch(ref: string): string;
+export interface PrCacheContext {
+    branch: string;
+    repoId: string | null;
+}
+export declare function createPrCacheContext(branch: string, repoId: string | null): PrCacheContext;
+export declare function isSamePrCacheContext(a: PrCacheContext | undefined, b: PrCacheContext | undefined): boolean;
+export declare function canReuseCachedPr(cachedPr: {
+    number: number;
+    url: string;
+} | null | undefined, cachedContext: PrCacheContext | undefined, currentContext: PrCacheContext | null): boolean;
+export interface CurrentBranchState {
+    readonly branch: string | null;
+    readonly repoId: string | null;
+}
+export declare function resolveCurrentBranch(cwd: string, resolveHead?: (cwd: string) => GitHeadState | null): CurrentBranchState;

package/dist/types/modes/components/status-line/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./presets";
+export * from "./segments";
+export * from "./separators";
+export * from "./types";

package/dist/types/modes/components/status-line/presets.d.ts

@@ -0,0 +1,3 @@
+import type { PresetDef, StatusLinePreset } from "./types";
+export declare const STATUS_LINE_PRESETS: Record<StatusLinePreset, PresetDef>;
+export declare function getPreset(name: StatusLinePreset): PresetDef;

package/dist/types/modes/components/status-line/segments.d.ts

@@ -0,0 +1,5 @@
+import type { RenderedSegment, SegmentContext, StatusLineSegment, StatusLineSegmentId } from "./types";
+export type { SegmentContext } from "./types";
+export declare const SEGMENTS: Record<StatusLineSegmentId, StatusLineSegment>;
+export declare function renderSegment(id: StatusLineSegmentId, ctx: SegmentContext): RenderedSegment;
+export declare const ALL_SEGMENT_IDS: StatusLineSegmentId[];

package/dist/types/modes/components/status-line/separators.d.ts

@@ -0,0 +1,3 @@
+import type { Theme } from "../../../modes/theme/theme";
+import type { SeparatorDef, StatusLineSeparatorStyle } from "./types";
+export declare function getSeparator(style: StatusLineSeparatorStyle, theme: Theme): SeparatorDef;

package/dist/types/modes/components/status-line/token-rate.d.ts

@@ -0,0 +1,10 @@
+type MaybeAssistantMessage = {
+    role?: string;
+    timestamp?: number;
+    duration?: number;
+    usage?: {
+        output?: number;
+    };
+};
+export declare function calculateTokensPerSecond(messages: ReadonlyArray<MaybeAssistantMessage>, isStreaming: boolean, nowMs?: number): number | null;
+export {};

package/dist/types/modes/components/status-line/types.d.ts

@@ -0,0 +1,83 @@
+import type { StatusLinePreset, StatusLineSegmentId, StatusLineSeparatorStyle } from "../../../config/settings-schema";
+import type { AgentSession } from "../../../session/agent-session";
+import type { JobsSnapshot } from "../../jobs-observer";
+import type { StatusLineSegmentOptions, StatusLineSettings } from "../tool-status-header";
+export type { StatusLinePreset, StatusLineSegmentId, StatusLineSegmentOptions, StatusLineSeparatorStyle, StatusLineSettings, };
+export type RGB = readonly [number, number, number];
+export interface SegmentContext {
+    session: AgentSession;
+    width: number;
+    options: StatusLineSegmentOptions;
+    planMode: {
+        enabled: boolean;
+        paused: boolean;
+    } | null;
+    goalMode: {
+        enabled: boolean;
+        paused: boolean;
+    } | null;
+    usageStats: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+        premiumRequests: number;
+        cost: number;
+        tokensPerSecond: number | null;
+    };
+    contextPercent: number | null;
+    contextWindow: number;
+    /**
+     * True when a standalone `context_pct` segment is also part of the active
+     * layout. The model segment suppresses its inline percentage in that case to
+     * avoid showing the same value twice.
+     */
+    contextPctSegmentActive?: boolean;
+    autoCompactEnabled: boolean;
+    subagentCount: number;
+    jobs: JobsSnapshot;
+    sessionStartTime: number;
+    git: {
+        branch: string | null;
+        status: {
+            staged: number;
+            unstaged: number;
+            untracked: number;
+        } | null;
+        pr: {
+            number: number;
+            url: string;
+        } | null;
+    };
+    usage: {
+        windows: Array<{
+            label: string;
+            percent: number;
+            resetValue?: number;
+            resetUnit?: "m" | "h";
+        }>;
+    } | null;
+}
+export interface RenderedSegment {
+    content: string;
+    visible: boolean;
+}
+export interface StatusLineSegment {
+    id: StatusLineSegmentId;
+    render(ctx: SegmentContext): RenderedSegment;
+}
+export interface SeparatorDef {
+    left: string;
+    right: string;
+    endCaps?: {
+        left: string;
+        right: string;
+        useBgAsFg: boolean;
+    };
+}
+export interface PresetDef {
+    leftSegments: StatusLineSegmentId[];
+    rightSegments: StatusLineSegmentId[];
+    separator: StatusLineSeparatorStyle;
+    segmentOptions?: StatusLineSegmentOptions;
+}

package/dist/types/modes/components/status-line.d.ts

@@ -0,0 +1 @@
+export * from "./tool-status-header";

package/dist/types/modes/components/tasks-pane.d.ts

@@ -0,0 +1,15 @@
+import { Container, type SelectItem, SelectList } from "@sayknow-cli/tui";
+import type { TaskRow, TasksAggregator } from "../tasks-aggregator";
+export interface TasksPaneCallbacks {
+    close(): void;
+    requestRender(): void;
+}
+/** A compact, read-only unified task list. Source-specific controls remain in their owners. */
+export declare class TasksPaneComponent extends Container {
+    #private;
+    constructor(aggregator: TasksAggregator, callbacks: TasksPaneCallbacks);
+    getFocus(): SelectList;
+    handleInput(data: string): void;
+    refresh(): void;
+}
+export declare function taskItem(row: TaskRow): SelectItem;