@tambo-ai/react 0.65.3 → 0.66.0

package/dist/model/component-metadata.d.ts

@@ -1,15 +1,26 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
 import TamboAI from "@tambo-ai/typescript-sdk";
 import { JSONSchema7 } from "json-schema";
 import { ComponentType } from "react";
-import z from "zod/v3";
-import type zodToJsonSchema from "zod-to-json-schema";
+import { ZodFunction as Zod3Function, ZodTuple as Zod3FunctionArgs, ZodType as Zod3FunctionReturns, infer as Zod3Infer } from "zod/v3";
+import { $ZodFunction as Zod4Function, $ZodFunctionArgs as Zod4FunctionArgs, $ZodType as Zod4FunctionReturns, infer as Zod4Infer } from "zod/v4/core";
+/**
+ * A schema type that accepts either a Standard Schema compliant validator
+ * (e.g., Zod, Valibot, ArkType) or a raw JSON Schema object.
+ *
+ * Standard Schema is a specification that provides a unified interface for
+ * TypeScript validation libraries. Libraries like Zod implement this spec,
+ * allowing us to accept any compliant validator without depending on a specific library.
+ * @see https://standardschema.dev/
+ */
+export type SupportedSchema = StandardSchemaV1 | JSONSchema7;
 /** Extension of the ToolParameters interface from Tambo AI to include JSONSchema definition */
 export type ParameterSpec = TamboAI.ToolParameters & {
-    schema?: ReturnType<typeof zodToJsonSchema>;
+    schema?: JSONSchema7;
 };
 /**
  * Extends the base ContextTool interface from Tambo AI to include schema information
- * for parameter validation using zod-to-json-schema.
+ * for parameter validation.
  */
 export interface ComponentContextToolMetadata extends TamboAI.ComponentContextToolMetadata {
     parameters: ParameterSpec[];
@@ -23,29 +34,229 @@ export interface RegisteredComponent extends TamboAI.AvailableComponent {
     loadingComponent?: ComponentType<any>;
 }
 export type ComponentRegistry = Record<string, RegisteredComponent>;
-export type TamboToolRegistry = Record<string, TamboTool>;
+export type TamboToolRegistry = Record<string, TamboTool | TamboToolWithToolSchema>;
 /**
  * A JSON Schema that is compatible with the MCP.
- * This is a simplified JSON Schema that is compatible with the MCPClient and the toolSchema.
+ * This is a simplified JSON Schema that is compatible with the MCPClient and the tool's inputSchema.
  *
  * Do not export this type from the SDK.
  */
-export type JSONSchemaLite = ReturnType<typeof zodToJsonSchema> & {
+export type JSONSchemaLite = JSONSchema7 & {
     description?: string;
 };
-export interface TamboTool<Args extends z.ZodTuple<any, any> = z.ZodTuple<any, any>, Returns extends z.ZodTypeAny = z.ZodTypeAny> {
+type MaybeAsync<T> = T | Promise<T>;
+/**
+ * TamboTool is a type that represents a tool that can be registered with Tambo.
+ *
+ * It is preferable to use the `defineTool` helper function to create tools, as
+ * it provides better type inference and safety.
+ * @example
+ * ```ts
+ * import { TamboTool, defineTool } from "@tambo-ai/react";
+ * import { z } from "zod";
+ *
+ * const locationToLatLon = defineTool({
+ *   name: "location_to_latlon",
+ *   description:
+ *     "Fetch latitude and longitude from a location string. Returns an object with 'lat' and 'lon' properties.",
+ *   tool: async ({ location }) => getLatLonFromLocation(location),
+ *   inputSchema: z.object({
+ *     location: z.string(),
+ *   }),
+ *   outputSchema: z.object({
+ *     lat: z.number(),
+ *     lon: z.number(),
+ *   }),
+ * });
+ * ```
+ * Alternatively, you manually construct a TamboTool with type safety by passing
+ * the expected parameter and return types as generics:
+ * ```ts
+ * import { TamboTool } from "@tambo-ai/react";
+ * import { z } from "zod";
+ *
+ * const locationToLatLon: TamboTool<{ location: string }, { lat: number; lon: number }> = {
+ *   name: "location_to_latlon",
+ *   description:
+ *     "Fetch latitude and longitude from a location string. Returns an object with 'lat' and 'lon' properties.",
+ *   tool: async ({ location }) => getLatLonFromLocation(location),
+ *   inputSchema: z.object({
+ *     location: z.string(),
+ *   }),
+ *   outputSchema: z.object({
+ *     lat: z.number(),
+ *     lon: z.number(),
+ *   }),
+ * });
+ * ```
+ */
+export interface TamboTool<Params = any, Returns = any, Rest extends any[] = []> {
+    /**
+     * Unique identifier for the tool
+     */
     name: string;
+    /**
+     * Description of what the tool does - used by AI to determine when to use it
+     */
     description: string;
-    tool: (...args: z.infer<Args>) => z.infer<Returns>;
-    toolSchema: z.ZodFunction<Args, Returns> | JSONSchemaLite;
+    /**
+     * Optional human-readable name of the tool for display purposes.
+     */
+    title?: string;
+    /**
+     * Optional properties describing tool behavior
+     */
+    annotations?: {
+        /**
+         * An array indicating the intended audience(s) for this resource. Valid
+         * values are "user" and "assistant". For example, ["user", "assistant"]
+         * indicates content useful for both.
+         */
+        audience: ("user" | "assistant")[];
+        /**
+         * A number from 0.0 to 1.0 indicating the importance of this resource. A
+         * value of 1 means "most important" (effectively required), while 0 means
+         * "least important" (entirely optional).
+         */
+        priority: number;
+        /**
+         * An ISO 8601 formatted timestamp indicating when the resource was last
+         * modified (e.g., "2025-01-12T15:00:58Z").
+         */
+        lastModified: string;
+    };
+    /**
+     * The function that implements the tool's logic. This function will be called
+     * by Tambo when the model decides to invoke the tool.
+     * @param params - The input parameters for the tool. These are validated
+     * against the inputSchema before being passed so are guaranteed to be correct
+     * when called by the model.
+     * @returns The result of the tool execution, which can be a value or a
+     * Promise resolving to a value
+     */
+    tool: (params: Params, ...rest: Rest) => MaybeAsync<Returns>;
+    /**
+     * The schema for the tool's input parameters. This can be a validator from
+     * any Standard Schema compliant library (Zod, Valibot, ArkType, etc.) or a
+     * raw JSON Schema object.
+     *
+     * This schema is used to validate and parse the parameters before passing
+     * them to the tool function.
+     */
+    inputSchema: SupportedSchema | unknown;
+    /**
+     * The schema for the tool's output/return value. This can be any Standard Schema
+     * compliant validator (Zod, Valibot, ArkType, etc.) or a raw JSON Schema object.
+     *
+     * This is used to inform the model about the structure of the tool's return value
+     * and is not used for runtime validation at this stage.
+     */
+    outputSchema: SupportedSchema | unknown;
     /**
      * Optional function to transform the tool's return value into an array of content parts.
      * If not provided, the return value will be converted to a string and wrapped in a text content part.
      * @param result - The result returned by the tool function
      * @returns An array of content parts to be sent back to the AI
      */
-    transformToContent?: (result: z.infer<Returns>) => Promise<TamboAI.Beta.Threads.ChatCompletionContentPart[]> | TamboAI.Beta.Threads.ChatCompletionContentPart[];
+    transformToContent?: (result: any) => Promise<TamboAI.Beta.Threads.ChatCompletionContentPart[]> | TamboAI.Beta.Threads.ChatCompletionContentPart[];
 }
+/**
+ * Simplified interface for tools using the deprecated toolSchema format.
+ * This interface uses simple `any` types to avoid complex type instantiation.
+ * Use `defineTamboTool()` for full type inference when creating tools.
+ * @deprecated Use TamboTool with `inputSchema`/`outputSchema` instead.
+ */
+export type TamboToolWithToolSchema<Args extends any[] = any[], Returns = any> = Omit<TamboTool, "tool" | "inputSchema" | "outputSchema"> & {
+    tool: (...args: Args) => MaybeAsync<Returns>;
+    /** @deprecated Use `inputSchema`/`outputSchema` properties instead. */
+    toolSchema: unknown;
+};
+/**
+ * TamboTool is a type that represents a tool that can be registered with Tambo.
+ *
+ * It is preferable to use the `defineTool` helper function to create tools, as
+ * it provides better type inference and safety.
+ * @example
+ * ```ts
+ * import { TamboTool, defineTool } from "@tambo-ai/react";
+ * import { z } from "zod";
+ *
+ * const locationToLatLon = defineTool({
+ *   name: "location_to_latlon",
+ *   description:
+ *     "Fetch latitude and longitude from a location string. Returns an object with 'lat' and 'lon' properties.",
+ *   tool: async ({ location }) => getLatLonFromLocation(location),
+ *   inputSchema: z.object({
+ *     location: z.string(),
+ *   }),
+ *   outputSchema: z.object({
+ *     lat: z.number(),
+ *     lon: z.number(),
+ *   }),
+ * });
+ * ```
+ * Alternatively, you manually construct a TamboTool with type safety by passing
+ * the expected parameter and return types as generics:
+ * ```ts
+ * import { TamboTool } from "@tambo-ai/react";
+ * import { z } from "zod";
+ *
+ * const locationToLatLon: TamboTool<{ location: string }, { lat: number; lon: number }> = {
+ *   name: "location_to_latlon",
+ *   description:
+ *     "Fetch latitude and longitude from a location string. Returns an object with 'lat' and 'lon' properties.",
+ *   tool: async ({ location }) => getLatLonFromLocation(location),
+ *   inputSchema: z.object({
+ *     location: z.string(),
+ *   }),
+ *   outputSchema: z.object({
+ *     lat: z.number(),
+ *     lon: z.number(),
+ *   }),
+ * });
+ * ```
+ */
+export type TamboToolBase<Params = any, Returns = any> = TamboToolWithToolSchema | TamboTool<Params, Returns>;
+/**
+ * A tool that uses JSON Schema compliant input and output schemas.
+ * This does not provide type safety for the tool's parameters and return value.
+ * @internal
+ */
+export type TamboToolJSONSchema<Args extends unknown[] = unknown[], Returns = unknown> = Omit<TamboTool<Args, Returns>, "tool" | "inputSchema" | "outputSchema"> & {
+    tool: (...args: Args) => MaybeAsync<Returns>;
+    inputSchema: JSONSchemaLite;
+    outputSchema: JSONSchemaLite;
+};
+/**
+ * A tool that could not be matched to any known schema types.
+ * This means type safety cannot be guaranteed.
+ * @internal
+ */
+export type TamboToolUnknown = Omit<TamboTool, "tool" | "inputSchema" | "outputSchema"> & {
+    tool: (...args: unknown[]) => MaybeAsync<unknown>;
+    inputSchema: unknown;
+    outputSchema: unknown;
+};
+/**
+ * A tool that uses Standard Schema compliant input and output schemas.
+ * This provides full type safety for the tool's parameters and return value.
+ * @internal
+ */
+export type TamboToolStandardSchema<Input extends StandardSchemaV1 = StandardSchemaV1, Output extends StandardSchemaV1 = StandardSchemaV1> = Omit<TamboTool<StandardSchemaV1.InferOutput<Input>, StandardSchemaV1.InferOutput<Output>>, "tool" | "inputSchema" | "outputSchema"> & {
+    tool: (...args: [StandardSchemaV1.InferOutput<Input>]) => MaybeAsync<StandardSchemaV1.InferOutput<Output>>;
+    inputSchema: Input;
+    outputSchema: Output;
+};
+type TamboToolZod3Function<Args extends Zod3FunctionArgs, Returns extends Zod3FunctionReturns> = Omit<TamboToolWithToolSchema<Zod3Infer<Args>, Zod3Infer<Returns>>, "toolSchema"> & {
+    tool: (...args: Zod3Infer<Args>) => MaybeAsync<Zod3Infer<Returns>>;
+    /** @deprecated Use `inputSchema`/`outputSchema` properties instead. */
+    toolSchema: Zod3Function<Args, Returns>;
+};
+type TamboToolZod4Function<Args extends Zod4FunctionArgs, Returns extends Zod4FunctionReturns> = Omit<TamboToolWithToolSchema<Zod4Infer<Args>, Zod4Infer<Returns>>, "toolSchema"> & {
+    tool: (...args: Zod4Infer<Args>) => MaybeAsync<Zod4Infer<Returns>>;
+    /** @deprecated Use `inputSchema`/`outputSchema` properties instead. */
+    toolSchema: Zod4Function<Args, Returns>;
+};
 export type TamboToolAssociations = Record<string, string[]>;
 /**
  * A component that can be registered with the TamboRegistryProvider.
@@ -76,10 +287,27 @@ export interface TamboComponent {
      */
     component: ComponentType<any>;
     /**
-     * A zod schema for the component props. (Recommended)
+     * Schema describing the component's props. Accepts any Standard Schema
+     * compliant validator (Zod, Valibot, ArkType, etc.) or a raw JSON Schema
+     * object.
+     *
      * Either this or propsDefinition must be provided, but not both.
+     * @example
+     * ```typescript
+     * import { z } from "zod/v4";
+     *
+     * const component: TamboComponent = {
+     *   name: "MyComponent",
+     *   description: "A sample component",
+     *   component: MyComponent,
+     *   propsSchema: z.object({
+     *     title: z.string(),
+     *     count: z.number().optional()
+     *   })
+     * };
+     * ```
      */
-    propsSchema?: z.ZodTypeAny | JSONSchema7;
+    propsSchema?: SupportedSchema;
     /**
      * The props definition of the component as a JSON object.
      * Either this or propsSchema must be provided, but not both.
@@ -89,6 +317,208 @@ export interface TamboComponent {
     /** The loading component to render while the component is loading */
     loadingComponent?: ComponentType<any>;
     /** The tools that are associated with the component */
-    associatedTools?: TamboTool[];
+    associatedTools?: (TamboTool | TamboToolWithToolSchema)[];
+}
+export interface RegisterToolsFn {
+    /**
+     * Registers one or more Tambo tools.
+     * @param tools - An array of Tambo tools to register
+     */
+    (tools: TamboTool[]): void;
+    (tools: (TamboTool | TamboToolWithToolSchema)[]): void;
+}
+/**
+ * Function interface for registering a Tambo tool with full type inference.
+ * This function has multiple overloads to handle different schema types. This
+ * is a utility function and does not perform any runtime logic.
+ */
+export interface RegisterToolFn {
+    /**
+     * @deprecated Use `inputSchema`/`outputSchema` instead. toolSchema is deprecated
+     * and will be removed in future versions.
+     * @example
+     * ```diff
+     * import { z } from "zod/v3";
+     * const myTool = defineTamboTool({
+     *   ...
+     * -  toolSchema: z.function()
+     * -    .arguments(z.tuple([z.string()]))
+     * -    .returns(z.number()),
+     * +  inputSchema: z.object({
+     * +    input: z.string().describe("Input description")
+     * +  }),
+     * +  outputSchema: z.number().describe("Result description"),
+     * });
+     */
+    <Args extends Zod3FunctionArgs, Returns extends Zod3FunctionReturns>(tool: TamboToolZod3Function<Args, Returns>, warnOnOverwrite?: boolean): void;
+    /**
+     * @deprecated Use `inputSchema`/`outputSchema` instead. toolSchema is deprecated
+     * and will be removed in future versions.
+     * @example
+     * ```diff
+     * import { z } from "zod/v4";
+     * const myTool = defineTamboTool({
+     *   ...
+     * -  toolSchema: z.function({
+     * -    input: z.tuple([z.string()]),
+     * -    output: z.number(),
+     * -  }),
+     * +  inputSchema: z.object({
+     * +    input: z.string().describe("Input description")
+     * +  }),
+     * +  outputSchema: z.number().describe("Result description"),
+     * });
+     */
+    <Args extends Zod4FunctionArgs, Returns extends Zod4FunctionReturns>(tool: TamboToolZod4Function<Args, Returns>, warnOnOverwrite?: boolean): void;
+    (tool: TamboToolWithToolSchema, warnOnOverwrite?: boolean): void;
+    <Args extends StandardSchemaV1, Returns extends StandardSchemaV1>(tool: TamboTool<StandardSchemaV1.InferOutput<Args>, StandardSchemaV1.InferOutput<Returns>>, warnOnOverwrite?: boolean): void;
+    <Args extends any[], Returns = any>(tool: TamboToolJSONSchema<Args, Returns>, warnOnOverwrite?: boolean): void;
+    (tool: TamboToolUnknown, warnOnOverwrite?: boolean): void;
+    (tool: TamboTool, warnOnOverwrite?: boolean): void;
+}
+/**
+ * Function interface for defining a Tambo tool with full type inference. This
+ * function has multiple overloads to handle different schema types. This is a
+ * utility function and does not perform any runtime logic.
+ */
+export interface DefineToolFn {
+    /**
+     * Provides type safety for defining a Tambo Tool.
+     *
+     * Tambo uses the [standard-schema.dev](https://standard-schema.dev) spec which means you can use any Standard Schema
+     * compliant validator (Zod, Valibot, ArkType, etc.). This definition ensures the input and output types are correctly
+     * inferred from the provided schemas.
+     * @example
+     * ```typescript
+     * import { z } from "zod/v4";
+     *
+     * const myTool = defineTamboTool({
+     *   // ...
+     *   inputSchema: z.object({
+     *     input: z.string().describe("Input description")
+     *   }),
+     *   outputSchema: z.number().describe("Result description"),
+     * });
+     * ```
+     * @see {@link https://standard-schema.dev/}
+     * @param tool The tool definition to register
+     * @returns The registered tool definition
+     */
+    <Input extends StandardSchemaV1, Output extends StandardSchemaV1>(tool: TamboToolStandardSchema<Input, Output>): TamboTool<StandardSchemaV1.InferOutput<Input>, StandardSchemaV1.InferOutput<Output>>;
+    /**
+     * Provides type safety for defining a Tambo Tool.
+     *
+     * This tool uses the deprecated `toolSchema` format which uses a zod function schema. If you are using a validation
+     * library that implements StandardSchema.dev, please switch to using separate `inputSchema` and `outputSchema`
+     * properties instead. See example below.
+     * @example
+     * ```diff
+     * import { z } from "zod/v4";
+     *
+     * const myTool = defineTamboTool({
+     *   // ...
+     * -  toolSchema: z.function({
+     * -    input: z.tuple([z.string()]),
+     * -    output: z.number(),
+     * -  })
+     * +  inputSchema: z.object({
+     * +    input: z.string().describe("Input description")
+     * +  }),
+     * +  outputSchema: z.number().describe("Result description"),
+     * });
+     * @see {@link https://standard-schema.dev/}
+     * @param tool The tool definition to register
+     * @returns The registered tool definition
+     * @deprecated Using `toolSchema` is deprecated. Please use separate `inputSchema` and `outputSchema` properties instead.
+     * Note that use of `toolSchema` will be removed in a future release.
+     * ```
+     */
+    <Args extends Zod3FunctionArgs, Returns extends Zod3FunctionReturns>(tool: TamboToolZod3Function<Args, Returns>): TamboToolZod3Function<Args, Returns>;
+    /**
+     * Provides type safety for defining a Tambo Tool.
+     *
+     * This tool uses the deprecated `toolSchema` format which uses a zod function schema. If you are using a validation
+     * library that implements standard-schema.dev, please switch to using separate `inputSchema` and `outputSchema`
+     * properties instead. See example below.
+     * @param tool The tool definition to register
+     * @returns The registered tool definition
+     * @deprecated Using `toolSchema` is deprecated. Please use separate `inputSchema` and `outputSchema` properties instead.
+     * Note that use of `toolSchema` will be removed in a future release.
+     * @example
+     * ```diff
+     * import { z } from "zod/v4";
+     *
+     * const myTool = defineTamboTool({
+     *   // ...
+     * -  toolSchema: z.function({
+     * -    input: z.tuple([z.string()]),
+     * -    output: z.number(),
+     * -  })
+     * +  inputSchema: z.object({
+     * +    input: z.string().describe("Input description")
+     * +  }),
+     * +  outputSchema: z.number().describe("Result description"),
+     * });
+     * ```
+     */
+    <Args extends Zod4FunctionArgs, Returns extends Zod4FunctionReturns>(tool: TamboToolZod4Function<Args, Returns>): TamboToolZod4Function<Args, Returns>;
+    /**
+     * Provides type safety for defining a Tambo Tool.
+     *
+     * This tool uses the deprecated `toolSchema` property which uses a zod function schema. If you are using a validation
+     * library that implements standard-schema.dev, please switch to using separate `inputSchema` and `outputSchema`
+     * properties instead. See example below.
+     * @param tool The tool definition to register
+     * @returns The registered tool definition
+     * @deprecated Using `toolSchema` is deprecated. Please use separate `inputSchema` and `outputSchema` properties instead.
+     * Note that use of `toolSchema` will be removed in a future release.
+     * @example
+     * ```diff
+     * import { z } from "zod/v4";
+     *
+     * const myTool = defineTamboTool({
+     *   // ...
+     * -  toolSchema: { ... }
+     * +  inputSchema: z.object({ ... }),
+     * +  outputSchema: z.number(),
+     * });
+     * ```
+     */
+    (tool: TamboToolWithToolSchema): TamboToolWithToolSchema;
+    /**
+     * Provides type safety for defining a Tambo Tool.
+     *
+     * This tool definition matched to JSON Schema input and output schemas which allows does not guarantee type
+     * safety. If you are using a validation library that implements
+     * [Standard Schema](https://standardschema.dev/#what-tools-frameworks-accept-speccompliant-schemas), please ensure
+     * your schemas are correctly typed.
+     * @see {@link https://standard-schema.dev/}
+     * @param tool The tool definition to register
+     * @returns The registered tool definition
+     */
+    <I extends any[], O = any>(tool: TamboToolJSONSchema<I, O>): TamboToolJSONSchema<I, O>;
+    /**
+     * Provides type safety for defining a Tambo Tool.
+     *
+     * This tool definition could not be matched to any known schema types which means type safety cannot be
+     * guaranteed. If you are using a validation library that implements
+     * [Standard Schema](https://standardschema.dev/#what-tools-frameworks-accept-speccompliant-schemas), please ensure
+     * your schemas are correctly typed.
+     * @example
+     * ```typescript
+     * const myTool = defineTamboTool({
+     *   name: "myTool",
+     *   description: "An example tool",
+     *   tool: (input) => { ... },
+     *   inputSchema: yourInputSchema,
+     *   outputSchema: yourOutputSchema,
+     * });
+     * @param tool The tool definition to register
+     * @returns The registered tool definition
+     * ```
+     */
+    (tool: TamboToolUnknown): TamboToolUnknown;
+    (tool: TamboTool): TamboTool;
 }
+export {};
 //# sourceMappingURL=component-metadata.d.ts.map

package/dist/model/component-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-metadata.d.ts","sourceRoot":"","sources":["../../src/model/component-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,CAAC,MAAM,QAAQ,CAAC;AACvB,OAAO,KAAK,eAAe,MAAM,oBAAoB,CAAC;AACtD,+FAA+F;AAC/F,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,GAAG;IACnD,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,4BACf,SAAQ,OAAO,CAAC,4BAA4B;IAC5C,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACtD,UAAU,EAAE,4BAA4B,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAoB,SAAQ,OAAO,CAAC,kBAAkB;IACrE,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC9B,gBAAgB,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEpE,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,GAAG;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,SAAS,CACxB,IAAI,SAAS,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EACxD,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IAE3C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnD,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,cAAc,CAAC;IAC1D;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CACnB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAEtB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC;CACtD;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAC7D;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAE9B;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,CAAC,UAAU,GAAG,WAAW,CAAC;IACzC;;;;OAIG;IACH,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IACtC,uDAAuD;IACvD,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC;CAC/B"}
+{"version":3,"file":"component-metadata.d.ts","sourceRoot":"","sources":["../../src/model/component-metadata.ts"],"names":[],"mappings":"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"}

package/dist/model/component-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-metadata.js","sourceRoot":"","sources":["../../src/model/component-metadata.ts"],"names":[],"mappings":"","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { JSONSchema7 } from \"json-schema\";\nimport { ComponentType } from \"react\";\nimport z from \"zod/v3\";\nimport type zodToJsonSchema from \"zod-to-json-schema\";\n/** Extension of the ToolParameters interface from Tambo AI to include JSONSchema definition */\nexport type ParameterSpec = TamboAI.ToolParameters & {\n  schema?: ReturnType<typeof zodToJsonSchema>;\n};\n\n/**\n * Extends the base ContextTool interface from Tambo AI to include schema information\n * for parameter validation using zod-to-json-schema.\n */\nexport interface ComponentContextToolMetadata\n  extends TamboAI.ComponentContextToolMetadata {\n  parameters: ParameterSpec[];\n}\n\nexport interface ComponentContextTool {\n  getComponentContext: (...args: any[]) => Promise<any>;\n  definition: ComponentContextToolMetadata;\n}\n\nexport interface RegisteredComponent extends TamboAI.AvailableComponent {\n  component: ComponentType<any>;\n  loadingComponent?: ComponentType<any>;\n}\n\nexport type ComponentRegistry = Record<string, RegisteredComponent>;\n\nexport type TamboToolRegistry = Record<string, TamboTool>;\n\n/**\n * A JSON Schema that is compatible with the MCP.\n * This is a simplified JSON Schema that is compatible with the MCPClient and the toolSchema.\n *\n * Do not export this type from the SDK.\n */\nexport type JSONSchemaLite = ReturnType<typeof zodToJsonSchema> & {\n  description?: string;\n};\n\nexport interface TamboTool<\n  Args extends z.ZodTuple<any, any> = z.ZodTuple<any, any>,\n  Returns extends z.ZodTypeAny = z.ZodTypeAny,\n> {\n  name: string;\n  description: string;\n  tool: (...args: z.infer<Args>) => z.infer<Returns>;\n  toolSchema: z.ZodFunction<Args, Returns> | JSONSchemaLite;\n  /**\n   * Optional function to transform the tool's return value into an array of content parts.\n   * If not provided, the return value will be converted to a string and wrapped in a text content part.\n   * @param result - The result returned by the tool function\n   * @returns An array of content parts to be sent back to the AI\n   */\n  transformToContent?: (\n    result: z.infer<Returns>,\n  ) =>\n    | Promise<TamboAI.Beta.Threads.ChatCompletionContentPart[]>\n    | TamboAI.Beta.Threads.ChatCompletionContentPart[];\n}\n\nexport type TamboToolAssociations = Record<string, string[]>;\n/**\n * A component that can be registered with the TamboRegistryProvider.\n */\n\nexport interface TamboComponent {\n  /** The name of the component */\n  name: string;\n  /** The description of the component */\n  description: string;\n  /**\n   * The React component to render.\n   *\n   * Make sure to pass the Component itself, not an instance of the component. For example,\n   * if you have a component like this:\n   *\n   * ```tsx\n   * const MyComponent = () => {\n   *   return <div>My Component</div>;\n   * };\n   * ```\n   *\n   * You should pass the `Component`:\n   *\n   * ```tsx\n   * const components = [MyComponent];\n   * <TamboRegistryProvider components={components} />\n   * ```\n   */\n  component: ComponentType<any>;\n\n  /**\n   * A zod schema for the component props. (Recommended)\n   * Either this or propsDefinition must be provided, but not both.\n   */\n  propsSchema?: z.ZodTypeAny | JSONSchema7;\n  /**\n   * The props definition of the component as a JSON object.\n   * Either this or propsSchema must be provided, but not both.\n   * @deprecated Use propsSchema instead.\n   */\n  propsDefinition?: any;\n  /** The loading component to render while the component is loading */\n  loadingComponent?: ComponentType<any>;\n  /** The tools that are associated with the component */\n  associatedTools?: TamboTool[];\n}\n"]}
+{"version":3,"file":"component-metadata.js","sourceRoot":"","sources":["../../src/model/component-metadata.ts"],"names":[],"mappings":"","sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { JSONSchema7 } from \"json-schema\";\nimport { ComponentType } from \"react\";\nimport {\n  ZodFunction as Zod3Function,\n  ZodTuple as Zod3FunctionArgs,\n  ZodType as Zod3FunctionReturns,\n  infer as Zod3Infer,\n} from \"zod/v3\";\nimport {\n  $ZodFunction as Zod4Function,\n  $ZodFunctionArgs as Zod4FunctionArgs,\n  $ZodType as Zod4FunctionReturns,\n  infer as Zod4Infer,\n} from \"zod/v4/core\";\n\n/**\n * A schema type that accepts either a Standard Schema compliant validator\n * (e.g., Zod, Valibot, ArkType) or a raw JSON Schema object.\n *\n * Standard Schema is a specification that provides a unified interface for\n * TypeScript validation libraries. Libraries like Zod implement this spec,\n * allowing us to accept any compliant validator without depending on a specific library.\n * @see https://standardschema.dev/\n */\nexport type SupportedSchema = StandardSchemaV1 | JSONSchema7;\n\n/** Extension of the ToolParameters interface from Tambo AI to include JSONSchema definition */\nexport type ParameterSpec = TamboAI.ToolParameters & {\n  schema?: JSONSchema7;\n};\n\n/**\n * Extends the base ContextTool interface from Tambo AI to include schema information\n * for parameter validation.\n */\nexport interface ComponentContextToolMetadata\n  extends TamboAI.ComponentContextToolMetadata {\n  parameters: ParameterSpec[];\n}\n\nexport interface ComponentContextTool {\n  getComponentContext: (...args: any[]) => Promise<any>;\n  definition: ComponentContextToolMetadata;\n}\n\nexport interface RegisteredComponent extends TamboAI.AvailableComponent {\n  component: ComponentType<any>;\n  loadingComponent?: ComponentType<any>;\n}\n\nexport type ComponentRegistry = Record<string, RegisteredComponent>;\n\nexport type TamboToolRegistry = Record<\n  string,\n  TamboTool | TamboToolWithToolSchema\n>;\n\n/**\n * A JSON Schema that is compatible with the MCP.\n * This is a simplified JSON Schema that is compatible with the MCPClient and the tool's inputSchema.\n *\n * Do not export this type from the SDK.\n */\nexport type JSONSchemaLite = JSONSchema7 & {\n  description?: string;\n};\n\ntype MaybeAsync<T> = T | Promise<T>;\n\n/**\n * TamboTool is a type that represents a tool that can be registered with Tambo.\n *\n * It is preferable to use the `defineTool` helper function to create tools, as\n * it provides better type inference and safety.\n * @example\n * ```ts\n * import { TamboTool, defineTool } from \"@tambo-ai/react\";\n * import { z } from \"zod\";\n *\n * const locationToLatLon = defineTool({\n *   name: \"location_to_latlon\",\n *   description:\n *     \"Fetch latitude and longitude from a location string. Returns an object with 'lat' and 'lon' properties.\",\n *   tool: async ({ location }) => getLatLonFromLocation(location),\n *   inputSchema: z.object({\n *     location: z.string(),\n *   }),\n *   outputSchema: z.object({\n *     lat: z.number(),\n *     lon: z.number(),\n *   }),\n * });\n * ```\n * Alternatively, you manually construct a TamboTool with type safety by passing\n * the expected parameter and return types as generics:\n * ```ts\n * import { TamboTool } from \"@tambo-ai/react\";\n * import { z } from \"zod\";\n *\n * const locationToLatLon: TamboTool<{ location: string }, { lat: number; lon: number }> = {\n *   name: \"location_to_latlon\",\n *   description:\n *     \"Fetch latitude and longitude from a location string. Returns an object with 'lat' and 'lon' properties.\",\n *   tool: async ({ location }) => getLatLonFromLocation(location),\n *   inputSchema: z.object({\n *     location: z.string(),\n *   }),\n *   outputSchema: z.object({\n *     lat: z.number(),\n *     lon: z.number(),\n *   }),\n * });\n * ```\n */\nexport interface TamboTool<\n  Params = any,\n  Returns = any,\n  Rest extends any[] = [],\n> {\n  /**\n   * Unique identifier for the tool\n   */\n  name: string;\n  /**\n   * Description of what the tool does - used by AI to determine when to use it\n   */\n  description: string;\n  /**\n   * Optional human-readable name of the tool for display purposes.\n   */\n  title?: string;\n  /**\n   * Optional properties describing tool behavior\n   */\n  annotations?: {\n    /**\n     * An array indicating the intended audience(s) for this resource. Valid\n     * values are \"user\" and \"assistant\". For example, [\"user\", \"assistant\"]\n     * indicates content useful for both.\n     */\n    audience: (\"user\" | \"assistant\")[];\n    /**\n     * A number from 0.0 to 1.0 indicating the importance of this resource. A\n     * value of 1 means \"most important\" (effectively required), while 0 means\n     * \"least important\" (entirely optional).\n     */\n    priority: number;\n    /**\n     * An ISO 8601 formatted timestamp indicating when the resource was last\n     * modified (e.g., \"2025-01-12T15:00:58Z\").\n     */\n    lastModified: string;\n  };\n\n  /**\n   * The function that implements the tool's logic. This function will be called\n   * by Tambo when the model decides to invoke the tool.\n   * @param params - The input parameters for the tool. These are validated\n   * against the inputSchema before being passed so are guaranteed to be correct\n   * when called by the model.\n   * @returns The result of the tool execution, which can be a value or a\n   * Promise resolving to a value\n   */\n  tool: (params: Params, ...rest: Rest) => MaybeAsync<Returns>;\n\n  /**\n   * The schema for the tool's input parameters. This can be a validator from\n   * any Standard Schema compliant library (Zod, Valibot, ArkType, etc.) or a\n   * raw JSON Schema object.\n   *\n   * This schema is used to validate and parse the parameters before passing\n   * them to the tool function.\n   */\n  inputSchema: SupportedSchema | unknown;\n\n  /**\n   * The schema for the tool's output/return value. This can be any Standard Schema\n   * compliant validator (Zod, Valibot, ArkType, etc.) or a raw JSON Schema object.\n   *\n   * This is used to inform the model about the structure of the tool's return value\n   * and is not used for runtime validation at this stage.\n   */\n  outputSchema: SupportedSchema | unknown;\n\n  /**\n   * Optional function to transform the tool's return value into an array of content parts.\n   * If not provided, the return value will be converted to a string and wrapped in a text content part.\n   * @param result - The result returned by the tool function\n   * @returns An array of content parts to be sent back to the AI\n   */\n  transformToContent?: (\n    result: any,\n  ) =>\n    | Promise<TamboAI.Beta.Threads.ChatCompletionContentPart[]>\n    | TamboAI.Beta.Threads.ChatCompletionContentPart[];\n}\n\n/**\n * Simplified interface for tools using the deprecated toolSchema format.\n * This interface uses simple `any` types to avoid complex type instantiation.\n * Use `defineTamboTool()` for full type inference when creating tools.\n * @deprecated Use TamboTool with `inputSchema`/`outputSchema` instead.\n */\nexport type TamboToolWithToolSchema<\n  Args extends any[] = any[],\n  Returns = any,\n> = Omit<TamboTool, \"tool\" | \"inputSchema\" | \"outputSchema\"> & {\n  tool: (...args: Args) => MaybeAsync<Returns>;\n  /** @deprecated Use `inputSchema`/`outputSchema` properties instead. */\n  toolSchema: unknown;\n};\n\n// NOTE(lachieh): this comment mirrors the one from `TamboTool` above\n/**\n * TamboTool is a type that represents a tool that can be registered with Tambo.\n *\n * It is preferable to use the `defineTool` helper function to create tools, as\n * it provides better type inference and safety.\n * @example\n * ```ts\n * import { TamboTool, defineTool } from \"@tambo-ai/react\";\n * import { z } from \"zod\";\n *\n * const locationToLatLon = defineTool({\n *   name: \"location_to_latlon\",\n *   description:\n *     \"Fetch latitude and longitude from a location string. Returns an object with 'lat' and 'lon' properties.\",\n *   tool: async ({ location }) => getLatLonFromLocation(location),\n *   inputSchema: z.object({\n *     location: z.string(),\n *   }),\n *   outputSchema: z.object({\n *     lat: z.number(),\n *     lon: z.number(),\n *   }),\n * });\n * ```\n * Alternatively, you manually construct a TamboTool with type safety by passing\n * the expected parameter and return types as generics:\n * ```ts\n * import { TamboTool } from \"@tambo-ai/react\";\n * import { z } from \"zod\";\n *\n * const locationToLatLon: TamboTool<{ location: string }, { lat: number; lon: number }> = {\n *   name: \"location_to_latlon\",\n *   description:\n *     \"Fetch latitude and longitude from a location string. Returns an object with 'lat' and 'lon' properties.\",\n *   tool: async ({ location }) => getLatLonFromLocation(location),\n *   inputSchema: z.object({\n *     location: z.string(),\n *   }),\n *   outputSchema: z.object({\n *     lat: z.number(),\n *     lon: z.number(),\n *   }),\n * });\n * ```\n */\nexport type TamboToolBase<Params = any, Returns = any> =\n  | TamboToolWithToolSchema\n  | TamboTool<Params, Returns>;\n\n/**\n * A tool that uses JSON Schema compliant input and output schemas.\n * This does not provide type safety for the tool's parameters and return value.\n * @internal\n */\nexport type TamboToolJSONSchema<\n  Args extends unknown[] = unknown[],\n  Returns = unknown,\n> = Omit<TamboTool<Args, Returns>, \"tool\" | \"inputSchema\" | \"outputSchema\"> & {\n  tool: (...args: Args) => MaybeAsync<Returns>;\n  inputSchema: JSONSchemaLite;\n  outputSchema: JSONSchemaLite;\n};\n\n/**\n * A tool that could not be matched to any known schema types.\n * This means type safety cannot be guaranteed.\n * @internal\n */\nexport type TamboToolUnknown = Omit<\n  TamboTool,\n  \"tool\" | \"inputSchema\" | \"outputSchema\"\n> & {\n  tool: (...args: unknown[]) => MaybeAsync<unknown>;\n  inputSchema: unknown;\n  outputSchema: unknown;\n};\n\n/**\n * A tool that uses Standard Schema compliant input and output schemas.\n * This provides full type safety for the tool's parameters and return value.\n * @internal\n */\nexport type TamboToolStandardSchema<\n  Input extends StandardSchemaV1 = StandardSchemaV1,\n  Output extends StandardSchemaV1 = StandardSchemaV1,\n> = Omit<\n  TamboTool<\n    StandardSchemaV1.InferOutput<Input>,\n    StandardSchemaV1.InferOutput<Output>\n  >,\n  \"tool\" | \"inputSchema\" | \"outputSchema\"\n> & {\n  tool: (\n    ...args: [StandardSchemaV1.InferOutput<Input>]\n  ) => MaybeAsync<StandardSchemaV1.InferOutput<Output>>;\n  inputSchema: Input;\n  outputSchema: Output;\n};\n\ntype TamboToolZod3Function<\n  Args extends Zod3FunctionArgs,\n  Returns extends Zod3FunctionReturns,\n> = Omit<\n  TamboToolWithToolSchema<Zod3Infer<Args>, Zod3Infer<Returns>>,\n  \"toolSchema\"\n> & {\n  tool: (...args: Zod3Infer<Args>) => MaybeAsync<Zod3Infer<Returns>>;\n  /** @deprecated Use `inputSchema`/`outputSchema` properties instead. */\n  toolSchema: Zod3Function<Args, Returns>;\n};\n\ntype TamboToolZod4Function<\n  Args extends Zod4FunctionArgs,\n  Returns extends Zod4FunctionReturns,\n> = Omit<\n  TamboToolWithToolSchema<Zod4Infer<Args>, Zod4Infer<Returns>>,\n  \"toolSchema\"\n> & {\n  tool: (...args: Zod4Infer<Args>) => MaybeAsync<Zod4Infer<Returns>>;\n  /** @deprecated Use `inputSchema`/`outputSchema` properties instead. */\n  toolSchema: Zod4Function<Args, Returns>;\n};\n\nexport type TamboToolAssociations = Record<string, string[]>;\n/**\n * A component that can be registered with the TamboRegistryProvider.\n */\n\nexport interface TamboComponent {\n  /** The name of the component */\n  name: string;\n  /** The description of the component */\n  description: string;\n  /**\n   * The React component to render.\n   *\n   * Make sure to pass the Component itself, not an instance of the component. For example,\n   * if you have a component like this:\n   *\n   * ```tsx\n   * const MyComponent = () => {\n   *   return <div>My Component</div>;\n   * };\n   * ```\n   *\n   * You should pass the `Component`:\n   *\n   * ```tsx\n   * const components = [MyComponent];\n   * <TamboRegistryProvider components={components} />\n   * ```\n   */\n  component: ComponentType<any>;\n\n  /**\n   * Schema describing the component's props. Accepts any Standard Schema\n   * compliant validator (Zod, Valibot, ArkType, etc.) or a raw JSON Schema\n   * object.\n   *\n   * Either this or propsDefinition must be provided, but not both.\n   * @example\n   * ```typescript\n   * import { z } from \"zod/v4\";\n   *\n   * const component: TamboComponent = {\n   *   name: \"MyComponent\",\n   *   description: \"A sample component\",\n   *   component: MyComponent,\n   *   propsSchema: z.object({\n   *     title: z.string(),\n   *     count: z.number().optional()\n   *   })\n   * };\n   * ```\n   */\n  propsSchema?: SupportedSchema;\n  /**\n   * The props definition of the component as a JSON object.\n   * Either this or propsSchema must be provided, but not both.\n   * @deprecated Use propsSchema instead.\n   */\n  propsDefinition?: any;\n  /** The loading component to render while the component is loading */\n  loadingComponent?: ComponentType<any>;\n  /** The tools that are associated with the component */\n  associatedTools?: (TamboTool | TamboToolWithToolSchema)[];\n}\n\nexport interface RegisterToolsFn {\n  /**\n   * Registers one or more Tambo tools.\n   * @param tools - An array of Tambo tools to register\n   */\n  (tools: TamboTool[]): void;\n  (tools: (TamboTool | TamboToolWithToolSchema)[]): void;\n}\n\n/**\n * Function interface for registering a Tambo tool with full type inference.\n * This function has multiple overloads to handle different schema types. This\n * is a utility function and does not perform any runtime logic.\n */\nexport interface RegisterToolFn {\n  /**\n   * @deprecated Use `inputSchema`/`outputSchema` instead. toolSchema is deprecated\n   * and will be removed in future versions.\n   * @example\n   * ```diff\n   * import { z } from \"zod/v3\";\n   * const myTool = defineTamboTool({\n   *   ...\n   * -  toolSchema: z.function()\n   * -    .arguments(z.tuple([z.string()]))\n   * -    .returns(z.number()),\n   * +  inputSchema: z.object({\n   * +    input: z.string().describe(\"Input description\")\n   * +  }),\n   * +  outputSchema: z.number().describe(\"Result description\"),\n   * });\n   */\n  <Args extends Zod3FunctionArgs, Returns extends Zod3FunctionReturns>(\n    tool: TamboToolZod3Function<Args, Returns>,\n    warnOnOverwrite?: boolean,\n  ): void;\n  /**\n   * @deprecated Use `inputSchema`/`outputSchema` instead. toolSchema is deprecated\n   * and will be removed in future versions.\n   * @example\n   * ```diff\n   * import { z } from \"zod/v4\";\n   * const myTool = defineTamboTool({\n   *   ...\n   * -  toolSchema: z.function({\n   * -    input: z.tuple([z.string()]),\n   * -    output: z.number(),\n   * -  }),\n   * +  inputSchema: z.object({\n   * +    input: z.string().describe(\"Input description\")\n   * +  }),\n   * +  outputSchema: z.number().describe(\"Result description\"),\n   * });\n   */\n  <Args extends Zod4FunctionArgs, Returns extends Zod4FunctionReturns>(\n    tool: TamboToolZod4Function<Args, Returns>,\n    warnOnOverwrite?: boolean,\n  ): void;\n  (tool: TamboToolWithToolSchema, warnOnOverwrite?: boolean): void;\n  <Args extends StandardSchemaV1, Returns extends StandardSchemaV1>(\n    tool: TamboTool<\n      StandardSchemaV1.InferOutput<Args>,\n      StandardSchemaV1.InferOutput<Returns>\n    >,\n    warnOnOverwrite?: boolean,\n  ): void;\n  <Args extends any[], Returns = any>(\n    tool: TamboToolJSONSchema<Args, Returns>,\n    warnOnOverwrite?: boolean,\n  ): void;\n  (tool: TamboToolUnknown, warnOnOverwrite?: boolean): void;\n  (tool: TamboTool, warnOnOverwrite?: boolean): void;\n}\n\n/**\n * Function interface for defining a Tambo tool with full type inference. This\n * function has multiple overloads to handle different schema types. This is a\n * utility function and does not perform any runtime logic.\n */\nexport interface DefineToolFn {\n  /**\n   * Provides type safety for defining a Tambo Tool.\n   *\n   * Tambo uses the [standard-schema.dev](https://standard-schema.dev) spec which means you can use any Standard Schema\n   * compliant validator (Zod, Valibot, ArkType, etc.). This definition ensures the input and output types are correctly\n   * inferred from the provided schemas.\n   * @example\n   * ```typescript\n   * import { z } from \"zod/v4\";\n   *\n   * const myTool = defineTamboTool({\n   *   // ...\n   *   inputSchema: z.object({\n   *     input: z.string().describe(\"Input description\")\n   *   }),\n   *   outputSchema: z.number().describe(\"Result description\"),\n   * });\n   * ```\n   * @see {@link https://standard-schema.dev/}\n   * @param tool The tool definition to register\n   * @returns The registered tool definition\n   */\n  <Input extends StandardSchemaV1, Output extends StandardSchemaV1>(\n    tool: TamboToolStandardSchema<Input, Output>,\n  ): TamboTool<\n    StandardSchemaV1.InferOutput<Input>,\n    StandardSchemaV1.InferOutput<Output>\n  >;\n  /**\n   * Provides type safety for defining a Tambo Tool.\n   *\n   * This tool uses the deprecated `toolSchema` format which uses a zod function schema. If you are using a validation\n   * library that implements StandardSchema.dev, please switch to using separate `inputSchema` and `outputSchema`\n   * properties instead. See example below.\n   * @example\n   * ```diff\n   * import { z } from \"zod/v4\";\n   *\n   * const myTool = defineTamboTool({\n   *   // ...\n   * -  toolSchema: z.function({\n   * -    input: z.tuple([z.string()]),\n   * -    output: z.number(),\n   * -  })\n   * +  inputSchema: z.object({\n   * +    input: z.string().describe(\"Input description\")\n   * +  }),\n   * +  outputSchema: z.number().describe(\"Result description\"),\n   * });\n   * @see {@link https://standard-schema.dev/}\n   * @param tool The tool definition to register\n   * @returns The registered tool definition\n   * @deprecated Using `toolSchema` is deprecated. Please use separate `inputSchema` and `outputSchema` properties instead.\n   * Note that use of `toolSchema` will be removed in a future release.\n   * ```\n   */\n  <Args extends Zod3FunctionArgs, Returns extends Zod3FunctionReturns>(\n    tool: TamboToolZod3Function<Args, Returns>,\n  ): TamboToolZod3Function<Args, Returns>;\n  /**\n   * Provides type safety for defining a Tambo Tool.\n   *\n   * This tool uses the deprecated `toolSchema` format which uses a zod function schema. If you are using a validation\n   * library that implements standard-schema.dev, please switch to using separate `inputSchema` and `outputSchema`\n   * properties instead. See example below.\n   * @param tool The tool definition to register\n   * @returns The registered tool definition\n   * @deprecated Using `toolSchema` is deprecated. Please use separate `inputSchema` and `outputSchema` properties instead.\n   * Note that use of `toolSchema` will be removed in a future release.\n   * @example\n   * ```diff\n   * import { z } from \"zod/v4\";\n   *\n   * const myTool = defineTamboTool({\n   *   // ...\n   * -  toolSchema: z.function({\n   * -    input: z.tuple([z.string()]),\n   * -    output: z.number(),\n   * -  })\n   * +  inputSchema: z.object({\n   * +    input: z.string().describe(\"Input description\")\n   * +  }),\n   * +  outputSchema: z.number().describe(\"Result description\"),\n   * });\n   * ```\n   */\n  <Args extends Zod4FunctionArgs, Returns extends Zod4FunctionReturns>(\n    tool: TamboToolZod4Function<Args, Returns>,\n  ): TamboToolZod4Function<Args, Returns>;\n  /**\n   * Provides type safety for defining a Tambo Tool.\n   *\n   * This tool uses the deprecated `toolSchema` property which uses a zod function schema. If you are using a validation\n   * library that implements standard-schema.dev, please switch to using separate `inputSchema` and `outputSchema`\n   * properties instead. See example below.\n   * @param tool The tool definition to register\n   * @returns The registered tool definition\n   * @deprecated Using `toolSchema` is deprecated. Please use separate `inputSchema` and `outputSchema` properties instead.\n   * Note that use of `toolSchema` will be removed in a future release.\n   * @example\n   * ```diff\n   * import { z } from \"zod/v4\";\n   *\n   * const myTool = defineTamboTool({\n   *   // ...\n   * -  toolSchema: { ... }\n   * +  inputSchema: z.object({ ... }),\n   * +  outputSchema: z.number(),\n   * });\n   * ```\n   */\n  (tool: TamboToolWithToolSchema): TamboToolWithToolSchema;\n  /**\n   * Provides type safety for defining a Tambo Tool.\n   *\n   * This tool definition matched to JSON Schema input and output schemas which allows does not guarantee type\n   * safety. If you are using a validation library that implements\n   * [Standard Schema](https://standardschema.dev/#what-tools-frameworks-accept-speccompliant-schemas), please ensure\n   * your schemas are correctly typed.\n   * @see {@link https://standard-schema.dev/}\n   * @param tool The tool definition to register\n   * @returns The registered tool definition\n   */\n  <I extends any[], O = any>(\n    tool: TamboToolJSONSchema<I, O>,\n  ): TamboToolJSONSchema<I, O>;\n  /**\n   * Provides type safety for defining a Tambo Tool.\n   *\n   * This tool definition could not be matched to any known schema types which means type safety cannot be\n   * guaranteed. If you are using a validation library that implements\n   * [Standard Schema](https://standardschema.dev/#what-tools-frameworks-accept-speccompliant-schemas), please ensure\n   * your schemas are correctly typed.\n   * @example\n   * ```typescript\n   * const myTool = defineTamboTool({\n   *   name: \"myTool\",\n   *   description: \"An example tool\",\n   *   tool: (input) => { ... },\n   *   inputSchema: yourInputSchema,\n   *   outputSchema: yourOutputSchema,\n   * });\n   * @param tool The tool definition to register\n   * @returns The registered tool definition\n   * ```\n   */\n  (tool: TamboToolUnknown): TamboToolUnknown;\n  (tool: TamboTool): TamboTool;\n}\n"]}

package/dist/model/generate-component-response.d.ts

@@ -1,11 +1,22 @@
 import TamboAI from "@tambo-ai/typescript-sdk";
 import { ReactElement } from "react";
+import type { InteractableConfig } from "../hoc/with-tambo-interactable";
+/**
+ * Metadata for interactable components.
+ * Used when a component is wrapped with withInteractable.
+ */
+export interface InteractableMetadata extends InteractableConfig {
+    /** Unique identifier for this interactable instance */
+    id: string;
+}
 /**
  * An extension of the TamboAI.Beta.Threads.ThreadMessage type that includes a
- * renderedComponent
+ * renderedComponent and optional interactable metadata
  */
 export interface TamboThreadMessage extends TamboAI.Beta.Threads.ThreadMessage {
     renderedComponent?: ReactElement | null;
+    /** Optional metadata for interactable components */
+    interactableMetadata?: InteractableMetadata;
 }
 export declare enum GenerationStage {
     IDLE = "IDLE",

package/dist/model/generate-component-response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-component-response.d.ts","sourceRoot":"","sources":["../../src/model/generate-component-response.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa;IAC5E,iBAAiB,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACzC;AAED,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,kBAAkB,uBAAuB;IACzC,gBAAgB,qBAAqB;IACrC,mBAAmB,wBAAwB;IAC3C,kBAAkB,uBAAuB;IACzC,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,SAAS,cAAc;CACxB;AACD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,eAAe,EAAE,eAAe,WAO3D"}
+{"version":3,"file":"generate-component-response.d.ts","sourceRoot":"","sources":["../../src/model/generate-component-response.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa;IAC5E,iBAAiB,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACxC,oDAAoD;IACpD,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,kBAAkB,uBAAuB;IACzC,gBAAgB,qBAAqB;IACrC,mBAAmB,wBAAwB;IAC3C,kBAAkB,uBAAuB;IACzC,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,SAAS,cAAc;CACxB;AACD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,eAAe,EAAE,eAAe,WAO3D"}

package/dist/model/generate-component-response.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-component-response.js","sourceRoot":"","sources":["../../src/model/generate-component-response.ts"],"names":[],"mappings":";;;AA0BA,kCAOC;AAtBD,IAAY,eASX;AATD,WAAY,eAAe;IACzB,gCAAa,CAAA;IACb,4DAAyC,CAAA;IACzC,wDAAqC,CAAA;IACrC,8DAA2C,CAAA;IAC3C,4DAAyC,CAAA;IACzC,wCAAqB,CAAA;IACrB,kCAAe,CAAA;IACf,0CAAuB,CAAA;AACzB,CAAC,EATW,eAAe,+BAAf,eAAe,QAS1B;AACD;;;;GAIG;AACH,SAAgB,WAAW,CAAC,eAAgC;IAC1D,OAAO;QACL,eAAe,CAAC,IAAI;QACpB,eAAe,CAAC,QAAQ;QACxB,eAAe,CAAC,KAAK;QACrB,eAAe,CAAC,SAAS;KAC1B,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { ReactElement } from \"react\";\n\n/**\n * An extension of the TamboAI.Beta.Threads.ThreadMessage type that includes a\n * renderedComponent\n */\nexport interface TamboThreadMessage extends TamboAI.Beta.Threads.ThreadMessage {\n  renderedComponent?: ReactElement | null;\n}\n\nexport enum GenerationStage {\n  IDLE = \"IDLE\",\n  CHOOSING_COMPONENT = \"CHOOSING_COMPONENT\",\n  FETCHING_CONTEXT = \"FETCHING_CONTEXT\",\n  HYDRATING_COMPONENT = \"HYDRATING_COMPONENT\",\n  STREAMING_RESPONSE = \"STREAMING_RESPONSE\",\n  COMPLETE = \"COMPLETE\",\n  ERROR = \"ERROR\",\n  CANCELLED = \"CANCELLED\",\n}\n/**\n * Checks if the generation stage is in a state where it can accept user input.\n * @param generationStage - The generation stage to check\n * @returns True if the generation stage is idle, false otherwise\n */\nexport function isIdleStage(generationStage: GenerationStage) {\n  return [\n    GenerationStage.IDLE,\n    GenerationStage.COMPLETE,\n    GenerationStage.ERROR,\n    GenerationStage.CANCELLED,\n  ].includes(generationStage);\n}\n"]}
+{"version":3,"file":"generate-component-response.js","sourceRoot":"","sources":["../../src/model/generate-component-response.ts"],"names":[],"mappings":";;;AAsCA,kCAOC;AAtBD,IAAY,eASX;AATD,WAAY,eAAe;IACzB,gCAAa,CAAA;IACb,4DAAyC,CAAA;IACzC,wDAAqC,CAAA;IACrC,8DAA2C,CAAA;IAC3C,4DAAyC,CAAA;IACzC,wCAAqB,CAAA;IACrB,kCAAe,CAAA;IACf,0CAAuB,CAAA;AACzB,CAAC,EATW,eAAe,+BAAf,eAAe,QAS1B;AACD;;;;GAIG;AACH,SAAgB,WAAW,CAAC,eAAgC;IAC1D,OAAO;QACL,eAAe,CAAC,IAAI;QACpB,eAAe,CAAC,QAAQ;QACxB,eAAe,CAAC,KAAK;QACrB,eAAe,CAAC,SAAS;KAC1B,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { ReactElement } from \"react\";\nimport type { InteractableConfig } from \"../hoc/with-tambo-interactable\";\n\n/**\n * Metadata for interactable components.\n * Used when a component is wrapped with withInteractable.\n */\nexport interface InteractableMetadata extends InteractableConfig {\n  /** Unique identifier for this interactable instance */\n  id: string;\n}\n\n/**\n * An extension of the TamboAI.Beta.Threads.ThreadMessage type that includes a\n * renderedComponent and optional interactable metadata\n */\nexport interface TamboThreadMessage extends TamboAI.Beta.Threads.ThreadMessage {\n  renderedComponent?: ReactElement | null;\n  /** Optional metadata for interactable components */\n  interactableMetadata?: InteractableMetadata;\n}\n\nexport enum GenerationStage {\n  IDLE = \"IDLE\",\n  CHOOSING_COMPONENT = \"CHOOSING_COMPONENT\",\n  FETCHING_CONTEXT = \"FETCHING_CONTEXT\",\n  HYDRATING_COMPONENT = \"HYDRATING_COMPONENT\",\n  STREAMING_RESPONSE = \"STREAMING_RESPONSE\",\n  COMPLETE = \"COMPLETE\",\n  ERROR = \"ERROR\",\n  CANCELLED = \"CANCELLED\",\n}\n/**\n * Checks if the generation stage is in a state where it can accept user input.\n * @param generationStage - The generation stage to check\n * @returns True if the generation stage is idle, false otherwise\n */\nexport function isIdleStage(generationStage: GenerationStage) {\n  return [\n    GenerationStage.IDLE,\n    GenerationStage.COMPLETE,\n    GenerationStage.ERROR,\n    GenerationStage.CANCELLED,\n  ].includes(generationStage);\n}\n"]}