@sayknow-cli/coding-agent 0.3.13 → 0.3.16

package/dist/types/modes/components/extensions/types.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Types for the Extension Control Center dashboard.
+ */
+import type { SourceMeta } from "../../../capability/types";
+/**
+ * Extension kinds matching capability types.
+ */
+export type ExtensionKind = "extension-module" | "skill" | "rule" | "tool" | "mcp" | "prompt" | "instruction" | "context-file" | "hook" | "slash-command";
+/**
+ * Extension state (active, disabled, or shadowed).
+ */
+export type ExtensionState = "active" | "disabled" | "shadowed";
+/**
+ * Reason why an extension is disabled.
+ */
+export type DisabledReason = "provider-disabled" | "item-disabled" | "shadowed";
+/**
+ * Unified extension representation for the dashboard.
+ * Normalizes all capability types into a common shape.
+ */
+export interface Extension {
+    /** Unique ID: `${kind}:${name}` */
+    id: string;
+    /** Extension kind */
+    kind: ExtensionKind;
+    /** Extension name */
+    name: string;
+    /** Display name (may differ from name) */
+    displayName: string;
+    /** Description if available */
+    description?: string;
+    /** Trigger pattern (slash command, glob, regex) */
+    trigger?: string;
+    /** Absolute path to source file */
+    path: string;
+    /** Source metadata */
+    source: {
+        provider: string;
+        providerName: string;
+        level: "user" | "project" | "native";
+    };
+    /** Current state */
+    state: ExtensionState;
+    /** Reason for disabled state */
+    disabledReason?: DisabledReason;
+    /** If shadowed, what shadows it */
+    shadowedBy?: string;
+    /** Raw item data for inspector */
+    raw: unknown;
+}
+/**
+ * Tree node types for sidebar hierarchy.
+ */
+export type TreeNodeType = "provider" | "kind" | "item";
+/**
+ * Sidebar tree node.
+ */
+export interface TreeNode {
+    /** Unique ID */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Node type (provider can be toggled, kind groups items) */
+    type: TreeNodeType;
+    /** Whether this node/provider is enabled */
+    enabled: boolean;
+    /** Whether collapsed */
+    collapsed: boolean;
+    /** Child nodes */
+    children: TreeNode[];
+    /** Extension count (for display) */
+    count?: number;
+}
+/**
+ * Flattened tree item for navigation.
+ */
+export interface FlatTreeItem {
+    node: TreeNode;
+    depth: number;
+    index: number;
+}
+/**
+ * Focus region in the tabbed dashboard.
+ */
+export type FocusRegion = "tabs" | "list";
+/**
+ * Provider tab representation.
+ */
+export interface ProviderTab {
+    /** Provider ID (or "all" for the ALL tab) */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Whether provider is enabled (always true for "all") */
+    enabled: boolean;
+    /** Extension count for this provider */
+    count: number;
+}
+/**
+ * Tabbed dashboard state.
+ */
+export interface DashboardState {
+    /** Provider tabs */
+    tabs: ProviderTab[];
+    /** Active tab index */
+    activeTabIndex: number;
+    /** All extensions (unfiltered) */
+    extensions: Extension[];
+    /** Extensions filtered by active tab */
+    tabFiltered: Extension[];
+    /** Extensions filtered by search (applied after tab filter) */
+    searchFiltered: Extension[];
+    /** Current search query */
+    searchQuery: string;
+    /** Selected index in main list */
+    listIndex: number;
+    /** Scroll offset for main list */
+    scrollOffset: number;
+    /** Currently selected extension for inspector */
+    selected: Extension | null;
+}
+/**
+ * @deprecated Use FocusRegion instead
+ */
+export type FocusPane = "sidebar" | "main" | "inspector";
+/**
+ * Callbacks from dashboard to parent.
+ */
+export interface DashboardCallbacks {
+    /** Called when provider is toggled */
+    onProviderToggle: (providerId: string, enabled: boolean) => void;
+    /** Called when extension item is toggled */
+    onExtensionToggle: (extensionId: string, enabled: boolean) => void;
+    /** Called when dashboard is closed */
+    onClose: () => void;
+}
+/**
+ * Create extension ID from kind and name.
+ */
+export declare function makeExtensionId(kind: ExtensionKind, name: string): string;
+/**
+ * Parse extension ID into kind and name.
+ */
+export declare function parseExtensionId(id: string): {
+    kind: ExtensionKind;
+    name: string;
+} | null;
+/**
+ * Map SourceMeta to extension source shape.
+ */
+export declare function sourceFromMeta(meta: SourceMeta): Extension["source"];

package/dist/types/modes/components/footer.d.ts

@@ -0,0 +1,30 @@
+import { type Component } from "@sayknow-cli/tui";
+import type { AgentSession } from "../../session/agent-session";
+/**
+ * Footer component that shows pwd, token stats, and context usage
+ */
+export declare class FooterComponent implements Component {
+    #private;
+    private readonly session;
+    constructor(session: AgentSession);
+    setAutoCompactEnabled(enabled: boolean): void;
+    /**
+     * Set extension status text to display in the footer.
+     * Text is sanitized (newlines/tabs replaced with spaces) and truncated to terminal width.
+     * ANSI escape codes for styling are preserved.
+     * @param key - Unique key to identify this status
+     * @param text - Status text, or undefined to clear
+     */
+    setExtensionStatus(key: string, text: string | undefined): void;
+    /**
+     * Set up a file watcher on .git/HEAD to detect branch changes.
+     * Call the provided callback when branch changes.
+     */
+    watchBranch(onBranchChange: () => void): void;
+    /**
+     * Clean up the file watcher
+     */
+    dispose(): void;
+    invalidate(): void;
+    render(width: number): string[];
+}

package/dist/types/modes/components/history-search.d.ts

@@ -0,0 +1,7 @@
+import { Container } from "@sayknow-cli/tui";
+import type { HistoryStorage } from "../../session/history-storage";
+export declare class HistorySearchComponent extends Container {
+    #private;
+    constructor(historyStorage: HistoryStorage, onSelect: (prompt: string) => void, onCancel: () => void);
+    handleInput(keyData: string): void;
+}

package/dist/types/modes/components/hook-editor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Multi-line editor component for hooks and ask custom input.
+ * Supports Ctrl+G for external editor.
+ *
+ * Two modes:
+ * - Default (hook): Enter inserts newline, Ctrl+Enter submits, bordered popup
+ * - Prompt-style (ask): Enter submits, Shift+Enter inserts newline, legacy ask chrome
+ */
+import { Container, type TUI } from "@sayknow-cli/tui";
+export interface HookEditorOptions {
+    /** When true, use prompt-style keybindings with the legacy ask prompt chrome. */
+    promptStyle?: boolean;
+}
+export declare class HookEditorComponent extends Container {
+    #private;
+    constructor(tui: TUI, title: string, prefill: string | undefined, onSubmit: (value: string) => void, onCancel: () => void, options?: HookEditorOptions);
+    handleInput(keyData: string): void;
+}

package/dist/types/modes/components/hook-input.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Simple text input component for hooks.
+ */
+import { Container, type TUI } from "@sayknow-cli/tui";
+export interface HookInputOptions {
+    tui?: TUI;
+    timeout?: number;
+    onTimeout?: () => void;
+}
+export declare class HookInputComponent extends Container {
+    #private;
+    constructor(title: string, _placeholder: string | undefined, onSubmit: (value: string) => void, onCancel: () => void, opts?: HookInputOptions);
+    handleInput(keyData: string): void;
+    dispose(): void;
+}

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

@@ -0,0 +1,15 @@
+import { Container } from "@sayknow-cli/tui";
+import type { HookMessageRenderer } from "../../extensibility/hooks/types";
+import type { HookMessage } from "../../session/messages";
+/**
+ * Component that renders a custom message entry from hooks.
+ * Uses distinct styling to differentiate from user messages.
+ */
+export declare class HookMessageComponent extends Container {
+    #private;
+    private readonly message;
+    private readonly customRenderer?;
+    constructor(message: HookMessage<unknown>, customRenderer?: HookMessageRenderer | undefined);
+    setExpanded(expanded: boolean): void;
+    invalidate(): void;
+}

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

@@ -0,0 +1,59 @@
+/**
+ * Generic selector component for hooks.
+ * Displays a list of string options with keyboard navigation.
+ */
+import { type AutocompleteProvider, Container, type TUI } from "@sayknow-cli/tui";
+export interface HookSelectorOptions {
+    tui?: TUI;
+    timeout?: number;
+    onTimeout?: () => void;
+    initialIndex?: number;
+    outline?: boolean;
+    maxVisible?: number;
+    onLeft?: () => void;
+    onRight?: () => void;
+    onExternalEditor?: () => void;
+    helpText?: string;
+    /**
+     * When true, the focused option's label wraps across multiple rows so the
+     * full text is visible. Non-focused options remain single-row with the
+     * existing `…` truncation hint. When unset/false, rendering is
+     * byte-identical to the previous implementation for all consumers.
+     */
+    wrapFocused?: boolean;
+    scrollTitleRows?: number;
+    /**
+     * Inline free-text entry for the option with this label (e.g. the ask
+     * tool's "Other (type your own)"). Selecting it keeps the title and option
+     * list on screen and opens a prompt-style editor below the list instead of
+     * replacing the whole selector. Enter submits via `onSubmit`; Escape
+     * returns to option selection.
+     */
+    customInput?: {
+        optionLabel: string;
+        onSubmit: (text: string) => void;
+    };
+    clarificationInput?: {
+        optionLabel: string;
+        onSubmit: (text: string) => void;
+        allowEmpty?: boolean;
+    };
+    /**
+     * Autocomplete provider for the inline custom-input editor. When present,
+     * the "Other (type your own)" editor gains the same `@` file-link and `/`
+     * completion behavior as the main prompt editor.
+     */
+    autocompleteProvider?: AutocompleteProvider;
+    /**
+     * Maps raw single-key accelerators to option labels. Unset maps preserve
+     * the legacy selector key handling exactly.
+     */
+    acceleratorMap?: Readonly<Record<string, string>>;
+}
+export declare class HookSelectorComponent extends Container {
+    #private;
+    constructor(title: string, options: string[], onSelect: (option: string) => void, onCancel: () => void, opts?: HookSelectorOptions);
+    hasActiveInlineInput(): boolean;
+    handleInput(keyData: string): void;
+    dispose(): void;
+}

package/dist/types/modes/components/index.d.ts

@@ -0,0 +1,35 @@
+export * from "./assistant-message";
+export * from "./bash-execution";
+export * from "./bordered-loader";
+export * from "./branch-summary-message";
+export * from "./compaction-summary-message";
+export * from "./countdown-timer";
+export * from "./custom-editor";
+export * from "./custom-message";
+export * from "./diff";
+export * from "./dynamic-border";
+export * from "./footer";
+export * from "./hook-editor";
+export * from "./hook-input";
+export * from "./hook-message";
+export * from "./hook-selector";
+export * from "./keybinding-hints";
+export * from "./login-dialog";
+export * from "./model-selector";
+export * from "./oauth-selector";
+export * from "./queue-mode-selector";
+export * from "./read-tool-group";
+export * from "./session-selector";
+export * from "./settings-selector";
+export * from "./show-images-selector";
+export * from "./status-line";
+export * from "./theme-selector";
+export * from "./thinking-selector";
+export * from "./todo-reminder";
+export * from "./tool-execution";
+export * from "./tree-selector";
+export * from "./ttsr-notification";
+export * from "./user-message";
+export * from "./user-message-selector";
+export * from "./visual-truncate";
+export * from "./welcome";

package/dist/types/modes/components/irc-sidebar.d.ts

@@ -0,0 +1,32 @@
+import { type Component, type ViewportAnchorProvider, type ViewportAnchorRender } from "@sayknow-cli/tui";
+import type { IrcObservationLedger } from "../irc-observation-ledger";
+export declare const IRC_SIDEBAR_WIDTH_RATIO = 0.3;
+export declare const IRC_SIDEBAR_MAX_RENDER_ROWS = 2048;
+/** Computes transcript/sidebar widths while preserving at least half the terminal for the transcript. */
+export declare function computeIrcSplitWidths(width: number): {
+    leftWidth: number;
+    separatorWidth: number;
+    rightWidth: number;
+};
+export interface IrcSidebarTheme {
+    fg(color: "dim" | "accent", text: string): string;
+    bold(text: string): string;
+    readonly boxSharp: {
+        readonly vertical: string;
+    };
+}
+export type IrcSidebarThemeSource = IrcSidebarTheme | (() => IrcSidebarTheme);
+/** Read-only IRC history alongside the active transcript. */
+export declare class IrcSplitViewComponent implements ViewportAnchorProvider {
+    #private;
+    private readonly leftPane;
+    private readonly ledger;
+    private readonly componentTheme;
+    constructor(leftPane: Component, ledger: IrcObservationLedger, componentTheme: IrcSidebarThemeSource);
+    get visible(): boolean;
+    effectiveSidebarVisible(width?: number): boolean;
+    setVisible(visible: boolean): void;
+    render(width: number): string[];
+    renderWithViewportAnchors(width: number): ViewportAnchorRender;
+    invalidate(): void;
+}

package/dist/types/modes/components/jobs-overlay-model.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pure model helpers for the jobs overlay.
+ *
+ * Kept free of UI/Component dependencies so the grouping/ordering and
+ * detail-formatting logic is unit-testable. The selector controller wires these
+ * SelectItem lists into nested SelectLists (list -> detail -> confirm).
+ */
+import type { SelectItem } from "@sayknow-cli/tui";
+import type { JobsSnapshot } from "../jobs-observer";
+export type JobRefKind = "monitor" | "cron";
+export interface JobRef {
+    kind: JobRefKind;
+    id: string;
+}
+/** Compact relative time, e.g. "in 5m", "2m ago", "now". */
+export declare function formatRelative(targetMs: number | undefined, nowMs?: number): string;
+/** Parse a list item value back into a job reference. */
+export declare function parseJobRef(value: string): JobRef | null;
+/**
+ * Build the grouped jobs list: monitors first (newest-first), then crons
+ * (newest-first). The snapshot arrays are already sorted newest-first.
+ */
+export declare function buildJobsListItems(snapshot: JobsSnapshot): SelectItem[];
+/**
+ * Build the detail-level items for a job: read-only info rows (value "noop"),
+ * then the destructive action, then a back row. `output` is the bounded monitor
+ * output tail (ignored for cron jobs).
+ */
+export declare function buildJobDetailItems(snapshot: JobsSnapshot, ref: JobRef, output?: string): SelectItem[];
+/** Yes/No confirm items for a destructive action. */
+export declare function buildConfirmItems(actionLabel: string): SelectItem[];

package/dist/types/modes/components/jobs-overlay.d.ts

@@ -0,0 +1,30 @@
+import { Container, type SelectItem, SelectList } from "@sayknow-cli/tui";
+import type { JobsSnapshot } from "../jobs-observer";
+/**
+ * Generic single-level selector used by the jobs overlay. The selector
+ * controller mounts a fresh instance per navigation level (list -> detail ->
+ * confirm); focus is placed on the inner SelectList, matching the existing
+ * selector components (e.g. ThemeSelectorComponent).
+ */
+export declare class JobsSelectorComponent extends Container {
+    #private;
+    constructor(items: SelectItem[], onSelect: (item: SelectItem) => void, onCancel: () => void, maxVisible?: number);
+    getSelectList(): SelectList;
+}
+export interface JobsOverlayController {
+    acknowledgeFailures(): void;
+    getSnapshot(): JobsSnapshot;
+    getMonitorOutput(id: string): string;
+    cancelMonitor(id: string): boolean;
+    deleteCron(id: string): boolean;
+}
+export interface JobsOverlayCallbacks {
+    close(): void;
+    requestRender(): void;
+}
+export declare class JobsOverlayComponent extends Container {
+    #private;
+    constructor(controller: JobsOverlayController, callbacks: JobsOverlayCallbacks);
+    getFocus(): SelectList;
+    handleInput(data: string): void;
+}

package/dist/types/modes/components/keybinding-hints.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Utilities for formatting keybinding hints in the UI.
+ */
+import { type Keybinding } from "@sayknow-cli/tui";
+import type { AppKeybinding, KeybindingsManager } from "../../config/keybindings";
+/**
+ * Get display string for an editor action.
+ */
+export declare function editorKey(action: Keybinding): string;
+/**
+ * Get display string for an app action.
+ */
+export declare function appKey(keybindings: KeybindingsManager, action: AppKeybinding): string;
+/**
+ * Format a keybinding hint with consistent styling: dim key, muted description.
+ * Looks up the key from editor keybindings automatically.
+ *
+ * @param action - Keybinding action name (e.g., "tui.select.confirm", "app.tools.expand")
+ * @param description - Description text (e.g., "to expand", "cancel")
+ * @returns Formatted string with dim key and muted description
+ */
+export declare function keyHint(action: Keybinding, description: string): string;
+/**
+ * Format a keybinding hint for app-level actions.
+ * Requires the KeybindingsManager instance.
+ *
+ * @param keybindings - KeybindingsManager instance
+ * @param action - App keybinding name (e.g., "app.interrupt", "app.editor.external")
+ * @param description - Description text
+ * @returns Formatted string with dim key and muted description
+ */
+export declare function appKeyHint(keybindings: KeybindingsManager, action: AppKeybinding, description: string): string;
+/**
+ * Format a raw key string with description (for non-configurable keys like ↑↓).
+ *
+ * @param key - Raw key string
+ * @param description - Description text
+ * @returns Formatted string with dim key and muted description
+ */
+export declare function rawKeyHint(key: string, description: string): string;

package/dist/types/modes/components/login-dialog.d.ts

@@ -0,0 +1,32 @@
+import { Container, type TUI } from "@sayknow-cli/tui";
+/**
+ * Login dialog component - replaces editor during OAuth login flow
+ */
+export declare class LoginDialogComponent extends Container {
+    #private;
+    private onComplete;
+    constructor(tui: TUI, providerId: string, onComplete: (success: boolean, message?: string) => void);
+    get signal(): AbortSignal;
+    /**
+     * Called by onAuth callback - show URL and optional instructions
+     */
+    showAuth(url: string, instructions?: string): void;
+    /**
+     * Show input for manual code/URL entry (for callback server providers)
+     */
+    showManualInput(prompt: string): Promise<string>;
+    /**
+     * Called by onPrompt callback - show prompt and wait for input
+     * Note: Does NOT clear content, appends to existing (preserves URL from showAuth)
+     */
+    showPrompt(message: string, placeholder?: string): Promise<string>;
+    /**
+     * Show waiting message (for polling flows like GitHub Copilot)
+     */
+    showWaiting(message: string): void;
+    /**
+     * Called by onProgress callback
+     */
+    showProgress(message: string): void;
+    handleInput(data: string): void;
+}

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

@@ -0,0 +1,42 @@
+/**
+ * Shared rendering for extension/hook custom message frames.
+ *
+ * Both `CustomMessageComponent` and `HookMessageComponent` wrap a
+ * `Spacer(1) + Box` layout, try a user-supplied renderer first, and fall
+ * back to a label + markdown body when the renderer returns nothing or
+ * throws. The only meaningful difference is that hook messages collapse to
+ * the first N lines when not expanded; extension messages render in full.
+ */
+import type { TextContent } from "@sayknow-cli/ai";
+import type { Box, Component } from "@sayknow-cli/tui";
+import { type Theme } from "../../modes/theme/theme";
+/** Message shape consumed by the shared frame. */
+export interface FramedMessage {
+    customType: string;
+    content: string | (TextContent | {
+        type: string;
+    })[];
+}
+/**
+ * Callable signature shared by `MessageRenderer` (extensions) and
+ * `HookMessageRenderer` (hooks). Both narrow `message` to their own type;
+ * this signature is the structural intersection callers can hand off here.
+ */
+export type FramedRenderer<M extends FramedMessage> = (message: M, options: {
+    expanded: boolean;
+}, theme: Theme) => Component | undefined;
+export interface RebuildFrameOptions<M extends FramedMessage> {
+    message: M;
+    box: Box;
+    expanded: boolean;
+    /** Collapse the markdown body to this many lines when `expanded` is false. Omit to never collapse. */
+    collapseAfterLines?: number;
+    customRenderer?: FramedRenderer<M>;
+}
+/**
+ * Attempt the custom renderer; on failure or undefined return, populate
+ * `box` with the default `[customType]` label + markdown body and return
+ * undefined. When the custom renderer succeeds, return its Component so the
+ * caller can mount it and skip the default box.
+ */
+export declare function renderFramedMessage<M extends FramedMessage>(opts: RebuildFrameOptions<M>): Component | undefined;

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

@@ -0,0 +1,60 @@
+import { ThinkingLevel } from "@sayknow-cli/agent-core";
+import { type Model } from "@sayknow-cli/ai";
+import { Container, Input, type TUI } from "@sayknow-cli/tui";
+import type { ModelRegistry, SkcModelAssignmentTargetId } from "../../config/model-registry";
+import { type ScopedModelSelection } from "../../config/model-resolver";
+import type { ModelProfileConfig } from "../../config/models-config-schema";
+import type { Settings } from "../../config/settings";
+type ScopedModelItem = ScopedModelSelection;
+export type ModelSelectorSelection = {
+    kind: "assignment";
+    model: Model;
+    role: SkcModelAssignmentTargetId | null;
+    roles?: readonly SkcModelAssignmentTargetId[];
+    thinkingLevel?: ThinkingLevel;
+    selector?: string;
+} | {
+    kind: "profile";
+    profileName: string;
+    setDefault: boolean;
+} | {
+    kind: "createProfile";
+    profile: ModelProfileConfig;
+} | {
+    kind: "login";
+    providerId: string;
+};
+type RoleSelectCallback = (selection: ModelSelectorSelection) => void | Promise<void>;
+/**
+ * Component that renders a canonical model selector with provider tabs.
+ * - Preset landing Left/Right: Collapse/expand selected provider
+ * - Model browser Tab/Arrow Left/Right: Switch between provider tabs
+ * - Arrow Up/Down: Navigate rows
+ * - Enter: Open assignment actions for default plus SKC role-agent models
+ * - Escape: Close selector
+ */
+export declare class ModelSelectorComponent extends Container {
+    #private;
+    constructor(tui: TUI, _currentModel: Model | undefined, settings: Settings, modelRegistry: ModelRegistry, scopedModels: ReadonlyArray<ScopedModelItem>, onSelect: RoleSelectCallback, onCancel: () => void, options?: {
+        temporaryOnly?: boolean;
+        initialSearchInput?: string;
+        sessionId?: string;
+        isFastForProvider?: (provider?: string) => boolean;
+        isFastForSubagentProvider?: (provider?: string) => boolean;
+        isCurrentModelFastModeActive?: () => boolean;
+        currentThinkingLevel?: ThinkingLevel;
+        activeModelProfile?: string;
+    });
+    refreshRoleAssignments(options?: {
+        currentModel?: Model;
+        currentThinkingLevel?: ThinkingLevel;
+        activeModelProfile?: string;
+    }): void;
+    handleInput(keyData: string): void;
+    getSearchInput(): Input;
+    __testSelectProfile(profileName: string, setDefault: boolean): Promise<void>;
+    __testSelectAssignment(selection: Omit<Extract<ModelSelectorSelection, {
+        kind: "assignment";
+    }>, "kind">): Promise<void>;
+}
+export {};

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

@@ -0,0 +1,17 @@
+import { Container } from "@sayknow-cli/tui";
+import type { AuthStorage } from "../../session/auth-storage";
+import type { ImportableCredential } from "../../setup/credential-import";
+/**
+ * Component that renders an OAuth provider selector.
+ */
+export declare class OAuthSelectorComponent extends Container {
+    #private;
+    constructor(mode: "login" | "logout", authStorage: AuthStorage, onSelect: (providerId: string) => void, onCancel: () => void, options?: {
+        validateAuth?: (providerId: string) => Promise<boolean>;
+        requestRender?: () => void;
+        externalCredentialCandidates?: ImportableCredential[];
+    });
+    stopValidation(): void;
+    dispose(): void;
+    handleInput(keyData: string): void;
+}

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

@@ -0,0 +1,11 @@
+import { Container, SelectList } from "@sayknow-cli/tui";
+import type { PetMode } from "./sayknow-pet-widget";
+/**
+ * Theme-style picker for the sayknow pet skin (Off / RedSayknow / BlueSayknow). Preview
+ * fires as the selection moves; select commits, cancel restores.
+ */
+export declare class PetSelectorComponent extends Container {
+    #private;
+    constructor(current: PetMode, onSelect: (mode: PetMode) => void, onCancel: () => void, onPreview: (mode: PetMode) => void);
+    getSelectList(): SelectList;
+}

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

@@ -0,0 +1,26 @@
+/**
+ * Interactive marketplace plugin selector.
+ *
+ * Shows available plugins from all configured marketplaces in a SelectList.
+ * Selecting a plugin triggers installation. Esc cancels.
+ */
+import { Container, SelectList } from "@sayknow-cli/tui";
+export interface PluginSelectorCallbacks {
+    onSelect: (pluginName: string, marketplace: string, scope?: "user" | "project") => void;
+    onCancel: () => void;
+}
+export interface PluginItem {
+    plugin: {
+        name: string;
+        version?: string;
+        description?: string;
+    };
+    marketplace: string;
+    /** Scope of this entry. When set, appended to the label and forwarded to onSelect. */
+    scope?: "user" | "project";
+}
+export declare class PluginSelectorComponent extends Container {
+    #private;
+    constructor(marketplaceCount: number, plugins: PluginItem[], installedIds: Set<string>, callbacks: PluginSelectorCallbacks);
+    getSelectList(): SelectList;
+}