@botonic/plugin-ai-agents 0.56.0-alpha.0 → 0.57.0-rslib-esm.1

package/lib/llm-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-config.js","sources":["../src/llm-config.ts"],"sourcesContent":["import {\n  type BotContext,\n  type ReasoningEffort,\n  VerbosityLevel,\n} from '@botonic/core'\nimport {\n  type Model,\n  type ModelProvider,\n  type ModelSettings,\n  OpenAIProvider,\n} from '@openai/agents'\nimport OpenAI, { AzureOpenAI } from 'openai'\nimport {\n  isProd,\n  LITELLM_TAG_KEYS,\n  LLM_API_KEY,\n  LLM_API_URL,\n  LLM_AZURE_API_VERSION,\n  LLM_OPENAI_MODEL,\n  LLM_PROVIDER,\n  LLM_PROVIDERS,\n  type LLMProviderType,\n} from './constants'\n\nexport interface LLMConfigParams {\n  maxRetries: number\n  timeout: number\n  modelName: string\n  verbosity: VerbosityLevel\n  botContext: BotContext\n  reasoningEffort?: ReasoningEffort\n}\n\nexport class LLMConfig {\n  private readonly maxRetries: number\n  private readonly timeout: number\n  private readonly botContext: BotContext\n  public readonly modelName: string\n  public readonly modelSettings: ModelSettings\n  public readonly modelProvider: ModelProvider\n\n  constructor({\n    maxRetries,\n    timeout,\n    modelName,\n    verbosity,\n    botContext,\n    reasoningEffort,\n  }: LLMConfigParams) {\n    this.maxRetries = maxRetries\n    this.timeout = timeout\n    this.botContext = botContext\n    this.modelName =\n      LLM_PROVIDER === LLM_PROVIDERS.OPENAI ? LLM_OPENAI_MODEL : modelName\n    this.modelProvider = this.getModelProvider()\n    this.modelSettings = this.getModelSettings(\n      modelName,\n      verbosity,\n      reasoningEffort\n    )\n  }\n\n  async getModel(): Promise<Model> {\n    return await this.modelProvider.getModel(this.modelName)\n  }\n\n  private getModelProvider(): ModelProvider {\n    const client = this.getClient()\n    return new OpenAIProvider({\n      openAIClient: client,\n      useResponses: false,\n    })\n  }\n\n  getProviderName(): LLMProviderType {\n    if (\n      this.botContext.settings.LITELLM_API_URL ||\n      LLM_PROVIDER === LLM_PROVIDERS.LITELLM\n    ) {\n      return LLM_PROVIDERS.LITELLM\n    }\n    return LLM_PROVIDER\n  }\n\n  private getClient(): OpenAI | AzureOpenAI {\n    if (this.getProviderName() === LLM_PROVIDERS.LITELLM) {\n      const litellmUrl =\n        this.botContext.settings.LITELLM_API_URL || LLM_API_URL || ''\n      return this.getLiteLLMClient(litellmUrl)\n    }\n    if (LLM_PROVIDER === LLM_PROVIDERS.OPENAI) {\n      return this.getOpenAIClient()\n    }\n    return this.getAzureOpenAiClient()\n  }\n\n  private buildLiteLLMTags(): { 'x-litellm-tags': string } | undefined {\n    const botId = this.botContext.session.bot.id\n    const orgId = this.botContext.session.organization_id\n    const parts: string[] = []\n    if (botId) {\n      parts.push(`${LITELLM_TAG_KEYS.BOT_ID}:${botId}`)\n    }\n    if (orgId) {\n      parts.push(`${LITELLM_TAG_KEYS.ORG_ID}:${orgId}`)\n    }\n    return parts.length > 0\n      ? { 'x-litellm-tags': parts.join(LITELLM_TAG_KEYS.SEPARATOR) }\n      : undefined\n  }\n\n  private getLiteLLMClient(litellmUrl: string): OpenAI {\n    return new OpenAI({\n      apiKey: this.botContext.secrets.LITELLM_API_KEY || LLM_API_KEY,\n      baseURL: litellmUrl,\n      timeout: this.timeout,\n      maxRetries: this.maxRetries,\n      dangerouslyAllowBrowser: !isProd,\n      defaultHeaders: this.buildLiteLLMTags(),\n    })\n  }\n\n  private getOpenAIClient(): OpenAI {\n    return new OpenAI({\n      apiKey: this.botContext.secrets.AZURE_OPENAI_API_KEY || LLM_API_KEY,\n      timeout: this.timeout,\n      maxRetries: this.maxRetries,\n      dangerouslyAllowBrowser: !isProd,\n    })\n  }\n\n  private getAzureOpenAiClient(): AzureOpenAI {\n    const baseURL = `${this.botContext.settings.AZURE_OPENAI_API_BASE || LLM_API_URL}openai/`\n\n    return new AzureOpenAI({\n      apiKey: this.botContext.secrets.AZURE_OPENAI_API_KEY || LLM_API_KEY,\n      apiVersion:\n        this.botContext.settings.AZURE_OPENAI_API_VERSION ||\n        LLM_AZURE_API_VERSION,\n      deployment: this.modelName,\n      baseURL,\n      timeout: this.timeout,\n      maxRetries: this.maxRetries,\n      dangerouslyAllowBrowser: !isProd,\n    })\n  }\n\n  private getModelSettings(\n    model: string,\n    verbosity: VerbosityLevel,\n    reasoningEffort?: ReasoningEffort\n  ): ModelSettings {\n    if (model.includes('gpt-4')) {\n      return {\n        temperature: 0,\n        text: { verbosity: VerbosityLevel.Medium },\n      }\n    }\n\n    if (reasoningEffort) {\n      return {\n        reasoning: { effort: reasoningEffort },\n        temperature: 1,\n        text: { verbosity },\n      }\n    }\n\n    return {\n      temperature: 1,\n      text: { verbosity },\n    }\n  }\n\n  getApiVersion(): string | undefined {\n    if (this.getProviderName() === LLM_PROVIDERS.LITELLM) {\n      return undefined\n    }\n    if (LLM_PROVIDER !== LLM_PROVIDERS.AZURE) {\n      return 'NOT_API_VERSION_FOR_OPENAI_PROVIDER'\n    }\n    return (\n      this.botContext.settings.AZURE_OPENAI_API_VERSION || LLM_AZURE_API_VERSION\n    )\n  }\n}\n"],"names":["VerbosityLevel","OpenAIProvider","OpenAI","AzureOpenAI","isProd","LITELLM_TAG_KEYS","LLM_API_KEY","LLM_API_URL","LLM_AZURE_API_VERSION","LLM_OPENAI_MODEL","LLM_PROVIDER","LLM_PROVIDERS","LLMConfig","client","litellmUrl","botId","orgId","parts","undefined","baseURL","model","verbosity","reasoningEffort","maxRetries","timeout","modelName","botContext"],"mappings":"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"}

package/lib/{esm/runners → runners}/base-runner.d.ts

@@ -1,7 +1,7 @@
 import type { OutputMessage, ResolvedPlugins, ToolExecution } from '@botonic/core';
-import type { DebugLogger } from '../debug-logger';
-import type { LLMConfig } from '../llm-config';
-import type { AgenticInputMessage, AIAgent, Context, ResultRawResponse, RunResult } from '../types';
+import type { DebugLogger } from '../debug-logger.js';
+import type { LLMConfig } from '../llm-config.js';
+import type { AgenticInputMessage, AIAgent, Context, ResultRawResponse, RunResult } from '../types.js';
 export interface RunnerResult {
     finalOutput?: {
         messages?: OutputMessage[];

package/lib/{cjs/runners → runners}/base-runner.js

@@ -1,37 +1,49 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseRunner = void 0;
-const agents_1 = require("@openai/agents");
-const constants_1 = require("../constants");
-const hubtype_api_client_1 = require("../services/hubtype-api-client");
-const types_1 = require("../services/types");
-const tools_1 = require("../tools");
+import { InputGuardrailTripwireTriggered, RunContext, RunToolCallItem, RunToolCallOutputItem, Runner } from "@openai/agents";
+import { LLM_PROVIDERS, isProd } from "../constants.js";
+import { HubtypeApiClient } from "../services/hubtype-api-client.js";
+import { TrackFeature, TrackProductName } from "../services/types.js";
+import { RETRIEVE_KNOWLEDGE_TOOL_NAME } from "../tools/index.js";
+
+
+
+
+
+
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else obj[key] = value;
+    return obj;
+}
+
+
+
+
+
 class BaseRunner {
-    constructor(agent, llmConfig, inferenceId, logger) {
-        this.agent = agent;
-        this.llmConfig = llmConfig;
-        this.inferenceId = inferenceId;
-        this.logger = logger;
-    }
     async run(messages, context) {
         const startTime = Date.now();
-        const runContext = new agents_1.RunContext(context);
-        const prompt = (await this.agent.getSystemPrompt(runContext)) ?? '';
+        const runContext = new RunContext(context);
+        const prompt = await this.agent.getSystemPrompt(runContext) ?? '';
         this.logger.logRunnerStart(this.llmConfig.modelName, this.llmConfig.modelSettings, prompt);
         try {
-            const runner = new agents_1.Runner({
-                tracingDisabled: true,
+            const runner = new Runner({
+                tracingDisabled: true
+            });
+            const result = await runner.run(this.agent, messages, {
+                context
             });
-            const result = (await runner.run(this.agent, messages, {
-                context,
-            }));
             const endTime = Date.now();
             await this.sendLlmRunTracking(result, context, startTime, endTime);
             const runResult = this.buildRunResult(result, context, messages.length);
             this.logger.logRunResult(runResult, startTime);
             return runResult;
-        }
-        catch (error) {
+        } catch (error) {
             const runResult = this.handleInputGuardrailTripwireTriggered(error, startTime);
             if (runResult) {
                 return runResult;
@@ -42,15 +54,12 @@ class BaseRunner {
     }
     getToolsExecuted(result, context) {
         const toolResultsByCallId = this.getToolResultsByCallId(result.newItems);
-        return (result.newItems
-            ?.filter(item => item instanceof agents_1.RunToolCallItem)
-            .map((item) => this.getToolExecutionInfo(item, context, toolResultsByCallId))
-            .filter((toolExecution) => toolExecution.toolName !== '') || []);
+        return result.newItems?.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 agents_1.RunToolCallOutputItem)) {
+        for (const item of newItems){
+            if (!(item instanceof RunToolCallOutputItem)) {
                 continue;
             }
             const rawItem = item.rawItem;
@@ -70,32 +79,28 @@ class BaseRunner {
         if (typeof output === 'string') {
             return output;
         }
-        return output?.type === 'text' && typeof output?.text === 'string'
-            ? output.text
-            : undefined;
+        return output?.type === 'text' && typeof output?.text === 'string' ? output.text : undefined;
     }
     getToolExecutionInfo(item, context, toolResultsByCallId) {
         if (item.rawItem.type !== 'function_call') {
             return {
                 toolName: '',
-                toolArguments: {},
+                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 toolResults = item.rawItem.callId ? toolResultsByCallId.get(item.rawItem.callId) : undefined;
         const toolExecution = {
             toolName,
             toolArguments,
-            toolResults,
+            toolResults
         };
-        if (toolName === tools_1.RETRIEVE_KNOWLEDGE_TOOL_NAME) {
+        if (toolName === RETRIEVE_KNOWLEDGE_TOOL_NAME) {
             return {
                 ...toolExecution,
                 knowledgebaseSourcesIds: context.knowledgeUsed.sourceIds,
-                knowledgebaseChunksIds: context.knowledgeUsed.chunksIds,
+                knowledgebaseChunksIds: context.knowledgeUsed.chunksIds
             };
         }
         return toolExecution;
@@ -103,36 +108,32 @@ class BaseRunner {
     getSafeToolArguments(rawToolArguments) {
         try {
             return JSON.parse(rawToolArguments);
-        }
-        catch (_error) {
+        } catch (_error) {
             return {};
         }
     }
     buildRunResult(result, context, memoryLength) {
         const outputMessages = result.finalOutput?.messages || [];
-        const hasExit = outputMessages.length === 0 ||
-            outputMessages.some(message => message.type === 'exit');
+        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'),
+            messages: hasExit ? [] : outputMessages.filter((message)=>message.type !== 'exit'),
             toolsExecuted: this.getToolsExecuted(result, context),
             exit: hasExit,
             memoryLength,
             error: false,
             inputGuardrailsTriggered: [],
-            outputGuardrailsTriggered: [],
+            outputGuardrailsTriggered: []
         };
     }
     async sendLlmRunTracking(result, context, startTime, endTime) {
-        if (!constants_1.isProd) {
+        if (!isProd) {
             return;
         }
-        if (this.llmConfig.getProviderName() === constants_1.LLM_PROVIDERS.LITELLM) {
+        if (this.llmConfig.getProviderName() === LLM_PROVIDERS.LITELLM) {
             return;
         }
         const rawResponses = result.rawResponses ?? [];
@@ -144,28 +145,27 @@ class BaseRunner {
         const totalDuration = endTime - startTime;
         const durationPerCall = Math.round(totalDuration / rawResponses.length);
         const temperature = this.llmConfig.modelSettings.temperature ?? 0;
-        const llmRuns = rawResponses.map(response => ({
-            inference_id: this.inferenceId,
-            is_test: isTest,
-            product_name: types_1.TrackProductName.AI_AGENT,
-            deployment_name: this.llmConfig.modelName,
-            model_name: response.providerData?.model ??
-                this.llmConfig.modelName,
-            feature: types_1.TrackFeature.AI_AGENT_RUN,
-            api_version: this.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(context.authToken);
+        const llmRuns = rawResponses.map((response)=>({
+                inference_id: this.inferenceId,
+                is_test: isTest,
+                product_name: TrackProductName.AI_AGENT,
+                deployment_name: this.llmConfig.modelName,
+                model_name: response.providerData?.model ?? this.llmConfig.modelName,
+                feature: TrackFeature.AI_AGENT_RUN,
+                api_version: this.llmConfig.getApiVersion(),
+                num_prompt_tokens: response.usage.inputTokens,
+                num_completion_tokens: response.usage.outputTokens,
+                duration_in_milliseconds: durationPerCall,
+                temperature,
+                error: null
+            }));
+        const client = new HubtypeApiClient(context.authToken);
         await client.trackLlmRuns(botId, {
-            llm_runs: llmRuns,
+            llm_runs: llmRuns
         });
     }
     handleInputGuardrailTripwireTriggered(error, startTime) {
-        if (error instanceof agents_1.InputGuardrailTripwireTriggered) {
+        if (error instanceof InputGuardrailTripwireTriggered) {
             const runResult = {
                 startingAgentName: '',
                 lastAgentName: '',
@@ -177,13 +177,25 @@ class BaseRunner {
                 exit: true,
                 error: false,
                 inputGuardrailsTriggered: error.result.output.outputInfo,
-                outputGuardrailsTriggered: [],
+                outputGuardrailsTriggered: []
             };
             this.logger.logGuardrailTriggered();
             this.logger.logRunResult(runResult, startTime);
             return runResult;
         }
     }
+    constructor(agent, llmConfig, inferenceId, logger){
+        _define_property(this, "agent", void 0);
+        _define_property(this, "llmConfig", void 0);
+        _define_property(this, "inferenceId", void 0);
+        _define_property(this, "logger", void 0);
+        this.agent = agent;
+        this.llmConfig = llmConfig;
+        this.inferenceId = inferenceId;
+        this.logger = logger;
+    }
 }
-exports.BaseRunner = BaseRunner;
+
+export { BaseRunner };
+
 //# sourceMappingURL=base-runner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runners/base-runner.js","sources":["../../src/runners/base-runner.ts"],"sourcesContent":["import type {\n  OutputMessage,\n  ResolvedPlugins,\n  ToolExecution,\n} from '@botonic/core'\nimport {\n  InputGuardrailTripwireTriggered,\n  RunContext,\n  Runner,\n  RunToolCallItem,\n  RunToolCallOutputItem,\n} from '@openai/agents'\nimport { isProd, LLM_PROVIDERS } from '../constants'\nimport type { DebugLogger } from '../debug-logger'\nimport type { LLMConfig } from '../llm-config'\nimport { HubtypeApiClient } from '../services/hubtype-api-client'\nimport { TrackFeature, TrackProductName } from '../services/types'\nimport { RETRIEVE_KNOWLEDGE_TOOL_NAME } from '../tools'\nimport type {\n  AgenticInputMessage,\n  AgenticOutputMessage,\n  AIAgent,\n  Context,\n  ResultRawResponse,\n  RunResult,\n} from '../types'\n\n// Minimal interface matching the properties we actually use from Runner.run() result.\n// This bypasses strict type checking while maintaining type safety for accessed properties.\nexport interface RunnerResult {\n  finalOutput?: {\n    messages?: OutputMessage[]\n  }\n  rawResponses?: ResultRawResponse[]\n  newItems?: unknown[]\n  lastAgent?: { name?: string }\n  // biome-ignore lint/suspicious/noExplicitAny: state is a complex internal type\n  state?: any\n}\n\nexport abstract class BaseRunner<\n  TPlugins extends ResolvedPlugins = ResolvedPlugins,\n  TExtraData = unknown,\n> {\n  protected agent: AIAgent<TPlugins, TExtraData>\n  protected llmConfig: LLMConfig\n  protected inferenceId: string\n  protected logger: DebugLogger\n\n  constructor(\n    agent: AIAgent<TPlugins, TExtraData>,\n    llmConfig: LLMConfig,\n    inferenceId: string,\n    logger: DebugLogger\n  ) {\n    this.agent = agent\n    this.llmConfig = llmConfig\n    this.inferenceId = inferenceId\n    this.logger = logger\n  }\n\n  async run(\n    messages: AgenticInputMessage[],\n    context: Context<TPlugins, TExtraData>\n  ): Promise<RunResult> {\n    const startTime = Date.now()\n\n    const runContext = new RunContext(context)\n    const prompt = (await this.agent.getSystemPrompt(runContext)) ?? ''\n    this.logger.logRunnerStart(\n      this.llmConfig.modelName,\n      this.llmConfig.modelSettings,\n      prompt\n    )\n\n    try {\n      const runner = new Runner({\n        tracingDisabled: true,\n      })\n      const result = (await runner.run(this.agent, messages, {\n        context,\n      })) as RunnerResult\n      const endTime = Date.now()\n\n      await this.sendLlmRunTracking(result, context, startTime, endTime)\n\n      const runResult = this.buildRunResult(result, context, messages.length)\n\n      this.logger.logRunResult(runResult, startTime)\n\n      return runResult\n    } catch (error) {\n      const runResult = this.handleInputGuardrailTripwireTriggered(\n        error,\n        startTime\n      )\n      if (runResult) {\n        return runResult\n      }\n\n      this.logger.logRunnerError(startTime, error)\n\n      throw error\n    }\n  }\n\n  protected getToolsExecuted(\n    result: RunnerResult,\n    context: Context<TPlugins, TExtraData>\n  ): ToolExecution[] {\n    const toolResultsByCallId = this.getToolResultsByCallId(result.newItems)\n\n    return (\n      result.newItems\n        ?.filter(item => item instanceof RunToolCallItem)\n        .map((item: RunToolCallItem) =>\n          this.getToolExecutionInfo(\n            item as RunToolCallItem,\n            context,\n            toolResultsByCallId\n          )\n        )\n        .filter(\n          (toolExecution: ToolExecution) => toolExecution.toolName !== ''\n        ) || []\n    )\n  }\n\n  private getToolResultsByCallId(\n    newItems: unknown[] = []\n  ): Map<string, string> {\n    const map = new Map<string, string>()\n    for (const item of newItems) {\n      if (!(item instanceof RunToolCallOutputItem)) {\n        continue\n      }\n      const rawItem = item.rawItem as {\n        callId?: string\n        output?: string | { type?: string; text?: string }\n      }\n      const callId = rawItem?.callId\n      const output = rawItem?.output\n      if (callId == null || output == null) {\n        continue\n      }\n      const text = this.extractToolResult(output)\n      if (text != null) {\n        map.set(callId, text)\n      }\n    }\n    return map\n  }\n\n  private extractToolResult(\n    output: string | { type?: string; text?: string }\n  ): string | undefined {\n    if (typeof output === 'string') {\n      return output\n    }\n    return output?.type === 'text' && typeof output?.text === 'string'\n      ? output.text\n      : undefined\n  }\n\n  private getToolExecutionInfo(\n    item: RunToolCallItem,\n    context: Context<TPlugins, TExtraData>,\n    toolResultsByCallId: Map<string, string>\n  ): ToolExecution {\n    if (item.rawItem.type !== 'function_call') {\n      return {\n        toolName: '',\n        toolArguments: {},\n      }\n    }\n    const toolName = item.rawItem.name\n    const toolArguments = this.getSafeToolArguments(item.rawItem.arguments)\n    const toolResults = item.rawItem.callId\n      ? toolResultsByCallId.get(item.rawItem.callId)\n      : undefined\n\n    const toolExecution: ToolExecution = {\n      toolName,\n      toolArguments,\n      toolResults,\n    }\n\n    if (toolName === RETRIEVE_KNOWLEDGE_TOOL_NAME) {\n      return {\n        ...toolExecution,\n        knowledgebaseSourcesIds: context.knowledgeUsed.sourceIds,\n        knowledgebaseChunksIds: context.knowledgeUsed.chunksIds,\n      }\n    }\n\n    return toolExecution\n  }\n\n  private getSafeToolArguments(\n    rawToolArguments: string\n  ): Record<string, unknown> {\n    try {\n      return JSON.parse(rawToolArguments)\n    } catch (_error) {\n      return {}\n    }\n  }\n\n  protected buildRunResult(\n    result: RunnerResult,\n    context: Context<TPlugins, TExtraData>,\n    memoryLength: number\n  ): RunResult {\n    const outputMessages = result.finalOutput?.messages || []\n    const hasExit =\n      outputMessages.length === 0 ||\n      outputMessages.some(message => message.type === 'exit')\n\n    return {\n      startingAgentName: '',\n      lastAgentName: '',\n      availableSpecialists: [],\n      isTransferredToSpecialist: false,\n      messages: hasExit\n        ? []\n        : (outputMessages.filter(\n            message => message.type !== 'exit'\n          ) as AgenticOutputMessage[]),\n      toolsExecuted: this.getToolsExecuted(result, context),\n      exit: hasExit,\n      memoryLength,\n      error: false,\n      inputGuardrailsTriggered: [],\n      outputGuardrailsTriggered: [],\n    }\n  }\n\n  private async sendLlmRunTracking(\n    result: RunnerResult,\n    context: Context<TPlugins, TExtraData>,\n    startTime: number,\n    endTime: number\n  ): Promise<void> {\n    if (!isProd) {\n      return\n    }\n    if (this.llmConfig.getProviderName() === LLM_PROVIDERS.LITELLM) {\n      return\n    }\n    const rawResponses = result.rawResponses ?? []\n    if (rawResponses.length === 0) {\n      return\n    }\n    const botId = context.request.session.bot.id\n    const isTest = context.request.session.is_test_integration\n    const totalDuration = endTime - startTime\n    const durationPerCall = Math.round(totalDuration / rawResponses.length)\n    const temperature =\n      (this.llmConfig.modelSettings.temperature as number | undefined) ?? 0\n    const llmRuns = rawResponses.map(response => ({\n      inference_id: this.inferenceId,\n      is_test: isTest,\n      product_name: TrackProductName.AI_AGENT,\n      deployment_name: this.llmConfig.modelName,\n      model_name:\n        (response.providerData?.model as string | undefined) ??\n        this.llmConfig.modelName,\n      feature: TrackFeature.AI_AGENT_RUN,\n      api_version: this.llmConfig.getApiVersion(),\n      num_prompt_tokens: response.usage.inputTokens,\n      num_completion_tokens: response.usage.outputTokens,\n      duration_in_milliseconds: durationPerCall,\n      temperature,\n      error: null,\n    }))\n\n    const client = new HubtypeApiClient(context.authToken)\n    await client.trackLlmRuns(botId, {\n      llm_runs: llmRuns,\n    })\n  }\n\n  protected handleInputGuardrailTripwireTriggered(\n    error: unknown,\n    startTime: number\n  ): RunResult | undefined {\n    if (error instanceof InputGuardrailTripwireTriggered) {\n      const runResult: RunResult = {\n        startingAgentName: '',\n        lastAgentName: '',\n        availableSpecialists: [],\n        isTransferredToSpecialist: false,\n        messages: [],\n        memoryLength: 0,\n        toolsExecuted: [],\n        exit: true,\n        error: false,\n        inputGuardrailsTriggered: error.result.output.outputInfo,\n        outputGuardrailsTriggered: [],\n      }\n\n      this.logger.logGuardrailTriggered()\n      this.logger.logRunResult(runResult, startTime)\n\n      return runResult\n    }\n  }\n}\n"],"names":["InputGuardrailTripwireTriggered","RunContext","Runner","RunToolCallItem","RunToolCallOutputItem","isProd","LLM_PROVIDERS","HubtypeApiClient","TrackFeature","TrackProductName","RETRIEVE_KNOWLEDGE_TOOL_NAME","BaseRunner","messages","context","startTime","Date","runContext","prompt","runner","result","endTime","runResult","error","toolResultsByCallId","item","toolExecution","newItems","map","Map","rawItem","callId","output","text","undefined","toolName","toolArguments","toolResults","rawToolArguments","JSON","_error","memoryLength","outputMessages","hasExit","message","rawResponses","botId","isTest","totalDuration","durationPerCall","Math","temperature","llmRuns","response","client","agent","llmConfig","inferenceId","logger"],"mappings":"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"}

package/lib/runners/index.d.ts

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

package/lib/runners/index.js

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

package/lib/runners/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runners/index.js","sources":["../../src/runners/index.ts"],"sourcesContent":["export { RouterRunner } from './router-runner'\nexport { SpecialistRunner } from './specialist-runner'\n"],"names":["RouterRunner","SpecialistRunner"],"mappings":";;AAA8C;AACQ"}

package/lib/{cjs/runners → runners}/router-runner.d.ts

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

package/lib/{cjs/runners → runners}/router-runner.js

@@ -1,9 +1,11 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RouterRunner = void 0;
-const agents_1 = require("@openai/agents");
-const base_runner_1 = require("./base-runner");
-class RouterRunner extends base_runner_1.BaseRunner {
+import { Handoff } from "@openai/agents";
+import { BaseRunner } from "./base-runner.js";
+
+
+
+
+
+class RouterRunner extends BaseRunner {
     buildRunResult(result, context, memoryLength) {
         const base = super.buildRunResult(result, context, memoryLength);
         const availableSpecialists = this.getAvailableSpecialists();
@@ -14,7 +16,7 @@ class RouterRunner extends base_runner_1.BaseRunner {
             startingAgentName,
             lastAgentName,
             availableSpecialists,
-            isTransferredToSpecialist: startingAgentName !== lastAgentName,
+            isTransferredToSpecialist: startingAgentName !== lastAgentName
         };
     }
     handleInputGuardrailTripwireTriggered(error, startTime) {
@@ -30,15 +32,18 @@ class RouterRunner extends base_runner_1.BaseRunner {
         return undefined;
     }
     getAvailableSpecialists() {
-        return (this.agent.handoffs ?? []).map((entry) => {
-            const isHandoff = entry instanceof agents_1.Handoff;
+        return (this.agent.handoffs ?? []).map((entry)=>{
+            const isHandoff = entry instanceof Handoff;
             const agent = isHandoff ? entry.agent : entry;
-            const description = isHandoff
-                ? entry.toolDescription
-                : agent.handoffDescription;
-            return { name: agent.name, description };
+            const description = isHandoff ? entry.toolDescription : agent.handoffDescription;
+            return {
+                name: agent.name,
+                description
+            };
         });
     }
 }
-exports.RouterRunner = RouterRunner;
+
+export { RouterRunner };
+
 //# sourceMappingURL=router-runner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runners/router-runner.js","sources":["../../src/runners/router-runner.ts"],"sourcesContent":["import type { AvailableSpecialist, ResolvedPlugins } from '@botonic/core'\nimport { Handoff } from '@openai/agents'\nimport type { Agent } from '@openai/agents-core'\n\nimport type { Context, RunResult } from '../types'\nimport { BaseRunner, type RunnerResult } from './base-runner'\n\nexport class RouterRunner<\n  TPlugins extends ResolvedPlugins = ResolvedPlugins,\n  TExtraData = unknown,\n> extends BaseRunner<TPlugins, TExtraData> {\n  protected override buildRunResult(\n    result: RunnerResult,\n    context: Context<TPlugins, TExtraData>,\n    memoryLength: number\n  ): RunResult {\n    const base = super.buildRunResult(result, context, memoryLength)\n\n    const availableSpecialists = this.getAvailableSpecialists()\n    const startingAgentName = this.agent.name ?? ''\n    const lastAgentName = result.lastAgent?.name ?? ''\n\n    return {\n      ...base,\n      startingAgentName,\n      lastAgentName,\n      availableSpecialists,\n      isTransferredToSpecialist: startingAgentName !== lastAgentName,\n    }\n  }\n\n  protected override handleInputGuardrailTripwireTriggered(\n    error: unknown,\n    startTime: number\n  ): RunResult | undefined {\n    const runResult = super.handleInputGuardrailTripwireTriggered(\n      error,\n      startTime\n    )\n    if (runResult) {\n      // Override attributes to match router agent\n      runResult.startingAgentName = this.agent.name\n      runResult.lastAgentName = this.agent.name\n      runResult.availableSpecialists = this.getAvailableSpecialists()\n      runResult.isTransferredToSpecialist = false\n\n      return runResult\n    }\n    return undefined\n  }\n\n  private getAvailableSpecialists(): AvailableSpecialist[] {\n    return (this.agent.handoffs ?? []).map(\n      (entry: Agent<any, any> | Handoff<any, any>) => {\n        const isHandoff = entry instanceof Handoff\n        const agent = isHandoff ? entry.agent : (entry as Agent<any, any>)\n        const description = isHandoff\n          ? entry.toolDescription\n          : agent.handoffDescription\n        return { name: agent.name, description }\n      }\n    )\n  }\n}\n"],"names":["Handoff","BaseRunner","RouterRunner","result","context","memoryLength","base","availableSpecialists","startingAgentName","lastAgentName","error","startTime","runResult","undefined","entry","isHandoff","agent","description"],"mappings":";;;;;AACwC;AAIqB;AAEtD,MAAME,YAAYA,SAGfD,UAAUA;IACC,eACjBE,MAAoB,EACpBC,OAAsC,EACtCC,YAAoB,EACT;QACX,MAAMC,OAAO,KAAK,CAAC,eAAeH,QAAQC,SAASC;QAEnD,MAAME,uBAAuB,IAAI,CAAC,uBAAuB;QACzD,MAAMC,oBAAoB,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI;QAC7C,MAAMC,gBAAgBN,OAAO,SAAS,EAAE,QAAQ;QAEhD,OAAO;YACL,GAAGG,IAAI;YACPE;YACAC;YACAF;YACA,2BAA2BC,sBAAsBC;QACnD;IACF;IAEmB,sCACjBC,KAAc,EACdC,SAAiB,EACM;QACvB,MAAMC,YAAY,KAAK,CAAC,sCACtBF,OACAC;QAEF,IAAIC,WAAW;YACb,4CAA4C;YAC5CA,UAAU,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI;YAC7CA,UAAU,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI;YACzCA,UAAU,oBAAoB,GAAG,IAAI,CAAC,uBAAuB;YAC7DA,UAAU,yBAAyB,GAAG;YAEtC,OAAOA;QACT;QACA,OAAOC;IACT;IAEQ,0BAAiD;QACvD,OAAQ,KAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAC,EAAG,GAAG,CACpC,CAACC;YACC,MAAMC,YAAYD,iBAAiBd,OAAOA;YAC1C,MAAMgB,QAAQD,YAAYD,MAAM,KAAK,GAAIA;YACzC,MAAMG,cAAcF,YAChBD,MAAM,eAAe,GACrBE,MAAM,kBAAkB;YAC5B,OAAO;gBAAE,MAAMA,MAAM,IAAI;gBAAEC;YAAY;QACzC;IAEJ;AACF"}

package/lib/{esm/runners → runners}/specialist-runner.d.ts

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

package/lib/runners/specialist-runner.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"runners/specialist-runner.js","sources":["../../src/runners/specialist-runner.ts"],"sourcesContent":["import type { ResolvedPlugins } from '@botonic/core'\nimport { BaseRunner } from './base-runner'\n\nexport class SpecialistRunner<\n  TPlugins extends ResolvedPlugins = ResolvedPlugins,\n  TExtraData = unknown,\n> extends BaseRunner<TPlugins, TExtraData> {}\n"],"names":["BaseRunner","SpecialistRunner"],"mappings":";;;AAC0C;AAEnC,MAAMC,gBAAgBA,SAGnBD,UAAUA;AAAwB"}

package/lib/{esm/services → services}/hubtype-api-client.d.ts

@@ -1,6 +1,6 @@
 import type { BotContext, HubtypeAssistantMessage } from '@botonic/core';
-import type { AgenticInputMessage, Chunk, MemoryOptions } from '../types';
-import type { GetMessagesV2Result, TrackLlmRunsData } from './types';
+import type { AgenticInputMessage, Chunk, MemoryOptions } from '../types.js';
+import type { GetMessagesV2Result, TrackLlmRunsData } from './types.js';
 export declare class HubtypeApiClient {
     private readonly authToken;
     constructor(authToken: string);

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

@@ -0,0 +1,191 @@
+import axios from "axios";
+import { HUBTYPE_API_URL } from "../constants.js";
+
+
+
+/* eslint-disable @typescript-eslint/naming-convention */ function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else obj[key] = value;
+    return obj;
+}
+
+
+class HubtypeApiClient {
+    async retrieveSimilarChunks(query, sourceIds) {
+        const url = `${HUBTYPE_API_URL}/external/v1/ai/knowledge_base/similar_chunks/`;
+        const headers = {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.authToken}`
+        };
+        const params = {
+            query,
+            source_ids: sourceIds,
+            num_chunks: 5
+        };
+        const response = await axios.post(url, params, {
+            headers
+        });
+        const chunks = response.data.chunks.map((chunk)=>({
+                id: chunk.id,
+                text: chunk.text
+            }));
+        return chunks;
+    }
+    async getLocalMessages(maxMemoryLength, previousHubtypeMessages, localStorageKey) {
+        const localBotonicState = typeof globalThis !== 'undefined' && globalThis.localStorage ? globalThis.localStorage.getItem(localStorageKey) : null;
+        const botonicState = JSON.parse(localBotonicState || '{}');
+        const messages = botonicState.messages;
+        const filteredMessages = messages.filter((message)=>message.data.text).map((message)=>({
+                role: message.sentBy === 'user' ? 'user' : 'assistant',
+                content: message.data.text
+            })).map((message)=>this.formatMessage(message));
+        const resultMessages = [
+            ...filteredMessages,
+            ...previousHubtypeMessages
+        ];
+        return resultMessages.slice(-maxMemoryLength);
+    }
+    async getMessagesV2(botContext, options, previousHubtypeMessages) {
+        const url = `${HUBTYPE_API_URL}/external/v2/ai/agent/message_history/`;
+        const headers = {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.authToken}`
+        };
+        const params = {
+            last_message_id: botContext.input.message_id,
+            max_messages: options.maxMessages,
+            include_tool_calls: options.includeToolCalls,
+            max_full_tool_results: options.maxFullToolResults,
+            debug_mode: options.debugMode
+        };
+        try {
+            const response = await axios.get(url, {
+                headers,
+                params
+            });
+            const { messages, conversation_id, truncated } = response.data;
+            const formattedMessages = [
+                ...messages,
+                ...previousHubtypeMessages
+            ].map((message)=>this.formatMessageV2(message)).filter((message)=>message !== null);
+            return {
+                messages: formattedMessages,
+                conversationId: conversation_id,
+                truncated
+            };
+        } catch (error) {
+            console.error(error);
+            throw new Error('Failed to get messages from Hubtype V2 API');
+        }
+    }
+    formatMessageV2(message) {
+        switch(message.role){
+            case 'user':
+                return {
+                    role: 'user',
+                    content: message.content ?? ''
+                };
+            case 'assistant':
+                {
+                    const assistantMessage = message;
+                    // If assistant message has tool_calls, include them for context
+                    // Using double assertion as the OpenAI API supports this format,
+                    // but the agents SDK types are more restrictive
+                    if (assistantMessage.tool_calls && assistantMessage.tool_calls.length > 0) {
+                        return {
+                            role: 'assistant',
+                            content: assistantMessage.content ?? '',
+                            tool_calls: assistantMessage.tool_calls.map((tc)=>({
+                                    id: tc.id,
+                                    type: tc.type,
+                                    function: {
+                                        name: tc.function.name,
+                                        arguments: tc.function.arguments
+                                    }
+                                }))
+                        };
+                    }
+                    // Regular assistant message without tool_calls
+                    return {
+                        role: 'assistant',
+                        content: [
+                            {
+                                type: 'output_text',
+                                text: assistantMessage.content ?? ''
+                            }
+                        ],
+                        status: 'completed'
+                    };
+                }
+            case 'tool':
+                {
+                    // Tool messages provide context about previous tool executions
+                    // Using double assertion as the OpenAI API supports this format,
+                    // but the agents SDK types are more restrictive
+                    const toolMessage = message;
+                    return {
+                        role: 'tool',
+                        tool_call_id: toolMessage.tool_call_id,
+                        content: toolMessage.content ?? ''
+                    };
+                }
+            case 'system':
+                return {
+                    role: 'system',
+                    content: message.content ?? ''
+                };
+            default:
+                throw new Error(`Invalid message role: ${message.role}`);
+        }
+    }
+    async trackLlmRuns(botId, data) {
+        // Not stop the bot execution if the tracking fails, just log the error
+        try {
+            const url = `${HUBTYPE_API_URL}/external/v2/conversational_apps/${botId}/track_llm_runs/`;
+            const headers = {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.authToken}`
+            };
+            await axios.post(url, data, {
+                headers
+            });
+        } catch (error) {
+            console.error('Failed to track LLM runs:', error);
+        }
+    }
+    formatMessage(message) {
+        if (message.role === 'user') {
+            return {
+                content: message.content,
+                role: 'user'
+            };
+        } else if (message.role === 'assistant') {
+            return {
+                role: 'assistant',
+                content: [
+                    {
+                        type: 'output_text',
+                        text: message.content
+                    }
+                ],
+                status: 'completed'
+            };
+        } else {
+            throw new Error('Invalid message role');
+        }
+    }
+    constructor(authToken){
+        _define_property(this, "authToken", void 0);
+        this.authToken = authToken;
+    }
+}
+
+export { HubtypeApiClient };
+
+//# sourceMappingURL=hubtype-api-client.js.map