@shuffleio/shuffle-mcps 0.0.17 → 0.0.20

package/dist/index.d.ts

@@ -1,25 +1,20 @@
 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
  *
- * Mirror of Shuffle-Core's theme provider, scoped for the Shuffle-MCPs lib.
- * Two jobs:
- *
- * 1. Pin MUI defaults (`size="small"`) so individual call sites never need to
- *    thread sizing through.
- *
- * 2. Bridge the host app's light/dark scheme into MUI:
- *    - `mode="auto"` (default) — track the `.dark` class on `<html>` and flip
- *      MUI `palette.mode` accordingly. Tokens (`hsl(var(--…))`) flip with the
- *      same class so nothing else needs to know about the theme.
- *    - `mode="light" | "dark"` — pin the wrapped subtree to that scheme. We
- *      render a `<div className="dark">` (or remove it) so Tailwind dark
- *      variants and CSS-variable overrides scope to this subtree only —
- *      useful when embedding MCPs inside a host that doesn't manage `.dark`
- *      on `<html>`.
+ * - Pins MUI defaults (`size="small"`) so call sites never thread sizing.
+ * - Bridges the host app's light/dark scheme into MUI (`palette.mode`) and
+ *   into our HSL token system (the scoped `.dark` class).
+ * - Exposes a React Context (`ShuffleMcpThemeContext`) so internal raw
+ *   components — and views that compose other library components without
+ *   going through the public wrapped exports — see the resolved mode.
+ * - Stamps the scope className onto MUI portaled paper (Drawer, Dialog,
+ *   Menu, Popover, Tooltip), so portals rendered into <body> still resolve
+ *   our `hsl(var(--…))` tokens against the pinned theme instead of the
+ *   host's `<html>`.
  *
  * Wrap your MCP usage at any level:
  *
@@ -30,11 +25,12 @@ 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>`.
-     * - `"light"` / `"dark"` — pin the subtree to that scheme via a wrapping div.
+     * - `"light"` / `"dark"` — pin the subtree (and any portals rendered from
+     *   within it) to that scheme.
      */
     mode?: ShuffleMcpColorMode;
 }
@@ -244,115 +240,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 +268,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 +291,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 +315,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 +325,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 +397,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 +512,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 +550,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, globalUrl, }: AgentRunDrawerProps) => react_jsx_runtime.JSX.Element;
 
 /** Check if running on a known Shuffle Cloud domain */
 declare const isCloudDomain: () => boolean;
@@ -842,7 +719,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;
@@ -872,7 +748,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 {
     /**
@@ -883,8 +758,26 @@ 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, AgentsView mounts its own internal
+     * `AgentRunDrawer` and opens it on the Local LLM tab — so the chip
+     * always does *something*, even on hosts that haven't wired a picker.
+     * Pass this prop to override with 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;
+    /**
+     * Content rendered inside the built-in AgentRunDrawer's Local LLM tab
+     * when no `onChooseLLM` is provided. Use to plug in your own local LLM
+     * config form. When omitted, a minimal built-in placeholder is shown.
+     */
+    localLLMSlot?: React.ReactNode;
+    /** Content for the built-in AgentRunDrawer's Permissions tab. Optional. */
+    permissionsSlot?: React.ReactNode;
 }
-declare const AgentsView: ({ onSchedule, maxWidth, globalUrl, isLoaded, isLoggedIn, userdata, serverside }: AgentsViewProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Shared diagnosis utilities for an agent execution result.
@@ -937,21 +830,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
@@ -1450,4 +1328,44 @@ 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, 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 };
+/**
+ * Local Singul Library — fully self-contained.
+ * No host-app `@/` imports remain inside this folder (assets aside).
+ */
+
+/**
+ * Every exported component accepts an optional `theme` prop:
+ *   - `"light"` / `"dark"` — pin the subtree to that scheme
+ *   - `"system"` (default) — follow the host page's `.dark` class on `<html>`
+ *
+ * `colorMode` is preserved as a legacy alias (`"auto"` == `"system"`).
+ */
+type ShuffleTheme = 'light' | 'dark' | 'system';
+
+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, type ShuffleTheme, 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 };