@shuffleio/shuffle-mcps 0.0.64 → 0.0.66

package/dist/index.d.mts

@@ -2,6 +2,67 @@ import * as React$1 from 'react';
 import React__default, { ReactNode } from 'react';
 import { SxProps, Theme, PopperProps } from '@mui/material';
 
+/**
+ * RFC 4122 v4 UUID generator and global polyfill for crypto.randomUUID.
+ *
+ * In modern browsers, `crypto.randomUUID()` is restricted to Secure Contexts
+ * (HTTPS or localhost). When Shuffle Security is accessed over plain HTTP via
+ * an IP address or internal hostname (e.g. http://8.234.112.65:3002),
+ * `crypto.randomUUID` is undefined, throwing:
+ *   TypeError: crypto.randomUUID is not a function
+ *
+ * This module ensures:
+ * 1. A resilient `safeRandomUUID()` function that works in all contexts:
+ *    - Uses native `crypto.randomUUID()` if available
+ *    - Falls back to `crypto.getRandomValues()` (which IS allowed in insecure contexts)
+ *    - Falls back to `Math.random()` in extreme environments
+ * 2. A global shim installed on `crypto` and `Crypto.prototype` so any third-party
+ *    or inline calls to `crypto.randomUUID()` succeed transparently.
+ */
+/**
+ * Generates an RFC 4122 v4 compliant UUID string.
+ * Safe to call in both secure and insecure contexts (plain HTTP, older browsers, SSR).
+ */
+declare function safeRandomUUID(): string;
+declare const uuid: typeof safeRandomUUID;
+/**
+ * Installs `randomUUID` on `crypto` and `Crypto.prototype` if not already present.
+ */
+declare function installCryptoRandomUuidPolyfill(): void;
+
+/**
+ * Global Browser Compatibility Shims & Defensive Resilience Layer.
+ *
+ * Prevents runtime crashes caused by restricted, undefined, or throwing
+ * browser APIs in insecure contexts (plain HTTP/IP, e.g. http://8.234.112.65:3002),
+ * older browsers, embedded WebViews, sandboxed iframes, and SSR environments.
+ *
+ * Polyfills and defensive wrappers included:
+ * 1. crypto.randomUUID (via crypto-polyfill)
+ * 2. navigator.clipboard.writeText / readText (with fallback to textarea + execCommand)
+ * 3. globalThis.ResizeObserver (safe no-op fallback)
+ * 4. globalThis.IntersectionObserver (safe no-op fallback)
+ * 5. window.matchMedia (safe media query list fallback)
+ * 6. globalThis.structuredClone (safe JSON/object clone fallback)
+ * 7. performance.now (Date.now fallback)
+ * 8. Element.prototype.scrollIntoView (safe option normalization)
+ */
+/**
+ * Headless fallback copy using an offscreen textarea and document.execCommand('copy').
+ * Operates reliably in insecure contexts (HTTP/IP) where navigator.clipboard is absent.
+ */
+declare function fallbackCopyText(text: string): boolean;
+/**
+ * Installs navigator.clipboard polyfill and wraps existing writeText with fallback.
+ */
+declare function installClipboardPolyfill(): void;
+
+/**
+ * Self-contained clipboard export for the Singul / Shuffle-MCPs bundle.
+ */
+
+declare function copyToClipboard(text: string): Promise<boolean>;
+
 /**
  * ShuffleMcpThemeProvider
  *
@@ -68,6 +129,72 @@ interface ShuffleHostProps {
     colorMode?: 'light' | 'dark' | 'auto';
 }
 
+interface AiAgentPromptsEditorProps {
+    /** Ordered list of prompts. */
+    prompts: string[];
+    /** Per-prompt allow-list of app IDs/names (parallel array to `prompts`). */
+    apps: string[][];
+    /** Read-only mode: render prompts as plain text, no edit/add/remove. */
+    readOnly?: boolean;
+    /** Optional skill label (e.g. "Incident Handler") to show shared permission context. */
+    skillLabel?: string;
+    /** Optional check if an app key is a built-in default app for the active skill. */
+    isBuiltInApp?: (appKey: string) => boolean;
+    /** Edit handlers — required when `readOnly` is false. */
+    onChangePrompt?: (index: number, value: string) => void;
+    onRemovePrompt?: (index: number) => void;
+    onAddPrompt?: () => void;
+    onRemoveApp?: (promptIndex: number, appKey: string) => void;
+    onAddAppRequested?: (promptIndex: number) => void;
+    /** Resolves an app key to its display metadata. */
+    resolveAppMeta: (key: string) => {
+        name: string;
+        image: string;
+    };
+    /** Optional slot to render a richer prompt editor (e.g. PopupTextEditor).
+     *  If omitted, a multiline MUI TextField is rendered in edit mode. */
+    renderPromptInput?: (props: {
+        index: number;
+        value: string;
+        onChange: (next: string) => void;
+        placeholder: string;
+    }) => React__default.ReactNode;
+}
+
+interface AppTitleHeaderProps extends ShuffleHostProps {
+    /** Display name of the app (will be capitalized via CSS). */
+    name: string;
+    /** Image URL for the app icon. */
+    image?: string;
+    /** Whether at least one valid authentication exists. */
+    hasValidAuth?: boolean;
+    /** Whether at least one auth entry exists (valid or not). */
+    hasAnyAuth?: boolean;
+    /** Whether the host is authenticated — controls Verified/Pending chip + Activate button visibility. */
+    isAuthenticated?: boolean;
+    /** App categories to display as chips. */
+    categories?: string[];
+    /** Activation state — `null` hides the Activate button. */
+    isActivated?: boolean | null;
+    /** Whether activation toggle is in-flight. */
+    activateLoading?: boolean;
+    /** Called when user clicks Activate/Deactivate. */
+    onActivateToggle?: () => void;
+    /** Ingestion state — `null` or undefined hides the Ingest button. */
+    isIngestEnabled?: boolean | null;
+    /** Whether ingestion toggle is in-flight. */
+    ingestLoading?: boolean;
+    /** Called when user clicks Enable ingest / Ingest enabled. */
+    onIngestToggle?: () => void;
+    /** When true, visually highlight the Activate button to signal an
+     *  automatic click is happening (e.g. from a usecase auto-activate flow). */
+    highlightActivate?: boolean;
+    /** When provided, replaces the Activate button with "+ Add". */
+    onAdd?: () => void;
+    /** Called when the auth status chip is clicked (host may expand its auth section). */
+    onAuthClick?: () => void;
+}
+
 /**
  * Local Singul Library - Helpers
  * This is a local copy for development. Changes here should be merged back to:
@@ -247,266 +374,6 @@ interface ShuffleMCPProps extends ShuffleHostProps {
     onCreateNewApp?: () => void;
 }
 
-/**
- * Local Singul Library - React Component
- * This is a local copy for development. Changes here should be merged back to:
- * https://github.com/Shuffle/singul.js
- */
-
-interface ShuffleMCPHandle {
-    search: (query: string) => void;
-    clear: () => void;
-    focus: (selectAll?: boolean) => void;
-}
-
-type AuthStatus = 'pending' | 'testing' | 'connected' | 'error';
-interface AppAuthState {
-    systemId: string;
-    status: AuthStatus;
-    credentials: Record<string, string>;
-    errorMessage?: string;
-    successMessage?: string;
-    warningMessage?: string;
-    workflowId?: string;
-    executionId?: string;
-    errorCode?: number;
-}
-interface AuthParameter {
-    description: string;
-    example: string;
-    id: string;
-    name: string;
-    required: boolean;
-    schema: {
-        type: string;
-    };
-}
-interface AppAuthentication {
-    type: string;
-    description?: string;
-    redirect_uri?: string;
-    token_uri?: string;
-    refresh_uri?: string;
-    authorization_url?: string;
-    auth_uri?: string;
-    authorize_url?: string;
-    scope?: string[];
-    client_id?: string;
-    client_secret?: string;
-    parameters?: AuthParameter[];
-}
-interface ApiAuthEntry {
-    id?: string;
-    label?: string;
-    app: {
-        id: string;
-        name: string;
-        large_image?: string;
-    };
-    active?: boolean;
-    created?: number;
-    edited?: number;
-    validation?: {
-        valid: boolean;
-        error?: string;
-        last_valid?: number;
-    };
-}
-interface AppAuthConfigProps extends ShuffleHostProps {
-    apps: AlgoliaSearchApp[];
-    authStates: Record<string, AppAuthState>;
-    authenticatedApps?: ApiAuthEntry[];
-    onAuthChange: (appId: string, credentials: Record<string, string>) => void;
-    onTestConnection: (appId: string, authenticationId?: string) => void;
-    onSaveAuth: (appId: string, credentials: Record<string, string>) => Promise<boolean>;
-    onSelectAuth?: (appId: string, authId: string) => void;
-    onRefreshAuth?: () => Promise<void> | void;
-}
-interface AppAuthCardProps extends ShuffleHostProps {
-    app: AlgoliaSearchApp;
-    authState: AppAuthState;
-    isExpanded: boolean;
-    onToggle: () => void;
-    onAuthChange: (appId: string, credentials: Record<string, string>) => void;
-    onTestConnection: (appId: string, authenticationId?: string) => void;
-    onSaveAuth: (appId: string, credentials: Record<string, string>) => Promise<boolean>;
-    apiAuthEntries: ApiAuthEntry[];
-    onSelectAuth?: (appId: string, authId: string) => void;
-    /** Called to refresh auth entries (e.g. after OAuth popup closes) */
-    onRefreshAuth?: () => Promise<void> | void;
-    /** When true, do NOT auto-fill URL fields with the param.example value. */
-    disableUrlPrefill?: boolean;
-    /** Hide the entire card header row (app icon, name, description, chips, docs, expand). Body stays expanded. */
-    hideHeader?: boolean;
-    /** Hide the "Configured / Not configured" and "Tested / Not tested" chips. */
-    hideStatusChips?: boolean;
-    /** Hide the documentation (book icon) link. */
-    hideDocsLink?: boolean;
-    /** Hide URL-like fields (name/id containing "url", "endpoint", or "host").
-     *  Use when the URL is supplied externally (e.g. via a provider preset). */
-    hideUrlFields?: boolean;
-    /** Render without the outer Card border so the component can be embedded
-     *  inside another bordered container without the nested "double border" look. */
-    borderless?: boolean;
-    /** Compact mode for embedded auth setup (e.g. Local LLM). Hides the
-     *  "Select authentication" dropdown and the large "Pending Verification"
-     *  detail panel with its standalone Test Connection button. The inline
-     *  credentials form (with the small "Test Authentication" CTA) is always
-     *  visible so users can edit & retest in one place. */
-    compactAuthForm?: boolean;
-    /** Always render the "Select authentication" dropdown, even when there are no
-     *  saved entries yet, so the UI does not switch between two different shapes. */
-    alwaysShowAuthSelector?: boolean;
-    /** Suppress the "Authentication saved" success toast (embedded flows that
-     *  already give their own feedback, e.g. the LLM provider config). */
-    suppressSaveToast?: boolean;
-    /** Render additional fields inside the expanded body, above the credential
-     *  inputs. The slot receives the live `localCredentials` and a `setField`
-     *  helper so its values are persisted as part of the auth on Save. */
-    extraFieldsSlot?: (api: {
-        credentials: Record<string, string>;
-        setField: (key: string, value: string) => void;
-    }) => React.ReactNode;
-    /** Known-ahead-of-time auth schema. When provided the fields render
-     *  instantly and no app-config request is made (no "Loading configuration"). */
-    initialAuthConfig?: AppAuthentication;
-}
-declare const AppAuthCard: ({ app, authState, isExpanded, onToggle, onAuthChange, onTestConnection, onSaveAuth, apiAuthEntries, onSelectAuth, onRefreshAuth, disableUrlPrefill, hideHeader, hideStatusChips, hideDocsLink, hideUrlFields, borderless, compactAuthForm, alwaysShowAuthSelector, suppressSaveToast, extraFieldsSlot, initialAuthConfig, globalUrl, userdata, isLoaded, isLoggedIn, serverside, }: AppAuthCardProps) => React$1.JSX.Element;
-declare const AppAuthConfig: ({ apps, authStates, authenticatedApps, onAuthChange, onTestConnection, onSaveAuth, onSelectAuth, onRefreshAuth, globalUrl, userdata, isLoaded, isLoggedIn, serverside, }: AppAuthConfigProps) => React$1.JSX.Element;
-
-/**
- * AppDetailContent — Single source of truth for app details, authentication,
- * MCP testing, and action execution.
- *
- * Used by:
- * 1. AppDetailDrawer — in drawer mode (slide-out drawer with close button & incident stats).
- * 2. AppDetailPage — in page mode (full page with guest locking, quick info, and SEO reporting).
- */
-
-interface AppInfo {
-    name: string;
-    description: string;
-    large_image?: string;
-    categories?: string[];
-    actions?: unknown[];
-    authentication?: AppAuthentication;
-    algoliaId?: string;
-    [key: string]: unknown;
-}
-interface AppDetailContentProps extends ShuffleHostProps {
-    /** Display mode */
-    mode?: 'drawer' | 'page';
-    /** Whether the parent container is open/mounted (used in drawer mode to defer network requests) */
-    open?: boolean;
-    /** App name to load */
-    appName: string | null;
-    /** Pre-resolved Algolia objectID (optional fast path) */
-    appId?: string | null;
-    /** Pre-resolved app icon/image (optional fast path from chip/picker) */
-    appImage?: string | null;
-    /** Callback to close the view (drawer mode) */
-    onClose?: () => void;
-    /** Callback when data is refreshed */
-    onRefresh?: () => void;
-    /** Action when adding to canvas (builder mode) */
-    onAddToCanvas?: (app: {
-        name: string;
-        icon: string;
-        algoliaId?: string | null;
-    }) => void;
-    /** Whether the user is authenticated. In page mode, false enables guest locked sections */
-    isAuthenticated?: boolean;
-    /** Active organization ID for multi-tenant scoping */
-    activeOrgId?: string | null;
-    /** Automatically fire Activate action once app is loaded */
-    autoActivate?: boolean;
-    /** Show incident ingestion/forwarding stats */
-    showIncidentStats?: boolean;
-    /** Show quick info summary cards (Auth Type, Configurations, Status) */
-    showQuickInfo?: boolean;
-    /** Show the live MCP ApiCallViewer */
-    showApiCallViewer?: boolean;
-    /** When true and isAuthenticated is false, renders GuestLockedSection */
-    allowGuestLocked?: boolean;
-    /** Notifies parent when app info is resolved (useful for page SEO / usePageMeta) */
-    onAppInfoLoaded?: (info: AppInfo | null) => void;
-}
-/**
- * Compares a requested app name against a resolved app name to determine if they match,
- * close-match, or mismatch.
- */
-declare function checkAppNameMatch(requested?: string | null, resolved?: string | null): {
-    isMatch: boolean;
-    isCloseMatch: boolean;
-    mismatch: boolean;
-};
-
-interface AiAgentPromptsEditorProps {
-    /** Ordered list of prompts. */
-    prompts: string[];
-    /** Per-prompt allow-list of app IDs/names (parallel array to `prompts`). */
-    apps: string[][];
-    /** Read-only mode: render prompts as plain text, no edit/add/remove. */
-    readOnly?: boolean;
-    /** Optional skill label (e.g. "Incident Handler") to show shared permission context. */
-    skillLabel?: string;
-    /** Optional check if an app key is a built-in default app for the active skill. */
-    isBuiltInApp?: (appKey: string) => boolean;
-    /** Edit handlers — required when `readOnly` is false. */
-    onChangePrompt?: (index: number, value: string) => void;
-    onRemovePrompt?: (index: number) => void;
-    onAddPrompt?: () => void;
-    onRemoveApp?: (promptIndex: number, appKey: string) => void;
-    onAddAppRequested?: (promptIndex: number) => void;
-    /** Resolves an app key to its display metadata. */
-    resolveAppMeta: (key: string) => {
-        name: string;
-        image: string;
-    };
-    /** Optional slot to render a richer prompt editor (e.g. PopupTextEditor).
-     *  If omitted, a multiline MUI TextField is rendered in edit mode. */
-    renderPromptInput?: (props: {
-        index: number;
-        value: string;
-        onChange: (next: string) => void;
-        placeholder: string;
-    }) => React__default.ReactNode;
-}
-
-interface AppTitleHeaderProps extends ShuffleHostProps {
-    /** Display name of the app (will be capitalized via CSS). */
-    name: string;
-    /** Image URL for the app icon. */
-    image?: string;
-    /** Whether at least one valid authentication exists. */
-    hasValidAuth?: boolean;
-    /** Whether at least one auth entry exists (valid or not). */
-    hasAnyAuth?: boolean;
-    /** Whether the host is authenticated — controls Verified/Pending chip + Activate button visibility. */
-    isAuthenticated?: boolean;
-    /** App categories to display as chips. */
-    categories?: string[];
-    /** Activation state — `null` hides the Activate button. */
-    isActivated?: boolean | null;
-    /** Whether activation toggle is in-flight. */
-    activateLoading?: boolean;
-    /** Called when user clicks Activate/Deactivate. */
-    onActivateToggle?: () => void;
-    /** Ingestion state — `null` or undefined hides the Ingest button. */
-    isIngestEnabled?: boolean | null;
-    /** Whether ingestion toggle is in-flight. */
-    ingestLoading?: boolean;
-    /** Called when user clicks Enable ingest / Ingest enabled. */
-    onIngestToggle?: () => void;
-    /** When true, visually highlight the Activate button to signal an
-     *  automatic click is happening (e.g. from a usecase auto-activate flow). */
-    highlightActivate?: boolean;
-    /** When provided, replaces the Activate button with "+ Add". */
-    onAdd?: () => void;
-    /** Called when the auth status chip is clicked (host may expand its auth section). */
-    onAuthClick?: () => void;
-}
-
 interface AppAuthSectionProps extends ShuffleHostProps {
     /** Display name (used in copy when no auth exists). */
     displayName: string;
@@ -840,6 +707,43 @@ interface AgentUIProps {
     vulnerabilityId?: string;
     /** Optional target workflow ID for edit-workflow skill */
     workflowId?: string;
+    /** Optional custom renderer for the tool search drawer (e.g. AppSearchDrawer from Shuffle-Core) */
+    renderToolDrawer?: (props: ToolDrawerRenderProps) => React__default.ReactNode;
+    /** Optional custom renderer for the app detail drawer (e.g. AppDetailDrawer from Shuffle-Core) */
+    renderAppDetailDrawer?: (props: AppDetailDrawerRenderProps) => React__default.ReactNode;
+}
+interface ToolDrawerRenderProps {
+    open: boolean;
+    initialQuery?: string;
+    onClose: () => void;
+    title?: string;
+    subtitle?: string;
+    multiSelect?: boolean;
+    selectedApps: Array<{
+        name: string;
+        id?: string | null;
+        icon?: string;
+    }>;
+    globalUrl?: string;
+    theme?: string;
+    colorMode?: 'light' | 'dark' | 'auto';
+    onSelectionChange: (next: Array<{
+        name: string;
+        id?: string | null;
+        icon?: string;
+    }>) => void;
+}
+interface AppDetailDrawerRenderProps {
+    open: boolean;
+    onClose: () => void;
+    appName?: string | null;
+    appId?: string | null;
+    appImage?: string | null;
+    activeOrgId?: string | null;
+    globalUrl?: string;
+    theme?: string;
+    colorMode?: 'light' | 'dark' | 'auto';
+    onRefresh?: () => void;
 }
 /** Set of confirmed live built-in Shuffle services that are always available in the platform */
 declare const VERIFIED_BUILTIN_APPS: Set<string>;
@@ -877,10 +781,10 @@ interface UseAgentPromptPrefixOptions {
     persist?: boolean;
 }
 declare const useAgentPromptPrefix: (options?: UseAgentPromptPrefixOptions) => {
-    prompt: string;
-    savePrompt: (next: string) => Promise<boolean>;
-    hasFetched: boolean;
-    isSaving: boolean;
+    prompt: any;
+    savePrompt: any;
+    hasFetched: any;
+    isSaving: any;
 };
 
 type AgentRunDrawerTab = 'run' | 'permissions' | 'localLLM';
@@ -1247,7 +1151,7 @@ interface AskAiWidgetProps extends Omit<AskAiSidePanelProps, 'open' | 'onClose'>
 /**
  * Convenience hook to get the active agent context for a given route.
  */
-declare const useContextAwareAgent: (pathname?: string, search?: string) => AgentResolvedContext;
+declare const useContextAwareAgent: (pathname?: string, search?: string) => any;
 
 /**
  * ApiCallViewer — Standardized, compact API call inspector and test runner.
@@ -1527,6 +1431,17 @@ interface AgentActivityListProps extends ShuffleHostProps {
     initialRuns?: AgentRun[];
     /** When true, skips remote activity fetching entirely (e.g. for demo runs). */
     disableFetch?: boolean;
+    /** Optional custom renderer for the app detail drawer (e.g. from Shuffle-Core) */
+    renderAppDetailDrawer?: (props: {
+        open: boolean;
+        onClose: () => void;
+        appName?: string | null;
+        appId?: string | null;
+        activeOrgId?: string | null;
+        globalUrl?: string;
+        theme?: string;
+        colorMode?: 'light' | 'dark' | 'auto';
+    }) => React.ReactNode;
 }
 
 interface AgentExecutionDrawerProps extends ShuffleHostProps {
@@ -1607,6 +1522,10 @@ interface AgentsViewProps extends ShuffleHostProps {
     usecaseFilters?: AgentUsecaseFilter[];
     /** Per-skill readiness CTAs forwarded to the embedded AgentUI. */
     presetCtas?: AgentUIProps['presetCtas'];
+    /** Custom renderer for the tool search drawer (forwarded to AgentUI) */
+    renderToolDrawer?: AgentUIProps['renderToolDrawer'];
+    /** Custom renderer for the app detail drawer (forwarded to AgentUI and AgentActivityList) */
+    renderAppDetailDrawer?: AgentUIProps['renderAppDetailDrawer'];
 }
 
 interface AgentLocalModel {
@@ -1631,24 +1550,6 @@ interface LocalLLMConfigProps extends ShuffleHostProps {
     open?: boolean;
 }
 
-/**
- * AddAppModal — Two-phase modal for finding and authenticating apps.
- *
- * Phase 1: ShuffleMCP search (same style as /onboarding/sources)
- * Phase 2: AppAuthCard for the selected app (same as /onboarding/authenticate)
- *
- * Self-contained: lives in Shuffle-MCPs so it can be used inside the library
- * (e.g., AppSearchDrawer) without host-app imports.
- */
-interface AddAppModalProps {
-    open: boolean;
-    onClose: () => void;
-    /** Initial search query (e.g. category label like "SIEM") */
-    initialQuery: string;
-    /** Category label for display */
-    categoryLabel: string;
-}
-
 /**
  * useAppAuthFlow — Shared hook for the search→authenticate flow.
  * Encapsulates fetching auth entries, saving credentials, and testing connections.
@@ -1657,18 +1558,17 @@ interface AddAppModalProps {
  * Self-contained: lives in Shuffle-MCPs so library consumers can use the same
  * auth flow without host-app wiring.
  */
-
 declare function useAppAuthFlow(): {
-    selectedApp: AlgoliaSearchApp;
-    authState: AppAuthState;
-    authenticatedApps: ApiAuthEntry[];
-    authLoading: boolean;
-    selectApp: (app: AlgoliaSearchApp) => void;
-    clearSelection: () => void;
-    handleAuthChange: (_appId: string, credentials: Record<string, string>) => void;
-    handleTestConnection: (systemId: string, authenticationId?: string) => Promise<void>;
-    handleSaveAuth: (appId: string, credentials: Record<string, string>) => Promise<boolean>;
-    refreshAuth: () => Promise<void>;
+    selectedApp: any;
+    authState: any;
+    authenticatedApps: any;
+    authLoading: any;
+    selectApp: any;
+    clearSelection: any;
+    handleAuthChange: any;
+    handleTestConnection: any;
+    handleSaveAuth: any;
+    refreshAuth: any;
 };
 
 /**
@@ -1834,13 +1734,13 @@ declare const refreshAllIntegrationStatus: () => void;
 declare const IntegrationStatus: ({ collapsed, filterApps, onAddClick, iconSize, onDisable, disabledApps, showAll, hideAddButton, hideHeader, priorityCategory, extraApps }: IntegrationStatusProps) => React$1.JSX.Element;
 
 declare function useAppAuth(): {
-    authStates: Record<string, AppAuthState>;
-    authenticatedApps: ApiAuthEntry[];
-    loading: boolean;
-    handleAuthChange: (systemId: string, credentials: Record<string, string>) => void;
-    handleTestConnection: (systemId: string, authenticationId?: string) => Promise<void>;
-    handleSaveAuth: (appId: string, credentials: Record<string, string>, appName?: string, label?: string) => Promise<boolean>;
-    refreshAuth: () => Promise<void>;
+    authStates: any;
+    authenticatedApps: any;
+    loading: any;
+    handleAuthChange: any;
+    handleTestConnection: any;
+    handleSaveAuth: any;
+    refreshAuth: any;
 };
 
 interface AppDetailContextType {
@@ -1899,12 +1799,121 @@ interface AgentIconProps {
  */
 declare const AgentIcon: ({ size, className, style }: AgentIconProps) => React$1.JSX.Element;
 
-/**
- * Shuffle Datastore Service
- *
- * Provides reusable functions for interacting with the Shuffle datastore API.
- * Uses the correct Shuffle cache API endpoints.
- */
+type AuthStatus = 'pending' | 'testing' | 'connected' | 'error';
+interface AppAuthState {
+    systemId: string;
+    status: AuthStatus;
+    credentials: Record<string, string>;
+    errorMessage?: string;
+    successMessage?: string;
+    warningMessage?: string;
+    workflowId?: string;
+    executionId?: string;
+    errorCode?: number;
+}
+interface AuthParameter {
+    description: string;
+    example: string;
+    id: string;
+    name: string;
+    required: boolean;
+    schema: {
+        type: string;
+    };
+}
+interface AppAuthentication {
+    type: string;
+    description?: string;
+    redirect_uri?: string;
+    token_uri?: string;
+    refresh_uri?: string;
+    authorization_url?: string;
+    auth_uri?: string;
+    authorize_url?: string;
+    scope?: string[];
+    client_id?: string;
+    client_secret?: string;
+    parameters?: AuthParameter[];
+}
+interface ApiAuthEntry {
+    id?: string;
+    label?: string;
+    app: {
+        id: string;
+        name: string;
+        large_image?: string;
+    };
+    active?: boolean;
+    created?: number;
+    edited?: number;
+    validation?: {
+        valid: boolean;
+        error?: string;
+        last_valid?: number;
+    };
+}
+interface AppAuthConfigProps extends ShuffleHostProps {
+    apps: AlgoliaSearchApp[];
+    authStates: Record<string, AppAuthState>;
+    authenticatedApps?: ApiAuthEntry[];
+    onAuthChange: (appId: string, credentials: Record<string, string>) => void;
+    onTestConnection: (appId: string, authenticationId?: string) => void;
+    onSaveAuth: (appId: string, credentials: Record<string, string>) => Promise<boolean>;
+    onSelectAuth?: (appId: string, authId: string) => void;
+    onRefreshAuth?: () => Promise<void> | void;
+}
+interface AppAuthCardProps extends ShuffleHostProps {
+    app: AlgoliaSearchApp;
+    authState: AppAuthState;
+    isExpanded: boolean;
+    onToggle: () => void;
+    onAuthChange: (appId: string, credentials: Record<string, string>) => void;
+    onTestConnection: (appId: string, authenticationId?: string) => void;
+    onSaveAuth: (appId: string, credentials: Record<string, string>) => Promise<boolean>;
+    apiAuthEntries: ApiAuthEntry[];
+    onSelectAuth?: (appId: string, authId: string) => void;
+    /** Called to refresh auth entries (e.g. after OAuth popup closes) */
+    onRefreshAuth?: () => Promise<void> | void;
+    /** When true, do NOT auto-fill URL fields with the param.example value. */
+    disableUrlPrefill?: boolean;
+    /** Hide the entire card header row (app icon, name, description, chips, docs, expand). Body stays expanded. */
+    hideHeader?: boolean;
+    /** Hide the "Configured / Not configured" and "Tested / Not tested" chips. */
+    hideStatusChips?: boolean;
+    /** Hide the documentation (book icon) link. */
+    hideDocsLink?: boolean;
+    /** Hide URL-like fields (name/id containing "url", "endpoint", or "host").
+     *  Use when the URL is supplied externally (e.g. via a provider preset). */
+    hideUrlFields?: boolean;
+    /** Render without the outer Card border so the component can be embedded
+     *  inside another bordered container without the nested "double border" look. */
+    borderless?: boolean;
+    /** Compact mode for embedded auth setup (e.g. Local LLM). Hides the
+     *  "Select authentication" dropdown and the large "Pending Verification"
+     *  detail panel with its standalone Test Connection button. The inline
+     *  credentials form (with the small "Test Authentication" CTA) is always
+     *  visible so users can edit & retest in one place. */
+    compactAuthForm?: boolean;
+    /** Always render the "Select authentication" dropdown, even when there are no
+     *  saved entries yet, so the UI does not switch between two different shapes. */
+    alwaysShowAuthSelector?: boolean;
+    /** Suppress the "Authentication saved" success toast (embedded flows that
+     *  already give their own feedback, e.g. the LLM provider config). */
+    suppressSaveToast?: boolean;
+    /** Render additional fields inside the expanded body, above the credential
+     *  inputs. The slot receives the live `localCredentials` and a `setField`
+     *  helper so its values are persisted as part of the auth on Save. */
+    extraFieldsSlot?: (api: {
+        credentials: Record<string, string>;
+        setField: (key: string, value: string) => void;
+    }) => React.ReactNode;
+    /** Known-ahead-of-time auth schema. When provided the fields render
+     *  instantly and no app-config request is made (no "Loading configuration"). */
+    initialAuthConfig?: AppAuthentication;
+}
+declare const AppAuthCard: ({ app, authState, isExpanded, onToggle, onAuthChange, onTestConnection, onSaveAuth, apiAuthEntries, onSelectAuth, onRefreshAuth, disableUrlPrefill, hideHeader, hideStatusChips, hideDocsLink, hideUrlFields, borderless, compactAuthForm, alwaysShowAuthSelector, suppressSaveToast, extraFieldsSlot, initialAuthConfig, globalUrl, userdata, isLoaded, isLoggedIn, serverside, }: AppAuthCardProps) => React$1.JSX.Element;
+declare const AppAuthConfig: ({ apps, authStates, authenticatedApps, onAuthChange, onTestConnection, onSaveAuth, onSelectAuth, onRefreshAuth, globalUrl, userdata, isLoaded, isLoggedIn, serverside, }: AppAuthConfigProps) => React$1.JSX.Element;
+
 interface DatastoreItem {
     key: string;
     value: string;
@@ -2004,6 +2013,7 @@ declare const setRuntimeOrgId: (orgId: string | null) => void;
  */
 declare const setDatastoreItem: (key: string, value: string | object, category: string, overrideOrgId?: string, options?: {
     regionUrl?: string;
+    ignoreSecurityRules?: boolean;
 }) => Promise<DatastoreResponse>;
 /**
  * Set multiple items in the datastore (bulk create) using v2 API
@@ -2356,46 +2366,42 @@ declare function openSupportEscalation(context: SupportEscalationContext): void;
  * `colorMode` is preserved as a legacy alias (`"auto"` == `"system"`).
  */
 type ShuffleTheme = 'light' | 'dark' | 'system';
+type WithTheme<P> = P & {
+    theme?: ShuffleTheme;
+    colorMode?: ShuffleMcpColorMode;
+};
 
-declare const ShuffleMCP: React__default.ForwardRefExoticComponent<any>;
-
-declare const AppDetailDrawer: React__default.ComponentType<any>;
-declare const AppDetailContent: React__default.ComponentType<any>;
-
-declare const AppSearchDrawer: React__default.ComponentType<any>;
-declare const AiAgentPromptsEditor: React__default.ComponentType<any>;
-
-declare const ShufflePipelinesBanner: React__default.ComponentType<any>;
-declare const AppTitleHeader: React__default.ComponentType<any>;
+declare const AiAgentPromptsEditor: React.ComponentType<WithTheme<P>>;
 
-declare const AppAuthSection: React__default.ComponentType<any>;
+declare const ShufflePipelinesBanner: React.ComponentType<WithTheme<P>>;
+declare const AppTitleHeader: React.ComponentType<WithTheme<P>>;
 
-declare const TryMcpSection: React__default.ComponentType<any>;
+declare const AppAuthSection: React.ComponentType<WithTheme<P>>;
 
-declare const SingulActionsPreview: React__default.ComponentType<any>;
-declare const AgentUI: React__default.ComponentType<any>;
+declare const TryMcpSection: React.ComponentType<WithTheme<P>>;
 
-declare const AgentRunDrawer: React__default.ComponentType<any>;
+declare const SingulActionsPreview: React.ComponentType<WithTheme<P>>;
+declare const AgentUI: React.ComponentType<WithTheme<P>>;
 
-declare const AskAiButton: React__default.ComponentType<any>;
+declare const AgentRunDrawer: React.ComponentType<WithTheme<P>>;
 
-declare const AskAiDrawer: React__default.ComponentType<any>;
+declare const AskAiButton: React.ComponentType<WithTheme<P>>;
 
-declare const AskAiSidePanel: React__default.ComponentType<any>;
+declare const AskAiDrawer: React.ComponentType<WithTheme<P>>;
 
-declare const AskAiWidget: React__default.ComponentType<any>;
+declare const AskAiSidePanel: React.ComponentType<WithTheme<P>>;
 
-declare const ApiCallViewer: React__default.ComponentType<any>;
+declare const AskAiWidget: React.ComponentType<WithTheme<P>>;
 
-declare const AgentActivityList: React__default.ComponentType<any>;
+declare const ApiCallViewer: React.ComponentType<WithTheme<P>>;
 
-declare const AgentExecutionDrawer: React__default.ComponentType<any>;
+declare const AgentActivityList: React.ComponentType<WithTheme<P>>;
 
-declare const AgentsView: React__default.ComponentType<any>;
+declare const AgentExecutionDrawer: React.ComponentType<WithTheme<P>>;
 
-declare const AgentRunDiagnosisBanner: React__default.ComponentType<any>;
-declare const LocalLLMConfig: React__default.ComponentType<any>;
+declare const AgentsView: React.ComponentType<WithTheme<P>>;
 
-declare const AddAppModal: React__default.ComponentType<any>;
+declare const AgentRunDiagnosisBanner: React.ComponentType<WithTheme<P>>;
+declare const LocalLLMConfig: React.ComponentType<WithTheme<P>>;
 
-export { AGENT_DRAWER_CLOSE_EVENT, AGENT_DRAWER_OPEN_EVENT, AGENT_DRAWER_STATE_EVENT, AGENT_PRESETS, AGENT_PROMPT_PREFIX_CATEGORY, API_CONFIG, ASK_AI_PANEL_WIDTH_STORAGE_KEY, AddAppModal, type AddAppModalProps, AgentActivityList, type AgentActivityListProps, type AgentActivityParams, type AgentActivityResponse, type AgentContextApp, type AgentContextRule, type AgentDecision, AgentExecutionDrawer, type AgentExecutionDrawerProps, AgentIcon, type AgentLocalModel, type AgentPreset, AgentPresets, type AgentPresetsProps, AgentPromptPrefixChip, type AgentPromptPrefixChipProps, type AgentResolvedContext, type AgentRun, AgentRunDiagnosisBanner, AgentRunDrawer, type AgentRunDrawerProps, type AgentRunDrawerTab, type AgentRunResult, AgentUI, type AgentUIApp, type AgentUIProps, AgentsView, type AgentsViewProps, AiAgentPromptsEditor, type AiAgentPromptsEditorProps, type AlgoliaSearchApp, type ApiAuthEntry, type ApiCallConfig, ApiCallViewer, type ApiCallViewerProps, AppAuthCard, type AppAuthCardProps, AppAuthConfig, AppAuthSection, type AppAuthSectionProps, type AppAuthState, type AppAuthentication$1 as AppAuthentication, AppDetailContent, type AppDetailContentProps, AppDetailDrawer, AppDetailProvider, type AppInfo, type AppLookupResult, AppSearchDrawer, type AppSelectedEvent, AppTitleHeader, type AppTitleHeaderProps, AskAiButton, type AskAiButtonProps, AskAiDrawer, type AskAiDrawerProps, AskAiSidePanel, type AskAiSidePanelProps, AskAiWidget, type AskAiWidgetProps, type AuthStatus, CASES_PATTERNS, COMMUNICATION_PATTERNS_NAMES, type CategoryAutomation, type CategoryConfig, type ConnectedToolApp, type CustomStyles, DATASTORE_CATEGORIES, DEFAULT_AGENT_CONTEXT_RULES, DEFAULT_AGENT_PROMPT_PREFIX, DEMO_AGENT_RUNS, type DatastoreDiagnostics, type DatastoreItem, type DatastoreResponse, type DiagnosableRun, type DiagnosisEvidence, EDR_PATTERNS, EMAIL_APP_PATTERNS, FORWARD_TICKETS_WORKFLOW_NAME, type FetchAppsOptions, INGEST_TICKETS_WORKFLOW_NAME, type IngestionCategory, IntegrationStatus, LocalLLMConfig, type LocalLLMConfigProps, type LocalLLMTestResult, MAX_ASK_AI_PANEL_WIDTH, MAX_AUTO_ASSIGNED_TOOLS, MIN_ASK_AI_PANEL_WIDTH, ShuffleMarkdown as Markdown, MarkdownJsonBlock, type OutputDiagnosis, type PageContextChoice, type ResolvedApp, type ResolvedContactUserInfo, SIEM_PATTERNS, type ShuffleHostProps, ShuffleMCP, type ShuffleMCPHandle, type ShuffleMCPProps, ShuffleMarkdown, type ShuffleMcpColorMode, ShuffleMcpThemeProvider, type ShuffleMcpThemeProviderProps, ShufflePipelinesBanner, type ShuffleTheme, SingulActionsPreview, type SupportEscalationContext, THREAT_INTEL_PATTERNS, TryMcpSection, type TryMcpSectionProps, UsageBar, type UsageBarProps, type UseAgentPromptPrefixOptions, VERIFIED_BUILTIN_APPS, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, VideoEmbed, applyRegionFromPayload, buildSupportEscalationUrl, checkAppNameMatch, clearPageContextChoice, ShuffleMCP as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, extractActionAppNames, extractValidatedIngestionApps, extractWorkflowActionAppNames, extractWorkflowAppNames, fetchApps, fetchAppsViaApiConfig, fetchConnectedTools, filterItemsByCategory, findForwardTicketsWorkflow, findIngestTicketsWorkflow, getActivePageEntityName, getAgentContextRules, getApiUrl, getAuthHeader, getCachedConnectedTools, getDatastoreByCategory, getDatastoreItem, getDatastoreItemPublic, getDatastorePageSize, getFailureInfo, getHostBaseUrl, getIngestionCategory, getPageContextChoice, hasOutputWarning, installFetchBreaker, invalidateAppsCache, invalidateResolvedApps, isAgentRoute, isCloud, isCloudDomain, isEmailApp, isIngestionApp, isOnprem, isShuffleCloudDomain, isShuffleSecurityBackend, isThreatIntelApp, isVulnScannerApp, isWorkflowScheduleStopped, mapCloudRegionUrl, matchRoutePattern, mergeConnectedTools, normalizeAppName, openSupportEscalation, parseRunResult, refreshAllIntegrationStatus, registerAgentContextRule, registerProtectedOrigin, resetRegionUrl, resolveAgentContext, resolveApp, resolveApps, resolveConnectedTools, resolveContactUserInfo, resolveVideoUrl, scheduleAgentRun, searchAgentActivity, seedResolvedApp, setCachedConnectedTools, setDatastoreItem, setDatastoreItems, setHostBaseUrl, setPageContextChoice, setRegionUrl, setRuntimeOrgId, setToastImpl, shuffleFetch, toast, useAgentPromptPrefix, useAppAuth, useAppAuthFlow, useAppDetail, useAppDetailOptional, useAppLookup, useContextAwareAgent, useSyncHostBaseUrl };
+export { AGENT_DRAWER_CLOSE_EVENT, AGENT_DRAWER_OPEN_EVENT, AGENT_DRAWER_STATE_EVENT, AGENT_PRESETS, AGENT_PROMPT_PREFIX_CATEGORY, API_CONFIG, ASK_AI_PANEL_WIDTH_STORAGE_KEY, AgentActivityList, type AgentActivityListProps, type AgentActivityParams, type AgentActivityResponse, type AgentContextApp, type AgentContextRule, type AgentDecision, AgentExecutionDrawer, type AgentExecutionDrawerProps, AgentIcon, type AgentLocalModel, type AgentPreset, AgentPresets, type AgentPresetsProps, AgentPromptPrefixChip, type AgentPromptPrefixChipProps, type AgentResolvedContext, type AgentRun, AgentRunDiagnosisBanner, AgentRunDrawer, type AgentRunDrawerProps, type AgentRunDrawerTab, type AgentRunResult, AgentUI, type AgentUIApp, type AgentUIProps, AgentsView, type AgentsViewProps, AiAgentPromptsEditor, type AiAgentPromptsEditorProps, type AlgoliaSearchApp, type ApiAuthEntry, type ApiCallConfig, ApiCallViewer, type ApiCallViewerProps, AppAuthCard, type AppAuthCardProps, AppAuthConfig, AppAuthSection, type AppAuthSectionProps, type AppAuthState, type AppAuthentication$1 as AppAuthentication, type AppDetailDrawerRenderProps, AppDetailProvider, type AppLookupResult, type AppSelectedEvent, AppTitleHeader, type AppTitleHeaderProps, AskAiButton, type AskAiButtonProps, AskAiDrawer, type AskAiDrawerProps, AskAiSidePanel, type AskAiSidePanelProps, AskAiWidget, type AskAiWidgetProps, type AuthStatus, CASES_PATTERNS, COMMUNICATION_PATTERNS_NAMES, type CategoryAutomation, type CategoryConfig, type ConnectedToolApp, type CustomStyles, DATASTORE_CATEGORIES, DEFAULT_AGENT_CONTEXT_RULES, DEFAULT_AGENT_PROMPT_PREFIX, DEMO_AGENT_RUNS, type DatastoreDiagnostics, type DatastoreItem, type DatastoreResponse, type DiagnosableRun, type DiagnosisEvidence, EDR_PATTERNS, EMAIL_APP_PATTERNS, FORWARD_TICKETS_WORKFLOW_NAME, type FetchAppsOptions, INGEST_TICKETS_WORKFLOW_NAME, type IngestionCategory, IntegrationStatus, LocalLLMConfig, type LocalLLMConfigProps, type LocalLLMTestResult, MAX_ASK_AI_PANEL_WIDTH, MAX_AUTO_ASSIGNED_TOOLS, MIN_ASK_AI_PANEL_WIDTH, ShuffleMarkdown as Markdown, MarkdownJsonBlock, type OutputDiagnosis, type PageContextChoice, type ResolvedApp, type ResolvedContactUserInfo, SIEM_PATTERNS, type ShuffleHostProps, type ShuffleMCPProps, ShuffleMarkdown, type ShuffleMcpColorMode, ShuffleMcpThemeProvider, type ShuffleMcpThemeProviderProps, ShufflePipelinesBanner, type ShuffleTheme, SingulActionsPreview, type SupportEscalationContext, THREAT_INTEL_PATTERNS, type ToolDrawerRenderProps, TryMcpSection, type TryMcpSectionProps, UsageBar, type UsageBarProps, type UseAgentPromptPrefixOptions, VERIFIED_BUILTIN_APPS, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, VideoEmbed, applyRegionFromPayload, buildSupportEscalationUrl, clearPageContextChoice, copyToClipboard, AgentsView as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, extractActionAppNames, extractValidatedIngestionApps, extractWorkflowActionAppNames, extractWorkflowAppNames, fallbackCopyText as fallbackCopyToClipboard, fetchApps, fetchAppsViaApiConfig, fetchConnectedTools, filterItemsByCategory, findForwardTicketsWorkflow, findIngestTicketsWorkflow, getActivePageEntityName, getAgentContextRules, getApiUrl, getAuthHeader, getCachedConnectedTools, getDatastoreByCategory, getDatastoreItem, getDatastoreItemPublic, getDatastorePageSize, getFailureInfo, getHostBaseUrl, getIngestionCategory, getPageContextChoice, hasOutputWarning, installClipboardPolyfill, installCryptoRandomUuidPolyfill, installFetchBreaker, invalidateAppsCache, invalidateResolvedApps, isAgentRoute, isCloud, isCloudDomain, isEmailApp, isIngestionApp, isOnprem, isShuffleCloudDomain, isShuffleSecurityBackend, isThreatIntelApp, isVulnScannerApp, isWorkflowScheduleStopped, mapCloudRegionUrl, matchRoutePattern, mergeConnectedTools, normalizeAppName, openSupportEscalation, parseRunResult, refreshAllIntegrationStatus, registerAgentContextRule, registerProtectedOrigin, resetRegionUrl, resolveAgentContext, resolveApp, resolveApps, resolveConnectedTools, resolveContactUserInfo, resolveVideoUrl, safeRandomUUID, scheduleAgentRun, searchAgentActivity, seedResolvedApp, setCachedConnectedTools, setDatastoreItem, setDatastoreItems, setHostBaseUrl, setPageContextChoice, setRegionUrl, setRuntimeOrgId, setToastImpl, shuffleFetch, toast, useAgentPromptPrefix, useAppAuth, useAppAuthFlow, useAppDetail, useAppDetailOptional, useAppLookup, useContextAwareAgent, useSyncHostBaseUrl, uuid };