@seed-ship/mcp-ui-solid 1.1.0 → 1.2.0

package/dist/context/MCPActionContext.cjs

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const web = require("solid-js/web");
+const solidJs = require("solid-js");
+const MCPActionContext = solidJs.createContext();
+const defaultExecutor = async (request) => {
+  return new Promise((resolve) => {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    if (typeof window !== "undefined") {
+      const event = new CustomEvent("mcp-action", {
+        detail: {
+          toolName: request.toolName,
+          params: request.params || {},
+          spaceIds: request.spaceIds,
+          macroId: request.macroId
+        },
+        bubbles: true
+      });
+      const responseHandler = (e) => {
+        var _a, _b, _c;
+        const customEvent = e;
+        window.removeEventListener("mcp-action-response", responseHandler);
+        resolve({
+          success: ((_a = customEvent.detail) == null ? void 0 : _a.success) ?? true,
+          data: (_b = customEvent.detail) == null ? void 0 : _b.data,
+          error: (_c = customEvent.detail) == null ? void 0 : _c.error,
+          timestamp,
+          toolName: request.toolName
+        });
+      };
+      window.addEventListener("mcp-action-response", responseHandler);
+      window.dispatchEvent(event);
+      setTimeout(() => {
+        window.removeEventListener("mcp-action-response", responseHandler);
+        resolve({
+          success: true,
+          data: {
+            dispatched: true
+          },
+          timestamp,
+          toolName: request.toolName
+        });
+      }, 100);
+    } else {
+      resolve({
+        success: false,
+        error: "Actions not available server-side",
+        timestamp,
+        toolName: request.toolName
+      });
+    }
+  });
+};
+const MCPActionProvider = (props) => {
+  const [isExecuting, setIsExecuting] = solidJs.createSignal(false);
+  const [lastResult, setLastResult] = solidJs.createSignal();
+  const [spaceIds, setSpaceIds] = solidJs.createSignal(props.spaceIds || []);
+  const [macroId, setMacroId] = solidJs.createSignal(props.macroId);
+  const [availableTools, setAvailableTools] = solidJs.createSignal(props.availableTools || []);
+  const executeAction = async (request) => {
+    var _a, _b;
+    setIsExecuting(true);
+    try {
+      const enrichedRequest = {
+        ...request,
+        spaceIds: request.spaceIds || spaceIds(),
+        macroId: request.macroId || macroId()
+      };
+      const executor = props.executor || defaultExecutor;
+      const result = await executor(enrichedRequest);
+      setLastResult(result);
+      (_a = props.onAction) == null ? void 0 : _a.call(props, enrichedRequest, result);
+      if (result.success && props.onWebhook) {
+        props.onWebhook({
+          type: "action-completed",
+          payload: {
+            request: enrichedRequest,
+            result
+          }
+        });
+      }
+      return result;
+    } catch (error) {
+      const errorResult = {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        toolName: request.toolName
+      };
+      setLastResult(errorResult);
+      (_b = props.onAction) == null ? void 0 : _b.call(props, request, errorResult);
+      return errorResult;
+    } finally {
+      setIsExecuting(false);
+    }
+  };
+  const contextValue = {
+    executeAction,
+    availableTools,
+    spaceIds,
+    macroId,
+    isExecuting,
+    lastResult
+  };
+  return web.createComponent(MCPActionContext.Provider, {
+    value: contextValue,
+    get children() {
+      return props.children;
+    }
+  });
+};
+function useMCPAction() {
+  const context = solidJs.useContext(MCPActionContext);
+  if (!context) {
+    throw new Error("useMCPAction must be used within an MCPActionProvider");
+  }
+  return context;
+}
+function useMCPActionSafe() {
+  const context = solidJs.useContext(MCPActionContext);
+  if (context) {
+    return context;
+  }
+  const [isExecuting, setIsExecuting] = solidJs.createSignal(false);
+  const [lastResult, setLastResult] = solidJs.createSignal();
+  const executeAction = async (request) => {
+    setIsExecuting(true);
+    try {
+      const result = await defaultExecutor(request);
+      setLastResult(result);
+      return result;
+    } finally {
+      setIsExecuting(false);
+    }
+  };
+  return {
+    executeAction,
+    availableTools: () => [],
+    spaceIds: () => [],
+    macroId: () => void 0,
+    isExecuting,
+    lastResult
+  };
+}
+exports.MCPActionContext = MCPActionContext;
+exports.MCPActionProvider = MCPActionProvider;
+exports.useMCPAction = useMCPAction;
+exports.useMCPActionSafe = useMCPActionSafe;
+//# sourceMappingURL=MCPActionContext.cjs.map

package/dist/context/MCPActionContext.cjs.map

@@ -0,0 +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  const [spaceIds, setSpaceIds] = createSignal<string[]>(props.spaceIds || [])\n  const [macroId, setMacroId] = createSignal<string | undefined>(props.macroId)\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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"}

package/dist/context/MCPActionContext.d.ts

@@ -0,0 +1,158 @@
+/**
+ * MCPActionContext - Context provider for MCP action execution
+ * Phase 5.0: Quick Wins - Replaces CustomEvent with typed context for Mastra integration
+ */
+import { ParentComponent, Accessor } from 'solid-js';
+/**
+ * Action request payload
+ */
+export interface ActionRequest {
+    /**
+     * MCP tool name to execute
+     */
+    toolName: string;
+    /**
+     * Tool parameters
+     */
+    params?: Record<string, any>;
+    /**
+     * Optional space IDs for multi-space context
+     */
+    spaceIds?: string[];
+    /**
+     * Optional macro ID for template execution
+     */
+    macroId?: string;
+}
+/**
+ * Action result from execution
+ */
+export interface ActionResult {
+    /**
+     * Whether the action was successful
+     */
+    success: boolean;
+    /**
+     * Result data (if successful)
+     */
+    data?: any;
+    /**
+     * Error message (if failed)
+     */
+    error?: string;
+    /**
+     * Execution timestamp
+     */
+    timestamp: string;
+    /**
+     * Tool that was executed
+     */
+    toolName: string;
+}
+/**
+ * Context value interface
+ */
+export interface MCPActionContextValue {
+    /**
+     * Execute an MCP action
+     */
+    executeAction: (request: ActionRequest) => Promise<ActionResult>;
+    /**
+     * Currently available tools (from MCP server)
+     */
+    availableTools: Accessor<string[]>;
+    /**
+     * Space IDs in current context
+     */
+    spaceIds: Accessor<string[]>;
+    /**
+     * Current macro ID (if executing within a template)
+     */
+    macroId: Accessor<string | undefined>;
+    /**
+     * Whether an action is currently executing
+     */
+    isExecuting: Accessor<boolean>;
+    /**
+     * Last action result
+     */
+    lastResult: Accessor<ActionResult | undefined>;
+}
+/**
+ * Props for MCPActionProvider
+ */
+export interface MCPActionProviderProps {
+    /**
+     * Space IDs for multi-space queries
+     */
+    spaceIds?: string[];
+    /**
+     * Macro ID when executing within a template
+     */
+    macroId?: string;
+    /**
+     * Available MCP tools
+     */
+    availableTools?: string[];
+    /**
+     * Callback for action execution (for audit logging)
+     */
+    onAction?: (request: ActionRequest, result: ActionResult) => void;
+    /**
+     * Callback for webhook events (n8n, Zapier integration)
+     */
+    onWebhook?: (event: {
+        type: string;
+        payload: any;
+    }) => void;
+    /**
+     * Custom action executor (override default)
+     */
+    executor?: (request: ActionRequest) => Promise<ActionResult>;
+}
+declare const MCPActionContext: import("solid-js").Context<MCPActionContextValue | undefined>;
+/**
+ * MCPActionProvider - Provides action execution context to child components
+ *
+ * @example
+ * ```tsx
+ * <MCPActionProvider
+ *   spaceIds={['space-123']}
+ *   macroId="sales_overview"
+ *   onAction={(req, res) => audit(req, res)}
+ * >
+ *   <UIResourceRenderer layout={layout} />
+ * </MCPActionProvider>
+ * ```
+ */
+export declare const MCPActionProvider: ParentComponent<MCPActionProviderProps>;
+/**
+ * Hook to access MCP action context
+ * Throws if used outside of MCPActionProvider
+ *
+ * @example
+ * ```tsx
+ * const { executeAction, isExecuting } = useMCPAction()
+ *
+ * const handleClick = async () => {
+ *   const result = await executeAction({
+ *     toolName: 'search.hub',
+ *     params: { query: 'revenue Q4' },
+ *   })
+ * }
+ * ```
+ */
+export declare function useMCPAction(): MCPActionContextValue;
+/**
+ * Hook to access MCP action context with fallback for components
+ * outside of provider (uses CustomEvent fallback)
+ *
+ * @example
+ * ```tsx
+ * const { executeAction, isExecuting } = useMCPActionSafe()
+ * // Works even without MCPActionProvider
+ * ```
+ */
+export declare function useMCPActionSafe(): MCPActionContextValue;
+export { MCPActionContext };
+//# sourceMappingURL=MCPActionContext.d.ts.map

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

@@ -0,0 +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,CAyErE,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

@@ -0,0 +1,149 @@
+import { createComponent } from "solid-js/web";
+import { createContext, createSignal, useContext } from "solid-js";
+const MCPActionContext = createContext();
+const defaultExecutor = async (request) => {
+  return new Promise((resolve) => {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    if (typeof window !== "undefined") {
+      const event = new CustomEvent("mcp-action", {
+        detail: {
+          toolName: request.toolName,
+          params: request.params || {},
+          spaceIds: request.spaceIds,
+          macroId: request.macroId
+        },
+        bubbles: true
+      });
+      const responseHandler = (e) => {
+        var _a, _b, _c;
+        const customEvent = e;
+        window.removeEventListener("mcp-action-response", responseHandler);
+        resolve({
+          success: ((_a = customEvent.detail) == null ? void 0 : _a.success) ?? true,
+          data: (_b = customEvent.detail) == null ? void 0 : _b.data,
+          error: (_c = customEvent.detail) == null ? void 0 : _c.error,
+          timestamp,
+          toolName: request.toolName
+        });
+      };
+      window.addEventListener("mcp-action-response", responseHandler);
+      window.dispatchEvent(event);
+      setTimeout(() => {
+        window.removeEventListener("mcp-action-response", responseHandler);
+        resolve({
+          success: true,
+          data: {
+            dispatched: true
+          },
+          timestamp,
+          toolName: request.toolName
+        });
+      }, 100);
+    } else {
+      resolve({
+        success: false,
+        error: "Actions not available server-side",
+        timestamp,
+        toolName: request.toolName
+      });
+    }
+  });
+};
+const MCPActionProvider = (props) => {
+  const [isExecuting, setIsExecuting] = createSignal(false);
+  const [lastResult, setLastResult] = createSignal();
+  const [spaceIds, setSpaceIds] = createSignal(props.spaceIds || []);
+  const [macroId, setMacroId] = createSignal(props.macroId);
+  const [availableTools, setAvailableTools] = createSignal(props.availableTools || []);
+  const executeAction = async (request) => {
+    var _a, _b;
+    setIsExecuting(true);
+    try {
+      const enrichedRequest = {
+        ...request,
+        spaceIds: request.spaceIds || spaceIds(),
+        macroId: request.macroId || macroId()
+      };
+      const executor = props.executor || defaultExecutor;
+      const result = await executor(enrichedRequest);
+      setLastResult(result);
+      (_a = props.onAction) == null ? void 0 : _a.call(props, enrichedRequest, result);
+      if (result.success && props.onWebhook) {
+        props.onWebhook({
+          type: "action-completed",
+          payload: {
+            request: enrichedRequest,
+            result
+          }
+        });
+      }
+      return result;
+    } catch (error) {
+      const errorResult = {
+        success: false,
+        error: error instanceof Error ? error.message : "Unknown error",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        toolName: request.toolName
+      };
+      setLastResult(errorResult);
+      (_b = props.onAction) == null ? void 0 : _b.call(props, request, errorResult);
+      return errorResult;
+    } finally {
+      setIsExecuting(false);
+    }
+  };
+  const contextValue = {
+    executeAction,
+    availableTools,
+    spaceIds,
+    macroId,
+    isExecuting,
+    lastResult
+  };
+  return createComponent(MCPActionContext.Provider, {
+    value: contextValue,
+    get children() {
+      return props.children;
+    }
+  });
+};
+function useMCPAction() {
+  const context = useContext(MCPActionContext);
+  if (!context) {
+    throw new Error("useMCPAction must be used within an MCPActionProvider");
+  }
+  return context;
+}
+function useMCPActionSafe() {
+  const context = useContext(MCPActionContext);
+  if (context) {
+    return context;
+  }
+  const [isExecuting, setIsExecuting] = createSignal(false);
+  const [lastResult, setLastResult] = createSignal();
+  const executeAction = async (request) => {
+    setIsExecuting(true);
+    try {
+      const result = await defaultExecutor(request);
+      setLastResult(result);
+      return result;
+    } finally {
+      setIsExecuting(false);
+    }
+  };
+  return {
+    executeAction,
+    availableTools: () => [],
+    spaceIds: () => [],
+    macroId: () => void 0,
+    isExecuting,
+    lastResult
+  };
+}
+export {
+  MCPActionContext,
+  MCPActionProvider,
+  useMCPAction,
+  useMCPActionSafe
+};
+//# sourceMappingURL=MCPActionContext.js.map

package/dist/context/MCPActionContext.js.map

@@ -0,0 +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  const [spaceIds, setSpaceIds] = createSignal<string[]>(props.spaceIds || [])\n  const [macroId, setMacroId] = createSignal<string | undefined>(props.macroId)\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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"}

package/dist/context/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP UI Solid - Context Providers
+ *
+ * Context providers for action execution and state management
+ */
+export { MCPActionProvider, MCPActionContext, useMCPAction, useMCPActionSafe, } from './MCPActionContext';
+export type { MCPActionContextValue, MCPActionProviderProps, ActionRequest, ActionResult, } from './MCPActionContext';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,GACjB,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,YAAY,GACb,MAAM,oBAAoB,CAAA"}

package/dist/hooks/index.d.ts

@@ -5,4 +5,6 @@
  */
 export { useStreamingUI } from './useStreamingUI';
 export type { UseStreamingUIOptions, StreamingUIState, StreamProgress, StreamError, CompleteMetadata, } from './useStreamingUI';
+export { useAction, useToolAction } from './useAction';
+export type { UseActionReturn, ActionRequest, ActionResult } from './useAction';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACtD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/dist/hooks/useAction.cjs

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const solidJs = require("solid-js");
+const MCPActionContext = require("../context/MCPActionContext.cjs");
+function useAction() {
+  const context = MCPActionContext.useMCPActionSafe();
+  const [lastError, setLastError] = solidJs.createSignal();
+  const execute = async (toolName, params) => {
+    setLastError(void 0);
+    const result = await context.executeAction({
+      toolName,
+      params
+    });
+    if (!result.success && result.error) {
+      setLastError(result.error);
+    }
+    return result;
+  };
+  const executeAction = async (request) => {
+    setLastError(void 0);
+    const result = await context.executeAction(request);
+    if (!result.success && result.error) {
+      setLastError(result.error);
+    }
+    return result;
+  };
+  return {
+    execute,
+    executeAction,
+    isExecuting: context.isExecuting,
+    lastResult: context.lastResult,
+    lastError
+  };
+}
+function useToolAction(toolName) {
+  const { execute: baseExecute, isExecuting, lastResult, lastError } = useAction();
+  const execute = async (params) => {
+    return baseExecute(toolName, params);
+  };
+  return {
+    execute,
+    isExecuting,
+    lastResult,
+    lastError
+  };
+}
+exports.useAction = useAction;
+exports.useToolAction = useToolAction;
+//# sourceMappingURL=useAction.cjs.map

package/dist/hooks/useAction.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAction.cjs","sources":["../../src/hooks/useAction.ts"],"sourcesContent":["/**\n * useAction - Hook for executing MCP actions from components\n * Phase 5.0: Quick Wins - Simplified API for ActionRenderer and custom components\n */\n\nimport { createSignal, Accessor } from 'solid-js'\nimport { useMCPActionSafe, ActionRequest, ActionResult } from '../context/MCPActionContext'\n\n/**\n * Return type for useAction hook\n */\nexport interface UseActionReturn {\n  /**\n   * Execute a tool action\n   */\n  execute: (toolName: string, params?: Record<string, any>) => Promise<ActionResult>\n\n  /**\n   * Full execute with ActionRequest\n   */\n  executeAction: (request: ActionRequest) => Promise<ActionResult>\n\n  /**\n   * Whether an action is currently executing\n   */\n  isExecuting: Accessor<boolean>\n\n  /**\n   * Last result from action execution\n   */\n  lastResult: Accessor<ActionResult | undefined>\n\n  /**\n   * Last error (if any)\n   */\n  lastError: Accessor<string | undefined>\n}\n\n/**\n * Hook for executing MCP actions\n *\n * @example\n * ```tsx\n * function MyButton() {\n *   const { execute, isExecuting, lastError } = useAction()\n *\n *   const handleClick = async () => {\n *     const result = await execute('search.hub', { query: 'test' })\n *     if (result.success) {\n *       console.log('Data:', result.data)\n *     }\n *   }\n *\n *   return (\n *     <button onClick={handleClick} disabled={isExecuting()}>\n *       {isExecuting() ? 'Loading...' : 'Search'}\n *     </button>\n *   )\n * }\n * ```\n */\nexport function useAction(): UseActionReturn {\n  const context = useMCPActionSafe()\n  const [lastError, setLastError] = createSignal<string>()\n\n  const execute = async (toolName: string, params?: Record<string, any>): Promise<ActionResult> => {\n    setLastError(undefined)\n\n    const result = await context.executeAction({\n      toolName,\n      params,\n    })\n\n    if (!result.success && result.error) {\n      setLastError(result.error)\n    }\n\n    return result\n  }\n\n  const executeAction = async (request: ActionRequest): Promise<ActionResult> => {\n    setLastError(undefined)\n\n    const result = await context.executeAction(request)\n\n    if (!result.success && result.error) {\n      setLastError(result.error)\n    }\n\n    return result\n  }\n\n  return {\n    execute,\n    executeAction,\n    isExecuting: context.isExecuting,\n    lastResult: context.lastResult,\n    lastError,\n  }\n}\n\n/**\n * Hook for binding action to a specific tool\n *\n * @example\n * ```tsx\n * function SearchButton() {\n *   const { execute, isExecuting } = useToolAction('search.hub')\n *\n *   return (\n *     <button onClick={() => execute({ query: 'test' })} disabled={isExecuting()}>\n *       Search\n *     </button>\n *   )\n * }\n * ```\n */\nexport function useToolAction(toolName: string): {\n  execute: (params?: Record<string, any>) => Promise<ActionResult>\n  isExecuting: Accessor<boolean>\n  lastResult: Accessor<ActionResult | undefined>\n  lastError: Accessor<string | undefined>\n} {\n  const { execute: baseExecute, isExecuting, lastResult, lastError } = useAction()\n\n  const execute = async (params?: Record<string, any>): Promise<ActionResult> => {\n    return baseExecute(toolName, params)\n  }\n\n  return {\n    execute,\n    isExecuting,\n    lastResult,\n    lastError,\n  }\n}\n\nexport type { ActionRequest, ActionResult }\n"],"names":["useMCPActionSafe","createSignal"],"mappings":";;;;AA6DO,SAAS,YAA6B;AAC3C,QAAM,UAAUA,iBAAAA,iBAAA;AAChB,QAAM,CAAC,WAAW,YAAY,IAAIC,qBAAA;AAElC,QAAM,UAAU,OAAO,UAAkB,WAAwD;AAC/F,iBAAa,MAAS;AAEtB,UAAM,SAAS,MAAM,QAAQ,cAAc;AAAA,MACzC;AAAA,MACA;AAAA,IAAA,CACD;AAED,QAAI,CAAC,OAAO,WAAW,OAAO,OAAO;AACnC,mBAAa,OAAO,KAAK;AAAA,IAC3B;AAEA,WAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,OAAO,YAAkD;AAC7E,iBAAa,MAAS;AAEtB,UAAM,SAAS,MAAM,QAAQ,cAAc,OAAO;AAElD,QAAI,CAAC,OAAO,WAAW,OAAO,OAAO;AACnC,mBAAa,OAAO,KAAK;AAAA,IAC3B;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,aAAa,QAAQ;AAAA,IACrB,YAAY,QAAQ;AAAA,IACpB;AAAA,EAAA;AAEJ;AAkBO,SAAS,cAAc,UAK5B;AACA,QAAM,EAAE,SAAS,aAAa,aAAa,YAAY,UAAA,IAAc,UAAA;AAErE,QAAM,UAAU,OAAO,WAAwD;AAC7E,WAAO,YAAY,UAAU,MAAM;AAAA,EACrC;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;;;"}