@shuffleio/shuffle-mcps 0.0.59 → 0.0.63

package/dist/index.d.ts

@@ -136,6 +136,8 @@ interface AppAuthentication$1 {
         id: string;
         name: string;
         large_image: string;
+        categories?: string[];
+        description?: string;
     };
     fields: Array<{
         key: string;
@@ -149,6 +151,7 @@ interface AppAuthentication$1 {
         /** Whether the authentication has been validated (tests ran successfully) */
         valid: boolean;
         error?: string;
+        last_valid?: number;
     };
 }
 interface ShuffleMCPProps extends ShuffleHostProps {
@@ -390,6 +393,8 @@ interface AppDetailContentProps extends ShuffleHostProps {
     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 */
@@ -478,6 +483,12 @@ interface AppTitleHeaderProps extends ShuffleHostProps {
     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;
@@ -728,6 +739,7 @@ interface AgentUIProps {
         input: string;
         success: boolean;
         executionId?: string;
+        authorization?: string;
         error?: string;
     }) => void;
     /** Called whenever the chip set under the prompt changes (add/remove apps). */
@@ -929,7 +941,7 @@ interface AskAiButtonProps {
     isBeta?: boolean;
     /** Current URL pathname. Automatically disables button on /agents and /agent */
     pathname?: string;
-    /** Custom button label. Default: "Ask AI". */
+    /** Custom button label. Default: "Ask Shuffle". */
     label?: string;
     /** Tag label in the button. When undefined, defaults to "Beta" if isBeta is true, else "Support". Set to null to hide tag. */
     tagLabel?: string | null;
@@ -1193,6 +1205,9 @@ interface AskAiSidePanelProps extends ShuffleHostProps {
  * Self-contained: No host-app `@/` imports.
  */
 
+declare const AGENT_DRAWER_OPEN_EVENT = "agent-drawer-open";
+declare const AGENT_DRAWER_CLOSE_EVENT = "agent-drawer-close";
+declare const AGENT_DRAWER_STATE_EVENT = "agent-drawer-state";
 interface AskAiWidgetProps extends Omit<AskAiSidePanelProps, 'open' | 'onClose'> {
     /** Controlled open state. When omitted, the widget manages its own open state. */
     open?: boolean;
@@ -1225,6 +1240,34 @@ interface AskAiWidgetProps extends Omit<AskAiSidePanelProps, 'open' | 'onClose'>
  */
 declare const useContextAwareAgent: (pathname?: string, search?: string) => AgentResolvedContext;
 
+/**
+ * ApiCallViewer — Standardized, compact API call inspector and test runner.
+ * Used across App Integrations and Documentation.
+ *
+ * Supports switching between cURL, Python, HTTP, and JSON payload inspection,
+ * live testing via Shuffle HTTP app, and collapsible JSON parsing via JsonView.
+ */
+
+interface ApiCallConfig {
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+type SnippetLang = 'curl' | 'python' | 'http' | 'json';
+interface ApiCallViewerProps extends ShuffleHostProps {
+    /** Structured API call configuration */
+    config?: ApiCallConfig;
+    /** Raw cURL command string (e.g. from documentation markdown) */
+    rawCurl?: string;
+    /** Whether to mask the Authorization header value in display (default: true) */
+    maskAuth?: boolean;
+    /** Initial selected tab mode (default: 'curl') */
+    defaultMode?: SnippetLang;
+    /** Title displayed in the header (default: 'API Call') */
+    title?: string;
+}
+
 /**
  * API Configuration
  *
@@ -1922,6 +1965,8 @@ interface DatastoreResponse {
     totalAmount?: number;
     error?: string;
     diagnostics?: DatastoreDiagnostics;
+    /** Raw items count from backend before client-side cross-category filtering */
+    rawItemCount?: number;
     /** Per-key write result reported by the backend (v2 datastore writes). */
     keysExisted?: DatastoreKeyExisted[];
     /** True when the backend reports the stored value actually changed. */
@@ -1938,6 +1983,7 @@ interface DatastoreDiagnostics {
     contentType?: string | null;
     responseShape?: 'array' | 'keys' | 'data' | 'object' | 'unknown';
     itemCount?: number;
+    rawItemCount?: number;
     totalAmount?: number | null;
     bodyPreview?: string;
     errorStage?: 'request' | 'response' | 'parse' | 'unknown';
@@ -1973,6 +2019,17 @@ declare const getDatastoreItemPublic: (key: string, orgId: string, authorization
     item?: DatastoreItem;
 }>;
 /**
+ * Defensively filters items returned by datastore list APIs.
+ * The Shuffle Core backend's list_cache API filters the category field with an
+ * analyzed match query instead of an exact term match, causing cross-category
+ * contamination among categories sharing prefixes (e.g. shuffle-security_*).
+ * If an item explicitly carries a `category` property, ensure it matches the
+ * requested category (or known aliases for vulns). Items without a category
+ * property are preserved for backwards compatibility with legacy payloads.
+ */
+declare const filterItemsByCategory: <T extends {
+    category?: string;
+}>(items: T[], category: string) => T[];
 /**
  * Page size used for a category. Exported so callers that follow cursors can
  * tell a full page (more data may exist) from a short page (definitively the
@@ -2235,6 +2292,45 @@ declare function resolveConnectedTools(category: 'incidents' | 'vulnerabilities'
  */
 declare function fetchConnectedTools(category: string, resolveUrl?: (path: string) => string, resolveHeaders?: () => Record<string, string>): Promise<ConnectedToolApp[]>;
 
+/**
+ * Helper to build and launch pre-filled contact form URLs for escalating
+ * an Ask Shuffle run or question to Shuffle Support.
+ */
+interface SupportEscalationContext {
+    userdata?: any;
+    sourceUrl?: string;
+    pathname?: string;
+    search?: string;
+    entityTitle?: string;
+    initialQuestion?: string;
+    executionId?: string;
+    authorization?: string;
+    executionStatus?: string;
+    error?: string;
+    category?: string;
+}
+interface ResolvedContactUserInfo {
+    firstName: string;
+    lastName: string;
+    email: string;
+    title: string;
+    company: string;
+}
+/**
+ * Extracts and normalizes user profile fields from available user session data.
+ */
+declare function resolveContactUserInfo(userdata?: any): ResolvedContactUserInfo;
+/**
+ * Builds the pre-filled URL pointing to https://shuffler.io/contact
+ * using the available form fields:
+ * "firstName", "lastName", "email", "title", "company", "category", "message"
+ */
+declare function buildSupportEscalationUrl(context: SupportEscalationContext): string;
+/**
+ * Opens https://shuffler.io/contact pre-filled in a new browser tab.
+ */
+declare function openSupportEscalation(context: SupportEscalationContext): void;
+
 /**
  * Local Singul Library — fully self-contained.
  * No host-app `@/` imports remain inside this folder (assets aside).
@@ -2280,6 +2376,8 @@ declare const AskAiSidePanel: React__default.ComponentType<any>;
 
 declare const AskAiWidget: React__default.ComponentType<any>;
 
+declare const ApiCallViewer: React__default.ComponentType<any>;
+
 declare const AgentActivityList: React__default.ComponentType<any>;
 
 declare const AgentExecutionDrawer: React__default.ComponentType<any>;
@@ -2291,4 +2389,4 @@ declare const LocalLLMConfig: React__default.ComponentType<any>;
 
 declare const AddAppModal: React__default.ComponentType<any>;
 
-export { 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, 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, SIEM_PATTERNS, type ShuffleHostProps, ShuffleMCP, type ShuffleMCPHandle, type ShuffleMCPProps, ShuffleMarkdown, type ShuffleMcpColorMode, ShuffleMcpThemeProvider, type ShuffleMcpThemeProviderProps, ShufflePipelinesBanner, type ShuffleTheme, SingulActionsPreview, THREAT_INTEL_PATTERNS, TryMcpSection, type TryMcpSectionProps, UsageBar, type UsageBarProps, type UseAgentPromptPrefixOptions, VERIFIED_BUILTIN_APPS, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, VideoEmbed, applyRegionFromPayload, checkAppNameMatch, clearPageContextChoice, ShuffleMCP as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, extractActionAppNames, extractValidatedIngestionApps, extractWorkflowActionAppNames, extractWorkflowAppNames, fetchApps, fetchAppsViaApiConfig, fetchConnectedTools, 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, parseRunResult, refreshAllIntegrationStatus, registerAgentContextRule, registerProtectedOrigin, resetRegionUrl, resolveAgentContext, resolveApp, resolveApps, resolveConnectedTools, 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, 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 };