@tambo-ai/react 0.69.1 → 0.71.0

package/esm/v1/utils/tool-executor.test.js

@@ -0,0 +1,220 @@
+import { z } from "zod";
+import { executeClientTool, executeAllPendingTools, } from "./tool-executor";
+describe("tool-executor", () => {
+    describe("executeClientTool", () => {
+        it("executes a tool and returns text result", async () => {
+            const tool = {
+                name: "get_weather",
+                description: "Gets weather",
+                tool: async ({ city }) => `Weather in ${city} is sunny`,
+                inputSchema: z.object({ city: z.string() }),
+                outputSchema: z.string(),
+            };
+            const result = await executeClientTool(tool, "call-1", {
+                city: "Seattle",
+            });
+            expect(result).toEqual({
+                type: "tool_result",
+                toolUseId: "call-1",
+                content: [{ type: "text", text: "Weather in Seattle is sunny" }],
+            });
+        });
+        it("stringifies non-string results", async () => {
+            const tool = {
+                name: "get_data",
+                description: "Gets data",
+                tool: async () => ({ value: 42 }),
+                inputSchema: z.object({}),
+                outputSchema: z.object({ value: z.number() }),
+            };
+            const result = await executeClientTool(tool, "call-2", {});
+            expect(result).toEqual({
+                type: "tool_result",
+                toolUseId: "call-2",
+                content: [{ type: "text", text: '{"value":42}' }],
+            });
+        });
+        it("uses transformToContent when provided", async () => {
+            const tool = {
+                name: "custom_tool",
+                description: "Custom tool",
+                tool: async () => "custom result",
+                inputSchema: z.object({}),
+                outputSchema: z.string(),
+                transformToContent: (result) => [
+                    { type: "text", text: `Transformed: ${result}` },
+                ],
+            };
+            const result = await executeClientTool(tool, "call-3", {});
+            expect(result).toEqual({
+                type: "tool_result",
+                toolUseId: "call-3",
+                content: [{ type: "text", text: "Transformed: custom result" }],
+            });
+        });
+        it("handles transformToContent with non-text types by stringifying", async () => {
+            const tool = {
+                name: "image_tool",
+                description: "Image tool",
+                tool: async () => "image data",
+                inputSchema: z.object({}),
+                outputSchema: z.string(),
+                transformToContent: () => [
+                    {
+                        type: "image_url",
+                        image_url: { url: "https://example.com/image.png" },
+                    },
+                ],
+            };
+            const result = await executeClientTool(tool, "call-4", {});
+            expect(result).toEqual({
+                type: "tool_result",
+                toolUseId: "call-4",
+                content: [
+                    {
+                        type: "text",
+                        text: '{"type":"image_url","image_url":{"url":"https://example.com/image.png"}}',
+                    },
+                ],
+            });
+        });
+        it("handles tool execution errors gracefully", async () => {
+            const tool = {
+                name: "failing_tool",
+                description: "A tool that fails",
+                tool: async () => {
+                    throw new Error("Tool failed!");
+                },
+                inputSchema: z.object({}),
+                outputSchema: z.void(),
+            };
+            const result = await executeClientTool(tool, "call-5", {});
+            expect(result).toEqual({
+                type: "tool_result",
+                toolUseId: "call-5",
+                content: [{ type: "text", text: "Tool failed!" }],
+            });
+        });
+        it("handles non-Error throws gracefully", async () => {
+            const tool = {
+                name: "throwing_tool",
+                description: "A tool that throws a string",
+                tool: async () => {
+                    throw "string error";
+                },
+                inputSchema: z.object({}),
+                outputSchema: z.void(),
+            };
+            const result = await executeClientTool(tool, "call-6", {});
+            expect(result).toEqual({
+                type: "tool_result",
+                toolUseId: "call-6",
+                content: [{ type: "text", text: "Tool execution failed" }],
+            });
+        });
+    });
+    describe("executeAllPendingTools", () => {
+        it("executes multiple tools with Map registry", async () => {
+            const registry = new Map([
+                [
+                    "add",
+                    {
+                        name: "add",
+                        description: "Adds numbers",
+                        tool: async ({ a, b }) => a + b,
+                        inputSchema: z.object({ a: z.number(), b: z.number() }),
+                        outputSchema: z.number(),
+                    },
+                ],
+                [
+                    "multiply",
+                    {
+                        name: "multiply",
+                        description: "Multiplies numbers",
+                        tool: async ({ a, b }) => a * b,
+                        inputSchema: z.object({ a: z.number(), b: z.number() }),
+                        outputSchema: z.number(),
+                    },
+                ],
+            ]);
+            const toolCalls = new Map([
+                ["call-1", { name: "add", input: { a: 2, b: 3 } }],
+                ["call-2", { name: "multiply", input: { a: 4, b: 5 } }],
+            ]);
+            const results = await executeAllPendingTools(toolCalls, registry);
+            expect(results).toHaveLength(2);
+            expect(results[0]).toEqual({
+                type: "tool_result",
+                toolUseId: "call-1",
+                content: [{ type: "text", text: "5" }],
+            });
+            expect(results[1]).toEqual({
+                type: "tool_result",
+                toolUseId: "call-2",
+                content: [{ type: "text", text: "20" }],
+            });
+        });
+        it("executes tools with Record registry", async () => {
+            const registry = {
+                greet: {
+                    name: "greet",
+                    description: "Greets user",
+                    tool: async ({ name }) => `Hello, ${name}!`,
+                    inputSchema: z.object({ name: z.string() }),
+                    outputSchema: z.string(),
+                },
+            };
+            const toolCalls = new Map([
+                ["call-1", { name: "greet", input: { name: "World" } }],
+            ]);
+            const results = await executeAllPendingTools(toolCalls, registry);
+            expect(results).toHaveLength(1);
+            expect(results[0]).toEqual({
+                type: "tool_result",
+                toolUseId: "call-1",
+                content: [{ type: "text", text: "Hello, World!" }],
+            });
+        });
+        it("returns error result for unknown tools", async () => {
+            const registry = new Map();
+            const toolCalls = new Map([
+                ["call-1", { name: "unknown_tool", input: {} }],
+            ]);
+            const results = await executeAllPendingTools(toolCalls, registry);
+            expect(results).toHaveLength(1);
+            expect(results[0]).toEqual({
+                type: "tool_result",
+                toolUseId: "call-1",
+                content: [
+                    { type: "text", text: 'Tool "unknown_tool" not found in registry' },
+                ],
+            });
+        });
+        it("handles mixed known and unknown tools", async () => {
+            const registry = new Map([
+                [
+                    "known",
+                    {
+                        name: "known",
+                        description: "Known tool",
+                        tool: async () => "success",
+                        inputSchema: z.object({}),
+                        outputSchema: z.string(),
+                    },
+                ],
+            ]);
+            const toolCalls = new Map([
+                ["call-1", { name: "known", input: {} }],
+                ["call-2", { name: "unknown", input: {} }],
+            ]);
+            const results = await executeAllPendingTools(toolCalls, registry);
+            expect(results).toHaveLength(2);
+            expect(results[0].content[0]).toEqual({ type: "text", text: "success" });
+            expect(results[1].content[0]).toEqual({
+                type: "text",
+                text: 'Tool "unknown" not found in registry',
+            });
+        });
+    });
+});
+//# sourceMappingURL=tool-executor.test.js.map

package/esm/v1/utils/tool-executor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.test.js","sourceRoot":"","sources":["../../../src/v1/utils/tool-executor.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport type { TamboTool } from \"../../model/component-metadata\";\nimport {\n  executeClientTool,\n  executeAllPendingTools,\n  type PendingToolCall,\n} from \"./tool-executor\";\n\ndescribe(\"tool-executor\", () => {\n  describe(\"executeClientTool\", () => {\n    it(\"executes a tool and returns text result\", async () => {\n      const tool: TamboTool = {\n        name: \"get_weather\",\n        description: \"Gets weather\",\n        tool: async ({ city }: { city: string }) =>\n          `Weather in ${city} is sunny`,\n        inputSchema: z.object({ city: z.string() }),\n        outputSchema: z.string(),\n      };\n\n      const result = await executeClientTool(tool, \"call-1\", {\n        city: \"Seattle\",\n      });\n\n      expect(result).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-1\",\n        content: [{ type: \"text\", text: \"Weather in Seattle is sunny\" }],\n      });\n    });\n\n    it(\"stringifies non-string results\", async () => {\n      const tool: TamboTool = {\n        name: \"get_data\",\n        description: \"Gets data\",\n        tool: async () => ({ value: 42 }),\n        inputSchema: z.object({}),\n        outputSchema: z.object({ value: z.number() }),\n      };\n\n      const result = await executeClientTool(tool, \"call-2\", {});\n\n      expect(result).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-2\",\n        content: [{ type: \"text\", text: '{\"value\":42}' }],\n      });\n    });\n\n    it(\"uses transformToContent when provided\", async () => {\n      const tool: TamboTool = {\n        name: \"custom_tool\",\n        description: \"Custom tool\",\n        tool: async () => \"custom result\",\n        inputSchema: z.object({}),\n        outputSchema: z.string(),\n        transformToContent: (result) => [\n          { type: \"text\", text: `Transformed: ${result}` },\n        ],\n      };\n\n      const result = await executeClientTool(tool, \"call-3\", {});\n\n      expect(result).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-3\",\n        content: [{ type: \"text\", text: \"Transformed: custom result\" }],\n      });\n    });\n\n    it(\"handles transformToContent with non-text types by stringifying\", async () => {\n      const tool: TamboTool = {\n        name: \"image_tool\",\n        description: \"Image tool\",\n        tool: async () => \"image data\",\n        inputSchema: z.object({}),\n        outputSchema: z.string(),\n        transformToContent: () => [\n          {\n            type: \"image_url\",\n            image_url: { url: \"https://example.com/image.png\" },\n          },\n        ],\n      };\n\n      const result = await executeClientTool(tool, \"call-4\", {});\n\n      expect(result).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-4\",\n        content: [\n          {\n            type: \"text\",\n            text: '{\"type\":\"image_url\",\"image_url\":{\"url\":\"https://example.com/image.png\"}}',\n          },\n        ],\n      });\n    });\n\n    it(\"handles tool execution errors gracefully\", async () => {\n      const tool: TamboTool = {\n        name: \"failing_tool\",\n        description: \"A tool that fails\",\n        tool: async () => {\n          throw new Error(\"Tool failed!\");\n        },\n        inputSchema: z.object({}),\n        outputSchema: z.void(),\n      };\n\n      const result = await executeClientTool(tool, \"call-5\", {});\n\n      expect(result).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-5\",\n        content: [{ type: \"text\", text: \"Tool failed!\" }],\n      });\n    });\n\n    it(\"handles non-Error throws gracefully\", async () => {\n      const tool: TamboTool = {\n        name: \"throwing_tool\",\n        description: \"A tool that throws a string\",\n        tool: async () => {\n          throw \"string error\";\n        },\n        inputSchema: z.object({}),\n        outputSchema: z.void(),\n      };\n\n      const result = await executeClientTool(tool, \"call-6\", {});\n\n      expect(result).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-6\",\n        content: [{ type: \"text\", text: \"Tool execution failed\" }],\n      });\n    });\n  });\n\n  describe(\"executeAllPendingTools\", () => {\n    it(\"executes multiple tools with Map registry\", async () => {\n      const registry = new Map<string, TamboTool>([\n        [\n          \"add\",\n          {\n            name: \"add\",\n            description: \"Adds numbers\",\n            tool: async ({ a, b }: { a: number; b: number }) => a + b,\n            inputSchema: z.object({ a: z.number(), b: z.number() }),\n            outputSchema: z.number(),\n          },\n        ],\n        [\n          \"multiply\",\n          {\n            name: \"multiply\",\n            description: \"Multiplies numbers\",\n            tool: async ({ a, b }: { a: number; b: number }) => a * b,\n            inputSchema: z.object({ a: z.number(), b: z.number() }),\n            outputSchema: z.number(),\n          },\n        ],\n      ]);\n\n      const toolCalls = new Map<string, PendingToolCall>([\n        [\"call-1\", { name: \"add\", input: { a: 2, b: 3 } }],\n        [\"call-2\", { name: \"multiply\", input: { a: 4, b: 5 } }],\n      ]);\n\n      const results = await executeAllPendingTools(toolCalls, registry);\n\n      expect(results).toHaveLength(2);\n      expect(results[0]).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-1\",\n        content: [{ type: \"text\", text: \"5\" }],\n      });\n      expect(results[1]).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-2\",\n        content: [{ type: \"text\", text: \"20\" }],\n      });\n    });\n\n    it(\"executes tools with Record registry\", async () => {\n      const registry: Record<string, TamboTool> = {\n        greet: {\n          name: \"greet\",\n          description: \"Greets user\",\n          tool: async ({ name }: { name: string }) => `Hello, ${name}!`,\n          inputSchema: z.object({ name: z.string() }),\n          outputSchema: z.string(),\n        },\n      };\n\n      const toolCalls = new Map<string, PendingToolCall>([\n        [\"call-1\", { name: \"greet\", input: { name: \"World\" } }],\n      ]);\n\n      const results = await executeAllPendingTools(toolCalls, registry);\n\n      expect(results).toHaveLength(1);\n      expect(results[0]).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-1\",\n        content: [{ type: \"text\", text: \"Hello, World!\" }],\n      });\n    });\n\n    it(\"returns error result for unknown tools\", async () => {\n      const registry = new Map<string, TamboTool>();\n\n      const toolCalls = new Map<string, PendingToolCall>([\n        [\"call-1\", { name: \"unknown_tool\", input: {} }],\n      ]);\n\n      const results = await executeAllPendingTools(toolCalls, registry);\n\n      expect(results).toHaveLength(1);\n      expect(results[0]).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-1\",\n        content: [\n          { type: \"text\", text: 'Tool \"unknown_tool\" not found in registry' },\n        ],\n      });\n    });\n\n    it(\"handles mixed known and unknown tools\", async () => {\n      const registry = new Map<string, TamboTool>([\n        [\n          \"known\",\n          {\n            name: \"known\",\n            description: \"Known tool\",\n            tool: async () => \"success\",\n            inputSchema: z.object({}),\n            outputSchema: z.string(),\n          },\n        ],\n      ]);\n\n      const toolCalls = new Map<string, PendingToolCall>([\n        [\"call-1\", { name: \"known\", input: {} }],\n        [\"call-2\", { name: \"unknown\", input: {} }],\n      ]);\n\n      const results = await executeAllPendingTools(toolCalls, registry);\n\n      expect(results).toHaveLength(2);\n      expect(results[0].content[0]).toEqual({ type: \"text\", text: \"success\" });\n      expect(results[1].content[0]).toEqual({\n        type: \"text\",\n        text: 'Tool \"unknown\" not found in registry',\n      });\n    });\n  });\n});\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tambo-ai/react",
-  "version": "0.69.1",
+  "version": "0.71.0",
   "description": "React client package for Tambo AI",
   "license": "MIT",
   "repository": {
@@ -22,6 +22,11 @@
       "import": "./esm/mcp/index.js",
       "require": "./dist/mcp/index.js",
       "types": "./dist/mcp/index.d.ts"
+    },
+    "./v1": {
+      "import": "./esm/v1/index.js",
+      "require": "./dist/v1/index.js",
+      "types": "./dist/v1/index.d.ts"
     }
   },
   "files": [
@@ -38,6 +43,9 @@
     "build:cjs": "tsc -p tsconfig.cjs.json",
     "build:esm": "tsc -p tsconfig.esm.json",
     "check-types": "tsc --noEmit",
+    "dev": "concurrently \"npm run dev:cjs\" \"npm run dev:esm\"",
+    "dev:cjs": "tsc -p tsconfig.cjs.json --watch",
+    "dev:esm": "tsc -p tsconfig.esm.json --watch",
     "test": "jest --config jest.config.ts",
     "format": "prettier --write .",
     "lint": "eslint",
@@ -61,7 +69,7 @@
     "@types/react-dom": "^18.0.0 || ^19.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
-    "zod": "^3.25.76 || ~4.0.0",
+    "zod": "^3.25.76 || ^4",
     "zod-to-json-schema": "^3.25.1"
   },
   "peerDependenciesMeta": {
@@ -73,16 +81,19 @@
     }
   },
   "dependencies": {
+    "@ag-ui/core": "^0.0.43",
+    "@modelcontextprotocol/sdk": "^1.25.1",
     "@standard-community/standard-json": "^0.3.5",
     "@standard-schema/spec": "^1.1.0",
-    "@tambo-ai/typescript-sdk": "^0.80.0",
+    "@tambo-ai/typescript-sdk": "^0.86.0",
     "@tanstack/react-query": "^5.90.16",
     "fast-equals": "^5.3.3",
+    "fast-json-patch": "^3.1.1",
     "partial-json": "^0.1.7",
     "react-fast-compare": "^3.2.2",
     "react-media-recorder": "^1.7.2",
-    "ts-essentials": "^10.1.1",
     "ts-node": "^10.9.2",
+    "type-fest": "^5.4.1",
     "use-debounce": "^10.0.6"
   },
   "devDependencies": {
@@ -91,7 +102,7 @@
     "@tambo-ai/eslint-config": "*",
     "@tambo-ai/typescript-config": "*",
     "@testing-library/jest-dom": "^6.9.1",
-    "@testing-library/react": "^16.3.1",
+    "@testing-library/react": "^16.3.2",
     "@types/jest": "^30.0.0",
     "@types/json-schema": "^7.0.15",
     "@types/node": "^22.19.5",
@@ -100,20 +111,20 @@
     "@valibot/to-json-schema": "^1.5.0",
     "concurrently": "^9.2.1",
     "eslint": "^9.39.2",
-    "eslint-plugin-jsdoc": "^61.7.1",
+    "eslint-plugin-jsdoc": "^62.3.1",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^6.1.1",
     "jest": "^30.2.0",
     "jest-environment-jsdom": "^30.2.0",
     "lint-staged": "^16.2.7",
-    "prettier": "^3.7.4",
+    "prettier": "^3.8.1",
     "prettier-2": "npm:prettier@^2",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "ts-jest": "^29.4.6",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.52.0",
-    "zod": "^3.25.76 || ~4.0.0",
+    "typescript-eslint": "^8.53.0",
+    "zod": "^3.25.76 || ^4",
     "zod-to-json-schema": "^3.25.1"
   }
 }

package/dist/schema/zod.d.ts

@@ -1,57 +0,0 @@
-import { JSONSchema7 } from "json-schema";
-import { ZodFunction, ZodTuple, ZodTupleItems, ZodType, ZodTypeAny } from "zod/v3";
-import { $ZodFunction, $ZodType } from "zod/v4/core";
-/**
- * @returns True if the schema is a Zod 3 function schema
- */
-export declare function isZod3FunctionSchema(schema: unknown): schema is ZodFunction<ZodTuple<ZodTupleItems, any>, ZodTypeAny>;
-/**
- * @returns True if the schema is a Zod 4 function schema
- */
-export declare function isZod4FunctionSchema(schema: unknown): schema is $ZodFunction;
-/**
- * Checks if a schema is a Zod function schema (Zod 3 or Zod 4).
- * @param schema - The schema to check
- * @returns True if the schema is a Zod function schema
- */
-export declare function isZodFunctionSchema(schema: unknown): schema is ZodFunction<ZodTuple<ZodTupleItems, any>, ZodTypeAny> | $ZodFunction<import("zod/v4/core").$ZodFunctionArgs, import("zod/v4/core").$ZodFunctionOut>;
-/**
- * Extracts the args schema from a Zod function schema.
- * @param schema - The Zod function schema
- * @returns The args schema, or undefined if not a Zod function schema
- */
-export declare function getZodFunctionArgs(schema: unknown): import("zod/v4/core").$ZodFunctionArgs | ZodTuple<ZodTupleItems, any>;
-/**
- * Extracts the return schema from a Zod 3 or Zod 4 function schema.
- * @param schema - The Zod function schema
- * @returns The return schema, or undefined if not a Zod function schema
- */
-export declare function getZodFunctionReturns(schema: unknown): ZodTypeAny | import("zod/v4/core").$ZodFunctionOut;
-/**
- * Handles conversion of Zod schemas to JSON Schema.
- * Supports both Zod 3 (via zod-to-json-schema) and Zod 4 (native).
- * @param schema - The Zod schema to convert
- * @returns The JSON Schema representation
- */
-export declare function handleZodSchemaToJson(schema: unknown): JSONSchema7;
-/**
- * Checks if a schema is probably a Zod 3 schema.
- * @param schema - The schema to check
- * @returns True if the schema looks like a Zod 3 schema
- */
-export declare function isZod3Schema(schema: unknown): schema is ZodType;
-/**
- * Detects if a schema is Zod 4 by checking for Zod 4 markers.
- * - v4.1.x has `_zod` property
- * - v4.0.x (bundled in zod@3.25) has `def` directly but no `_def` for regular schemas
- * - v4.0.x function schemas have both `_def` and `def` (special case)
- * @returns True if the schema appears to be Zod 4 style
- */
-export declare function isZod4Schema(schema: unknown): schema is $ZodType;
-/**
- * Checks if a schema is a Zod schema
- * @param schema - The schema to check
- * @returns True if the schema is a Zod schema
- */
-export declare function isZodSchema(schema: unknown): schema is ZodType | $ZodType;
-//# sourceMappingURL=zod.d.ts.map

package/dist/schema/zod.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/schema/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACL,WAAW,EACX,QAAQ,EACR,aAAa,EACb,OAAO,EACP,UAAU,EACX,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,YAAY,EACZ,QAAQ,EAET,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,GACd,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,CAQjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,YAAY,CAoB5E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,iKAElD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,yEAWjD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,sDAapD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,eAoBpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,OAAO,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,QAAQ,CA0BhE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,OAAO,GAAG,QAAQ,CA0CzE"}

package/dist/schema/zod.js

@@ -1,191 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isZod3FunctionSchema = isZod3FunctionSchema;
-exports.isZod4FunctionSchema = isZod4FunctionSchema;
-exports.isZodFunctionSchema = isZodFunctionSchema;
-exports.getZodFunctionArgs = getZodFunctionArgs;
-exports.getZodFunctionReturns = getZodFunctionReturns;
-exports.handleZodSchemaToJson = handleZodSchemaToJson;
-exports.isZod3Schema = isZod3Schema;
-exports.isZod4Schema = isZod4Schema;
-exports.isZodSchema = isZodSchema;
-const core_1 = require("zod/v4/core");
-/**
- * @returns True if the schema is a Zod 3 function schema
- */
-function isZod3FunctionSchema(schema) {
-    if (!isZodSchema(schema))
-        return false;
-    return ("_def" in schema &&
-        "typeName" in schema._def &&
-        schema._def.typeName === "ZodFunction");
-}
-/**
- * @returns True if the schema is a Zod 4 function schema
- */
-function isZod4FunctionSchema(schema) {
-    if (!isZod4Schema(schema)) {
-        return false;
-    }
-    // $ZodFunctions in zod 4.0 most certainly do have .def.type === "function"
-    // but the type definitions do not reflect this because $ZodFunction does not
-    // extend $ZodType. This is corrected in zod 4.1, but zod 3 does not include
-    // the types for 4.1 yet (and might not ever).
-    // See: https://github.com/colinhacks/zod/blob/463f03eb8183dcdcdf735b180f2bf40883e66220/packages/zod/src/v4/core/function.ts#L48
-    if ("def" in schema && typeof schema.def === "object" && schema.def) {
-        if (schema.def?.type === "function") {
-            return true;
-        }
-    }
-    // We're casting as string here because zod 4.0 types don't include "function"
-    // literal in the union for `_zod.def.type`. The optional chaining is because
-    // _zod does not exist on zod 4 objects from zod 3.
-    return schema._zod?.def?.type === "function";
-}
-/**
- * Checks if a schema is a Zod function schema (Zod 3 or Zod 4).
- * @param schema - The schema to check
- * @returns True if the schema is a Zod function schema
- */
-function isZodFunctionSchema(schema) {
-    return isZod3FunctionSchema(schema) || isZod4FunctionSchema(schema);
-}
-/**
- * Extracts the args schema from a Zod function schema.
- * @param schema - The Zod function schema
- * @returns The args schema, or undefined if not a Zod function schema
- */
-function getZodFunctionArgs(schema) {
-    if (isZod3FunctionSchema(schema)) {
-        return schema._def.args;
-    }
-    if (isZod4FunctionSchema(schema)) {
-        // @ts-expect-error -- Error in Zod types for v3 vs v4.0
-        return schema?.def?.input ?? schema._zod?.def?.input;
-    }
-    throw new Error("Unable to determine parameters from zod function schema");
-}
-/**
- * Extracts the return schema from a Zod 3 or Zod 4 function schema.
- * @param schema - The Zod function schema
- * @returns The return schema, or undefined if not a Zod function schema
- */
-function getZodFunctionReturns(schema) {
-    if (isZod3FunctionSchema(schema)) {
-        return schema._def.returns;
-    }
-    if (isZod4FunctionSchema(schema)) {
-        // v4.0.x: output on .def directly
-        // v4.1.x: output on ._zod.def
-        // @ts-expect-error -- Type differences between v4.0.x and v4.1.x
-        return schema.def?.output ?? schema._zod?.def?.output;
-    }
-    throw new Error("Unable to determine return type from zod function schema");
-}
-/**
- * Handles conversion of Zod schemas to JSON Schema.
- * Supports both Zod 3 (via zod-to-json-schema) and Zod 4 (native).
- * @param schema - The Zod schema to convert
- * @returns The JSON Schema representation
- */
-function handleZodSchemaToJson(schema) {
-    // If Zod4 schema detected, use the toJSONSchema function from "zod/v4/core"
-    if (isZod4Schema(schema)) {
-        return (0, core_1.toJSONSchema)(schema, { reused: "inline" });
-    }
-    try {
-        // Dynamic require for optional peer dependency
-        // eslint-disable-next-line @typescript-eslint/no-require-imports -- need require because zod-to-json-schema may be missing
-        const { zodToJsonSchema } = require("zod-to-json-schema");
-        return zodToJsonSchema(schema, { $refStrategy: "none" });
-    }
-    catch (error) {
-        throw new Error("Zod 3 requires 'zod-to-json-schema' package for JSON Schema conversion. " +
-            "Install it with: npm install zod-to-json-schema", {
-            cause: error,
-        });
-    }
-}
-/**
- * Checks if a schema is probably a Zod 3 schema.
- * @param schema - The schema to check
- * @returns True if the schema looks like a Zod 3 schema
- */
-function isZod3Schema(schema) {
-    return isZodSchema(schema) && "_def" in schema && !("def" in schema);
-}
-/**
- * Detects if a schema is Zod 4 by checking for Zod 4 markers.
- * - v4.1.x has `_zod` property
- * - v4.0.x (bundled in zod@3.25) has `def` directly but no `_def` for regular schemas
- * - v4.0.x function schemas have both `_def` and `def` (special case)
- * @returns True if the schema appears to be Zod 4 style
- */
-function isZod4Schema(schema) {
-    if (!isZodSchema(schema))
-        return false;
-    // v4.1.x: has _zod property
-    if ("_zod" in schema)
-        return true;
-    // v4.0.x regular schemas: has def directly but NOT _def (v3 has _def)
-    // Also check def.type is a string; in Zod v4 this is typically a string
-    // literal like "string"
-    if ("def" in schema && !("_def" in schema)) {
-        const def = schema.def;
-        if (def && typeof def === "object" && "type" in def) {
-            return typeof def.type === "string";
-        }
-    }
-    // v4.0.x function schemas: have both _def and def with type "function"
-    // This is a special case where _def exists but it's still a v4 schema
-    if ("_def" in schema && "def" in schema) {
-        const def = schema.def;
-        if (def && typeof def === "object" && "type" in def) {
-            return def.type === "function";
-        }
-    }
-    return false;
-}
-/**
- * Checks if a schema is a Zod schema
- * @param schema - The schema to check
- * @returns True if the schema is a Zod schema
- */
-function isZodSchema(schema) {
-    if (typeof schema !== "object")
-        return false;
-    if (!schema)
-        return false;
-    // Standard detection: schema has { ~standard: { vendor: "zod" } }
-    if ("~standard" in schema && schema["~standard"]) {
-        const std = schema["~standard"];
-        if (typeof std === "object" && "vendor" in std && std.vendor === "zod") {
-            // Require at least one internal marker to reduce false positives
-            const looksLikeV3 = "_def" in schema;
-            const looksLikeV4 = "_zod" in schema || "def" in schema;
-            return looksLikeV3 || looksLikeV4;
-        }
-    }
-    // v4.0.x function schemas: have _def and def with type "function"
-    // but don't have ~standard at the top level (only on nested schemas)
-    if ("_def" in schema && "def" in schema) {
-        const def = schema.def;
-        if (def &&
-            typeof def === "object" &&
-            "type" in def &&
-            def.type === "function") {
-            // Check if nested input/output have zod markers
-            const inputIsZod = "input" in def &&
-                typeof def.input === "object" &&
-                def.input !== null &&
-                "~standard" in def.input;
-            const outputIsZod = "output" in def &&
-                typeof def.output === "object" &&
-                def.output !== null &&
-                "~standard" in def.output;
-            return inputIsZod || outputIsZod;
-        }
-    }
-    return false;
-}
-//# sourceMappingURL=zod.js.map

package/dist/schema/zod.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../src/schema/zod.ts"],"names":[],"mappings":"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","sourcesContent":["import { JSONSchema7 } from \"json-schema\";\nimport {\n  ZodFunction,\n  ZodTuple,\n  ZodTupleItems,\n  ZodType,\n  ZodTypeAny,\n} from \"zod/v3\";\nimport {\n  $ZodFunction,\n  $ZodType,\n  toJSONSchema as zod4ToJSONSchema,\n} from \"zod/v4/core\";\n\n/**\n * @returns True if the schema is a Zod 3 function schema\n */\nexport function isZod3FunctionSchema(\n  schema: unknown,\n): schema is ZodFunction<ZodTuple<ZodTupleItems, any>, ZodTypeAny> {\n  if (!isZodSchema(schema)) return false;\n\n  return (\n    \"_def\" in schema &&\n    \"typeName\" in schema._def &&\n    schema._def.typeName === \"ZodFunction\"\n  );\n}\n\n/**\n * @returns True if the schema is a Zod 4 function schema\n */\nexport function isZod4FunctionSchema(schema: unknown): schema is $ZodFunction {\n  if (!isZod4Schema(schema)) {\n    return false;\n  }\n\n  // $ZodFunctions in zod 4.0 most certainly do have .def.type === \"function\"\n  // but the type definitions do not reflect this because $ZodFunction does not\n  // extend $ZodType. This is corrected in zod 4.1, but zod 3 does not include\n  // the types for 4.1 yet (and might not ever).\n  // See: https://github.com/colinhacks/zod/blob/463f03eb8183dcdcdf735b180f2bf40883e66220/packages/zod/src/v4/core/function.ts#L48\n  if (\"def\" in schema && typeof schema.def === \"object\" && schema.def) {\n    if ((schema.def as { type: string })?.type === \"function\") {\n      return true;\n    }\n  }\n\n  // We're casting as string here because zod 4.0 types don't include \"function\"\n  // literal in the union for `_zod.def.type`. The optional chaining is because\n  // _zod does not exist on zod 4 objects from zod 3.\n  return (schema._zod?.def?.type as string) === \"function\";\n}\n\n/**\n * Checks if a schema is a Zod function schema (Zod 3 or Zod 4).\n * @param schema - The schema to check\n * @returns True if the schema is a Zod function schema\n */\nexport function isZodFunctionSchema(schema: unknown) {\n  return isZod3FunctionSchema(schema) || isZod4FunctionSchema(schema);\n}\n\n/**\n * Extracts the args schema from a Zod function schema.\n * @param schema - The Zod function schema\n * @returns The args schema, or undefined if not a Zod function schema\n */\nexport function getZodFunctionArgs(schema: unknown) {\n  if (isZod3FunctionSchema(schema)) {\n    return schema._def.args;\n  }\n\n  if (isZod4FunctionSchema(schema)) {\n    // @ts-expect-error -- Error in Zod types for v3 vs v4.0\n    return schema?.def?.input ?? schema._zod?.def?.input;\n  }\n\n  throw new Error(\"Unable to determine parameters from zod function schema\");\n}\n\n/**\n * Extracts the return schema from a Zod 3 or Zod 4 function schema.\n * @param schema - The Zod function schema\n * @returns The return schema, or undefined if not a Zod function schema\n */\nexport function getZodFunctionReturns(schema: unknown) {\n  if (isZod3FunctionSchema(schema)) {\n    return schema._def.returns;\n  }\n\n  if (isZod4FunctionSchema(schema)) {\n    // v4.0.x: output on .def directly\n    // v4.1.x: output on ._zod.def\n    // @ts-expect-error -- Type differences between v4.0.x and v4.1.x\n    return schema.def?.output ?? schema._zod?.def?.output;\n  }\n\n  throw new Error(\"Unable to determine return type from zod function schema\");\n}\n\n/**\n * Handles conversion of Zod schemas to JSON Schema.\n * Supports both Zod 3 (via zod-to-json-schema) and Zod 4 (native).\n * @param schema - The Zod schema to convert\n * @returns The JSON Schema representation\n */\nexport function handleZodSchemaToJson(schema: unknown) {\n  // If Zod4 schema detected, use the toJSONSchema function from \"zod/v4/core\"\n  if (isZod4Schema(schema)) {\n    return zod4ToJSONSchema(schema, { reused: \"inline\" }) as JSONSchema7;\n  }\n\n  try {\n    // Dynamic require for optional peer dependency\n    // eslint-disable-next-line @typescript-eslint/no-require-imports -- need require because zod-to-json-schema may be missing\n    const { zodToJsonSchema } = require(\"zod-to-json-schema\");\n    return zodToJsonSchema(schema, { $refStrategy: \"none\" }) as JSONSchema7;\n  } catch (error) {\n    throw new Error(\n      \"Zod 3 requires 'zod-to-json-schema' package for JSON Schema conversion. \" +\n        \"Install it with: npm install zod-to-json-schema\",\n      {\n        cause: error,\n      },\n    );\n  }\n}\n\n/**\n * Checks if a schema is probably a Zod 3 schema.\n * @param schema - The schema to check\n * @returns True if the schema looks like a Zod 3 schema\n */\nexport function isZod3Schema(schema: unknown): schema is ZodType {\n  return isZodSchema(schema) && \"_def\" in schema && !(\"def\" in schema);\n}\n\n/**\n * Detects if a schema is Zod 4 by checking for Zod 4 markers.\n * - v4.1.x has `_zod` property\n * - v4.0.x (bundled in zod@3.25) has `def` directly but no `_def` for regular schemas\n * - v4.0.x function schemas have both `_def` and `def` (special case)\n * @returns True if the schema appears to be Zod 4 style\n */\nexport function isZod4Schema(schema: unknown): schema is $ZodType {\n  if (!isZodSchema(schema)) return false;\n\n  // v4.1.x: has _zod property\n  if (\"_zod\" in schema) return true;\n\n  // v4.0.x regular schemas: has def directly but NOT _def (v3 has _def)\n  // Also check def.type is a string; in Zod v4 this is typically a string\n  // literal like \"string\"\n  if (\"def\" in schema && !(\"_def\" in schema)) {\n    const def = (schema as { def: unknown }).def;\n    if (def && typeof def === \"object\" && \"type\" in def) {\n      return typeof def.type === \"string\";\n    }\n  }\n\n  // v4.0.x function schemas: have both _def and def with type \"function\"\n  // This is a special case where _def exists but it's still a v4 schema\n  if (\"_def\" in schema && \"def\" in schema) {\n    const def = (schema as { def: unknown }).def;\n    if (def && typeof def === \"object\" && \"type\" in def) {\n      return def.type === \"function\";\n    }\n  }\n\n  return false;\n}\n\n/**\n * Checks if a schema is a Zod schema\n * @param schema - The schema to check\n * @returns True if the schema is a Zod schema\n */\nexport function isZodSchema(schema: unknown): schema is ZodType | $ZodType {\n  if (typeof schema !== \"object\") return false;\n  if (!schema) return false;\n\n  // Standard detection: schema has { ~standard: { vendor: \"zod\" } }\n  if (\"~standard\" in schema && schema[\"~standard\"]) {\n    const std = schema[\"~standard\"];\n    if (typeof std === \"object\" && \"vendor\" in std && std.vendor === \"zod\") {\n      // Require at least one internal marker to reduce false positives\n      const looksLikeV3 = \"_def\" in schema;\n      const looksLikeV4 = \"_zod\" in schema || \"def\" in schema;\n      return looksLikeV3 || looksLikeV4;\n    }\n  }\n\n  // v4.0.x function schemas: have _def and def with type \"function\"\n  // but don't have ~standard at the top level (only on nested schemas)\n  if (\"_def\" in schema && \"def\" in schema) {\n    const def = (schema as { def: unknown }).def;\n    if (\n      def &&\n      typeof def === \"object\" &&\n      \"type\" in def &&\n      def.type === \"function\"\n    ) {\n      // Check if nested input/output have zod markers\n      const inputIsZod =\n        \"input\" in def &&\n        typeof def.input === \"object\" &&\n        def.input !== null &&\n        \"~standard\" in def.input;\n\n      const outputIsZod =\n        \"output\" in def &&\n        typeof def.output === \"object\" &&\n        def.output !== null &&\n        \"~standard\" in def.output;\n      return inputIsZod || outputIsZod;\n    }\n  }\n\n  return false;\n}\n"]}

package/dist/schema/zod.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=zod.test.d.ts.map

package/dist/schema/zod.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"zod.test.d.ts","sourceRoot":"","sources":["../../src/schema/zod.test.ts"],"names":[],"mappings":""}