@botonic/plugin-ai-agents 0.46.1 → 2.23.1

package/src/lib/runner.js

@@ -0,0 +1,96 @@
+import { __awaiter } from "tslib";
+import { InputGuardrailTripwireTriggered, Runner, RunToolCallItem, } from '@openai/agents';
+import { retrieveKnowledge } from './tools';
+export class AIAgentRunner {
+    constructor(agent, logger) {
+        this.agent = agent;
+        this.logger = logger;
+    }
+    run(messages, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const startTime = Date.now();
+            this.logger.logRunnerStart();
+            try {
+                const runner = new Runner({
+                    modelSettings: { temperature: 0 },
+                });
+                // Type assertion to bypass strict type checking - the actual return type from runner.run()
+                // doesn't perfectly match our interface, but the properties we access are compatible
+                const result = (yield runner.run(this.agent, messages, {
+                    context,
+                }));
+                const outputMessages = ((_a = result.finalOutput) === null || _a === void 0 ? void 0 : _a.messages) || [];
+                const hasExit = outputMessages.length === 0 ||
+                    outputMessages.some(message => message.type === 'exit');
+                const toolsExecuted = this.getToolsExecuted(result, context);
+                const runResult = {
+                    messages: hasExit
+                        ? []
+                        : outputMessages.filter(message => message.type !== 'exit'),
+                    toolsExecuted,
+                    exit: hasExit,
+                    memoryLength: messages.length,
+                    error: false,
+                    inputGuardrailsTriggered: [],
+                    outputGuardrailsTriggered: [],
+                };
+                this.logger.logRunResult(runResult, startTime);
+                return runResult;
+            }
+            catch (error) {
+                if (error instanceof InputGuardrailTripwireTriggered) {
+                    const runResult = {
+                        messages: [],
+                        memoryLength: 0,
+                        toolsExecuted: [],
+                        exit: true,
+                        error: false,
+                        inputGuardrailsTriggered: error.result.output.outputInfo,
+                        outputGuardrailsTriggered: [],
+                    };
+                    this.logger.logGuardrailTriggered();
+                    this.logger.logRunResult(runResult, startTime);
+                    return runResult;
+                }
+                this.logger.logRunnerError(startTime, error);
+                throw error;
+            }
+        });
+    }
+    getToolsExecuted(result, context) {
+        var _a;
+        return (((_a = result.newItems) === null || _a === void 0 ? void 0 : _a.filter((item) => item instanceof RunToolCallItem).map((item) => this.getToolExecutionInfo(item, context)).filter((toolExecution) => toolExecution.toolName !== '')) || []);
+    }
+    getToolExecutionInfo(item, context) {
+        if (item.rawItem.type !== 'function_call') {
+            return {
+                toolName: '',
+                toolArguments: {},
+            };
+        }
+        const toolName = item.rawItem.name;
+        const toolArguments = this.getSafeToolArguments(item.rawItem.arguments);
+        if (toolName === retrieveKnowledge.name) {
+            return {
+                toolName,
+                toolArguments,
+                knowledgebaseSourcesIds: context.knowledgeUsed.sourceIds,
+                knowledgebaseChunksIds: context.knowledgeUsed.chunksIds,
+            };
+        }
+        return {
+            toolName,
+            toolArguments,
+        };
+    }
+    getSafeToolArguments(rawToolArguments) {
+        try {
+            return JSON.parse(rawToolArguments);
+        }
+        catch (error) {
+            return {};
+        }
+    }
+}
+//# sourceMappingURL=runner.js.map

package/src/lib/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../../../../libs/botonic/plugin-ai-agents/src/lib/runner.ts"],"names":[],"mappings":"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"}

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

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

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

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export const CarouselSchema = z
+    .object({
+    type: z.enum(['carousel']),
+    content: z.object({
+        text: z.string().nullable().optional(),
+        elements: z.array(z.object({
+            title: z.string(),
+            subtitle: z.string(),
+            image: z.string(),
+            button: z.object({
+                text: z.string(),
+                url: z.string().nullable().optional(),
+            }),
+        })),
+    }),
+})
+    .describe('A carousel message containing a list of elements');
+//# sourceMappingURL=carousel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"carousel.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/plugin-ai-agents/src/lib/structured-output/carousel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACtC,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;YACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;YACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;gBAChB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;aACtC,CAAC;SACH,CAAC,CACH;KACF,CAAC;CACH,CAAC;KACD,QAAQ,CAAC,kDAAkD,CAAC,CAAA"}

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

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

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

@@ -0,0 +1,7 @@
+import z from 'zod';
+export const ExitSchema = z
+    .object({
+    type: z.enum(['exit']),
+})
+    .describe('An exit message. This message should only be used to exit the agent due to out of context or the user asking to exit the conversation');
+//# sourceMappingURL=exit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exit.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/plugin-ai-agents/src/lib/structured-output/exit.ts"],"names":[],"mappings":"AACA,OAAO,CAAC,MAAM,KAAK,CAAA;AAInB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;KACD,QAAQ,CACP,uIAAuI,CACxI,CAAA"}

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/lib/cjs/agent-builder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-builder.js","sourceRoot":"","sources":["../../src/agent-builder.ts"],"names":[],"mappings":"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"}