@shuffleio/shuffle-mcps 0.0.60 → 0.0.63

package/dist/chunk-TUSSDUVQ.mjs

@@ -0,0 +1,155 @@
+// ../Shuffle-Core/lib/analytics.ts
+import ReactGA from "react-ga4";
+import { isCloud } from "@shuffleio/shuffle-mcps";
+var GA_MEASUREMENT_ID = "G-YSYM9JDVEE";
+var _initialized = false;
+function initAnalytics() {
+  if (_initialized) return;
+  if (!isCloud()) return;
+  if (typeof window === "undefined") return;
+  ReactGA.initialize(GA_MEASUREMENT_ID);
+  _initialized = true;
+}
+var canTrack = () => isCloud() && _initialized;
+var GA_EVENTS = {
+  // Auth events
+  LOGIN_START: { category: "auth", action: "login_start" },
+  LOGIN_SUCCESS: { category: "auth", action: "login_success" },
+  LOGIN_FAILURE: { category: "auth", action: "login_failure" },
+  REGISTER_START: { category: "auth", action: "register_start" },
+  REGISTER_SUCCESS: { category: "auth", action: "register_success" },
+  LOGOUT: { category: "auth", action: "logout" },
+  // Onboarding events
+  ONBOARDING_START: { category: "onboarding", action: "onboarding_start" },
+  ONBOARDING_STEP: { category: "onboarding", action: "onboarding_step" },
+  ONBOARDING_COMPLETE: { category: "onboarding", action: "onboarding_complete" },
+  CHALLENGE_SELECTED: { category: "onboarding", action: "challenge_selected" },
+  TOOL_SELECTED: { category: "onboarding", action: "tool_selected" },
+  ONBOARDING_APP_CLICK: { category: "onboarding", action: "app_click" },
+  ONBOARDING_AUTH_TEST_SUCCESS: { category: "onboarding", action: "auth_test_success" },
+  ONBOARDING_AUTH_TEST_FAILURE: { category: "onboarding", action: "auth_test_failure" },
+  ONBOARDING_AUTOMATION_TOGGLE: { category: "onboarding", action: "automation_toggle" },
+  ONBOARDING_PRODUCT_CHOICE: { category: "onboarding", action: "product_choice" },
+  // Navigation events
+  CTA_CLICK: { category: "navigation", action: "cta_click" },
+  NAV_CLICK: { category: "navigation", action: "nav_click" },
+  EXTERNAL_LINK: { category: "navigation", action: "external_link" },
+  // Engagement events
+  SEARCH_USED: { category: "engagement", action: "search_used" },
+  CATEGORY_FILTER: { category: "engagement", action: "category_filter" },
+  APP_VIEWED: { category: "engagement", action: "app_viewed" },
+  // Conversion events
+  FREE_TRIAL_START: { category: "conversion", action: "free_trial_start" },
+  INTEGRATION_CONNECTED: { category: "conversion", action: "integration_connected" },
+  // Incident events
+  INCIDENT_AUTOMATION_CHANGE: { category: "incidents", action: "automation_change" },
+  INCIDENT_CREATE: { category: "incidents", action: "create" },
+  INCIDENT_RESOLVE: { category: "incidents", action: "resolve" },
+  INCIDENT_BULK_RESOLVE: { category: "incidents", action: "bulk_resolve" },
+  INCIDENT_SYNC: { category: "incidents", action: "sync" },
+  INCIDENT_INGESTION_TOGGLE: { category: "incidents", action: "ingestion_toggle" },
+  INCIDENT_MERGE: { category: "incidents", action: "merge" },
+  // Detection events
+  DETECTION_SENSOR_SELECT: { category: "detection", action: "sensor_select" },
+  DETECTION_SENSOR_CHECK: { category: "detection", action: "sensor_check" },
+  DETECTION_RULES_LOAD: { category: "detection", action: "rules_load" },
+  DETECTION_DEPLOY_CLICK: { category: "detection", action: "deploy_click" },
+  DETECTION_TEST_RUN: { category: "detection", action: "test_run" },
+  DETECTION_STEP_EXPAND: { category: "detection", action: "step_expand" },
+  DETECTION_ENV_CREATE: { category: "detection", action: "env_create" },
+  // Demo tour funnel events.
+  // Each fires with `label = stepId` and `value = stepIndex` so GA can build
+  // a step-ordinal funnel (e.g. how many users reach step 5 of the demo).
+  //
+  // Funnel layers:
+  //   DEMO_START          — user clicked "Start demo tour"
+  //   DEMO_LIVE_ENV_*     — environment bootstrap (workflows + feeds + IOCs) result
+  //   DEMO_STEP_VIEW      — user landed on a step (once per session per step)
+  //   DEMO_STEP_ADVANCE   — user clicked Next from a step (counts as "successful
+  //                         at this step" for steps without an explicit gate)
+  //   DEMO_STEP_COMPLETE  — gated step's requirement was satisfied (e.g. webhook on)
+  //   DEMO_FORCE_CREATE_INCIDENTS — manual rescue button on the incidents step
+  //   DEMO_FINISH         — user reached the final wrap step
+  //   DEMO_ABANDON        — user closed/exited the tour before finishing
+  //   DEMO_CLEANUP        — user clicked "Clean up demo data"
+  //   DEMO_MINIMIZE/RESTORE — drawer pill state
+  DEMO_START: { category: "demo", action: "demo_start" },
+  DEMO_LIVE_ENV_SUCCESS: { category: "demo", action: "demo_live_env_success" },
+  DEMO_LIVE_ENV_FAILURE: { category: "demo", action: "demo_live_env_failure" },
+  DEMO_STEP_VIEW: { category: "demo", action: "demo_step_view" },
+  DEMO_STEP_ADVANCE: { category: "demo", action: "demo_step_advance" },
+  DEMO_STEP_COMPLETE: { category: "demo", action: "demo_step_complete" },
+  DEMO_FORCE_CREATE_INCIDENTS: { category: "demo", action: "demo_force_create_incidents" },
+  DEMO_FINISH: { category: "demo", action: "demo_finish" },
+  DEMO_ABANDON: { category: "demo", action: "demo_abandon" },
+  DEMO_CLEANUP: { category: "demo", action: "demo_cleanup" },
+  DEMO_MINIMIZE: { category: "demo", action: "demo_minimize" },
+  DEMO_RESTORE: { category: "demo", action: "demo_restore" },
+  // Host monitor (Add Host) funnel events.
+  //   OPEN     — user opened the Add Host dialog
+  //   DEPLOY   — advanced from "checks" to "deploy" step (saw the install command)
+  //   DETECTED — sensor actually checked in while the dialog was open (success)
+  //   DISMISS  — dialog closed (or page unmounted) without a successful detection (abandonment)
+  // Together these form a 4-step funnel: OPEN → DEPLOY → DETECTED, with DISMISS as the abandonment counter.
+  MONITOR_ADD_HOST_OPEN: { category: "monitors", action: "add_host_open" },
+  MONITOR_ADD_HOST_DEPLOY: { category: "monitors", action: "add_host_deploy" },
+  MONITOR_ADD_HOST_DETECTED: { category: "monitors", action: "add_host_detected" },
+  MONITOR_ADD_HOST_DISMISS: { category: "monitors", action: "add_host_dismiss" }
+};
+function trackEvent({ category, action, label, value, custom }) {
+  if (!canTrack()) return;
+  ReactGA.event(action, {
+    event_category: category,
+    event_label: label,
+    value,
+    ...custom
+  });
+}
+function trackPredefinedEvent(event, label, value, custom) {
+  trackEvent({
+    category: event.category,
+    action: event.action,
+    label,
+    value,
+    custom
+  });
+}
+function trackPageView(path, title) {
+  if (!canTrack()) return;
+  ReactGA.send({
+    hitType: "pageview",
+    page: path,
+    title: title || (typeof document !== "undefined" ? document.title : void 0)
+  });
+}
+function trackCTA(ctaName, location) {
+  trackPredefinedEvent(GA_EVENTS.CTA_CLICK, ctaName, void 0, {
+    cta_location: location
+  });
+}
+function trackOnboardingStep(stepNumber, stepName) {
+  trackPredefinedEvent(GA_EVENTS.ONBOARDING_STEP, stepName, stepNumber);
+}
+function trackReferralParams() {
+  if (typeof window === "undefined") return;
+  const params = new URLSearchParams(window.location.search);
+  const utmContent = params.get("utm_content");
+  const shuffleRef = params.get("shuffle_ref");
+  if (utmContent) {
+    trackEvent({ category: "navigation", action: "utm_content", label: utmContent });
+  }
+  if (shuffleRef) {
+    trackEvent({ category: "navigation", action: "shuffle_ref", label: shuffleRef });
+  }
+}
+
+export {
+  initAnalytics,
+  GA_EVENTS,
+  trackEvent,
+  trackPredefinedEvent,
+  trackPageView,
+  trackCTA,
+  trackOnboardingStep,
+  trackReferralParams
+};

package/dist/{chunk-7HRNENGV.mjs → chunk-XNE7PKME.mjs}

@@ -552,6 +552,12 @@ var isCapacitorNative = () => {
   const cap = window.Capacitor;
   return Boolean(cap?.isNativePlatform && cap.isNativePlatform());
 };
+var isIos = () => {
+  return getPlatform() === "ios";
+};
+var isAndroid = () => {
+  return getPlatform() === "android";
+};
 var isIosWebView = () => {
   if (typeof window === "undefined") return false;
   const cap = window.Capacitor;
@@ -813,7 +819,8 @@ var resetRegionUrl = () => {
 };
 var SHUFFLE_HOST_BASE_URL_EVENT = "shuffle:set-host-base-url";
 var setHostBaseUrl = (url) => {
-  const next = url ? url.replace(/\/+$/, "") : null;
+  let next = url ? url.replace(/\/+$/, "") : null;
+  if (next && isShuffleCloudDomain(next) && !isDevEnvironment()) next = null;
   if (next === _hostBaseUrl) return;
   _hostBaseUrl = next;
   if (next) {
@@ -996,67 +1003,18 @@ var hasShuffleAuth = () => {
   }
 };
 
-// appsCache.ts
-var TTL_MS = 3e4;
-var ERROR_TTL_MS = 3e4;
-var cache = /* @__PURE__ */ new Map();
-var cacheKey = (o) => `${o.baseUrl}|${o.path || "/api/v1/apps"}|${o.apiKey || ""}|${o.orgId || ""}`;
-var doFetch = async (o) => {
-  const headers = {
-    ...getAuthHeader(o.orgId || void 0)
-  };
-  if (o.apiKey) headers["Authorization"] = `Bearer ${o.apiKey}`;
-  if (o.orgId) headers["Org-Id"] = o.orgId;
-  const response = await fetch(`${o.baseUrl}${o.path || "/api/v1/apps"}`, {
-    credentials: "include",
-    headers
-  });
-  if (!response.ok) return [];
-  const data = await response.json();
-  if (Array.isArray(data)) return data;
-  return Array.isArray(data?.data) ? data.data : [];
-};
-var fetchApps = (opts) => {
-  const key = cacheKey(opts);
-  const entry = cache.get(key) || {};
-  if (entry.data && entry.fetchedAt && Date.now() - entry.fetchedAt < TTL_MS) {
-    return Promise.resolve(entry.data);
-  }
-  if (entry.promise) return entry.promise;
-  const promise = doFetch(opts).then((data) => {
-    cache.set(key, { data, fetchedAt: Date.now() });
-    return data;
-  }).catch(() => {
-    cache.set(key, { data: [], fetchedAt: Date.now() - (TTL_MS - ERROR_TTL_MS) });
-    return [];
-  });
-  cache.set(key, { ...entry, promise });
-  return promise;
-};
-var invalidateAppsCache = (opts) => {
-  if (!opts) {
-    cache.clear();
-    return;
-  }
-  cache.delete(cacheKey(opts));
-};
-var fetchAppsViaApiConfig = () => {
-  const headers = getAuthHeader();
-  const orgId = headers["Org-Id"] || null;
-  return fetchApps({
-    baseUrl: API_CONFIG.baseUrl,
-    apiKey: API_CONFIG.apiKey,
-    orgId
-  });
-};
-
 export {
   resolveProductLink,
   registerProtectedOrigin,
   installFetchBreaker,
   isCapacitorNative,
+  isIos,
+  isAndroid,
+  isIosWebView,
+  isAndroidWebView,
   isShuffleCloudDomain,
   mapCloudRegionUrl,
+  isDevEnvironment,
   isCloudDomain,
   isCloud,
   isOnprem,
@@ -1066,13 +1024,11 @@ export {
   setHostBaseUrl,
   getHostBaseUrl,
   getTrackedOrgId,
+  getSessionToken,
   isShuffleSecurityBackend,
   API_CONFIG,
   getApiUrl,
   shuffleFetch,
   getAuthHeader,
-  hasShuffleAuth,
-  fetchApps,
-  invalidateAppsCache,
-  fetchAppsViaApiConfig
+  hasShuffleAuth
 };

package/dist/datastore-DRXSNIPR.mjs

@@ -0,0 +1,27 @@
+import {
+  DATASTORE_CATEGORIES,
+  deleteDatastoreItem,
+  deleteDatastoreItems,
+  filterItemsByCategory,
+  getDatastoreByCategory,
+  getDatastoreItem,
+  getDatastoreItemPublic,
+  getDatastorePageSize,
+  setDatastoreItem,
+  setDatastoreItems,
+  setRuntimeOrgId
+} from "./chunk-QC2DO6WV.mjs";
+import "./chunk-XNE7PKME.mjs";
+export {
+  DATASTORE_CATEGORIES,
+  deleteDatastoreItem,
+  deleteDatastoreItems,
+  filterItemsByCategory,
+  getDatastoreByCategory,
+  getDatastoreItem,
+  getDatastoreItemPublic,
+  getDatastorePageSize,
+  setDatastoreItem,
+  setDatastoreItems,
+  setRuntimeOrgId
+};

package/dist/index.d.mts

@@ -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;
@@ -1229,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
  *
@@ -1926,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. */
@@ -1942,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';
@@ -1977,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
@@ -2323,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>;
@@ -2334,4 +2389,4 @@ declare const LocalLLMConfig: React__default.ComponentType<any>;
 
 declare const AddAppModal: React__default.ComponentType<any>;
 
-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, 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, 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, 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 };

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;
@@ -1229,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
  *
@@ -1926,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. */
@@ -1942,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';
@@ -1977,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
@@ -2323,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>;
@@ -2334,4 +2389,4 @@ declare const LocalLLMConfig: React__default.ComponentType<any>;
 
 declare const AddAppModal: React__default.ComponentType<any>;
 
-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, 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, 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, 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 };