@shuffleio/shuffle-mcps 0.0.10 → 0.0.12

package/dist/index.d.cts

@@ -599,6 +599,20 @@ interface AgentRunDrawerProps {
 }
 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;
+/**
+ * True when running on Shuffle Cloud (a known *.shuffler.io / shutdown.no domain).
+ * Use this to gate cloud-only features like Google Analytics (ReactGA).
+ *
+ * isCloud()  → cloud deployment, GA allowed, telemetry OK
+ * !isCloud() → either Lovable preview (dev) OR self-hosted onprem; do NOT call GA
+ */
+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;
 declare const API_CONFIG: {
     readonly baseUrl: string;
     version: string;
@@ -775,11 +789,12 @@ declare const AgentExecutionDrawer: ({ open, onClose, run, width, apiKey, apiBas
  *  AgentUI's internal ExecutionData. */
 interface DiagnosableRun {
     status?: string;
+    result?: string;
     results?: Array<{
         result?: string;
     } | any> | null;
 }
-/** Try to parse the result JSON from results[0].result, unwrapping AGENT-type executions. */
+/** Try to parse the agent result JSON, unwrapping AGENT-type executions. */
 declare const parseRunResult: (run: DiagnosableRun) => {
     raw: string | null;
     parsed: any | null;
@@ -800,7 +815,7 @@ type DiagnosisEvidence = {
     value: string;
 };
 type OutputDiagnosis = {
-    kind: 'auth' | 'permission' | 'not_found' | 'rate_limit' | 'network' | 'validation' | 'generic';
+    kind: 'auth' | 'permission' | 'not_found' | 'rate_limit' | 'token_limit' | 'network' | 'validation' | 'generic';
     status?: number;
     title: string;
     explanation: string;
@@ -922,10 +937,16 @@ interface IntegrationStatusProps {
     hideHeader?: boolean;
     /** When set, apps matching this category are sorted to the top */
     priorityCategory?: string;
+    /** Extra apps to merge in (e.g. apps selected in onboarding but not yet activated). Merged by name (case-insensitive) — not duplicated if already present. */
+    extraApps?: {
+        id: string;
+        name: string;
+        icon?: string;
+    }[];
 }
 /** Fire this event from anywhere to make all IntegrationStatus instances re-fetch. */
 declare const refreshAllIntegrationStatus: () => void;
-declare const IntegrationStatus: ({ collapsed, filterApps, onAddClick, iconSize, onDisable, disabledApps, showAll, hideAddButton, hideHeader, priorityCategory }: IntegrationStatusProps) => react_jsx_runtime.JSX.Element;
+declare const IntegrationStatus: ({ collapsed, filterApps, onAddClick, iconSize, onDisable, disabledApps, showAll, hideAddButton, hideHeader, priorityCategory, extraApps }: IntegrationStatusProps) => react_jsx_runtime.JSX.Element;
 
 type AuthStatus = 'pending' | 'testing' | 'connected' | 'error';
 interface AppAuthState {
@@ -956,6 +977,39 @@ interface ApiAuthEntry {
         last_valid?: number;
     };
 }
+interface AppAuthConfigProps {
+    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 {
+    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;
+}
+declare const AppAuthCard: ({ app, authState, isExpanded, onToggle, onAuthChange, onTestConnection, onSaveAuth, apiAuthEntries, onSelectAuth, onRefreshAuth, disableUrlPrefill, hideHeader, hideStatusChips, hideDocsLink, }: AppAuthCardProps) => react_jsx_runtime.JSX.Element;
+declare const AppAuthConfig: ({ apps, authStates, authenticatedApps, onAuthChange, onTestConnection, onSaveAuth, onSelectAuth, onRefreshAuth, }: AppAuthConfigProps) => react_jsx_runtime.JSX.Element;
 
 declare function useAppAuth(): {
     authStates: Record<string, AppAuthState>;
@@ -977,6 +1031,8 @@ declare const AppDetailProvider: ({ children }: {
     children: ReactNode;
 }) => react_jsx_runtime.JSX.Element;
 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;
 
 /**
  * Tiny toast facade — library version. Mirrors the sonner-style surface
@@ -1004,4 +1060,235 @@ type ToastApi = ((arg: ToastArg, opts?: ToastOptions) => void) & {
 };
 declare const toast: ToastApi;
 
-export { API_CONFIG, AgentActivityList, type AgentActivityListProps, type AgentActivityParams, type AgentActivityResponse, type AgentDecision, AgentExecutionDrawer, type AgentExecutionDrawerProps, type AgentRun, AgentRunDiagnosisBanner, AgentRunDrawer, type AgentRunDrawerProps, type AgentRunDrawerTab, type AgentRunResult, AgentUI, type AgentUIApp, type AgentUIProps, type AlgoliaSearchApp, AppAuthSection, type AppAuthSectionProps, type AppAuthentication, AppDetailDrawer, AppDetailProvider, type AppLookupResult, AppSearchDrawer, type AppSelectedEvent, AppTitleHeader, type AppTitleHeaderProps, type CustomStyles, type DiagnosableRun, type DiagnosisEvidence, IntegrationStatus, type OutputDiagnosis, type ResolvedApp, ShuffleMCP, type ShuffleMCPHandle, type ShuffleMCPProps, ShufflePipelinesBanner, SingulActionsPreview, TryMcpSection, type TryMcpSectionProps, ShuffleMCP as default, diagnoseOutputWarning, getApiUrl, getAuthHeader, getFailureInfo, hasOutputWarning, invalidateResolvedApps, parseRunResult, refreshAllIntegrationStatus, resolveApp, resolveApps, searchAgentActivity, seedResolvedApp, setToastImpl, toast, useAppAuth, useAppDetail, useAppLookup };
+interface AgentIconProps {
+    size?: number;
+    className?: string;
+    style?: React.CSSProperties;
+}
+/**
+ * Renders the Singul agent icon — use this everywhere instead of 🤖.
+ */
+declare const AgentIcon: ({ size, className, style }: AgentIconProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * Shuffle Datastore Service
+ *
+ * Provides reusable functions for interacting with the Shuffle datastore API.
+ * Uses the correct Shuffle cache API endpoints.
+ */
+interface DatastoreItem {
+    key: string;
+    value: string;
+    category: string;
+    created?: number;
+    edited?: number;
+    public_authorization?: string;
+    enrichments?: Array<{
+        type: string;
+        value?: string;
+        data?: string;
+    }>;
+}
+interface CategoryAutomation {
+    id?: string;
+    name: string;
+    type?: 'workflow' | 'webhook' | 'ai_agent' | 'enrich' | 'send_message' | 'security_rules';
+    trigger?: 'on_create' | 'on_edit' | 'on_delete';
+    workflow_id?: string;
+    webhook_url?: string;
+    enabled: boolean;
+    description?: string;
+    options?: {
+        key: string;
+        value: string;
+    }[];
+}
+interface CategoryConfig {
+    id: string;
+    org_id: string;
+    category: string;
+    automations: CategoryAutomation[] | null;
+    settings: {
+        timeout: number;
+        public: boolean;
+    };
+}
+interface DatastoreResponse {
+    success: boolean;
+    data?: DatastoreItem[];
+    categoryConfig?: CategoryConfig;
+    cursor?: string;
+    totalAmount?: number;
+    error?: string;
+    diagnostics?: DatastoreDiagnostics;
+}
+interface DatastoreDiagnostics {
+    operation: string;
+    category?: string;
+    orgId?: string | null;
+    url?: string;
+    cursor?: string;
+    status?: number;
+    statusText?: string;
+    contentType?: string | null;
+    responseShape?: 'array' | 'keys' | 'data' | 'unknown';
+    itemCount?: number;
+    totalAmount?: number | null;
+    bodyPreview?: string;
+    errorStage?: 'request' | 'response' | 'parse' | 'unknown';
+    timestamp: string;
+}
+declare const setRuntimeOrgId: (orgId: string | null) => void;
+/**
+ * Set a single item in the datastore
+ */
+declare const setDatastoreItem: (key: string, value: string | object, category: string, overrideOrgId?: string) => Promise<DatastoreResponse>;
+/**
+ * Set multiple items in the datastore (bulk create) using v2 API
+ */
+declare const setDatastoreItems: (items: {
+    key: string;
+    value: string | object;
+}[], category: string) => Promise<DatastoreResponse>;
+/**
+ * Get a single item from the datastore
+ */
+declare const getDatastoreItem: (key: string, category: string, overrideOrgId?: string) => Promise<DatastoreResponse & {
+    item?: DatastoreItem;
+}>;
+/**
+ * Get a single item from the datastore using public authorization (no login required)
+ */
+declare const getDatastoreItemPublic: (key: string, orgId: string, authorization: string) => Promise<DatastoreResponse & {
+    item?: DatastoreItem;
+}>;
+/**
+ * Get all items in a category with optional cursor-based pagination
+ */
+declare const getDatastoreByCategory: (category: string, cursor?: string, limit?: number) => Promise<DatastoreResponse>;
+/**
+ * Delete a single item from the datastore
+ */
+declare const deleteDatastoreItem: (key: string, category: string, overrideOrgId?: string) => Promise<DatastoreResponse>;
+/**
+ * Delete multiple items from the datastore (bulk delete)
+ */
+declare const deleteDatastoreItems: (keys: string[], category: string) => Promise<{
+    success: boolean;
+    deleted: number;
+    failed: string[];
+    error?: string;
+}>;
+declare const DATASTORE_CATEGORIES: {
+    readonly INCIDENTS: "shuffle-security_incidents";
+    readonly ASSETS: "shuffle-security_assets";
+    readonly TEMPLATES: "shuffle-security_templates";
+    readonly CONFIGURATION: "shuffle-security_configuration";
+    readonly IOCS: "shuffle-security_ioc-config";
+    readonly CUSTOM_FIELDS: "shuffle-security_custom-fields";
+    readonly THREAT_FEEDS: "shuffle-security_threat-feeds";
+    readonly INFRASTRUCTURE: "shuffle-security_infrastructure";
+    readonly USERS: "shuffle-security_users";
+    readonly REPORTS: "shuffle-security_reports";
+    readonly LEGACY_ALERTS: "shuffle-security_alerts";
+    readonly LEGACY_CASES: "shuffle-security_cases";
+};
+
+/**
+ * Shared app category detection utilities.
+ * Used by onboarding (AutomationConfig) and incident automations (CategoryAutomationsDialog).
+ */
+declare const EMAIL_APP_PATTERNS: string[];
+declare const CASES_PATTERNS: string[];
+declare const EDR_PATTERNS: string[];
+declare const SIEM_PATTERNS: string[];
+declare const THREAT_INTEL_PATTERNS: string[];
+declare const COMMUNICATION_PATTERNS_NAMES: string[];
+declare const VULN_SCANNER_PATTERNS: string[];
+declare const isEmailApp: (appName: string) => boolean;
+declare const isThreatIntelApp: (appName: string) => boolean;
+declare const isVulnScannerApp: (appName: string) => boolean;
+declare const isIngestionApp: (appName: string) => boolean;
+type IngestionCategory = 'email' | 'cases' | 'edr' | 'siem' | 'other';
+declare const normalizeAppName: (name: string) => string;
+declare const getIngestionCategory: (appName: string, appCategories?: string[]) => IngestionCategory | null;
+/** Name of the workflow that powers automatic ingestion */
+declare const INGEST_TICKETS_WORKFLOW_NAME = "Ingest Tickets";
+/** Name of the workflow that powers forward tickets */
+declare const FORWARD_TICKETS_WORKFLOW_NAME = "Forward Tickets";
+/**
+ * Extract normalized app names from a workflow's actions.
+ * Returns a Set of normalized app names found in the workflow.
+ */
+declare function extractWorkflowAppNames(workflow: any): Set<string>;
+/**
+ * Find the 'Ingest Tickets' workflow from a list of workflows.
+ * Returns the workflow object or null.
+ */
+declare function findIngestTicketsWorkflow(workflows: any[]): any | null;
+/**
+ * Check if a workflow's schedule/trigger is stopped.
+ * Returns true if all triggers are stopped or the workflow has no triggers.
+ */
+declare function isWorkflowScheduleStopped(workflow: any): boolean;
+/**
+ * Find the 'Forward Tickets' workflow from a list of workflows.
+ * Returns the workflow object or null.
+ */
+declare function findForwardTicketsWorkflow(workflows: any[]): any | null;
+interface ValidatedIngestionApp {
+    id: string;
+    name: string;
+    image?: string;
+    validated: boolean;
+    enabled: boolean;
+    category: IngestionCategory;
+}
+/**
+ * Extract validated apps from the raw /api/v1/apps/authentication response.
+ * Returns deduplicated apps that have valid authentication.
+ *
+ * Enablement is determined by whether the app appears in the
+ * 'Ingest Tickets' workflow's actions (workflows are the source of truth).
+ *
+ * @param authApiResponse - Raw response from /api/v1/apps/authentication
+ * @param workflowAppNames - Set of normalized app names from the Ingest Tickets workflow actions
+ */
+declare function extractValidatedIngestionApps(authApiResponse: any[], workflowAppNames?: Set<string>): ValidatedIngestionApp[];
+
+/**
+ * Shared, request-coalescing fetcher for `/api/v1/apps`.
+ *
+ * The demo page (and the real app) renders many components that each need
+ * the user's apps list — `ShuffleMCP`, `AgentUI`, `AppDetailDrawer`,
+ * `useAppLookup`, `IntegrationStatus`. Without coordination they fire 5+
+ * identical `/api/v1/apps` requests on mount.
+ *
+ * This module mirrors `authenticatedApps.ts`:
+ *   1. Coalesces concurrent in-flight calls into a single Promise.
+ *   2. Caches the resolved JSON for a short TTL.
+ *   3. Exposes `invalidateAppsCache()` for callers that mutate apps.
+ *
+ * The cache key includes baseUrl + path + apiKey + orgId so multi-tenant /
+ * multi-region setups stay isolated.
+ */
+interface FetchAppsOptions {
+    baseUrl: string;
+    path?: string;
+    apiKey?: string | null;
+    orgId?: string | null;
+}
+/**
+ * Get the apps list. Returns the cached value if it is still within the
+ * TTL; otherwise fires (or joins) a single network request.
+ */
+declare const fetchApps: (opts: FetchAppsOptions) => Promise<any[]>;
+/** Invalidate the cached entry for one (or all) keys. */
+declare const invalidateAppsCache: (opts?: FetchAppsOptions) => void;
+/**
+ * Convenience wrapper for callers that already use API_CONFIG / getAuthHeader.
+ * Coalesces against the same cache as `fetchApps`.
+ */
+declare const fetchAppsViaApiConfig: () => Promise<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, 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, ShuffleMCP, type ShuffleMCPHandle, type ShuffleMCPProps, ShufflePipelinesBanner, SingulActionsPreview, THREAT_INTEL_PATTERNS, TryMcpSection, type TryMcpSectionProps, 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, toast, useAppAuth, useAppDetail, useAppDetailOptional, useAppLookup };