@shuffleio/shuffle-mcps 0.0.34 → 0.0.35

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

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

package/dist/{chunk-B4JFC2JU.mjs → chunk-5B3Q2RHS.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 : "";
@@ -244,13 +276,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, {
@@ -340,7 +365,6 @@ export {
   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;
@@ -807,6 +808,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 +857,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 +929,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 {
@@ -964,6 +981,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 +1064,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 +1077,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 +1271,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 +1298,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 +1454,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
  */
@@ -1598,4 +1659,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, 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, getDatastorePageSize, 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 };

package/dist/index.d.ts

@@ -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;
@@ -807,6 +808,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 +857,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 +929,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 {
@@ -964,6 +981,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 +1064,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 +1077,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 +1271,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 +1298,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 +1454,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
  */
@@ -1598,4 +1659,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, 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, getDatastorePageSize, 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 };