@shuffleio/shuffle-mcps 0.0.5 → 0.0.6

package/dist/index.d.cts

@@ -196,6 +196,9 @@ interface AppDetailDrawerProps {
     onClose: () => void;
     /** App name to load */
     appName: string | null;
+    /** Pre-resolved Algolia objectID — bypasses Algolia lookup when provided (e.g. when the
+     *  caller already had the hit, like AppSearchDrawer / "Add Ingestion Source"). */
+    appId?: string | null;
     /** Anchor side */
     anchor?: 'left' | 'right';
     /** Width in px */
@@ -214,7 +217,7 @@ interface AppDetailDrawerProps {
      *  an `Org-Id` header is injected into the Singul curl preview. */
     activeOrgId?: string | null;
 }
-declare function AppDetailDrawer({ open, onClose, appName, anchor, width, onRefresh, onAddToCanvas, isAuthenticated, activeOrgId, }: AppDetailDrawerProps): react_jsx_runtime.JSX.Element;
+declare function AppDetailDrawer({ open, onClose, appName, appId, anchor, width, onRefresh, onAddToCanvas, isAuthenticated, activeOrgId, }: AppDetailDrawerProps): react_jsx_runtime.JSX.Element;
 
 /**
  * AppSearchDrawer — Reusable drawer for searching apps.
@@ -362,6 +365,115 @@ declare const SingulActionsPreview: ({ appName, categories, activeOrgId, }: {
     activeOrgId?: string | null;
 }) => react_jsx_runtime.JSX.Element;
 
+/**
+ * AgentUI — Standalone "start + debug agents" surface.
+ *
+ * TypeScript port and modernization of the legacy Shuffle Core
+ * `AgentUI.jsx`. One component, two modes:
+ *
+ *  1. **Starter** — large hero prompt ("What do you want to do?")
+ *     with attached MCP/app chips. Submits to `/api/v1/agent`.
+ *  2. **Debugger** — compact header + decision timeline driven by
+ *     `/api/v1/streams/results`, with question/continuation forms
+ *     and per-decision raw-JSON inspection.
+ *
+ * Mode switches automatically when an execution is started or when
+ * `?execution_id=...&authorization=...` is present in the URL.
+ *
+ * Self-contained: uses {@link AppSearchDrawer} for app picking,
+ * {@link runAgent} for the JSON-RPC call, and the library's
+ * {@link toast} facade for notifications.
+ */
+
+interface AgentUIApp {
+    /** App slug, e.g. "http", "shuffle_tools", "gmail". */
+    name: string;
+    /** Algolia objectID / Shuffle app id (preferred). */
+    id?: string;
+    /** Optional preview icon URL. */
+    icon?: string;
+}
+interface AgentUIProps {
+    /** Controlled list of apps. When provided, overrides defaultApps and disables auto-load. */
+    apps?: AgentUIApp[];
+    /** Initial chip set under the prompt. Used only when `apps` is not provided. */
+    defaultApps?: AgentUIApp[];
+    /**
+     * When true (default) and neither `apps` nor `defaultApps` is provided, fetch the
+     * caller's authenticated apps via `/api/v1/apps/authentication` (requires an API
+     * token to be set on `API_CONFIG`).
+     */
+    autoLoadApps?: boolean;
+    /** Hero title above the prompt. */
+    title?: string;
+    /** Optional subtitle/description shown under the title. */
+    subtitle?: React$1.ReactNode;
+    /** Placeholder shown in the empty prompt. */
+    placeholder?: string;
+    /** Pre-fill the prompt with this text. */
+    defaultInput?: string;
+    /** Submit immediately on mount when `defaultInput` is provided. */
+    autoSubmit?: boolean;
+    /** Hide the centered hero icon (compact mode). */
+    hideHeroIcon?: boolean;
+    /** Replace the default AgentIcon with a custom node (e.g. brand logo). */
+    heroIcon?: React$1.ReactNode;
+    /** Pixel size of the hero icon container. Default 84. */
+    heroIconSize?: number;
+    /** Maximum width of the centered card. */
+    maxWidth?: number;
+    /** Compact mode: hides the hero icon, shrinks padding. */
+    compact?: boolean;
+    /** Hide the "Select Apps / MCPs" chip row entirely. */
+    hideAppPicker?: boolean;
+    /** Hide the paperclip image-attachment button. */
+    hideAttach?: boolean;
+    /** Label on the "Select Apps / MCPs" chip. */
+    appPickerLabel?: string;
+    /** Title on the AppSearchDrawer. */
+    appPickerTitle?: string;
+    /** Subtitle on the AppSearchDrawer. */
+    appPickerSubtitle?: string;
+    /** Tooltip on the submit button. Default: "⌘+Enter to send". */
+    submitTooltip?: string;
+    /** Custom icon for the submit button. */
+    submitIcon?: React$1.ReactNode;
+    /** Placeholder for the post-finish continuation field. */
+    continuationPlaceholder?: string;
+    /** Read `?execution_id` & `?authorization` from window URL on mount. */
+    readUrlParams?: boolean;
+    /**
+     * Optional explicit execution to attach to on mount. Overrides URL params
+     * and skips the starter — useful when embedding to monitor a known run.
+     */
+    executionId?: string;
+    /** Authorization token paired with `executionId`. */
+    authorization?: string;
+    /** Called whenever a run finishes (success or failure). */
+    onRun?: (info: {
+        input: string;
+        success: boolean;
+        executionId?: string;
+        error?: string;
+    }) => void;
+    /**
+     * Optional Shuffle API key. When provided, all `/api/v1/*` calls made by
+     * this component (agent run, polling, app autoload, icon fallback) use it
+     * via `Authorization: Bearer <apiKey>`. When omitted, falls back to the
+     * shared `API_CONFIG` (browser session / `localStorage.shuffle_api_key`).
+     */
+    apiKey?: string;
+    /**
+     * Optional Shuffle backend base URL (e.g. `https://shuffler.io`). When
+     * omitted, falls back to the shared `API_CONFIG.baseUrl`. Useful when
+     * embedding `AgentUI` inside another app that targets a different region.
+     */
+    apiBaseUrl?: string;
+    /** Optional Shuffle Org ID — sent as the `Org-Id` header on every call. */
+    orgId?: string;
+}
+declare const AgentUI: React$1.FC<AgentUIProps>;
+
 /**
  * useAppLookup — Resolve an app's display name, image, categories,
  * canonical Algolia objectID and matching auth entries from just
@@ -484,16 +596,29 @@ declare const getApiUrl: (endpoint: string) => string;
 declare const getAuthHeader: (overrideOrgId?: string | null) => Record<string, string>;
 
 /**
- * Tiny toast facade — library version. The host app can replace this by
- * setting a custom impl via setToastImpl(). Falls back to console.warn.
+ * Tiny toast facade — library version. Mirrors the sonner-style surface
+ * (`toast(...)`, `toast.success`, `toast.error`, `toast.info`, `toast.warning`)
+ * plus the legacy `{ title, description, variant }` shape used elsewhere in
+ * the host app. The host app can replace the impl via `setToastImpl()`.
  */
-type ToastArg = {
+type Variant = 'default' | 'destructive' | 'success' | 'error' | 'info' | 'warning';
+type ToastArg = string | {
     title?: string;
     description?: string;
-    variant?: 'default' | 'destructive';
+    variant?: Variant;
+};
+type ToastOptions = {
+    description?: string;
+    [key: string]: unknown;
+};
+type ToastImpl = (arg: ToastArg, opts?: ToastOptions) => void;
+declare function setToastImpl(fn: ToastImpl): void;
+type ToastApi = ((arg: ToastArg, opts?: ToastOptions) => void) & {
+    success: (msg: string, opts?: ToastOptions) => void;
+    error: (msg: string, opts?: ToastOptions) => void;
+    info: (msg: string, opts?: ToastOptions) => void;
+    warning: (msg: string, opts?: ToastOptions) => void;
 };
-type ToastFn = (arg: ToastArg) => void;
-declare function setToastImpl(fn: ToastFn): void;
-declare const toast: ToastFn;
+declare const toast: ToastApi;
 
-export { API_CONFIG, type AlgoliaSearchApp, AppAuthSection, type AppAuthSectionProps, type AppAuthentication, AppDetailDrawer, AppDetailProvider, type AppLookupResult, AppSearchDrawer, type AppSelectedEvent, AppTitleHeader, type AppTitleHeaderProps, type CustomStyles, IntegrationStatus, ShuffleMCP, type ShuffleMCPHandle, type ShuffleMCPProps, ShufflePipelinesBanner, SingulActionsPreview, TryMcpSection, type TryMcpSectionProps, ShuffleMCP as default, getApiUrl, getAuthHeader, refreshAllIntegrationStatus, setToastImpl, toast, useAppAuth, useAppDetail, useAppLookup };
+export { API_CONFIG, AgentUI, type AgentUIApp, type AgentUIProps, type AlgoliaSearchApp, AppAuthSection, type AppAuthSectionProps, type AppAuthentication, AppDetailDrawer, AppDetailProvider, type AppLookupResult, AppSearchDrawer, type AppSelectedEvent, AppTitleHeader, type AppTitleHeaderProps, type CustomStyles, IntegrationStatus, ShuffleMCP, type ShuffleMCPHandle, type ShuffleMCPProps, ShufflePipelinesBanner, SingulActionsPreview, TryMcpSection, type TryMcpSectionProps, ShuffleMCP as default, getApiUrl, getAuthHeader, refreshAllIntegrationStatus, setToastImpl, toast, useAppAuth, useAppDetail, useAppLookup };

package/dist/index.d.ts

@@ -196,6 +196,9 @@ interface AppDetailDrawerProps {
     onClose: () => void;
     /** App name to load */
     appName: string | null;
+    /** Pre-resolved Algolia objectID — bypasses Algolia lookup when provided (e.g. when the
+     *  caller already had the hit, like AppSearchDrawer / "Add Ingestion Source"). */
+    appId?: string | null;
     /** Anchor side */
     anchor?: 'left' | 'right';
     /** Width in px */
@@ -214,7 +217,7 @@ interface AppDetailDrawerProps {
      *  an `Org-Id` header is injected into the Singul curl preview. */
     activeOrgId?: string | null;
 }
-declare function AppDetailDrawer({ open, onClose, appName, anchor, width, onRefresh, onAddToCanvas, isAuthenticated, activeOrgId, }: AppDetailDrawerProps): react_jsx_runtime.JSX.Element;
+declare function AppDetailDrawer({ open, onClose, appName, appId, anchor, width, onRefresh, onAddToCanvas, isAuthenticated, activeOrgId, }: AppDetailDrawerProps): react_jsx_runtime.JSX.Element;
 
 /**
  * AppSearchDrawer — Reusable drawer for searching apps.
@@ -362,6 +365,115 @@ declare const SingulActionsPreview: ({ appName, categories, activeOrgId, }: {
     activeOrgId?: string | null;
 }) => react_jsx_runtime.JSX.Element;
 
+/**
+ * AgentUI — Standalone "start + debug agents" surface.
+ *
+ * TypeScript port and modernization of the legacy Shuffle Core
+ * `AgentUI.jsx`. One component, two modes:
+ *
+ *  1. **Starter** — large hero prompt ("What do you want to do?")
+ *     with attached MCP/app chips. Submits to `/api/v1/agent`.
+ *  2. **Debugger** — compact header + decision timeline driven by
+ *     `/api/v1/streams/results`, with question/continuation forms
+ *     and per-decision raw-JSON inspection.
+ *
+ * Mode switches automatically when an execution is started or when
+ * `?execution_id=...&authorization=...` is present in the URL.
+ *
+ * Self-contained: uses {@link AppSearchDrawer} for app picking,
+ * {@link runAgent} for the JSON-RPC call, and the library's
+ * {@link toast} facade for notifications.
+ */
+
+interface AgentUIApp {
+    /** App slug, e.g. "http", "shuffle_tools", "gmail". */
+    name: string;
+    /** Algolia objectID / Shuffle app id (preferred). */
+    id?: string;
+    /** Optional preview icon URL. */
+    icon?: string;
+}
+interface AgentUIProps {
+    /** Controlled list of apps. When provided, overrides defaultApps and disables auto-load. */
+    apps?: AgentUIApp[];
+    /** Initial chip set under the prompt. Used only when `apps` is not provided. */
+    defaultApps?: AgentUIApp[];
+    /**
+     * When true (default) and neither `apps` nor `defaultApps` is provided, fetch the
+     * caller's authenticated apps via `/api/v1/apps/authentication` (requires an API
+     * token to be set on `API_CONFIG`).
+     */
+    autoLoadApps?: boolean;
+    /** Hero title above the prompt. */
+    title?: string;
+    /** Optional subtitle/description shown under the title. */
+    subtitle?: React$1.ReactNode;
+    /** Placeholder shown in the empty prompt. */
+    placeholder?: string;
+    /** Pre-fill the prompt with this text. */
+    defaultInput?: string;
+    /** Submit immediately on mount when `defaultInput` is provided. */
+    autoSubmit?: boolean;
+    /** Hide the centered hero icon (compact mode). */
+    hideHeroIcon?: boolean;
+    /** Replace the default AgentIcon with a custom node (e.g. brand logo). */
+    heroIcon?: React$1.ReactNode;
+    /** Pixel size of the hero icon container. Default 84. */
+    heroIconSize?: number;
+    /** Maximum width of the centered card. */
+    maxWidth?: number;
+    /** Compact mode: hides the hero icon, shrinks padding. */
+    compact?: boolean;
+    /** Hide the "Select Apps / MCPs" chip row entirely. */
+    hideAppPicker?: boolean;
+    /** Hide the paperclip image-attachment button. */
+    hideAttach?: boolean;
+    /** Label on the "Select Apps / MCPs" chip. */
+    appPickerLabel?: string;
+    /** Title on the AppSearchDrawer. */
+    appPickerTitle?: string;
+    /** Subtitle on the AppSearchDrawer. */
+    appPickerSubtitle?: string;
+    /** Tooltip on the submit button. Default: "⌘+Enter to send". */
+    submitTooltip?: string;
+    /** Custom icon for the submit button. */
+    submitIcon?: React$1.ReactNode;
+    /** Placeholder for the post-finish continuation field. */
+    continuationPlaceholder?: string;
+    /** Read `?execution_id` & `?authorization` from window URL on mount. */
+    readUrlParams?: boolean;
+    /**
+     * Optional explicit execution to attach to on mount. Overrides URL params
+     * and skips the starter — useful when embedding to monitor a known run.
+     */
+    executionId?: string;
+    /** Authorization token paired with `executionId`. */
+    authorization?: string;
+    /** Called whenever a run finishes (success or failure). */
+    onRun?: (info: {
+        input: string;
+        success: boolean;
+        executionId?: string;
+        error?: string;
+    }) => void;
+    /**
+     * Optional Shuffle API key. When provided, all `/api/v1/*` calls made by
+     * this component (agent run, polling, app autoload, icon fallback) use it
+     * via `Authorization: Bearer <apiKey>`. When omitted, falls back to the
+     * shared `API_CONFIG` (browser session / `localStorage.shuffle_api_key`).
+     */
+    apiKey?: string;
+    /**
+     * Optional Shuffle backend base URL (e.g. `https://shuffler.io`). When
+     * omitted, falls back to the shared `API_CONFIG.baseUrl`. Useful when
+     * embedding `AgentUI` inside another app that targets a different region.
+     */
+    apiBaseUrl?: string;
+    /** Optional Shuffle Org ID — sent as the `Org-Id` header on every call. */
+    orgId?: string;
+}
+declare const AgentUI: React$1.FC<AgentUIProps>;
+
 /**
  * useAppLookup — Resolve an app's display name, image, categories,
  * canonical Algolia objectID and matching auth entries from just
@@ -484,16 +596,29 @@ declare const getApiUrl: (endpoint: string) => string;
 declare const getAuthHeader: (overrideOrgId?: string | null) => Record<string, string>;
 
 /**
- * Tiny toast facade — library version. The host app can replace this by
- * setting a custom impl via setToastImpl(). Falls back to console.warn.
+ * Tiny toast facade — library version. Mirrors the sonner-style surface
+ * (`toast(...)`, `toast.success`, `toast.error`, `toast.info`, `toast.warning`)
+ * plus the legacy `{ title, description, variant }` shape used elsewhere in
+ * the host app. The host app can replace the impl via `setToastImpl()`.
  */
-type ToastArg = {
+type Variant = 'default' | 'destructive' | 'success' | 'error' | 'info' | 'warning';
+type ToastArg = string | {
     title?: string;
     description?: string;
-    variant?: 'default' | 'destructive';
+    variant?: Variant;
+};
+type ToastOptions = {
+    description?: string;
+    [key: string]: unknown;
+};
+type ToastImpl = (arg: ToastArg, opts?: ToastOptions) => void;
+declare function setToastImpl(fn: ToastImpl): void;
+type ToastApi = ((arg: ToastArg, opts?: ToastOptions) => void) & {
+    success: (msg: string, opts?: ToastOptions) => void;
+    error: (msg: string, opts?: ToastOptions) => void;
+    info: (msg: string, opts?: ToastOptions) => void;
+    warning: (msg: string, opts?: ToastOptions) => void;
 };
-type ToastFn = (arg: ToastArg) => void;
-declare function setToastImpl(fn: ToastFn): void;
-declare const toast: ToastFn;
+declare const toast: ToastApi;
 
-export { API_CONFIG, type AlgoliaSearchApp, AppAuthSection, type AppAuthSectionProps, type AppAuthentication, AppDetailDrawer, AppDetailProvider, type AppLookupResult, AppSearchDrawer, type AppSelectedEvent, AppTitleHeader, type AppTitleHeaderProps, type CustomStyles, IntegrationStatus, ShuffleMCP, type ShuffleMCPHandle, type ShuffleMCPProps, ShufflePipelinesBanner, SingulActionsPreview, TryMcpSection, type TryMcpSectionProps, ShuffleMCP as default, getApiUrl, getAuthHeader, refreshAllIntegrationStatus, setToastImpl, toast, useAppAuth, useAppDetail, useAppLookup };
+export { API_CONFIG, AgentUI, type AgentUIApp, type AgentUIProps, type AlgoliaSearchApp, AppAuthSection, type AppAuthSectionProps, type AppAuthentication, AppDetailDrawer, AppDetailProvider, type AppLookupResult, AppSearchDrawer, type AppSelectedEvent, AppTitleHeader, type AppTitleHeaderProps, type CustomStyles, IntegrationStatus, ShuffleMCP, type ShuffleMCPHandle, type ShuffleMCPProps, ShufflePipelinesBanner, SingulActionsPreview, TryMcpSection, type TryMcpSectionProps, ShuffleMCP as default, getApiUrl, getAuthHeader, refreshAllIntegrationStatus, setToastImpl, toast, useAppAuth, useAppDetail, useAppLookup };