@seed-ship/mcp-ui-solid 6.6.0 → 6.7.0

package/dist/context/MCPActionContext.cjs

@@ -12,7 +12,10 @@ const defaultExecutor = async (request) => {
           toolName: request.toolName,
           params: request.params || {},
           spaceIds: request.spaceIds,
-          macroId: request.macroId
+          macroId: request.macroId,
+          // v6.6.1 — action kind so a window-level listener can route a
+          // `submit` (POST to params.submit_url) vs a tool call.
+          action: request.action ?? "tool-call"
         },
         bubbles: true
       });

package/dist/context/MCPActionContext.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"MCPActionContext.cjs","sources":["../../src/context/MCPActionContext.tsx"],"sourcesContent":["/**\n * MCPActionContext - Context provider for MCP action execution\n * Phase 5.0: Quick Wins - Replaces CustomEvent with typed context for Mastra integration\n */\n\nimport { createContext, createSignal, useContext, ParentComponent, Accessor } from 'solid-js'\n\n/**\n * Action request payload\n */\nexport interface ActionRequest {\n  /**\n   * MCP tool name to execute\n   */\n  toolName: string\n\n  /**\n   * Tool parameters\n   */\n  params?: Record<string, any>\n\n  /**\n   * Optional space IDs for multi-space context\n   */\n  spaceIds?: string[]\n\n  /**\n   * Optional macro ID for template execution\n   */\n  macroId?: string\n}\n\n/**\n * Action result from execution\n */\nexport interface ActionResult {\n  /**\n   * Whether the action was successful\n   */\n  success: boolean\n\n  /**\n   * Result data (if successful)\n   */\n  data?: any\n\n  /**\n   * Error message (if failed)\n   */\n  error?: string\n\n  /**\n   * Execution timestamp\n   */\n  timestamp: string\n\n  /**\n   * Tool that was executed\n   */\n  toolName: string\n}\n\n/**\n * Context value interface\n */\nexport interface MCPActionContextValue {\n  /**\n   * Execute an MCP action\n   */\n  executeAction: (request: ActionRequest) => Promise<ActionResult>\n\n  /**\n   * Currently available tools (from MCP server)\n   */\n  availableTools: Accessor<string[]>\n\n  /**\n   * Space IDs in current context\n   */\n  spaceIds: Accessor<string[]>\n\n  /**\n   * Current macro ID (if executing within a template)\n   */\n  macroId: Accessor<string | undefined>\n\n  /**\n   * Whether an action is currently executing\n   */\n  isExecuting: Accessor<boolean>\n\n  /**\n   * Last action result\n   */\n  lastResult: Accessor<ActionResult | undefined>\n}\n\n/**\n * Props for MCPActionProvider\n */\nexport interface MCPActionProviderProps {\n  /**\n   * Space IDs for multi-space queries\n   */\n  spaceIds?: string[]\n\n  /**\n   * Macro ID when executing within a template\n   */\n  macroId?: string\n\n  /**\n   * Available MCP tools\n   */\n  availableTools?: string[]\n\n  /**\n   * Callback for action execution (for audit logging)\n   */\n  onAction?: (request: ActionRequest, result: ActionResult) => void\n\n  /**\n   * Callback for webhook events (n8n, Zapier integration)\n   */\n  onWebhook?: (event: { type: string; payload: any }) => void\n\n  /**\n   * Custom action executor (override default)\n   */\n  executor?: (request: ActionRequest) => Promise<ActionResult>\n}\n\n// Create the context with undefined default\nconst MCPActionContext = createContext<MCPActionContextValue>()\n\n/**\n * Default action executor using CustomEvent fallback\n * This maintains backward compatibility while allowing Context-based usage\n */\nconst defaultExecutor = async (request: ActionRequest): Promise<ActionResult> => {\n  return new Promise((resolve) => {\n    const timestamp = new Date().toISOString()\n\n    // Dispatch CustomEvent for backward compatibility with existing listeners\n    if (typeof window !== 'undefined') {\n      const event = new CustomEvent('mcp-action', {\n        detail: {\n          toolName: request.toolName,\n          params: request.params || {},\n          spaceIds: request.spaceIds,\n          macroId: request.macroId,\n        },\n        bubbles: true,\n      })\n\n      // Listen for response event\n      const responseHandler = (e: Event) => {\n        const customEvent = e as CustomEvent\n        window.removeEventListener('mcp-action-response', responseHandler)\n        resolve({\n          success: customEvent.detail?.success ?? true,\n          data: customEvent.detail?.data,\n          error: customEvent.detail?.error,\n          timestamp,\n          toolName: request.toolName,\n        })\n      }\n\n      window.addEventListener('mcp-action-response', responseHandler)\n      window.dispatchEvent(event)\n\n      // Timeout fallback - resolve as success if no response in 100ms\n      // (indicates no listener, action was dispatched)\n      setTimeout(() => {\n        window.removeEventListener('mcp-action-response', responseHandler)\n        resolve({\n          success: true,\n          data: { dispatched: true },\n          timestamp,\n          toolName: request.toolName,\n        })\n      }, 100)\n    } else {\n      // Server-side: return immediately\n      resolve({\n        success: false,\n        error: 'Actions not available server-side',\n        timestamp,\n        toolName: request.toolName,\n      })\n    }\n  })\n}\n\n/**\n * MCPActionProvider - Provides action execution context to child components\n *\n * @example\n * ```tsx\n * <MCPActionProvider\n *   spaceIds={['space-123']}\n *   macroId=\"sales_overview\"\n *   onAction={(req, res) => audit(req, res)}\n * >\n *   <UIResourceRenderer layout={layout} />\n * </MCPActionProvider>\n * ```\n */\nexport const MCPActionProvider: ParentComponent<MCPActionProviderProps> = (props) => {\n  const [isExecuting, setIsExecuting] = createSignal(false)\n  const [lastResult, setLastResult] = createSignal<ActionResult>()\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const [spaceIds, _setSpaceIds] = createSignal<string[]>(props.spaceIds || [])\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const [macroId, _setMacroId] = createSignal<string | undefined>(props.macroId)\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const [availableTools, _setAvailableTools] = createSignal<string[]>(props.availableTools || [])\n\n  // Update signals when props change\n  // Note: This is a simple approach; for more complex scenarios, consider createEffect\n\n  const executeAction = async (request: ActionRequest): Promise<ActionResult> => {\n    setIsExecuting(true)\n\n    try {\n      // Enrich request with context\n      const enrichedRequest: ActionRequest = {\n        ...request,\n        spaceIds: request.spaceIds || spaceIds(),\n        macroId: request.macroId || macroId(),\n      }\n\n      // Execute using custom executor or default\n      const executor = props.executor || defaultExecutor\n      const result = await executor(enrichedRequest)\n\n      setLastResult(result)\n\n      // Call audit callback if provided\n      props.onAction?.(enrichedRequest, result)\n\n      // Trigger webhook if provided and action was successful\n      if (result.success && props.onWebhook) {\n        props.onWebhook({\n          type: 'action-completed',\n          payload: {\n            request: enrichedRequest,\n            result,\n          },\n        })\n      }\n\n      return result\n    } catch (error) {\n      const errorResult: ActionResult = {\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error',\n        timestamp: new Date().toISOString(),\n        toolName: request.toolName,\n      }\n\n      setLastResult(errorResult)\n      props.onAction?.(request, errorResult)\n\n      return errorResult\n    } finally {\n      setIsExecuting(false)\n    }\n  }\n\n  const contextValue: MCPActionContextValue = {\n    executeAction,\n    availableTools,\n    spaceIds,\n    macroId,\n    isExecuting,\n    lastResult,\n  }\n\n  return (\n    <MCPActionContext.Provider value={contextValue}>\n      {props.children}\n    </MCPActionContext.Provider>\n  )\n}\n\n/**\n * Hook to access MCP action context\n * Throws if used outside of MCPActionProvider\n *\n * @example\n * ```tsx\n * const { executeAction, isExecuting } = useMCPAction()\n *\n * const handleClick = async () => {\n *   const result = await executeAction({\n *     toolName: 'search.hub',\n *     params: { query: 'revenue Q4' },\n *   })\n * }\n * ```\n */\nexport function useMCPAction(): MCPActionContextValue {\n  const context = useContext(MCPActionContext)\n  if (!context) {\n    throw new Error('useMCPAction must be used within an MCPActionProvider')\n  }\n  return context\n}\n\n/**\n * Hook to access MCP action context with fallback for components\n * outside of provider (uses CustomEvent fallback)\n *\n * @example\n * ```tsx\n * const { executeAction, isExecuting } = useMCPActionSafe()\n * // Works even without MCPActionProvider\n * ```\n */\nexport function useMCPActionSafe(): MCPActionContextValue {\n  const context = useContext(MCPActionContext)\n\n  if (context) {\n    return context\n  }\n\n  // Fallback implementation for components outside provider\n  const [isExecuting, setIsExecuting] = createSignal(false)\n  const [lastResult, setLastResult] = createSignal<ActionResult>()\n\n  const executeAction = async (request: ActionRequest): Promise<ActionResult> => {\n    setIsExecuting(true)\n    try {\n      const result = await defaultExecutor(request)\n      setLastResult(result)\n      return result\n    } finally {\n      setIsExecuting(false)\n    }\n  }\n\n  return {\n    executeAction,\n    availableTools: () => [],\n    spaceIds: () => [],\n    macroId: () => undefined,\n    isExecuting,\n    lastResult,\n  }\n}\n\nexport { MCPActionContext }\n"],"names":["MCPActionContext","createContext","defaultExecutor","request","Promise","resolve","timestamp","Date","toISOString","window","event","CustomEvent","detail","toolName","params","spaceIds","macroId","bubbles","responseHandler","e","customEvent","removeEventListener","success","data","error","addEventListener","dispatchEvent","setTimeout","dispatched","MCPActionProvider","props","isExecuting","setIsExecuting","createSignal","lastResult","setLastResult","_setSpaceIds","_setMacroId","availableTools","_setAvailableTools","executeAction","enrichedRequest","executor","result","onAction","onWebhook","type","payload","errorResult","Error","message","contextValue","_$createComponent","Provider","value","children","useMCPAction","context","useContext","useMCPActionSafe","undefined"],"mappings":"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"}
+{"version":3,"file":"MCPActionContext.cjs","sources":["../../src/context/MCPActionContext.tsx"],"sourcesContent":["/**\n * MCPActionContext - Context provider for MCP action execution\n * Phase 5.0: Quick Wins - Replaces CustomEvent with typed context for Mastra integration\n */\n\nimport { createContext, createSignal, useContext, ParentComponent, Accessor } from 'solid-js'\n\n/**\n * Action request payload\n */\nexport interface ActionRequest {\n  /**\n   * MCP tool name to execute. For a `submit` action with no associated\n   * tool, renderers pass the sentinel `'submit'` — branch on `action`,\n   * not on `toolName`, to tell a submit apart from a tool call.\n   */\n  toolName: string\n\n  /**\n   * Tool parameters\n   */\n  params?: Record<string, any>\n\n  /**\n   * Optional space IDs for multi-space context\n   */\n  spaceIds?: string[]\n\n  /**\n   * Optional macro ID for template execution\n   */\n  macroId?: string\n\n  /**\n   * Action kind (v6.6.1). Lets a host `executor` tell a tool call apart\n   * from a form-style `submit`. Absent ⇒ treat as `'tool-call'` (backward\n   * compatible — every pre-v6.6.1 request omits it).\n   *\n   * A `submit` action carries its payload in `params` (e.g. `submit_url`,\n   * `connector_id`, `feedback_value`) and **must NOT** be executed as a\n   * tool call — the host routes it (e.g. POST to `params.submit_url`).\n   */\n  action?: 'tool-call' | 'submit' | 'link'\n}\n\n/**\n * Action result from execution\n */\nexport interface ActionResult {\n  /**\n   * Whether the action was successful\n   */\n  success: boolean\n\n  /**\n   * Result data (if successful)\n   */\n  data?: any\n\n  /**\n   * Error message (if failed)\n   */\n  error?: string\n\n  /**\n   * Execution timestamp\n   */\n  timestamp: string\n\n  /**\n   * Tool that was executed\n   */\n  toolName: string\n}\n\n/**\n * Context value interface\n */\nexport interface MCPActionContextValue {\n  /**\n   * Execute an MCP action\n   */\n  executeAction: (request: ActionRequest) => Promise<ActionResult>\n\n  /**\n   * Currently available tools (from MCP server)\n   */\n  availableTools: Accessor<string[]>\n\n  /**\n   * Space IDs in current context\n   */\n  spaceIds: Accessor<string[]>\n\n  /**\n   * Current macro ID (if executing within a template)\n   */\n  macroId: Accessor<string | undefined>\n\n  /**\n   * Whether an action is currently executing\n   */\n  isExecuting: Accessor<boolean>\n\n  /**\n   * Last action result\n   */\n  lastResult: Accessor<ActionResult | undefined>\n}\n\n/**\n * Props for MCPActionProvider\n */\nexport interface MCPActionProviderProps {\n  /**\n   * Space IDs for multi-space queries\n   */\n  spaceIds?: string[]\n\n  /**\n   * Macro ID when executing within a template\n   */\n  macroId?: string\n\n  /**\n   * Available MCP tools\n   */\n  availableTools?: string[]\n\n  /**\n   * Callback for action execution (for audit logging)\n   */\n  onAction?: (request: ActionRequest, result: ActionResult) => void\n\n  /**\n   * Callback for webhook events (n8n, Zapier integration)\n   */\n  onWebhook?: (event: { type: string; payload: any }) => void\n\n  /**\n   * Custom action executor (override default)\n   */\n  executor?: (request: ActionRequest) => Promise<ActionResult>\n}\n\n// Create the context with undefined default\nconst MCPActionContext = createContext<MCPActionContextValue>()\n\n/**\n * Default action executor using CustomEvent fallback\n * This maintains backward compatibility while allowing Context-based usage\n */\nconst defaultExecutor = async (request: ActionRequest): Promise<ActionResult> => {\n  return new Promise((resolve) => {\n    const timestamp = new Date().toISOString()\n\n    // Dispatch CustomEvent for backward compatibility with existing listeners\n    if (typeof window !== 'undefined') {\n      const event = new CustomEvent('mcp-action', {\n        detail: {\n          toolName: request.toolName,\n          params: request.params || {},\n          spaceIds: request.spaceIds,\n          macroId: request.macroId,\n          // v6.6.1 — action kind so a window-level listener can route a\n          // `submit` (POST to params.submit_url) vs a tool call.\n          action: request.action ?? 'tool-call',\n        },\n        bubbles: true,\n      })\n\n      // Listen for response event\n      const responseHandler = (e: Event) => {\n        const customEvent = e as CustomEvent\n        window.removeEventListener('mcp-action-response', responseHandler)\n        resolve({\n          success: customEvent.detail?.success ?? true,\n          data: customEvent.detail?.data,\n          error: customEvent.detail?.error,\n          timestamp,\n          toolName: request.toolName,\n        })\n      }\n\n      window.addEventListener('mcp-action-response', responseHandler)\n      window.dispatchEvent(event)\n\n      // Timeout fallback - resolve as success if no response in 100ms\n      // (indicates no listener, action was dispatched)\n      setTimeout(() => {\n        window.removeEventListener('mcp-action-response', responseHandler)\n        resolve({\n          success: true,\n          data: { dispatched: true },\n          timestamp,\n          toolName: request.toolName,\n        })\n      }, 100)\n    } else {\n      // Server-side: return immediately\n      resolve({\n        success: false,\n        error: 'Actions not available server-side',\n        timestamp,\n        toolName: request.toolName,\n      })\n    }\n  })\n}\n\n/**\n * MCPActionProvider - Provides action execution context to child components\n *\n * @example\n * ```tsx\n * <MCPActionProvider\n *   spaceIds={['space-123']}\n *   macroId=\"sales_overview\"\n *   onAction={(req, res) => audit(req, res)}\n * >\n *   <UIResourceRenderer layout={layout} />\n * </MCPActionProvider>\n * ```\n */\nexport const MCPActionProvider: ParentComponent<MCPActionProviderProps> = (props) => {\n  const [isExecuting, setIsExecuting] = createSignal(false)\n  const [lastResult, setLastResult] = createSignal<ActionResult>()\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const [spaceIds, _setSpaceIds] = createSignal<string[]>(props.spaceIds || [])\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const [macroId, _setMacroId] = createSignal<string | undefined>(props.macroId)\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const [availableTools, _setAvailableTools] = createSignal<string[]>(props.availableTools || [])\n\n  // Update signals when props change\n  // Note: This is a simple approach; for more complex scenarios, consider createEffect\n\n  const executeAction = async (request: ActionRequest): Promise<ActionResult> => {\n    setIsExecuting(true)\n\n    try {\n      // Enrich request with context\n      const enrichedRequest: ActionRequest = {\n        ...request,\n        spaceIds: request.spaceIds || spaceIds(),\n        macroId: request.macroId || macroId(),\n      }\n\n      // Execute using custom executor or default\n      const executor = props.executor || defaultExecutor\n      const result = await executor(enrichedRequest)\n\n      setLastResult(result)\n\n      // Call audit callback if provided\n      props.onAction?.(enrichedRequest, result)\n\n      // Trigger webhook if provided and action was successful\n      if (result.success && props.onWebhook) {\n        props.onWebhook({\n          type: 'action-completed',\n          payload: {\n            request: enrichedRequest,\n            result,\n          },\n        })\n      }\n\n      return result\n    } catch (error) {\n      const errorResult: ActionResult = {\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error',\n        timestamp: new Date().toISOString(),\n        toolName: request.toolName,\n      }\n\n      setLastResult(errorResult)\n      props.onAction?.(request, errorResult)\n\n      return errorResult\n    } finally {\n      setIsExecuting(false)\n    }\n  }\n\n  const contextValue: MCPActionContextValue = {\n    executeAction,\n    availableTools,\n    spaceIds,\n    macroId,\n    isExecuting,\n    lastResult,\n  }\n\n  return (\n    <MCPActionContext.Provider value={contextValue}>\n      {props.children}\n    </MCPActionContext.Provider>\n  )\n}\n\n/**\n * Hook to access MCP action context\n * Throws if used outside of MCPActionProvider\n *\n * @example\n * ```tsx\n * const { executeAction, isExecuting } = useMCPAction()\n *\n * const handleClick = async () => {\n *   const result = await executeAction({\n *     toolName: 'search.hub',\n *     params: { query: 'revenue Q4' },\n *   })\n * }\n * ```\n */\nexport function useMCPAction(): MCPActionContextValue {\n  const context = useContext(MCPActionContext)\n  if (!context) {\n    throw new Error('useMCPAction must be used within an MCPActionProvider')\n  }\n  return context\n}\n\n/**\n * Hook to access MCP action context with fallback for components\n * outside of provider (uses CustomEvent fallback)\n *\n * @example\n * ```tsx\n * const { executeAction, isExecuting } = useMCPActionSafe()\n * // Works even without MCPActionProvider\n * ```\n */\nexport function useMCPActionSafe(): MCPActionContextValue {\n  const context = useContext(MCPActionContext)\n\n  if (context) {\n    return context\n  }\n\n  // Fallback implementation for components outside provider\n  const [isExecuting, setIsExecuting] = createSignal(false)\n  const [lastResult, setLastResult] = createSignal<ActionResult>()\n\n  const executeAction = async (request: ActionRequest): Promise<ActionResult> => {\n    setIsExecuting(true)\n    try {\n      const result = await defaultExecutor(request)\n      setLastResult(result)\n      return result\n    } finally {\n      setIsExecuting(false)\n    }\n  }\n\n  return {\n    executeAction,\n    availableTools: () => [],\n    spaceIds: () => [],\n    macroId: () => undefined,\n    isExecuting,\n    lastResult,\n  }\n}\n\nexport { MCPActionContext }\n"],"names":["MCPActionContext","createContext","defaultExecutor","request","Promise","resolve","timestamp","Date","toISOString","window","event","CustomEvent","detail","toolName","params","spaceIds","macroId","action","bubbles","responseHandler","e","customEvent","removeEventListener","success","data","error","addEventListener","dispatchEvent","setTimeout","dispatched","MCPActionProvider","props","isExecuting","setIsExecuting","createSignal","lastResult","setLastResult","_setSpaceIds","_setMacroId","availableTools","_setAvailableTools","executeAction","enrichedRequest","executor","result","onAction","onWebhook","type","payload","errorResult","Error","message","contextValue","_$createComponent","Provider","value","children","useMCPAction","context","useContext","useMCPActionSafe","undefined"],"mappings":"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"}

package/dist/context/MCPActionContext.d.ts

@@ -8,7 +8,9 @@ import { ParentComponent, Accessor } from 'solid-js';
  */
 export interface ActionRequest {
     /**
-     * MCP tool name to execute
+     * MCP tool name to execute. For a `submit` action with no associated
+     * tool, renderers pass the sentinel `'submit'` — branch on `action`,
+     * not on `toolName`, to tell a submit apart from a tool call.
      */
     toolName: string;
     /**
@@ -23,6 +25,16 @@ export interface ActionRequest {
      * Optional macro ID for template execution
      */
     macroId?: string;
+    /**
+     * Action kind (v6.6.1). Lets a host `executor` tell a tool call apart
+     * from a form-style `submit`. Absent ⇒ treat as `'tool-call'` (backward
+     * compatible — every pre-v6.6.1 request omits it).
+     *
+     * A `submit` action carries its payload in `params` (e.g. `submit_url`,
+     * `connector_id`, `feedback_value`) and **must NOT** be executed as a
+     * tool call — the host routes it (e.g. POST to `params.submit_url`).
+     */
+    action?: 'tool-call' | 'submit' | 'link';
 }
 /**
  * Action result from execution

package/dist/context/MCPActionContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MCPActionContext.d.ts","sourceRoot":"","sources":["../../src/context/MCPActionContext.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA2C,eAAe,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE7F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,GAAG,CAAA;IAEV;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAEhE;;OAEG;IACH,cAAc,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAElC;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAE5B;;OAEG;IACH,OAAO,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAErC;;OAEG;IACH,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE9B;;OAEG;IACH,UAAU,EAAE,QAAQ,CAAC,YAAY,GAAG,SAAS,CAAC,CAAA;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;IAEjE;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE,KAAK,IAAI,CAAA;IAE3D;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;CAC7D;AAGD,QAAA,MAAM,gBAAgB,+DAAyC,CAAA;AA6D/D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAAe,CAAC,sBAAsB,CA4ErE,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,IAAI,qBAAqB,CAMpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,IAAI,qBAAqB,CA8BxD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAA"}
+{"version":3,"file":"MCPActionContext.d.ts","sourceRoot":"","sources":["../../src/context/MCPActionContext.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA2C,eAAe,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE7F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAA;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,GAAG,CAAA;IAEV;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAEhE;;OAEG;IACH,cAAc,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAElC;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAE5B;;OAEG;IACH,OAAO,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAErC;;OAEG;IACH,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE9B;;OAEG;IACH,UAAU,EAAE,QAAQ,CAAC,YAAY,GAAG,SAAS,CAAC,CAAA;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;IAEjE;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAE,KAAK,IAAI,CAAA;IAE3D;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;CAC7D;AAGD,QAAA,MAAM,gBAAgB,+DAAyC,CAAA;AAgE/D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAAe,CAAC,sBAAsB,CA4ErE,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,IAAI,qBAAqB,CAMpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,IAAI,qBAAqB,CA8BxD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/context/MCPActionContext.js

@@ -10,7 +10,10 @@ const defaultExecutor = async (request) => {
           toolName: request.toolName,
           params: request.params || {},
           spaceIds: request.spaceIds,
-          macroId: request.macroId
+          macroId: request.macroId,
+          // v6.6.1 — action kind so a window-level listener can route a
+          // `submit` (POST to params.submit_url) vs a tool call.
+          action: request.action ?? "tool-call"
         },
         bubbles: true
       });

package/dist/context/MCPActionContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"MCPActionContext.js","sources":["../../src/context/MCPActionContext.tsx"],"sourcesContent":["/**\n * MCPActionContext - Context provider for MCP action execution\n * Phase 5.0: Quick Wins - Replaces CustomEvent with typed context for Mastra integration\n */\n\nimport { createContext, createSignal, useContext, ParentComponent, Accessor } from 'solid-js'\n\n/**\n * Action request payload\n */\nexport interface ActionRequest {\n  /**\n   * MCP tool name to execute\n   */\n  toolName: string\n\n  /**\n   * Tool parameters\n   */\n  params?: Record<string, any>\n\n  /**\n   * Optional space IDs for multi-space context\n   */\n  spaceIds?: string[]\n\n  /**\n   * Optional macro ID for template execution\n   */\n  macroId?: string\n}\n\n/**\n * Action result from execution\n */\nexport interface ActionResult {\n  /**\n   * Whether the action was successful\n   */\n  success: boolean\n\n  /**\n   * Result data (if successful)\n   */\n  data?: any\n\n  /**\n   * Error message (if failed)\n   */\n  error?: string\n\n  /**\n   * Execution timestamp\n   */\n  timestamp: string\n\n  /**\n   * Tool that was executed\n   */\n  toolName: string\n}\n\n/**\n * Context value interface\n */\nexport interface MCPActionContextValue {\n  /**\n   * Execute an MCP action\n   */\n  executeAction: (request: ActionRequest) => Promise<ActionResult>\n\n  /**\n   * Currently available tools (from MCP server)\n   */\n  availableTools: Accessor<string[]>\n\n  /**\n   * Space IDs in current context\n   */\n  spaceIds: Accessor<string[]>\n\n  /**\n   * Current macro ID (if executing within a template)\n   */\n  macroId: Accessor<string | undefined>\n\n  /**\n   * Whether an action is currently executing\n   */\n  isExecuting: Accessor<boolean>\n\n  /**\n   * Last action result\n   */\n  lastResult: Accessor<ActionResult | undefined>\n}\n\n/**\n * Props for MCPActionProvider\n */\nexport interface MCPActionProviderProps {\n  /**\n   * Space IDs for multi-space queries\n   */\n  spaceIds?: string[]\n\n  /**\n   * Macro ID when executing within a template\n   */\n  macroId?: string\n\n  /**\n   * Available MCP tools\n   */\n  availableTools?: string[]\n\n  /**\n   * Callback for action execution (for audit logging)\n   */\n  onAction?: (request: ActionRequest, result: ActionResult) => void\n\n  /**\n   * Callback for webhook events (n8n, Zapier integration)\n   */\n  onWebhook?: (event: { type: string; payload: any }) => void\n\n  /**\n   * Custom action executor (override default)\n   */\n  executor?: (request: ActionRequest) => Promise<ActionResult>\n}\n\n// Create the context with undefined default\nconst MCPActionContext = createContext<MCPActionContextValue>()\n\n/**\n * Default action executor using CustomEvent fallback\n * This maintains backward compatibility while allowing Context-based usage\n */\nconst defaultExecutor = async (request: ActionRequest): Promise<ActionResult> => {\n  return new Promise((resolve) => {\n    const timestamp = new Date().toISOString()\n\n    // Dispatch CustomEvent for backward compatibility with existing listeners\n    if (typeof window !== 'undefined') {\n      const event = new CustomEvent('mcp-action', {\n        detail: {\n          toolName: request.toolName,\n          params: request.params || {},\n          spaceIds: request.spaceIds,\n          macroId: request.macroId,\n        },\n        bubbles: true,\n      })\n\n      // Listen for response event\n      const responseHandler = (e: Event) => {\n        const customEvent = e as CustomEvent\n        window.removeEventListener('mcp-action-response', responseHandler)\n        resolve({\n          success: customEvent.detail?.success ?? true,\n          data: customEvent.detail?.data,\n          error: customEvent.detail?.error,\n          timestamp,\n          toolName: request.toolName,\n        })\n      }\n\n      window.addEventListener('mcp-action-response', responseHandler)\n      window.dispatchEvent(event)\n\n      // Timeout fallback - resolve as success if no response in 100ms\n      // (indicates no listener, action was dispatched)\n      setTimeout(() => {\n        window.removeEventListener('mcp-action-response', responseHandler)\n        resolve({\n          success: true,\n          data: { dispatched: true },\n          timestamp,\n          toolName: request.toolName,\n        })\n      }, 100)\n    } else {\n      // Server-side: return immediately\n      resolve({\n        success: false,\n        error: 'Actions not available server-side',\n        timestamp,\n        toolName: request.toolName,\n      })\n    }\n  })\n}\n\n/**\n * MCPActionProvider - Provides action execution context to child components\n *\n * @example\n * ```tsx\n * <MCPActionProvider\n *   spaceIds={['space-123']}\n *   macroId=\"sales_overview\"\n *   onAction={(req, res) => audit(req, res)}\n * >\n *   <UIResourceRenderer layout={layout} />\n * </MCPActionProvider>\n * ```\n */\nexport const MCPActionProvider: ParentComponent<MCPActionProviderProps> = (props) => {\n  const [isExecuting, setIsExecuting] = createSignal(false)\n  const [lastResult, setLastResult] = createSignal<ActionResult>()\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const [spaceIds, _setSpaceIds] = createSignal<string[]>(props.spaceIds || [])\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const [macroId, _setMacroId] = createSignal<string | undefined>(props.macroId)\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const [availableTools, _setAvailableTools] = createSignal<string[]>(props.availableTools || [])\n\n  // Update signals when props change\n  // Note: This is a simple approach; for more complex scenarios, consider createEffect\n\n  const executeAction = async (request: ActionRequest): Promise<ActionResult> => {\n    setIsExecuting(true)\n\n    try {\n      // Enrich request with context\n      const enrichedRequest: ActionRequest = {\n        ...request,\n        spaceIds: request.spaceIds || spaceIds(),\n        macroId: request.macroId || macroId(),\n      }\n\n      // Execute using custom executor or default\n      const executor = props.executor || defaultExecutor\n      const result = await executor(enrichedRequest)\n\n      setLastResult(result)\n\n      // Call audit callback if provided\n      props.onAction?.(enrichedRequest, result)\n\n      // Trigger webhook if provided and action was successful\n      if (result.success && props.onWebhook) {\n        props.onWebhook({\n          type: 'action-completed',\n          payload: {\n            request: enrichedRequest,\n            result,\n          },\n        })\n      }\n\n      return result\n    } catch (error) {\n      const errorResult: ActionResult = {\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error',\n        timestamp: new Date().toISOString(),\n        toolName: request.toolName,\n      }\n\n      setLastResult(errorResult)\n      props.onAction?.(request, errorResult)\n\n      return errorResult\n    } finally {\n      setIsExecuting(false)\n    }\n  }\n\n  const contextValue: MCPActionContextValue = {\n    executeAction,\n    availableTools,\n    spaceIds,\n    macroId,\n    isExecuting,\n    lastResult,\n  }\n\n  return (\n    <MCPActionContext.Provider value={contextValue}>\n      {props.children}\n    </MCPActionContext.Provider>\n  )\n}\n\n/**\n * Hook to access MCP action context\n * Throws if used outside of MCPActionProvider\n *\n * @example\n * ```tsx\n * const { executeAction, isExecuting } = useMCPAction()\n *\n * const handleClick = async () => {\n *   const result = await executeAction({\n *     toolName: 'search.hub',\n *     params: { query: 'revenue Q4' },\n *   })\n * }\n * ```\n */\nexport function useMCPAction(): MCPActionContextValue {\n  const context = useContext(MCPActionContext)\n  if (!context) {\n    throw new Error('useMCPAction must be used within an MCPActionProvider')\n  }\n  return context\n}\n\n/**\n * Hook to access MCP action context with fallback for components\n * outside of provider (uses CustomEvent fallback)\n *\n * @example\n * ```tsx\n * const { executeAction, isExecuting } = useMCPActionSafe()\n * // Works even without MCPActionProvider\n * ```\n */\nexport function useMCPActionSafe(): MCPActionContextValue {\n  const context = useContext(MCPActionContext)\n\n  if (context) {\n    return context\n  }\n\n  // Fallback implementation for components outside provider\n  const [isExecuting, setIsExecuting] = createSignal(false)\n  const [lastResult, setLastResult] = createSignal<ActionResult>()\n\n  const executeAction = async (request: ActionRequest): Promise<ActionResult> => {\n    setIsExecuting(true)\n    try {\n      const result = await defaultExecutor(request)\n      setLastResult(result)\n      return result\n    } finally {\n      setIsExecuting(false)\n    }\n  }\n\n  return {\n    executeAction,\n    availableTools: () => [],\n    spaceIds: () => [],\n    macroId: () => undefined,\n    isExecuting,\n    lastResult,\n  }\n}\n\nexport { MCPActionContext }\n"],"names":["MCPActionContext","createContext","defaultExecutor","request","Promise","resolve","timestamp","Date","toISOString","window","event","CustomEvent","detail","toolName","params","spaceIds","macroId","bubbles","responseHandler","e","customEvent","removeEventListener","success","data","error","addEventListener","dispatchEvent","setTimeout","dispatched","MCPActionProvider","props","isExecuting","setIsExecuting","createSignal","lastResult","setLastResult","_setSpaceIds","_setMacroId","availableTools","_setAvailableTools","executeAction","enrichedRequest","executor","result","onAction","onWebhook","type","payload","errorResult","Error","message","contextValue","_$createComponent","Provider","value","children","useMCPAction","context","useContext","useMCPActionSafe","undefined"],"mappings":";;AAqIA,MAAMA,mBAAmBC,cAAAA;AAMzB,MAAMC,kBAAkB,OAAOC,YAAkD;AAC/E,SAAO,IAAIC,QAASC,CAAAA,YAAY;AAC9B,UAAMC,aAAY,oBAAIC,KAAAA,GAAOC,YAAAA;AAG7B,QAAI,OAAOC,WAAW,aAAa;AACjC,YAAMC,QAAQ,IAAIC,YAAY,cAAc;AAAA,QAC1CC,QAAQ;AAAA,UACNC,UAAUV,QAAQU;AAAAA,UAClBC,QAAQX,QAAQW,UAAU,CAAA;AAAA,UAC1BC,UAAUZ,QAAQY;AAAAA,UAClBC,SAASb,QAAQa;AAAAA,QAAAA;AAAAA,QAEnBC,SAAS;AAAA,MAAA,CACV;AAGD,YAAMC,kBAAkBA,CAACC,MAAa;;AACpC,cAAMC,cAAcD;AACpBV,eAAOY,oBAAoB,uBAAuBH,eAAe;AACjEb,gBAAQ;AAAA,UACNiB,WAASF,iBAAYR,WAAZQ,mBAAoBE,YAAW;AAAA,UACxCC,OAAMH,iBAAYR,WAAZQ,mBAAoBG;AAAAA,UAC1BC,QAAOJ,iBAAYR,WAAZQ,mBAAoBI;AAAAA,UAC3BlB;AAAAA,UACAO,UAAUV,QAAQU;AAAAA,QAAAA,CACnB;AAAA,MACH;AAEAJ,aAAOgB,iBAAiB,uBAAuBP,eAAe;AAC9DT,aAAOiB,cAAchB,KAAK;AAI1BiB,iBAAW,MAAM;AACflB,eAAOY,oBAAoB,uBAAuBH,eAAe;AACjEb,gBAAQ;AAAA,UACNiB,SAAS;AAAA,UACTC,MAAM;AAAA,YAAEK,YAAY;AAAA,UAAA;AAAA,UACpBtB;AAAAA,UACAO,UAAUV,QAAQU;AAAAA,QAAAA,CACnB;AAAA,MACH,GAAG,GAAG;AAAA,IACR,OAAO;AAELR,cAAQ;AAAA,QACNiB,SAAS;AAAA,QACTE,OAAO;AAAA,QACPlB;AAAAA,QACAO,UAAUV,QAAQU;AAAAA,MAAAA,CACnB;AAAA,IACH;AAAA,EACF,CAAC;AACH;AAgBO,MAAMgB,oBAA8DC,CAAAA,UAAU;AACnF,QAAM,CAACC,aAAaC,cAAc,IAAIC,aAAa,KAAK;AACxD,QAAM,CAACC,YAAYC,aAAa,IAAIF,aAAAA;AAEpC,QAAM,CAAClB,UAAUqB,YAAY,IAAIH,aAAuBH,MAAMf,YAAY,EAAE;AAE5E,QAAM,CAACC,SAASqB,WAAW,IAAIJ,aAAiCH,MAAMd,OAAO;AAE7E,QAAM,CAACsB,gBAAgBC,kBAAkB,IAAIN,aAAuBH,MAAMQ,kBAAkB,EAAE;AAK9F,QAAME,gBAAgB,OAAOrC,YAAkD;;AAC7E6B,mBAAe,IAAI;AAEnB,QAAI;AAEF,YAAMS,kBAAiC;AAAA,QACrC,GAAGtC;AAAAA,QACHY,UAAUZ,QAAQY,YAAYA,SAAAA;AAAAA,QAC9BC,SAASb,QAAQa,WAAWA,QAAAA;AAAAA,MAAQ;AAItC,YAAM0B,WAAWZ,MAAMY,YAAYxC;AACnC,YAAMyC,SAAS,MAAMD,SAASD,eAAe;AAE7CN,oBAAcQ,MAAM;AAGpBb,kBAAMc,aAANd,+BAAiBW,iBAAiBE;AAGlC,UAAIA,OAAOrB,WAAWQ,MAAMe,WAAW;AACrCf,cAAMe,UAAU;AAAA,UACdC,MAAM;AAAA,UACNC,SAAS;AAAA,YACP5C,SAASsC;AAAAA,YACTE;AAAAA,UAAAA;AAAAA,QACF,CACD;AAAA,MACH;AAEA,aAAOA;AAAAA,IACT,SAASnB,OAAO;AACd,YAAMwB,cAA4B;AAAA,QAChC1B,SAAS;AAAA,QACTE,OAAOA,iBAAiByB,QAAQzB,MAAM0B,UAAU;AAAA,QAChD5C,YAAW,oBAAIC,KAAAA,GAAOC,YAAAA;AAAAA,QACtBK,UAAUV,QAAQU;AAAAA,MAAAA;AAGpBsB,oBAAca,WAAW;AACzBlB,kBAAMc,aAANd,+BAAiB3B,SAAS6C;AAE1B,aAAOA;AAAAA,IACT,UAAA;AACEhB,qBAAe,KAAK;AAAA,IACtB;AAAA,EACF;AAEA,QAAMmB,eAAsC;AAAA,IAC1CX;AAAAA,IACAF;AAAAA,IACAvB;AAAAA,IACAC;AAAAA,IACAe;AAAAA,IACAG;AAAAA,EAAAA;AAGF,SAAAkB,gBACGpD,iBAAiBqD,UAAQ;AAAA,IAACC,OAAOH;AAAAA,IAAY,IAAAI,WAAA;AAAA,aAC3CzB,MAAMyB;AAAAA,IAAQ;AAAA,EAAA,CAAA;AAGrB;AAkBO,SAASC,eAAsC;AACpD,QAAMC,UAAUC,WAAW1D,gBAAgB;AAC3C,MAAI,CAACyD,SAAS;AACZ,UAAM,IAAIR,MAAM,uDAAuD;AAAA,EACzE;AACA,SAAOQ;AACT;AAYO,SAASE,mBAA0C;AACxD,QAAMF,UAAUC,WAAW1D,gBAAgB;AAE3C,MAAIyD,SAAS;AACX,WAAOA;AAAAA,EACT;AAGA,QAAM,CAAC1B,aAAaC,cAAc,IAAIC,aAAa,KAAK;AACxD,QAAM,CAACC,YAAYC,aAAa,IAAIF,aAAAA;AAEpC,QAAMO,gBAAgB,OAAOrC,YAAkD;AAC7E6B,mBAAe,IAAI;AACnB,QAAI;AACF,YAAMW,SAAS,MAAMzC,gBAAgBC,OAAO;AAC5CgC,oBAAcQ,MAAM;AACpB,aAAOA;AAAAA,IACT,UAAA;AACEX,qBAAe,KAAK;AAAA,IACtB;AAAA,EACF;AAEA,SAAO;AAAA,IACLQ;AAAAA,IACAF,gBAAgBA,MAAM,CAAA;AAAA,IACtBvB,UAAUA,MAAM,CAAA;AAAA,IAChBC,SAASA,MAAM4C;AAAAA,IACf7B;AAAAA,IACAG;AAAAA,EAAAA;AAEJ;"}
+{"version":3,"file":"MCPActionContext.js","sources":["../../src/context/MCPActionContext.tsx"],"sourcesContent":["/**\n * MCPActionContext - Context provider for MCP action execution\n * Phase 5.0: Quick Wins - Replaces CustomEvent with typed context for Mastra integration\n */\n\nimport { createContext, createSignal, useContext, ParentComponent, Accessor } from 'solid-js'\n\n/**\n * Action request payload\n */\nexport interface ActionRequest {\n  /**\n   * MCP tool name to execute. For a `submit` action with no associated\n   * tool, renderers pass the sentinel `'submit'` — branch on `action`,\n   * not on `toolName`, to tell a submit apart from a tool call.\n   */\n  toolName: string\n\n  /**\n   * Tool parameters\n   */\n  params?: Record<string, any>\n\n  /**\n   * Optional space IDs for multi-space context\n   */\n  spaceIds?: string[]\n\n  /**\n   * Optional macro ID for template execution\n   */\n  macroId?: string\n\n  /**\n   * Action kind (v6.6.1). Lets a host `executor` tell a tool call apart\n   * from a form-style `submit`. Absent ⇒ treat as `'tool-call'` (backward\n   * compatible — every pre-v6.6.1 request omits it).\n   *\n   * A `submit` action carries its payload in `params` (e.g. `submit_url`,\n   * `connector_id`, `feedback_value`) and **must NOT** be executed as a\n   * tool call — the host routes it (e.g. POST to `params.submit_url`).\n   */\n  action?: 'tool-call' | 'submit' | 'link'\n}\n\n/**\n * Action result from execution\n */\nexport interface ActionResult {\n  /**\n   * Whether the action was successful\n   */\n  success: boolean\n\n  /**\n   * Result data (if successful)\n   */\n  data?: any\n\n  /**\n   * Error message (if failed)\n   */\n  error?: string\n\n  /**\n   * Execution timestamp\n   */\n  timestamp: string\n\n  /**\n   * Tool that was executed\n   */\n  toolName: string\n}\n\n/**\n * Context value interface\n */\nexport interface MCPActionContextValue {\n  /**\n   * Execute an MCP action\n   */\n  executeAction: (request: ActionRequest) => Promise<ActionResult>\n\n  /**\n   * Currently available tools (from MCP server)\n   */\n  availableTools: Accessor<string[]>\n\n  /**\n   * Space IDs in current context\n   */\n  spaceIds: Accessor<string[]>\n\n  /**\n   * Current macro ID (if executing within a template)\n   */\n  macroId: Accessor<string | undefined>\n\n  /**\n   * Whether an action is currently executing\n   */\n  isExecuting: Accessor<boolean>\n\n  /**\n   * Last action result\n   */\n  lastResult: Accessor<ActionResult | undefined>\n}\n\n/**\n * Props for MCPActionProvider\n */\nexport interface MCPActionProviderProps {\n  /**\n   * Space IDs for multi-space queries\n   */\n  spaceIds?: string[]\n\n  /**\n   * Macro ID when executing within a template\n   */\n  macroId?: string\n\n  /**\n   * Available MCP tools\n   */\n  availableTools?: string[]\n\n  /**\n   * Callback for action execution (for audit logging)\n   */\n  onAction?: (request: ActionRequest, result: ActionResult) => void\n\n  /**\n   * Callback for webhook events (n8n, Zapier integration)\n   */\n  onWebhook?: (event: { type: string; payload: any }) => void\n\n  /**\n   * Custom action executor (override default)\n   */\n  executor?: (request: ActionRequest) => Promise<ActionResult>\n}\n\n// Create the context with undefined default\nconst MCPActionContext = createContext<MCPActionContextValue>()\n\n/**\n * Default action executor using CustomEvent fallback\n * This maintains backward compatibility while allowing Context-based usage\n */\nconst defaultExecutor = async (request: ActionRequest): Promise<ActionResult> => {\n  return new Promise((resolve) => {\n    const timestamp = new Date().toISOString()\n\n    // Dispatch CustomEvent for backward compatibility with existing listeners\n    if (typeof window !== 'undefined') {\n      const event = new CustomEvent('mcp-action', {\n        detail: {\n          toolName: request.toolName,\n          params: request.params || {},\n          spaceIds: request.spaceIds,\n          macroId: request.macroId,\n          // v6.6.1 — action kind so a window-level listener can route a\n          // `submit` (POST to params.submit_url) vs a tool call.\n          action: request.action ?? 'tool-call',\n        },\n        bubbles: true,\n      })\n\n      // Listen for response event\n      const responseHandler = (e: Event) => {\n        const customEvent = e as CustomEvent\n        window.removeEventListener('mcp-action-response', responseHandler)\n        resolve({\n          success: customEvent.detail?.success ?? true,\n          data: customEvent.detail?.data,\n          error: customEvent.detail?.error,\n          timestamp,\n          toolName: request.toolName,\n        })\n      }\n\n      window.addEventListener('mcp-action-response', responseHandler)\n      window.dispatchEvent(event)\n\n      // Timeout fallback - resolve as success if no response in 100ms\n      // (indicates no listener, action was dispatched)\n      setTimeout(() => {\n        window.removeEventListener('mcp-action-response', responseHandler)\n        resolve({\n          success: true,\n          data: { dispatched: true },\n          timestamp,\n          toolName: request.toolName,\n        })\n      }, 100)\n    } else {\n      // Server-side: return immediately\n      resolve({\n        success: false,\n        error: 'Actions not available server-side',\n        timestamp,\n        toolName: request.toolName,\n      })\n    }\n  })\n}\n\n/**\n * MCPActionProvider - Provides action execution context to child components\n *\n * @example\n * ```tsx\n * <MCPActionProvider\n *   spaceIds={['space-123']}\n *   macroId=\"sales_overview\"\n *   onAction={(req, res) => audit(req, res)}\n * >\n *   <UIResourceRenderer layout={layout} />\n * </MCPActionProvider>\n * ```\n */\nexport const MCPActionProvider: ParentComponent<MCPActionProviderProps> = (props) => {\n  const [isExecuting, setIsExecuting] = createSignal(false)\n  const [lastResult, setLastResult] = createSignal<ActionResult>()\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const [spaceIds, _setSpaceIds] = createSignal<string[]>(props.spaceIds || [])\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const [macroId, _setMacroId] = createSignal<string | undefined>(props.macroId)\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const [availableTools, _setAvailableTools] = createSignal<string[]>(props.availableTools || [])\n\n  // Update signals when props change\n  // Note: This is a simple approach; for more complex scenarios, consider createEffect\n\n  const executeAction = async (request: ActionRequest): Promise<ActionResult> => {\n    setIsExecuting(true)\n\n    try {\n      // Enrich request with context\n      const enrichedRequest: ActionRequest = {\n        ...request,\n        spaceIds: request.spaceIds || spaceIds(),\n        macroId: request.macroId || macroId(),\n      }\n\n      // Execute using custom executor or default\n      const executor = props.executor || defaultExecutor\n      const result = await executor(enrichedRequest)\n\n      setLastResult(result)\n\n      // Call audit callback if provided\n      props.onAction?.(enrichedRequest, result)\n\n      // Trigger webhook if provided and action was successful\n      if (result.success && props.onWebhook) {\n        props.onWebhook({\n          type: 'action-completed',\n          payload: {\n            request: enrichedRequest,\n            result,\n          },\n        })\n      }\n\n      return result\n    } catch (error) {\n      const errorResult: ActionResult = {\n        success: false,\n        error: error instanceof Error ? error.message : 'Unknown error',\n        timestamp: new Date().toISOString(),\n        toolName: request.toolName,\n      }\n\n      setLastResult(errorResult)\n      props.onAction?.(request, errorResult)\n\n      return errorResult\n    } finally {\n      setIsExecuting(false)\n    }\n  }\n\n  const contextValue: MCPActionContextValue = {\n    executeAction,\n    availableTools,\n    spaceIds,\n    macroId,\n    isExecuting,\n    lastResult,\n  }\n\n  return (\n    <MCPActionContext.Provider value={contextValue}>\n      {props.children}\n    </MCPActionContext.Provider>\n  )\n}\n\n/**\n * Hook to access MCP action context\n * Throws if used outside of MCPActionProvider\n *\n * @example\n * ```tsx\n * const { executeAction, isExecuting } = useMCPAction()\n *\n * const handleClick = async () => {\n *   const result = await executeAction({\n *     toolName: 'search.hub',\n *     params: { query: 'revenue Q4' },\n *   })\n * }\n * ```\n */\nexport function useMCPAction(): MCPActionContextValue {\n  const context = useContext(MCPActionContext)\n  if (!context) {\n    throw new Error('useMCPAction must be used within an MCPActionProvider')\n  }\n  return context\n}\n\n/**\n * Hook to access MCP action context with fallback for components\n * outside of provider (uses CustomEvent fallback)\n *\n * @example\n * ```tsx\n * const { executeAction, isExecuting } = useMCPActionSafe()\n * // Works even without MCPActionProvider\n * ```\n */\nexport function useMCPActionSafe(): MCPActionContextValue {\n  const context = useContext(MCPActionContext)\n\n  if (context) {\n    return context\n  }\n\n  // Fallback implementation for components outside provider\n  const [isExecuting, setIsExecuting] = createSignal(false)\n  const [lastResult, setLastResult] = createSignal<ActionResult>()\n\n  const executeAction = async (request: ActionRequest): Promise<ActionResult> => {\n    setIsExecuting(true)\n    try {\n      const result = await defaultExecutor(request)\n      setLastResult(result)\n      return result\n    } finally {\n      setIsExecuting(false)\n    }\n  }\n\n  return {\n    executeAction,\n    availableTools: () => [],\n    spaceIds: () => [],\n    macroId: () => undefined,\n    isExecuting,\n    lastResult,\n  }\n}\n\nexport { MCPActionContext }\n"],"names":["MCPActionContext","createContext","defaultExecutor","request","Promise","resolve","timestamp","Date","toISOString","window","event","CustomEvent","detail","toolName","params","spaceIds","macroId","action","bubbles","responseHandler","e","customEvent","removeEventListener","success","data","error","addEventListener","dispatchEvent","setTimeout","dispatched","MCPActionProvider","props","isExecuting","setIsExecuting","createSignal","lastResult","setLastResult","_setSpaceIds","_setMacroId","availableTools","_setAvailableTools","executeAction","enrichedRequest","executor","result","onAction","onWebhook","type","payload","errorResult","Error","message","contextValue","_$createComponent","Provider","value","children","useMCPAction","context","useContext","useMCPActionSafe","undefined"],"mappings":"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"}

package/dist/mcp-ui-spec/dist/schemas.cjs

@@ -252,6 +252,99 @@ const MapMarkerSchema = types.object({
   tooltip: types.string().optional(),
   popup: types.string().optional()
 });
+const GeoJSONPositionSchema = types.array(types.number()).min(2);
+const GeoJSONCoordinatesSchema = types.union([
+  GeoJSONPositionSchema,
+  types.array(GeoJSONPositionSchema),
+  types.array(types.array(GeoJSONPositionSchema)),
+  types.array(types.array(types.array(GeoJSONPositionSchema)))
+]);
+const GeoJSONGeometryTypeSchema = types.enum([
+  "Point",
+  "MultiPoint",
+  "LineString",
+  "MultiLineString",
+  "Polygon",
+  "MultiPolygon",
+  "GeometryCollection"
+]);
+const GeoJSONSimpleGeometrySchema = types.object({
+  type: GeoJSONGeometryTypeSchema,
+  coordinates: GeoJSONCoordinatesSchema.optional(),
+  bbox: types.array(types.number()).optional()
+});
+const GeoJSONGeometrySchema = types.object({
+  type: GeoJSONGeometryTypeSchema,
+  coordinates: GeoJSONCoordinatesSchema.optional(),
+  geometries: types.array(GeoJSONSimpleGeometrySchema).optional(),
+  bbox: types.array(types.number()).optional()
+});
+const GeoJSONFeatureSchema = types.object({
+  type: types.literal("Feature"),
+  geometry: GeoJSONGeometrySchema.nullable(),
+  properties: types.record(types.unknown()).nullable().optional(),
+  id: types.union([types.string(), types.number()]).optional(),
+  bbox: types.array(types.number()).optional()
+});
+const GeoJSONFeatureCollectionSchema = types.object({
+  type: types.literal("FeatureCollection"),
+  features: types.array(GeoJSONFeatureSchema),
+  bbox: types.array(types.number()).optional()
+});
+const GeoJSONSchema = types.union([
+  GeoJSONFeatureCollectionSchema,
+  GeoJSONFeatureSchema,
+  GeoJSONGeometrySchema
+]);
+const MapGeoJSONStyleSchema = types.object({
+  fillColor: types.string().optional(),
+  fillOpacity: types.number().optional(),
+  strokeColor: types.string().optional(),
+  strokeWeight: types.number().optional(),
+  strokeOpacity: types.number().optional(),
+  choroplethField: types.string().optional(),
+  choroplethScale: types.array(types.tuple([types.number(), types.string()])).optional(),
+  choroplethFallback: types.string().optional()
+});
+const MapPopupConfigSchema = types.object({
+  titleField: types.string().optional(),
+  fields: types.array(types.string()).optional(),
+  template: types.string().optional()
+});
+const MapLayerSchema = types.object({
+  name: types.string().min(1),
+  visible: types.boolean().optional(),
+  geojson: GeoJSONSchema,
+  style: MapGeoJSONStyleSchema.optional(),
+  popup: MapPopupConfigSchema.optional()
+});
+const MapClusterOptionsSchema = types.object({
+  maxClusterRadius: types.number().optional(),
+  spiderfyOnMaxZoom: types.boolean().optional(),
+  showCoverageOnHover: types.boolean().optional(),
+  disableClusteringAtZoom: types.number().optional(),
+  animateAddingMarkers: types.boolean().optional()
+});
+const MapPMTilesPaintRuleSchema = types.object({
+  dataLayer: types.string(),
+  symbolizer: types.enum(["polygon", "line", "circle"]),
+  color: types.string().optional(),
+  width: types.number().optional(),
+  opacity: types.number().optional()
+});
+const MapPMTilesLabelRuleSchema = types.object({
+  dataLayer: types.string(),
+  textField: types.string(),
+  fontSize: types.number().optional()
+});
+const MapPMTilesConfigSchema = types.object({
+  url: types.string(),
+  attribution: types.string().optional(),
+  paintRules: types.array(MapPMTilesPaintRuleSchema).optional(),
+  labelRules: types.array(MapPMTilesLabelRuleSchema).optional(),
+  maxZoom: types.number().optional(),
+  minZoom: types.number().optional()
+});
 const MapComponentParamsSchema = types.object({
   center: LatLngPointSchema.optional(),
   zoom: types.number().optional(),
@@ -261,7 +354,18 @@ const MapComponentParamsSchema = types.object({
   zoomControl: types.boolean().optional(),
   scrollWheelZoom: types.boolean().optional(),
   tileLayer: types.string().optional(),
-  attribution: types.string().optional()
+  attribution: types.string().optional(),
+  className: types.string().optional(),
+  // GeoJSON layer (v5.2.0) — polygons / lines / points from structured data.
+  geojson: GeoJSONSchema.optional(),
+  geojsonStyle: MapGeoJSONStyleSchema.optional(),
+  popup: MapPopupConfigSchema.optional(),
+  // Multiple named GeoJSON overlays with a Leaflet layer control (v5.2.0).
+  layers: types.array(MapLayerSchema).optional(),
+  // Marker clustering — `true` for defaults, or an options object (v5.2.0).
+  clustering: types.union([types.boolean(), MapClusterOptionsSchema]).optional(),
+  // PMTiles vector-tile source for large datasets (v5.2.0).
+  pmtiles: MapPMTilesConfigSchema.optional()
 });
 const GraphNodeSchema = types.object({
   id: types.string().min(1),
@@ -641,6 +745,125 @@ types.object({
   /** Free-text comment. */
   comment: types.string().optional()
 });
+const MACRO_RUN_V1 = "macro-run/v1";
+const MACRO_INTERROGATION_V1 = "macro-interrogation/v1";
+const MacroRunStatusSchema = types.enum([
+  "pending",
+  "running",
+  "awaiting_input",
+  "completed",
+  "failed",
+  "aborted"
+]);
+const MacroStepStatusSchema = types.enum(["pending", "active", "done", "skipped", "failed"]);
+const MacroInvocationTypeSchema = types.enum([
+  "slash_command",
+  "natural_language",
+  "api_direct",
+  "pipeline",
+  "chat_stream"
+]);
+const MacroStepV1Schema = types.lazy(
+  () => types.object({
+    id: types.string().min(1),
+    label: types.string(),
+    toolName: types.string().optional(),
+    status: MacroStepStatusSchema,
+    summary: types.string().optional(),
+    durationMs: types.number().optional(),
+    error: types.string().optional(),
+    resultRef: types.string().optional(),
+    parallel: types.array(MacroStepV1Schema).optional()
+  })
+);
+const MacroInterrogationOptionSchema = types.object({
+  value: types.string(),
+  label: types.string(),
+  icon: types.string().optional(),
+  description: types.string().optional(),
+  metadata: types.record(types.unknown()).optional()
+});
+const MacroInterrogationKindSchema = types.enum(["choice", "confirm", "form", "elicitation"]);
+const MacroInterrogationV1Schema = types.object({
+  schemaVersion: types.literal(MACRO_INTERROGATION_V1),
+  interrogationId: types.string().min(1),
+  runId: types.string().min(1),
+  correlationId: types.string().optional(),
+  stepId: types.string().optional(),
+  /** Free-form tag describing what the run is blocked on. */
+  waitingFor: types.string().optional(),
+  kind: MacroInterrogationKindSchema,
+  title: types.string(),
+  message: types.string().optional(),
+  /** Options for a `choice` interrogation. */
+  options: types.array(MacroInterrogationOptionSchema).optional(),
+  /** Labels / variant for a `confirm` interrogation. */
+  confirm: types.object({
+    confirmLabel: types.string().optional(),
+    cancelLabel: types.string().optional(),
+    variant: types.enum(["default", "danger"]).optional()
+  }).optional(),
+  /** Opaque field list for a `form` interrogation (renderer-side shape). */
+  fields: types.array(types.unknown()).optional(),
+  /** Opaque MCP elicitation JSON Schema for an `elicitation` interrogation. */
+  elicitationSchema: types.unknown().optional(),
+  /** A pre-selected default the host may surface (e.g. timeout fallback). */
+  defaultChoice: types.object({
+    value: types.string(),
+    reason: types.string().optional()
+  }).optional(),
+  /** How the host resumes the run once answered — host-side, opaque to the lib. */
+  resume: types.object({
+    endpoint: types.string(),
+    mode: types.enum(["agent_resume", "legacy_chat_prompt", "macro_resume"])
+  }).optional(),
+  metadata: types.record(types.unknown()).optional()
+});
+const MacroRunAgentSchema = types.object({
+  id: types.string(),
+  name: types.string(),
+  avatar: types.string().optional(),
+  capabilities: types.array(types.string()).optional(),
+  status: types.enum(["idle", "running", "waiting", "done", "error"]).optional(),
+  currentStep: types.object({ id: types.string(), label: types.string() }).optional()
+});
+const MacroRunErrorSchema = types.object({
+  message: types.string(),
+  code: types.string().optional(),
+  stepId: types.string().optional(),
+  retryable: types.boolean().optional()
+});
+const MacroRunOutcomeSchema = types.object({
+  kind: types.enum(["verified_text", "briefing_diff", "agent_result", "raw"]),
+  content: types.unknown()
+});
+types.object({
+  schemaVersion: types.literal(MACRO_RUN_V1),
+  // Identity
+  runId: types.string().min(1),
+  correlationId: types.string().optional(),
+  macroId: types.string().min(1),
+  macroName: types.string().optional(),
+  macroVersion: types.string().optional(),
+  title: types.string().optional(),
+  invocationType: MacroInvocationTypeSchema.optional(),
+  // State
+  status: MacroRunStatusSchema,
+  startedAt: types.string().optional(),
+  updatedAt: types.string().optional(),
+  completedAt: types.string().optional(),
+  // Presentation
+  agent: MacroRunAgentSchema.optional(),
+  // Execution
+  steps: types.array(MacroStepV1Schema),
+  /** `UIComponent`-shaped results (passthrough). Optional — see header. */
+  results: types.array(types.record(types.unknown())).optional(),
+  pendingInterrogation: MacroInterrogationV1Schema.optional(),
+  error: MacroRunErrorSchema.optional(),
+  outcome: MacroRunOutcomeSchema.optional(),
+  variables: types.record(types.unknown()).optional(),
+  metadata: types.record(types.unknown()).optional()
+});
 exports.ActionGroupGapSchema = ActionGroupGapSchema;
 exports.ActionGroupLayoutSchema = ActionGroupLayoutSchema;
 exports.ActionGroupParamsSchema = ActionGroupParamsSchema;
@@ -669,6 +892,13 @@ exports.FormFieldSchema = FormFieldSchema;
 exports.FormFieldTypeSchema = FormFieldTypeSchema;
 exports.FormSubmitActionSchema = FormSubmitActionSchema;
 exports.GalleryImageSchema = GalleryImageSchema;
+exports.GeoJSONCoordinatesSchema = GeoJSONCoordinatesSchema;
+exports.GeoJSONFeatureCollectionSchema = GeoJSONFeatureCollectionSchema;
+exports.GeoJSONFeatureSchema = GeoJSONFeatureSchema;
+exports.GeoJSONGeometrySchema = GeoJSONGeometrySchema;
+exports.GeoJSONGeometryTypeSchema = GeoJSONGeometryTypeSchema;
+exports.GeoJSONPositionSchema = GeoJSONPositionSchema;
+exports.GeoJSONSchema = GeoJSONSchema;
 exports.GraphComponentParamsSchema = GraphComponentParamsSchema;
 exports.GraphEdgeSchema = GraphEdgeSchema;
 exports.GraphLayoutNameSchema = GraphLayoutNameSchema;
@@ -684,8 +914,27 @@ exports.LatLngObjectSchema = LatLngObjectSchema;
 exports.LatLngPointSchema = LatLngPointSchema;
 exports.LatLngTupleSchema = LatLngTupleSchema;
 exports.LinkComponentParamsSchema = LinkComponentParamsSchema;
+exports.MACRO_INTERROGATION_V1 = MACRO_INTERROGATION_V1;
+exports.MACRO_RUN_V1 = MACRO_RUN_V1;
+exports.MacroInterrogationKindSchema = MacroInterrogationKindSchema;
+exports.MacroInterrogationOptionSchema = MacroInterrogationOptionSchema;
+exports.MacroInterrogationV1Schema = MacroInterrogationV1Schema;
+exports.MacroInvocationTypeSchema = MacroInvocationTypeSchema;
+exports.MacroRunAgentSchema = MacroRunAgentSchema;
+exports.MacroRunErrorSchema = MacroRunErrorSchema;
+exports.MacroRunOutcomeSchema = MacroRunOutcomeSchema;
+exports.MacroRunStatusSchema = MacroRunStatusSchema;
+exports.MacroStepStatusSchema = MacroStepStatusSchema;
+exports.MacroStepV1Schema = MacroStepV1Schema;
+exports.MapClusterOptionsSchema = MapClusterOptionsSchema;
 exports.MapComponentParamsSchema = MapComponentParamsSchema;
+exports.MapGeoJSONStyleSchema = MapGeoJSONStyleSchema;
+exports.MapLayerSchema = MapLayerSchema;
 exports.MapMarkerSchema = MapMarkerSchema;
+exports.MapPMTilesConfigSchema = MapPMTilesConfigSchema;
+exports.MapPMTilesLabelRuleSchema = MapPMTilesLabelRuleSchema;
+exports.MapPMTilesPaintRuleSchema = MapPMTilesPaintRuleSchema;
+exports.MapPopupConfigSchema = MapPopupConfigSchema;
 exports.MetricComponentParamsSchema = MetricComponentParamsSchema;
 exports.MetricTrendSchema = MetricTrendSchema;
 exports.ModalSizeSchema = ModalSizeSchema;