@shuffleio/shuffle-mcps 0.0.16 → 0.0.18

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import React$1, { ReactNode } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import { SxProps, Theme } from '@mui/material';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
  * ShuffleMcpThemeProvider
@@ -30,10 +30,11 @@ import { SxProps, Theme } from '@mui/material';
 
 type ShuffleMcpColorMode = "light" | "dark" | "auto";
 interface ShuffleMcpThemeProviderProps {
-    children: React$1.ReactNode;
+    children?: React$1.ReactNode;
     /**
      * Color mode for the wrapped subtree.
-     * - `"auto"` (default) — follow the host page's `.dark` class on `<html>`.
+     * - `"dark"` (default) — render exactly like Shuffle Security standalone.
+     * - `"auto"` — follow the host page's `.dark` class on `<html>`.
      * - `"light"` / `"dark"` — pin the subtree to that scheme via a wrapping div.
      */
     mode?: ShuffleMcpColorMode;
@@ -244,115 +245,6 @@ interface ShuffleMCPHandle {
     search: (query: string) => void;
     clear: () => void;
 }
-declare const ShuffleMCP: React$1.ForwardRefExoticComponent<ShuffleMCPProps & React$1.RefAttributes<ShuffleMCPHandle>>;
-
-/**
- * Singul standard actions catalog, keyed by lowercase category fragment.
- * Mirrors the canonical action names exposed by https://singul.io —
- * each name becomes the `{action}` segment in `POST /api/{action}`.
- * Fields shown here are starter parameters; the full schema lives on
- * the Singul side and is editable in the curl preview below.
- */
-interface AppDetailDrawerProps extends ShuffleHostProps {
-    open: boolean;
-    onClose: () => void;
-    /** App name to load */
-    appName: string | null;
-    /** Pre-resolved Algolia objectID — bypasses Algolia lookup when provided (e.g. when the
-     *  caller already had the hit, like AppSearchDrawer / "Add Ingestion Source"). */
-    appId?: string | null;
-    /** Anchor side */
-    anchor?: 'left' | 'right';
-    /** Width in px */
-    width?: number;
-    /** Called when drawer closes so parent can refresh data */
-    onRefresh?: () => void;
-    /** When set, replaces the Activate button with "+ Add" and calls this on click */
-    onAddToCanvas?: (appInfo: {
-        name: string;
-        icon: string;
-        algoliaId: string | null;
-    }) => void;
-    /** Whether the current user is authenticated. Defaults to true. */
-    isAuthenticated?: boolean;
-    /** Host app's currently active org id. If different from the library's tracked org,
-     *  an `Org-Id` header is injected into the Singul curl preview. */
-    activeOrgId?: string | null;
-}
-declare function AppDetailDrawer({ open, onClose, appName, appId, anchor, width, onRefresh, onAddToCanvas, isAuthenticated, activeOrgId, }: AppDetailDrawerProps): react_jsx_runtime.JSX.Element;
-
-interface ConnectionPathApp {
-    name: string;
-    icon: string;
-    hasValidAuth?: boolean;
-    isActiveOnly?: boolean;
-}
-interface AppSearchDrawerProps extends ShuffleHostProps {
-    open: boolean;
-    onClose: () => void;
-    initialQuery?: string;
-    title?: string;
-    subtitle?: string;
-    anchor?: 'left' | 'right';
-    width?: number;
-    /** Show the Shuffle Pipelines banner above search results */
-    showPipelinesBanner?: boolean;
-    /** If provided, selecting an app calls this instead of opening AppDetailDrawer */
-    onQuickSelect?: (app: {
-        name: string;
-        icon: string;
-        categories: string[];
-        id: string | null;
-    }) => void;
-    /** If provided, called before default behavior. Return true to prevent opening detail drawer. */
-    onSelectOverride?: (app: {
-        name: string;
-        icon: string;
-        categories: string[];
-    }) => boolean;
-    /** Called when the detail drawer closes, with the app name that was being configured */
-    onDetailClose?: (appName: string) => void;
-    /** When set, replaces Activate with "+ Add" in the detail drawer */
-    onAddToCanvas?: (appInfo: {
-        name: string;
-        icon: string;
-        algoliaId: string | null;
-    }) => void;
-    /** When set, apps matching this category are sorted to the top in user's apps */
-    priorityCategory?: string;
-    /** Apps currently in the connection path diagram — shown first in the drawer */
-    connectionPathApps?: ConnectionPathApp[];
-    /** Apps to pin at the top of the ShuffleMCP search results (deduped by name). */
-    pinnedApps?: Array<{
-        name: string;
-        image_url: string;
-        categories?: string[];
-        objectID?: string;
-    }>;
-    /** Highlight (pulsing ring) the matching app card after `highlightDelayMs` */
-    highlightAppName?: string;
-    /** Delay before the highlight kicks in (default 5000ms) */
-    highlightDelayMs?: number;
-    /** Enable multi-select: clicking apps toggles them in/out of the selection,
-     *  drawer stays open, and the picker shows checkboxes + a primary-bordered
-     *  highlight on already-chosen rows. */
-    multiSelect?: boolean;
-    /** Currently chosen apps (used to highlight rows in multi-select mode).
-     *  Match is by objectID first, then by normalized name. */
-    selectedApps?: Array<{
-        name: string;
-        id?: string | null;
-        icon?: string;
-    }>;
-    /** Fires whenever the selection changes in multi-select mode. */
-    onSelectionChange?: (apps: Array<{
-        name: string;
-        id: string | null;
-        icon: string;
-        categories: string[];
-    }>) => void;
-}
-declare function AppSearchDrawer({ open, onClose, initialQuery, title, subtitle, anchor, width, showPipelinesBanner, onQuickSelect, onSelectOverride, onDetailClose, onAddToCanvas, priorityCategory, connectionPathApps, pinnedApps, highlightAppName, highlightDelayMs, multiSelect, selectedApps, onSelectionChange, }: AppSearchDrawerProps): react_jsx_runtime.JSX.Element;
 
 interface AiAgentPromptsEditorProps {
     /** Ordered list of prompts. */
@@ -381,9 +273,6 @@ interface AiAgentPromptsEditorProps {
         placeholder: string;
     }) => React$1.ReactNode;
 }
-declare const AiAgentPromptsEditor: React$1.FC<AiAgentPromptsEditorProps>;
-
-declare function ShufflePipelinesBanner(): react_jsx_runtime.JSX.Element;
 
 interface AppTitleHeaderProps extends ShuffleHostProps {
     /** Display name of the app (will be capitalized via CSS). */
@@ -407,7 +296,6 @@ interface AppTitleHeaderProps extends ShuffleHostProps {
     /** When provided, replaces the Activate button with "+ Add". */
     onAdd?: () => void;
 }
-declare function AppTitleHeader({ name, image, hasValidAuth, hasAnyAuth, isAuthenticated, categories, isActivated, activateLoading, onActivateToggle, onAdd, }: AppTitleHeaderProps): react_jsx_runtime.JSX.Element;
 
 interface AppAuthSectionProps extends ShuffleHostProps {
     /** Display name (used in copy when no auth exists). */
@@ -432,7 +320,6 @@ interface AppAuthSectionProps extends ShuffleHostProps {
     onSaveAuth: (appId: string, credentials: Record<string, string>) => Promise<boolean>;
     onRefreshAuth: () => void;
 }
-declare function AppAuthSection({ displayName, algoliaApp, resolvedAlgoliaId, authState, expanded, onToggle, authCount, isAuthenticated, matchingEntries, onAuthChange, onTestConnection, onSaveAuth, onRefreshAuth, }: AppAuthSectionProps): react_jsx_runtime.JSX.Element;
 
 interface TryMcpSectionProps extends ShuffleHostProps {
     appName: string;
@@ -443,20 +330,6 @@ interface TryMcpSectionProps extends ShuffleHostProps {
     /** App categories — used to pick suggested actions. */
     categories?: string[];
 }
-declare function TryMcpSection({ appName, appIcon, appId, categories }: TryMcpSectionProps): react_jsx_runtime.JSX.Element;
-
-interface SingulActionsPreviewProps extends ShuffleHostProps {
-    appName: string;
-    appIcon?: string;
-    appId?: string | null;
-    categories?: string[];
-    activeOrgId?: string | null;
-    /** Optional click handler invoked when the user presses the
-     *  "Authenticate {App}" button surfaced after an
-     *  `action: "app_authentication"` response. */
-    onAuthenticate?: (appName: string) => void;
-}
-declare const SingulActionsPreview: ({ appName, appIcon, categories, activeOrgId, onAuthenticate, }: SingulActionsPreviewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * AgentUI — Standalone "start + debug agents" surface.
@@ -529,6 +402,17 @@ interface AgentUIProps {
     appPickerTitle?: string;
     /** Subtitle on the AppSearchDrawer. */
     appPickerSubtitle?: string;
+    /**
+     * Handler for the "Choose LLM" chip. When provided, takes full ownership
+     * of the click. When omitted, AgentUI dispatches a window
+     * `agent-drawer-open` CustomEvent — that's what the bundled
+     * `AgentRunDrawer` listens for. On hosts that don't mount the drawer,
+     * provide this prop to wire your own LLM picker (or set it to a no-op
+     * to hide the chip's intent entirely).
+     */
+    onChooseLLM?: () => void;
+    /** Hide the "Choose LLM" chip entirely. */
+    hideChooseLLM?: boolean;
     /** Tooltip on the submit button. Default: "⌘+Enter to send". */
     submitTooltip?: string;
     /** Custom icon for the submit button. */
@@ -633,7 +517,6 @@ interface AgentUIProps {
     /** Style overrides for the inner content card (the column under the run-switcher). */
     contentSx?: SxProps<Theme>;
 }
-declare const AgentUI: React$1.FC<AgentUIProps>;
 
 type AgentRunDrawerTab = 'run' | 'permissions' | 'localLLM';
 interface AgentRunDrawerProps extends ShuffleHostProps {
@@ -672,7 +555,6 @@ interface AgentRunDrawerProps extends ShuffleHostProps {
     /** Style overrides for the body container that wraps the active tab content. */
     bodySx?: SxProps<Theme>;
 }
-declare const AgentRunDrawer: ({ open, onClose, initialTab, permissionsSlot, localLLMSlot, localLLMTabBadge, permissionsDisabled, permissionsDisabledTooltip, agentUIProps, width, title, subtitle, className, paperSx, headerSx, tabsSx, bodySx, }: AgentRunDrawerProps) => react_jsx_runtime.JSX.Element;
 
 /** Check if running on a known Shuffle Cloud domain */
 declare const isCloudDomain: () => boolean;
@@ -688,6 +570,26 @@ declare const isCloud: () => boolean;
  * True when running self-hosted (onprem) — i.e. NOT in Lovable preview AND NOT on a known cloud domain.
  */
 declare const isOnprem: () => boolean;
+/**
+ * Set the dynamic region URL from getinfo response.
+ * Only applies if the URL is a shuffler.io subdomain and different from default.
+ */
+declare const setRegionUrl: (regionUrl: string | undefined | null, orgId: string | undefined | null) => void;
+/**
+ * Called when org changes. Resets region URL to default until next getinfo.
+ */
+declare const resetRegionUrl: () => void;
+/**
+ * Host override — call from a top-level component (or `useSyncHostBaseUrl`)
+ * with the `globalUrl` injected via `ShuffleHostProps`. When set, this beats
+ * region URL and the env-based default for ALL fetches that go through
+ * `getApiUrl()` / `API_CONFIG.baseUrl` / `shuffleFetch`.
+ *
+ * Pass `null` / `undefined` / empty string to clear the override.
+ */
+declare const setHostBaseUrl: (url: string | undefined | null) => void;
+/** Get the currently active host override, if any. */
+declare const getHostBaseUrl: () => string | null;
 declare const API_CONFIG: {
     readonly baseUrl: string;
     version: string;
@@ -822,7 +724,6 @@ interface AgentActivityListProps extends ShuffleHostProps {
     /** Style overrides for each individual run row. */
     rowSx?: SxProps<Theme>;
 }
-declare const AgentActivityList: ({ apiKey, apiBaseUrl, orgId, onRunClick, onEditWorkflow, showSearchBar, showStatusChips, limit, emptyTitle, emptySubtitle, className, sx, toolbarSx, rowSx, }: AgentActivityListProps) => react_jsx_runtime.JSX.Element;
 
 interface AgentExecutionDrawerProps extends ShuffleHostProps {
     open: boolean;
@@ -852,7 +753,6 @@ interface AgentExecutionDrawerProps extends ShuffleHostProps {
     /** Handler for scheduling the loaded agent prompt from the execution view. */
     onSchedule?: AgentUIProps['onSchedule'];
 }
-declare const AgentExecutionDrawer: ({ open, onClose, run, width, apiKey, apiBaseUrl, orgId, className, paperSx, headerSx, bodySx, topBanner, onSchedule, }: AgentExecutionDrawerProps) => react_jsx_runtime.JSX.Element;
 
 interface AgentsViewProps extends ShuffleHostProps {
     /**
@@ -863,8 +763,17 @@ interface AgentsViewProps extends ShuffleHostProps {
     onSchedule: NonNullable<AgentUIProps['onSchedule']>;
     /** Override max content width of the inner stack. Defaults to 820. */
     maxWidth?: number;
+    /**
+     * Optional handler for the "Choose LLM" chip. Forwarded to the embedded
+     * AgentUI. When omitted, AgentUI dispatches its legacy window event
+     * (handled by the bundled AgentRunDrawer in Shuffle Security). On other
+     * hosts, pass this prop to wire your own LLM picker — or set
+     * `hideChooseLLM` to remove the chip entirely.
+     */
+    onChooseLLM?: () => void;
+    /** Hide the "Choose LLM" chip in the embedded AgentUI. */
+    hideChooseLLM?: boolean;
 }
-declare const AgentsView: ({ onSchedule, maxWidth }: AgentsViewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Shared diagnosis utilities for an agent execution result.
@@ -917,21 +826,6 @@ type OutputDiagnosis = {
 };
 declare const diagnoseOutputWarning: (run: DiagnosableRun) => OutputDiagnosis | null;
 
-interface Props extends ShuffleHostProps {
-    run: DiagnosableRun | null | undefined;
-    /** Outer padding wrapper. Defaults to `{ px: 2.5, pb: 0.5 }`. */
-    sx?: Record<string, unknown>;
-    /** When provided, the banner becomes clickable and asks the host to jump
-     *  to the underlying decision (e.g. switch to the detailed timeline,
-     *  expand that row, scroll to it). */
-    onJumpToEvidence?: (decisionIndex: number) => void;
-    /** Stable id used to persist dismissals per-execution. Falls back to
-     *  `run.execution_id` if present. When neither is available, dismiss
-     *  still works for the current mount but is not persisted. */
-    executionId?: string;
-}
-declare const AgentRunDiagnosisBanner: ({ run, sx, onJumpToEvidence, executionId }: Props) => react_jsx_runtime.JSX.Element;
-
 /**
  * useAppLookup — Resolve an app's display name, image, categories,
  * canonical Algolia objectID and matching auth entries from just
@@ -1132,6 +1026,27 @@ declare const useAppDetail: () => AppDetailContextType;
 /** Safe variant: returns null if no provider is mounted. Useful for components used both inside and outside the dashboard. */
 declare const useAppDetailOptional: () => AppDetailContextType;
 
+declare const useSyncHostBaseUrl: (globalUrl: string | undefined | null) => void;
+
+/**
+ * Global fetch circuit breaker.
+ *
+ * Installs a one-time wrapper around `window.fetch` that protects the Shuffle
+ * backend from infinite-loop spam. If the same endpoint (method + URL pathname,
+ * scoped to a Shuffle backend origin) fails repeatedly inside a short window,
+ * subsequent calls fail-fast with a synthetic 503 for a cooldown period.
+ *
+ * This is a safety net — components and hooks should still throttle / cache
+ * their own requests. The breaker only kicks in when something has gone wrong
+ * (a useEffect missing deps, a render loop, an unreachable backend).
+ *
+ * Both Shuffle-Core and Shuffle-MCPs install this — it is idempotent so the
+ * first call wins and the second is a no-op.
+ */
+/** Register a backend origin as one we should guard. Idempotent. */
+declare const registerProtectedOrigin: (url: string | undefined | null) => void;
+declare const installFetchBreaker: () => void;
+
 /**
  * Tiny toast facade — library version. Mirrors the sonner-style surface
  * (`toast(...)`, `toast.success`, `toast.error`, `toast.info`, `toast.warning`)
@@ -1409,4 +1324,35 @@ interface UsageBarProps {
 }
 declare const UsageBar: React$1.FC<UsageBarProps>;
 
-export { API_CONFIG, AgentActivityList, type AgentActivityListProps, type AgentActivityParams, type AgentActivityResponse, type AgentDecision, AgentExecutionDrawer, type AgentExecutionDrawerProps, AgentIcon, 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, AppAuthCard, type AppAuthCardProps, AppAuthConfig, AppAuthSection, type AppAuthSectionProps, type AppAuthState, type AppAuthentication, AppDetailDrawer, AppDetailProvider, type AppLookupResult, AppSearchDrawer, type AppSelectedEvent, AppTitleHeader, type AppTitleHeaderProps, type AuthStatus, CASES_PATTERNS, COMMUNICATION_PATTERNS_NAMES, type CategoryAutomation, type CategoryConfig, type CustomStyles, DATASTORE_CATEGORIES, 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, type OutputDiagnosis, type ResolvedApp, SIEM_PATTERNS, type ShuffleHostProps, ShuffleMCP, type ShuffleMCPHandle, type ShuffleMCPProps, type ShuffleMcpColorMode, ShuffleMcpThemeProvider, type ShuffleMcpThemeProviderProps, ShufflePipelinesBanner, SingulActionsPreview, THREAT_INTEL_PATTERNS, TryMcpSection, type TryMcpSectionProps, UsageBar, type UsageBarProps, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, ShuffleMCP as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, extractValidatedIngestionApps, extractWorkflowAppNames, fetchApps, fetchAppsViaApiConfig, findForwardTicketsWorkflow, findIngestTicketsWorkflow, getApiUrl, getAuthHeader, getDatastoreByCategory, getDatastoreItem, getDatastoreItemPublic, getFailureInfo, getIngestionCategory, hasOutputWarning, invalidateAppsCache, invalidateResolvedApps, isCloud, isCloudDomain, isEmailApp, isIngestionApp, isOnprem, isThreatIntelApp, isVulnScannerApp, isWorkflowScheduleStopped, normalizeAppName, parseRunResult, refreshAllIntegrationStatus, resolveApp, resolveApps, searchAgentActivity, seedResolvedApp, setDatastoreItem, setDatastoreItems, setRuntimeOrgId, setToastImpl, shuffleFetch, toast, useAppAuth, useAppDetail, useAppDetailOptional, useAppLookup };
+/**
+ * Local Singul Library — fully self-contained.
+ * No host-app `@/` imports remain inside this folder (assets aside).
+ */
+
+declare const ShuffleMCP: React$1.ForwardRefExoticComponent<any>;
+
+declare const AppDetailDrawer: React$1.ComponentType<any>;
+declare const AppSearchDrawer: React$1.ComponentType<any>;
+declare const AiAgentPromptsEditor: React$1.ComponentType<any>;
+
+declare const ShufflePipelinesBanner: React$1.ComponentType<any>;
+declare const AppTitleHeader: React$1.ComponentType<any>;
+
+declare const AppAuthSection: React$1.ComponentType<any>;
+
+declare const TryMcpSection: React$1.ComponentType<any>;
+
+declare const SingulActionsPreview: React$1.ComponentType<any>;
+declare const AgentUI: React$1.ComponentType<any>;
+
+declare const AgentRunDrawer: React$1.ComponentType<any>;
+
+declare const AgentActivityList: React$1.ComponentType<any>;
+
+declare const AgentExecutionDrawer: React$1.ComponentType<any>;
+
+declare const AgentsView: React$1.ComponentType<any>;
+
+declare const AgentRunDiagnosisBanner: React$1.ComponentType<any>;
+
+export { API_CONFIG, AgentActivityList, type AgentActivityListProps, type AgentActivityParams, type AgentActivityResponse, type AgentDecision, AgentExecutionDrawer, type AgentExecutionDrawerProps, AgentIcon, 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, AppAuthCard, type AppAuthCardProps, AppAuthConfig, AppAuthSection, type AppAuthSectionProps, type AppAuthState, type AppAuthentication, AppDetailDrawer, AppDetailProvider, type AppLookupResult, AppSearchDrawer, type AppSelectedEvent, AppTitleHeader, type AppTitleHeaderProps, type AuthStatus, CASES_PATTERNS, COMMUNICATION_PATTERNS_NAMES, type CategoryAutomation, type CategoryConfig, type CustomStyles, DATASTORE_CATEGORIES, 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, type OutputDiagnosis, type ResolvedApp, SIEM_PATTERNS, type ShuffleHostProps, ShuffleMCP, type ShuffleMCPHandle, type ShuffleMCPProps, type ShuffleMcpColorMode, ShuffleMcpThemeProvider, type ShuffleMcpThemeProviderProps, ShufflePipelinesBanner, SingulActionsPreview, THREAT_INTEL_PATTERNS, TryMcpSection, type TryMcpSectionProps, UsageBar, type UsageBarProps, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, ShuffleMCP as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, extractValidatedIngestionApps, extractWorkflowAppNames, fetchApps, fetchAppsViaApiConfig, findForwardTicketsWorkflow, findIngestTicketsWorkflow, getApiUrl, getAuthHeader, getDatastoreByCategory, getDatastoreItem, getDatastoreItemPublic, getFailureInfo, getHostBaseUrl, getIngestionCategory, hasOutputWarning, installFetchBreaker, invalidateAppsCache, invalidateResolvedApps, isCloud, isCloudDomain, isEmailApp, isIngestionApp, isOnprem, isThreatIntelApp, isVulnScannerApp, isWorkflowScheduleStopped, normalizeAppName, parseRunResult, refreshAllIntegrationStatus, registerProtectedOrigin, resetRegionUrl, resolveApp, resolveApps, searchAgentActivity, seedResolvedApp, setDatastoreItem, setDatastoreItems, setHostBaseUrl, setRegionUrl, setRuntimeOrgId, setToastImpl, shuffleFetch, toast, useAppAuth, useAppDetail, useAppDetailOptional, useAppLookup, useSyncHostBaseUrl };