@tanstack/ai-svelte 0.20.0 → 0.21.0

package/dist/create-web-mcp-tools.svelte.d.ts

@@ -0,0 +1,24 @@
+import type { AnyClientTool, InferredClientContext, RegisterWebMCPToolsOptions } from '@tanstack/ai-client';
+/** Options for {@link createWebMCPTools}. */
+export type CreateWebMCPToolsOptions<TTools extends ReadonlyArray<AnyClientTool>, TContext = InferredClientContext<TTools>> = Omit<RegisterWebMCPToolsOptions<TTools, TContext>, 'signal'> & {
+    /** Receives an asynchronous registration error. */
+    onError?: (error: unknown) => void;
+};
+type CreateWebMCPToolsArguments<TTools extends ReadonlyArray<AnyClientTool>, TContext> = {} extends CreateWebMCPToolsOptions<TTools, TContext> ? [options?: CreateWebMCPToolsOptions<TTools, TContext>] : [options: CreateWebMCPToolsOptions<TTools, TContext>];
+/**
+ * Registers executable client tools with WebMCP for the current Svelte component.
+ *
+ * Component destruction removes every tool registered by this call.
+ *
+ * @param tools - The executable client tools to expose through WebMCP.
+ * @param options - Runtime context, per-tool options, and error handling.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   createWebMCPTools([searchProducts])
+ * </script>
+ * ```
+ */
+export declare function createWebMCPTools<const TTools extends ReadonlyArray<AnyClientTool>, TContext = InferredClientContext<TTools>>(tools: TTools, ...[options]: CreateWebMCPToolsArguments<TTools, TContext>): void;
+export {};

package/dist/create-web-mcp-tools.svelte.js

@@ -0,0 +1,29 @@
+import { onDestroy } from 'svelte';
+import { registerWebMCPTools } from '@tanstack/ai-client';
+/**
+ * Registers executable client tools with WebMCP for the current Svelte component.
+ *
+ * Component destruction removes every tool registered by this call.
+ *
+ * @param tools - The executable client tools to expose through WebMCP.
+ * @param options - Runtime context, per-tool options, and error handling.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   createWebMCPTools([searchProducts])
+ * </script>
+ * ```
+ */
+export function createWebMCPTools(tools, ...[options]) {
+    const controller = new AbortController();
+    void registerWebMCPTools(tools, {
+        ...options,
+        signal: controller.signal,
+    }).catch((error) => {
+        if (!controller.signal.aborted) {
+            options?.onError?.(error);
+        }
+    });
+    onDestroy(() => controller.abort());
+}

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export { createChat } from './create-chat.svelte';
 export { createChatHook } from './create-chat-hook';
 export { createByok } from './create-byok.svelte';
+export { createWebMCPTools } from './create-web-mcp-tools.svelte';
+export type { CreateWebMCPToolsOptions } from './create-web-mcp-tools.svelte';
 export type { CreateChatOptions, CreateChatReturn, DeepPartial, UIMessage, ChatRequestBody, QueuedMessage, SendMessageOptions, WhenBusy, QueueConfig, QueueStrategy, QueueOption, } from './types';
 export { createGeneration } from './create-generation.svelte';
 export type { CreateGenerationOptions, CreateGenerationReturn, } from './create-generation.svelte';

package/dist/index.js

@@ -1,6 +1,7 @@
 export { createChat } from './create-chat.svelte';
 export { createChatHook } from './create-chat-hook';
 export { createByok } from './create-byok.svelte';
+export { createWebMCPTools } from './create-web-mcp-tools.svelte';
 // Generation hooks
 export { createGeneration } from './create-generation.svelte';
 export { createGenerateImage } from './create-generate-image.svelte';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-svelte",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Svelte 5 bindings for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -51,11 +51,11 @@
     "media-generation"
   ],
   "dependencies": {
-    "@tanstack/ai-client": "^0.30.0"
+    "@tanstack/ai-client": "^0.31.0"
   },
   "peerDependencies": {
     "svelte": "^5.0.0",
-    "@tanstack/ai": "^0.52.1"
+    "@tanstack/ai": "^0.53.0"
   },
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -68,7 +68,7 @@
     "svelte-check": "^4.2.0",
     "typescript": "5.9.3",
     "vite": "^8.2.1",
-    "@tanstack/ai": "0.52.1"
+    "@tanstack/ai": "0.53.0"
   },
   "scripts": {
     "clean": "rm -rf ./dist",

package/src/create-web-mcp-tools.svelte.ts

@@ -0,0 +1,57 @@
+import { onDestroy } from 'svelte'
+import { registerWebMCPTools } from '@tanstack/ai-client'
+import type {
+  AnyClientTool,
+  InferredClientContext,
+  RegisterWebMCPToolsOptions,
+} from '@tanstack/ai-client'
+
+/** Options for {@link createWebMCPTools}. */
+export type CreateWebMCPToolsOptions<
+  TTools extends ReadonlyArray<AnyClientTool>,
+  TContext = InferredClientContext<TTools>,
+> = Omit<RegisterWebMCPToolsOptions<TTools, TContext>, 'signal'> & {
+  /** Receives an asynchronous registration error. */
+  onError?: (error: unknown) => void
+}
+
+type CreateWebMCPToolsArguments<
+  TTools extends ReadonlyArray<AnyClientTool>,
+  TContext,
+> =
+  {} extends CreateWebMCPToolsOptions<TTools, TContext>
+    ? [options?: CreateWebMCPToolsOptions<TTools, TContext>]
+    : [options: CreateWebMCPToolsOptions<TTools, TContext>]
+
+/**
+ * Registers executable client tools with WebMCP for the current Svelte component.
+ *
+ * Component destruction removes every tool registered by this call.
+ *
+ * @param tools - The executable client tools to expose through WebMCP.
+ * @param options - Runtime context, per-tool options, and error handling.
+ *
+ * @example
+ * ```svelte
+ * <script lang="ts">
+ *   createWebMCPTools([searchProducts])
+ * </script>
+ * ```
+ */
+export function createWebMCPTools<
+  const TTools extends ReadonlyArray<AnyClientTool>,
+  TContext = InferredClientContext<TTools>,
+>(tools: TTools, ...[options]: CreateWebMCPToolsArguments<TTools, TContext>) {
+  const controller = new AbortController()
+
+  void registerWebMCPTools(tools, {
+    ...options,
+    signal: controller.signal,
+  }).catch((error) => {
+    if (!controller.signal.aborted) {
+      options?.onError?.(error)
+    }
+  })
+
+  onDestroy(() => controller.abort())
+}

package/src/index.ts

@@ -1,6 +1,8 @@
 export { createChat } from './create-chat.svelte'
 export { createChatHook } from './create-chat-hook'
 export { createByok } from './create-byok.svelte'
+export { createWebMCPTools } from './create-web-mcp-tools.svelte'
+export type { CreateWebMCPToolsOptions } from './create-web-mcp-tools.svelte'
 export type {
   CreateChatOptions,
   CreateChatReturn,