@shuffleio/shuffle-mcps 0.0.23 → 0.0.24

package/dist/index.d.mts

@@ -531,7 +531,7 @@ interface AgentRunDrawerProps extends ShuffleHostProps {
     initialTab?: AgentRunDrawerTab;
     /** Render content for the Permissions tab. Tab is hidden when omitted. */
     permissionsSlot?: React.ReactNode;
-    /** Render content for the Local LLM tab. Tab is hidden when omitted. */
+    /** Render content for the Local LLM tab. Defaults to the bundled Local LLM configuration UI. */
     localLLMSlot?: React.ReactNode;
     /**
      * Custom badge node next to the Local LLM tab label (e.g. a green check
@@ -686,10 +686,36 @@ interface AgentActivityParams {
     /** Workflow ID to search. Defaults to the synthetic 'AGENT' grouping. */
     workflowId?: string;
 }
+type ScheduleStepId = 'name' | 'workflow' | 'schedule';
+type ScheduleStepState = 'active' | 'done' | 'error';
+interface ScheduleStepEvent {
+    id: ScheduleStepId;
+    state: ScheduleStepState;
+    detail?: string;
+}
+interface ScheduleAgentRunArgs {
+    cron: string;
+    input: string;
+    apps?: Array<{
+        name: string;
+        id?: string;
+        icon?: string;
+    }>;
+    onStep?: (event: ScheduleStepEvent) => void;
+    apiKey?: string;
+    apiBaseUrl?: string;
+    orgId?: string;
+}
 /**
  * Search agent workflow executions (workflow_id = "AGENT" by default).
  */
 declare const searchAgentActivity: (params?: AgentActivityParams) => Promise<AgentActivityResponse>;
+/** Create a scheduled AI Agent workflow directly from the library. */
+declare const scheduleAgentRun: ({ cron, input, apps, onStep, apiKey, apiBaseUrl, orgId }: ScheduleAgentRunArgs) => Promise<{
+    workflowId: string;
+    name: string;
+    cron: string;
+}>;
 
 interface AgentActivityListProps extends ShuffleHostProps {
     /** Optional Shuffle API key. Falls back to the shared API_CONFIG. */
@@ -761,11 +787,14 @@ interface AgentExecutionDrawerProps extends ShuffleHostProps {
 
 interface AgentsViewProps extends ShuffleHostProps {
     /**
-     * Required scheduler implementation. Receives the cron + prompt + apps
-     * from AgentUI and is responsible for creating the underlying scheduled
-     * workflow on the host backend.
+     * Optional scheduler override. When omitted, AgentsView creates the scheduled
+     * AI Agent workflow directly through the Shuffle API.
      */
-    onSchedule: NonNullable<AgentUIProps['onSchedule']>;
+    onSchedule?: NonNullable<AgentUIProps['onSchedule']>;
+    /** Optional Shuffle API key. Falls back to the shared API config/session. */
+    apiKey?: string;
+    /** Optional Shuffle Org ID — sent as the `Org-Id` header on library fetches. */
+    orgId?: string;
     /** Override max content width of the inner stack. Defaults to 820. */
     maxWidth?: number;
     /**
@@ -782,13 +811,31 @@ interface AgentsViewProps extends ShuffleHostProps {
     /**
      * Content rendered inside the built-in AgentRunDrawer's Local LLM tab
      * when no `onChooseLLM` is provided. Use to plug in your own local LLM
-     * config form. When omitted, a minimal built-in placeholder is shown.
+     * config form. When omitted, the built-in Local LLM configuration UI is shown.
      */
     localLLMSlot?: React.ReactNode;
     /** Content for the built-in AgentRunDrawer's Permissions tab. Optional. */
     permissionsSlot?: React.ReactNode;
 }
 
+interface AgentLocalModel {
+    url: string;
+    apikey: string;
+    model: string;
+}
+interface LocalLLMTestResult {
+    success: boolean;
+    message: string;
+    models?: string[];
+    latencyMs?: number;
+}
+interface LocalLLMConfigProps extends ShuffleHostProps {
+    compact?: boolean;
+    hasOpenAIAuth?: boolean;
+    onSave?: (model: AgentLocalModel) => void;
+    onTestResult?: (result: LocalLLMTestResult) => void;
+}
+
 /**
  * Shared diagnosis utilities for an agent execution result.
  *
@@ -1346,7 +1393,10 @@ declare const UsageBar: React$1.FC<UsageBarProps>;
 /**
  * Every exported component accepts an optional `theme` prop:
  *   - `"light"` / `"dark"` — pin the subtree to that scheme
- *   - `"system"` (default) — follow the host page's `.dark` class on `<html>`
+ *   - `"system"` — follow the host page's `.dark` class on `<html>`
+ *
+ * If `theme` is omitted, defaults to `"dark"` (Shuffle's primary surface).
+ * Callers can always override by passing `theme="light"` or `theme="system"`.
  *
  * `colorMode` is preserved as a legacy alias (`"auto"` == `"system"`).
  */
@@ -1377,5 +1427,6 @@ declare const AgentExecutionDrawer: React$1.ComponentType<any>;
 declare const AgentsView: React$1.ComponentType<any>;
 
 declare const AgentRunDiagnosisBanner: React$1.ComponentType<any>;
+declare const LocalLLMConfig: React$1.ComponentType<any>;
 
-export { API_CONFIG, AgentActivityList, type AgentActivityListProps, type AgentActivityParams, type AgentActivityResponse, type AgentDecision, AgentExecutionDrawer, type AgentExecutionDrawerProps, AgentIcon, type AgentRun, AgentRunDiagnosisBanner, AgentRunDrawer, type AgentRunDrawerProps, type AgentRunDrawerTab, type AgentRunResult, AgentUI, type AgentUIApp, type AgentUIProps, 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, type DatastoreDiagnostics, type DatastoreItem, type DatastoreResponse, type DiagnosableRun, type DiagnosisEvidence, EDR_PATTERNS, EMAIL_APP_PATTERNS, FORWARD_TICKETS_WORKFLOW_NAME, type FetchAppsOptions, INGEST_TICKETS_WORKFLOW_NAME, type IngestionCategory, IntegrationStatus, type OutputDiagnosis, type ResolvedApp, SIEM_PATTERNS, 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, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, ShuffleMCP as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, extractValidatedIngestionApps, 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, searchAgentActivity, seedResolvedApp, setDatastoreItem, setDatastoreItems, setHostBaseUrl, setRegionUrl, setRuntimeOrgId, setToastImpl, shuffleFetch, toast, useAppAuth, useAppDetail, useAppDetailOptional, useAppLookup, useSyncHostBaseUrl };
+export { API_CONFIG, AgentActivityList, type AgentActivityListProps, type AgentActivityParams, type AgentActivityResponse, type AgentDecision, AgentExecutionDrawer, type AgentExecutionDrawerProps, AgentIcon, type AgentLocalModel, 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, 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, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, ShuffleMCP as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, extractValidatedIngestionApps, 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, useAppAuth, useAppDetail, useAppDetailOptional, useAppLookup, useSyncHostBaseUrl };

package/dist/index.d.ts

@@ -531,7 +531,7 @@ interface AgentRunDrawerProps extends ShuffleHostProps {
     initialTab?: AgentRunDrawerTab;
     /** Render content for the Permissions tab. Tab is hidden when omitted. */
     permissionsSlot?: React.ReactNode;
-    /** Render content for the Local LLM tab. Tab is hidden when omitted. */
+    /** Render content for the Local LLM tab. Defaults to the bundled Local LLM configuration UI. */
     localLLMSlot?: React.ReactNode;
     /**
      * Custom badge node next to the Local LLM tab label (e.g. a green check
@@ -686,10 +686,36 @@ interface AgentActivityParams {
     /** Workflow ID to search. Defaults to the synthetic 'AGENT' grouping. */
     workflowId?: string;
 }
+type ScheduleStepId = 'name' | 'workflow' | 'schedule';
+type ScheduleStepState = 'active' | 'done' | 'error';
+interface ScheduleStepEvent {
+    id: ScheduleStepId;
+    state: ScheduleStepState;
+    detail?: string;
+}
+interface ScheduleAgentRunArgs {
+    cron: string;
+    input: string;
+    apps?: Array<{
+        name: string;
+        id?: string;
+        icon?: string;
+    }>;
+    onStep?: (event: ScheduleStepEvent) => void;
+    apiKey?: string;
+    apiBaseUrl?: string;
+    orgId?: string;
+}
 /**
  * Search agent workflow executions (workflow_id = "AGENT" by default).
  */
 declare const searchAgentActivity: (params?: AgentActivityParams) => Promise<AgentActivityResponse>;
+/** Create a scheduled AI Agent workflow directly from the library. */
+declare const scheduleAgentRun: ({ cron, input, apps, onStep, apiKey, apiBaseUrl, orgId }: ScheduleAgentRunArgs) => Promise<{
+    workflowId: string;
+    name: string;
+    cron: string;
+}>;
 
 interface AgentActivityListProps extends ShuffleHostProps {
     /** Optional Shuffle API key. Falls back to the shared API_CONFIG. */
@@ -761,11 +787,14 @@ interface AgentExecutionDrawerProps extends ShuffleHostProps {
 
 interface AgentsViewProps extends ShuffleHostProps {
     /**
-     * Required scheduler implementation. Receives the cron + prompt + apps
-     * from AgentUI and is responsible for creating the underlying scheduled
-     * workflow on the host backend.
+     * Optional scheduler override. When omitted, AgentsView creates the scheduled
+     * AI Agent workflow directly through the Shuffle API.
      */
-    onSchedule: NonNullable<AgentUIProps['onSchedule']>;
+    onSchedule?: NonNullable<AgentUIProps['onSchedule']>;
+    /** Optional Shuffle API key. Falls back to the shared API config/session. */
+    apiKey?: string;
+    /** Optional Shuffle Org ID — sent as the `Org-Id` header on library fetches. */
+    orgId?: string;
     /** Override max content width of the inner stack. Defaults to 820. */
     maxWidth?: number;
     /**
@@ -782,13 +811,31 @@ interface AgentsViewProps extends ShuffleHostProps {
     /**
      * Content rendered inside the built-in AgentRunDrawer's Local LLM tab
      * when no `onChooseLLM` is provided. Use to plug in your own local LLM
-     * config form. When omitted, a minimal built-in placeholder is shown.
+     * config form. When omitted, the built-in Local LLM configuration UI is shown.
      */
     localLLMSlot?: React.ReactNode;
     /** Content for the built-in AgentRunDrawer's Permissions tab. Optional. */
     permissionsSlot?: React.ReactNode;
 }
 
+interface AgentLocalModel {
+    url: string;
+    apikey: string;
+    model: string;
+}
+interface LocalLLMTestResult {
+    success: boolean;
+    message: string;
+    models?: string[];
+    latencyMs?: number;
+}
+interface LocalLLMConfigProps extends ShuffleHostProps {
+    compact?: boolean;
+    hasOpenAIAuth?: boolean;
+    onSave?: (model: AgentLocalModel) => void;
+    onTestResult?: (result: LocalLLMTestResult) => void;
+}
+
 /**
  * Shared diagnosis utilities for an agent execution result.
  *
@@ -1346,7 +1393,10 @@ declare const UsageBar: React$1.FC<UsageBarProps>;
 /**
  * Every exported component accepts an optional `theme` prop:
  *   - `"light"` / `"dark"` — pin the subtree to that scheme
- *   - `"system"` (default) — follow the host page's `.dark` class on `<html>`
+ *   - `"system"` — follow the host page's `.dark` class on `<html>`
+ *
+ * If `theme` is omitted, defaults to `"dark"` (Shuffle's primary surface).
+ * Callers can always override by passing `theme="light"` or `theme="system"`.
  *
  * `colorMode` is preserved as a legacy alias (`"auto"` == `"system"`).
  */
@@ -1377,5 +1427,6 @@ declare const AgentExecutionDrawer: React$1.ComponentType<any>;
 declare const AgentsView: React$1.ComponentType<any>;
 
 declare const AgentRunDiagnosisBanner: React$1.ComponentType<any>;
+declare const LocalLLMConfig: React$1.ComponentType<any>;
 
-export { API_CONFIG, AgentActivityList, type AgentActivityListProps, type AgentActivityParams, type AgentActivityResponse, type AgentDecision, AgentExecutionDrawer, type AgentExecutionDrawerProps, AgentIcon, type AgentRun, AgentRunDiagnosisBanner, AgentRunDrawer, type AgentRunDrawerProps, type AgentRunDrawerTab, type AgentRunResult, AgentUI, type AgentUIApp, type AgentUIProps, 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, type DatastoreDiagnostics, type DatastoreItem, type DatastoreResponse, type DiagnosableRun, type DiagnosisEvidence, EDR_PATTERNS, EMAIL_APP_PATTERNS, FORWARD_TICKETS_WORKFLOW_NAME, type FetchAppsOptions, INGEST_TICKETS_WORKFLOW_NAME, type IngestionCategory, IntegrationStatus, type OutputDiagnosis, type ResolvedApp, SIEM_PATTERNS, 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, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, ShuffleMCP as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, extractValidatedIngestionApps, 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, searchAgentActivity, seedResolvedApp, setDatastoreItem, setDatastoreItems, setHostBaseUrl, setRegionUrl, setRuntimeOrgId, setToastImpl, shuffleFetch, toast, useAppAuth, useAppDetail, useAppDetailOptional, useAppLookup, useSyncHostBaseUrl };
+export { API_CONFIG, AgentActivityList, type AgentActivityListProps, type AgentActivityParams, type AgentActivityResponse, type AgentDecision, AgentExecutionDrawer, type AgentExecutionDrawerProps, AgentIcon, type AgentLocalModel, 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, 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, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, ShuffleMCP as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, extractValidatedIngestionApps, 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, useAppAuth, useAppDetail, useAppDetailOptional, useAppLookup, useSyncHostBaseUrl };