@botonic/plugin-ai-agents 0.46.0 → 2.23.0

package/{lib/cjs → src/lib}/structured-output/index.d.ts

@@ -1,4 +1,4 @@
-import type { OutputMessage } from '@botonic/core';
+import { OutputMessage } from '@botonic/shared';
 import { z } from 'zod';
 export interface Output {
     messages: OutputMessage[];
@@ -29,25 +29,25 @@ export declare const OutputSchema: z.ZodObject<{
             text: z.ZodString;
             buttons: z.ZodArray<z.ZodObject<{
                 text: z.ZodString;
-                url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                url: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
                 text: string;
-                url?: string | null | undefined;
+                url?: string | undefined;
             }, {
                 text: string;
-                url?: string | null | undefined;
+                url?: string | undefined;
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
             text: string;
             buttons: {
                 text: string;
-                url?: string | null | undefined;
+                url?: string | undefined;
             }[];
         }, {
             text: string;
             buttons: {
                 text: string;
-                url?: string | null | undefined;
+                url?: string | undefined;
             }[];
         }>;
     }, "strip", z.ZodTypeAny, {
@@ -56,7 +56,7 @@ export declare const OutputSchema: z.ZodObject<{
             text: string;
             buttons: {
                 text: string;
-                url?: string | null | undefined;
+                url?: string | undefined;
             }[];
         };
     }, {
@@ -65,7 +65,7 @@ export declare const OutputSchema: z.ZodObject<{
             text: string;
             buttons: {
                 text: string;
-                url?: string | null | undefined;
+                url?: string | undefined;
             }[];
         };
     }>, z.ZodObject<{
@@ -160,63 +160,9 @@ export declare const OutputSchema: z.ZodObject<{
         type: "exit";
     }, {
         type: "exit";
-    }>, z.ZodObject<{
-        type: z.ZodEnum<["botExecutor"]>;
-        content: z.ZodObject<{
-            text: z.ZodString;
-            buttons: z.ZodArray<z.ZodObject<{
-                text: z.ZodString;
-                payload: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                text: string;
-                payload: string;
-            }, {
-                text: string;
-                payload: string;
-            }>, "many">;
-        }, "strip", z.ZodTypeAny, {
-            text: string;
-            buttons: {
-                text: string;
-                payload: string;
-            }[];
-        }, {
-            text: string;
-            buttons: {
-                text: string;
-                payload: string;
-            }[];
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        type: "botExecutor";
-        content: {
-            text: string;
-            buttons: {
-                text: string;
-                payload: string;
-            }[];
-        };
-    }, {
-        type: "botExecutor";
-        content: {
-            text: string;
-            buttons: {
-                text: string;
-                payload: string;
-            }[];
-        };
     }>]>, "many">;
 }, "strip", z.ZodTypeAny, {
     messages: ({
-        type: "botExecutor";
-        content: {
-            text: string;
-            buttons: {
-                text: string;
-                payload: string;
-            }[];
-        };
-    } | {
         type: "carousel";
         content: {
             elements: {
@@ -243,21 +189,12 @@ export declare const OutputSchema: z.ZodObject<{
             text: string;
             buttons: {
                 text: string;
-                url?: string | null | undefined;
+                url?: string | undefined;
             }[];
         };
     })[];
 }, {
     messages: ({
-        type: "botExecutor";
-        content: {
-            text: string;
-            buttons: {
-                text: string;
-                payload: string;
-            }[];
-        };
-    } | {
         type: "carousel";
         content: {
             elements: {
@@ -284,7 +221,7 @@ export declare const OutputSchema: z.ZodObject<{
             text: string;
             buttons: {
                 text: string;
-                url?: string | null | undefined;
+                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 → src/lib}/structured-output/text-with-buttons.d.ts

@@ -1,4 +1,4 @@
-import type { TextWithButtonsMessage } from '@botonic/core';
+import { TextWithButtonsMessage } from '@botonic/shared';
 import z from 'zod';
 export type { TextWithButtonsMessage };
 export declare const TextWithButtonsSchema: z.ZodObject<{
@@ -7,25 +7,25 @@ export declare const TextWithButtonsSchema: z.ZodObject<{
         text: z.ZodString;
         buttons: z.ZodArray<z.ZodObject<{
             text: z.ZodString;
-            url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            url: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             text: string;
-            url?: string | null | undefined;
+            url?: string | undefined;
         }, {
             text: string;
-            url?: string | null | undefined;
+            url?: string | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         text: string;
         buttons: {
             text: string;
-            url?: string | null | undefined;
+            url?: string | undefined;
         }[];
     }, {
         text: string;
         buttons: {
             text: string;
-            url?: string | null | undefined;
+            url?: string | undefined;
         }[];
     }>;
 }, "strip", z.ZodTypeAny, {
@@ -34,7 +34,7 @@ export declare const TextWithButtonsSchema: z.ZodObject<{
         text: string;
         buttons: {
             text: string;
-            url?: string | null | undefined;
+            url?: string | undefined;
         }[];
     };
 }, {
@@ -43,7 +43,7 @@ export declare const TextWithButtonsSchema: z.ZodObject<{
         text: string;
         buttons: {
             text: string;
-            url?: string | null | undefined;
+            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;AAEvB,2CAA6C;AAE7C,6CAAmD;AAGnD,2DAAkD;AAClD,mCAA2D;AAmB3D,MAAa,cAAc;IAWzB,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,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,gCAAY;YACxB,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;AAlJD,wCAkJC"}

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[];

package/lib/cjs/bot-config-tools.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getToolsForBotConfig = getToolsForBotConfig;
-const zod_to_json_schema_1 = require("zod-to-json-schema");
-/**
- * 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.
- */
-function getToolsForBotConfig(customTools) {
-    return customTools.map(tool => ({
-        name: tool.name,
-        description: tool.description,
-        // Cast to avoid TS "Type instantiation is excessively deep" with zodToJsonSchema + ZodSchema
-        schema: (0, zod_to_json_schema_1.zodToJsonSchema)(tool.schema, {
-            $refStrategy: 'none',
-        }),
-    }));
-}
-//# sourceMappingURL=bot-config-tools.js.map

package/lib/cjs/bot-config-tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bot-config-tools.js","sourceRoot":"","sources":["../../src/bot-config-tools.ts"],"names":[],"mappings":";;AASA,oDAWC;AAnBD,2DAAoD;AAIpD;;;GAGG;AACH,SAAgB,oBAAoB,CAClC,WAAyB;IAEzB,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,6FAA6F;QAC7F,MAAM,EAAE,IAAA,oCAAe,EAAC,IAAI,CAAC,MAAe,EAAE;YAC5C,YAAY,EAAE,MAAM;SACrB,CAA6B;KAC/B,CAAC,CAAC,CAAA;AACL,CAAC"}

package/lib/cjs/constants.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_MAX_RETRIES = exports.DEFAULT_TIMEOUT_16_SECONDS = exports.MAX_MEMORY_LENGTH = exports.isProd = exports.AZURE_OPENAI_API_VERSION = exports.AZURE_OPENAI_API_BASE = exports.AZURE_OPENAI_API_KEY = exports.OPENAI_PROVIDER = exports.OPENAI_MODEL = exports.OPENAI_API_KEY = exports.HUBTYPE_API_URL = void 0;
-exports.HUBTYPE_API_URL = process.env.HUBTYPE_API_URL || 'https://api.hubtype.com';
-// OpenAI Provider Configuration
-exports.OPENAI_API_KEY = process.env.OPENAI_API_KEY; // pragma: allowlist secret
-exports.OPENAI_MODEL = process.env.OPENAI_MODEL || 'gpt-4.1-mini';
-exports.OPENAI_PROVIDER = process.env.OPENAI_PROVIDER || 'azure';
-// Azure OpenAI Configuration
-exports.AZURE_OPENAI_API_KEY = process.env.AZURE_OPENAI_API_KEY; // pragma: allowlist secret
-exports.AZURE_OPENAI_API_BASE = process.env.AZURE_OPENAI_API_BASE;
-exports.AZURE_OPENAI_API_VERSION = process.env.AZURE_OPENAI_API_VERSION || '2025-01-01-preview';
-exports.isProd = process.env.NODE_ENV === 'production';
-exports.MAX_MEMORY_LENGTH = 25;
-exports.DEFAULT_TIMEOUT_16_SECONDS = 16000;
-exports.DEFAULT_MAX_RETRIES = 2;
-//# sourceMappingURL=constants.js.map

package/lib/cjs/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAC1B,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,yBAAyB,CAAA;AAE1D,gCAAgC;AACnB,QAAA,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAA,CAAC,2BAA2B;AACvE,QAAA,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,cAAc,CAAA;AACzD,QAAA,eAAe,GACzB,OAAO,CAAC,GAAG,CAAC,eAAsC,IAAI,OAAO,CAAA;AAEhE,6BAA6B;AAChB,QAAA,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAA,CAAC,2BAA2B;AACnF,QAAA,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAA;AACzD,QAAA,wBAAwB,GACnC,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,oBAAoB,CAAA;AAEjD,QAAA,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAA;AAE9C,QAAA,iBAAiB,GAAG,EAAE,CAAA;AAEtB,QAAA,0BAA0B,GAAG,KAAK,CAAA;AAClC,QAAA,mBAAmB,GAAG,CAAC,CAAA"}

package/lib/cjs/debug-logger.d.ts

@@ -1,33 +0,0 @@
-import type { AiAgentArgs, ToolExecution } from '@botonic/core';
-import type { ModelSettings } from '@openai/agents';
-import type { AgenticInputMessage, MemoryOptions, RunResult } from './types';
-export interface DebugLoggerConfig {
-    messageHistoryApiVersion: string;
-    maxRetries: number;
-    timeout: number;
-    customToolNames: string[];
-    memory: MemoryOptions;
-}
-export interface ModelSettingsInfo {
-    provider: string;
-    model: string | undefined;
-    reasoning?: {
-        effort: string;
-    };
-    text?: {
-        verbosity: string;
-    };
-    toolChoice?: string;
-    hasRetrieveKnowledge: boolean;
-}
-export interface DebugLogger {
-    logInitialConfig(config: DebugLoggerConfig): void;
-    logAgentDebugInfo(aiAgentArgs: AiAgentArgs, toolNames: string[], messages: AgenticInputMessage[]): void;
-    logModelSettings(settings: ModelSettingsInfo): void;
-    logRunnerStart(model: string, modelSettings: ModelSettings): void;
-    logRunResult(runResult: RunResult, startTime: number): void;
-    logGuardrailTriggered(): void;
-    logRunnerError(startTime: number, error: unknown): void;
-    logToolExecution(toolExecution: ToolExecution): void;
-}
-export declare function createDebugLogger(enableDebug: boolean): DebugLogger;