@botonic/plugin-ai-agents 0.58.0-alpha-new-stack.0 → 0.58.0-alpha.0

package/lib/esm/constants.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MAX_RETRIES = exports.DEFAULT_TIMEOUT_16_SECONDS = exports.MAX_MEMORY_LENGTH = exports.isProd = exports.LLM_OPENAI_MODEL = exports.LLM_AZURE_API_VERSION = exports.LLM_API_URL = exports.LLM_API_KEY = exports.LLM_PROVIDER = exports.LITELLM_TAG_KEYS = exports.LLM_PROVIDERS = exports.HUBTYPE_API_URL = void 0;
+exports.HUBTYPE_API_URL = process.env.HUBTYPE_API_URL || 'https://api.hubtype.com';
+// LLM Configuration (provider-agnostic; set LLM_PROVIDER=azure|openai)
+exports.LLM_PROVIDERS = {
+    AZURE: 'azure',
+    OPENAI: 'openai',
+    LITELLM: 'litellm',
+};
+exports.LITELLM_TAG_KEYS = {
+    BOT_ID: 'bot_id',
+    ORG_ID: 'org_id',
+    SEPARATOR: ',',
+};
+exports.LLM_PROVIDER = process.env.LLM_PROVIDER || exports.LLM_PROVIDERS.AZURE;
+exports.LLM_API_KEY = process.env.LLM_API_KEY; // pragma: allowlist secret
+exports.LLM_API_URL = process.env.LLM_API_URL;
+exports.LLM_AZURE_API_VERSION = process.env.LLM_AZURE_API_VERSION || '2025-01-01-preview';
+exports.LLM_OPENAI_MODEL = process.env.LLM_OPENAI_MODEL || 'gpt-4.1-mini';
+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/esm/constants.js.map

@@ -0,0 +1 @@
+{"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,uEAAuE;AAC1D,QAAA,aAAa,GAAG;IAC3B,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACV,CAAA;AAIG,QAAA,gBAAgB,GAAG;IAC9B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,GAAG;CACN,CAAA;AAEG,QAAA,YAAY,GACtB,OAAO,CAAC,GAAG,CAAC,YAAgC,IAAI,qBAAa,CAAC,KAAK,CAAA;AACzD,QAAA,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA,CAAC,2BAA2B;AACjE,QAAA,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;AACrC,QAAA,qBAAqB,GAChC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,oBAAoB,CAAA;AAC9C,QAAA,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,cAAc,CAAA;AAEjE,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/esm/debug-logger.d.ts

@@ -0,0 +1,33 @@
+import { type AiAgentArgs, type 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, prompt: string): 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;

package/lib/esm/debug-logger.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDebugLogger = createDebugLogger;
+const core_1 = require("@botonic/core");
+const constants_1 = require("./constants");
+const PREFIX = '[BotonicPluginAiAgents]';
+class EnabledDebugLogger {
+    logInitialConfig(config) {
+        console.log(`${PREFIX} === Plugin Initialization ===`);
+        console.log(`${PREFIX} Provider: ${constants_1.LLM_PROVIDER}`);
+        console.log(`${PREFIX} Message History API Version: ${config.messageHistoryApiVersion}`);
+        console.log(`${PREFIX} Max Retries: ${config.maxRetries}`);
+        console.log(`${PREFIX} Timeout: ${config.timeout}ms`);
+        console.log(`${PREFIX} Custom Tools Registered: ${config.customToolNames.join(', ') || 'none'}`);
+        console.log(`${PREFIX} Memory Options:`, {
+            maxMessages: config.memory.maxMessages,
+            includeToolCalls: config.memory.includeToolCalls,
+            maxFullToolResults: config.memory.maxFullToolResults,
+            debugMode: config.memory.debugMode,
+        });
+        console.log(`${PREFIX} === End Plugin Initialization ===`);
+    }
+    logAgentDebugInfo(aiAgentArgs, toolNames, messages) {
+        console.log(`${PREFIX} === AI Agent Debug Info ===`);
+        console.log(`${PREFIX} Agent Name: ${aiAgentArgs.name}`);
+        console.log(`${PREFIX} Active Tools: ${JSON.stringify(toolNames)}`);
+        if (aiAgentArgs.type === core_1.AiAgentType.Specialist) {
+            console.log(`${PREFIX} Source IDs: ${JSON.stringify(aiAgentArgs.sourceIds || [])}`);
+        }
+        console.log(`${PREFIX} Message History Count: ${messages.length}`);
+        console.log(`${PREFIX} Messages: ${JSON.stringify(messages, null, 2)}`);
+        console.log(`${PREFIX} Input Guardrail Rules: ${aiAgentArgs.inputGuardrailRules?.length || 0}`);
+        console.log(`${PREFIX} === End Debug Info ===`);
+    }
+    logModelSettings(settings) {
+        console.log(`${PREFIX} === Agent Model Settings ===`);
+        console.log(`${PREFIX} Has Retrieve Knowledge Tool: ${settings.hasRetrieveKnowledge}`);
+        if (settings.reasoning) {
+            console.log(`${PREFIX} Reasoning Effort: ${settings.reasoning.effort}`);
+        }
+        if (settings.text) {
+            console.log(`${PREFIX} Text Verbosity: ${settings.text.verbosity}`);
+        }
+        if (settings.toolChoice) {
+            console.log(`${PREFIX} Tool Choice: ${settings.toolChoice}`);
+        }
+        console.log(`${PREFIX} === End Model Settings ===`);
+    }
+    logRunnerStart(model, modelSettings, prompt) {
+        console.log(`${PREFIX} === Runner Execution Start ===`);
+        console.log(`${PREFIX} Model: ${model}`);
+        console.log(`${PREFIX} Model Settings: ${JSON.stringify(modelSettings)}`);
+        console.log(`${PREFIX} Prompt: ${prompt}`);
+    }
+    logRunResult(runResult, startTime) {
+        const elapsedMs = Date.now() - startTime;
+        console.log(`${PREFIX} === Runner Execution Complete ===`);
+        console.log(`${PREFIX} Execution Time: ${elapsedMs}ms`);
+        console.log(`${PREFIX} Output Messages Count: ${runResult.messages.length}`);
+        console.log(`${PREFIX} Exit: ${runResult.exit}`);
+        console.log(`${PREFIX} Error: ${runResult.error}`);
+        console.log(`${PREFIX} Tools Executed: ${JSON.stringify(runResult.toolsExecuted.map(t => t.toolName))}`);
+        if (runResult.inputGuardrailsTriggered.length > 0) {
+            console.log(`${PREFIX} Input Guardrails Triggered: ${runResult.inputGuardrailsTriggered.length}`);
+        }
+        if (runResult.outputGuardrailsTriggered.length > 0) {
+            console.log(`${PREFIX} Output Guardrails Triggered: ${runResult.outputGuardrailsTriggered.length}`);
+        }
+        console.log(`${PREFIX} === End Runner Execution ===`);
+    }
+    logGuardrailTriggered() {
+        console.log(`${PREFIX} Input guardrail triggered`);
+    }
+    logRunnerError(startTime, error) {
+        const elapsedMs = Date.now() - startTime;
+        console.log(`${PREFIX} Runner execution failed after ${elapsedMs}ms`);
+        console.log(`${PREFIX} Error:`, error);
+    }
+    logToolExecution(toolExecution) {
+        console.log(`${PREFIX} Tool Execution: ${toolExecution.toolName}`);
+        console.log(`${PREFIX} Tool Arguments: ${JSON.stringify(toolExecution.toolArguments)}`);
+        console.log(`${PREFIX} Tool Results: ${toolExecution.toolResults}`);
+        console.log(`${PREFIX} Knowledgebase Sources IDs: ${JSON.stringify(toolExecution.knowledgebaseSourcesIds)}`);
+        console.log(`${PREFIX} Knowledgebase Chunks IDs: ${JSON.stringify(toolExecution.knowledgebaseChunksIds)}`);
+    }
+}
+class DisabledDebugLogger {
+    logInitialConfig() {
+        return;
+    }
+    logAgentDebugInfo() {
+        return;
+    }
+    logModelSettings() {
+        return;
+    }
+    logRunnerStart(_model, _modelSettings, _prompt) {
+        return;
+    }
+    logRunResult() {
+        return;
+    }
+    logGuardrailTriggered() {
+        return;
+    }
+    logRunnerError() {
+        return;
+    }
+    logToolExecution() {
+        return;
+    }
+}
+function createDebugLogger(enableDebug) {
+    return enableDebug ? new EnabledDebugLogger() : new DisabledDebugLogger();
+}
+//# sourceMappingURL=debug-logger.js.map

package/lib/esm/debug-logger.js.map

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

package/lib/esm/guardrails/index.d.ts

@@ -0,0 +1 @@
+export * from './input';

package/lib/esm/guardrails/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./input"), exports);
+//# sourceMappingURL=index.js.map

package/lib/esm/guardrails/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/guardrails/index.ts"],"names":[],"mappings":";;;AAAA,kDAAuB"}

package/lib/esm/guardrails/input.d.ts

@@ -0,0 +1,10 @@
+import { type InputGuardrail } from '@openai/agents';
+import type { LLMConfig } from '../llm-config';
+import type { GuardrailRule } from '../types';
+export interface GuardrailTrackingContext {
+    botId: string;
+    isTest: boolean;
+    authToken: string;
+    inferenceId: string;
+}
+export declare function createInputGuardrails(rules: GuardrailRule[], llmConfig: LLMConfig, trackingContext: GuardrailTrackingContext): Promise<InputGuardrail[]>;

package/lib/esm/guardrails/input.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInputGuardrails = createInputGuardrails;
+const agents_1 = require("@openai/agents");
+const zod_1 = require("zod");
+const constants_1 = require("../constants");
+const hubtype_api_client_1 = require("../services/hubtype-api-client");
+const types_1 = require("../services/types");
+async function createInputGuardrails(rules, llmConfig, trackingContext) {
+    if (rules.length === 0) {
+        return [];
+    }
+    return [await buildInputGuardrail(rules, llmConfig, trackingContext)];
+}
+async function buildInputGuardrail(rules, llmConfig, trackingContext) {
+    const outputType = zod_1.z.object(Object.fromEntries(rules.map(rule => [rule.name, zod_1.z.boolean().describe(rule.description)])));
+    const modelSettings = createInputGuardrailModelSettings(llmConfig);
+    const agent = new agents_1.Agent({
+        name: 'InputGuardrail',
+        model: await llmConfig.getModel(),
+        modelSettings,
+        instructions: 'Check if the user triggers some of the following guardrails.',
+        outputType,
+    });
+    return {
+        name: 'InputGuardrail',
+        execute: async ({ input, context }) => {
+            const lastMessage = input[input.length - 1];
+            const runner = new agents_1.Runner({
+                tracingDisabled: true,
+            });
+            const startTime = Date.now();
+            const result = await runner.run(agent, [lastMessage], { context });
+            const endTime = Date.now();
+            await sendGuardrailLlmRunTracking(result, trackingContext, llmConfig, startTime, endTime);
+            const finalOutput = result.finalOutput;
+            if (finalOutput === undefined) {
+                throw new Error('Guardrail agent failed to produce output');
+            }
+            const triggered = Object.values(finalOutput).some(value => value === true);
+            const triggeredGuardrails = Object.keys(finalOutput).filter(key => finalOutput[key] === true);
+            return {
+                outputInfo: triggeredGuardrails,
+                tripwireTriggered: triggered,
+            };
+        },
+    };
+}
+function createInputGuardrailModelSettings(llmConfig) {
+    const modelSettings = {
+        ...llmConfig.modelSettings,
+        toolChoice: undefined,
+    };
+    if (llmConfig.modelSettings.reasoning) {
+        modelSettings.reasoning = { ...llmConfig.modelSettings.reasoning };
+    }
+    if (llmConfig.modelSettings.text) {
+        modelSettings.text = { ...llmConfig.modelSettings.text };
+    }
+    return modelSettings;
+}
+async function sendGuardrailLlmRunTracking(result, trackingContext, llmConfig, startTime, endTime) {
+    if (!constants_1.isProd) {
+        return;
+    }
+    if (llmConfig.getProviderName() === constants_1.LLM_PROVIDERS.LITELLM) {
+        return;
+    }
+    const rawResponses = result.rawResponses ?? [];
+    if (rawResponses.length === 0) {
+        return;
+    }
+    const totalDuration = endTime - startTime;
+    const durationPerCall = Math.round(totalDuration / rawResponses.length);
+    const temperature = llmConfig.modelSettings.temperature ?? 0;
+    const llmRuns = rawResponses.map(response => ({
+        inference_id: trackingContext.inferenceId,
+        is_test: trackingContext.isTest,
+        product_name: types_1.TrackProductName.AI_AGENT,
+        deployment_name: llmConfig.modelName,
+        model_name: response.providerData?.model ??
+            llmConfig.modelName,
+        feature: types_1.TrackFeature.AI_AGENT_GUARDRAIL,
+        api_version: llmConfig.getApiVersion(),
+        num_prompt_tokens: response.usage.inputTokens,
+        num_completion_tokens: response.usage.outputTokens,
+        duration_in_milliseconds: durationPerCall,
+        temperature,
+        error: null,
+    }));
+    const client = new hubtype_api_client_1.HubtypeApiClient(trackingContext.authToken);
+    await client.trackLlmRuns(trackingContext.botId, {
+        llm_runs: llmRuns,
+    });
+}
+//# sourceMappingURL=input.js.map

package/lib/esm/guardrails/input.js.map

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

package/lib/esm/index.d.ts

@@ -0,0 +1,22 @@
+import { type AiAgentArgs, type BotContext, type Plugin, type ResolvedPlugins } from '@botonic/core';
+import type { CustomTool, InferenceResponse, PluginAiAgentOptions } from './types';
+export default class BotonicPluginAiAgents<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = any> implements Plugin {
+    private readonly authToken?;
+    private readonly memory;
+    private readonly logger;
+    private readonly timeout;
+    private readonly maxRetries;
+    toolDefinitions: CustomTool<TPlugins, TExtraData>[];
+    private readonly localStorageKey;
+    constructor(options?: PluginAiAgentOptions<TPlugins, TExtraData>);
+    private getMemoryOptions;
+    pre(): void;
+    getInference(botContext: BotContext<TPlugins, TExtraData>, aiAgentArgs: AiAgentArgs): Promise<InferenceResponse>;
+    private executeSpecialistAIAgent;
+    private executeRouterAIAgent;
+    private getSpecialistAgentAndTools;
+    private getMessages;
+    private buildTools;
+}
+export * from './bot-config-tools';
+export * from './types';

package/lib/esm/index.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const core_1 = require("@botonic/core");
+const agents_1 = require("@openai/agents");
+const uuid_1 = require("uuid");
+const agents_2 = require("./agents");
+const constants_1 = require("./constants");
+const debug_logger_1 = require("./debug-logger");
+const llm_config_1 = require("./llm-config");
+const runners_1 = require("./runners");
+const hubtype_api_client_1 = require("./services/hubtype-api-client");
+class BotonicPluginAiAgents {
+    constructor(options) {
+        this.toolDefinitions = [];
+        this.authToken = options?.authToken;
+        this.toolDefinitions = options?.customTools || [];
+        this.memory = this.getMemoryOptions(options?.memory);
+        this.timeout = options?.timeout ?? constants_1.DEFAULT_TIMEOUT_16_SECONDS;
+        this.maxRetries = options?.maxRetries ?? constants_1.DEFAULT_MAX_RETRIES;
+        this.logger = (0, debug_logger_1.createDebugLogger)(options?.enableDebug ?? false);
+        this.localStorageKey = options?.localStorageKey ?? 'botonicState';
+        (0, agents_1.setTracingDisabled)(true);
+        this.logger.logInitialConfig({
+            messageHistoryApiVersion: 'v2',
+            maxRetries: options?.maxRetries ?? constants_1.DEFAULT_MAX_RETRIES,
+            timeout: options?.timeout ?? constants_1.DEFAULT_TIMEOUT_16_SECONDS,
+            customToolNames: this.toolDefinitions.map(t => t.name),
+            memory: this.memory,
+        });
+    }
+    getMemoryOptions(memory) {
+        return {
+            maxMessages: memory?.maxMessages ?? constants_1.MAX_MEMORY_LENGTH,
+            includeToolCalls: memory?.includeToolCalls ?? true,
+            maxFullToolResults: memory?.maxFullToolResults ?? 1,
+            debugMode: memory?.debugMode ?? false,
+        };
+    }
+    pre() {
+        return;
+    }
+    async getInference(botContext, aiAgentArgs) {
+        const authToken = constants_1.isProd ? botContext.session._access_token : this.authToken;
+        if (!authToken) {
+            throw new Error('Auth token is required');
+        }
+        const inferenceId = (0, uuid_1.v7)();
+        try {
+            if (aiAgentArgs.type === core_1.AiAgentType.Specialist) {
+                return await this.executeSpecialistAIAgent(botContext, aiAgentArgs, authToken, inferenceId);
+            }
+            if (aiAgentArgs.type === core_1.AiAgentType.Router) {
+                return await this.executeRouterAIAgent(botContext, aiAgentArgs, authToken, inferenceId);
+            }
+            throw new Error('Invalid agent type');
+        }
+        catch (error) {
+            console.error('error plugin returns undefined', error);
+            return {
+                messages: [],
+                toolsExecuted: [],
+                memoryLength: 0,
+                exit: true,
+                error: true,
+                doNothing: false,
+                inputGuardrailsTriggered: [],
+                outputGuardrailsTriggered: [],
+                startingAgentName: '',
+                lastAgentName: '',
+                availableSpecialists: [],
+                isTransferredToSpecialist: false,
+            };
+        }
+    }
+    async executeSpecialistAIAgent(botContext, aiAgentArgs, authToken, inferenceId) {
+        const llmConfig = new llm_config_1.LLMConfig({
+            maxRetries: this.maxRetries,
+            timeout: this.timeout,
+            modelName: aiAgentArgs.model,
+            verbosity: aiAgentArgs.verbosity,
+            botContext,
+            reasoningEffort: aiAgentArgs.reasoningEffort,
+        });
+        // Get LLM config, tools and agent
+        const { tools, agent } = await this.getSpecialistAgentAndTools(botContext, aiAgentArgs, aiAgentArgs.outputMessagesSchemas || [], authToken, inferenceId, llmConfig);
+        // Get messages
+        const messages = await this.getMessages(botContext, authToken, aiAgentArgs.previousHubtypeMessages || []);
+        // Build context
+        const context = {
+            authToken,
+            knowledgeUsed: {
+                query: '',
+                sourceIds: [],
+                chunksIds: [],
+                chunkTexts: [],
+            },
+            request: botContext,
+        };
+        // Log agent debug info
+        this.logger.logAgentDebugInfo(aiAgentArgs, tools.map(t => t.name), messages);
+        // Run agent
+        const runner = new runners_1.SpecialistRunner(agent, llmConfig, inferenceId, this.logger);
+        return await runner.run(messages, context);
+    }
+    async executeRouterAIAgent(botContext, aiAgentArgs, authToken, inferenceId) {
+        const { specialists, name, instructions } = aiAgentArgs;
+        const llmConfig = new llm_config_1.LLMConfig({
+            maxRetries: this.maxRetries,
+            timeout: this.timeout,
+            modelName: aiAgentArgs.model,
+            verbosity: aiAgentArgs.verbosity,
+            botContext,
+            reasoningEffort: aiAgentArgs.reasoningEffort,
+        });
+        const specialistsAgents = await Promise.all(specialists.map(async (specialistData) => {
+            // If the forceToolNameOverride is set, we force this override for all specialists
+            const forceToolNameOverride = aiAgentArgs.forceToolNameOverride;
+            const reasoningEffort = aiAgentArgs.reasoningEffort;
+            const disableForceRetrieveKnowledge = aiAgentArgs.disableForceRetrieveKnowledge;
+            // Create AiAgentArgs for the specialist, with values from AIAgentRouterArgs
+            const aiAgentSpecialistArgs = {
+                ...specialistData,
+                forceToolNameOverride,
+                reasoningEffort,
+                disableForceRetrieveKnowledge,
+            };
+            const { agent } = await this.getSpecialistAgentAndTools(botContext, aiAgentSpecialistArgs, aiAgentArgs.outputMessagesSchemas || [], authToken, inferenceId, llmConfig);
+            return (0, agents_1.handoff)(agent, {
+                toolNameOverride: specialistData.name,
+                toolDescriptionOverride: specialistData.description,
+            });
+        }));
+        const router = await agents_2.RouterAgent.create({
+            name,
+            instructions,
+            llmConfig,
+            handoffs: specialistsAgents,
+            inputGuardrailRules: aiAgentArgs.inputGuardrailRules || [],
+            outputMessagesSchemas: aiAgentArgs.outputMessagesSchemas || [],
+            guardrailTrackingContext: {
+                botId: botContext.session.bot.id,
+                isTest: botContext.session.is_test_integration,
+                authToken,
+                inferenceId,
+            },
+        });
+        // Get messages
+        const messages = await this.getMessages(botContext, authToken, aiAgentArgs.previousHubtypeMessages || []);
+        // Build context
+        const context = {
+            authToken,
+            knowledgeUsed: {
+                query: '',
+                sourceIds: [],
+                chunksIds: [],
+                chunkTexts: [],
+            },
+            request: botContext,
+        };
+        // Run agent
+        const routerAgent = router.getAgent();
+        const runner = new runners_1.RouterRunner(routerAgent, llmConfig, inferenceId, this.logger);
+        return await runner.run(messages, context);
+    }
+    async getSpecialistAgentAndTools(botContext, aiAgentArgs, outputMessagesSchemas, authToken, inferenceId, llmConfig) {
+        // Build tools
+        const tools = this.buildTools(aiAgentArgs);
+        // Build agent
+        const sourceIds = aiAgentArgs.type === core_1.AiAgentType.Specialist ? aiAgentArgs.sourceIds : [];
+        const campaignsContext = botContext.input.context && 'campaigns_v2' in botContext.input.context
+            ? botContext.input.context?.campaigns_v2
+            : [];
+        const specialist = await agents_2.SpecialistAgent.create({
+            name: aiAgentArgs.name,
+            instructions: aiAgentArgs.instructions,
+            tools: tools,
+            contactInfo: botContext.session.user.contact_info || [],
+            inputGuardrailRules: aiAgentArgs.inputGuardrailRules || [],
+            sourceIds,
+            outputMessagesSchemas: outputMessagesSchemas || [],
+            campaignsContext: campaignsContext,
+            logger: this.logger,
+            llmConfig,
+            guardrailTrackingContext: {
+                botId: botContext.session.bot.id,
+                isTest: botContext.session.is_test_integration,
+                authToken,
+                inferenceId,
+            },
+            forceToolNameOverride: aiAgentArgs.forceToolNameOverride,
+            disableForceRetrieveKnowledge: aiAgentArgs.disableForceRetrieveKnowledge,
+        });
+        const specialistAgent = specialist.getAgent();
+        return { agent: specialistAgent, tools };
+    }
+    async getMessages(botContext, authToken, previousHubtypeMessages) {
+        const hubtypeClient = new hubtype_api_client_1.HubtypeApiClient(authToken);
+        if (!constants_1.isProd) {
+            return await hubtypeClient.getLocalMessages(constants_1.MAX_MEMORY_LENGTH, previousHubtypeMessages, this.localStorageKey);
+        }
+        // Default to V2
+        const result = await hubtypeClient.getMessagesV2(botContext, this.memory, previousHubtypeMessages);
+        return result.messages;
+    }
+    buildTools(aiAgentArgs) {
+        const activeTools = aiAgentArgs.type === core_1.AiAgentType.Router ? [] : aiAgentArgs.activeTools;
+        const activeToolNames = activeTools.map(tool => tool.name);
+        const availableTools = this.toolDefinitions.filter(tool => activeToolNames.includes(tool.name));
+        return availableTools.map(toolDefinition => {
+            return (0, agents_1.tool)({
+                name: toolDefinition.name,
+                description: toolDefinition.description,
+                parameters: toolDefinition.schema,
+                execute: toolDefinition.func,
+            });
+        });
+    }
+}
+exports.default = BotonicPluginAiAgents;
+tslib_1.__exportStar(require("./bot-config-tools"), exports);
+tslib_1.__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/lib/esm/index.js.map

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

package/lib/esm/llm-config.d.ts

@@ -0,0 +1,30 @@
+import { type BotContext, type ReasoningEffort, VerbosityLevel } from '@botonic/core';
+import { type Model, type ModelProvider, type ModelSettings } from '@openai/agents';
+import { type LLMProviderType } from './constants';
+export interface LLMConfigParams {
+    maxRetries: number;
+    timeout: number;
+    modelName: string;
+    verbosity: VerbosityLevel;
+    botContext: BotContext;
+    reasoningEffort?: ReasoningEffort;
+}
+export declare class LLMConfig {
+    private readonly maxRetries;
+    private readonly timeout;
+    private readonly botContext;
+    readonly modelName: string;
+    readonly modelSettings: ModelSettings;
+    readonly modelProvider: ModelProvider;
+    constructor({ maxRetries, timeout, modelName, verbosity, botContext, reasoningEffort, }: LLMConfigParams);
+    getModel(): Promise<Model>;
+    private getModelProvider;
+    getProviderName(): LLMProviderType;
+    private getClient;
+    private buildLiteLLMTags;
+    private getLiteLLMClient;
+    private getOpenAIClient;
+    private getAzureOpenAiClient;
+    private getModelSettings;
+    getApiVersion(): string | undefined;
+}