@tanstack/ai-react 0.16.1 → 0.16.2

package/dist/esm/mcp-app-resource.d.ts

@@ -0,0 +1,20 @@
+import { UIResourcePart } from '@tanstack/ai';
+import { McpAppBridge } from '@tanstack/ai-client';
+import { JSX } from 'react';
+export interface MCPAppResourceProps {
+    /** The ui-resource part from a UIMessage assistant part. */
+    part: UIResourcePart;
+    /**
+     * Framework-agnostic bridge for tool calls, prompt sending, and link opening.
+     * Omit it to render the widget in display-only mode — iframe interactions
+     * that would trigger tool calls or prompts are ignored.
+     */
+    bridge?: McpAppBridge;
+    /** Sandbox iframe configuration — must include the proxy page URL. */
+    sandbox: {
+        url: URL;
+    };
+    /** Optional structured arguments forwarded to the guest UI once it's ready. */
+    toolInput?: Record<string, unknown>;
+}
+export declare function MCPAppResource(props: MCPAppResourceProps): JSX.Element;

package/dist/esm/mcp-app-resource.js

@@ -0,0 +1,52 @@
+import { jsx } from "react/jsx-runtime";
+import { AppRenderer } from "@mcp-ui/client";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function resultToText(result) {
+  if (typeof result === "string") return result;
+  const stringify = JSON.stringify;
+  return stringify(result) ?? "null";
+}
+function MCPAppResource(props) {
+  const { bridge } = props;
+  return /* @__PURE__ */ jsx(
+    AppRenderer,
+    {
+      toolName: props.part.toolName,
+      sandbox: props.sandbox,
+      html: props.part.resource.text,
+      toolResourceUri: props.part.resource.uri,
+      toolInput: props.toolInput,
+      onCallTool: bridge ? async ({ name, arguments: args }) => {
+        const result = await bridge.callTool({
+          serverId: props.part.serverId,
+          toolName: name,
+          args
+        });
+        const structuredContent = isRecord(result) ? result : void 0;
+        return {
+          content: [
+            {
+              type: "text",
+              text: resultToText(result)
+            }
+          ],
+          structuredContent
+        };
+      } : void 0,
+      onMessage: bridge ? async ({ content }) => {
+        const text = content.filter(
+          (c) => c.type === "text"
+        ).map((c) => c.text).join("");
+        if (text) await bridge.sendPrompt(text);
+        return {};
+      } : void 0,
+      onOpenLink: bridge ? ({ url }) => Promise.resolve(bridge.openLink(url)) : void 0
+    }
+  );
+}
+export {
+  MCPAppResource
+};
+//# sourceMappingURL=mcp-app-resource.js.map

package/dist/esm/mcp-app-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-app-resource.js","sources":["../../src/mcp-app-resource.tsx"],"sourcesContent":["import { AppRenderer } from '@mcp-ui/client'\nimport type { UIResourcePart } from '@tanstack/ai'\nimport type { McpAppBridge } from '@tanstack/ai-client'\nimport type { JSX } from 'react'\n\nexport interface MCPAppResourceProps {\n  /** The ui-resource part from a UIMessage assistant part. */\n  part: UIResourcePart\n  /**\n   * Framework-agnostic bridge for tool calls, prompt sending, and link opening.\n   * Omit it to render the widget in display-only mode — iframe interactions\n   * that would trigger tool calls or prompts are ignored.\n   */\n  bridge?: McpAppBridge\n  /** Sandbox iframe configuration — must include the proxy page URL. */\n  sandbox: { url: URL }\n  /** Optional structured arguments forwarded to the guest UI once it's ready. */\n  toolInput?: Record<string, unknown>\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n/**\n * Coalesce an arbitrary bridge result into the `string` required by the\n * `CallToolResult` text content block. `JSON.stringify` is typed to return\n * `string` but actually returns `undefined` for inputs like `undefined` or a\n * function, so we narrow explicitly to avoid `text: undefined`.\n */\nfunction resultToText(result: unknown): string {\n  if (typeof result === 'string') return result\n  // `JSON.stringify`'s lib signature claims `string`, but it returns\n  // `undefined` for `undefined`/function inputs; type the call honestly.\n  const stringify: (value: unknown) => string | undefined = JSON.stringify\n  return stringify(result) ?? 'null'\n}\n\nexport function MCPAppResource(props: MCPAppResourceProps): JSX.Element {\n  const { bridge } = props\n  return (\n    <AppRenderer\n      toolName={props.part.toolName}\n      sandbox={props.sandbox}\n      html={props.part.resource.text}\n      toolResourceUri={props.part.resource.uri}\n      toolInput={props.toolInput}\n      onCallTool={\n        bridge\n          ? async ({ name, arguments: args }) => {\n              const result = await bridge.callTool({\n                serverId: props.part.serverId,\n                toolName: name,\n                args,\n              })\n              const structuredContent = isRecord(result) ? result : undefined\n              return {\n                content: [\n                  {\n                    type: 'text' as const,\n                    text: resultToText(result),\n                  },\n                ],\n                structuredContent,\n              }\n            }\n          : undefined\n      }\n      onMessage={\n        bridge\n          ? async ({ content }) => {\n              const text = content\n                .filter(\n                  (c): c is { type: 'text'; text: string } => c.type === 'text',\n                )\n                .map((c) => c.text)\n                .join('')\n              if (text) await bridge.sendPrompt(text)\n              return {}\n            }\n          : undefined\n      }\n      onOpenLink={\n        bridge ? ({ url }) => Promise.resolve(bridge.openLink(url)) : undefined\n      }\n    />\n  )\n}\n"],"names":[],"mappings":";;AAoBA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAQA,SAAS,aAAa,QAAyB;AAC7C,MAAI,OAAO,WAAW,SAAU,QAAO;AAGvC,QAAM,YAAoD,KAAK;AAC/D,SAAO,UAAU,MAAM,KAAK;AAC9B;AAEO,SAAS,eAAe,OAAyC;AACtE,QAAM,EAAE,WAAW;AACnB,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,UAAU,MAAM,KAAK;AAAA,MACrB,SAAS,MAAM;AAAA,MACf,MAAM,MAAM,KAAK,SAAS;AAAA,MAC1B,iBAAiB,MAAM,KAAK,SAAS;AAAA,MACrC,WAAW,MAAM;AAAA,MACjB,YACE,SACI,OAAO,EAAE,MAAM,WAAW,WAAW;AACnC,cAAM,SAAS,MAAM,OAAO,SAAS;AAAA,UACnC,UAAU,MAAM,KAAK;AAAA,UACrB,UAAU;AAAA,UACV;AAAA,QAAA,CACD;AACD,cAAM,oBAAoB,SAAS,MAAM,IAAI,SAAS;AACtD,eAAO;AAAA,UACL,SAAS;AAAA,YACP;AAAA,cACE,MAAM;AAAA,cACN,MAAM,aAAa,MAAM;AAAA,YAAA;AAAA,UAC3B;AAAA,UAEF;AAAA,QAAA;AAAA,MAEJ,IACA;AAAA,MAEN,WACE,SACI,OAAO,EAAE,cAAc;AACrB,cAAM,OAAO,QACV;AAAA,UACC,CAAC,MAA2C,EAAE,SAAS;AAAA,QAAA,EAExD,IAAI,CAAC,MAAM,EAAE,IAAI,EACjB,KAAK,EAAE;AACV,YAAI,KAAM,OAAM,OAAO,WAAW,IAAI;AACtC,eAAO,CAAA;AAAA,MACT,IACA;AAAA,MAEN,YACE,SAAS,CAAC,EAAE,UAAU,QAAQ,QAAQ,OAAO,SAAS,GAAG,CAAC,IAAI;AAAA,IAAA;AAAA,EAAA;AAItE;"}

package/dist/esm/mcp-apps.d.ts

@@ -1,20 +1,2 @@
-import { UIResourcePart } from '@tanstack/ai';
-import { McpAppBridge } from '@tanstack/ai-client';
-import { JSX } from 'react';
-export interface MCPAppResourceProps {
-    /** The ui-resource part from a UIMessage assistant part. */
-    part: UIResourcePart;
-    /**
-     * Framework-agnostic bridge for tool calls, prompt sending, and link opening.
-     * Omit it to render the widget in display-only mode — iframe interactions
-     * that would trigger tool calls or prompts are ignored.
-     */
-    bridge?: McpAppBridge;
-    /** Sandbox iframe configuration — must include the proxy page URL. */
-    sandbox: {
-        url: URL;
-    };
-    /** Optional structured arguments forwarded to the guest UI once it's ready. */
-    toolInput?: Record<string, unknown>;
-}
-export declare function MCPAppResource(props: MCPAppResourceProps): JSX.Element;
+export type { MCPAppResourceProps } from './mcp-app-resource.js';
+export { MCPAppResource } from './mcp-app-resource.js';

package/dist/esm/mcp-apps.js

@@ -1,51 +1,4 @@
-import { jsx } from "react/jsx-runtime";
-import { AppRenderer } from "@mcp-ui/client";
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function resultToText(result) {
-  if (typeof result === "string") return result;
-  const stringify = JSON.stringify;
-  return stringify(result) ?? "null";
-}
-function MCPAppResource(props) {
-  const { bridge } = props;
-  return /* @__PURE__ */ jsx(
-    AppRenderer,
-    {
-      toolName: props.part.toolName,
-      sandbox: props.sandbox,
-      html: props.part.resource.text,
-      toolResourceUri: props.part.resource.uri,
-      toolInput: props.toolInput,
-      onCallTool: bridge ? async ({ name, arguments: args }) => {
-        const result = await bridge.callTool({
-          serverId: props.part.serverId,
-          toolName: name,
-          args
-        });
-        const structuredContent = isRecord(result) ? result : void 0;
-        return {
-          content: [
-            {
-              type: "text",
-              text: resultToText(result)
-            }
-          ],
-          structuredContent
-        };
-      } : void 0,
-      onMessage: bridge ? async ({ content }) => {
-        const text = content.filter(
-          (c) => c.type === "text"
-        ).map((c) => c.text).join("");
-        if (text) await bridge.sendPrompt(text);
-        return {};
-      } : void 0,
-      onOpenLink: bridge ? ({ url }) => Promise.resolve(bridge.openLink(url)) : void 0
-    }
-  );
-}
+import { MCPAppResource } from "./mcp-app-resource.js";
 export {
   MCPAppResource
 };

package/dist/esm/mcp-apps.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-apps.js","sources":["../../src/mcp-apps.tsx"],"sourcesContent":["import { AppRenderer } from '@mcp-ui/client'\nimport type { UIResourcePart } from '@tanstack/ai'\nimport type { McpAppBridge } from '@tanstack/ai-client'\nimport type { JSX } from 'react'\n\nexport interface MCPAppResourceProps {\n  /** The ui-resource part from a UIMessage assistant part. */\n  part: UIResourcePart\n  /**\n   * Framework-agnostic bridge for tool calls, prompt sending, and link opening.\n   * Omit it to render the widget in display-only mode — iframe interactions\n   * that would trigger tool calls or prompts are ignored.\n   */\n  bridge?: McpAppBridge\n  /** Sandbox iframe configuration — must include the proxy page URL. */\n  sandbox: { url: URL }\n  /** Optional structured arguments forwarded to the guest UI once it's ready. */\n  toolInput?: Record<string, unknown>\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\n/**\n * Coalesce an arbitrary bridge result into the `string` required by the\n * `CallToolResult` text content block. `JSON.stringify` is typed to return\n * `string` but actually returns `undefined` for inputs like `undefined` or a\n * function, so we narrow explicitly to avoid `text: undefined`.\n */\nfunction resultToText(result: unknown): string {\n  if (typeof result === 'string') return result\n  // `JSON.stringify`'s lib signature claims `string`, but it returns\n  // `undefined` for `undefined`/function inputs; type the call honestly.\n  const stringify: (value: unknown) => string | undefined = JSON.stringify\n  return stringify(result) ?? 'null'\n}\n\nexport function MCPAppResource(props: MCPAppResourceProps): JSX.Element {\n  const { bridge } = props\n  return (\n    <AppRenderer\n      toolName={props.part.toolName}\n      sandbox={props.sandbox}\n      html={props.part.resource.text}\n      toolResourceUri={props.part.resource.uri}\n      toolInput={props.toolInput}\n      onCallTool={\n        bridge\n          ? async ({ name, arguments: args }) => {\n              const result = await bridge.callTool({\n                serverId: props.part.serverId,\n                toolName: name,\n                args,\n              })\n              const structuredContent = isRecord(result) ? result : undefined\n              return {\n                content: [\n                  {\n                    type: 'text' as const,\n                    text: resultToText(result),\n                  },\n                ],\n                structuredContent,\n              }\n            }\n          : undefined\n      }\n      onMessage={\n        bridge\n          ? async ({ content }) => {\n              const text = content\n                .filter(\n                  (c): c is { type: 'text'; text: string } => c.type === 'text',\n                )\n                .map((c) => c.text)\n                .join('')\n              if (text) await bridge.sendPrompt(text)\n              return {}\n            }\n          : undefined\n      }\n      onOpenLink={\n        bridge ? ({ url }) => Promise.resolve(bridge.openLink(url)) : undefined\n      }\n    />\n  )\n}\n"],"names":[],"mappings":";;AAoBA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAQA,SAAS,aAAa,QAAyB;AAC7C,MAAI,OAAO,WAAW,SAAU,QAAO;AAGvC,QAAM,YAAoD,KAAK;AAC/D,SAAO,UAAU,MAAM,KAAK;AAC9B;AAEO,SAAS,eAAe,OAAyC;AACtE,QAAM,EAAE,WAAW;AACnB,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,UAAU,MAAM,KAAK;AAAA,MACrB,SAAS,MAAM;AAAA,MACf,MAAM,MAAM,KAAK,SAAS;AAAA,MAC1B,iBAAiB,MAAM,KAAK,SAAS;AAAA,MACrC,WAAW,MAAM;AAAA,MACjB,YACE,SACI,OAAO,EAAE,MAAM,WAAW,WAAW;AACnC,cAAM,SAAS,MAAM,OAAO,SAAS;AAAA,UACnC,UAAU,MAAM,KAAK;AAAA,UACrB,UAAU;AAAA,UACV;AAAA,QAAA,CACD;AACD,cAAM,oBAAoB,SAAS,MAAM,IAAI,SAAS;AACtD,eAAO;AAAA,UACL,SAAS;AAAA,YACP;AAAA,cACE,MAAM;AAAA,cACN,MAAM,aAAa,MAAM;AAAA,YAAA;AAAA,UAC3B;AAAA,UAEF;AAAA,QAAA;AAAA,MAEJ,IACA;AAAA,MAEN,WACE,SACI,OAAO,EAAE,cAAc;AACrB,cAAM,OAAO,QACV;AAAA,UACC,CAAC,MAA2C,EAAE,SAAS;AAAA,QAAA,EAExD,IAAI,CAAC,MAAM,EAAE,IAAI,EACjB,KAAK,EAAE;AACV,YAAI,KAAM,OAAM,OAAO,WAAW,IAAI;AACtC,eAAO,CAAA;AAAA,MACT,IACA;AAAA,MAEN,YACE,SAAS,CAAC,EAAE,UAAU,QAAQ,QAAQ,OAAO,SAAS,GAAG,CAAC,IAAI;AAAA,IAAA;AAAA,EAAA;AAItE;"}
+{"version":3,"file":"mcp-apps.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-react",
-  "version": "0.16.1",
+  "version": "0.16.2",
   "description": "React hooks for TanStack AI streaming chat, realtime voice, structured outputs, and media generation.",
   "author": "Tanner Linsley",
   "license": "MIT",

package/src/mcp-apps.ts

@@ -0,0 +1,7 @@
+// Barrel entry for the `@tanstack/ai-react/mcp-apps` subpath. The JSX
+// implementation lives in the sibling `.tsx` file; this `.ts` re-export exists
+// so kiira's dist->src resolution (which maps `dist/esm/mcp-apps.d.ts` to
+// `src/mcp-apps.ts`, never `.tsx`) can type-check the docs snippets that import
+// from this subpath.
+export type { MCPAppResourceProps } from './mcp-app-resource'
+export { MCPAppResource } from './mcp-app-resource'