@shuffleio/shuffle-mcps 0.0.68 → 0.0.69-staging-52bdb60

package/README.md

@@ -210,10 +210,11 @@ Reference implementation in production: [`src/Shuffle-MCPs/AppSearchDrawer.tsx`]
 
 ### 4. `<AgentUI />` — start + debug agents
 
-A standalone "What do you want to do?" surface for the Shuffle agent. Two modes in one component:
+A standalone "What do you want to do?" surface for the Shuffle agent. Its tabs are:
 
-1. **Starter** — large hero prompt with attached MCP/app chips. Submits to `/api/v1/agent`.
-2. **Debugger** — compact header + live decision timeline driven by `/api/v1/streams/results`, with question/continuation forms, per-decision raw-JSON inspection, approvals, retries, and reruns.
+1. **Start** — large hero prompt with attached MCP/app chips. Submits to `/api/v1/agent`.
+2. **Simple / Detailed** — compact header + live decision timeline driven by `/api/v1/streams/results`, with question/continuation forms, per-decision raw-JSON inspection, approvals, retries, and reruns.
+3. **Chat** — the same run as a conversation: the user's messages, the steps the agent took (collapsed once done), its questions with one-click replies, credentials to connect, and its answers. The composer starts a run, answers the agent, or continues a finished run.
 
 It switches modes automatically when an execution starts, or when `?execution_id=...&authorization=...` is present in the URL.
 
@@ -250,10 +251,28 @@ Useful props:
 | `compact` / `hideHeroIcon` / `hideAppPicker` / `hideAttach` | `boolean` | Layout switches for embedding |
 | `maxWidth` | `number` | Max width of the centered card. Default `900` |
 | `onRun` | `(info) => void` | Fires whenever a run finishes (success or failure) |
+| `initialView` | `'start' \| 'simple' \| 'detailed' \| 'chat'` | View to open on mount. `'chat'` opens the Chat tab, without the Start form, and keeps the tabs visible before the first run |
+| `workflowId` | `string` | Workflow the agent works on (edit-workflow skill). In Chat it also enables "Revert" and the workflow events below |
 | `className` / `sx` / `contentSx` | `string` / `SxProps` | Style overrides for the root container and inner content column |
 
 Reference page in production: [`src/pages/dashboard/AgentsPage.tsx`](../pages/dashboard/AgentsPage.tsx) (mounted at [`/agents`](https://shuffle.security/agents)).
 
+When the Chat tab changes or runs a workflow it sends window events, so a page showing that workflow can keep its canvas in sync. Without a listener the chat still works. Runs the agent starts also get a card in the chat showing each node's status as the engine recorded it.
+
+| Event | `detail` | Sent when |
+|---|---|---|
+| `AGENT_WORKFLOW_CHANGED_EVENT` | `{ workflowId, nodeIds, reverted? }` | An agent edit to the workflow finished, or the user reverted the chat's changes |
+| `AGENT_FOCUS_NODE_EVENT` | `{ workflowId, nodeId }` | The user clicked a changed node in the chat |
+| `AGENT_OPEN_EXECUTION_EVENT` | `{ workflowId, executionId, authorization }` | The agent started a workflow run, or the user clicked "Open in debug view" (only sent when `workflowId` is set) |
+
+```tsx
+import { AGENT_WORKFLOW_CHANGED_EVENT } from 'shuffle-mcps';
+
+window.addEventListener(AGENT_WORKFLOW_CHANGED_EVENT, (e) => {
+  if (e.detail.workflowId === workflow.id) reloadWorkflow();
+});
+```
+
 ### 5. `<AgentRunDrawer />` — Run Agent side panel
 
 Right-side drawer that embeds `<AgentUI />` in compact mode, with optional **Permissions** and **Local LLM** tabs you fill via slots. Zero host-app context required — pass `apiKey` / `apiBaseUrl` / `orgId` through `agentUIProps` to authenticate.

package/dist/{appsCache-QAL2GC5W.mjs → appsCache-UIU3LPWV.mjs}

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

package/dist/{chunk-V3R4HDJT.mjs → chunk-TAHB4QZU.mjs}

@@ -612,10 +612,30 @@ var isShuffleCloudDomain = (url) => {
     return false;
   }
 };
+var isOnShufflerIoHost = () => {
+  if (typeof window === "undefined") return false;
+  const host = window.location.hostname.toLowerCase();
+  if (host === "security.shuffler.io") return false;
+  return host === "shuffler.io" || host.endsWith(".shuffler.io");
+};
 var mapCloudRegionUrl = (url) => {
   if (!url || typeof url !== "string") return "";
   const trimmed = url.trim();
   if (!trimmed) return "";
+  if (isOnShufflerIoHost()) {
+    try {
+      const parsed = new URL(/^[a-zA-Z][a-zA-Z\d+\-.]*:\/\//.test(trimmed) ? trimmed : `https://${trimmed}`);
+      const h = parsed.hostname.toLowerCase();
+      if (h === "shuffle.security" || h === "www.shuffle.security") {
+        parsed.hostname = "shuffler.io";
+      } else if (h.endsWith(".shuffle.security")) {
+        parsed.hostname = `${h.slice(0, -".shuffle.security".length)}.shuffler.io`;
+      }
+      return parsed.toString().replace(/\/+$/, "");
+    } catch {
+      return trimmed.replace(/\/+$/, "");
+    }
+  }
   const hasScheme = /^[a-zA-Z][a-zA-Z\d+\-.]*:\/\//.test(trimmed);
   const toParse = hasScheme ? trimmed : `https://${trimmed}`;
   try {
@@ -675,6 +695,7 @@ var getDefaultBaseUrl = () => {
     if (customHost) return customHost;
     return PROD_BACKEND;
   }
+  if (isOnShufflerIoHost()) return window.location.origin;
   if (isCloudDomain()) return PROD_BACKEND;
   if (typeof window !== "undefined") {
     return window.location.origin;
@@ -818,7 +839,9 @@ var resetRegionUrl = () => {
 var SHUFFLE_HOST_BASE_URL_EVENT = "shuffle:set-host-base-url";
 var setHostBaseUrl = (url) => {
   let next = url ? url.replace(/\/+$/, "") : null;
-  if (next && isShuffleCloudDomain(next) && !isDevEnvironment()) next = null;
+  if (next && isShuffleCloudDomain(next) && !isDevEnvironment()) {
+    next = isOnShufflerIoHost() ? mapCloudRegionUrl(next) || null : null;
+  }
   if (next === _hostBaseUrl) return;
   _hostBaseUrl = next;
   if (next) {
@@ -856,7 +879,13 @@ var clearAuthTokens = () => {
 var getSessionToken = () => {
   try {
     if (typeof localStorage === "undefined") return null;
-    if (localStorage.getItem(LEGACY_API_KEY_STORAGE_KEY) !== null) {
+    const legacy = localStorage.getItem(LEGACY_API_KEY_STORAGE_KEY);
+    if (legacy !== null) {
+      const current = localStorage.getItem("session_token");
+      const legacyValid = legacy.trim().length > 0 && legacy !== "null" && legacy !== "undefined";
+      if (legacyValid && (!current || current === "null" || current === "undefined")) {
+        localStorage.setItem("session_token", legacy.trim());
+      }
       localStorage.removeItem(LEGACY_API_KEY_STORAGE_KEY);
     }
     const stored = localStorage.getItem("session_token");

package/dist/index.d.mts

@@ -489,6 +489,8 @@ interface AgentUIApp {
     /** Optional preview icon URL. */
     icon?: string;
 }
+/** Top-level views of AgentUI. */
+type AgentUIView = 'start' | 'simple' | 'detailed' | 'chat';
 interface AgentUIProps {
     /** Optional React key to force re-mounting when context changes */
     key?: React__default.Key;
@@ -617,7 +619,7 @@ interface AgentUIProps {
         };
         [k: string]: any;
     };
-    /** Called whenever a run finishes (success or failure). */
+    /** Called once the request to start a run returns: success with the new execution, or the error it failed to start with. */
     onRun?: (info: {
         input: string;
         success: boolean;
@@ -625,10 +627,32 @@ interface AgentUIProps {
         authorization?: string;
         error?: string;
     }) => void;
+    /** Awaited before a run starts or continues, e.g. so the host can save its unsaved changes first. */
+    onBeforeRun?: () => void | Promise<void>;
+    /**
+     * Called when the shown run's status changes. `previousStatus` is the status this
+     * same run had before, so it is missing for a run that was just opened or started.
+     * `status` is empty once no run is shown (e.g. after stopping one that never started).
+     * `waiting` is true while the agent waits for the user (a question or an approval);
+     * the run itself still counts as running then.
+     */
+    onRunStatusChange?: (info: {
+        executionId: string;
+        status: string;
+        previousStatus?: string;
+        running: boolean;
+        waiting: boolean;
+    }) => void;
     /** Called whenever the chip set under the prompt changes (add/remove apps). */
     onAppsChange?: (apps: AgentUIApp[]) => void;
-    /** Called whenever the active top-level view changes (start / simple / detailed). */
-    onViewChange?: (view: 'start' | 'simple' | 'detailed') => void;
+    /** Called whenever the active top-level view changes (start / simple / detailed / chat). */
+    onViewChange?: (view: AgentUIView) => void;
+    /**
+     * View to open on mount. 'chat' shows the run as a conversation and lets the
+     * user start, answer and continue runs from there. When omitted, the stored
+     * Simple/Detailed preference is used (unchanged behaviour).
+     */
+    initialView?: AgentUIView;
     /**
      * Called when the user saves a recurring schedule (cron expression) for the
      * current prompt. When omitted, a toast is shown indicating scheduling is
@@ -755,6 +779,29 @@ interface AppDetailDrawerRenderProps {
 /** Set of confirmed live built-in Shuffle services that are always available in the platform */
 declare const VERIFIED_BUILTIN_APPS: Set<string>;
 
+/** Sent by the chat when the agent changed a workflow. Hosts showing that
+ * workflow can reload it and highlight the nodes. */
+declare const AGENT_WORKFLOW_CHANGED_EVENT = "shuffle:agent_workflow_changed";
+type AgentWorkflowChangedDetail = {
+    workflowId: string;
+    nodeIds: string[];
+    reverted?: boolean;
+};
+/** Sent when the user asks to see a node the agent touched. */
+declare const AGENT_FOCUS_NODE_EVENT = "shuffle:agent_focus_node";
+type AgentFocusNodeDetail = {
+    workflowId: string;
+    nodeId: string;
+};
+/** Sent when the agent started a workflow run, or the user asks to see it.
+ * Hosts showing that workflow can open the run in their own run view. */
+declare const AGENT_OPEN_EXECUTION_EVENT = "shuffle:agent_open_execution";
+type AgentOpenExecutionDetail = {
+    workflowId: string;
+    executionId: string;
+    authorization: string;
+};
+
 interface AgentPromptPrefixChipProps {
     /** Optional label override. Defaults to "Shuffle Tools MCP". */
     label?: string;
@@ -971,7 +1018,7 @@ interface PageContextChoice {
     executionId?: string | null;
     authorization?: string | null;
     executionStatus?: string | null;
-    viewMode?: 'start' | 'simple' | 'detailed' | null;
+    viewMode?: 'start' | 'simple' | 'detailed' | 'chat' | null;
     updatedAt: number;
 }
 /** Match a URL pathname against a route pattern with `:param` segments */
@@ -1085,6 +1132,10 @@ interface AskAiSidePanelProps extends ShuffleHostProps {
     rules?: AgentContextRule[];
     /** Authoritative support user flag */
     isSupport?: boolean;
+    /** Distance in px from the right edge of the screen, for hosts that dock their own panel there. Default 0. */
+    rightOffset?: number;
+    /** Keep the agent mounted while the panel is closed, e.g. so a run in progress is still followed. Default false. */
+    keepMounted?: boolean;
     /** Panel width in pixels. Default: 380 */
     width?: number;
     /** Theme override forwarded to AgentUI */
@@ -1202,15 +1253,6 @@ interface ApiCallViewerProps extends ShuffleHostProps {
 
 /** Check if a URL belongs to a Shuffle Cloud domain (*.shuffler.io or *.shuffle.security) */
 declare const isShuffleCloudDomain: (url?: string | null) => boolean;
-/**
- * Maps legacy shuffler.io cloud URLs to shuffle.security redirect routes.
- *
- * Mapping rules:
- * - shuffler.io / shuffle.security -> https://uk.shuffle.security (default cloud backend)
- * - <subdomain>.shuffler.io -> https://<subdomain>.shuffle.security (e.g. ca, us, eu, au, uk, frankfurt)
- * - <subdomain>.shuffle.security -> preserved as https://<subdomain>.shuffle.security
- * - Self-hosted / on-prem / dev URLs -> preserved as-is
- */
 declare const mapCloudRegionUrl: (url?: string | null) => string;
 /** Check if running on a known Shuffle Cloud domain */
 declare const isCloudDomain: () => boolean;
@@ -2097,6 +2139,7 @@ declare const DATASTORE_CATEGORIES: {
     readonly INFRASTRUCTURE: "shuffle-security_infrastructure";
     readonly USERS: "shuffle-security_users";
     readonly REPORTS: "shuffle-security_reports";
+    readonly DASHBOARDS: "shuffle-security_dashboards";
     readonly LEGACY_ALERTS: "shuffle-security_alerts";
     readonly LEGACY_CASES: "shuffle-security_cases";
 };
@@ -2375,7 +2418,8 @@ declare function openSupportEscalation(context: SupportEscalationContext): void;
 type ShuffleTheme = 'light' | 'dark' | 'system';
 type WithTheme<P> = P & {
     theme?: ShuffleTheme;
-    colorMode?: ShuffleMcpColorMode;
+    colorMode?: ShuffleMcpColorMode; /** Backend base URL. On *.shuffler.io hosts it always wins; on Shuffle Cloud elsewhere only self-hosted URLs are honored. */
+    globalUrl?: string;
 };
 
 declare const AiAgentPromptsEditor: React.ComponentType<WithTheme<P>>;
@@ -2413,4 +2457,4 @@ declare const AgentsView: React.ComponentType<WithTheme<P>>;
 declare const AgentRunDiagnosisBanner: React.ComponentType<WithTheme<P>>;
 declare const LocalLLMConfig: React.ComponentType<WithTheme<P>>;
 
-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, 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, type AppDetailDrawerRenderProps, AppDetailProvider, type AppLookupResult, 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, type ShuffleMCPProps, ShuffleMarkdown, type ShuffleMcpColorMode, ShuffleMcpThemeProvider, ShufflePipelinesBanner, type ShuffleTheme, type ShuffleTokenStyle, SingulActionsPreview, type SupportEscalationContext, THREAT_INTEL_PATTERNS, type ToolDrawerRenderProps, TryMcpSection, type TryMcpSectionProps, UsageBar, type UsageBarProps, type UseAgentPromptPrefixOptions, VERIFIED_BUILTIN_APPS, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, VideoEmbed, applyRegionFromPayload, buildSupportEscalationUrl, clearPageContextChoice, copyToClipboard, darkTokenStyle, AgentsView as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, ensureShuffleMcpStyles, extractActionAppNames, extractValidatedIngestionApps, extractWorkflowActionAppNames, extractWorkflowAppNames, fallbackCopyText as fallbackCopyToClipboard, fetchApps, fetchAppsViaApiConfig, fetchConnectedTools, filterItemsByCategory, findForwardTicketsWorkflow, findIngestTicketsWorkflow, getActivePageEntityName, getAgentContextRules, getApiUrl, getAuthHeader, getCachedConnectedTools, getDatastoreByCategory, getDatastoreItem, getDatastoreItemPublic, getDatastorePageSize, getFailureInfo, getHostBaseUrl, getIngestionCategory, getPageContextChoice, hasOutputWarning, installClipboardPolyfill, installCryptoRandomUuidPolyfill, installFetchBreaker, invalidateAppsCache, invalidateResolvedApps, isAgentRoute, isCloud, isCloudDomain, isEmailApp, isIngestionApp, isOnprem, isShuffleCloudDomain, isShuffleSecurityBackend, isThreatIntelApp, isVulnScannerApp, isWorkflowScheduleStopped, lightTokenStyle, mapCloudRegionUrl, matchRoutePattern, mergeConnectedTools, normalizeAppName, openSupportEscalation, parseRunResult, refreshAllIntegrationStatus, registerAgentContextRule, registerProtectedOrigin, resetRegionUrl, resolveAgentContext, resolveApp, resolveApps, resolveConnectedTools, resolveContactUserInfo, resolveVideoUrl, safeRandomUUID, scheduleAgentRun, searchAgentActivity, seedResolvedApp, setCachedConnectedTools, setDatastoreItem, setDatastoreItems, setHostBaseUrl, setPageContextChoice, setRegionUrl, setRuntimeOrgId, setToastImpl, shuffleFetch, toast, useAgentPromptPrefix, useAppAuth, useAppAuthFlow, useAppDetail, useAppDetailOptional, useAppLookup, useContextAwareAgent, useSyncHostBaseUrl, uuid };
+export { AGENT_DRAWER_CLOSE_EVENT, AGENT_DRAWER_OPEN_EVENT, AGENT_DRAWER_STATE_EVENT, AGENT_FOCUS_NODE_EVENT, AGENT_OPEN_EXECUTION_EVENT, AGENT_PRESETS, AGENT_PROMPT_PREFIX_CATEGORY, AGENT_WORKFLOW_CHANGED_EVENT, API_CONFIG, ASK_AI_PANEL_WIDTH_STORAGE_KEY, AgentActivityList, type AgentActivityListProps, type AgentActivityParams, type AgentActivityResponse, type AgentContextApp, type AgentContextRule, type AgentDecision, AgentExecutionDrawer, type AgentExecutionDrawerProps, type AgentFocusNodeDetail, AgentIcon, type AgentLocalModel, type AgentOpenExecutionDetail, 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, type AgentUIView, type AgentWorkflowChangedDetail, 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, type AppDetailDrawerRenderProps, AppDetailProvider, type AppLookupResult, 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, type ShuffleMCPProps, ShuffleMarkdown, type ShuffleMcpColorMode, ShuffleMcpThemeProvider, ShufflePipelinesBanner, type ShuffleTheme, type ShuffleTokenStyle, SingulActionsPreview, type SupportEscalationContext, THREAT_INTEL_PATTERNS, type ToolDrawerRenderProps, TryMcpSection, type TryMcpSectionProps, UsageBar, type UsageBarProps, type UseAgentPromptPrefixOptions, VERIFIED_BUILTIN_APPS, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, VideoEmbed, applyRegionFromPayload, buildSupportEscalationUrl, clearPageContextChoice, copyToClipboard, darkTokenStyle, AgentsView as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, ensureShuffleMcpStyles, extractActionAppNames, extractValidatedIngestionApps, extractWorkflowActionAppNames, extractWorkflowAppNames, fallbackCopyText as fallbackCopyToClipboard, fetchApps, fetchAppsViaApiConfig, fetchConnectedTools, filterItemsByCategory, findForwardTicketsWorkflow, findIngestTicketsWorkflow, getActivePageEntityName, getAgentContextRules, getApiUrl, getAuthHeader, getCachedConnectedTools, getDatastoreByCategory, getDatastoreItem, getDatastoreItemPublic, getDatastorePageSize, getFailureInfo, getHostBaseUrl, getIngestionCategory, getPageContextChoice, hasOutputWarning, installClipboardPolyfill, installCryptoRandomUuidPolyfill, installFetchBreaker, invalidateAppsCache, invalidateResolvedApps, isAgentRoute, isCloud, isCloudDomain, isEmailApp, isIngestionApp, isOnprem, isShuffleCloudDomain, isShuffleSecurityBackend, isThreatIntelApp, isVulnScannerApp, isWorkflowScheduleStopped, lightTokenStyle, mapCloudRegionUrl, matchRoutePattern, mergeConnectedTools, normalizeAppName, openSupportEscalation, parseRunResult, refreshAllIntegrationStatus, registerAgentContextRule, registerProtectedOrigin, resetRegionUrl, resolveAgentContext, resolveApp, resolveApps, resolveConnectedTools, resolveContactUserInfo, resolveVideoUrl, safeRandomUUID, scheduleAgentRun, searchAgentActivity, seedResolvedApp, setCachedConnectedTools, setDatastoreItem, setDatastoreItems, setHostBaseUrl, setPageContextChoice, setRegionUrl, setRuntimeOrgId, setToastImpl, shuffleFetch, toast, useAgentPromptPrefix, useAppAuth, useAppAuthFlow, useAppDetail, useAppDetailOptional, useAppLookup, useContextAwareAgent, useSyncHostBaseUrl, uuid };

package/dist/index.d.ts

@@ -489,6 +489,8 @@ interface AgentUIApp {
     /** Optional preview icon URL. */
     icon?: string;
 }
+/** Top-level views of AgentUI. */
+type AgentUIView = 'start' | 'simple' | 'detailed' | 'chat';
 interface AgentUIProps {
     /** Optional React key to force re-mounting when context changes */
     key?: React__default.Key;
@@ -617,7 +619,7 @@ interface AgentUIProps {
         };
         [k: string]: any;
     };
-    /** Called whenever a run finishes (success or failure). */
+    /** Called once the request to start a run returns: success with the new execution, or the error it failed to start with. */
     onRun?: (info: {
         input: string;
         success: boolean;
@@ -625,10 +627,32 @@ interface AgentUIProps {
         authorization?: string;
         error?: string;
     }) => void;
+    /** Awaited before a run starts or continues, e.g. so the host can save its unsaved changes first. */
+    onBeforeRun?: () => void | Promise<void>;
+    /**
+     * Called when the shown run's status changes. `previousStatus` is the status this
+     * same run had before, so it is missing for a run that was just opened or started.
+     * `status` is empty once no run is shown (e.g. after stopping one that never started).
+     * `waiting` is true while the agent waits for the user (a question or an approval);
+     * the run itself still counts as running then.
+     */
+    onRunStatusChange?: (info: {
+        executionId: string;
+        status: string;
+        previousStatus?: string;
+        running: boolean;
+        waiting: boolean;
+    }) => void;
     /** Called whenever the chip set under the prompt changes (add/remove apps). */
     onAppsChange?: (apps: AgentUIApp[]) => void;
-    /** Called whenever the active top-level view changes (start / simple / detailed). */
-    onViewChange?: (view: 'start' | 'simple' | 'detailed') => void;
+    /** Called whenever the active top-level view changes (start / simple / detailed / chat). */
+    onViewChange?: (view: AgentUIView) => void;
+    /**
+     * View to open on mount. 'chat' shows the run as a conversation and lets the
+     * user start, answer and continue runs from there. When omitted, the stored
+     * Simple/Detailed preference is used (unchanged behaviour).
+     */
+    initialView?: AgentUIView;
     /**
      * Called when the user saves a recurring schedule (cron expression) for the
      * current prompt. When omitted, a toast is shown indicating scheduling is
@@ -755,6 +779,29 @@ interface AppDetailDrawerRenderProps {
 /** Set of confirmed live built-in Shuffle services that are always available in the platform */
 declare const VERIFIED_BUILTIN_APPS: Set<string>;
 
+/** Sent by the chat when the agent changed a workflow. Hosts showing that
+ * workflow can reload it and highlight the nodes. */
+declare const AGENT_WORKFLOW_CHANGED_EVENT = "shuffle:agent_workflow_changed";
+type AgentWorkflowChangedDetail = {
+    workflowId: string;
+    nodeIds: string[];
+    reverted?: boolean;
+};
+/** Sent when the user asks to see a node the agent touched. */
+declare const AGENT_FOCUS_NODE_EVENT = "shuffle:agent_focus_node";
+type AgentFocusNodeDetail = {
+    workflowId: string;
+    nodeId: string;
+};
+/** Sent when the agent started a workflow run, or the user asks to see it.
+ * Hosts showing that workflow can open the run in their own run view. */
+declare const AGENT_OPEN_EXECUTION_EVENT = "shuffle:agent_open_execution";
+type AgentOpenExecutionDetail = {
+    workflowId: string;
+    executionId: string;
+    authorization: string;
+};
+
 interface AgentPromptPrefixChipProps {
     /** Optional label override. Defaults to "Shuffle Tools MCP". */
     label?: string;
@@ -971,7 +1018,7 @@ interface PageContextChoice {
     executionId?: string | null;
     authorization?: string | null;
     executionStatus?: string | null;
-    viewMode?: 'start' | 'simple' | 'detailed' | null;
+    viewMode?: 'start' | 'simple' | 'detailed' | 'chat' | null;
     updatedAt: number;
 }
 /** Match a URL pathname against a route pattern with `:param` segments */
@@ -1085,6 +1132,10 @@ interface AskAiSidePanelProps extends ShuffleHostProps {
     rules?: AgentContextRule[];
     /** Authoritative support user flag */
     isSupport?: boolean;
+    /** Distance in px from the right edge of the screen, for hosts that dock their own panel there. Default 0. */
+    rightOffset?: number;
+    /** Keep the agent mounted while the panel is closed, e.g. so a run in progress is still followed. Default false. */
+    keepMounted?: boolean;
     /** Panel width in pixels. Default: 380 */
     width?: number;
     /** Theme override forwarded to AgentUI */
@@ -1202,15 +1253,6 @@ interface ApiCallViewerProps extends ShuffleHostProps {
 
 /** Check if a URL belongs to a Shuffle Cloud domain (*.shuffler.io or *.shuffle.security) */
 declare const isShuffleCloudDomain: (url?: string | null) => boolean;
-/**
- * Maps legacy shuffler.io cloud URLs to shuffle.security redirect routes.
- *
- * Mapping rules:
- * - shuffler.io / shuffle.security -> https://uk.shuffle.security (default cloud backend)
- * - <subdomain>.shuffler.io -> https://<subdomain>.shuffle.security (e.g. ca, us, eu, au, uk, frankfurt)
- * - <subdomain>.shuffle.security -> preserved as https://<subdomain>.shuffle.security
- * - Self-hosted / on-prem / dev URLs -> preserved as-is
- */
 declare const mapCloudRegionUrl: (url?: string | null) => string;
 /** Check if running on a known Shuffle Cloud domain */
 declare const isCloudDomain: () => boolean;
@@ -2097,6 +2139,7 @@ declare const DATASTORE_CATEGORIES: {
     readonly INFRASTRUCTURE: "shuffle-security_infrastructure";
     readonly USERS: "shuffle-security_users";
     readonly REPORTS: "shuffle-security_reports";
+    readonly DASHBOARDS: "shuffle-security_dashboards";
     readonly LEGACY_ALERTS: "shuffle-security_alerts";
     readonly LEGACY_CASES: "shuffle-security_cases";
 };
@@ -2375,7 +2418,8 @@ declare function openSupportEscalation(context: SupportEscalationContext): void;
 type ShuffleTheme = 'light' | 'dark' | 'system';
 type WithTheme<P> = P & {
     theme?: ShuffleTheme;
-    colorMode?: ShuffleMcpColorMode;
+    colorMode?: ShuffleMcpColorMode; /** Backend base URL. On *.shuffler.io hosts it always wins; on Shuffle Cloud elsewhere only self-hosted URLs are honored. */
+    globalUrl?: string;
 };
 
 declare const AiAgentPromptsEditor: React.ComponentType<WithTheme<P>>;
@@ -2413,4 +2457,4 @@ declare const AgentsView: React.ComponentType<WithTheme<P>>;
 declare const AgentRunDiagnosisBanner: React.ComponentType<WithTheme<P>>;
 declare const LocalLLMConfig: React.ComponentType<WithTheme<P>>;
 
-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, 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, type AppDetailDrawerRenderProps, AppDetailProvider, type AppLookupResult, 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, type ShuffleMCPProps, ShuffleMarkdown, type ShuffleMcpColorMode, ShuffleMcpThemeProvider, ShufflePipelinesBanner, type ShuffleTheme, type ShuffleTokenStyle, SingulActionsPreview, type SupportEscalationContext, THREAT_INTEL_PATTERNS, type ToolDrawerRenderProps, TryMcpSection, type TryMcpSectionProps, UsageBar, type UsageBarProps, type UseAgentPromptPrefixOptions, VERIFIED_BUILTIN_APPS, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, VideoEmbed, applyRegionFromPayload, buildSupportEscalationUrl, clearPageContextChoice, copyToClipboard, darkTokenStyle, AgentsView as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, ensureShuffleMcpStyles, extractActionAppNames, extractValidatedIngestionApps, extractWorkflowActionAppNames, extractWorkflowAppNames, fallbackCopyText as fallbackCopyToClipboard, fetchApps, fetchAppsViaApiConfig, fetchConnectedTools, filterItemsByCategory, findForwardTicketsWorkflow, findIngestTicketsWorkflow, getActivePageEntityName, getAgentContextRules, getApiUrl, getAuthHeader, getCachedConnectedTools, getDatastoreByCategory, getDatastoreItem, getDatastoreItemPublic, getDatastorePageSize, getFailureInfo, getHostBaseUrl, getIngestionCategory, getPageContextChoice, hasOutputWarning, installClipboardPolyfill, installCryptoRandomUuidPolyfill, installFetchBreaker, invalidateAppsCache, invalidateResolvedApps, isAgentRoute, isCloud, isCloudDomain, isEmailApp, isIngestionApp, isOnprem, isShuffleCloudDomain, isShuffleSecurityBackend, isThreatIntelApp, isVulnScannerApp, isWorkflowScheduleStopped, lightTokenStyle, mapCloudRegionUrl, matchRoutePattern, mergeConnectedTools, normalizeAppName, openSupportEscalation, parseRunResult, refreshAllIntegrationStatus, registerAgentContextRule, registerProtectedOrigin, resetRegionUrl, resolveAgentContext, resolveApp, resolveApps, resolveConnectedTools, resolveContactUserInfo, resolveVideoUrl, safeRandomUUID, scheduleAgentRun, searchAgentActivity, seedResolvedApp, setCachedConnectedTools, setDatastoreItem, setDatastoreItems, setHostBaseUrl, setPageContextChoice, setRegionUrl, setRuntimeOrgId, setToastImpl, shuffleFetch, toast, useAgentPromptPrefix, useAppAuth, useAppAuthFlow, useAppDetail, useAppDetailOptional, useAppLookup, useContextAwareAgent, useSyncHostBaseUrl, uuid };
+export { AGENT_DRAWER_CLOSE_EVENT, AGENT_DRAWER_OPEN_EVENT, AGENT_DRAWER_STATE_EVENT, AGENT_FOCUS_NODE_EVENT, AGENT_OPEN_EXECUTION_EVENT, AGENT_PRESETS, AGENT_PROMPT_PREFIX_CATEGORY, AGENT_WORKFLOW_CHANGED_EVENT, API_CONFIG, ASK_AI_PANEL_WIDTH_STORAGE_KEY, AgentActivityList, type AgentActivityListProps, type AgentActivityParams, type AgentActivityResponse, type AgentContextApp, type AgentContextRule, type AgentDecision, AgentExecutionDrawer, type AgentExecutionDrawerProps, type AgentFocusNodeDetail, AgentIcon, type AgentLocalModel, type AgentOpenExecutionDetail, 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, type AgentUIView, type AgentWorkflowChangedDetail, 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, type AppDetailDrawerRenderProps, AppDetailProvider, type AppLookupResult, 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, type ShuffleMCPProps, ShuffleMarkdown, type ShuffleMcpColorMode, ShuffleMcpThemeProvider, ShufflePipelinesBanner, type ShuffleTheme, type ShuffleTokenStyle, SingulActionsPreview, type SupportEscalationContext, THREAT_INTEL_PATTERNS, type ToolDrawerRenderProps, TryMcpSection, type TryMcpSectionProps, UsageBar, type UsageBarProps, type UseAgentPromptPrefixOptions, VERIFIED_BUILTIN_APPS, VULN_SCANNER_PATTERNS, type ValidatedIngestionApp, VideoEmbed, applyRegionFromPayload, buildSupportEscalationUrl, clearPageContextChoice, copyToClipboard, darkTokenStyle, AgentsView as default, deleteDatastoreItem, deleteDatastoreItems, diagnoseOutputWarning, ensureShuffleMcpStyles, extractActionAppNames, extractValidatedIngestionApps, extractWorkflowActionAppNames, extractWorkflowAppNames, fallbackCopyText as fallbackCopyToClipboard, fetchApps, fetchAppsViaApiConfig, fetchConnectedTools, filterItemsByCategory, findForwardTicketsWorkflow, findIngestTicketsWorkflow, getActivePageEntityName, getAgentContextRules, getApiUrl, getAuthHeader, getCachedConnectedTools, getDatastoreByCategory, getDatastoreItem, getDatastoreItemPublic, getDatastorePageSize, getFailureInfo, getHostBaseUrl, getIngestionCategory, getPageContextChoice, hasOutputWarning, installClipboardPolyfill, installCryptoRandomUuidPolyfill, installFetchBreaker, invalidateAppsCache, invalidateResolvedApps, isAgentRoute, isCloud, isCloudDomain, isEmailApp, isIngestionApp, isOnprem, isShuffleCloudDomain, isShuffleSecurityBackend, isThreatIntelApp, isVulnScannerApp, isWorkflowScheduleStopped, lightTokenStyle, mapCloudRegionUrl, matchRoutePattern, mergeConnectedTools, normalizeAppName, openSupportEscalation, parseRunResult, refreshAllIntegrationStatus, registerAgentContextRule, registerProtectedOrigin, resetRegionUrl, resolveAgentContext, resolveApp, resolveApps, resolveConnectedTools, resolveContactUserInfo, resolveVideoUrl, safeRandomUUID, scheduleAgentRun, searchAgentActivity, seedResolvedApp, setCachedConnectedTools, setDatastoreItem, setDatastoreItems, setHostBaseUrl, setPageContextChoice, setRegionUrl, setRuntimeOrgId, setToastImpl, shuffleFetch, toast, useAgentPromptPrefix, useAppAuth, useAppAuthFlow, useAppDetail, useAppDetailOptional, useAppLookup, useContextAwareAgent, useSyncHostBaseUrl, uuid };