byterover-cli 1.8.0 → 2.0.0

package/dist/tui/features/provider/components/api-key-dialog.js

@@ -0,0 +1,126 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ApiKeyDialog Component
+ *
+ * Dialog for entering and validating API keys for LLM providers.
+ * Features:
+ * - Masked input option (toggle with Ctrl+M)
+ * - Real-time validation
+ * - Loading state during validation
+ * - Error message display
+ * - Link to get API key
+ */
+import { Box, Text, useInput } from 'ink';
+import { useCallback, useState } from 'react';
+import { useTheme } from '../../../hooks/index.js';
+import { stripBracketedPaste } from '../../../utils/index.js';
+/**
+ * API key placeholder hints per provider.
+ * Falls back to 'sk-...' for unlisted providers.
+ */
+const API_KEY_PLACEHOLDERS = {
+    anthropic: 'sk-ant-...',
+    cerebras: 'csk-...',
+    cohere: '...',
+    deepinfra: '...',
+    groq: 'gsk_...',
+    mistral: '...',
+    openai: 'sk-...',
+    openrouter: 'sk-or-...',
+    perplexity: 'pplx-...',
+    togetherai: '...',
+    vercel: 'vcp_...',
+    xai: 'xai-...',
+};
+/**
+ * Masks an API key, showing only the last 4 characters.
+ */
+function maskApiKey(apiKey) {
+    if (apiKey.length <= 4) {
+        return '*'.repeat(apiKey.length);
+    }
+    return '*'.repeat(apiKey.length - 4) + apiKey.slice(-4);
+}
+/**
+ * Default validation function - always returns valid.
+ * In production, this should be replaced with actual API validation.
+ */
+const defaultValidateApiKey = async () => ({ isValid: true });
+/**
+ * ApiKeyDialog displays an input for entering and validating API keys.
+ */
+export const ApiKeyDialog = ({ isActive = true, isOptional = false, onCancel, onSuccess, provider, validateApiKey = defaultValidateApiKey, }) => {
+    const { theme: { colors } } = useTheme();
+    const [apiKey, setApiKey] = useState('');
+    const [isValidating, setIsValidating] = useState(false);
+    const [error, setError] = useState();
+    const [showMasked, setShowMasked] = useState(true);
+    const handleSubmit = useCallback(async () => {
+        if (!apiKey.trim()) {
+            if (isOptional) {
+                onSuccess('');
+                return;
+            }
+            setError('API key is required');
+            return;
+        }
+        setIsValidating(true);
+        setError(undefined);
+        try {
+            const result = await validateApiKey(apiKey.trim(), provider);
+            if (result.isValid) {
+                onSuccess(apiKey.trim());
+            }
+            else {
+                setError(result.error ?? 'Invalid API key');
+            }
+        }
+        catch (error_) {
+            setError(error_ instanceof Error ? error_.message : 'Validation failed');
+        }
+        finally {
+            setIsValidating(false);
+        }
+    }, [apiKey, isOptional, provider, validateApiKey, onSuccess]);
+    // Handle keyboard input for text entry and commands
+    useInput((input, key) => {
+        // Submit on Enter
+        if (key.return && !isValidating) {
+            handleSubmit();
+            return;
+        }
+        // Clear input on Escape, cancel if already empty
+        if (key.escape) {
+            if (apiKey.length > 0) {
+                setApiKey('');
+                setError(undefined);
+            }
+            else {
+                onCancel();
+            }
+            return;
+        }
+        // Toggle mask with Ctrl+R
+        if (input === 'r' && key.ctrl) {
+            setShowMasked((prev) => !prev);
+            return;
+        }
+        // Handle backspace
+        if (key.backspace || key.delete) {
+            setApiKey((prev) => prev.slice(0, -1));
+            setError(undefined);
+            return;
+        }
+        // Handle printable characters (type or paste to add to API key)
+        if (input && !key.ctrl && !key.meta) {
+            const cleaned = stripBracketedPaste(input);
+            if (cleaned) {
+                setApiKey((prev) => prev + cleaned);
+                setError(undefined);
+            }
+        }
+    }, { isActive });
+    // Display value based on mask state
+    const displayValue = showMasked ? maskApiKey(apiKey) : apiKey;
+    return (_jsxs(Box, { borderColor: colors.border, borderStyle: "single", flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { bold: true, color: colors.text, children: ["Connect to ", provider.name] }) }), provider.apiKeyUrl && (_jsxs(Box, { marginBottom: 1, children: [_jsxs(Text, { color: colors.dimText, children: ["Get your API key at:", ' '] }), _jsx(Text, { color: colors.dimText, underline: true, children: provider.apiKeyUrl })] })), _jsx(Box, { marginBottom: 1, children: isValidating ? (_jsx(Text, { color: colors.primary, children: "\u27F3 Validating..." })) : (_jsxs(Box, { children: [_jsx(Box, { flexShrink: 0, children: _jsxs(Text, { color: colors.primary, children: ["Enter your ", provider.name, " API key", isOptional ? ' (optional, Enter to skip)' : '', ":", ' '] }) }), _jsx(Box, { children: _jsxs(Text, { children: [_jsx(Text, { color: apiKey ? colors.text : colors.dimText, children: apiKey ? displayValue : (API_KEY_PLACEHOLDERS[provider.id] ?? 'sk-...') }), apiKey && _jsx(Text, { color: colors.primary, children: "\u258E" })] }) })] })) }), _jsx(Box, { marginBottom: 1, children: error && !isValidating && (_jsxs(Text, { color: colors.warning, children: ["\u2717 ", error] })) }), !isValidating && (_jsxs(Box, { gap: 2, children: [_jsxs(Text, { color: colors.dimText, children: [_jsx(Text, { color: colors.text, children: "Enter" }), " ", isOptional && !apiKey.trim() ? 'Skip' : 'Submit'] }), _jsxs(Text, { color: colors.dimText, children: [_jsx(Text, { color: colors.text, children: "Esc" }), " ", apiKey.length > 0 ? 'Clear' : 'Cancel'] }), _jsxs(Text, { color: colors.dimText, children: [_jsx(Text, { color: colors.text, children: "Ctrl+R" }), " ", showMasked ? 'Reveal' : 'Hide'] })] }))] }));
+};

package/dist/tui/features/provider/components/base-url-dialog.d.ts

@@ -0,0 +1,24 @@
+/**
+ * BaseUrlDialog Component
+ *
+ * Reusable dialog for entering and validating a base URL.
+ * Title and description are provided via props.
+ * Features:
+ * - URL format validation (must be http:// or https://)
+ * - Strips trailing slashes
+ * - Error message display
+ */
+import React from 'react';
+export interface BaseUrlDialogProps {
+    /** Description text shown below the title */
+    description: string;
+    /** Whether the dialog is active for keyboard input */
+    isActive?: boolean;
+    /** Callback when dialog is cancelled */
+    onCancel: () => void;
+    /** Callback when a valid base URL is submitted */
+    onSubmit: (baseUrl: string) => void;
+    /** Title displayed at the top of the dialog */
+    title: string;
+}
+export declare const BaseUrlDialog: React.FC<BaseUrlDialogProps>;

package/dist/tui/features/provider/components/base-url-dialog.js

@@ -0,0 +1,77 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * BaseUrlDialog Component
+ *
+ * Reusable dialog for entering and validating a base URL.
+ * Title and description are provided via props.
+ * Features:
+ * - URL format validation (must be http:// or https://)
+ * - Strips trailing slashes
+ * - Error message display
+ */
+import { Box, Text, useInput } from 'ink';
+import { useCallback, useState } from 'react';
+import { useTheme } from '../../../hooks/index.js';
+import { stripBracketedPaste } from '../../../utils/index.js';
+/**
+ * Validates a URL string. Must be a valid http:// or https:// URL.
+ * Returns an error message string if invalid, or undefined if valid.
+ */
+function validateUrl(input) {
+    if (!input) {
+        return 'Base URL is required';
+    }
+    try {
+        const parsed = new URL(input);
+        if (!['http:', 'https:'].includes(parsed.protocol)) {
+            return 'URL must start with http:// or https://';
+        }
+        return undefined;
+    }
+    catch {
+        return 'Invalid URL format';
+    }
+}
+export const BaseUrlDialog = ({ description, isActive = true, onCancel, onSubmit, title, }) => {
+    const { theme: { colors } } = useTheme();
+    const [url, setUrl] = useState('');
+    const [error, setError] = useState();
+    const handleSubmit = useCallback(() => {
+        const trimmed = url.trim().replace(/\/+$/, '');
+        const validationError = validateUrl(trimmed);
+        if (validationError) {
+            setError(validationError);
+            return;
+        }
+        onSubmit(trimmed);
+    }, [url, onSubmit]);
+    useInput((input, key) => {
+        if (key.return) {
+            handleSubmit();
+            return;
+        }
+        if (key.escape) {
+            if (url.length > 0) {
+                setUrl('');
+                setError(undefined);
+            }
+            else {
+                onCancel();
+            }
+            return;
+        }
+        if (key.backspace || key.delete) {
+            setUrl((prev) => prev.slice(0, -1));
+            setError(undefined);
+            return;
+        }
+        if (input && !key.ctrl && !key.meta) {
+            const cleaned = stripBracketedPaste(input);
+            if (cleaned) {
+                setUrl((prev) => prev + cleaned);
+                setError(undefined);
+            }
+        }
+    }, { isActive });
+    return (_jsxs(Box, { borderColor: colors.border, borderStyle: "single", flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: colors.text, children: title }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: colors.dimText, children: description }) }), _jsxs(Box, { marginBottom: 1, children: [_jsx(Box, { flexShrink: 0, children: _jsxs(Text, { color: colors.primary, children: ["Base URL:", ' '] }) }), _jsx(Box, { children: _jsxs(Text, { children: [_jsx(Text, { color: url ? colors.text : colors.dimText, children: url || 'http://localhost:11434/v1' }), url && _jsx(Text, { color: colors.primary, children: "\u258E" })] }) })] }), _jsx(Box, { marginBottom: 1, children: error && (_jsxs(Text, { color: colors.warning, children: ["\u2717 ", error] })) }), _jsxs(Box, { gap: 2, children: [_jsxs(Text, { color: colors.dimText, children: [_jsx(Text, { color: colors.text, children: "Enter" }), " Submit"] }), _jsxs(Text, { color: colors.dimText, children: [_jsx(Text, { color: colors.text, children: "Esc" }), " ", url.length > 0 ? 'Clear' : 'Cancel'] })] })] }));
+};

package/dist/tui/features/provider/components/credential-path-dialog.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CredentialPathDialog Component
+ *
+ * Dialog for entering a file path to a service account JSON credential.
+ * Used by Google Vertex AI provider which uses file-based credentials
+ * instead of API keys.
+ * Features:
+ * - Unmasked input (file paths, not secrets)
+ * - Real-time validation (file existence + JSON parse)
+ * - Error message display
+ * - Link to service account key page
+ */
+import React from 'react';
+import type { ProviderDTO } from '../../../../shared/transport/types/dto.js';
+export interface CredentialPathDialogProps {
+    /** Whether the dialog is active for keyboard input */
+    isActive?: boolean;
+    /** Callback when dialog is cancelled */
+    onCancel: () => void;
+    /** Callback when credential path is successfully validated */
+    onSuccess: (credentialPath: string) => void;
+    /** The provider to connect to */
+    provider: ProviderDTO;
+    /** Optional validation function */
+    validateCredential?: (path: string, provider: ProviderDTO) => Promise<{
+        error?: string;
+        isValid: boolean;
+    }>;
+}
+export declare const CredentialPathDialog: React.FC<CredentialPathDialogProps>;

package/dist/tui/features/provider/components/credential-path-dialog.js

@@ -0,0 +1,85 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * CredentialPathDialog Component
+ *
+ * Dialog for entering a file path to a service account JSON credential.
+ * Used by Google Vertex AI provider which uses file-based credentials
+ * instead of API keys.
+ * Features:
+ * - Unmasked input (file paths, not secrets)
+ * - Real-time validation (file existence + JSON parse)
+ * - Error message display
+ * - Link to service account key page
+ */
+import { Box, Text, useInput } from 'ink';
+import { homedir } from 'node:os';
+import { useCallback, useState } from 'react';
+import { useTheme } from '../../../hooks/index.js';
+import { stripBracketedPaste } from '../../../utils/index.js';
+function expandTilde(filePath) {
+    if (filePath === '~')
+        return homedir();
+    if (filePath.startsWith('~/'))
+        return homedir() + filePath.slice(1);
+    return filePath;
+}
+const defaultValidate = async () => ({ isValid: true });
+export const CredentialPathDialog = ({ isActive = true, onCancel, onSuccess, provider, validateCredential = defaultValidate, }) => {
+    const { theme: { colors } } = useTheme();
+    const [filePath, setFilePath] = useState('');
+    const [isValidating, setIsValidating] = useState(false);
+    const [error, setError] = useState();
+    const handleSubmit = useCallback(async () => {
+        if (!filePath.trim()) {
+            setError('File path is required');
+            return;
+        }
+        const resolvedPath = expandTilde(filePath.trim());
+        setIsValidating(true);
+        setError(undefined);
+        try {
+            const result = await validateCredential(resolvedPath, provider);
+            if (result.isValid) {
+                onSuccess(resolvedPath);
+            }
+            else {
+                setError(result.error ?? 'Invalid credential file');
+            }
+        }
+        catch (error_) {
+            setError(error_ instanceof Error ? error_.message : 'Validation failed');
+        }
+        finally {
+            setIsValidating(false);
+        }
+    }, [filePath, provider, validateCredential, onSuccess]);
+    useInput((input, key) => {
+        if (key.return && !isValidating) {
+            handleSubmit();
+            return;
+        }
+        if (key.escape) {
+            if (filePath.length > 0) {
+                setFilePath('');
+                setError(undefined);
+            }
+            else {
+                onCancel();
+            }
+            return;
+        }
+        if (key.backspace || key.delete) {
+            setFilePath((prev) => prev.slice(0, -1));
+            setError(undefined);
+            return;
+        }
+        if (input && !key.ctrl && !key.meta) {
+            const cleaned = stripBracketedPaste(input);
+            if (cleaned) {
+                setFilePath((prev) => prev + cleaned);
+                setError(undefined);
+            }
+        }
+    }, { isActive });
+    return (_jsxs(Box, { borderColor: colors.border, borderStyle: "single", flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { bold: true, color: colors.text, children: ["Connect to ", provider.name] }) }), provider.apiKeyUrl && (_jsxs(Box, { marginBottom: 1, children: [_jsxs(Text, { color: colors.dimText, children: ["Get your service account key at:", ' '] }), _jsx(Text, { color: colors.dimText, underline: true, children: provider.apiKeyUrl })] })), _jsx(Box, { marginBottom: 1, children: isValidating ? (_jsx(Text, { color: colors.primary, children: "\u27F3 Validating..." })) : (_jsxs(Box, { children: [_jsx(Box, { flexShrink: 0, children: _jsxs(Text, { color: colors.primary, children: ["Service account JSON key file path:", ' '] }) }), _jsx(Box, { children: _jsxs(Text, { children: [_jsx(Text, { color: filePath ? colors.text : colors.dimText, children: filePath || '/path/to/service-account.json' }), filePath && _jsx(Text, { color: colors.primary, children: "\u258E" })] }) })] })) }), _jsx(Box, { marginBottom: 1, children: error && !isValidating && (_jsxs(Text, { color: colors.warning, children: ["\u2717 ", error] })) }), !isValidating && (_jsxs(Box, { gap: 2, children: [_jsxs(Text, { color: colors.dimText, children: [_jsx(Text, { color: colors.text, children: "Enter" }), " Submit"] }), _jsxs(Text, { color: colors.dimText, children: [_jsx(Text, { color: colors.text, children: "Esc" }), " ", filePath.length > 0 ? 'Clear' : 'Cancel'] })] }))] }));
+};

package/dist/tui/features/provider/components/model-select-step.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ModelSelectStep Component
+ *
+ * Model selection step used within the provider flow.
+ * Fetches models for a given provider and renders ModelDialog for selection.
+ */
+import React from 'react';
+export interface ModelSelectStepProps {
+    /** Whether the step is active for keyboard input */
+    isActive?: boolean;
+    /** Called when model selection is cancelled (skip) */
+    onCancel: () => void;
+    /** Called when a model is selected and set */
+    onComplete: (modelName: string) => void;
+    /** The provider ID to fetch models for */
+    providerId: string;
+    /** The provider display name */
+    providerName: string;
+}
+export declare const ModelSelectStep: React.FC<ModelSelectStepProps>;

package/dist/tui/features/provider/components/model-select-step.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ModelSelectStep Component
+ *
+ * Model selection step used within the provider flow.
+ * Fetches models for a given provider and renders ModelDialog for selection.
+ */
+import { useQueryClient } from '@tanstack/react-query';
+import { Box, Text, useInput } from 'ink';
+import { useCallback, useMemo, useState } from 'react';
+import { useTheme } from '../../../hooks/index.js';
+import { formatTransportError } from '../../../utils/index.js';
+import { getModelsQueryOptions, useGetModels } from '../../model/api/get-models.js';
+import { useSetActiveModel } from '../../model/api/set-active-model.js';
+import { ModelDialog } from '../../model/components/model-dialog.js';
+import { getActiveProviderConfigQueryOptions } from '../api/get-active-provider-config.js';
+export const ModelSelectStep = ({ isActive = true, onCancel, onComplete, providerId, providerName, }) => {
+    const { theme: { colors } } = useTheme();
+    const [error, setError] = useState(null);
+    const queryClient = useQueryClient();
+    const { data: modelData, isError: isModelsError, isLoading } = useGetModels({
+        providerId,
+        queryConfig: { enabled: Boolean(providerId) },
+    });
+    const setActiveModelMutation = useSetActiveModel();
+    const modelItems = useMemo(() => {
+        if (!modelData)
+            return [];
+        const favSet = new Set(modelData.favorites);
+        const recentSet = new Set(modelData.recent);
+        return modelData.models.map((model) => ({
+            contextLength: model.contextLength,
+            id: model.id,
+            isCurrent: model.id === modelData.activeModel,
+            isFavorite: favSet.has(model.id),
+            isFree: model.isFree,
+            isRecent: recentSet.has(model.id),
+            name: model.name,
+            pricing: model.pricing,
+            provider: model.provider,
+        }));
+    }, [modelData]);
+    const handleSelect = useCallback(async (model) => {
+        setError(null);
+        try {
+            await setActiveModelMutation.mutateAsync({
+                contextLength: model.contextLength,
+                modelId: model.id,
+                providerId,
+            });
+            queryClient.invalidateQueries({ queryKey: getModelsQueryOptions(providerId).queryKey });
+            queryClient.invalidateQueries({ queryKey: getActiveProviderConfigQueryOptions().queryKey });
+            onComplete(model.name);
+        }
+        catch (error_) {
+            setError(formatTransportError(error_));
+        }
+    }, [onComplete, providerId, queryClient, setActiveModelMutation]);
+    // Allow Esc to go back when no models available
+    useInput((_input, key) => {
+        if (key.escape && modelItems.length === 0) {
+            onCancel();
+        }
+    }, { isActive: isActive && modelItems.length === 0 });
+    if (isLoading) {
+        return (_jsx(Box, { children: _jsx(Text, { color: colors.dimText, children: "Loading models..." }) }));
+    }
+    if (modelItems.length === 0) {
+        const emptyMessage = isModelsError ? 'Failed to load models.' : 'No models available.';
+        return (_jsxs(Box, { gap: 2, children: [_jsx(Text, { color: colors.dimText, children: emptyMessage }), _jsxs(Text, { color: colors.dimText, children: [_jsx(Text, { color: colors.text, children: "Esc" }), " Back"] })] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [error && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: colors.errorText, children: error }) })), _jsx(ModelDialog, { activeModelId: modelData?.activeModel, isActive: isActive, models: modelItems, onCancel: onCancel, onSelect: handleSelect, providerName: providerName })] }));
+};

package/dist/tui/{components → features/provider/components}/provider-dialog.d.ts

@@ -5,21 +5,23 @@
  * Shows available providers grouped by category with connection status.
  */
 import React from 'react';
-import { ProviderDefinition } from '../../server/core/domain/entities/provider-registry.js';
+import type { ProviderDTO } from '../../../../shared/transport/types/dto.js';
 /**
  * Props for ProviderDialog.
  */
 export interface ProviderDialogProps {
-    /** Currently active provider ID */
-    activeProviderId: string;
-    /** Set of connected provider IDs */
-    connectedProviders: Set<string>;
+    /** Hide the Cancel keybind hint and disable Esc to cancel */
+    hideCancelButton?: boolean;
     /** Whether the dialog is active for keyboard input */
     isActive?: boolean;
     /** Callback when dialog is cancelled */
     onCancel: () => void;
     /** Callback when a provider is selected */
-    onSelect: (provider: ProviderDefinition) => void;
+    onSelect: (provider: ProviderDTO) => void;
+    /** All available providers (already includes isConnected/isCurrent) */
+    providers: ProviderDTO[];
+    /** Custom title for the dialog */
+    title?: string;
 }
 /**
  * ProviderDialog displays a list of available providers for selection.

package/dist/tui/features/provider/components/provider-dialog.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ProviderDialog Component
+ *
+ * Interactive dialog for selecting and connecting to LLM providers.
+ * Shows available providers grouped by category with connection status.
+ */
+import { Box, Text } from 'ink';
+import { useMemo } from 'react';
+import { SelectableList } from '../../../components/selectable-list.js';
+import { useTheme } from '../../../hooks/index.js';
+/**
+ * ProviderDialog displays a list of available providers for selection.
+ */
+export const ProviderDialog = ({ hideCancelButton = false, isActive = true, onCancel, onSelect, providers, title = 'Connect a Provider', }) => {
+    const { theme: { colors } } = useTheme();
+    // Find current provider for the list
+    const currentProvider = useMemo(() => providers.find((p) => p.isCurrent), [providers]);
+    return (_jsx(SelectableList, { currentItem: currentProvider, filterKeys: (item) => [item.id, item.name, item.description], getCurrentKey: (item) => item.id, hideCancelButton: hideCancelButton, isActive: isActive, items: providers, keyExtractor: (item) => item.id, onCancel: onCancel, onSelect: (item) => onSelect(item), renderItem: (item, isActive, isCurrent) => (_jsxs(Box, { gap: 2, children: [_jsx(Text, { backgroundColor: isActive ? colors.dimText : undefined, color: isActive ? colors.text : colors.text, children: item.name.padEnd(15) }), _jsx(Text, { color: colors.dimText, children: item.description }), item.isConnected && !isCurrent && (_jsx(Text, { color: colors.primary, children: "[Connected]" })), isCurrent && (_jsx(Text, { color: colors.primary, children: "(Current)" }))] })), searchPlaceholder: "Search providers...", title: title }));
+};

package/dist/tui/features/provider/components/provider-flow.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ProviderFlow Component
+ *
+ * Multi-step React flow for the /providers command.
+ * State machine: loading → select → provider_actions → api_key → connecting → done
+ *
+ * Owns the UX flow — fetches providers, renders selection,
+ * handles API key input, and calls connect/setActive mutations.
+ * For connected providers, shows action menu (set active, replace key, disconnect).
+ */
+import React from 'react';
+import type { CommandSideEffects } from '../../../types/commands.js';
+export interface ProviderFlowProps {
+    /** Hide the Cancel keybind in provider selection */
+    hideCancelButton?: boolean;
+    /** Whether the flow is active for keyboard input */
+    isActive?: boolean;
+    /** Called when the flow is cancelled */
+    onCancel: () => void;
+    /** Called when the flow completes (provider connected or switched) */
+    onComplete: (message: string, sideEffects?: CommandSideEffects) => void;
+    /** Custom title for the provider selection dialog */
+    providerDialogTitle?: string;
+}
+export declare const ProviderFlow: React.FC<ProviderFlowProps>;