@botonic/plugin-ai-agents 0.46.1 → 2.23.0

package/src/lib/structured-output/index.d.ts

@@ -0,0 +1,228 @@
+import { OutputMessage } from '@botonic/shared';
+import { z } from 'zod';
+export interface Output {
+    messages: OutputMessage[];
+}
+export declare const OutputSchema: z.ZodObject<{
+    messages: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        type: z.ZodEnum<["text"]>;
+        content: z.ZodObject<{
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+        }, {
+            text: string;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "text";
+        content: {
+            text: string;
+        };
+    }, {
+        type: "text";
+        content: {
+            text: string;
+        };
+    }>, z.ZodObject<{
+        type: z.ZodEnum<["textWithButtons"]>;
+        content: z.ZodObject<{
+            text: z.ZodString;
+            buttons: z.ZodArray<z.ZodObject<{
+                text: z.ZodString;
+                url: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                text: string;
+                url?: string | undefined;
+            }, {
+                text: string;
+                url?: string | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            buttons: {
+                text: string;
+                url?: string | undefined;
+            }[];
+        }, {
+            text: string;
+            buttons: {
+                text: string;
+                url?: string | undefined;
+            }[];
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "textWithButtons";
+        content: {
+            text: string;
+            buttons: {
+                text: string;
+                url?: string | undefined;
+            }[];
+        };
+    }, {
+        type: "textWithButtons";
+        content: {
+            text: string;
+            buttons: {
+                text: string;
+                url?: string | undefined;
+            }[];
+        };
+    }>, z.ZodObject<{
+        type: z.ZodEnum<["carousel"]>;
+        content: z.ZodObject<{
+            text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            elements: z.ZodArray<z.ZodObject<{
+                title: z.ZodString;
+                subtitle: z.ZodString;
+                image: z.ZodString;
+                button: z.ZodObject<{
+                    text: z.ZodString;
+                    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, "strip", z.ZodTypeAny, {
+                    text: string;
+                    url?: string | null | undefined;
+                }, {
+                    text: string;
+                    url?: string | null | undefined;
+                }>;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                subtitle: string;
+                image: string;
+                button: {
+                    text: string;
+                    url?: string | null | undefined;
+                };
+            }, {
+                title: string;
+                subtitle: string;
+                image: string;
+                button: {
+                    text: string;
+                    url?: string | null | undefined;
+                };
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            elements: {
+                title: string;
+                subtitle: string;
+                image: string;
+                button: {
+                    text: string;
+                    url?: string | null | undefined;
+                };
+            }[];
+            text?: string | null | undefined;
+        }, {
+            elements: {
+                title: string;
+                subtitle: string;
+                image: string;
+                button: {
+                    text: string;
+                    url?: string | null | undefined;
+                };
+            }[];
+            text?: string | null | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "carousel";
+        content: {
+            elements: {
+                title: string;
+                subtitle: string;
+                image: string;
+                button: {
+                    text: string;
+                    url?: string | null | undefined;
+                };
+            }[];
+            text?: string | null | undefined;
+        };
+    }, {
+        type: "carousel";
+        content: {
+            elements: {
+                title: string;
+                subtitle: string;
+                image: string;
+                button: {
+                    text: string;
+                    url?: string | null | undefined;
+                };
+            }[];
+            text?: string | null | undefined;
+        };
+    }>, z.ZodObject<{
+        type: z.ZodEnum<["exit"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "exit";
+    }, {
+        type: "exit";
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    messages: ({
+        type: "carousel";
+        content: {
+            elements: {
+                title: string;
+                subtitle: string;
+                image: string;
+                button: {
+                    text: string;
+                    url?: string | null | undefined;
+                };
+            }[];
+            text?: string | null | undefined;
+        };
+    } | {
+        type: "exit";
+    } | {
+        type: "text";
+        content: {
+            text: string;
+        };
+    } | {
+        type: "textWithButtons";
+        content: {
+            text: string;
+            buttons: {
+                text: string;
+                url?: string | undefined;
+            }[];
+        };
+    })[];
+}, {
+    messages: ({
+        type: "carousel";
+        content: {
+            elements: {
+                title: string;
+                subtitle: string;
+                image: string;
+                button: {
+                    text: string;
+                    url?: string | null | undefined;
+                };
+            }[];
+            text?: string | null | undefined;
+        };
+    } | {
+        type: "exit";
+    } | {
+        type: "text";
+        content: {
+            text: string;
+        };
+    } | {
+        type: "textWithButtons";
+        content: {
+            text: string;
+            buttons: {
+                text: string;
+                url?: string | undefined;
+            }[];
+        };
+    })[];
+}>;

package/src/lib/structured-output/index.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import { CarouselSchema } from './carousel';
+import { ExitSchema } from './exit';
+import { TextSchema } from './text';
+import { TextWithButtonsSchema } from './text-with-buttons';
+export const OutputSchema = z
+    .object({
+    messages: z.array(z.union([TextSchema, TextWithButtonsSchema, CarouselSchema, ExitSchema])),
+})
+    .describe('The messages to be sent to the user');
+//# sourceMappingURL=index.js.map

package/src/lib/structured-output/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/plugin-ai-agents/src/lib/structured-output/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAM3D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,qBAAqB,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC,CACzE;CACF,CAAC;KACD,QAAQ,CAAC,qCAAqC,CAAC,CAAA"}

package/{lib/esm/structured-output/bot-executor.d.ts → src/lib/structured-output/text-with-buttons.d.ts}

@@ -1,49 +1,49 @@
-import type { BotExecutorMessage } from '@botonic/core';
+import { TextWithButtonsMessage } from '@botonic/shared';
 import z from 'zod';
-export type { BotExecutorMessage };
-export declare const BotExecutorSchema: z.ZodObject<{
-    type: z.ZodEnum<["botExecutor"]>;
+export type { TextWithButtonsMessage };
+export declare const TextWithButtonsSchema: z.ZodObject<{
+    type: z.ZodEnum<["textWithButtons"]>;
     content: z.ZodObject<{
         text: z.ZodString;
         buttons: z.ZodArray<z.ZodObject<{
             text: z.ZodString;
-            payload: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             text: string;
-            payload: string;
+            url?: string | undefined;
         }, {
             text: string;
-            payload: string;
+            url?: string | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         text: string;
         buttons: {
             text: string;
-            payload: string;
+            url?: string | undefined;
         }[];
     }, {
         text: string;
         buttons: {
             text: string;
-            payload: string;
+            url?: string | undefined;
         }[];
     }>;
 }, "strip", z.ZodTypeAny, {
-    type: "botExecutor";
+    type: "textWithButtons";
     content: {
         text: string;
         buttons: {
             text: string;
-            payload: string;
+            url?: string | undefined;
         }[];
     };
 }, {
-    type: "botExecutor";
+    type: "textWithButtons";
     content: {
         text: string;
         buttons: {
             text: string;
-            payload: string;
+            url?: string | undefined;
         }[];
     };
 }>;

package/src/lib/structured-output/text-with-buttons.js

@@ -0,0 +1,14 @@
+import z from 'zod';
+export const TextWithButtonsSchema = z
+    .object({
+    type: z.enum(['textWithButtons']),
+    content: z.object({
+        text: z.string(),
+        buttons: z.array(z.object({
+            text: z.string(),
+            url: z.string().optional(),
+        })),
+    }),
+})
+    .describe('A text message with buttons to allow the user to use quick replies');
+//# sourceMappingURL=text-with-buttons.js.map

package/src/lib/structured-output/text-with-buttons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-with-buttons.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/plugin-ai-agents/src/lib/structured-output/text-with-buttons.ts"],"names":[],"mappings":"AACA,OAAO,CAAC,MAAM,KAAK,CAAA;AAInB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC3B,CAAC,CACH;KACF,CAAC;CACH,CAAC;KACD,QAAQ,CACP,oEAAoE,CACrE,CAAA"}

package/{lib/esm → src/lib}/structured-output/text.d.ts

@@ -1,4 +1,4 @@
-import type { TextMessage } from '@botonic/core';
+import { TextMessage } from '@botonic/shared';
 import { z } from 'zod';
 export type { TextMessage };
 export declare const TextSchema: z.ZodObject<{

package/src/lib/structured-output/text.js

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export const TextSchema = z
+    .object({
+    type: z.enum(['text']),
+    content: z.object({
+        text: z.string(),
+    }),
+})
+    .describe('A text message');
+//# sourceMappingURL=text.js.map

package/src/lib/structured-output/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/plugin-ai-agents/src/lib/structured-output/text.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;IACtB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;CACH,CAAC;KACD,QAAQ,CAAC,gBAAgB,CAAC,CAAA"}

package/{lib/esm → src/lib}/tools/index.d.ts

@@ -1,3 +1,3 @@
-import type { Tool } from '../types';
+import { Tool } from '../types';
 export { retrieveKnowledge } from './retrieve-knowledge';
 export declare const mandatoryTools: Tool[];

package/src/lib/tools/index.js

@@ -0,0 +1,3 @@
+export { retrieveKnowledge } from './retrieve-knowledge';
+export const mandatoryTools = [];
+//# sourceMappingURL=index.js.map

package/src/lib/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/plugin-ai-agents/src/lib/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAExD,MAAM,CAAC,MAAM,cAAc,GAAW,EAAE,CAAA"}

package/{lib/cjs → src/lib}/tools/retrieve-knowledge.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import type { Context } from '../types';
-export declare const retrieveKnowledge: import("@openai/agents").FunctionTool<Context<import("@botonic/core").ResolvedPlugins, any>, z.ZodObject<{
+import { AiAgentContext } from '../types';
+export declare const retrieveKnowledge: import("@openai/agents").FunctionTool<AiAgentContext<import("dist/libs/botonic/shared/src").ResolvedPlugins, import("dist/libs/botonic/shared/src").UserExtraData>, z.ZodObject<{
     query: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     query: string;

package/src/lib/tools/retrieve-knowledge.js

@@ -0,0 +1,30 @@
+import { __awaiter } from "tslib";
+import { tool } from '@openai/agents';
+import { z } from 'zod';
+import { HubtypeApiClient } from '../hubtype-api-client';
+export const retrieveKnowledge = tool({
+    name: 'retrieve_knowledge',
+    description: 'Consult the knowledge base for information before answering. Use this tool to make sure the information you provide is faithful.',
+    parameters: z.object({
+        query: z.string().describe('The query to search the knowledge base for'),
+    }),
+    execute: (input, runContext) => __awaiter(void 0, void 0, void 0, function* () {
+        const context = runContext === null || runContext === void 0 ? void 0 : runContext.context;
+        const query = input.query;
+        if (!context) {
+            throw new Error('Context is required');
+        }
+        const sourceIds = context.sourceIds;
+        const client = new HubtypeApiClient(context.authToken);
+        const chunks = yield client.retrieveSimilarChunks(query, sourceIds);
+        const chunkTexts = chunks.map(chunk => chunk.text);
+        context.knowledgeUsed = {
+            query,
+            sourceIds,
+            chunksIds: chunks.map(chunk => chunk.id),
+            chunkTexts,
+        };
+        return chunkTexts;
+    }),
+});
+//# sourceMappingURL=retrieve-knowledge.js.map

package/src/lib/tools/retrieve-knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-knowledge.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/plugin-ai-agents/src/lib/tools/retrieve-knowledge.ts"],"names":[],"mappings":";AAAA,OAAO,EAAc,IAAI,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAGxD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;IACpC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,kIAAkI;IACpI,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;KACzE,CAAC;IACF,OAAO,EAAE,CACP,KAAwB,EACxB,UAAuC,EACpB,EAAE;QACrB,MAAM,OAAO,GAAG,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,OAAO,CAAA;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;QACzB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;QACxC,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;QACnC,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QACtD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QACnE,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAElD,OAAO,CAAC,aAAa,GAAG;YACtB,KAAK;YACL,SAAS;YACT,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,UAAU;SACX,CAAA;QAED,OAAO,UAAU,CAAA;IACnB,CAAC,CAAA;CACF,CAAC,CAAA"}

package/{lib/esm → src/lib}/types.d.ts

@@ -1,8 +1,8 @@
-import { AgenticOutputMessage, AiAgentArgs, type BotContext, GuardrailRule, InferenceResponse, type ResolvedPlugins, RunResult } from '@botonic/core';
+import type { AgenticOutputMessage, AiAgentArgs, BotContext, GuardrailRule, InferenceResponse, ResolvedPlugins, RunResult, UserExtraData } from '@botonic/shared';
 import type { Agent, AgentInputItem, AgentOutputType, RunContext as OpenAIRunContext, Tool as OpenAITool } from '@openai/agents';
 import type { ZodSchema } from 'zod';
 import type { OutputSchema } from './structured-output';
-export interface Context<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = any> {
+export interface AiAgentContext<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData extends UserExtraData = UserExtraData> {
     authToken: string;
     sourceIds: string[];
     knowledgeUsed: {
@@ -11,10 +11,10 @@ export interface Context<TPlugins extends ResolvedPlugins = ResolvedPlugins, TEx
         chunksIds: string[];
         chunkTexts: string[];
     };
-    request: BotContext<TPlugins, TExtraData>;
+    botonicContext: BotContext<TPlugins, TExtraData>;
 }
-export type RunContext<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = any> = OpenAIRunContext<Context<TPlugins, TExtraData>>;
-export interface CustomTool<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = any> {
+export type RunContext<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData extends UserExtraData = UserExtraData> = OpenAIRunContext<AiAgentContext<TPlugins, TExtraData>>;
+export interface CustomTool<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData extends UserExtraData = UserExtraData> {
     name: string;
     description: string;
     schema: ZodSchema;
@@ -24,8 +24,9 @@ export interface Chunk {
     id: string;
     text: string;
 }
-export type Tool<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = any> = OpenAITool<Context<TPlugins, TExtraData>>;
-export type AIAgent<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = any> = Agent<Context<TPlugins, TExtraData>, AgentOutputType<typeof OutputSchema>>;
+export type ContactInfo = Record<string, string>;
+export type Tool<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData extends UserExtraData = UserExtraData> = OpenAITool<AiAgentContext<TPlugins, TExtraData>>;
+export type AIAgent<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData extends UserExtraData = UserExtraData> = Agent<AiAgentContext<TPlugins, TExtraData>, AgentOutputType<typeof OutputSchema>>;
 export type MessageHistoryApiVersion = 'v1' | 'v2';
 export interface MemoryOptions {
     maxMessages?: number;
@@ -33,24 +34,13 @@ export interface MemoryOptions {
     maxFullToolResults?: number;
     debugMode?: boolean;
 }
-export interface PluginAiAgentOptions<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = any> {
-    authToken?: string;
+export interface PluginAiAgentOptions<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData extends UserExtraData = UserExtraData> {
     customTools?: CustomTool<TPlugins, TExtraData>[];
-    maxRetries?: number;
     timeout?: number;
-    /** API version for message history endpoint. Defaults to 'v2'. */
+    maxRetries?: number;
     messageHistoryApiVersion?: MessageHistoryApiVersion;
-    /** Options for V2 message history API. Only used when messageHistoryApiVersion is 'v2'. */
     memory?: MemoryOptions;
-    /** Enable debug logging for AI agent configuration and execution details. */
     enableDebug?: boolean;
 }
-export interface ResultRawResponse {
-    usage: {
-        inputTokens: number;
-        outputTokens: number;
-    };
-    providerData?: Record<string, unknown>;
-}
 export type AgenticInputMessage = AgentInputItem;
-export { AgenticOutputMessage, AiAgentArgs, GuardrailRule, InferenceResponse, RunResult, };
+export type { AgenticOutputMessage, AiAgentArgs, GuardrailRule, InferenceResponse, RunResult, };

package/src/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/src/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../libs/botonic/plugin-ai-agents/src/lib/types.ts"],"names":[],"mappings":""}

package/README.md

@@ -1,156 +0,0 @@
-# Botonic Plugin AI Agents
-
-## env variables
-
-- It is necessary to add the following variables to an `.env` file:
-  - `AZURE_OPENAI_API_KEY`
-  - `AZURE_OPENAI_API_BASE`
-  - `AZURE_OPENAI_API_DEPLOYMENT_NAME`
-  - `AZURE_OPENAI_API_VERSION`
-- Add these env variables to build using rspack, for target NODE and DEV.
-
-```ts
-...
-import { config } from 'dotenv'
-config()
-...
-  const plugins = [
-    new rspack.EnvironmentPlugin({
-      NODE_ENV: process.env.NODE_ENV,
-      HUBTYPE_API_URL: process.env.HUBTYPE_API_URL || HUBTYPE_DEFAULTS.API_URL,
-      BOTONIC_TARGET: BotonicTarget.NODE,
-      WEBCHAT_PUSHER_KEY:
-        process.env.WEBCHAT_PUSHER_KEY || HUBTYPE_DEFAULTS.WEBCHAT_PUSHER_KEY,
-      ENVIRONMENT: process.env.ENVIRONMENT,
-      AZURE_OPENAI_API_KEY: isNodeOrDev
-        ? process.env.AZURE_OPENAI_API_KEY
-        : undefined,
-      AZURE_OPENAI_API_DEPLOYMENT_NAME: isNodeOrDev
-        ? process.env.AZURE_OPENAI_API_DEPLOYMENT_NAME
-        : undefined,
-      AZURE_OPENAI_API_VERSION: isNodeOrDev
-        ? process.env.AZURE_OPENAI_API_VERSION
-        : undefined,
-      AZURE_OPENAI_API_BASE: isNodeOrDev
-        ? process.env.AZURE_OPENAI_API_BASE
-        : undefined,
-    }),
-    new rspack.ProgressPlugin(),
-  ]
-```
-
-## Custom Tools
-
-- It is possible to add tools from the bot code. To do this:
-- Add the `zod` dependency.
-- Create and export the definition of the tools in a file, for example: `src/server/tools.ts`.
-
-```ts
-import { CustomTool } from '@botonic/plugin-ai-agents'
-import axios from 'axios'
-import z from 'zod'
-
-export const customTools: CustomTool[] = [
-  {
-    name: 'get_current_weather',
-    description: 'Get current weather for a city',
-    schema: z.object({
-      cityName: z.string(),
-    }),
-    func: async (input: { cityName: string }) => {
-      const baseURL = 'http://api.weatherapi.com/v1'
-      const response = await axios.get(`${baseURL}/forecast.json`, {
-        params: {
-          key: 'WEATHER_API_TOKEN',
-          q: input.cityName,
-        },
-      })
-      const data = response.data
-      console.log('get_current_weather', { data })
-      return data
-    },
-  },
-  ...
-]
-```
-
-- Add these tools to:
-- Update the `BotonicPluginFlowBuilderOptions`, as we did with the knowledge base, and add the `customTools`.
-
-src/server/config.ts
-
-```ts
-import { PluginAiAgentOptions } from '@botonic/plugin-ai-agents'
-import { customTools } from './tools'
-
-...
-function getFlowBuilderConfig(
-  env: ENVIRONMENT
-): BotonicPluginFlowBuilderOptions<BotPlugins, UserData> {
-  return {
-...
-    getAiAgentResponse: async (
-      request: BotRequest,
-      aiAgentArgs: {
-        name: string
-        instructions: string
-      }
-    ) => {
-      const aiAgentPlugin = request.plugins.aiAgents
-      return await aiAgentPlugin.getInference(request, aiAgentArgs)
-    },
-...
-}
-
-function getAiAgentsConfig(): PluginAiAgentOptions {
-  return {
-    authToken: 'AUTH_TOKEN', // Used locally
-    customTools: customTools,
-  }
-}
-...
-
-interface Config {
-  // Use any for infer type for TPlugins and TExtraData
-  // to avoid type errors with circular dependencies
-  flowBuilder: BotonicPluginFlowBuilderOptions<any, any>
-  aiAgents: PluginAiAgentOptions
-  knowledgeBases: PluginKnowledgeBaseOptions
-}
-
-export const CONFIG: Record<ENVIRONMENT, Config> = {
-  [ENVIRONMENT.LOCAL]: {
-    flowBuilder: getFlowBuilderConfig(ENVIRONMENT.LOCAL),
-    aiAgents: getAiAgentsConfig(),
-    knowledgeBases: getKnowledgeBasesConfig(),
-  },
-  ...
-}
-```
-
-## Share customTools with flow builder frontend
-
-- Create new `src/bot-config.ts` file and add customTools. This file is used so that every time a bot is deployed, the Flow Builder frontend can know which tools are in the deployed bot and enable or disable tools for each AI Agent node.
-
-src/bot-config.ts
-
-```ts
-import { BotConfigJSON } from '@botonic/core'
-
-import { customTools } from './server/tools'
-
-const aiAgentTools =
-  customTools?.map(customTool => ({
-    name: customTool.name,
-    description: customTool.description,
-  })) || []
-
-/**
- * This is the configuration is shared with flow-builder-frontend.
- */
-export const botConfig: BotConfigJSON = {
-  tools: aiAgentTools,
-  payloads: [],
-  webviews: [],
-}
-```

package/lib/cjs/agent-builder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-builder.js","sourceRoot":"","sources":["../../src/agent-builder.ts"],"names":[],"mappings":";;;AACA,2CAIuB;AAGvB,2CAA6C;AAE7C,6CAAmD;AAGnD,2DAAwE;AACxE,mCAA2D;AAoB3D,MAAa,cAAc;IAYzB,YAAY,OAAoD;QAC9D,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,oBAAoB,CAC3C,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,gBAAgB,CACzB,CAAA;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;QACnE,IAAI,CAAC,6BAA6B,GAAG,OAAO,CAAC,qBAAqB,IAAI,EAAE,CAAA;QACxE,IAAI,CAAC,eAAe,GAAG,EAAE,CAAA;QACzB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;QAClC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAC5B,IAAI,OAAO,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,cAAc,GAAG,IAAA,iCAAoB,EACzC,OAAO,CAAC,mBAAmB,EAC3B,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,wBAAwB,CACjC,CAAA;YACD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;IAED,KAAK;QACH,+DAA+D;QAC/D,4CAA4C;QAE5C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAA;QACtC,MAAM,oBAAoB,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,yBAAiB,CAAC,CAAA;QAEnE,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;YAC3B,QAAQ,EAAE,2BAAe;YACzB,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,SAE3B;YACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAEtB;YACb,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,UAAgC;YACzE,oBAAoB;SACrB,CAAC,CAAA;QAEF,OAAO,IAAI,cAAK,CAGd;YACA,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK;YACL,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAA,mCAAe,EAAC,IAAI,CAAC,6BAA6B,CAAC;YAC/D,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,gBAAgB,EAAE,EAAE;SACrB,CAAC,CAAA;IACJ,CAAC;IAEO,oBAAoB,CAC1B,mBAA2B,EAC3B,WAA0B,EAC1B,gBAA+B;QAE/B,MAAM,YAAY,GAAG,mBAAmB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,CAAA;QACrF,MAAM,oBAAoB,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAA;QAC3D,MAAM,uBAAuB,GAAG,IAAI,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAA;QAC5E,MAAM,oBAAoB,GAAG,IAAI,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,CAAA;QAC3E,MAAM,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAA;QACvD,OAAO,GAAG,YAAY,OAAO,oBAAoB,OAAO,uBAAuB,OAAO,oBAAoB,OAAO,kBAAkB,EAAE,CAAA;IACvI,CAAC;IAEO,0BAA0B,CAAC,WAA0B;QAC3D,MAAM,qBAAqB,GAAG,WAAW;aACtC,GAAG,CACF,IAAI,CAAC,EAAE,CACL;sBACY,IAAI,CAAC,IAAI;uBACR,IAAI,CAAC,KAAK;sBACX,IAAI,CAAC,IAAI;gBAEf,IAAI,CAAC,WAAW;YACd,CAAC,CAAC,gBAAgB,IAAI,CAAC,WAAW,gBAAgB;YAClD,CAAC,CAAC,EACN;4BACc,CACrB;aACA,IAAI,CAAC,IAAI,CAAC,CAAA;QACb,OAAO,0BAA0B,qBAAqB,wBAAwB,CAAA;IAChF,CAAC;IAEO,uBAAuB;QAC7B,MAAM,QAAQ,GAAG,iBAAiB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAA;QAC5D,OAAO,eAAe,QAAQ,eAAe,CAAA;IAC/C,CAAC;IAEO,uBAAuB,CAAC,gBAA+B;QAC7D,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvD,OAAO,EAAE,CAAA;QACX,CAAC;QACD,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,MAAM,CAClD,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,aAAa,CACnC,CAAA;QACD,IAAI,oBAAoB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,EAAE,CAAA;QACX,CAAC;QACD,OAAO,oBAAoB;aACxB,GAAG,CACF,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAClB,qBAAqB,KAAK,GAAG,CAAC,MAAM,QAAQ,CAAC,aAAa,wBAAwB,KAAK,GAAG,CAAC,GAAG,CACjG;aACA,IAAI,CAAC,IAAI,CAAC,CAAA;IACf,CAAC;IAEO,qBAAqB;QAC3B,MAAM,OAAO,GAAG;YACd,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,kCAAkC;qBACzC;iBACF;aACF;SACF,CAAA;QACD,MAAM,MAAM,GAAG,yIAAyI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,CAAA;QAC7L,OAAO,aAAa,MAAM,aAAa,CAAA;IACzC,CAAC;IAEO,eAAe,CACrB,KAAmC,EACnC,SAAmB;QAEnB,MAAM,YAAY,GAAW,CAAC,GAAG,sBAAc,CAAC,CAAA;QAChD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,YAAY,CAAC,IAAI,CAAC,yBAAiB,CAAC,CAAA;QACtC,CAAC;QACD,OAAO,CAAC,GAAG,YAAY,EAAE,GAAG,KAAK,CAAC,CAAA;IACpC,CAAC;CACF;AApJD,wCAoJC"}

package/lib/cjs/bot-config-tools.d.ts

@@ -1,7 +0,0 @@
-import type { ToolConfigJSON } from '@botonic/core';
-import type { CustomTool } from './types';
-/**
- * Maps custom AI agent tools to the format expected by bot config (e.g. for flow-builder).
- * Converts each tool's Zod schema to JSON Schema so it can be serialized in the config.
- */
-export declare function getToolsForBotConfig(customTools: CustomTool[]): ToolConfigJSON[];