@super_studio/ecforce-ai-agent-react 1.2.0-canary.0 → 1.2.0-canary.1

package/README.md

@@ -220,6 +220,100 @@ sendAppMessage({
 
 これにより、AI Agent 側で現在の画面や対象データに応じた応答をしやすくなります。
 
+### 3-5. `useClientTool()` でクライアントツールを登録する
+
+ブラウザ上で実行したい処理を AI Agent から呼ばせたい場合は、`useClientTool()` を使います。
+
+典型的には、以下のような用途で使います。
+
+- 現在開いている画面の React state を参照して結果を返す
+- ユーザー確認付きでクライアント側の state を更新する
+- クライアント側の UI 操作をトリガーする
+
+`useClientTool()` は `ChatbotProvider` 配下で呼び出してください。引数定義には `zod` を使います。
+
+```tsx
+"use client";
+
+import { useState } from "react";
+import { z } from "zod";
+import { useClientTool } from "@super_studio/ecforce-ai-agent-react";
+
+export function CartToolRegistration() {
+  const [selectedSku, setSelectedSku] = useState("sku_001");
+  const [isPinned, setIsPinned] = useState(false);
+
+  useClientTool({
+    name: "checkSelectedSku",
+    displayName: "選択中SKU確認",
+    description: "現在画面で選択中の商品 SKU を返します。",
+    summary: "選択中の SKU を返します。",
+    parameters: z.object({}),
+    execute: () => {
+      return {
+        selectedSku,
+        isPinned,
+      };
+    },
+  });
+
+  useClientTool({
+    name: "togglePinnedState",
+    displayName: "ピン留め切り替え",
+    description: "現在の商品をピン留めするかどうかを切り替えます。",
+    summary: "ピン留め状態を更新します。",
+    requireConfirmation: true,
+    parameters: z.object({
+      pinned: z.boolean().describe("更新後のピン留め状態"),
+    }),
+    execute: ({ pinned }) => {
+      setIsPinned(pinned);
+
+      return {
+        selectedSku,
+        isPinned: pinned,
+      };
+    },
+  });
+
+  return (
+    <div>
+      <p>selectedSku: {selectedSku}</p>
+      <p>isPinned: {String(isPinned)}</p>
+      <button onClick={() => setSelectedSku("sku_002")}>SKU を切り替える</button>
+    </div>
+  );
+}
+```
+
+#### `useClientTool()` の options
+
+```ts
+type UseClientToolOptions<TParameters extends z.ZodTypeAny> = {
+  name: string;
+  displayName: string;
+  description: string;
+  summary?: string;
+  requireConfirmation?: boolean;
+  parameters: TParameters;
+  execute: (args: z.output<TParameters>) => Promise<unknown> | unknown;
+};
+```
+
+- `name`: ツール識別子です。内部では自動で `page_` プレフィックスが付きます
+- `displayName`: UI 上で表示するツール名です
+- `description`: AI Agent が参照する詳細説明です。何をするツールか、どんな引数を受けるかを明確に書いてください
+- `summary`: ユーザー向けの短い要約です
+- `requireConfirmation`: `true` の場合、実行前にユーザー確認を要求します
+- `parameters`: ツール引数を表す `zod` スキーマです
+- `execute`: 検証済み引数を受け取ってクライアント側の処理を実行する関数です
+
+#### 補足
+
+- `name` に `page_` を自分で付けても動きますが、通常は素の名前で問題ありません
+- `execute` の返り値は AI Agent に渡されるため、JSON 化しやすい値を返すのがおすすめです
+- コンポーネントがアンマウントされるとツール登録は自動で解除されます
+
 ## 4. `@super_studio/ecforce-ai-agent-server` のセットアップ
 
 ### 4-1. サーバー側で AI Agent セッションを発行する

package/dist/lib/client-tools.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"client-tools.d.mts","names":[],"sources":["../../src/lib/client-tools.ts"],"sourcesContent":[],"mappings":";;;KAMY,oBAAA,GAAuB;KAGvB,oBAAA;EAHA,IAAA,EAAA,MAAA;EAGA,WAAA,EAAA,MAAA;EASA,WAAA,EAAA,MAAA;EAMA,OAAA,CAAA,EAAA,MAAA;EAKA,mBAAA,CAAA,EAAA,OAAoB;EAAuB,UAAA,EAdzC,oBAcyC;CAYzC;AAEa,KAzBf,wBAAA,GAyBe;EAAP,MAAA,EAAA,MAAA;EAAwB,IAAA,EAAA,MAAA;EAAO,IAAA,EAAA,OAAA;AAqCnD,CAAA;AAAoD,KAxDxC,oBAAA,GAwDwC;EAClD,UAAA,EAxDY,oBAwDZ;EACA,OAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GAxD4B,OAwD5B,CAAA,OAAA,CAAA,GAAA,OAAA;CACA;AACA,KAvDU,oBAuDV,CAAA,oBAvDmD,CAAA,CAAE,UAuDrD,CAAA,GAAA;EACA;EACA,IAAA,EAAA,MAAA;EACA;EACsB,WAAA,EAAA,MAAA;EAArB;EAAoB,WAAA,EAAA,MAAA;;;;;;cA/CT;;kBAEI,CAAA,CAAE,OAAO,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqC5B,kCAAkC,CAAA,CAAE;;;;;;;;GAQjD,qBAAqB"}
+{"version":3,"file":"client-tools.d.mts","names":[],"sources":["../../src/lib/client-tools.ts"],"sourcesContent":[],"mappings":";;;KAOY,oBAAA,GAAuB;KAGvB,oBAAA;EAHA,IAAA,EAAA,MAAA;EAGA,WAAA,EAAA,MAAA;EASA,WAAA,EAAA,MAAA;EAMA,OAAA,CAAA,EAAA,MAAA;EAKA,mBAAA,CAAA,EAAA,OAAoB;EAAuB,UAAA,EAdzC,oBAcyC;CAYzC;AAEa,KAzBf,wBAAA,GAyBe;EAAP,MAAA,EAAA,MAAA;EAAwB,IAAA,EAAA,MAAA;EAAO,IAAA,EAAA,OAAA;AAiEnD,CAAA;AAAoD,KApFxC,oBAAA,GAoFwC;EAClD,UAAA,EApFY,oBAoFZ;EACA,OAAA,EAAA,CAAA,IAAA,EAAA,OAAA,EAAA,GApF4B,OAoF5B,CAAA,OAAA,CAAA,GAAA,OAAA;CACA;AACA,KAnFU,oBAmFV,CAAA,oBAnFmD,CAAA,CAAE,UAmFrD,CAAA,GAAA;EACA;EACA,IAAA,EAAA,MAAA;EACA;EACsB,WAAA,EAAA,MAAA;EAArB;EAAoB,WAAA,EAAA,MAAA;;;;;;cA3ET;;kBAEI,CAAA,CAAE,OAAO,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiE5B,kCAAkC,CAAA,CAAE;;;;;;;;GAQjD,qBAAqB"}

package/dist/lib/client-tools.mjs

@@ -2,6 +2,7 @@
 
 import { useChatbot } from "../components/provider/chatbot-provider.mjs";
 import React from "react";
+import { zodToJsonSchema } from "zod-to-json-schema";
 
 //#region src/lib/client-tools.ts
 const CLIENT_TOOL_NAME_PREFIX = "page_";
@@ -9,6 +10,16 @@ function normalizeClientToolName(name) {
 	if (name.startsWith(CLIENT_TOOL_NAME_PREFIX)) return name;
 	return `${CLIENT_TOOL_NAME_PREFIX}${name}`;
 }
+function isZodV4Schema(parameters) {
+	return "_zod" in parameters;
+}
+function parametersToJsonSchema(parameters, zodModule) {
+	if (zodModule && isZodV4Schema(parameters)) {
+		const nativeToJsonSchema = zodModule.z.toJSONSchema;
+		if (typeof nativeToJsonSchema === "function") return nativeToJsonSchema(parameters);
+	}
+	return zodToJsonSchema(parameters, { $refStrategy: "none" });
+}
 /**
 * チャットボットから呼び出せるクライアントツールを登録します。
 *
@@ -45,7 +56,7 @@ function useClientTool({ name, displayName, description, summary, requireConfirm
 	React.useEffect(() => {
 		let isCancelled = false;
 		(async () => {
-			const { z } = await import("zod");
+			const zodModule = isZodV4Schema(parameters) ? await import("zod") : void 0;
 			if (isCancelled) return;
 			registerClientTool({
 				definition: {
@@ -54,7 +65,7 @@ function useClientTool({ name, displayName, description, summary, requireConfirm
 					description,
 					summary,
 					requireConfirmation,
-					parameters: z.toJSONSchema(parameters)
+					parameters: parametersToJsonSchema(parameters, zodModule)
 				},
 				execute: (args) => executeRef.current(args)
 			});

package/dist/lib/client-tools.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client-tools.mjs","names":[],"sources":["../../src/lib/client-tools.ts"],"sourcesContent":["\"use client\";\n\nimport React from \"react\";\nimport type { z } from \"zod\";\nimport { useChatbot } from \"../components/provider/chatbot-provider\";\n\nexport type ClientToolJsonSchema = Record<string, unknown>;\nconst CLIENT_TOOL_NAME_PREFIX = \"page_\";\n\nexport type ClientToolDefinition = {\n  name: string;\n  displayName: string;\n  description: string;\n  summary?: string;\n  requireConfirmation?: boolean;\n  parameters: ClientToolJsonSchema;\n};\n\nexport type ClientToolExecuteRequest = {\n  callId: string;\n  name: string;\n  args: unknown;\n};\n\nexport type RegisteredClientTool = {\n  definition: ClientToolDefinition;\n  execute: (args: unknown) => Promise<unknown> | unknown;\n};\n\nexport type UseClientToolOptions<TParameters extends z.ZodTypeAny> = {\n  /** ツール名です。`page_`のプレフィックスが自動で追加されます。 */\n  name: string;\n  /** UI上に表示するツール名です。 */\n  displayName: string;\n  /** LLMが見れるツールの詳細説明です。 */\n  description: string;\n  /** ユーザーに表示するツールの要約です。 */\n  summary?: string;\n  /** 実行前にユーザー確認を要求するかを指定します。 */\n  requireConfirmation?: boolean;\n  /** ツールの引数を定義するZodスキーマです。 */\n  parameters: TParameters;\n  /** 検証済み引数を受け取り、ツール本体の処理を実行します。 */\n  execute: (args: z.output<TParameters>) => Promise<unknown> | unknown;\n};\n\nfunction normalizeClientToolName(name: string) {\n  if (name.startsWith(CLIENT_TOOL_NAME_PREFIX)) {\n    return name;\n  }\n\n  return `${CLIENT_TOOL_NAME_PREFIX}${name}`;\n}\n\n/**\n * チャットボットから呼び出せるクライアントツールを登録します。\n *\n * @example\n * ```tsx\n * import { z } from \"zod\";\n * import { useClientTool } from \"@super_studio/ecforce-ai-agent-react\";\n *\n * export function InventoryToolRegistration() {\n *   useClientTool({\n *     name: \"lookup_inventory\",\n *     displayName: \"在庫確認\",\n *     description: \"商品コードから在庫数を取得します。\",\n *     summary: \"商品在庫を返します。\",\n *     parameters: z.object({\n *       sku: z.string().describe(\"商品コード\"),\n *     }),\n *     execute: async ({ sku }) => {\n *       return { sku, available: true };\n *     },\n *   });\n *\n *   return null;\n * }\n * ```\n */\nexport function useClientTool<TParameters extends z.ZodTypeAny>({\n  name,\n  displayName,\n  description,\n  summary,\n  requireConfirmation = false,\n  parameters,\n  execute,\n}: UseClientToolOptions<TParameters>) {\n  const { registerClientTool, unregisterClientTool } = useChatbot();\n  const executeRef = React.useRef(execute);\n  const normalizedName = React.useMemo(\n    () => normalizeClientToolName(name),\n    [name],\n  );\n\n  React.useEffect(() => {\n    executeRef.current = execute;\n  }, [execute]);\n\n  React.useEffect(() => {\n    let isCancelled = false;\n\n    void (async () => {\n      const { z } = await import(\"zod\");\n      if (isCancelled) {\n        return;\n      }\n\n      registerClientTool({\n        definition: {\n          name: normalizedName,\n          displayName,\n          description,\n          summary,\n          requireConfirmation,\n          parameters: z.toJSONSchema(parameters),\n        },\n        execute: (args) => executeRef.current(args as z.output<TParameters>),\n      });\n    })();\n\n    return () => {\n      isCancelled = true;\n      unregisterClientTool(normalizedName);\n    };\n  }, [\n    description,\n    displayName,\n    normalizedName,\n    parameters,\n    registerClientTool,\n    requireConfirmation,\n    summary,\n    unregisterClientTool,\n  ]);\n}\n"],"mappings":";;;;;;AAOA,MAAM,0BAA0B;AAuChC,SAAS,wBAAwB,MAAc;AAC7C,KAAI,KAAK,WAAW,wBAAwB,CAC1C,QAAO;AAGT,QAAO,GAAG,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BtC,SAAgB,cAAgD,EAC9D,MACA,aACA,aACA,SACA,sBAAsB,OACtB,YACA,WACoC;CACpC,MAAM,EAAE,oBAAoB,yBAAyB,YAAY;CACjE,MAAM,aAAa,MAAM,OAAO,QAAQ;CACxC,MAAM,iBAAiB,MAAM,cACrB,wBAAwB,KAAK,EACnC,CAAC,KAAK,CACP;AAED,OAAM,gBAAgB;AACpB,aAAW,UAAU;IACpB,CAAC,QAAQ,CAAC;AAEb,OAAM,gBAAgB;EACpB,IAAI,cAAc;AAElB,GAAM,YAAY;GAChB,MAAM,EAAE,MAAM,MAAM,OAAO;AAC3B,OAAI,YACF;AAGF,sBAAmB;IACjB,YAAY;KACV,MAAM;KACN;KACA;KACA;KACA;KACA,YAAY,EAAE,aAAa,WAAW;KACvC;IACD,UAAU,SAAS,WAAW,QAAQ,KAA8B;IACrE,CAAC;MACA;AAEJ,eAAa;AACX,iBAAc;AACd,wBAAqB,eAAe;;IAErC;EACD;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC"}
+{"version":3,"file":"client-tools.mjs","names":[],"sources":["../../src/lib/client-tools.ts"],"sourcesContent":["\"use client\";\n\nimport React from \"react\";\nimport type { z } from \"zod\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { useChatbot } from \"../components/provider/chatbot-provider\";\n\nexport type ClientToolJsonSchema = Record<string, unknown>;\nconst CLIENT_TOOL_NAME_PREFIX = \"page_\";\n\nexport type ClientToolDefinition = {\n  name: string;\n  displayName: string;\n  description: string;\n  summary?: string;\n  requireConfirmation?: boolean;\n  parameters: ClientToolJsonSchema;\n};\n\nexport type ClientToolExecuteRequest = {\n  callId: string;\n  name: string;\n  args: unknown;\n};\n\nexport type RegisteredClientTool = {\n  definition: ClientToolDefinition;\n  execute: (args: unknown) => Promise<unknown> | unknown;\n};\n\nexport type UseClientToolOptions<TParameters extends z.ZodTypeAny> = {\n  /** ツール名です。`page_`のプレフィックスが自動で追加されます。 */\n  name: string;\n  /** UI上に表示するツール名です。 */\n  displayName: string;\n  /** LLMが見れるツールの詳細説明です。 */\n  description: string;\n  /** ユーザーに表示するツールの要約です。 */\n  summary?: string;\n  /** 実行前にユーザー確認を要求するかを指定します。 */\n  requireConfirmation?: boolean;\n  /** ツールの引数を定義するZodスキーマです。 */\n  parameters: TParameters;\n  /** 検証済み引数を受け取り、ツール本体の処理を実行します。 */\n  execute: (args: z.output<TParameters>) => Promise<unknown> | unknown;\n};\n\nfunction normalizeClientToolName(name: string) {\n  if (name.startsWith(CLIENT_TOOL_NAME_PREFIX)) {\n    return name;\n  }\n\n  return `${CLIENT_TOOL_NAME_PREFIX}${name}`;\n}\n\nfunction isZodV4Schema(parameters: z.ZodTypeAny) {\n  return \"_zod\" in (parameters as object);\n}\n\nfunction parametersToJsonSchema(\n  parameters: z.ZodTypeAny,\n  zodModule?: typeof import(\"zod\"),\n): ClientToolJsonSchema {\n  if (zodModule && isZodV4Schema(parameters)) {\n    const nativeToJsonSchema = (\n      zodModule.z as typeof zodModule.z & {\n        toJSONSchema?: (schema: z.ZodTypeAny) => ClientToolJsonSchema;\n      }\n    ).toJSONSchema;\n\n    if (typeof nativeToJsonSchema === \"function\") {\n      return nativeToJsonSchema(parameters);\n    }\n  }\n\n  return zodToJsonSchema(\n    parameters as unknown as Parameters<typeof zodToJsonSchema>[0],\n    {\n      $refStrategy: \"none\",\n    },\n  ) as ClientToolJsonSchema;\n}\n\n/**\n * チャットボットから呼び出せるクライアントツールを登録します。\n *\n * @example\n * ```tsx\n * import { z } from \"zod\";\n * import { useClientTool } from \"@super_studio/ecforce-ai-agent-react\";\n *\n * export function InventoryToolRegistration() {\n *   useClientTool({\n *     name: \"lookup_inventory\",\n *     displayName: \"在庫確認\",\n *     description: \"商品コードから在庫数を取得します。\",\n *     summary: \"商品在庫を返します。\",\n *     parameters: z.object({\n *       sku: z.string().describe(\"商品コード\"),\n *     }),\n *     execute: async ({ sku }) => {\n *       return { sku, available: true };\n *     },\n *   });\n *\n *   return null;\n * }\n * ```\n */\nexport function useClientTool<TParameters extends z.ZodTypeAny>({\n  name,\n  displayName,\n  description,\n  summary,\n  requireConfirmation = false,\n  parameters,\n  execute,\n}: UseClientToolOptions<TParameters>) {\n  const { registerClientTool, unregisterClientTool } = useChatbot();\n  const executeRef = React.useRef(execute);\n  const normalizedName = React.useMemo(\n    () => normalizeClientToolName(name),\n    [name],\n  );\n\n  React.useEffect(() => {\n    executeRef.current = execute;\n  }, [execute]);\n\n  React.useEffect(() => {\n    let isCancelled = false;\n\n    void (async () => {\n      const zodModule = isZodV4Schema(parameters) ? await import(\"zod\") : undefined;\n      if (isCancelled) {\n        return;\n      }\n\n      registerClientTool({\n        definition: {\n          name: normalizedName,\n          displayName,\n          description,\n          summary,\n          requireConfirmation,\n          parameters: parametersToJsonSchema(parameters, zodModule),\n        },\n        execute: (args) => executeRef.current(args as z.output<TParameters>),\n      });\n    })();\n\n    return () => {\n      isCancelled = true;\n      unregisterClientTool(normalizedName);\n    };\n  }, [\n    description,\n    displayName,\n    normalizedName,\n    parameters,\n    registerClientTool,\n    requireConfirmation,\n    summary,\n    unregisterClientTool,\n  ]);\n}\n"],"mappings":";;;;;;;AAQA,MAAM,0BAA0B;AAuChC,SAAS,wBAAwB,MAAc;AAC7C,KAAI,KAAK,WAAW,wBAAwB,CAC1C,QAAO;AAGT,QAAO,GAAG,0BAA0B;;AAGtC,SAAS,cAAc,YAA0B;AAC/C,QAAO,UAAW;;AAGpB,SAAS,uBACP,YACA,WACsB;AACtB,KAAI,aAAa,cAAc,WAAW,EAAE;EAC1C,MAAM,qBACJ,UAAU,EAGV;AAEF,MAAI,OAAO,uBAAuB,WAChC,QAAO,mBAAmB,WAAW;;AAIzC,QAAO,gBACL,YACA,EACE,cAAc,QACf,CACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BH,SAAgB,cAAgD,EAC9D,MACA,aACA,aACA,SACA,sBAAsB,OACtB,YACA,WACoC;CACpC,MAAM,EAAE,oBAAoB,yBAAyB,YAAY;CACjE,MAAM,aAAa,MAAM,OAAO,QAAQ;CACxC,MAAM,iBAAiB,MAAM,cACrB,wBAAwB,KAAK,EACnC,CAAC,KAAK,CACP;AAED,OAAM,gBAAgB;AACpB,aAAW,UAAU;IACpB,CAAC,QAAQ,CAAC;AAEb,OAAM,gBAAgB;EACpB,IAAI,cAAc;AAElB,GAAM,YAAY;GAChB,MAAM,YAAY,cAAc,WAAW,GAAG,MAAM,OAAO,SAAS;AACpE,OAAI,YACF;AAGF,sBAAmB;IACjB,YAAY;KACV,MAAM;KACN;KACA;KACA;KACA;KACA,YAAY,uBAAuB,YAAY,UAAU;KAC1D;IACD,UAAU,SAAS,WAAW,QAAQ,KAA8B;IACrE,CAAC;MACA;AAEJ,eAAa;AACX,iBAAc;AACd,wBAAqB,eAAe;;IAErC;EACD;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@super_studio/ecforce-ai-agent-react",
-  "version": "1.2.0-canary.0",
+  "version": "1.2.0-canary.1",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
@@ -20,12 +20,13 @@
   },
   "dependencies": {
     "@radix-ui/react-dialog": "1.1.14",
-    "@radix-ui/react-tooltip": "1.2.7"
+    "@radix-ui/react-tooltip": "1.2.7",
+    "zod-to-json-schema": "3.25.2"
   },
   "peerDependencies": {
     "react": ">=16",
     "react-dom": ">=16",
-    "zod": ">=4"
+    "zod": ">=3"
   },
   "peerDependenciesMeta": {
     "zod": {

package/src/lib/client-tools.ts

@@ -2,6 +2,7 @@
 
 import React from "react";
 import type { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
 import { useChatbot } from "../components/provider/chatbot-provider";
 
 export type ClientToolJsonSchema = Record<string, unknown>;
@@ -52,6 +53,34 @@ function normalizeClientToolName(name: string) {
   return `${CLIENT_TOOL_NAME_PREFIX}${name}`;
 }
 
+function isZodV4Schema(parameters: z.ZodTypeAny) {
+  return "_zod" in (parameters as object);
+}
+
+function parametersToJsonSchema(
+  parameters: z.ZodTypeAny,
+  zodModule?: typeof import("zod"),
+): ClientToolJsonSchema {
+  if (zodModule && isZodV4Schema(parameters)) {
+    const nativeToJsonSchema = (
+      zodModule.z as typeof zodModule.z & {
+        toJSONSchema?: (schema: z.ZodTypeAny) => ClientToolJsonSchema;
+      }
+    ).toJSONSchema;
+
+    if (typeof nativeToJsonSchema === "function") {
+      return nativeToJsonSchema(parameters);
+    }
+  }
+
+  return zodToJsonSchema(
+    parameters as unknown as Parameters<typeof zodToJsonSchema>[0],
+    {
+      $refStrategy: "none",
+    },
+  ) as ClientToolJsonSchema;
+}
+
 /**
  * チャットボットから呼び出せるクライアントツールを登録します。
  *
@@ -102,7 +131,7 @@ export function useClientTool<TParameters extends z.ZodTypeAny>({
     let isCancelled = false;
 
     void (async () => {
-      const { z } = await import("zod");
+      const zodModule = isZodV4Schema(parameters) ? await import("zod") : undefined;
       if (isCancelled) {
         return;
       }
@@ -114,7 +143,7 @@ export function useClientTool<TParameters extends z.ZodTypeAny>({
           description,
           summary,
           requireConfirmation,
-          parameters: z.toJSONSchema(parameters),
+          parameters: parametersToJsonSchema(parameters, zodModule),
         },
         execute: (args) => executeRef.current(args as z.output<TParameters>),
       });