@mastra/react 1.8.0-alpha.8 → 1.9.0-alpha.0

package/dist/chat/index.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_hooks = require("../hooks-CMjizg6y.cjs");
+const require_hooks = require("../hooks-DeaoDYVv.cjs");
 exports.useChat = require_hooks.useChat;

package/dist/chat/index.js

@@ -1,2 +1,2 @@
-import { t as useChat } from "../hooks-BFQK_s4g.js";
+import { t as useChat } from "../hooks-s61OBZ5M.js";
 export { useChat };

package/dist/hooks/capabilities/index.cjs

@@ -27,6 +27,20 @@ const useTraceQueryAvailable = () => {
 	};
 };
 //#endregion
+//#region src/hooks/capabilities/use-trace-query-discovery-available.ts
+/**
+* Whether the store supports trace query field/value discovery. Callers combine it with
+* `useTraceQueryAvailable` when they also need the trace query API. `enabled` stays false
+* while capabilities load; servers without the capabilities endpoint fall back to `true`.
+*/
+const useTraceQueryDiscoveryAvailable = () => {
+	const { data, isLoading } = useObservabilityCapabilities();
+	return {
+		isLoading,
+		enabled: !isLoading && (data?.capabilities.traceQueryDiscovery ?? true)
+	};
+};
+//#endregion
 //#region src/hooks/capabilities/use-feedback-available.ts
 /**
 * `enabled` stays false while capabilities load. Servers without the
@@ -43,5 +57,6 @@ const useFeedbackAvailable = () => {
 exports.useFeedbackAvailable = useFeedbackAvailable;
 exports.useObservabilityCapabilities = useObservabilityCapabilities;
 exports.useTraceQueryAvailable = useTraceQueryAvailable;
+exports.useTraceQueryDiscoveryAvailable = useTraceQueryDiscoveryAvailable;
 
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/capabilities/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["useMastraClient"],"sources":["../../../src/hooks/capabilities/use-observability-capabilities.ts","../../../src/hooks/capabilities/use-trace-query-available.ts","../../../src/hooks/capabilities/use-feedback-available.ts"],"sourcesContent":["import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nconst OBSERVABILITY_CAPABILITIES_STALE_TIME = 24 * 60 * 60 * 1000;\n\ntype ObservabilityCapabilitiesResponse = Awaited<ReturnType<MastraClient['getObservabilityCapabilities']>>;\n\nexport const useObservabilityCapabilities = <TData = ObservabilityCapabilitiesResponse>({\n  queryOptions,\n}: { queryOptions?: MastraQueryOptions<ObservabilityCapabilitiesResponse, TData> } = {}): UseQueryResult<\n  TData,\n  Error\n> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['observability-capabilities'],\n    queryFn: () => client.getObservabilityCapabilities(),\n    retry: false,\n    staleTime: OBSERVABILITY_CAPABILITIES_STALE_TIME,\n    ...queryOptions,\n  });\n};\n","import { useObservabilityCapabilities } from './use-observability-capabilities';\n\n/**\n * `enabled` stays false while capabilities load. Servers without the\n * capabilities endpoint fall back to `true` (trace query was the default before).\n */\nexport const useTraceQueryAvailable = (): { isLoading: boolean; enabled: boolean } => {\n  const { data, isLoading } = useObservabilityCapabilities();\n\n  return {\n    isLoading,\n    enabled: !isLoading && (data?.capabilities.traceQuery ?? true),\n  };\n};\n","import { useObservabilityCapabilities } from './use-observability-capabilities';\n\n/**\n * `enabled` stays false while capabilities load. Servers without the\n * capabilities endpoint fall back to `true` (feedback was shown by default before).\n */\nexport const useFeedbackAvailable = (): { isLoading: boolean; enabled: boolean } => {\n  const { data, isLoading } = useObservabilityCapabilities();\n\n  return {\n    isLoading,\n    enabled: !isLoading && (data?.capabilities.feedback ?? true),\n  };\n};\n"],"mappings":";;;;AAMA,MAAM,wCAAwC,OAAU,KAAK;AAI7D,MAAa,gCAA2E,EACtF,iBACmF,CAAC,MAGjF;CACH,MAAM,SAASA,8BAAAA,gBAAgB;CAE/B,QAAA,GAAA,sBAAA,SAAA,CAAgB;EACd,UAAU,CAAC,4BAA4B;EACvC,eAAe,OAAO,6BAA6B;EACnD,OAAO;EACP,WAAW;EACX,GAAG;CACL,CAAC;AACH;;;;;;;ACnBA,MAAa,+BAAyE;CACpF,MAAM,EAAE,MAAM,cAAc,6BAA6B;CAEzD,OAAO;EACL;EACA,SAAS,CAAC,cAAc,MAAM,aAAa,cAAc;CAC3D;AACF;;;;;;;ACPA,MAAa,6BAAuE;CAClF,MAAM,EAAE,MAAM,cAAc,6BAA6B;CAEzD,OAAO;EACL;EACA,SAAS,CAAC,cAAc,MAAM,aAAa,YAAY;CACzD;AACF"}
+{"version":3,"file":"index.cjs","names":["useMastraClient"],"sources":["../../../src/hooks/capabilities/use-observability-capabilities.ts","../../../src/hooks/capabilities/use-trace-query-available.ts","../../../src/hooks/capabilities/use-trace-query-discovery-available.ts","../../../src/hooks/capabilities/use-feedback-available.ts"],"sourcesContent":["import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nconst OBSERVABILITY_CAPABILITIES_STALE_TIME = 24 * 60 * 60 * 1000;\n\ntype ObservabilityCapabilitiesResponse = Awaited<ReturnType<MastraClient['getObservabilityCapabilities']>>;\n\nexport const useObservabilityCapabilities = <TData = ObservabilityCapabilitiesResponse>({\n  queryOptions,\n}: { queryOptions?: MastraQueryOptions<ObservabilityCapabilitiesResponse, TData> } = {}): UseQueryResult<\n  TData,\n  Error\n> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['observability-capabilities'],\n    queryFn: () => client.getObservabilityCapabilities(),\n    retry: false,\n    staleTime: OBSERVABILITY_CAPABILITIES_STALE_TIME,\n    ...queryOptions,\n  });\n};\n","import { useObservabilityCapabilities } from './use-observability-capabilities';\n\n/**\n * `enabled` stays false while capabilities load. Servers without the\n * capabilities endpoint fall back to `true` (trace query was the default before).\n */\nexport const useTraceQueryAvailable = (): { isLoading: boolean; enabled: boolean } => {\n  const { data, isLoading } = useObservabilityCapabilities();\n\n  return {\n    isLoading,\n    enabled: !isLoading && (data?.capabilities.traceQuery ?? true),\n  };\n};\n","import { useObservabilityCapabilities } from './use-observability-capabilities';\n\n/**\n * Whether the store supports trace query field/value discovery. Callers combine it with\n * `useTraceQueryAvailable` when they also need the trace query API. `enabled` stays false\n * while capabilities load; servers without the capabilities endpoint fall back to `true`.\n */\nexport const useTraceQueryDiscoveryAvailable = (): { isLoading: boolean; enabled: boolean } => {\n  const { data, isLoading } = useObservabilityCapabilities();\n\n  return {\n    isLoading,\n    enabled: !isLoading && (data?.capabilities.traceQueryDiscovery ?? true),\n  };\n};\n","import { useObservabilityCapabilities } from './use-observability-capabilities';\n\n/**\n * `enabled` stays false while capabilities load. Servers without the\n * capabilities endpoint fall back to `true` (feedback was shown by default before).\n */\nexport const useFeedbackAvailable = (): { isLoading: boolean; enabled: boolean } => {\n  const { data, isLoading } = useObservabilityCapabilities();\n\n  return {\n    isLoading,\n    enabled: !isLoading && (data?.capabilities.feedback ?? true),\n  };\n};\n"],"mappings":";;;;AAMA,MAAM,wCAAwC,OAAU,KAAK;AAI7D,MAAa,gCAA2E,EACtF,iBACmF,CAAC,MAGjF;CACH,MAAM,SAASA,8BAAAA,gBAAgB;CAE/B,QAAA,GAAA,sBAAA,SAAA,CAAgB;EACd,UAAU,CAAC,4BAA4B;EACvC,eAAe,OAAO,6BAA6B;EACnD,OAAO;EACP,WAAW;EACX,GAAG;CACL,CAAC;AACH;;;;;;;ACnBA,MAAa,+BAAyE;CACpF,MAAM,EAAE,MAAM,cAAc,6BAA6B;CAEzD,OAAO;EACL;EACA,SAAS,CAAC,cAAc,MAAM,aAAa,cAAc;CAC3D;AACF;;;;;;;;ACNA,MAAa,wCAAkF;CAC7F,MAAM,EAAE,MAAM,cAAc,6BAA6B;CAEzD,OAAO;EACL;EACA,SAAS,CAAC,cAAc,MAAM,aAAa,uBAAuB;CACpE;AACF;;;;;;;ACRA,MAAa,6BAAuE;CAClF,MAAM,EAAE,MAAM,cAAc,6BAA6B;CAEzD,OAAO;EACL;EACA,SAAS,CAAC,cAAc,MAAM,aAAa,YAAY;CACzD;AACF"}

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

@@ -1,4 +1,5 @@
 export * from './use-observability-capabilities.js';
 export * from './use-trace-query-available.js';
+export * from './use-trace-query-discovery-available.js';
 export * from './use-feedback-available.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/capabilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/capabilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC"}

package/dist/hooks/capabilities/index.js

@@ -26,6 +26,20 @@ const useTraceQueryAvailable = () => {
 	};
 };
 //#endregion
+//#region src/hooks/capabilities/use-trace-query-discovery-available.ts
+/**
+* Whether the store supports trace query field/value discovery. Callers combine it with
+* `useTraceQueryAvailable` when they also need the trace query API. `enabled` stays false
+* while capabilities load; servers without the capabilities endpoint fall back to `true`.
+*/
+const useTraceQueryDiscoveryAvailable = () => {
+	const { data, isLoading } = useObservabilityCapabilities();
+	return {
+		isLoading,
+		enabled: !isLoading && (data?.capabilities.traceQueryDiscovery ?? true)
+	};
+};
+//#endregion
 //#region src/hooks/capabilities/use-feedback-available.ts
 /**
 * `enabled` stays false while capabilities load. Servers without the
@@ -39,6 +53,6 @@ const useFeedbackAvailable = () => {
 	};
 };
 //#endregion
-export { useFeedbackAvailable, useObservabilityCapabilities, useTraceQueryAvailable };
+export { useFeedbackAvailable, useObservabilityCapabilities, useTraceQueryAvailable, useTraceQueryDiscoveryAvailable };
 
 //# sourceMappingURL=index.js.map

package/dist/hooks/capabilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/capabilities/use-observability-capabilities.ts","../../../src/hooks/capabilities/use-trace-query-available.ts","../../../src/hooks/capabilities/use-feedback-available.ts"],"sourcesContent":["import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nconst OBSERVABILITY_CAPABILITIES_STALE_TIME = 24 * 60 * 60 * 1000;\n\ntype ObservabilityCapabilitiesResponse = Awaited<ReturnType<MastraClient['getObservabilityCapabilities']>>;\n\nexport const useObservabilityCapabilities = <TData = ObservabilityCapabilitiesResponse>({\n  queryOptions,\n}: { queryOptions?: MastraQueryOptions<ObservabilityCapabilitiesResponse, TData> } = {}): UseQueryResult<\n  TData,\n  Error\n> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['observability-capabilities'],\n    queryFn: () => client.getObservabilityCapabilities(),\n    retry: false,\n    staleTime: OBSERVABILITY_CAPABILITIES_STALE_TIME,\n    ...queryOptions,\n  });\n};\n","import { useObservabilityCapabilities } from './use-observability-capabilities';\n\n/**\n * `enabled` stays false while capabilities load. Servers without the\n * capabilities endpoint fall back to `true` (trace query was the default before).\n */\nexport const useTraceQueryAvailable = (): { isLoading: boolean; enabled: boolean } => {\n  const { data, isLoading } = useObservabilityCapabilities();\n\n  return {\n    isLoading,\n    enabled: !isLoading && (data?.capabilities.traceQuery ?? true),\n  };\n};\n","import { useObservabilityCapabilities } from './use-observability-capabilities';\n\n/**\n * `enabled` stays false while capabilities load. Servers without the\n * capabilities endpoint fall back to `true` (feedback was shown by default before).\n */\nexport const useFeedbackAvailable = (): { isLoading: boolean; enabled: boolean } => {\n  const { data, isLoading } = useObservabilityCapabilities();\n\n  return {\n    isLoading,\n    enabled: !isLoading && (data?.capabilities.feedback ?? true),\n  };\n};\n"],"mappings":";;;AAMA,MAAM,wCAAwC,OAAU,KAAK;AAI7D,MAAa,gCAA2E,EACtF,iBACmF,CAAC,MAGjF;CACH,MAAM,SAAS,gBAAgB;CAE/B,OAAO,SAAS;EACd,UAAU,CAAC,4BAA4B;EACvC,eAAe,OAAO,6BAA6B;EACnD,OAAO;EACP,WAAW;EACX,GAAG;CACL,CAAC;AACH;;;;;;;ACnBA,MAAa,+BAAyE;CACpF,MAAM,EAAE,MAAM,cAAc,6BAA6B;CAEzD,OAAO;EACL;EACA,SAAS,CAAC,cAAc,MAAM,aAAa,cAAc;CAC3D;AACF;;;;;;;ACPA,MAAa,6BAAuE;CAClF,MAAM,EAAE,MAAM,cAAc,6BAA6B;CAEzD,OAAO;EACL;EACA,SAAS,CAAC,cAAc,MAAM,aAAa,YAAY;CACzD;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/capabilities/use-observability-capabilities.ts","../../../src/hooks/capabilities/use-trace-query-available.ts","../../../src/hooks/capabilities/use-trace-query-discovery-available.ts","../../../src/hooks/capabilities/use-feedback-available.ts"],"sourcesContent":["import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nconst OBSERVABILITY_CAPABILITIES_STALE_TIME = 24 * 60 * 60 * 1000;\n\ntype ObservabilityCapabilitiesResponse = Awaited<ReturnType<MastraClient['getObservabilityCapabilities']>>;\n\nexport const useObservabilityCapabilities = <TData = ObservabilityCapabilitiesResponse>({\n  queryOptions,\n}: { queryOptions?: MastraQueryOptions<ObservabilityCapabilitiesResponse, TData> } = {}): UseQueryResult<\n  TData,\n  Error\n> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['observability-capabilities'],\n    queryFn: () => client.getObservabilityCapabilities(),\n    retry: false,\n    staleTime: OBSERVABILITY_CAPABILITIES_STALE_TIME,\n    ...queryOptions,\n  });\n};\n","import { useObservabilityCapabilities } from './use-observability-capabilities';\n\n/**\n * `enabled` stays false while capabilities load. Servers without the\n * capabilities endpoint fall back to `true` (trace query was the default before).\n */\nexport const useTraceQueryAvailable = (): { isLoading: boolean; enabled: boolean } => {\n  const { data, isLoading } = useObservabilityCapabilities();\n\n  return {\n    isLoading,\n    enabled: !isLoading && (data?.capabilities.traceQuery ?? true),\n  };\n};\n","import { useObservabilityCapabilities } from './use-observability-capabilities';\n\n/**\n * Whether the store supports trace query field/value discovery. Callers combine it with\n * `useTraceQueryAvailable` when they also need the trace query API. `enabled` stays false\n * while capabilities load; servers without the capabilities endpoint fall back to `true`.\n */\nexport const useTraceQueryDiscoveryAvailable = (): { isLoading: boolean; enabled: boolean } => {\n  const { data, isLoading } = useObservabilityCapabilities();\n\n  return {\n    isLoading,\n    enabled: !isLoading && (data?.capabilities.traceQueryDiscovery ?? true),\n  };\n};\n","import { useObservabilityCapabilities } from './use-observability-capabilities';\n\n/**\n * `enabled` stays false while capabilities load. Servers without the\n * capabilities endpoint fall back to `true` (feedback was shown by default before).\n */\nexport const useFeedbackAvailable = (): { isLoading: boolean; enabled: boolean } => {\n  const { data, isLoading } = useObservabilityCapabilities();\n\n  return {\n    isLoading,\n    enabled: !isLoading && (data?.capabilities.feedback ?? true),\n  };\n};\n"],"mappings":";;;AAMA,MAAM,wCAAwC,OAAU,KAAK;AAI7D,MAAa,gCAA2E,EACtF,iBACmF,CAAC,MAGjF;CACH,MAAM,SAAS,gBAAgB;CAE/B,OAAO,SAAS;EACd,UAAU,CAAC,4BAA4B;EACvC,eAAe,OAAO,6BAA6B;EACnD,OAAO;EACP,WAAW;EACX,GAAG;CACL,CAAC;AACH;;;;;;;ACnBA,MAAa,+BAAyE;CACpF,MAAM,EAAE,MAAM,cAAc,6BAA6B;CAEzD,OAAO;EACL;EACA,SAAS,CAAC,cAAc,MAAM,aAAa,cAAc;CAC3D;AACF;;;;;;;;ACNA,MAAa,wCAAkF;CAC7F,MAAM,EAAE,MAAM,cAAc,6BAA6B;CAEzD,OAAO;EACL;EACA,SAAS,CAAC,cAAc,MAAM,aAAa,uBAAuB;CACpE;AACF;;;;;;;ACRA,MAAa,6BAAuE;CAClF,MAAM,EAAE,MAAM,cAAc,6BAA6B;CAEzD,OAAO;EACL;EACA,SAAS,CAAC,cAAc,MAAM,aAAa,YAAY;CACzD;AACF"}

package/dist/hooks/capabilities/use-trace-query-discovery-available.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Whether the store supports trace query field/value discovery. Callers combine it with
+ * `useTraceQueryAvailable` when they also need the trace query API. `enabled` stays false
+ * while capabilities load; servers without the capabilities endpoint fall back to `true`.
+ */
+export declare const useTraceQueryDiscoveryAvailable: () => {
+    isLoading: boolean;
+    enabled: boolean;
+};
+//# sourceMappingURL=use-trace-query-discovery-available.d.ts.map

package/dist/hooks/capabilities/use-trace-query-discovery-available.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trace-query-discovery-available.d.ts","sourceRoot":"","sources":["../../../src/hooks/capabilities/use-trace-query-discovery-available.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,QAAO;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAOxF,CAAC"}

package/dist/hooks/mcps/index.cjs

@@ -1,6 +1,28 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_mastra_client_context = require("../../mastra-client-context-DzX3f0RF.cjs");
 let _tanstack_react_query = require("@tanstack/react-query");
+//#region src/hooks/mcps/use-mcp-app-html.ts
+/**
+* The HTML of an MCP tool's `ui://` app resource (from the tool's `_meta`), for rendering the tool's own UI.
+* Skips the fetch when the tool has no app resource.
+*/
+const useMcpAppHtml = ({ serverId, appResourceUri, queryOptions }) => {
+	const client = require_mastra_client_context.useMastraClient();
+	return (0, _tanstack_react_query.useQuery)({
+		queryKey: [
+			"mcp-app-resource",
+			serverId,
+			appResourceUri
+		],
+		queryFn: async () => {
+			if (!appResourceUri) return null;
+			return (await client.readMcpServerResource(serverId, appResourceUri)).contents[0]?.text ?? null;
+		},
+		enabled: appResourceUri !== void 0,
+		...queryOptions
+	});
+};
+//#endregion
 //#region src/hooks/mcps/use-mcp-app-tools.ts
 /**
 * Builds a map of tool names → MCP App info for tools across all registered
@@ -209,6 +231,7 @@ exports.useMCPServerTool = useMCPServerTool;
 exports.useMCPServerTools = useMCPServerTools;
 exports.useMCPServerToolsById = useMCPServerToolsById;
 exports.useMCPServers = useMCPServers;
+exports.useMcpAppHtml = useMcpAppHtml;
 exports.useMcpAppTools = useMcpAppTools;
 exports.useTryConnectMcp = useTryConnectMcp;
 

package/dist/hooks/mcps/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["useMastraClient","useMastraClient","useMastraClient","useMastraClient","useMastraClient","useMastraClient"],"sources":["../../../src/hooks/mcps/use-mcp-app-tools.ts","../../../src/hooks/mcps/use-mcp-server-tool.ts","../../../src/hooks/mcps/use-mcp-server-tools.ts","../../../src/hooks/mcps/use-mcp-server-tools-by-id.ts","../../../src/hooks/mcps/use-mcp-servers.ts","../../../src/hooks/mcps/use-try-connect-mcp.ts"],"sourcesContent":["import type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport interface McpAppToolInfo {\n  serverId: string;\n  toolId: string;\n  toolName: string;\n  resourceUri: string;\n}\n\n/**\n * Builds a map of tool names → MCP App info for tools across all registered\n * MCP servers that have `_meta.ui.resourceUri` (i.e., tools with interactive\n * MCP App UIs).\n *\n * For each app tool, entries are created under both the original tool name\n * and the namespaced name (`${serverId}_${toolName}`) so that agent tools\n * sourced via `MCPClient.listTools()` (which namespaces) can be resolved.\n */\nexport function useMcpAppTools<TData = Record<string, McpAppToolInfo>>({\n  queryOptions,\n}: { queryOptions?: MastraQueryOptions<Record<string, McpAppToolInfo>, TData> } = {}): UseQueryResult<TData, Error> {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-app-tools'],\n    queryFn: async () => {\n      const map: Record<string, McpAppToolInfo> = {};\n\n      const { servers } = await client.getMcpServers();\n      if (!servers?.length) return map;\n\n      const results = await Promise.allSettled(\n        servers.map(async server => {\n          const { tools } = await client.getMcpServerTools(server.id);\n          return { serverId: server.id, tools };\n        }),\n      );\n\n      for (const result of results) {\n        if (result.status !== 'fulfilled') continue;\n        const { serverId, tools } = result.value;\n        for (const tool of tools) {\n          const meta = tool._meta as { ui?: { resourceUri?: string } } | undefined;\n          const resourceUri = meta?.ui?.resourceUri;\n          if (resourceUri) {\n            const toolId = tool.name;\n            const info: McpAppToolInfo = { serverId, toolId, toolName: tool.name, resourceUri };\n            map[toolId] = info;\n            if (tool.name !== toolId) {\n              map[tool.name] = info;\n            }\n            // Also map the namespaced name used by MCPClient.listTools()\n            map[`${serverId}_${tool.name}`] = info;\n          }\n        }\n      }\n\n      return map;\n    },\n    staleTime: 60_000,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n}\n","import type { MastraClient } from '@mastra/client-js';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport { useMutation, useQuery } from '@tanstack/react-query';\nimport type { UseMutationResult, UseQueryResult } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions, MastraQueryOptions } from '../shared/query-options';\n\ntype MCPServerToolDetails = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['details']>>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useMCPServerTool = <TData = MCPServerToolDetails>({\n  serverId,\n  toolId,\n  requestContext,\n  queryOptions,\n}: {\n  serverId: string;\n  toolId: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<MCPServerToolDetails, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-server-tool', serverId, toolId],\n    queryFn: () => {\n      const instance = client.getMcpServerTool(serverId, toolId);\n      return instance.details(requestContext);\n    },\n    ...queryOptions,\n  });\n};\n\nexport type ExecuteMCPToolResponse = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['execute']>>;\ntype ExecuteMCPToolVariables = { data: any; requestContext?: Record<string, any> };\n\nexport const useExecuteMCPTool = ({\n  serverId,\n  toolId,\n  queryOptions,\n}: {\n  serverId: string;\n  toolId: string;\n  queryOptions?: MastraMutationOptions<ExecuteMCPToolResponse, ExecuteMCPToolVariables>;\n}): UseMutationResult<ExecuteMCPToolResponse, Error, ExecuteMCPToolVariables> => {\n  const client = useMastraClient();\n\n  return useMutation({\n    mutationFn: ({ data, requestContext }: ExecuteMCPToolVariables) => {\n      const instance = client.getMcpServerTool(serverId, toolId);\n      return instance.execute({ data, requestContext: requestContext as RequestContext });\n    },\n    ...queryOptions,\n  });\n};\n","import type { McpToolInfo as SdkMcpToolInfo } from '@mastra/client-js';\nimport type { ServerInfo } from '@mastra/core/mcp';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport const useMCPServerTools = <TData = Record<string, SdkMcpToolInfo>>({\n  selectedServer,\n  queryOptions,\n}: {\n  selectedServer: ServerInfo;\n  queryOptions?: MastraQueryOptions<Record<string, SdkMcpToolInfo>, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcpserver-tools', selectedServer?.id],\n    queryFn: async () => {\n      const response = await client.getMcpServerTools(selectedServer?.id);\n      const fetchedToolsArray: SdkMcpToolInfo[] = response.tools;\n      const transformedTools: Record<string, SdkMcpToolInfo> = {};\n      fetchedToolsArray.forEach((sdkToolInfo: SdkMcpToolInfo) => {\n        transformedTools[sdkToolInfo.name] = sdkToolInfo;\n      });\n\n      return transformedTools;\n    },\n    retry: false,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n};\n","import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\ntype MCPServerToolsById = Record<string, Awaited<ReturnType<MastraClient['getMcpServerTools']>>['tools'][number]>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useMCPServerToolsById = <TData = MCPServerToolsById>({\n  serverId,\n  queryOptions,\n}: {\n  serverId: string | null;\n  queryOptions?: MastraQueryOptions<MCPServerToolsById, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcpserver-tools', serverId],\n    queryFn: async (): Promise<MCPServerToolsById> => {\n      const response = await client.getMcpServerTools(serverId!);\n      return Object.fromEntries(response.tools.map(tool => [tool.name, tool]));\n    },\n    retry: false,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n};\n","import type { McpServerListResponse } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport const useMCPServers = <TData = McpServerListResponse['servers']>({\n  requestContext,\n  queryOptions,\n}: {\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<McpServerListResponse['servers'], TData>;\n} = {}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-servers'],\n    queryFn: async () => {\n      const mcpServers: McpServerListResponse['servers'] = (await client.getMcpServers(requestContext)).servers;\n      return mcpServers;\n    },\n    ...queryOptions,\n  });\n};\n","import { useMutation } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions } from '../shared/query-options';\n\ninterface McpTool {\n  name: string;\n  description?: string;\n  inputSchema?: Record<string, unknown>;\n}\n\nexport interface TryConnectResult {\n  tools: McpTool[];\n}\n\nasync function parseResponse(response: Response): Promise<unknown> {\n  const contentType = response.headers.get('content-type') ?? '';\n\n  if (contentType.includes('text/event-stream')) {\n    const text = await response.text();\n    const lines = text.split('\\n');\n\n    for (const line of lines) {\n      if (line.startsWith('data:')) {\n        const data = line.slice('data:'.length).trim();\n        if (data) {\n          return JSON.parse(data);\n        }\n      }\n    }\n\n    throw new Error('No data found in SSE response');\n  }\n\n  return response.json();\n}\n\nasync function connectAndListTools(url: string, clientHeaders?: Record<string, string>): Promise<TryConnectResult> {\n  const baseHeaders: Record<string, string> = {\n    ...clientHeaders,\n    'Content-Type': 'application/json',\n    Accept: 'application/json, text/event-stream',\n  };\n\n  // Step 1: Initialize\n  const initResponse = await fetch(url, {\n    method: 'POST',\n    headers: baseHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: '2025-03-26',\n        capabilities: {},\n        clientInfo: { name: 'mastra-playground', version: '1.0.0' },\n      },\n    }),\n  });\n\n  if (!initResponse.ok) {\n    throw new Error(`Initialize failed: ${initResponse.status} ${initResponse.statusText}`);\n  }\n\n  const sessionId = initResponse.headers.get('Mcp-Session-Id');\n  await parseResponse(initResponse);\n\n  const sessionHeaders: Record<string, string> = {\n    ...baseHeaders,\n  };\n  if (sessionId) {\n    sessionHeaders['Mcp-Session-Id'] = sessionId;\n  }\n\n  // Step 2: Send initialized notification\n  await fetch(url, {\n    method: 'POST',\n    headers: sessionHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      method: 'notifications/initialized',\n    }),\n  });\n\n  // Step 3: List tools\n  const toolsResponse = await fetch(url, {\n    method: 'POST',\n    headers: sessionHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 2,\n      method: 'tools/list',\n    }),\n  });\n\n  if (!toolsResponse.ok) {\n    throw new Error(`tools/list failed: ${toolsResponse.status} ${toolsResponse.statusText}`);\n  }\n\n  const toolsResult = (await parseResponse(toolsResponse)) as { result?: { tools?: McpTool[] } };\n\n  return {\n    tools: toolsResult.result?.tools ?? [],\n  };\n}\n\nexport const useTryConnectMcp = ({\n  queryOptions,\n}: { queryOptions?: MastraMutationOptions<TryConnectResult, string> } = {}) => {\n  const client = useMastraClient();\n  const clientHeaders = (client.options?.headers as Record<string, string>) ?? {};\n\n  return useMutation({\n    mutationFn: (url: string) => connectAndListTools(url, clientHeaders),\n    ...queryOptions,\n  });\n};\n\nexport type TryConnectMcpMutation = ReturnType<typeof useTryConnectMcp>;\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["useMastraClient","useMastraClient","useMastraClient","useMastraClient","useMastraClient","useMastraClient","useMastraClient"],"sources":["../../../src/hooks/mcps/use-mcp-app-html.ts","../../../src/hooks/mcps/use-mcp-app-tools.ts","../../../src/hooks/mcps/use-mcp-server-tool.ts","../../../src/hooks/mcps/use-mcp-server-tools.ts","../../../src/hooks/mcps/use-mcp-server-tools-by-id.ts","../../../src/hooks/mcps/use-mcp-servers.ts","../../../src/hooks/mcps/use-try-connect-mcp.ts"],"sourcesContent":["import type { MastraClient } from '@mastra/client-js';\nimport { useQuery } from '@tanstack/react-query';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\n/** The app HTML, or `null` when the resource has no text. */\ntype McpAppHtml = string | null;\n\nexport type ReadMcpServerResourceResponse = Awaited<ReturnType<MastraClient['readMcpServerResource']>>;\n\n/**\n * The HTML of an MCP tool's `ui://` app resource (from the tool's `_meta`), for rendering the tool's own UI.\n * Skips the fetch when the tool has no app resource.\n */\nexport const useMcpAppHtml = <TData = McpAppHtml>({\n  serverId,\n  appResourceUri,\n  queryOptions,\n}: {\n  serverId: string;\n  appResourceUri?: string;\n  queryOptions?: MastraQueryOptions<McpAppHtml, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-app-resource', serverId, appResourceUri],\n    queryFn: async () => {\n      if (!appResourceUri) return null;\n      const response = await client.readMcpServerResource(serverId, appResourceUri);\n      return response.contents[0]?.text ?? null;\n    },\n    enabled: appResourceUri !== undefined,\n    ...queryOptions,\n  });\n};\n","import type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport interface McpAppToolInfo {\n  serverId: string;\n  toolId: string;\n  toolName: string;\n  resourceUri: string;\n}\n\n/**\n * Builds a map of tool names → MCP App info for tools across all registered\n * MCP servers that have `_meta.ui.resourceUri` (i.e., tools with interactive\n * MCP App UIs).\n *\n * For each app tool, entries are created under both the original tool name\n * and the namespaced name (`${serverId}_${toolName}`) so that agent tools\n * sourced via `MCPClient.listTools()` (which namespaces) can be resolved.\n */\nexport function useMcpAppTools<TData = Record<string, McpAppToolInfo>>({\n  queryOptions,\n}: { queryOptions?: MastraQueryOptions<Record<string, McpAppToolInfo>, TData> } = {}): UseQueryResult<TData, Error> {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-app-tools'],\n    queryFn: async () => {\n      const map: Record<string, McpAppToolInfo> = {};\n\n      const { servers } = await client.getMcpServers();\n      if (!servers?.length) return map;\n\n      const results = await Promise.allSettled(\n        servers.map(async server => {\n          const { tools } = await client.getMcpServerTools(server.id);\n          return { serverId: server.id, tools };\n        }),\n      );\n\n      for (const result of results) {\n        if (result.status !== 'fulfilled') continue;\n        const { serverId, tools } = result.value;\n        for (const tool of tools) {\n          const meta = tool._meta as { ui?: { resourceUri?: string } } | undefined;\n          const resourceUri = meta?.ui?.resourceUri;\n          if (resourceUri) {\n            const toolId = tool.name;\n            const info: McpAppToolInfo = { serverId, toolId, toolName: tool.name, resourceUri };\n            map[toolId] = info;\n            if (tool.name !== toolId) {\n              map[tool.name] = info;\n            }\n            // Also map the namespaced name used by MCPClient.listTools()\n            map[`${serverId}_${tool.name}`] = info;\n          }\n        }\n      }\n\n      return map;\n    },\n    staleTime: 60_000,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n}\n","import type { MastraClient } from '@mastra/client-js';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport { useMutation, useQuery } from '@tanstack/react-query';\nimport type { UseMutationResult, UseQueryResult } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions, MastraQueryOptions } from '../shared/query-options';\n\ntype MCPServerToolDetails = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['details']>>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useMCPServerTool = <TData = MCPServerToolDetails>({\n  serverId,\n  toolId,\n  requestContext,\n  queryOptions,\n}: {\n  serverId: string;\n  toolId: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<MCPServerToolDetails, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-server-tool', serverId, toolId],\n    queryFn: () => {\n      const instance = client.getMcpServerTool(serverId, toolId);\n      return instance.details(requestContext);\n    },\n    ...queryOptions,\n  });\n};\n\nexport type ExecuteMCPToolResponse = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['execute']>>;\ntype ExecuteMCPToolVariables = { data: any; requestContext?: Record<string, any> };\n\nexport const useExecuteMCPTool = ({\n  serverId,\n  toolId,\n  queryOptions,\n}: {\n  serverId: string;\n  toolId: string;\n  queryOptions?: MastraMutationOptions<ExecuteMCPToolResponse, ExecuteMCPToolVariables>;\n}): UseMutationResult<ExecuteMCPToolResponse, Error, ExecuteMCPToolVariables> => {\n  const client = useMastraClient();\n\n  return useMutation({\n    mutationFn: ({ data, requestContext }: ExecuteMCPToolVariables) => {\n      const instance = client.getMcpServerTool(serverId, toolId);\n      return instance.execute({ data, requestContext: requestContext as RequestContext });\n    },\n    ...queryOptions,\n  });\n};\n","import type { McpToolInfo as SdkMcpToolInfo } from '@mastra/client-js';\nimport type { ServerInfo } from '@mastra/core/mcp';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport const useMCPServerTools = <TData = Record<string, SdkMcpToolInfo>>({\n  selectedServer,\n  queryOptions,\n}: {\n  selectedServer: ServerInfo;\n  queryOptions?: MastraQueryOptions<Record<string, SdkMcpToolInfo>, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcpserver-tools', selectedServer?.id],\n    queryFn: async () => {\n      const response = await client.getMcpServerTools(selectedServer?.id);\n      const fetchedToolsArray: SdkMcpToolInfo[] = response.tools;\n      const transformedTools: Record<string, SdkMcpToolInfo> = {};\n      fetchedToolsArray.forEach((sdkToolInfo: SdkMcpToolInfo) => {\n        transformedTools[sdkToolInfo.name] = sdkToolInfo;\n      });\n\n      return transformedTools;\n    },\n    retry: false,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n};\n","import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\ntype MCPServerToolsById = Record<string, Awaited<ReturnType<MastraClient['getMcpServerTools']>>['tools'][number]>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useMCPServerToolsById = <TData = MCPServerToolsById>({\n  serverId,\n  queryOptions,\n}: {\n  serverId: string | null;\n  queryOptions?: MastraQueryOptions<MCPServerToolsById, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcpserver-tools', serverId],\n    queryFn: async (): Promise<MCPServerToolsById> => {\n      const response = await client.getMcpServerTools(serverId!);\n      return Object.fromEntries(response.tools.map(tool => [tool.name, tool]));\n    },\n    retry: false,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n};\n","import type { McpServerListResponse } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport const useMCPServers = <TData = McpServerListResponse['servers']>({\n  requestContext,\n  queryOptions,\n}: {\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<McpServerListResponse['servers'], TData>;\n} = {}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-servers'],\n    queryFn: async () => {\n      const mcpServers: McpServerListResponse['servers'] = (await client.getMcpServers(requestContext)).servers;\n      return mcpServers;\n    },\n    ...queryOptions,\n  });\n};\n","import { useMutation } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions } from '../shared/query-options';\n\ninterface McpTool {\n  name: string;\n  description?: string;\n  inputSchema?: Record<string, unknown>;\n}\n\nexport interface TryConnectResult {\n  tools: McpTool[];\n}\n\nasync function parseResponse(response: Response): Promise<unknown> {\n  const contentType = response.headers.get('content-type') ?? '';\n\n  if (contentType.includes('text/event-stream')) {\n    const text = await response.text();\n    const lines = text.split('\\n');\n\n    for (const line of lines) {\n      if (line.startsWith('data:')) {\n        const data = line.slice('data:'.length).trim();\n        if (data) {\n          return JSON.parse(data);\n        }\n      }\n    }\n\n    throw new Error('No data found in SSE response');\n  }\n\n  return response.json();\n}\n\nasync function connectAndListTools(url: string, clientHeaders?: Record<string, string>): Promise<TryConnectResult> {\n  const baseHeaders: Record<string, string> = {\n    ...clientHeaders,\n    'Content-Type': 'application/json',\n    Accept: 'application/json, text/event-stream',\n  };\n\n  // Step 1: Initialize\n  const initResponse = await fetch(url, {\n    method: 'POST',\n    headers: baseHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: '2025-03-26',\n        capabilities: {},\n        clientInfo: { name: 'mastra-playground', version: '1.0.0' },\n      },\n    }),\n  });\n\n  if (!initResponse.ok) {\n    throw new Error(`Initialize failed: ${initResponse.status} ${initResponse.statusText}`);\n  }\n\n  const sessionId = initResponse.headers.get('Mcp-Session-Id');\n  await parseResponse(initResponse);\n\n  const sessionHeaders: Record<string, string> = {\n    ...baseHeaders,\n  };\n  if (sessionId) {\n    sessionHeaders['Mcp-Session-Id'] = sessionId;\n  }\n\n  // Step 2: Send initialized notification\n  await fetch(url, {\n    method: 'POST',\n    headers: sessionHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      method: 'notifications/initialized',\n    }),\n  });\n\n  // Step 3: List tools\n  const toolsResponse = await fetch(url, {\n    method: 'POST',\n    headers: sessionHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 2,\n      method: 'tools/list',\n    }),\n  });\n\n  if (!toolsResponse.ok) {\n    throw new Error(`tools/list failed: ${toolsResponse.status} ${toolsResponse.statusText}`);\n  }\n\n  const toolsResult = (await parseResponse(toolsResponse)) as { result?: { tools?: McpTool[] } };\n\n  return {\n    tools: toolsResult.result?.tools ?? [],\n  };\n}\n\nexport const useTryConnectMcp = ({\n  queryOptions,\n}: { queryOptions?: MastraMutationOptions<TryConnectResult, string> } = {}) => {\n  const client = useMastraClient();\n  const clientHeaders = (client.options?.headers as Record<string, string>) ?? {};\n\n  return useMutation({\n    mutationFn: (url: string) => connectAndListTools(url, clientHeaders),\n    ...queryOptions,\n  });\n};\n\nexport type TryConnectMcpMutation = ReturnType<typeof useTryConnectMcp>;\n"],"mappings":"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"}

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

@@ -1,3 +1,4 @@
+export * from './use-mcp-app-html.js';
 export * from './use-mcp-app-tools.js';
 export * from './use-mcp-server-tool.js';
 export * from './use-mcp-server-tools.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/mcps/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/mcps/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/dist/hooks/mcps/index.js

@@ -1,5 +1,27 @@
 import { n as useMastraClient } from "../../mastra-client-context-Bx_g84YB.js";
 import { useMutation, useQuery } from "@tanstack/react-query";
+//#region src/hooks/mcps/use-mcp-app-html.ts
+/**
+* The HTML of an MCP tool's `ui://` app resource (from the tool's `_meta`), for rendering the tool's own UI.
+* Skips the fetch when the tool has no app resource.
+*/
+const useMcpAppHtml = ({ serverId, appResourceUri, queryOptions }) => {
+	const client = useMastraClient();
+	return useQuery({
+		queryKey: [
+			"mcp-app-resource",
+			serverId,
+			appResourceUri
+		],
+		queryFn: async () => {
+			if (!appResourceUri) return null;
+			return (await client.readMcpServerResource(serverId, appResourceUri)).contents[0]?.text ?? null;
+		},
+		enabled: appResourceUri !== void 0,
+		...queryOptions
+	});
+};
+//#endregion
 //#region src/hooks/mcps/use-mcp-app-tools.ts
 /**
 * Builds a map of tool names → MCP App info for tools across all registered
@@ -203,6 +225,6 @@ const useTryConnectMcp = ({ queryOptions } = {}) => {
 	});
 };
 //#endregion
-export { useExecuteMCPTool, useMCPServerTool, useMCPServerTools, useMCPServerToolsById, useMCPServers, useMcpAppTools, useTryConnectMcp };
+export { useExecuteMCPTool, useMCPServerTool, useMCPServerTools, useMCPServerToolsById, useMCPServers, useMcpAppHtml, useMcpAppTools, useTryConnectMcp };
 
 //# sourceMappingURL=index.js.map

package/dist/hooks/mcps/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/mcps/use-mcp-app-tools.ts","../../../src/hooks/mcps/use-mcp-server-tool.ts","../../../src/hooks/mcps/use-mcp-server-tools.ts","../../../src/hooks/mcps/use-mcp-server-tools-by-id.ts","../../../src/hooks/mcps/use-mcp-servers.ts","../../../src/hooks/mcps/use-try-connect-mcp.ts"],"sourcesContent":["import type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport interface McpAppToolInfo {\n  serverId: string;\n  toolId: string;\n  toolName: string;\n  resourceUri: string;\n}\n\n/**\n * Builds a map of tool names → MCP App info for tools across all registered\n * MCP servers that have `_meta.ui.resourceUri` (i.e., tools with interactive\n * MCP App UIs).\n *\n * For each app tool, entries are created under both the original tool name\n * and the namespaced name (`${serverId}_${toolName}`) so that agent tools\n * sourced via `MCPClient.listTools()` (which namespaces) can be resolved.\n */\nexport function useMcpAppTools<TData = Record<string, McpAppToolInfo>>({\n  queryOptions,\n}: { queryOptions?: MastraQueryOptions<Record<string, McpAppToolInfo>, TData> } = {}): UseQueryResult<TData, Error> {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-app-tools'],\n    queryFn: async () => {\n      const map: Record<string, McpAppToolInfo> = {};\n\n      const { servers } = await client.getMcpServers();\n      if (!servers?.length) return map;\n\n      const results = await Promise.allSettled(\n        servers.map(async server => {\n          const { tools } = await client.getMcpServerTools(server.id);\n          return { serverId: server.id, tools };\n        }),\n      );\n\n      for (const result of results) {\n        if (result.status !== 'fulfilled') continue;\n        const { serverId, tools } = result.value;\n        for (const tool of tools) {\n          const meta = tool._meta as { ui?: { resourceUri?: string } } | undefined;\n          const resourceUri = meta?.ui?.resourceUri;\n          if (resourceUri) {\n            const toolId = tool.name;\n            const info: McpAppToolInfo = { serverId, toolId, toolName: tool.name, resourceUri };\n            map[toolId] = info;\n            if (tool.name !== toolId) {\n              map[tool.name] = info;\n            }\n            // Also map the namespaced name used by MCPClient.listTools()\n            map[`${serverId}_${tool.name}`] = info;\n          }\n        }\n      }\n\n      return map;\n    },\n    staleTime: 60_000,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n}\n","import type { MastraClient } from '@mastra/client-js';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport { useMutation, useQuery } from '@tanstack/react-query';\nimport type { UseMutationResult, UseQueryResult } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions, MastraQueryOptions } from '../shared/query-options';\n\ntype MCPServerToolDetails = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['details']>>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useMCPServerTool = <TData = MCPServerToolDetails>({\n  serverId,\n  toolId,\n  requestContext,\n  queryOptions,\n}: {\n  serverId: string;\n  toolId: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<MCPServerToolDetails, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-server-tool', serverId, toolId],\n    queryFn: () => {\n      const instance = client.getMcpServerTool(serverId, toolId);\n      return instance.details(requestContext);\n    },\n    ...queryOptions,\n  });\n};\n\nexport type ExecuteMCPToolResponse = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['execute']>>;\ntype ExecuteMCPToolVariables = { data: any; requestContext?: Record<string, any> };\n\nexport const useExecuteMCPTool = ({\n  serverId,\n  toolId,\n  queryOptions,\n}: {\n  serverId: string;\n  toolId: string;\n  queryOptions?: MastraMutationOptions<ExecuteMCPToolResponse, ExecuteMCPToolVariables>;\n}): UseMutationResult<ExecuteMCPToolResponse, Error, ExecuteMCPToolVariables> => {\n  const client = useMastraClient();\n\n  return useMutation({\n    mutationFn: ({ data, requestContext }: ExecuteMCPToolVariables) => {\n      const instance = client.getMcpServerTool(serverId, toolId);\n      return instance.execute({ data, requestContext: requestContext as RequestContext });\n    },\n    ...queryOptions,\n  });\n};\n","import type { McpToolInfo as SdkMcpToolInfo } from '@mastra/client-js';\nimport type { ServerInfo } from '@mastra/core/mcp';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport const useMCPServerTools = <TData = Record<string, SdkMcpToolInfo>>({\n  selectedServer,\n  queryOptions,\n}: {\n  selectedServer: ServerInfo;\n  queryOptions?: MastraQueryOptions<Record<string, SdkMcpToolInfo>, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcpserver-tools', selectedServer?.id],\n    queryFn: async () => {\n      const response = await client.getMcpServerTools(selectedServer?.id);\n      const fetchedToolsArray: SdkMcpToolInfo[] = response.tools;\n      const transformedTools: Record<string, SdkMcpToolInfo> = {};\n      fetchedToolsArray.forEach((sdkToolInfo: SdkMcpToolInfo) => {\n        transformedTools[sdkToolInfo.name] = sdkToolInfo;\n      });\n\n      return transformedTools;\n    },\n    retry: false,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n};\n","import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\ntype MCPServerToolsById = Record<string, Awaited<ReturnType<MastraClient['getMcpServerTools']>>['tools'][number]>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useMCPServerToolsById = <TData = MCPServerToolsById>({\n  serverId,\n  queryOptions,\n}: {\n  serverId: string | null;\n  queryOptions?: MastraQueryOptions<MCPServerToolsById, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcpserver-tools', serverId],\n    queryFn: async (): Promise<MCPServerToolsById> => {\n      const response = await client.getMcpServerTools(serverId!);\n      return Object.fromEntries(response.tools.map(tool => [tool.name, tool]));\n    },\n    retry: false,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n};\n","import type { McpServerListResponse } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport const useMCPServers = <TData = McpServerListResponse['servers']>({\n  requestContext,\n  queryOptions,\n}: {\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<McpServerListResponse['servers'], TData>;\n} = {}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-servers'],\n    queryFn: async () => {\n      const mcpServers: McpServerListResponse['servers'] = (await client.getMcpServers(requestContext)).servers;\n      return mcpServers;\n    },\n    ...queryOptions,\n  });\n};\n","import { useMutation } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions } from '../shared/query-options';\n\ninterface McpTool {\n  name: string;\n  description?: string;\n  inputSchema?: Record<string, unknown>;\n}\n\nexport interface TryConnectResult {\n  tools: McpTool[];\n}\n\nasync function parseResponse(response: Response): Promise<unknown> {\n  const contentType = response.headers.get('content-type') ?? '';\n\n  if (contentType.includes('text/event-stream')) {\n    const text = await response.text();\n    const lines = text.split('\\n');\n\n    for (const line of lines) {\n      if (line.startsWith('data:')) {\n        const data = line.slice('data:'.length).trim();\n        if (data) {\n          return JSON.parse(data);\n        }\n      }\n    }\n\n    throw new Error('No data found in SSE response');\n  }\n\n  return response.json();\n}\n\nasync function connectAndListTools(url: string, clientHeaders?: Record<string, string>): Promise<TryConnectResult> {\n  const baseHeaders: Record<string, string> = {\n    ...clientHeaders,\n    'Content-Type': 'application/json',\n    Accept: 'application/json, text/event-stream',\n  };\n\n  // Step 1: Initialize\n  const initResponse = await fetch(url, {\n    method: 'POST',\n    headers: baseHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: '2025-03-26',\n        capabilities: {},\n        clientInfo: { name: 'mastra-playground', version: '1.0.0' },\n      },\n    }),\n  });\n\n  if (!initResponse.ok) {\n    throw new Error(`Initialize failed: ${initResponse.status} ${initResponse.statusText}`);\n  }\n\n  const sessionId = initResponse.headers.get('Mcp-Session-Id');\n  await parseResponse(initResponse);\n\n  const sessionHeaders: Record<string, string> = {\n    ...baseHeaders,\n  };\n  if (sessionId) {\n    sessionHeaders['Mcp-Session-Id'] = sessionId;\n  }\n\n  // Step 2: Send initialized notification\n  await fetch(url, {\n    method: 'POST',\n    headers: sessionHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      method: 'notifications/initialized',\n    }),\n  });\n\n  // Step 3: List tools\n  const toolsResponse = await fetch(url, {\n    method: 'POST',\n    headers: sessionHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 2,\n      method: 'tools/list',\n    }),\n  });\n\n  if (!toolsResponse.ok) {\n    throw new Error(`tools/list failed: ${toolsResponse.status} ${toolsResponse.statusText}`);\n  }\n\n  const toolsResult = (await parseResponse(toolsResponse)) as { result?: { tools?: McpTool[] } };\n\n  return {\n    tools: toolsResult.result?.tools ?? [],\n  };\n}\n\nexport const useTryConnectMcp = ({\n  queryOptions,\n}: { queryOptions?: MastraMutationOptions<TryConnectResult, string> } = {}) => {\n  const client = useMastraClient();\n  const clientHeaders = (client.options?.headers as Record<string, string>) ?? {};\n\n  return useMutation({\n    mutationFn: (url: string) => connectAndListTools(url, clientHeaders),\n    ...queryOptions,\n  });\n};\n\nexport type TryConnectMcpMutation = ReturnType<typeof useTryConnectMcp>;\n"],"mappings":";;;;;;;;;;;;AAqBA,SAAgB,eAAuD,EACrE,iBACgF,CAAC,GAAiC;CAClH,MAAM,SAAS,gBAAgB;CAE/B,OAAO,SAAS;EACd,UAAU,CAAC,eAAe;EAC1B,SAAS,YAAY;GACnB,MAAM,MAAsC,CAAC;GAE7C,MAAM,EAAE,YAAY,MAAM,OAAO,cAAc;GAC/C,IAAI,CAAC,SAAS,QAAQ,OAAO;GAE7B,MAAM,UAAU,MAAM,QAAQ,WAC5B,QAAQ,IAAI,OAAM,WAAU;IAC1B,MAAM,EAAE,UAAU,MAAM,OAAO,kBAAkB,OAAO,EAAE;IAC1D,OAAO;KAAE,UAAU,OAAO;KAAI;IAAM;GACtC,CAAC,CACH;GAEA,KAAK,MAAM,UAAU,SAAS;IAC5B,IAAI,OAAO,WAAW,aAAa;IACnC,MAAM,EAAE,UAAU,UAAU,OAAO;IACnC,KAAK,MAAM,QAAQ,OAAO;KAExB,MAAM,cADO,KAAK,OACQ,IAAI;KAC9B,IAAI,aAAa;MACf,MAAM,SAAS,KAAK;MACpB,MAAM,OAAuB;OAAE;OAAU;OAAQ,UAAU,KAAK;OAAM;MAAY;MAClF,IAAI,UAAU;MACd,IAAI,KAAK,SAAS,QAChB,IAAI,KAAK,QAAQ;MAGnB,IAAI,GAAG,SAAS,GAAG,KAAK,UAAU;KACpC;IACF;GACF;GAEA,OAAO;EACT;EACA,WAAW;EACX,sBAAsB;EACtB,GAAG;CACL,CAAC;AACH;;;;;;ACtDA,MAAa,oBAAkD,EAC7D,UACA,QACA,gBACA,mBAMkC;CAClC,MAAM,SAAS,gBAAgB;CAE/B,OAAO,SAAS;EACd,UAAU;GAAC;GAAmB;GAAU;EAAM;EAC9C,eAAe;GAEb,OADiB,OAAO,iBAAiB,UAAU,MACrC,CAAC,CAAC,QAAQ,cAAc;EACxC;EACA,GAAG;CACL,CAAC;AACH;AAKA,MAAa,qBAAqB,EAChC,UACA,QACA,mBAK+E;CAC/E,MAAM,SAAS,gBAAgB;CAE/B,OAAO,YAAY;EACjB,aAAa,EAAE,MAAM,qBAA8C;GAEjE,OADiB,OAAO,iBAAiB,UAAU,MACrC,CAAC,CAAC,QAAQ;IAAE;IAAsB;GAAiC,CAAC;EACpF;EACA,GAAG;CACL,CAAC;AACH;;;ACjDA,MAAa,qBAA6D,EACxE,gBACA,mBAIkC;CAClC,MAAM,SAAS,gBAAgB;CAE/B,OAAO,SAAS;EACd,UAAU,CAAC,mBAAmB,gBAAgB,EAAE;EAChD,SAAS,YAAY;GAEnB,MAAM,qBAAsC,MADrB,OAAO,kBAAkB,gBAAgB,EAAE,EAAA,CACb;GACrD,MAAM,mBAAmD,CAAC;GAC1D,kBAAkB,SAAS,gBAAgC;IACzD,iBAAiB,YAAY,QAAQ;GACvC,CAAC;GAED,OAAO;EACT;EACA,OAAO;EACP,sBAAsB;EACtB,GAAG;CACL,CAAC;AACH;;;;;;ACrBA,MAAa,yBAAqD,EAChE,UACA,mBAIkC;CAClC,MAAM,SAAS,gBAAgB;CAE/B,OAAO,SAAS;EACd,UAAU,CAAC,mBAAmB,QAAQ;EACtC,SAAS,YAAyC;GAChD,MAAM,WAAW,MAAM,OAAO,kBAAkB,QAAS;GACzD,OAAO,OAAO,YAAY,SAAS,MAAM,KAAI,SAAQ,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC;EACzE;EACA,OAAO;EACP,sBAAsB;EACtB,GAAG;CACL,CAAC;AACH;;;ACxBA,MAAa,iBAA2D,EACtE,gBACA,iBAIE,CAAC,MAAoC;CACvC,MAAM,SAAS,gBAAgB;CAE/B,OAAO,SAAS;EACd,UAAU,CAAC,aAAa;EACxB,SAAS,YAAY;GAEnB,QADsD,MAAM,OAAO,cAAc,cAAc,EAAA,CAAG;EAEpG;EACA,GAAG;CACL,CAAC;AACH;;;ACTA,eAAe,cAAc,UAAsC;CAGjE,KAFoB,SAAS,QAAQ,IAAI,cAAc,KAAK,GAAA,CAE5C,SAAS,mBAAmB,GAAG;EAE7C,MAAM,SAAQ,MADK,SAAS,KAAK,EAAA,CACd,MAAM,IAAI;EAE7B,KAAK,MAAM,QAAQ,OACjB,IAAI,KAAK,WAAW,OAAO,GAAG;GAC5B,MAAM,OAAO,KAAK,MAAM,CAAc,CAAC,CAAC,KAAK;GAC7C,IAAI,MACF,OAAO,KAAK,MAAM,IAAI;EAE1B;EAGF,MAAM,IAAI,MAAM,+BAA+B;CACjD;CAEA,OAAO,SAAS,KAAK;AACvB;AAEA,eAAe,oBAAoB,KAAa,eAAmE;CACjH,MAAM,cAAsC;EAC1C,GAAG;EACH,gBAAgB;EAChB,QAAQ;CACV;CAGA,MAAM,eAAe,MAAM,MAAM,KAAK;EACpC,QAAQ;EACR,SAAS;EACT,aAAa;EACb,MAAM,KAAK,UAAU;GACnB,SAAS;GACT,IAAI;GACJ,QAAQ;GACR,QAAQ;IACN,iBAAiB;IACjB,cAAc,CAAC;IACf,YAAY;KAAE,MAAM;KAAqB,SAAS;IAAQ;GAC5D;EACF,CAAC;CACH,CAAC;CAED,IAAI,CAAC,aAAa,IAChB,MAAM,IAAI,MAAM,sBAAsB,aAAa,OAAO,GAAG,aAAa,YAAY;CAGxF,MAAM,YAAY,aAAa,QAAQ,IAAI,gBAAgB;CAC3D,MAAM,cAAc,YAAY;CAEhC,MAAM,iBAAyC,EAC7C,GAAG,YACL;CACA,IAAI,WACF,eAAe,oBAAoB;CAIrC,MAAM,MAAM,KAAK;EACf,QAAQ;EACR,SAAS;EACT,aAAa;EACb,MAAM,KAAK,UAAU;GACnB,SAAS;GACT,QAAQ;EACV,CAAC;CACH,CAAC;CAGD,MAAM,gBAAgB,MAAM,MAAM,KAAK;EACrC,QAAQ;EACR,SAAS;EACT,aAAa;EACb,MAAM,KAAK,UAAU;GACnB,SAAS;GACT,IAAI;GACJ,QAAQ;EACV,CAAC;CACH,CAAC;CAED,IAAI,CAAC,cAAc,IACjB,MAAM,IAAI,MAAM,sBAAsB,cAAc,OAAO,GAAG,cAAc,YAAY;CAK1F,OAAO,EACL,QAAO,MAHkB,cAAc,aAAa,EAAA,CAGjC,QAAQ,SAAS,CAAC,EACvC;AACF;AAEA,MAAa,oBAAoB,EAC/B,iBACsE,CAAC,MAAM;CAE7E,MAAM,gBADS,gBACa,CAAC,CAAC,SAAS,WAAsC,CAAC;CAE9E,OAAO,YAAY;EACjB,aAAa,QAAgB,oBAAoB,KAAK,aAAa;EACnE,GAAG;CACL,CAAC;AACH"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/hooks/mcps/use-mcp-app-html.ts","../../../src/hooks/mcps/use-mcp-app-tools.ts","../../../src/hooks/mcps/use-mcp-server-tool.ts","../../../src/hooks/mcps/use-mcp-server-tools.ts","../../../src/hooks/mcps/use-mcp-server-tools-by-id.ts","../../../src/hooks/mcps/use-mcp-servers.ts","../../../src/hooks/mcps/use-try-connect-mcp.ts"],"sourcesContent":["import type { MastraClient } from '@mastra/client-js';\nimport { useQuery } from '@tanstack/react-query';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\n/** The app HTML, or `null` when the resource has no text. */\ntype McpAppHtml = string | null;\n\nexport type ReadMcpServerResourceResponse = Awaited<ReturnType<MastraClient['readMcpServerResource']>>;\n\n/**\n * The HTML of an MCP tool's `ui://` app resource (from the tool's `_meta`), for rendering the tool's own UI.\n * Skips the fetch when the tool has no app resource.\n */\nexport const useMcpAppHtml = <TData = McpAppHtml>({\n  serverId,\n  appResourceUri,\n  queryOptions,\n}: {\n  serverId: string;\n  appResourceUri?: string;\n  queryOptions?: MastraQueryOptions<McpAppHtml, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-app-resource', serverId, appResourceUri],\n    queryFn: async () => {\n      if (!appResourceUri) return null;\n      const response = await client.readMcpServerResource(serverId, appResourceUri);\n      return response.contents[0]?.text ?? null;\n    },\n    enabled: appResourceUri !== undefined,\n    ...queryOptions,\n  });\n};\n","import type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport interface McpAppToolInfo {\n  serverId: string;\n  toolId: string;\n  toolName: string;\n  resourceUri: string;\n}\n\n/**\n * Builds a map of tool names → MCP App info for tools across all registered\n * MCP servers that have `_meta.ui.resourceUri` (i.e., tools with interactive\n * MCP App UIs).\n *\n * For each app tool, entries are created under both the original tool name\n * and the namespaced name (`${serverId}_${toolName}`) so that agent tools\n * sourced via `MCPClient.listTools()` (which namespaces) can be resolved.\n */\nexport function useMcpAppTools<TData = Record<string, McpAppToolInfo>>({\n  queryOptions,\n}: { queryOptions?: MastraQueryOptions<Record<string, McpAppToolInfo>, TData> } = {}): UseQueryResult<TData, Error> {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-app-tools'],\n    queryFn: async () => {\n      const map: Record<string, McpAppToolInfo> = {};\n\n      const { servers } = await client.getMcpServers();\n      if (!servers?.length) return map;\n\n      const results = await Promise.allSettled(\n        servers.map(async server => {\n          const { tools } = await client.getMcpServerTools(server.id);\n          return { serverId: server.id, tools };\n        }),\n      );\n\n      for (const result of results) {\n        if (result.status !== 'fulfilled') continue;\n        const { serverId, tools } = result.value;\n        for (const tool of tools) {\n          const meta = tool._meta as { ui?: { resourceUri?: string } } | undefined;\n          const resourceUri = meta?.ui?.resourceUri;\n          if (resourceUri) {\n            const toolId = tool.name;\n            const info: McpAppToolInfo = { serverId, toolId, toolName: tool.name, resourceUri };\n            map[toolId] = info;\n            if (tool.name !== toolId) {\n              map[tool.name] = info;\n            }\n            // Also map the namespaced name used by MCPClient.listTools()\n            map[`${serverId}_${tool.name}`] = info;\n          }\n        }\n      }\n\n      return map;\n    },\n    staleTime: 60_000,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n}\n","import type { MastraClient } from '@mastra/client-js';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport { useMutation, useQuery } from '@tanstack/react-query';\nimport type { UseMutationResult, UseQueryResult } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions, MastraQueryOptions } from '../shared/query-options';\n\ntype MCPServerToolDetails = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['details']>>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useMCPServerTool = <TData = MCPServerToolDetails>({\n  serverId,\n  toolId,\n  requestContext,\n  queryOptions,\n}: {\n  serverId: string;\n  toolId: string;\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<MCPServerToolDetails, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-server-tool', serverId, toolId],\n    queryFn: () => {\n      const instance = client.getMcpServerTool(serverId, toolId);\n      return instance.details(requestContext);\n    },\n    ...queryOptions,\n  });\n};\n\nexport type ExecuteMCPToolResponse = Awaited<ReturnType<ReturnType<MastraClient['getMcpServerTool']>['execute']>>;\ntype ExecuteMCPToolVariables = { data: any; requestContext?: Record<string, any> };\n\nexport const useExecuteMCPTool = ({\n  serverId,\n  toolId,\n  queryOptions,\n}: {\n  serverId: string;\n  toolId: string;\n  queryOptions?: MastraMutationOptions<ExecuteMCPToolResponse, ExecuteMCPToolVariables>;\n}): UseMutationResult<ExecuteMCPToolResponse, Error, ExecuteMCPToolVariables> => {\n  const client = useMastraClient();\n\n  return useMutation({\n    mutationFn: ({ data, requestContext }: ExecuteMCPToolVariables) => {\n      const instance = client.getMcpServerTool(serverId, toolId);\n      return instance.execute({ data, requestContext: requestContext as RequestContext });\n    },\n    ...queryOptions,\n  });\n};\n","import type { McpToolInfo as SdkMcpToolInfo } from '@mastra/client-js';\nimport type { ServerInfo } from '@mastra/core/mcp';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport const useMCPServerTools = <TData = Record<string, SdkMcpToolInfo>>({\n  selectedServer,\n  queryOptions,\n}: {\n  selectedServer: ServerInfo;\n  queryOptions?: MastraQueryOptions<Record<string, SdkMcpToolInfo>, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcpserver-tools', selectedServer?.id],\n    queryFn: async () => {\n      const response = await client.getMcpServerTools(selectedServer?.id);\n      const fetchedToolsArray: SdkMcpToolInfo[] = response.tools;\n      const transformedTools: Record<string, SdkMcpToolInfo> = {};\n      fetchedToolsArray.forEach((sdkToolInfo: SdkMcpToolInfo) => {\n        transformedTools[sdkToolInfo.name] = sdkToolInfo;\n      });\n\n      return transformedTools;\n    },\n    retry: false,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n};\n","import type { MastraClient } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\ntype MCPServerToolsById = Record<string, Awaited<ReturnType<MastraClient['getMcpServerTools']>>['tools'][number]>;\n\n/**\n * Does not guard on empty ids; pass `queryOptions: { enabled }` to skip the fetch.\n */\nexport const useMCPServerToolsById = <TData = MCPServerToolsById>({\n  serverId,\n  queryOptions,\n}: {\n  serverId: string | null;\n  queryOptions?: MastraQueryOptions<MCPServerToolsById, TData>;\n}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcpserver-tools', serverId],\n    queryFn: async (): Promise<MCPServerToolsById> => {\n      const response = await client.getMcpServerTools(serverId!);\n      return Object.fromEntries(response.tools.map(tool => [tool.name, tool]));\n    },\n    retry: false,\n    refetchOnWindowFocus: false,\n    ...queryOptions,\n  });\n};\n","import type { McpServerListResponse } from '@mastra/client-js';\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { useQuery } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraQueryOptions } from '../shared/query-options';\n\nexport const useMCPServers = <TData = McpServerListResponse['servers']>({\n  requestContext,\n  queryOptions,\n}: {\n  requestContext?: Record<string, any>;\n  queryOptions?: MastraQueryOptions<McpServerListResponse['servers'], TData>;\n} = {}): UseQueryResult<TData, Error> => {\n  const client = useMastraClient();\n\n  return useQuery({\n    queryKey: ['mcp-servers'],\n    queryFn: async () => {\n      const mcpServers: McpServerListResponse['servers'] = (await client.getMcpServers(requestContext)).servers;\n      return mcpServers;\n    },\n    ...queryOptions,\n  });\n};\n","import { useMutation } from '@tanstack/react-query';\nimport { useMastraClient } from '../../mastra-client-context';\nimport type { MastraMutationOptions } from '../shared/query-options';\n\ninterface McpTool {\n  name: string;\n  description?: string;\n  inputSchema?: Record<string, unknown>;\n}\n\nexport interface TryConnectResult {\n  tools: McpTool[];\n}\n\nasync function parseResponse(response: Response): Promise<unknown> {\n  const contentType = response.headers.get('content-type') ?? '';\n\n  if (contentType.includes('text/event-stream')) {\n    const text = await response.text();\n    const lines = text.split('\\n');\n\n    for (const line of lines) {\n      if (line.startsWith('data:')) {\n        const data = line.slice('data:'.length).trim();\n        if (data) {\n          return JSON.parse(data);\n        }\n      }\n    }\n\n    throw new Error('No data found in SSE response');\n  }\n\n  return response.json();\n}\n\nasync function connectAndListTools(url: string, clientHeaders?: Record<string, string>): Promise<TryConnectResult> {\n  const baseHeaders: Record<string, string> = {\n    ...clientHeaders,\n    'Content-Type': 'application/json',\n    Accept: 'application/json, text/event-stream',\n  };\n\n  // Step 1: Initialize\n  const initResponse = await fetch(url, {\n    method: 'POST',\n    headers: baseHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: '2025-03-26',\n        capabilities: {},\n        clientInfo: { name: 'mastra-playground', version: '1.0.0' },\n      },\n    }),\n  });\n\n  if (!initResponse.ok) {\n    throw new Error(`Initialize failed: ${initResponse.status} ${initResponse.statusText}`);\n  }\n\n  const sessionId = initResponse.headers.get('Mcp-Session-Id');\n  await parseResponse(initResponse);\n\n  const sessionHeaders: Record<string, string> = {\n    ...baseHeaders,\n  };\n  if (sessionId) {\n    sessionHeaders['Mcp-Session-Id'] = sessionId;\n  }\n\n  // Step 2: Send initialized notification\n  await fetch(url, {\n    method: 'POST',\n    headers: sessionHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      method: 'notifications/initialized',\n    }),\n  });\n\n  // Step 3: List tools\n  const toolsResponse = await fetch(url, {\n    method: 'POST',\n    headers: sessionHeaders,\n    credentials: 'include',\n    body: JSON.stringify({\n      jsonrpc: '2.0',\n      id: 2,\n      method: 'tools/list',\n    }),\n  });\n\n  if (!toolsResponse.ok) {\n    throw new Error(`tools/list failed: ${toolsResponse.status} ${toolsResponse.statusText}`);\n  }\n\n  const toolsResult = (await parseResponse(toolsResponse)) as { result?: { tools?: McpTool[] } };\n\n  return {\n    tools: toolsResult.result?.tools ?? [],\n  };\n}\n\nexport const useTryConnectMcp = ({\n  queryOptions,\n}: { queryOptions?: MastraMutationOptions<TryConnectResult, string> } = {}) => {\n  const client = useMastraClient();\n  const clientHeaders = (client.options?.headers as Record<string, string>) ?? {};\n\n  return useMutation({\n    mutationFn: (url: string) => connectAndListTools(url, clientHeaders),\n    ...queryOptions,\n  });\n};\n\nexport type TryConnectMcpMutation = ReturnType<typeof useTryConnectMcp>;\n"],"mappings":"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"}

package/dist/hooks/mcps/use-mcp-app-html.d.ts

@@ -0,0 +1,17 @@
+import type { MastraClient } from '@mastra/client-js';
+import type { UseQueryResult } from '@tanstack/react-query';
+import type { MastraQueryOptions } from '../shared/query-options.js';
+/** The app HTML, or `null` when the resource has no text. */
+type McpAppHtml = string | null;
+export type ReadMcpServerResourceResponse = Awaited<ReturnType<MastraClient['readMcpServerResource']>>;
+/**
+ * The HTML of an MCP tool's `ui://` app resource (from the tool's `_meta`), for rendering the tool's own UI.
+ * Skips the fetch when the tool has no app resource.
+ */
+export declare const useMcpAppHtml: <TData = McpAppHtml>({ serverId, appResourceUri, queryOptions, }: {
+    serverId: string;
+    appResourceUri?: string;
+    queryOptions?: MastraQueryOptions<McpAppHtml, TData>;
+}) => UseQueryResult<TData, Error>;
+export {};
+//# sourceMappingURL=use-mcp-app-html.d.ts.map

package/dist/hooks/mcps/use-mcp-app-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mcp-app-html.d.ts","sourceRoot":"","sources":["../../../src/hooks/mcps/use-mcp-app-html.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,6DAA6D;AAC7D,KAAK,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;AAEhC,MAAM,MAAM,6BAA6B,GAAG,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;AAEvG;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,GAAG,UAAU,+CAI7C;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,kBAAkB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;CACtD,KAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAa9B,CAAC"}

package/dist/hooks/metrics/index.cjs

@@ -445,21 +445,27 @@ function useModelUsageCostMetrics(params) {
 				"mastra_model_input_cache_write_tokens"
 			].map((name) => client.getMetricBreakdown({
 				name: [name],
-				groupBy: ["model"],
+				groupBy: ["model", "provider"],
 				aggregation: "sum",
 				orderDirection: "DESC",
 				filters
 			})));
 			if (!inputRes || !outputRes || !cacheReadRes || !cacheWriteRes) return [];
 			const modelMap = /* @__PURE__ */ new Map();
-			const ensureModel = (model) => require_map.getOrCreate(modelMap, model, () => ({
-				input: 0,
-				output: 0,
-				cacheRead: 0,
-				cacheWrite: 0,
-				cost: null,
-				costUnit: null
-			}));
+			const ensureModel = (dimensions) => {
+				const model = dimensions.model ?? "unknown";
+				const provider = dimensions.provider ?? void 0;
+				return require_map.getOrCreate(modelMap, `${model}\u0000${provider ?? ""}`, () => ({
+					model,
+					provider,
+					input: 0,
+					output: 0,
+					cacheRead: 0,
+					cacheWrite: 0,
+					cost: null,
+					costUnit: null
+				}));
+			};
 			const addCost = (entry, group) => {
 				if (group.estimatedCost != null) {
 					entry.cost = (entry.cost ?? 0) + group.estimatedCost;
@@ -467,32 +473,33 @@ function useModelUsageCostMetrics(params) {
 				}
 			};
 			for (const group of inputRes.groups) {
-				const entry = ensureModel(group.dimensions.model ?? "unknown");
+				const entry = ensureModel(group.dimensions);
 				entry.input = group.value;
 				addCost(entry, group);
 			}
 			for (const group of outputRes.groups) {
-				const entry = ensureModel(group.dimensions.model ?? "unknown");
+				const entry = ensureModel(group.dimensions);
 				entry.output = group.value;
 				addCost(entry, group);
 			}
 			for (const group of cacheReadRes.groups) {
-				const entry = ensureModel(group.dimensions.model ?? "unknown");
+				const entry = ensureModel(group.dimensions);
 				entry.cacheRead = group.value;
 			}
 			for (const group of cacheWriteRes.groups) {
-				const entry = ensureModel(group.dimensions.model ?? "unknown");
+				const entry = ensureModel(group.dimensions);
 				entry.cacheWrite = group.value;
 			}
-			return Array.from(modelMap.entries()).map(([model, vals]) => ({
-				model,
+			return Array.from(modelMap.values()).map((vals) => ({
+				model: vals.model,
+				...vals.provider ? { provider: vals.provider } : {},
 				input: formatCompactNumber(vals.input),
 				output: formatCompactNumber(vals.output),
 				cacheRead: formatCompactNumber(vals.cacheRead),
 				cacheWrite: formatCompactNumber(vals.cacheWrite),
 				cost: vals.cost,
 				costUnit: vals.costUnit
-			})).sort((a, b) => a.model.localeCompare(b.model));
+			})).sort((a, b) => a.model.localeCompare(b.model) || (a.provider ?? "").localeCompare(b.provider ?? ""));
 		},
 		...queryOptions
 	});