@tanstack/ai-svelte 0.11.1 → 0.12.1

package/dist/create-chat.svelte.d.ts

@@ -1,3 +1,4 @@
+import type { InferredClientContext } from '@tanstack/ai-client';
 import type { AnyClientTool, SchemaInput } from '@tanstack/ai';
 import type { CreateChatOptions, CreateChatReturn } from './types';
 /**
@@ -30,4 +31,4 @@ import type { CreateChatOptions, CreateChatReturn } from './types';
  * </div>
  * ```
  */
-export declare function createChat<TTools extends ReadonlyArray<AnyClientTool> = any, TSchema extends SchemaInput | undefined = undefined>(options: CreateChatOptions<TTools, TSchema>): CreateChatReturn<TTools, TSchema>;
+export declare function createChat<TTools extends ReadonlyArray<AnyClientTool> = any, TSchema extends SchemaInput | undefined = undefined, TContext = InferredClientContext<TTools>>(options: CreateChatOptions<TTools, TSchema, TContext>): CreateChatReturn<TTools, TSchema, TContext>;

package/dist/create-chat.svelte.js

@@ -66,6 +66,7 @@ export function createChat(options) {
         ...(options.forwardedProps !== undefined && {
             forwardedProps: options.forwardedProps,
         }),
+        ...(options.context !== undefined && { context: options.context }),
         devtools: {
             ...options.devtools,
             framework: 'svelte',
@@ -157,6 +158,9 @@ export function createChat(options) {
     const updateForwardedProps = (newForwardedProps) => {
         client.updateOptions({ forwardedProps: newForwardedProps });
     };
+    const updateContext = (newContext) => {
+        client.updateOptions({ context: newContext });
+    };
     // The "active" structured-output part is the one on the assistant message
     // after the latest user message. When no user message exists yet (e.g.
     // `initialMessages` carries only a stale assistant turn), we return null
@@ -194,7 +198,7 @@ export function createChat(options) {
         : null);
     // Return the chat interface with reactive getters
     // Using getters allows Svelte to track reactivity without needing $ prefix
-    // eslint-disable-next-line no-restricted-syntax -- rune return shape diverges from generic CreateChatReturn<TTools, TSchema> due to TSchema conditional partial/final fields; TS can't structurally narrow.
+    // eslint-disable-next-line no-restricted-syntax -- rune return shape diverges from generic CreateChatReturn<TTools, TSchema, TContext> due to TSchema conditional partial/final fields; TS can't structurally narrow.
     return {
         get messages() {
             return messages;
@@ -234,5 +238,6 @@ export function createChat(options) {
         addToolApprovalResponse,
         updateBody,
         updateForwardedProps,
+        updateContext,
     };
 }

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import type { AnyClientTool, InferSchemaType, ModelMessage, SchemaInput } from '@tanstack/ai';
-import type { AIDevtoolsDisplayOptions, ChatClientOptions, ChatClientState, ChatRequestBody, ConnectionStatus, DistributedOmit, MultimodalContent, UIMessage } from '@tanstack/ai-client';
+import type { AIDevtoolsDisplayOptions, ChatClientOptions, ChatClientState, ChatRequestBody, ClientContextOptionFromTools, ConnectionStatus, DistributedOmit, InferredClientContext, MultimodalContent, UIMessage } from '@tanstack/ai-client';
 export type { ChatRequestBody, MultimodalContent, UIMessage };
 /**
  * Recursive partial — every property and every nested array element is
@@ -30,7 +30,7 @@ export type DeepPartial<T> = T extends ReadonlyArray<infer U> ? Array<DeepPartia
  * Note: Connection and body changes will recreate the ChatClient instance.
  * To update these options, remount the component or use a key prop.
  */
-export type CreateChatOptions<TTools extends ReadonlyArray<AnyClientTool> = any, TSchema extends SchemaInput | undefined = undefined> = DistributedOmit<ChatClientOptions<TTools>, 'onMessagesChange' | 'onLoadingChange' | 'onErrorChange' | 'onStatusChange' | 'onSubscriptionChange' | 'onConnectionStatusChange' | 'onSessionGeneratingChange' | 'devtools'> & {
+export type CreateChatOptions<TTools extends ReadonlyArray<AnyClientTool> = any, TSchema extends SchemaInput | undefined = undefined, TContext = InferredClientContext<TTools>> = DistributedOmit<ChatClientOptions<TTools, TContext>, 'onMessagesChange' | 'onLoadingChange' | 'onErrorChange' | 'onStatusChange' | 'onSubscriptionChange' | 'onConnectionStatusChange' | 'onSessionGeneratingChange' | 'context' | 'devtools'> & {
     live?: boolean;
     /** Display options for TanStack AI Devtools. */
     devtools?: AIDevtoolsDisplayOptions;
@@ -39,13 +39,13 @@ export type CreateChatOptions<TTools extends ReadonlyArray<AnyClientTool> = any,
      * Schema). Used to infer the shape of `partial` and `final`.
      */
     outputSchema?: TSchema;
-};
+} & ClientContextOptionFromTools<TTools, TContext>;
 /**
  * Discriminated return shape: when `outputSchema` is supplied, the return adds
  * typed `partial` / `final` reactive getters; otherwise the return is
  * unchanged.
  */
-export type CreateChatReturn<TTools extends ReadonlyArray<AnyClientTool> = any, TSchema extends SchemaInput | undefined = undefined> = BaseCreateChatReturn<TTools, TSchema extends SchemaInput ? InferSchemaType<TSchema> : unknown> & (TSchema extends SchemaInput ? {
+export type CreateChatReturn<TTools extends ReadonlyArray<AnyClientTool> = any, TSchema extends SchemaInput | undefined = undefined, TContext = unknown> = BaseCreateChatReturn<TTools, TSchema extends SchemaInput ? InferSchemaType<TSchema> : unknown, TContext> & (TSchema extends SchemaInput ? {
     /**
      * Live progressively-parsed structured output (reactive getter).
      * Derived from the latest assistant message's structured-output part.
@@ -58,7 +58,7 @@ export type CreateChatReturn<TTools extends ReadonlyArray<AnyClientTool> = any,
      */
     readonly final: InferSchemaType<TSchema> | null;
 } : Record<never, never>);
-interface BaseCreateChatReturn<TTools extends ReadonlyArray<AnyClientTool> = any, TData = unknown> {
+interface BaseCreateChatReturn<TTools extends ReadonlyArray<AnyClientTool> = any, TData = unknown, TContext = unknown> {
     /**
      * Current messages in the conversation (reactive getter). When
      * `outputSchema` is supplied, `messages[i].parts.find(p => p.type ===
@@ -149,4 +149,9 @@ interface BaseCreateChatReturn<TTools extends ReadonlyArray<AnyClientTool> = any
      * changing model selection or other client-driven options).
      */
     updateForwardedProps: (forwardedProps: Record<string, any>) => void;
+    /**
+     * Update the client-local runtime context passed to client tool
+     * implementations. This value is not serialized to the server.
+     */
+    updateContext: (context: TContext) => void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-svelte",
-  "version": "0.11.1",
+  "version": "0.12.1",
   "description": "Svelte 5 bindings for TanStack AI streaming chat, structured outputs, and media generation.",
   "author": "",
   "license": "MIT",
@@ -38,11 +38,11 @@
     "media-generation"
   ],
   "dependencies": {
-    "@tanstack/ai-client": "0.14.1"
+    "@tanstack/ai-client": "0.15.1"
   },
   "peerDependencies": {
     "svelte": "^5.0.0",
-    "@tanstack/ai": "^0.23.1"
+    "@tanstack/ai": "^0.25.0"
   },
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -55,7 +55,7 @@
     "svelte-check": "^4.2.0",
     "typescript": "5.9.3",
     "vite": "^7.3.3",
-    "@tanstack/ai": "0.23.1"
+    "@tanstack/ai": "0.25.0"
   },
   "scripts": {
     "clean": "rm -rf ./dist",

package/src/create-chat.svelte.ts

@@ -3,6 +3,7 @@ import { createChatDevtoolsBridge } from '@tanstack/ai-client/devtools'
 import type {
   ChatClientState,
   ConnectionStatus,
+  InferredClientContext,
   StructuredOutputPart,
 } from '@tanstack/ai-client'
 import type {
@@ -53,9 +54,10 @@ import type {
 export function createChat<
   TTools extends ReadonlyArray<AnyClientTool> = any,
   TSchema extends SchemaInput | undefined = undefined,
+  TContext = InferredClientContext<TTools>,
 >(
-  options: CreateChatOptions<TTools, TSchema>,
-): CreateChatReturn<TTools, TSchema> {
+  options: CreateChatOptions<TTools, TSchema, TContext>,
+): CreateChatReturn<TTools, TSchema, TContext> {
   // Generate a unique ID for this chat instance
   const clientId =
     options.id ||
@@ -91,7 +93,7 @@ export function createChat<
     ? { connection: options.connection }
     : { fetcher: options.fetcher }
 
-  const client = new ChatClient({
+  const client = new ChatClient<TTools, TContext>({
     devtoolsBridgeFactory: createChatDevtoolsBridge,
     ...transport,
     id: clientId,
@@ -102,6 +104,7 @@ export function createChat<
     ...(options.forwardedProps !== undefined && {
       forwardedProps: options.forwardedProps,
     }),
+    ...(options.context !== undefined && { context: options.context }),
     devtools: {
       ...options.devtools,
       framework: 'svelte',
@@ -217,6 +220,10 @@ export function createChat<
     client.updateOptions({ forwardedProps: newForwardedProps })
   }
 
+  const updateContext = (newContext: TContext) => {
+    client.updateOptions({ context: newContext })
+  }
+
   // The "active" structured-output part is the one on the assistant message
   // after the latest user message. When no user message exists yet (e.g.
   // `initialMessages` carries only a stale assistant turn), we return null
@@ -257,7 +264,7 @@ export function createChat<
 
   // Return the chat interface with reactive getters
   // Using getters allows Svelte to track reactivity without needing $ prefix
-  // eslint-disable-next-line no-restricted-syntax -- rune return shape diverges from generic CreateChatReturn<TTools, TSchema> due to TSchema conditional partial/final fields; TS can't structurally narrow.
+  // eslint-disable-next-line no-restricted-syntax -- rune return shape diverges from generic CreateChatReturn<TTools, TSchema, TContext> due to TSchema conditional partial/final fields; TS can't structurally narrow.
   return {
     get messages() {
       return messages
@@ -297,5 +304,6 @@ export function createChat<
     addToolApprovalResponse,
     updateBody,
     updateForwardedProps,
-  } as unknown as CreateChatReturn<TTools, TSchema>
+    updateContext,
+  } as unknown as CreateChatReturn<TTools, TSchema, TContext>
 }

package/src/types.ts

@@ -9,8 +9,10 @@ import type {
   ChatClientOptions,
   ChatClientState,
   ChatRequestBody,
+  ClientContextOptionFromTools,
   ConnectionStatus,
   DistributedOmit,
+  InferredClientContext,
   MultimodalContent,
   UIMessage,
 } from '@tanstack/ai-client'
@@ -54,8 +56,9 @@ export type DeepPartial<T> =
 export type CreateChatOptions<
   TTools extends ReadonlyArray<AnyClientTool> = any,
   TSchema extends SchemaInput | undefined = undefined,
+  TContext = InferredClientContext<TTools>,
 > = DistributedOmit<
-  ChatClientOptions<TTools>,
+  ChatClientOptions<TTools, TContext>,
   | 'onMessagesChange'
   | 'onLoadingChange'
   | 'onErrorChange'
@@ -63,6 +66,7 @@ export type CreateChatOptions<
   | 'onSubscriptionChange'
   | 'onConnectionStatusChange'
   | 'onSessionGeneratingChange'
+  | 'context'
   | 'devtools'
 > & {
   live?: boolean
@@ -73,7 +77,7 @@ export type CreateChatOptions<
    * Schema). Used to infer the shape of `partial` and `final`.
    */
   outputSchema?: TSchema
-}
+} & ClientContextOptionFromTools<TTools, TContext>
 
 /**
  * Discriminated return shape: when `outputSchema` is supplied, the return adds
@@ -83,9 +87,11 @@ export type CreateChatOptions<
 export type CreateChatReturn<
   TTools extends ReadonlyArray<AnyClientTool> = any,
   TSchema extends SchemaInput | undefined = undefined,
+  TContext = unknown,
 > = BaseCreateChatReturn<
   TTools,
-  TSchema extends SchemaInput ? InferSchemaType<TSchema> : unknown
+  TSchema extends SchemaInput ? InferSchemaType<TSchema> : unknown,
+  TContext
 > &
   (TSchema extends SchemaInput
     ? {
@@ -106,6 +112,7 @@ export type CreateChatReturn<
 interface BaseCreateChatReturn<
   TTools extends ReadonlyArray<AnyClientTool> = any,
   TData = unknown,
+  TContext = unknown,
 > {
   /**
    * Current messages in the conversation (reactive getter). When
@@ -209,6 +216,11 @@ interface BaseCreateChatReturn<
    * changing model selection or other client-driven options).
    */
   updateForwardedProps: (forwardedProps: Record<string, any>) => void
+  /**
+   * Update the client-local runtime context passed to client tool
+   * implementations. This value is not serialized to the server.
+   */
+  updateContext: (context: TContext) => void
 }
 
 // Note: createChatClientOptions and InferChatMessages are now in @tanstack/ai-client