@shuffleio/shuffle-mcps 0.0.34 → 0.0.36

package/dist/{appsCache-KWDP7F2K.mjs → appsCache-ME4KZMTY.mjs}

@@ -2,7 +2,7 @@ import {
   fetchApps,
   fetchAppsViaApiConfig,
   invalidateAppsCache
-} from "./chunk-B4JFC2JU.mjs";
+} from "./chunk-IABSYB2J.mjs";
 export {
   fetchApps,
   fetchAppsViaApiConfig,

package/dist/{chunk-B4JFC2JU.mjs → chunk-IABSYB2J.mjs}

@@ -1,7 +1,9 @@
 // fetchBreaker.ts
 var FAIL_THRESHOLD = 12;
 var ROLLING_WINDOW_MS = 5e3;
-var COOLDOWN_MS = 3e4;
+var COOLDOWN_MS = 1e4;
+var PROBE_AFTER_MS = 1500;
+var MAX_PROBE_BACKOFF_MS = 5e3;
 var HARD_BURST_THRESHOLD = 30;
 var HARD_BURST_WINDOW_MS = 1e3;
 var state = /* @__PURE__ */ new Map();
@@ -10,11 +12,24 @@ var allowedOrigins = /* @__PURE__ */ new Set();
 var getEntry = (key) => {
   let entry = state.get(key);
   if (!entry) {
-    entry = { failures: [], attempts: [], blockedUntil: 0, warned: false };
+    entry = { failures: [], attempts: [], blockedUntil: 0, probeAfter: 0, probing: false, warned: false };
     state.set(key, entry);
   }
   return entry;
 };
+var trip = (entry, now, cooldownMs = COOLDOWN_MS) => {
+  entry.blockedUntil = now + cooldownMs;
+  entry.probeAfter = now + PROBE_AFTER_MS;
+  entry.probing = false;
+};
+var reset = (entry) => {
+  entry.failures.length = 0;
+  entry.attempts.length = 0;
+  entry.blockedUntil = 0;
+  entry.probeAfter = 0;
+  entry.probing = false;
+  entry.warned = false;
+};
 var prune = (arr, now, windowMs) => {
   const cutoff = now - windowMs;
   while (arr.length && arr[0] < cutoff) arr.shift();
@@ -64,21 +79,35 @@ var installFetchBreaker = () => {
     if (!key) return original(input, init);
     const entry = getEntry(key);
     const now = Date.now();
+    let isProbe = false;
     if (entry.blockedUntil > now) {
-      return synthetic503(key, entry.blockedUntil - now);
+      if (!entry.probing && now >= entry.probeAfter) {
+        entry.probing = true;
+        isProbe = true;
+      } else {
+        return synthetic503(key, entry.blockedUntil - now);
+      }
     }
-    entry.attempts.push(now);
-    prune(entry.attempts, now, HARD_BURST_WINDOW_MS);
-    if (entry.attempts.length > HARD_BURST_THRESHOLD) {
-      entry.blockedUntil = now + COOLDOWN_MS;
-      if (!entry.warned) {
-        entry.warned = true;
-        console.error(
-          `[fetchBreaker] Burst detected on ${key} (${entry.attempts.length} calls / ${HARD_BURST_WINDOW_MS}ms). Blocking for ${COOLDOWN_MS / 1e3}s. Fix the caller \u2014 this is almost always a missing useEffect dep or a render loop.`
-        );
+    if (!isProbe) {
+      entry.attempts.push(now);
+      prune(entry.attempts, now, HARD_BURST_WINDOW_MS);
+      if (entry.attempts.length > HARD_BURST_THRESHOLD) {
+        trip(entry, now);
+        if (!entry.warned) {
+          entry.warned = true;
+          console.error(
+            `[fetchBreaker] Burst detected on ${key} (${entry.attempts.length} calls / ${HARD_BURST_WINDOW_MS}ms). Blocking for up to ${COOLDOWN_MS / 1e3}s (probing again in ${PROBE_AFTER_MS / 1e3}s). Fix the caller \u2014 this is almost always a missing useEffect dep or a render loop.`
+          );
+        }
+        return synthetic503(key, COOLDOWN_MS);
       }
-      return synthetic503(key, COOLDOWN_MS);
     }
+    const onProbeFailure = (ts) => {
+      if (!isProbe) return;
+      entry.probing = false;
+      entry.probeAfter = ts + Math.min(MAX_PROBE_BACKOFF_MS, PROBE_AFTER_MS * 2);
+      entry.blockedUntil = Math.max(entry.blockedUntil, ts + PROBE_AFTER_MS);
+    };
     let response;
     try {
       response = await original(input, init);
@@ -86,12 +115,13 @@ var installFetchBreaker = () => {
       const ts = Date.now();
       entry.failures.push(ts);
       prune(entry.failures, ts, ROLLING_WINDOW_MS);
-      if (entry.failures.length >= FAIL_THRESHOLD) {
-        entry.blockedUntil = ts + COOLDOWN_MS;
+      onProbeFailure(ts);
+      if (!isProbe && entry.failures.length >= FAIL_THRESHOLD) {
+        trip(entry, ts);
         if (!entry.warned) {
           entry.warned = true;
           console.error(
-            `[fetchBreaker] ${entry.failures.length} network errors on ${key} in ${ROLLING_WINDOW_MS / 1e3}s. Blocking for ${COOLDOWN_MS / 1e3}s.`
+            `[fetchBreaker] ${entry.failures.length} network errors on ${key} in ${ROLLING_WINDOW_MS / 1e3}s. Blocking for up to ${COOLDOWN_MS / 1e3}s.`
           );
         }
       }
@@ -101,18 +131,20 @@ var installFetchBreaker = () => {
       const ts = Date.now();
       entry.failures.push(ts);
       prune(entry.failures, ts, ROLLING_WINDOW_MS);
-      if (entry.failures.length >= FAIL_THRESHOLD) {
-        entry.blockedUntil = ts + COOLDOWN_MS;
+      onProbeFailure(ts);
+      if (!isProbe && entry.failures.length >= FAIL_THRESHOLD) {
+        trip(entry, ts);
         if (!entry.warned) {
           entry.warned = true;
           console.error(
-            `[fetchBreaker] ${entry.failures.length} ${response.status}s on ${key} in ${ROLLING_WINDOW_MS / 1e3}s. Blocking for ${COOLDOWN_MS / 1e3}s.`
+            `[fetchBreaker] ${entry.failures.length} ${response.status}s on ${key} in ${ROLLING_WINDOW_MS / 1e3}s. Blocking for up to ${COOLDOWN_MS / 1e3}s.`
           );
         }
       }
     } else if (response.status < 400) {
-      entry.failures.length = 0;
-      entry.warned = false;
+      reset(entry);
+    } else {
+      if (isProbe) reset(entry);
     }
     return response;
   });
@@ -134,7 +166,7 @@ var getEnvVar = (key) => {
 var isDevEnvironment = () => {
   if (getEnvVar("VITE_SHUFFLE_API_URL")) return false;
   const hostname = typeof window !== "undefined" ? window.location.hostname : "";
-  return hostname.includes("lovableproject.com") || hostname.includes("id-preview--");
+  return hostname.includes("lovableproject.com") || hostname.includes("id-preview--") || hostname.endsWith(".lovable.app") || hostname.endsWith(".lovable.dev");
 };
 var isCloudDomain = () => {
   const hostname = typeof window !== "undefined" ? window.location.hostname : "";
@@ -154,9 +186,54 @@ var getDefaultBaseUrl = () => {
   }
   return PROD_BACKEND;
 };
-var _regionUrl = null;
-var _trackedOrgId = null;
+var REGION_STORAGE_KEY = "shuffle_region_url";
+var readCachedRegion = () => {
+  if (typeof window === "undefined") return { url: null, orgId: null };
+  try {
+    const raw = localStorage.getItem(REGION_STORAGE_KEY);
+    if (!raw) return { url: null, orgId: null };
+    const parsed = JSON.parse(raw);
+    return { url: parsed?.url || null, orgId: parsed?.orgId || null };
+  } catch {
+    return { url: null, orgId: null };
+  }
+};
+var cached = readCachedRegion();
+var _regionUrl = cached.url;
+var _trackedOrgId = cached.orgId;
 var _hostBaseUrl = null;
+var REGION_EVENT = "shuffle:region-url";
+var _lastBroadcastUrl = cached.url;
+var persistRegion = (url, orgId) => {
+  if (typeof window === "undefined") return;
+  const changed = url !== _lastBroadcastUrl;
+  _lastBroadcastUrl = url;
+  try {
+    if (url) localStorage.setItem(REGION_STORAGE_KEY, JSON.stringify({ url, orgId }));
+    else localStorage.removeItem(REGION_STORAGE_KEY);
+  } catch {
+  }
+  if (!changed) return;
+  try {
+    window.dispatchEvent(new CustomEvent(REGION_EVENT, { detail: { url, orgId } }));
+  } catch {
+  }
+};
+if (typeof window !== "undefined") {
+  const sync = () => {
+    const next = readCachedRegion();
+    if (next.url !== _regionUrl) {
+      _regionUrl = next.url;
+      _lastBroadcastUrl = next.url;
+      console.log(`[API] Region URL synced to: ${_regionUrl || "default"}`);
+    }
+    _trackedOrgId = next.orgId;
+  };
+  window.addEventListener(REGION_EVENT, sync);
+  window.addEventListener("storage", (e) => {
+    if (e.key === REGION_STORAGE_KEY) sync();
+  });
+}
 var isShufflerSubdomain = (url) => {
   try {
     const parsed = new URL(url);
@@ -166,26 +243,32 @@ var isShufflerSubdomain = (url) => {
   }
 };
 var setRegionUrl = (regionUrl, orgId) => {
-  if (isDevEnvironment()) {
-    _trackedOrgId = orgId || null;
-    return;
-  }
   _trackedOrgId = orgId || null;
   if (regionUrl && isShufflerSubdomain(regionUrl)) {
     const normalized = regionUrl.replace(/\/+$/, "");
     if (normalized !== PROD_BACKEND) {
       _regionUrl = normalized;
+      persistRegion(_regionUrl, _trackedOrgId);
       console.log(`[API] Region URL set to: ${_regionUrl}`);
       return;
     }
   }
   _regionUrl = null;
+  persistRegion(null, _trackedOrgId);
+};
+var applyRegionFromPayload = (payload, orgIdOverride) => {
+  if (!payload || typeof payload !== "object") return null;
+  const orgId = orgIdOverride ?? payload?.active_org?.id ?? payload?.org_id ?? null;
+  const regionUrl = payload?.region_url || payload?.active_org?.region_url || null;
+  setRegionUrl(regionUrl, orgId);
+  return regionUrl;
 };
 var resetRegionUrl = () => {
   if (_regionUrl) {
     console.log(`[API] Region URL reset to default (org changed)`);
   }
   _regionUrl = null;
+  persistRegion(null, null);
 };
 var SHUFFLE_HOST_BASE_URL_EVENT = "shuffle:set-host-base-url";
 var setHostBaseUrl = (url) => {
@@ -219,7 +302,7 @@ var getTrackedOrgId = () => _trackedOrgId;
 var API_CONFIG = {
   // Shuffle backend URL — host override beats region URL beats default.
   get baseUrl() {
-    const url = _hostBaseUrl || _regionUrl || getDefaultBaseUrl();
+    const url = _hostBaseUrl || (isDevEnvironment() || getEnvVar("VITE_SHUFFLE_API_URL") ? getDefaultBaseUrl() : _regionUrl || getDefaultBaseUrl());
     try {
       registerProtectedOrigin(url);
     } catch {
@@ -244,13 +327,6 @@ var API_CONFIG = {
 var getApiUrl = (endpoint) => {
   return `${API_CONFIG.baseUrl}${endpoint}`;
 };
-var getShuffleCoreFormUrl = (refUrl) => {
-  if (!refUrl) return refUrl;
-  if (/^https?:\/\//i.test(refUrl)) return refUrl;
-  const path = refUrl.startsWith("/") ? refUrl : `/${refUrl}`;
-  if (isCloud()) return `https://shuffler.io${path}`;
-  return `${API_CONFIG.baseUrl}${path}`;
-};
 var shuffleFetch = (url, init) => {
   const { headers: extraHeaders, ...rest } = init || {};
   return fetch(url, {
@@ -334,13 +410,13 @@ export {
   isCloud,
   isOnprem,
   setRegionUrl,
+  applyRegionFromPayload,
   resetRegionUrl,
   setHostBaseUrl,
   getHostBaseUrl,
   getTrackedOrgId,
   API_CONFIG,
   getApiUrl,
-  getShuffleCoreFormUrl,
   shuffleFetch,
   getAuthHeader,
   fetchApps,

package/dist/index.d.mts

@@ -131,7 +131,7 @@ interface CustomStyles {
     checkbox?: React.CSSProperties;
     checkboxChecked?: React.CSSProperties;
 }
-interface AppAuthentication {
+interface AppAuthentication$1 {
     app: {
         id: string;
         name: string;
@@ -212,7 +212,7 @@ interface ShuffleMCPProps extends ShuffleHostProps {
     /** Base URL for Singul API calls (default: https://singul.io) */
     singulBaseUrl?: string;
     /** Manually provided authenticated apps (used when apiKey is not provided) */
-    authenticatedApps?: AppAuthentication[];
+    authenticatedApps?: AppAuthentication$1[];
     /** Hide the auth status chips (Configured/Not configured, Tested/Not tested) */
     hideAuthStatus?: boolean;
     /** Apps to pin at the top of the results (prepended, deduped by name). */
@@ -604,8 +604,9 @@ interface AgentPromptPrefixChipProps {
 declare const AgentPromptPrefixChip: ({ label, userId, value, onChange, onRemove, defaultPrompt, dialogTitle, readOnly, }: AgentPromptPrefixChipProps) => React$1.JSX.Element;
 
 declare const AGENT_PROMPT_PREFIX_CATEGORY = "agent-prompt-prefix";
-/** Default seed used until the user saves their own prefix. */
-declare const DEFAULT_AGENT_PROMPT_PREFIX = "You are the Shuffle Tools agent. Use the connected Shuffle tools to help me with the request that follows.";
+/** Default seed used until the user saves their own prefix.
+ * Empty by default — the backend system prompt handles agent identity. */
+declare const DEFAULT_AGENT_PROMPT_PREFIX = "";
 interface UseAgentPromptPrefixOptions {
     /** Storage key — typically the current user id. Falls back to `"default"`. */
     userId?: string;
@@ -641,7 +642,7 @@ interface AgentRunDrawerProps extends ShuffleHostProps {
     permissionsDisabledTooltip?: string;
     /** Forwarded to the embedded AgentUI (apiKey, apiBaseUrl, orgId, etc.). */
     agentUIProps?: Partial<AgentUIProps>;
-    /** Drawer width override (default: 480 px on >=sm, full-width on xs). */
+    /** Drawer width override (default: 595 px on >=sm, full-width on xs). */
     width?: number;
     /** Header title. Default: "Agent". */
     title?: string;
@@ -675,9 +676,18 @@ declare const isCloud: () => boolean;
 declare const isOnprem: () => boolean;
 /**
  * Set the dynamic region URL from getinfo response.
- * Only applies if the URL is a shuffler.io subdomain and different from default.
+ * ALWAYS honored for the current org/tenant (including dev/preview) as long as
+ * the URL is a valid shuffler.io subdomain different from the default backend.
+ * Persisted in localStorage so later page loads do not have to wait on getinfo.
  */
 declare const setRegionUrl: (regionUrl: string | undefined | null, orgId: string | undefined | null) => void;
+/**
+ * Single entry point for applying a region from ANY backend response that
+ * carries one (`/api/v1/getinfo`, `/api/v1/orgs/{id}/change`, ...). Extracts
+ * `region_url` (top-level first, then `active_org`) and routes it through
+ * `setRegionUrl`, so setting + broadcasting always happens in one place.
+ */
+declare const applyRegionFromPayload: (payload: any, orgIdOverride?: string | null) => string | null;
 /**
  * Called when org changes. Resets region URL to default until next getinfo.
  */
@@ -807,6 +817,18 @@ declare const scheduleAgentRun: ({ cron, input, apps, onStep, apiKey, apiBaseUrl
     cron: string;
 }>;
 
+/**
+ * A usecase-backed agent "type" surfaced in the run filter dropdown.
+ * Hosts supply only the usecases that are actually enabled for the tenant.
+ */
+interface AgentUsecaseFilter {
+    /** Unique id (used as the menu value). */
+    id: string;
+    /** Menu label, e.g. "Incident Response Agent". */
+    label: string;
+    /** Case-insensitive substrings matched against run source/workflow metadata. */
+    matchTokens: string[];
+}
 interface AgentActivityListProps extends ShuffleHostProps {
     /** Optional Shuffle API key. Falls back to the shared API_CONFIG. */
     apiKey?: string;
@@ -844,6 +866,8 @@ interface AgentActivityListProps extends ShuffleHostProps {
     toolbarSx?: SxProps<Theme>;
     /** Style overrides for each individual run row. */
     rowSx?: SxProps<Theme>;
+    /** Usecase-backed agent types shown in the run filter dropdown. */
+    usecaseFilters?: AgentUsecaseFilter[];
 }
 
 interface AgentExecutionDrawerProps extends ShuffleHostProps {
@@ -914,6 +938,8 @@ interface AgentsViewProps extends ShuffleHostProps {
     disableAppsPersistence?: boolean;
     /** Storage key for internal chip-row persistence. Defaults to `shuffle-agents-selected-apps`. */
     appsStorageKey?: string;
+    /** Usecase-backed agent types shown in the activity list filter dropdown. */
+    usecaseFilters?: AgentUsecaseFilter[];
 }
 
 interface AgentLocalModel {
@@ -932,6 +958,10 @@ interface LocalLLMConfigProps extends ShuffleHostProps {
     hasOpenAIAuth?: boolean;
     onSave?: (model: AgentLocalModel) => void;
     onTestResult?: (result: LocalLLMTestResult) => void;
+    /** When the panel is rendered inside a drawer, pass the drawer open state
+     *  so the provider selector can reset to the currently active provider each
+     *  time the drawer opens. */
+    open?: boolean;
 }
 
 /**
@@ -964,6 +994,30 @@ interface AppAuthState {
     executionId?: string;
     errorCode?: number;
 }
+interface AuthParameter {
+    description: string;
+    example: string;
+    id: string;
+    name: string;
+    required: boolean;
+    schema: {
+        type: string;
+    };
+}
+interface AppAuthentication {
+    type: string;
+    description?: string;
+    redirect_uri?: string;
+    token_uri?: string;
+    refresh_uri?: string;
+    authorization_url?: string;
+    auth_uri?: string;
+    authorize_url?: string;
+    scope?: string[];
+    client_id?: string;
+    client_secret?: string;
+    parameters?: AuthParameter[];
+}
 interface ApiAuthEntry {
     id?: string;
     label?: string;
@@ -1023,6 +1077,12 @@ interface AppAuthCardProps extends ShuffleHostProps {
      *  credentials form (with the small "Test Authentication" CTA) is always
      *  visible so users can edit & retest in one place. */
     compactAuthForm?: boolean;
+    /** Always render the "Select authentication" dropdown, even when there are no
+     *  saved entries yet, so the UI does not switch between two different shapes. */
+    alwaysShowAuthSelector?: boolean;
+    /** Suppress the "Authentication saved" success toast (embedded flows that
+     *  already give their own feedback, e.g. the LLM provider config). */
+    suppressSaveToast?: boolean;
     /** Render additional fields inside the expanded body, above the credential
      *  inputs. The slot receives the live `localCredentials` and a `setField`
      *  helper so its values are persisted as part of the auth on Save. */
@@ -1030,8 +1090,11 @@ interface AppAuthCardProps extends ShuffleHostProps {
         credentials: Record<string, string>;
         setField: (key: string, value: string) => void;
     }) => React.ReactNode;
+    /** Known-ahead-of-time auth schema. When provided the fields render
+     *  instantly and no app-config request is made (no "Loading configuration"). */
+    initialAuthConfig?: AppAuthentication;
 }
-declare const AppAuthCard: ({ app, authState, isExpanded, onToggle, onAuthChange, onTestConnection, onSaveAuth, apiAuthEntries, onSelectAuth, onRefreshAuth, disableUrlPrefill, hideHeader, hideStatusChips, hideDocsLink, hideUrlFields, borderless, compactAuthForm, extraFieldsSlot, globalUrl, userdata, isLoaded, isLoggedIn, serverside, }: AppAuthCardProps) => React$1.JSX.Element;
+declare const AppAuthCard: ({ app, authState, isExpanded, onToggle, onAuthChange, onTestConnection, onSaveAuth, apiAuthEntries, onSelectAuth, onRefreshAuth, disableUrlPrefill, hideHeader, hideStatusChips, hideDocsLink, hideUrlFields, borderless, compactAuthForm, alwaysShowAuthSelector, suppressSaveToast, extraFieldsSlot, initialAuthConfig, globalUrl, userdata, isLoaded, isLoggedIn, serverside, }: AppAuthCardProps) => React$1.JSX.Element;
 declare const AppAuthConfig: ({ apps, authStates, authenticatedApps, onAuthChange, onTestConnection, onSaveAuth, onSelectAuth, onRefreshAuth, globalUrl, userdata, isLoaded, isLoggedIn, serverside, }: AppAuthConfigProps) => React$1.JSX.Element;
 
 /**
@@ -1221,7 +1284,7 @@ declare function useAppAuth(): {
     loading: boolean;
     handleAuthChange: (systemId: string, credentials: Record<string, string>) => void;
     handleTestConnection: (systemId: string, authenticationId?: string) => Promise<void>;
-    handleSaveAuth: (appId: string, credentials: Record<string, string>, appName?: string) => Promise<boolean>;
+    handleSaveAuth: (appId: string, credentials: Record<string, string>, appName?: string, label?: string) => Promise<boolean>;
     refreshAuth: () => Promise<void>;
 };
 
@@ -1248,6 +1311,10 @@ declare const useSyncHostBaseUrl: (globalUrl: string | undefined | null) => void
  * scoped to a Shuffle backend origin) fails repeatedly inside a short window,
  * subsequent calls fail-fast with a synthetic 503 for a cooldown period.
  *
+ * The breaker is "half-open": shortly after tripping it lets a single probe
+ * request through. If that probe succeeds the endpoint is restored immediately
+ * instead of staying blocked for the full cooldown.
+ *
  * This is a safety net — components and hooks should still throttle / cache
  * their own requests. The breaker only kicks in when something has gone wrong
  * (a useEffect missing deps, a render loop, an unreachable backend).
@@ -1400,6 +1467,13 @@ declare const getDatastoreItem: (key: string, category: string, overrideOrgId?:
 declare const getDatastoreItemPublic: (key: string, orgId: string, authorization: string) => Promise<DatastoreResponse & {
     item?: DatastoreItem;
 }>;
+/**
+/**
+ * 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
+ * last one) — the backend returns a cursor even on the final page.
+ */
+declare const getDatastorePageSize: (category: string, limit?: number) => number;
 /**
  * Get all items in a category with optional cursor-based pagination
  */
@@ -1552,6 +1626,67 @@ interface UsageBarProps {
 }
 declare const UsageBar: React__default.FC<UsageBarProps>;
 
+/**
+ * ShuffleMarkdown — the ONE markdown renderer for the platform.
+ *
+ * Every place that renders user/AI/remote markdown should use this component
+ * (or `InlineMarkdown` for single-line strings) instead of importing
+ * `react-markdown` directly, so plugins, link safety and typography stay
+ * identical everywhere.
+ *
+ * Defaults:
+ *  - remark-gfm (tables, strikethrough, task lists, autolinks)
+ *  - remark-breaks (single newline = <br>, matches how LLM/agent output reads)
+ *  - rehype-sanitize (defense in depth; raw HTML is never enabled)
+ *  - external links open in a new tab with noopener/noreferrer
+ *  - shared code / table / blockquote styling based on HSL design tokens
+ */
+
+/** Standardised JSON tree used inside markdown (same viewer as the rest of the platform). */
+declare const MarkdownJsonBlock: React__default.FC<{
+    src: object;
+}>;
+/**
+ * Deliberately loose (not react-markdown's own `Components` type): that type is a mapped
+ * type over `keyof JSX.IntrinsicElements`, which tsup's declaration bundler (rollup-plugin-dts)
+ * cannot inline into this package's published `.d.ts` without erroring (TS2709).
+ */
+type MarkdownComponentOverrides = Record<string, React__default.ElementType>;
+interface ShuffleMarkdownProps {
+    /** The markdown source. */
+    children?: string | null;
+    /** Component overrides merged on top of the shared defaults. */
+    components?: MarkdownComponentOverrides;
+    /** Extra remark plugins appended to the defaults. */
+    remarkPlugins?: any[];
+    /** Disable remark-breaks (for prose docs where blank lines separate paragraphs). */
+    disableBreaks?: boolean;
+    /** Styling applied to the wrapping Box. */
+    sx?: SxProps<Theme>;
+    className?: string;
+}
+declare const ShuffleMarkdown: React__default.FC<ShuffleMarkdownProps>;
+
+/**
+ * VideoEmbed — shared inline video player for markdown content.
+ *
+ * Supports YouTube, Loom and direct video files (mp4/webm/ogg).
+ * Rendered as a block-level span so it is valid inside <p> elements.
+ */
+
+type VideoKind = 'youtube' | 'loom' | 'file';
+interface ResolvedVideo {
+    kind: VideoKind;
+    /** Embed URL for iframes, or the direct file URL for <video>. */
+    src: string;
+}
+/** Returns embed info when the URL points at a supported video, otherwise null. */
+declare function resolveVideoUrl(raw?: string | null): ResolvedVideo | null;
+declare const VideoEmbed: React__default.FC<{
+    video: ResolvedVideo;
+    title?: string;
+}>;
+
 /**
  * Local Singul Library — fully self-contained.
  * No host-app `@/` imports remain inside this folder (assets aside).
@@ -1598,4 +1733,4 @@ declare const LocalLLMConfig: React__default.ComponentType<any>;
 
 declare const AddAppModal: React__default.ComponentType<any>;
 
-export { AGENT_PRESETS, AGENT_PROMPT_PREFIX_CATEGORY, API_CONFIG, AddAppModal, type AddAppModalProps, AgentActivityList, type AgentActivityListProps, type AgentActivityParams, type AgentActivityResponse, type AgentDecision, AgentExecutionDrawer, type AgentExecutionDrawerProps, AgentIcon, type AgentLocalModel, type AgentPreset, AgentPresets, type AgentPresetsProps, AgentPromptPrefixChip, type AgentPromptPrefixChipProps, 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, DEFAULT_AGENT_PROMPT_PREFIX, 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, 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, type UseAgentPromptPrefixOptions, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, ShuffleMCP as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, extractActionAppNames, extractValidatedIngestionApps, extractWorkflowActionAppNames, 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, scheduleAgentRun, searchAgentActivity, seedResolvedApp, setDatastoreItem, setDatastoreItems, setHostBaseUrl, setRegionUrl, setRuntimeOrgId, setToastImpl, shuffleFetch, toast, useAgentPromptPrefix, useAppAuth, useAppAuthFlow, useAppDetail, useAppDetailOptional, useAppLookup, useSyncHostBaseUrl };
+export { AGENT_PRESETS, AGENT_PROMPT_PREFIX_CATEGORY, API_CONFIG, AddAppModal, type AddAppModalProps, AgentActivityList, type AgentActivityListProps, type AgentActivityParams, type AgentActivityResponse, type AgentDecision, AgentExecutionDrawer, type AgentExecutionDrawerProps, AgentIcon, type AgentLocalModel, type AgentPreset, AgentPresets, type AgentPresetsProps, AgentPromptPrefixChip, type AgentPromptPrefixChipProps, 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, 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, DEFAULT_AGENT_PROMPT_PREFIX, 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, ShuffleMarkdown as Markdown, MarkdownJsonBlock, type OutputDiagnosis, 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, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, VideoEmbed, applyRegionFromPayload, ShuffleMCP as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, extractActionAppNames, extractValidatedIngestionApps, extractWorkflowActionAppNames, extractWorkflowAppNames, fetchApps, fetchAppsViaApiConfig, findForwardTicketsWorkflow, findIngestTicketsWorkflow, getApiUrl, getAuthHeader, getDatastoreByCategory, getDatastoreItem, getDatastoreItemPublic, getDatastorePageSize, getFailureInfo, getHostBaseUrl, getIngestionCategory, hasOutputWarning, installFetchBreaker, invalidateAppsCache, invalidateResolvedApps, isCloud, isCloudDomain, isEmailApp, isIngestionApp, isOnprem, isThreatIntelApp, isVulnScannerApp, isWorkflowScheduleStopped, normalizeAppName, parseRunResult, refreshAllIntegrationStatus, registerProtectedOrigin, resetRegionUrl, resolveApp, resolveApps, resolveVideoUrl, scheduleAgentRun, searchAgentActivity, seedResolvedApp, setDatastoreItem, setDatastoreItems, setHostBaseUrl, setRegionUrl, setRuntimeOrgId, setToastImpl, shuffleFetch, toast, useAgentPromptPrefix, useAppAuth, useAppAuthFlow, useAppDetail, useAppDetailOptional, useAppLookup, useSyncHostBaseUrl };