@skillkit/tui 1.6.3 → 1.8.0

package/dist/index.d.ts

@@ -1,265 +1,744 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
-import { ScoredSkill, ProjectProfile, Learning, Observation, MemoryStatus } from '@skillkit/core';
+import { AgentType, SkillMetadata } from '@skillkit/core';
+import * as _skillkit_agents from '@skillkit/agents';
 
-type Screen = 'home' | 'browse' | 'installed' | 'sync' | 'settings' | 'recommend' | 'translate' | 'context' | 'workflow' | 'execute' | 'history' | 'marketplace' | 'memory' | 'team' | 'plugins' | 'methodology' | 'plan';
-declare function App(): react_jsx_runtime.JSX.Element;
-
-interface SidebarProps {
+interface SkillItem {
+    name: string;
+    description?: string;
+    source?: string;
+    installs?: number;
+    enabled?: boolean;
+    quality?: number;
+    grade?: string;
+    warnings?: number;
+}
+interface RepoInfo {
+    source: string;
+    name: string;
+}
+interface FetchedSkill {
+    name: string;
+    source: string;
+    repoName: string;
+    description?: string;
+}
+type Screen = 'home' | 'browse' | 'installed' | 'marketplace' | 'recommend' | 'translate' | 'context' | 'memory' | 'team' | 'plugins' | 'methodology' | 'plan' | 'workflow' | 'execute' | 'history' | 'sync' | 'settings' | 'help' | 'mesh' | 'message';
+declare const NAV_KEYS: Record<string, Screen>;
+declare const STATUS_BAR_SHORTCUTS = "b browse  m market  i installed  s sync  / help  q quit";
+interface ScreenMeta {
+    key: string;
+    label: string;
     screen: Screen;
-    onNavigate: (screen: Screen) => void;
-    isCompact?: boolean;
 }
-declare function Sidebar({ screen }: SidebarProps): react_jsx_runtime.JSX.Element;
+interface SidebarSection {
+    section: string;
+    items: ScreenMeta[];
+}
+declare const SIDEBAR_NAV: SidebarSection[];
+
+interface AppProps {
+    onExit?: (code?: number) => void;
+}
+declare function App({ onExit }?: AppProps): react.ReactNode;
+
+/**
+ * Monochromatic color palette for SkillKit TUI
+ * Inspired by OpenSync's elegant dark theme
+ */
+declare const colors: {
+    readonly background: "#0d0d0d";
+    readonly surface: "#1a1a1a";
+    readonly surfaceHover: "#262626";
+    readonly border: "#333333";
+    readonly borderDim: "#1f1f1f";
+    readonly text: "#ffffff";
+    readonly textSecondary: "#a0a0a0";
+    readonly textMuted: "#666666";
+    readonly accent: "#00ff88";
+    readonly accentDim: "#00cc6a";
+    readonly success: "#22c55e";
+    readonly warning: "#eab308";
+    readonly error: "#ef4444";
+    readonly info: "#3b82f6";
+    readonly sync: "#00d9ff";
+    readonly browse: "#22c55e";
+    readonly recommend: "#fbbf24";
+    readonly translate: "#a855f7";
+    readonly workflow: "#3b82f6";
+    readonly team: "#ffffff";
+    readonly private: "#ef4444";
+    readonly tag: "#fbbf24";
+    readonly export: "#22c55e";
+    readonly delete: "#ef4444";
+};
+type ColorName = keyof typeof colors;
+type ColorValue = (typeof colors)[ColorName];
+/**
+ * Get a color value by name
+ */
+declare function getColor(name: ColorName): ColorValue;
+/**
+ * Terminal-safe color names for OpenTUI
+ * Maps our design system colors to terminal-compatible values
+ */
+declare const terminalColors: {
+    readonly background: "black";
+    readonly surface: "black";
+    readonly text: "white";
+    readonly textSecondary: "gray";
+    readonly textMuted: "gray";
+    readonly accent: "green";
+    readonly success: "green";
+    readonly warning: "yellow";
+    readonly error: "red";
+    readonly info: "blue";
+    readonly sync: "cyan";
+    readonly browse: "green";
+    readonly recommend: "yellow";
+    readonly translate: "magenta";
+    readonly workflow: "blue";
+    readonly team: "white";
+    readonly border: "gray";
+};
+
+/**
+ * Unicode symbols and agent logos for SkillKit TUI
+ * Monochromatic design system for terminal display
+ */
+/**
+ * Agent logo definitions with monochromatic icons
+ */
+interface AgentLogo {
+    icon: string;
+    name: string;
+    company: string;
+}
+/**
+ * All 32 supported agents with monochromatic Unicode logos
+ */
+declare const AGENT_LOGOS: Record<string, AgentLogo>;
+/**
+ * UI symbols for status and navigation
+ */
+declare const symbols: {
+    readonly pointer: "▸";
+    readonly pointerInactive: " ";
+    readonly bullet: "●";
+    readonly bulletEmpty: "○";
+    readonly success: "✓";
+    readonly error: "✗";
+    readonly warning: "⚠";
+    readonly info: "ℹ";
+    readonly pending: "○";
+    readonly active: "●";
+    readonly synced: "●";
+    readonly progressFilled: "█";
+    readonly progressEmpty: "░";
+    readonly spinner: readonly ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+    readonly arrowUp: "↑";
+    readonly arrowDown: "↓";
+    readonly arrowLeft: "←";
+    readonly arrowRight: "→";
+    readonly diamond: "◆";
+    readonly diamondEmpty: "◇";
+    readonly star: "★";
+    readonly starEmpty: "☆";
+    readonly horizontalLine: "─";
+    readonly verticalLine: "│";
+    readonly topLeft: "┌";
+    readonly topRight: "┐";
+    readonly bottomLeft: "└";
+    readonly bottomRight: "┘";
+    readonly brandIcon: "◆";
+};
+type SymbolName = keyof typeof symbols;
+/**
+ * Get agent logo by agent type ID
+ */
+declare function getAgentLogo(agentType: string): AgentLogo | undefined;
+/**
+ * Get all agent types
+ */
+declare function getAgentTypes(): string[];
+/**
+ * Get formatted agent display string (icon + name)
+ */
+declare function formatAgentDisplay(agentType: string): string;
+
+/**
+ * Animation presets for SkillKit TUI
+ * Uses OpenTUI's useTimeline for smooth 60fps animations
+ */
+/**
+ * Animation easing functions available in OpenTUI
+ */
+type EasingFunction = 'linear' | 'easeInQuad' | 'easeOutQuad' | 'easeInOutQuad' | 'easeInCubic' | 'easeOutCubic' | 'easeInOutCubic' | 'easeInQuart' | 'easeOutQuart' | 'easeInOutQuart';
+/**
+ * Animation preset configuration
+ */
+interface AnimationPreset {
+    duration: number;
+    ease: EasingFunction;
+    stagger?: number;
+}
+/**
+ * Predefined animation presets
+ */
+declare const animations: {
+    /**
+     * Staggered fade-in for entrance animations
+     * Used on home screen for progressive content reveal
+     */
+    readonly staggeredFadeIn: {
+        readonly duration: 800;
+        readonly ease: EasingFunction;
+        readonly stagger: 100;
+    };
+    /**
+     * Logo reveal with scramble effect
+     * Used for branding animation on startup
+     */
+    readonly logoReveal: {
+        readonly duration: 600;
+        readonly ease: EasingFunction;
+    };
+    /**
+     * Count-up animation for stats
+     * Used in StatsCard component
+     */
+    readonly countUp: {
+        readonly duration: 1200;
+        readonly ease: EasingFunction;
+    };
+    /**
+     * Screen transition animation
+     * Used when navigating between screens
+     */
+    readonly screenTransition: {
+        readonly duration: 200;
+        readonly ease: EasingFunction;
+    };
+    /**
+     * Quick fade for tooltips and hints
+     */
+    readonly quickFade: {
+        readonly duration: 150;
+        readonly ease: EasingFunction;
+    };
+    /**
+     * Pulse animation for active states
+     */
+    readonly pulse: {
+        readonly duration: 1000;
+        readonly ease: EasingFunction;
+    };
+};
+/**
+ * Scramble effect characters
+ * Used for text reveal animations
+ */
+declare const SCRAMBLE_CHARS = "\u2588\u2593\u2592\u2591\u25C6\u25C7\u25C8\u27C1\u25CE\u2726\u2B21\u25A3";
+/**
+ * Scramble animation configuration
+ */
+interface ScrambleConfig {
+    /** Animation duration in ms */
+    duration: number;
+    /** Progress increment per frame */
+    increment: number;
+    /** Frame interval in ms */
+    interval: number;
+}
+/**
+ * Default scramble animation config
+ */
+declare const DEFAULT_SCRAMBLE_CONFIG: ScrambleConfig;
+/**
+ * Generate scrambled text with progressive reveal
+ * @param target - The target text to reveal
+ * @param progress - Progress percentage (0-100)
+ * @param chars - Characters to use for scrambling
+ */
+declare function scrambleText(target: string, progress: number, chars?: string): string;
+/**
+ * Calculate staggered delay for an item in a list
+ * @param index - Item index
+ * @param stagger - Delay between items in ms
+ * @returns Delay in ms for this item
+ */
+declare function getStaggerDelay(index: number, stagger?: number): number;
+
+/**
+ * Navigation state management for SkillKit TUI
+ */
+
+/**
+ * Navigation state
+ */
+interface NavigationState {
+    currentScreen: Screen;
+    previousScreen: Screen | null;
+    history: Screen[];
+}
+/**
+ * Create initial navigation state
+ */
+declare function createNavigationState(): NavigationState;
+/**
+ * Navigate to a new screen
+ */
+declare function navigateTo(state: NavigationState, screen: Screen): NavigationState;
+/**
+ * Go back to previous screen (or home)
+ */
+declare function goBack(state: NavigationState): NavigationState;
+/**
+ * Get screen from key press
+ */
+declare function getScreenFromKey(key: string): Screen | undefined;
+/**
+ * Check if a key is a navigation key
+ */
+declare function isNavKey(key: string): boolean;
+
+/**
+ * Skills store state
+ */
+interface SkillsState {
+    skills: SkillItem[];
+    loading: boolean;
+    error: string | null;
+}
+/**
+ * Create initial skills state
+ */
+declare function createSkillsState(): SkillsState;
+/**
+ * Load installed skills
+ * @param agentType - Optional agent type to load skills for
+ * @returns Updated skills state
+ */
+declare function loadSkills(agentType?: AgentType): SkillsState;
+/**
+ * Remove a skill by name
+ * @param skillName - Name of the skill to remove
+ * @param agentType - Optional agent type
+ * @returns true if removed, false otherwise
+ */
+declare function removeSkill(skillName: string, agentType?: AgentType): boolean;
+/**
+ * Filter skills by search query
+ */
+declare function filterSkills(skills: SkillItem[], query: string): SkillItem[];
+
+/**
+ * Agent status information
+ */
+interface AgentStatus {
+    type: AgentType;
+    name: string;
+    detected: boolean;
+    configured: boolean;
+}
+/**
+ * Agents state
+ */
+interface AgentsState {
+    agents: AgentStatus[];
+    currentAgent: AgentType;
+    loading: boolean;
+    error: string | null;
+}
+/**
+ * Create initial agents state
+ */
+declare function createAgentsState(): AgentsState;
+/**
+ * Load all agents with their detection status
+ */
+declare function loadAgents(): Promise<AgentsState>;
+/**
+ * Get count of detected agents
+ */
+declare function getDetectedAgentCount(state: AgentsState): number;
+/**
+ * Get list of detected agents
+ */
+declare function getDetectedAgents(state: AgentsState): AgentStatus[];
+/**
+ * Get agent adapter by type
+ */
+declare function getAgentAdapter(type: AgentType): _skillkit_agents.AgentAdapter;
+/**
+ * Total number of supported agents (derived from adapters)
+ */
+declare const TOTAL_AGENTS: number;
+
+declare const DEFAULT_REPOS: RepoInfo[];
+/**
+ * Marketplace state
+ */
+interface MarketplaceState {
+    allSkills: FetchedSkill[];
+    filteredSkills: FetchedSkill[];
+    loading: boolean;
+    error: string | null;
+    currentRepo: string | null;
+    fetchedRepos: Set<string>;
+    failedRepos: string[];
+    repos: RepoInfo[];
+}
+/**
+ * Get marketplace repos from config or use defaults
+ */
+declare function getMarketplaceRepos(): RepoInfo[];
+/**
+ * Create initial marketplace state
+ */
+declare function createMarketplaceState(): MarketplaceState;
+/**
+ * Try to read skill description from frontmatter
+ */
+declare function readSkillDescription(skillPath: string): string | undefined;
+/**
+ * Fetch skills from a single repository
+ */
+declare function fetchRepoSkills(source: string, repos: RepoInfo[]): Promise<{
+    skills: FetchedSkill[];
+    tempRoot?: string;
+    error?: string;
+}>;
+/**
+ * Clean up temp directory from fetch
+ */
+declare function cleanupTempRoot(tempRoot: string): void;
+/**
+ * Filter skills by search query
+ */
+declare function filterMarketplaceSkills(skills: FetchedSkill[], query: string): FetchedSkill[];
+/**
+ * Convert fetched skills to skill items for display
+ */
+declare function toSkillItems(skills: FetchedSkill[]): SkillItem[];
+/**
+ * Sort skills alphabetically by name
+ */
+declare function sortSkillsByName(skills: FetchedSkill[]): FetchedSkill[];
+
+/**
+ * Get search directories for skills based on agent type
+ * @param agentType - Optional agent type (defaults to configured agent)
+ * @returns Array of directories to search for skills
+ */
+declare function getSearchDirs(agentType?: AgentType): string[];
+/**
+ * Get installation directory for skills
+ * @param global - Whether to get global or project-local directory
+ * @param agentType - Optional agent type (defaults to configured agent)
+ * @returns Installation directory path
+ */
+declare function getInstallDir(global?: boolean, agentType?: AgentType): string;
+/**
+ * Save skill metadata to a skill directory
+ * @param skillDir - Directory containing the skill
+ * @param metadata - Metadata to save
+ */
+declare function saveSkillMetadata(skillDir: string, metadata: SkillMetadata): void;
+/**
+ * Get version from package.json
+ * @returns Version string
+ */
+declare function getVersion(): string;
+
+/**
+ * List navigation and pagination utilities
+ */
+/**
+ * Calculate visible items for paginated list display
+ * Centers the selected item in the visible window
+ */
+interface PaginationResult {
+    /** Starting index in the full list */
+    start: number;
+    /** Ending index (exclusive) in the full list */
+    end: number;
+    /** Number of items above the visible window */
+    itemsAbove: number;
+    /** Number of items below the visible window */
+    itemsBelow: number;
+}
+/**
+ * Calculate pagination for a list with a selected index
+ * @param totalItems - Total number of items in the list
+ * @param selectedIndex - Currently selected item index
+ * @param maxVisible - Maximum number of items to show at once
+ * @returns Pagination information
+ */
+declare function calculatePagination(totalItems: number, selectedIndex: number, maxVisible: number): PaginationResult;
+/**
+ * Move selection up in a list
+ * @param currentIndex - Current selected index
+ * @param minIndex - Minimum allowed index (default: 0)
+ * @returns New index after moving up
+ */
+declare function moveUp(currentIndex: number, minIndex?: number): number;
+/**
+ * Move selection down in a list
+ * @param currentIndex - Current selected index
+ * @param maxIndex - Maximum allowed index
+ * @returns New index after moving down
+ */
+declare function moveDown(currentIndex: number, maxIndex: number): number;
+/**
+ * Clamp an index within valid bounds
+ * @param index - Index to clamp
+ * @param listLength - Length of the list
+ * @returns Clamped index
+ */
+declare function clampIndex(index: number, listLength: number): number;
+/**
+ * Calculate max visible items based on available rows
+ * @param availableRows - Total available rows
+ * @param reservedRows - Rows reserved for headers, footers, etc.
+ * @param minVisible - Minimum visible items (default: 5)
+ * @returns Maximum visible items
+ */
+declare function calculateMaxVisible(availableRows: number, reservedRows: number, minVisible?: number): number;
+
+interface AgentGridProps {
+    /** Maximum number of agents to display */
+    maxVisible?: number;
+    /** Show status indicators for detected agents */
+    showStatus?: boolean;
+    /** Agent types that are detected/active */
+    detectedAgents?: string[];
+    /** Number of columns in the grid */
+    columns?: number;
+}
+declare function AgentGrid({ maxVisible, showStatus, detectedAgents, columns, }: AgentGridProps): react.ReactNode;
+
+interface StatItem {
+    label: string;
+    value: number;
+    color?: keyof typeof terminalColors;
+}
+interface StatsCardProps {
+    items: StatItem[];
+    animated?: boolean;
+}
+declare function StatsCard({ items, animated }: StatsCardProps): react.ReactNode;
 
 interface HeaderProps {
     title: string;
     subtitle?: string;
     count?: number;
+    badge?: string;
+    icon?: string;
 }
-declare function Header({ title, subtitle, count }: HeaderProps): react_jsx_runtime.JSX.Element;
+declare function Header({ title, subtitle, count, badge, icon }: HeaderProps): react.ReactNode;
 
-interface SkillItem {
-    name: string;
-    description?: string;
-    source?: string;
-    installs?: number;
-    enabled?: boolean;
+interface SidebarProps {
+    screen: Screen;
+    onNavigate: (screen: Screen) => void;
 }
+declare function Sidebar({ screen }: SidebarProps): react.ReactNode;
+
+interface StatusBarProps {
+    message?: string;
+    messageType?: 'info' | 'success' | 'error' | 'warning';
+    shortcuts?: string;
+}
+declare function StatusBar({ message, messageType, shortcuts, }: StatusBarProps): react.ReactNode;
+
 interface SkillListProps {
     skills: SkillItem[];
     selectedIndex: number;
-    showInstalls?: boolean;
-    showRank?: boolean;
-    showSource?: boolean;
     maxVisible?: number;
+    onSelect?: (skill: SkillItem) => void;
+}
+declare function SkillList({ skills, selectedIndex, maxVisible, onSelect, }: SkillListProps): react.ReactNode;
+
+interface SearchInputProps {
+    value: string;
+    placeholder?: string;
+    focused?: boolean;
+    onChange?: (value: string) => void;
+}
+declare function SearchInput({ value, placeholder, focused, }: SearchInputProps): react.ReactNode;
+
+interface SpinnerProps {
+    label?: string;
+    color?: keyof typeof terminalColors;
+}
+declare function Spinner({ label, color }: SpinnerProps): react.ReactNode;
+
+interface ProgressBarProps {
+    progress: number;
+    width?: number;
+    showPercentage?: boolean;
+    color?: keyof typeof terminalColors;
 }
-declare function SkillList({ skills, selectedIndex, showInstalls, showRank, showSource, maxVisible, }: SkillListProps): react_jsx_runtime.JSX.Element;
+declare function ProgressBar({ progress, width, showPercentage, color, }: ProgressBarProps): react.ReactNode;
 
-interface Shortcut {
+interface Feature {
     key: string;
     label: string;
+    description: string;
+    color: keyof typeof terminalColors;
 }
-interface StatusBarProps {
-    shortcuts: Shortcut[];
-    message?: string;
+declare const FEATURES: Feature[];
+interface FeatureListProps {
+    features?: Feature[];
 }
-declare function StatusBar({ shortcuts, message }: StatusBarProps): react_jsx_runtime.JSX.Element;
+declare function FeatureList({ features }: FeatureListProps): react.ReactNode;
 
-interface SearchInputProps {
-    value: string;
-    onChange: (value: string) => void;
-    placeholder?: string;
-    isFocused?: boolean;
+interface SplashProps {
+    onComplete: () => void;
+    duration?: number;
 }
-declare function SearchInput({ value, onChange, placeholder, isFocused, }: SearchInputProps): react_jsx_runtime.JSX.Element;
+declare function Splash({ onComplete, duration }: SplashProps): react.ReactNode;
 
 interface HomeProps {
     onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Home({ cols, rows }: HomeProps): react_jsx_runtime.JSX.Element;
+declare function Home({ cols }: HomeProps): react.ReactNode;
 
-interface Props$f {
+interface BrowseProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Browse({ rows }: Props$f): react_jsx_runtime.JSX.Element;
+declare function Browse({ onNavigate, cols, rows }: BrowseProps): react.ReactNode;
 
-interface Props$e {
+interface InstalledProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Installed({ rows }: Props$e): react_jsx_runtime.JSX.Element;
+declare function Installed({ onNavigate, cols, rows }: InstalledProps): react.ReactNode;
 
-interface Props$d {
+interface MarketplaceProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Sync({ rows }: Props$d): react_jsx_runtime.JSX.Element;
+declare function Marketplace({ onNavigate, cols, rows }: MarketplaceProps): react.ReactNode;
 
-interface Props$c {
+interface RecommendProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Settings(_props: Props$c): react_jsx_runtime.JSX.Element;
+declare function Recommend({ onNavigate, cols, rows }: RecommendProps): react.ReactNode;
 
-interface Props$b {
+interface TranslateProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Recommend({ rows }: Props$b): react_jsx_runtime.JSX.Element;
+declare function Translate(_props: TranslateProps): react.ReactNode;
 
-interface Props$a {
+interface ContextProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Translate({ rows }: Props$a): react_jsx_runtime.JSX.Element;
+declare function Context({ onNavigate, cols, rows }: ContextProps): react.ReactNode;
 
-interface Props$9 {
+interface SyncProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Context({ rows }: Props$9): react_jsx_runtime.JSX.Element;
+declare function Sync({ onNavigate, cols, rows }: SyncProps): react.ReactNode;
 
-interface Props$8 {
+interface MemoryProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Memory({ rows }: Props$8): react_jsx_runtime.JSX.Element;
+declare function Memory({ onNavigate, cols, rows }: MemoryProps): react.ReactNode;
 
-interface Props$7 {
+interface WorkflowProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Workflow({ rows }: Props$7): react_jsx_runtime.JSX.Element;
+declare function Workflow({ onNavigate, cols, rows }: WorkflowProps): react.ReactNode;
 
-interface Props$6 {
+interface ExecuteProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Execute({ rows }: Props$6): react_jsx_runtime.JSX.Element;
+declare function Execute({ onNavigate, cols, rows }: ExecuteProps): react.ReactNode;
 
-interface Props$5 {
+interface HistoryProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function History({ rows }: Props$5): react_jsx_runtime.JSX.Element;
+declare function History({ onNavigate, cols, rows }: HistoryProps): react.ReactNode;
 
-interface Props$4 {
+interface TeamProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Marketplace({ rows }: Props$4): react_jsx_runtime.JSX.Element;
+declare function Team({ onNavigate, cols, rows }: TeamProps): react.ReactNode;
 
-interface Props$3 {
+interface PluginsProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Team({ rows }: Props$3): react_jsx_runtime.JSX.Element;
+declare function Plugins({ onNavigate, cols, rows }: PluginsProps): react.ReactNode;
 
-interface Props$2 {
+interface MethodologyProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Plugins({ rows }: Props$2): react_jsx_runtime.JSX.Element;
+declare function Methodology({ onNavigate, cols, rows }: MethodologyProps): react.ReactNode;
 
-interface Props$1 {
+interface PlanProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Methodology({ rows }: Props$1): react_jsx_runtime.JSX.Element;
+declare function Plan({ onNavigate, cols, rows }: PlanProps): react.ReactNode;
 
-interface Props {
+interface SettingsProps {
+    onNavigate: (screen: Screen) => void;
     cols?: number;
     rows?: number;
 }
-declare function Plan({ rows }: Props): react_jsx_runtime.JSX.Element;
+declare function Settings({ onNavigate, cols }: SettingsProps): react.ReactNode;
 
-interface UseSkillsResult {
-    skills: SkillItem[];
-    loading: boolean;
-    error: string | null;
-    refresh: () => void;
-    remove: (name: string) => Promise<void>;
+interface HelpProps {
+    onNavigate: (screen: Screen) => void;
+    cols?: number;
+    rows?: number;
 }
-declare function useSkills(): UseSkillsResult;
+declare function Help({ cols }: HelpProps): react.ReactNode;
 
-interface RepoInfo {
-    source: string;
-    name: string;
+interface MeshProps {
+    onNavigate: (screen: Screen) => void;
+    cols?: number;
+    rows?: number;
 }
-interface UseMarketplaceResult {
-    skills: SkillItem[];
-    loading: boolean;
-    error: string | null;
-    totalCount: number;
-    repos: RepoInfo[];
-    currentRepo: string | null;
-    failedRepos: string[];
-    refresh: () => void;
-    search: (query: string) => void;
-    fetchRepo: (source: string) => Promise<void>;
-    fetchAllRepos: () => Promise<void>;
-}
-declare function useMarketplace(): UseMarketplaceResult;
-
-interface UseKeyboardOptions {
-    onNavigate?: (screen: Screen) => void;
-    onSelect?: () => void;
-    onSearch?: () => void;
-    onInstall?: () => void;
-    onBack?: () => void;
-    onUp?: () => void;
-    onDown?: () => void;
-    disabled?: boolean;
-}
-declare function useKeyboard(options?: UseKeyboardOptions): void;
-declare function useListNavigation(listLength: number, initialIndex?: number): {
-    selectedIndex: number;
-    setSelectedIndex: react.Dispatch<react.SetStateAction<number>>;
-    moveUp: () => void;
-    moveDown: () => void;
-    reset: () => void;
-};
+declare function Mesh({ onNavigate, cols, rows }: MeshProps): react.ReactNode;
 
-interface UseRecommendResult {
-    recommendations: ScoredSkill[];
-    profile: ProjectProfile | null;
-    loading: boolean;
-    error: string | null;
-    totalScanned: number;
-    indexStatus: 'missing' | 'stale' | 'fresh';
-    refresh: () => void;
-    updateIndex: () => void;
-    search: (query: string) => void;
-    searchResults: ScoredSkill[];
-}
-declare function useRecommend(projectPath?: string): UseRecommendResult;
-
-interface UseMemoryResult {
-    learnings: Learning[];
-    observations: Observation[];
-    status: MemoryStatus | null;
-    loading: boolean;
-    error: string | null;
-    isGlobal: boolean;
-    setIsGlobal: (isGlobal: boolean) => void;
-    refresh: () => void;
-    search: (query: string) => Learning[];
-    deleteLearning: (id: string) => boolean;
-    deleteObservation: (id: string) => boolean;
+interface MessageProps {
+    onNavigate: (screen: Screen) => void;
+    cols?: number;
+    rows?: number;
 }
-declare function useMemory(): UseMemoryResult;
-
-declare const colors: {
-    primary: string;
-    secondary: string;
-    secondaryDim: string;
-    success: string;
-    danger: string;
-    warning: string;
-    background: string;
-    borderDim: string;
-};
-declare const symbols: {
-    pointer: string;
-    bullet: string;
-    checkboxOn: string;
-    checkboxOff: string;
-    check: string;
-    star: string;
-    spinner: string[];
-    arrowUp: string;
-    arrowDown: string;
-    success: string;
-    error: string;
-    warning: string;
-    info: string;
-};
-declare const logo = "\n\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2557     \u2588\u2588\u2557     \u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\n\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551 \u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551     \u2588\u2588\u2551 \u2588\u2588\u2554\u255D\u2588\u2588\u2551\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D\n\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2551   \u2588\u2588\u2551\n\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2588\u2588\u2557 \u2588\u2588\u2551   \u2588\u2588\u2551\n\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551\n\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D   \u255A\u2550\u255D\n";
+declare function Message({ onNavigate, cols, rows }: MessageProps): react.ReactNode;
 
-declare function startTUI(): Promise<void>;
+declare function exitTUI(code?: number): void;
+declare function startTUI(): Promise<never>;
 
-export { App, Browse, Context, Execute, Header, History, Home, Installed, Marketplace, Memory, Methodology, Plan, Plugins, Recommend, type Screen, SearchInput, Settings, Sidebar, type SkillItem, SkillList, StatusBar, Sync, Team, Translate, Workflow, colors, logo, startTUI, symbols, useKeyboard, useListNavigation, useMarketplace, useMemory, useRecommend, useSkills };
+export { AGENT_LOGOS, AgentGrid, type AgentLogo, type AgentStatus, type AgentsState, type AnimationPreset, App, Browse, type ColorName, type ColorValue, Context, DEFAULT_REPOS, DEFAULT_SCRAMBLE_CONFIG, type EasingFunction, Execute, FEATURES, type Feature, FeatureList, type FetchedSkill, Header, Help, History, Home, Installed, Marketplace, type MarketplaceState, Memory, Mesh, Message, Methodology, NAV_KEYS, type NavigationState, type PaginationResult, Plan, Plugins, ProgressBar, Recommend, type RepoInfo, SCRAMBLE_CHARS, SIDEBAR_NAV, STATUS_BAR_SHORTCUTS, type ScrambleConfig, type Screen, type ScreenMeta, SearchInput, Settings, Sidebar, type SidebarSection, type SkillItem, SkillList, type SkillsState, Spinner, Splash, StatsCard, StatusBar, type SymbolName, Sync, TOTAL_AGENTS, Team, Translate, Workflow, animations, calculateMaxVisible, calculatePagination, clampIndex, cleanupTempRoot, colors, createAgentsState, createMarketplaceState, createNavigationState, createSkillsState, exitTUI, fetchRepoSkills, filterMarketplaceSkills, filterSkills, formatAgentDisplay, getAgentAdapter, getAgentLogo, getAgentTypes, getColor, getDetectedAgentCount, getDetectedAgents, getInstallDir, getMarketplaceRepos, getScreenFromKey, getSearchDirs, getStaggerDelay, getVersion, goBack, isNavKey, loadAgents, loadSkills, moveDown, moveUp, navigateTo, readSkillDescription, removeSkill, saveSkillMetadata, scrambleText, sortSkillsByName, startTUI, symbols, terminalColors, toSkillItems };