@botonic/plugin-ai-agents 2.29.0 → 2.31.0

package/src/lib/runners/base-runner.js

@@ -0,0 +1,182 @@
+import { __awaiter } from "tslib";
+import { InputGuardrailTripwireTriggered, Runner, RunToolCallItem, RunToolCallOutputItem, } from '@openai/agents';
+import { HubtypeApiClient } from '../services/hubtype-api-client';
+import { TrackFeature, TrackProductName } from '../services/types';
+import { RETRIEVE_KNOWLEDGE_TOOL_NAME } from '../tools';
+export class BaseRunner {
+    constructor(agent, llmConfig, inferenceId, logger) {
+        this.agent = agent;
+        this.llmConfig = llmConfig;
+        this.inferenceId = inferenceId;
+        this.logger = logger;
+    }
+    run(messages, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const startTime = Date.now();
+            this.logger.logRunnerStart(this.llmConfig.modelName, this.llmConfig.modelSettings);
+            try {
+                const runner = new Runner({
+                    tracingDisabled: true,
+                });
+                const result = (yield runner.run(this.agent, messages, {
+                    context,
+                }));
+                const endTime = Date.now();
+                yield this.sendLlmRunTracking(result, context, startTime, endTime);
+                const runResult = this.buildRunResult(result, context, messages.length);
+                this.logger.logRunResult(runResult, startTime);
+                return runResult;
+            }
+            catch (error) {
+                const runResult = this.handleInputGuardrailTripwireTriggered(error, startTime);
+                if (runResult) {
+                    return runResult;
+                }
+                this.logger.logRunnerError(startTime, error);
+                throw error;
+            }
+        });
+    }
+    getToolsExecuted(result, context) {
+        var _a;
+        const toolResultsByCallId = this.getToolResultsByCallId(result.newItems);
+        return (((_a = result.newItems) === null || _a === void 0 ? void 0 : _a.filter(item => item instanceof RunToolCallItem).map((item) => this.getToolExecutionInfo(item, context, toolResultsByCallId)).filter((toolExecution) => toolExecution.toolName !== '')) || []);
+    }
+    getToolResultsByCallId(newItems = []) {
+        const map = new Map();
+        for (const item of newItems) {
+            if (!(item instanceof RunToolCallOutputItem)) {
+                continue;
+            }
+            const rawItem = item.rawItem;
+            const callId = rawItem === null || rawItem === void 0 ? void 0 : rawItem.callId;
+            const output = rawItem === null || rawItem === void 0 ? void 0 : rawItem.output;
+            if (callId == null || output == null) {
+                continue;
+            }
+            const text = this.extractToolResult(output);
+            if (text != null) {
+                map.set(callId, text);
+            }
+        }
+        return map;
+    }
+    extractToolResult(output) {
+        if (typeof output === 'string') {
+            return output;
+        }
+        return (output === null || output === void 0 ? void 0 : output.type) === 'text' && typeof (output === null || output === void 0 ? void 0 : output.text) === 'string'
+            ? output.text
+            : undefined;
+    }
+    getToolExecutionInfo(item, context, toolResultsByCallId) {
+        if (item.rawItem.type !== 'function_call') {
+            return {
+                toolName: '',
+                toolArguments: {},
+            };
+        }
+        const toolName = item.rawItem.name;
+        const toolArguments = this.getSafeToolArguments(item.rawItem.arguments);
+        const toolResults = item.rawItem.callId
+            ? toolResultsByCallId.get(item.rawItem.callId)
+            : undefined;
+        const toolExecution = {
+            toolName,
+            toolArguments,
+            toolResults,
+        };
+        if (toolName === RETRIEVE_KNOWLEDGE_TOOL_NAME) {
+            return Object.assign(Object.assign({}, toolExecution), { knowledgebaseSourcesIds: context.knowledgeUsed.sourceIds, knowledgebaseChunksIds: context.knowledgeUsed.chunksIds });
+        }
+        return toolExecution;
+    }
+    getSafeToolArguments(rawToolArguments) {
+        try {
+            return JSON.parse(rawToolArguments);
+        }
+        catch (_error) {
+            return {};
+        }
+    }
+    buildRunResult(result, context, memoryLength) {
+        var _a;
+        const outputMessages = ((_a = result.finalOutput) === null || _a === void 0 ? void 0 : _a.messages) || [];
+        const hasExit = outputMessages.length === 0 ||
+            outputMessages.some(message => message.type === 'exit');
+        return {
+            startingAgentName: '',
+            lastAgentName: '',
+            availableSpecialists: [],
+            isTransferredToSpecialist: false,
+            messages: hasExit
+                ? []
+                : outputMessages.filter(message => message.type !== 'exit'),
+            toolsExecuted: this.getToolsExecuted(result, context),
+            exit: hasExit,
+            memoryLength,
+            error: false,
+            inputGuardrailsTriggered: [],
+            outputGuardrailsTriggered: [],
+        };
+    }
+    sendLlmRunTracking(result, context, startTime, endTime) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const rawResponses = (_a = result.rawResponses) !== null && _a !== void 0 ? _a : [];
+            if (rawResponses.length === 0) {
+                return;
+            }
+            const botonicContext = context.botonicContext;
+            const botId = botonicContext.session.bot.id;
+            const isTest = botonicContext.session.isTestIntegration;
+            const totalDuration = endTime - startTime;
+            const durationPerCall = Math.round(totalDuration / rawResponses.length);
+            const temperature = (_b = this.llmConfig.modelSettings.temperature) !== null && _b !== void 0 ? _b : 0;
+            const apiVersion = (_c = this.llmConfig.getApiVersion()) !== null && _c !== void 0 ? _c : 'NOT_API_VERSION_FOR_LITELLM';
+            const llmRuns = rawResponses.map(response => {
+                var _a, _b;
+                return ({
+                    inference_id: this.inferenceId,
+                    is_test: isTest,
+                    product_name: TrackProductName.AI_AGENT,
+                    deployment_name: this.llmConfig.modelName,
+                    model_name: (_b = (_a = response.providerData) === null || _a === void 0 ? void 0 : _a['model']) !== null && _b !== void 0 ? _b : this.llmConfig.modelName,
+                    feature: TrackFeature.AI_AGENT_RUN,
+                    api_version: apiVersion,
+                    num_prompt_tokens: response.usage.inputTokens,
+                    num_completion_tokens: response.usage.outputTokens,
+                    duration_in_milliseconds: durationPerCall,
+                    temperature,
+                    error: null,
+                });
+            });
+            const client = new HubtypeApiClient(botonicContext);
+            yield client.trackLlmRuns(botId, {
+                llm_runs: llmRuns,
+            });
+        });
+    }
+    handleInputGuardrailTripwireTriggered(error, startTime) {
+        if (error instanceof InputGuardrailTripwireTriggered) {
+            const runResult = {
+                startingAgentName: '',
+                lastAgentName: '',
+                availableSpecialists: [],
+                isTransferredToSpecialist: false,
+                messages: [],
+                memoryLength: 0,
+                toolsExecuted: [],
+                exit: true,
+                error: false,
+                inputGuardrailsTriggered: error.result.output.outputInfo,
+                outputGuardrailsTriggered: [],
+            };
+            this.logger.logGuardrailTriggered();
+            this.logger.logRunResult(runResult, startTime);
+            return runResult;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=base-runner.js.map

package/src/lib/runners/base-runner.js.map

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

package/src/lib/runners/index.d.ts

@@ -0,0 +1,2 @@
+export { RouterRunner } from './router-runner';
+export { SpecialistRunner } from './specialist-runner';

package/src/lib/runners/index.js

@@ -0,0 +1,3 @@
+export { RouterRunner } from './router-runner';
+export { SpecialistRunner } from './specialist-runner';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/plugin-ai-agents/src/lib/runners/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA"}

package/src/lib/runners/router-runner.d.ts

@@ -0,0 +1,8 @@
+import type { ResolvedPlugins, UserExtraData } from '@botonic/core';
+import type { AiAgentContext, RunResult } from '../types';
+import { BaseRunner, type RunnerResult } from './base-runner';
+export declare class RouterRunner<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData extends UserExtraData = UserExtraData> extends BaseRunner<TPlugins, TExtraData> {
+    protected buildRunResult(result: RunnerResult, context: AiAgentContext<TPlugins, TExtraData>, memoryLength: number): RunResult;
+    protected handleInputGuardrailTripwireTriggered(error: unknown, startTime: number): RunResult | undefined;
+    private getAvailableSpecialists;
+}

package/src/lib/runners/router-runner.js

@@ -0,0 +1,40 @@
+import { Handoff } from '@openai/agents';
+import { BaseRunner } from './base-runner';
+export class RouterRunner extends BaseRunner {
+    buildRunResult(result, context, memoryLength) {
+        var _a, _b, _c;
+        const base = super.buildRunResult(result, context, memoryLength);
+        const availableSpecialists = this.getAvailableSpecialists();
+        const startingAgentName = (_a = this.agent.name) !== null && _a !== void 0 ? _a : '';
+        const lastAgentName = (_c = (_b = result.lastAgent) === null || _b === void 0 ? void 0 : _b.name) !== null && _c !== void 0 ? _c : '';
+        return Object.assign(Object.assign({}, base), { startingAgentName,
+            lastAgentName,
+            availableSpecialists, isTransferredToSpecialist: startingAgentName !== lastAgentName });
+    }
+    handleInputGuardrailTripwireTriggered(error, startTime) {
+        const runResult = super.handleInputGuardrailTripwireTriggered(error, startTime);
+        if (runResult) {
+            runResult.startingAgentName = this.agent.name;
+            runResult.lastAgentName = this.agent.name;
+            runResult.availableSpecialists = this.getAvailableSpecialists();
+            runResult.isTransferredToSpecialist = false;
+            return runResult;
+        }
+        return undefined;
+    }
+    getAvailableSpecialists() {
+        var _a;
+        return ((_a = this.agent.handoffs) !== null && _a !== void 0 ? _a : []).map(
+        // biome-ignore lint/suspicious/noExplicitAny: handoff entries use internal SDK types
+        (entry) => {
+            const isHandoff = entry instanceof Handoff;
+            // biome-ignore lint/suspicious/noExplicitAny: SDK types
+            const agent = isHandoff ? entry.agent : entry;
+            const description = isHandoff
+                ? entry.toolDescription
+                : agent.handoffDescription;
+            return { name: agent.name, description };
+        });
+    }
+}
+//# sourceMappingURL=router-runner.js.map

package/src/lib/runners/router-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-runner.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/plugin-ai-agents/src/lib/runners/router-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAGpD,OAAO,EAAE,UAAU,EAAqB,MAAM,eAAe,CAAA;AAE7D,MAAM,OAAO,YAGX,SAAQ,UAAgC;IACrB,cAAc,CAC/B,MAAoB,EACpB,OAA6C,EAC7C,YAAoB;;QAEpB,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA;QAEhE,MAAM,oBAAoB,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAA;QAC3D,MAAM,iBAAiB,GAAG,MAAA,IAAI,CAAC,KAAK,CAAC,IAAI,mCAAI,EAAE,CAAA;QAC/C,MAAM,aAAa,GAAG,MAAA,MAAA,MAAM,CAAC,SAAS,0CAAE,IAAI,mCAAI,EAAE,CAAA;QAElD,uCACK,IAAI,KACP,iBAAiB;YACjB,aAAa;YACb,oBAAoB,EACpB,yBAAyB,EAAE,iBAAiB,KAAK,aAAa,IAC/D;IACH,CAAC;IAEkB,qCAAqC,CACtD,KAAc,EACd,SAAiB;QAEjB,MAAM,SAAS,GAAG,KAAK,CAAC,qCAAqC,CAC3D,KAAK,EACL,SAAS,CACV,CAAA;QACD,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;YAC7C,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;YACzC,SAAS,CAAC,oBAAoB,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAA;YAC/D,SAAS,CAAC,yBAAyB,GAAG,KAAK,CAAA;YAE3C,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IAEO,uBAAuB;;QAC7B,OAAO,CAAC,MAAA,IAAI,CAAC,KAAK,CAAC,QAAQ,mCAAI,EAAE,CAAC,CAAC,GAAG;QACpC,qFAAqF;QACrF,CAAC,KAA0C,EAAE,EAAE;YAC7C,MAAM,SAAS,GAAG,KAAK,YAAY,OAAO,CAAA;YAC1C,wDAAwD;YACxD,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,KAAyB,CAAA;YAClE,MAAM,WAAW,GAAG,SAAS;gBAC3B,CAAC,CAAC,KAAK,CAAC,eAAe;gBACvB,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAA;YAC5B,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,EAAyB,CAAA;QACjE,CAAC,CACF,CAAA;IACH,CAAC;CACF"}

package/src/lib/runners/specialist-runner.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedPlugins, UserExtraData } from '@botonic/core';
+import { BaseRunner } from './base-runner';
+export declare class SpecialistRunner<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData extends UserExtraData = UserExtraData> extends BaseRunner<TPlugins, TExtraData> {
+}

package/src/lib/runners/specialist-runner.js

@@ -0,0 +1,4 @@
+import { BaseRunner } from './base-runner';
+export class SpecialistRunner extends BaseRunner {
+}
+//# sourceMappingURL=specialist-runner.js.map

package/src/lib/runners/specialist-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialist-runner.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/plugin-ai-agents/src/lib/runners/specialist-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE1C,MAAM,OAAO,gBAGX,SAAQ,UAAgC;CAAG"}

package/src/lib/services/hubtype-api-client.d.ts

@@ -0,0 +1,13 @@
+import type { BotonicContext } from '@botonic/core';
+import { HubtypeAssistantMessage } from '@botonic/shared';
+import type { Chunk, MemoryOptions } from '../types';
+import type { GetMessagesV2Result, TrackLlmRunsData } from './types';
+export declare class HubtypeApiClient {
+    private readonly botonicContext;
+    constructor(botonicContext: BotonicContext);
+    retrieveSimilarChunks(query: string, sourceIds: string[]): Promise<Chunk[]>;
+    getMessagesV2(botonicContext: BotonicContext, options: MemoryOptions, previousHubtypeMessages: HubtypeAssistantMessage[]): Promise<GetMessagesV2Result>;
+    private formatMessageV2;
+    private formatMessage;
+    trackLlmRuns(botId: string, data: TrackLlmRunsData): Promise<void>;
+}

package/src/lib/{hubtype-api-client.js → services/hubtype-api-client.js}

@@ -32,67 +32,25 @@ export class HubtypeApiClient {
             return chunks;
         });
     }
-    getMessages(botonicContext, maxMemoryLength) {
+    getMessagesV2(botonicContext, options, previousHubtypeMessages) {
         return __awaiter(this, void 0, void 0, function* () {
-            const url = `${this.botonicContext.settings.hubtypeApiUrl}/external/v1/ai/agent/message_history/`;
-            const headers = {
-                'Content-Type': 'application/json',
-                Authorization: `Bearer ${this.botonicContext.secrets.hubtypeAccessToken}`,
-            };
-            const params = new URLSearchParams({
-                last_message_id: botonicContext.input.messageId || '',
-                num_messages: maxMemoryLength.toString(),
-            });
-            const urlWithParams = `${url}?${params.toString()}`;
-            try {
-                const response = yield fetch(urlWithParams, {
-                    method: 'GET',
-                    headers,
-                });
-                if (!response.ok) {
-                    throw new Error(`Failed to get messages: ${response.statusText}`);
-                }
-                const data = yield response.json();
-                const messages = data.messages;
-                return messages.map(message => this.formatMessage(message));
-            }
-            catch (error) {
-                console.error(error);
-                throw new Error('Failed to get messages from Hubtype');
-            }
-        });
-    }
-    getMessagesV2(botonicContext_1) {
-        return __awaiter(this, arguments, void 0, function* (botonicContext, options = {}) {
+            var _a;
             const url = `${this.botonicContext.settings.hubtypeApiUrl}/external/v2/ai/agent/message_history/`;
             const headers = {
                 'Content-Type': 'application/json',
                 Authorization: `Bearer ${this.botonicContext.secrets.hubtypeAccessToken}`,
             };
-            const params = Object.assign(Object.assign(Object.assign(Object.assign({ last_message_id: botonicContext.input.messageId || '' }, (options.maxMessages !== undefined && {
+            const params = {
+                last_message_id: (_a = botonicContext.input.messageId) !== null && _a !== void 0 ? _a : 'NO_MESSAGE_ID',
                 max_messages: options.maxMessages,
-            })), (options.includeToolCalls !== undefined && {
                 include_tool_calls: options.includeToolCalls,
-            })), (options.maxFullToolResults !== undefined && {
                 max_full_tool_results: options.maxFullToolResults,
-            })), (options.debugMode !== undefined && {
                 debug_mode: options.debugMode,
-            }));
+            };
             try {
-                const searchParams = new URLSearchParams();
-                searchParams.set('last_message_id', params.last_message_id);
-                if (params.max_messages !== undefined) {
-                    searchParams.set('max_messages', params.max_messages.toString());
-                }
-                if (params.include_tool_calls !== undefined) {
-                    searchParams.set('include_tool_calls', params.include_tool_calls.toString());
-                }
-                if (params.max_full_tool_results !== undefined) {
-                    searchParams.set('max_full_tool_results', params.max_full_tool_results.toString());
-                }
-                if (params.debug_mode !== undefined) {
-                    searchParams.set('debug_mode', params.debug_mode.toString());
-                }
+                const searchParams = new URLSearchParams(Object.entries(params)
+                    .filter(([, value]) => value !== undefined)
+                    .map(([key, value]) => [key, String(value)]));
                 const urlWithParams = `${url}?${searchParams.toString()}`;
                 const response = yield fetch(urlWithParams, {
                     method: 'GET',
@@ -103,7 +61,7 @@ export class HubtypeApiClient {
                 }
                 const data = yield response.json();
                 const { messages, conversation_id, truncated } = data;
-                const formattedMessages = messages
+                const formattedMessages = [...messages, ...previousHubtypeMessages]
                     .map((message) => this.formatMessageV2(message))
                     .filter((message) => message !== null);
                 return {
@@ -201,5 +159,28 @@ export class HubtypeApiClient {
             throw new Error('Invalid message role');
         }
     }
+    trackLlmRuns(botId, data) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Not stop the bot execution if the tracking fails, just log the error
+            try {
+                const url = `${this.botonicContext.settings.hubtypeApiUrl}/external/v2/conversational_apps/${botId}/track_llm_runs/`;
+                const headers = {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.botonicContext.secrets.hubtypeAccessToken}`,
+                };
+                const response = yield fetch(url, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(data),
+                });
+                if (!response.ok) {
+                    throw new Error(`Failed to track LLM runs to Hubtype: ${response.status} ${response.statusText}`);
+                }
+            }
+            catch (error) {
+                console.error(error);
+            }
+        });
+    }
 }
 //# sourceMappingURL=hubtype-api-client.js.map

package/src/lib/services/hubtype-api-client.js.map

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

package/src/lib/services/types.d.ts

@@ -0,0 +1,71 @@
+import { HubtypeAssistantMessage, HubtypeUserMessage } from '@botonic/shared';
+import { AgenticInputMessage } from '../types';
+export declare enum TrackProductName {
+    AI_AGENT = "ai_agent"
+}
+export declare enum TrackFeature {
+    AI_AGENT_RUN = "ai_agent_run",
+    AI_AGENT_GUARDRAIL = "ai_agent_guardrail"
+}
+export interface LlmRunData {
+    inference_id: string;
+    is_test: boolean;
+    product_name: string;
+    deployment_name: string;
+    model_name: string;
+    feature: string;
+    api_version: string;
+    num_prompt_tokens: number;
+    num_completion_tokens: number;
+    duration_in_milliseconds: number;
+    temperature: number;
+    error: string | null;
+}
+export interface TrackLlmRunsData {
+    llm_runs: LlmRunData[];
+}
+export type HubtypeMessage = HubtypeAssistantMessage | HubtypeUserMessage;
+export interface HubtypeToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface HubtypeUserMessageV2 {
+    role: 'user';
+    content: string | null;
+}
+export interface HubtypeAssistantMessageV2 {
+    role: 'assistant';
+    content: string | null;
+    tool_calls?: HubtypeToolCall[] | null;
+}
+export interface HubtypeToolMessageV2 {
+    role: 'tool';
+    content: string | null;
+    tool_call_id: string;
+}
+export interface HubtypeSystemMessageV2 {
+    role: 'system';
+    content: string | null;
+}
+export type HubtypeMessageV2 = HubtypeUserMessageV2 | HubtypeAssistantMessageV2 | HubtypeToolMessageV2 | HubtypeSystemMessageV2;
+export interface MessageHistoryResponseV2 {
+    messages: HubtypeMessageV2[];
+    conversation_id: string | null;
+    truncated: boolean;
+}
+export interface GetMessagesV2Result {
+    messages: AgenticInputMessage[];
+    conversationId: string | null;
+    truncated: boolean;
+}
+export interface MessageHistoryV2Params {
+    last_message_id: string;
+    max_messages?: number;
+    include_tool_calls?: boolean;
+    max_full_tool_results?: number;
+    debug_mode?: boolean;
+}

package/src/lib/services/types.js

@@ -0,0 +1,10 @@
+export var TrackProductName;
+(function (TrackProductName) {
+    TrackProductName["AI_AGENT"] = "ai_agent";
+})(TrackProductName || (TrackProductName = {}));
+export var TrackFeature;
+(function (TrackFeature) {
+    TrackFeature["AI_AGENT_RUN"] = "ai_agent_run";
+    TrackFeature["AI_AGENT_GUARDRAIL"] = "ai_agent_guardrail";
+})(TrackFeature || (TrackFeature = {}));
+//# sourceMappingURL=types.js.map

package/src/lib/services/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/plugin-ai-agents/src/lib/services/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,gBAEX;AAFD,WAAY,gBAAgB;IAC1B,yCAAqB,CAAA;AACvB,CAAC,EAFW,gBAAgB,KAAhB,gBAAgB,QAE3B;AAED,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,6CAA6B,CAAA;IAC7B,yDAAyC,CAAA;AAC3C,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB"}

package/src/lib/structured-output/bot-executor.d.ts

@@ -0,0 +1,15 @@
+import { BotExecutorMessage, OutputAiAgentMessageType } from '@botonic/shared';
+import z from 'zod';
+export type { BotExecutorMessage };
+export declare const BotExecutorSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        botExecutor: OutputAiAgentMessageType.BotExecutor;
+    }>;
+    content: z.ZodObject<{
+        text: z.ZodString;
+        buttons: z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            payload: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;

package/src/lib/structured-output/bot-executor.js

@@ -0,0 +1,15 @@
+import { OutputAiAgentMessageType } from '@botonic/shared';
+import z from 'zod';
+export const BotExecutorSchema = z
+    .object({
+    type: z.enum([OutputAiAgentMessageType.BotExecutor]),
+    content: z.object({
+        text: z.string(),
+        buttons: z.array(z.object({
+            text: z.string(),
+            payload: z.string(),
+        })),
+    }),
+})
+    .describe('A text message with buttons to allow the bot to execute a specific action. Use it only when asked explicitly in the prompt');
+//# sourceMappingURL=bot-executor.js.map

package/src/lib/structured-output/bot-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-executor.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/plugin-ai-agents/src/lib/structured-output/bot-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAC9E,OAAO,CAAC,MAAM,KAAK,CAAA;AAInB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC;IACpD,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,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;SACpB,CAAC,CACH;KACF,CAAC;CACH,CAAC;KACD,QAAQ,CACP,4HAA4H,CAC7H,CAAA"}

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

@@ -1,8 +1,10 @@
-import { CarouselMessage } from '@botonic/shared';
+import { CarouselMessage, OutputAiAgentMessageType } from '@botonic/shared';
 import { z } from 'zod';
 export type { CarouselMessage };
 export declare const CarouselSchema: z.ZodObject<{
-    type: z.ZodEnum<["carousel"]>;
+    type: z.ZodEnum<{
+        carousel: OutputAiAgentMessageType.Carousel;
+    }>;
     content: z.ZodObject<{
         text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         elements: z.ZodArray<z.ZodObject<{
@@ -12,79 +14,7 @@ export declare const CarouselSchema: z.ZodObject<{
             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.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;

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

@@ -1,7 +1,8 @@
+import { OutputAiAgentMessageType } from '@botonic/shared';
 import { z } from 'zod';
 export const CarouselSchema = z
     .object({
-    type: z.enum(['carousel']),
+    type: z.enum([OutputAiAgentMessageType.Carousel]),
     content: z.object({
         text: z.string().nullable().optional(),
         elements: z.array(z.object({