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

package/lib/{cjs/agents → agents}/base-agent.d.ts

@@ -1,9 +1,9 @@
 import type { AgentOutputType, InputGuardrail, Model, ModelSettings } from '@openai/agents';
 import type { z } from 'zod';
-import type { GuardrailTrackingContext } from '../guardrails/input';
-import type { LLMConfig } from '../llm-config';
-import { type OutputSchema } from '../structured-output';
-import type { GuardrailRule } from '../types';
+import type { GuardrailTrackingContext } from '../guardrails/input.js';
+import type { LLMConfig } from '../llm-config.js';
+import { type OutputSchema } from '../structured-output/index.js';
+import type { GuardrailRule } from '../types.js';
 export interface BaseAgentOptions {
     name: string;
     instructions: string;

package/lib/agents/base-agent.js

@@ -0,0 +1,66 @@
+import { createInputGuardrails } from "../guardrails/index.js";
+import { getOutputInstructions, getOutputSchema } from "../structured-output/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 BaseAgent {
+    getAgentModelSettings() {
+        const modelSettings = {
+            ...this.llmConfig.modelSettings
+        };
+        if (this.llmConfig.modelSettings.reasoning) {
+            modelSettings.reasoning = {
+                ...this.llmConfig.modelSettings.reasoning
+            };
+        }
+        if (this.llmConfig.modelSettings.text) {
+            modelSettings.text = {
+                ...this.llmConfig.modelSettings.text
+            };
+        }
+        return modelSettings;
+    }
+    async getInputGuardrails() {
+        return await createInputGuardrails(this.inputGuardrailRules, this.llmConfig, this.guardrailTrackingContext);
+    }
+    getOutputType() {
+        return getOutputSchema(this.outputMessagesSchemas);
+    }
+    addOutputInstructions(instructions) {
+        return `${instructions}\n\n${getOutputInstructions()}`;
+    }
+    async getModel() {
+        return await this.llmConfig.getModel();
+    }
+    constructor(options){
+        _define_property(this, "name", void 0);
+        _define_property(this, "instructions", void 0);
+        _define_property(this, "llmConfig", void 0);
+        _define_property(this, "inputGuardrailRules", void 0);
+        _define_property(this, "outputMessagesSchemas", void 0);
+        _define_property(this, "guardrailTrackingContext", void 0);
+        this.name = options.name;
+        this.instructions = options.instructions;
+        this.llmConfig = options.llmConfig;
+        this.inputGuardrailRules = options.inputGuardrailRules;
+        this.outputMessagesSchemas = options.outputMessagesSchemas || [];
+        this.guardrailTrackingContext = options.guardrailTrackingContext;
+    }
+}
+
+export { BaseAgent };
+
+//# sourceMappingURL=base-agent.js.map

package/lib/agents/base-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents/base-agent.js","sources":["../../src/agents/base-agent.ts"],"sourcesContent":["import type {\n  AgentOutputType,\n  InputGuardrail,\n  Model,\n  ModelSettings,\n} from '@openai/agents'\nimport type { z } from 'zod'\n\nimport { createInputGuardrails } from '../guardrails'\nimport type { GuardrailTrackingContext } from '../guardrails/input'\nimport type { LLMConfig } from '../llm-config'\nimport {\n  getOutputInstructions,\n  getOutputSchema,\n  type OutputSchema,\n} from '../structured-output'\nimport type { GuardrailRule } from '../types'\n\nexport interface BaseAgentOptions {\n  name: string\n  instructions: string\n  llmConfig: LLMConfig\n  inputGuardrailRules: GuardrailRule[]\n  outputMessagesSchemas?: z.ZodObject[]\n  guardrailTrackingContext: GuardrailTrackingContext\n}\n\nexport abstract class BaseAgent {\n  protected name: string\n  protected instructions: string\n  protected llmConfig: LLMConfig\n  private inputGuardrailRules: GuardrailRule[]\n  private outputMessagesSchemas: z.ZodObject[]\n  private guardrailTrackingContext: GuardrailTrackingContext\n\n  constructor(options: BaseAgentOptions) {\n    this.name = options.name\n    this.instructions = options.instructions\n    this.llmConfig = options.llmConfig\n    this.inputGuardrailRules = options.inputGuardrailRules\n    this.outputMessagesSchemas = options.outputMessagesSchemas || []\n    this.guardrailTrackingContext = options.guardrailTrackingContext\n  }\n\n  protected getAgentModelSettings(): ModelSettings {\n    const modelSettings: ModelSettings = { ...this.llmConfig.modelSettings }\n\n    if (this.llmConfig.modelSettings.reasoning) {\n      modelSettings.reasoning = { ...this.llmConfig.modelSettings.reasoning }\n    }\n\n    if (this.llmConfig.modelSettings.text) {\n      modelSettings.text = { ...this.llmConfig.modelSettings.text }\n    }\n\n    return modelSettings\n  }\n\n  protected async getInputGuardrails(): Promise<InputGuardrail[]> {\n    return await createInputGuardrails(\n      this.inputGuardrailRules,\n      this.llmConfig,\n      this.guardrailTrackingContext\n    )\n  }\n\n  protected getOutputType(): AgentOutputType<typeof OutputSchema> {\n    return getOutputSchema(this.outputMessagesSchemas)\n  }\n\n  protected addOutputInstructions(instructions: string): string {\n    return `${instructions}\\n\\n${getOutputInstructions()}`\n  }\n\n  protected async getModel(): Promise<string | Model> {\n    return await this.llmConfig.getModel()\n  }\n}\n"],"names":["createInputGuardrails","getOutputInstructions","getOutputSchema","BaseAgent","modelSettings","instructions","options"],"mappings":";;;;;;;;;;;;;;;;AAQqD;AAOxB;AAYtB,MAAeG,SAASA;IAiBnB,wBAAuC;QAC/C,MAAMC,gBAA+B;YAAE,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa;QAAC;QAEvE,IAAI,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE;YAC1CA,cAAc,SAAS,GAAG;gBAAE,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,SAAS;YAAC;QACxE;QAEA,IAAI,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE;YACrCA,cAAc,IAAI,GAAG;gBAAE,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI;YAAC;QAC9D;QAEA,OAAOA;IACT;IAEA,MAAgB,qBAAgD;QAC9D,OAAO,MAAMJ,qBAAqBA,CAChC,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,wBAAwB;IAEjC;IAEU,gBAAsD;QAC9D,OAAOE,eAAeA,CAAC,IAAI,CAAC,qBAAqB;IACnD;IAEU,sBAAsBG,YAAoB,EAAU;QAC5D,OAAO,GAAGA,aAAa,IAAI,EAAEJ,qBAAqBA,IAAI;IACxD;IAEA,MAAgB,WAAoC;QAClD,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ;IACtC;IAzCA,YAAYK,OAAyB,CAAE;QAPvC,uBAAU,QAAV;QACA,uBAAU,gBAAV;QACA,uBAAU,aAAV;QACA,uBAAQ,uBAAR;QACA,uBAAQ,yBAAR;QACA,uBAAQ,4BAAR;QAGE,IAAI,CAAC,IAAI,GAAGA,QAAQ,IAAI;QACxB,IAAI,CAAC,YAAY,GAAGA,QAAQ,YAAY;QACxC,IAAI,CAAC,SAAS,GAAGA,QAAQ,SAAS;QAClC,IAAI,CAAC,mBAAmB,GAAGA,QAAQ,mBAAmB;QACtD,IAAI,CAAC,qBAAqB,GAAGA,QAAQ,qBAAqB,IAAI,EAAE;QAChE,IAAI,CAAC,wBAAwB,GAAGA,QAAQ,wBAAwB;IAClE;AAmCF"}

package/lib/agents/index.d.ts

@@ -0,0 +1,2 @@
+export { RouterAgent } from './router-agent.js';
+export { SpecialistAgent } from './specialist-agent.js';

package/lib/agents/index.js

@@ -0,0 +1,9 @@
+
+
+
+
+
+export { RouterAgent } from "./router-agent.js";
+export { SpecialistAgent } from "./specialist-agent.js";
+
+//# sourceMappingURL=index.js.map

package/lib/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents/index.js","sources":["../../src/agents/index.ts"],"sourcesContent":["export { RouterAgent } from './router-agent'\nexport { SpecialistAgent } from './specialist-agent'\n"],"names":["RouterAgent","SpecialistAgent"],"mappings":";;AAA4C;AACQ"}

package/lib/{esm/agents → agents}/router-agent.d.ts

@@ -1,11 +1,11 @@
 import type { ResolvedPlugins } from '@botonic/core';
 import { type AgentOutputType, type Handoff } from '@openai/agents';
 import type { z } from 'zod';
-import type { GuardrailTrackingContext } from '../guardrails/input';
-import type { LLMConfig } from '../llm-config';
-import type { OutputSchema } from '../structured-output';
-import type { AIAgent, Context, GuardrailRule } from '../types';
-import { BaseAgent } from './base-agent';
+import type { GuardrailTrackingContext } from '../guardrails/input.js';
+import type { LLMConfig } from '../llm-config.js';
+import type { OutputSchema } from '../structured-output/index.js';
+import type { AIAgent, Context, GuardrailRule } from '../types.js';
+import { BaseAgent } from './base-agent.js';
 interface RouterAgentOptions<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = unknown> {
     name: string;
     instructions: string;

package/lib/agents/router-agent.js

@@ -0,0 +1,50 @@
+import { Agent } from "@openai/agents";
+import { RECOMMENDED_PROMPT_PREFIX } from "@openai/agents-core/extensions";
+import { BaseAgent } from "./base-agent.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 RouterAgent extends BaseAgent {
+    static async create(options) {
+        const routerAgent = new RouterAgent(options);
+        const inputGuardrails = await routerAgent.getInputGuardrails();
+        // Agent.create is typed as Agent<UnknownContext>; we run with Context<TPlugins, TExtraData>.
+        const agent = Agent.create({
+            name: routerAgent.name,
+            model: await routerAgent.getModel(),
+            modelSettings: routerAgent.getAgentModelSettings(),
+            instructions: routerAgent.addOutputInstructions(`${RECOMMENDED_PROMPT_PREFIX}${routerAgent.instructions}`),
+            handoffs: routerAgent.handoffs,
+            outputType: routerAgent.getOutputType(),
+            inputGuardrails
+        });
+        routerAgent.agent = agent;
+        return routerAgent;
+    }
+    getAgent() {
+        return this.agent;
+    }
+    constructor(options){
+        super(options), _define_property(this, "handoffs", void 0), _define_property(this, "agent", void 0);
+        this.handoffs = options.handoffs;
+    }
+}
+
+export { RouterAgent };
+
+//# sourceMappingURL=router-agent.js.map

package/lib/agents/router-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents/router-agent.js","sources":["../../src/agents/router-agent.ts"],"sourcesContent":["import type { ResolvedPlugins } from '@botonic/core'\nimport { Agent, type AgentOutputType, type Handoff } from '@openai/agents'\nimport { RECOMMENDED_PROMPT_PREFIX } from '@openai/agents-core/extensions'\nimport type { z } from 'zod'\nimport type { GuardrailTrackingContext } from '../guardrails/input'\nimport type { LLMConfig } from '../llm-config'\nimport type { OutputSchema } from '../structured-output'\nimport type { AIAgent, Context, GuardrailRule } from '../types'\nimport { BaseAgent } from './base-agent'\n\ninterface RouterAgentOptions<\n  TPlugins extends ResolvedPlugins = ResolvedPlugins,\n  TExtraData = unknown,\n> {\n  name: string\n  instructions: string\n  llmConfig: LLMConfig\n  handoffs: Handoff<\n    Context<TPlugins, TExtraData>,\n    AgentOutputType<typeof OutputSchema>\n  >[]\n  inputGuardrailRules: GuardrailRule[]\n  outputMessagesSchemas?: z.ZodObject[]\n  guardrailTrackingContext: GuardrailTrackingContext\n}\n\nexport class RouterAgent<\n  TPlugins extends ResolvedPlugins = ResolvedPlugins,\n  TExtraData = unknown,\n> extends BaseAgent {\n  private handoffs: Handoff<\n    Context<TPlugins, TExtraData>,\n    AgentOutputType<typeof OutputSchema>\n  >[]\n  private agent!: AIAgent<TPlugins, TExtraData>\n\n  private constructor(options: RouterAgentOptions<TPlugins, TExtraData>) {\n    super(options)\n    this.handoffs = options.handoffs\n  }\n\n  static async create<\n    TPlugins extends ResolvedPlugins = ResolvedPlugins,\n    TExtraData = unknown,\n  >(\n    options: RouterAgentOptions<TPlugins, TExtraData>\n  ): Promise<RouterAgent<TPlugins, TExtraData>> {\n    const routerAgent = new RouterAgent<TPlugins, TExtraData>(options)\n    const inputGuardrails = await routerAgent.getInputGuardrails()\n\n    // Agent.create is typed as Agent<UnknownContext>; we run with Context<TPlugins, TExtraData>.\n    const agent = Agent.create({\n      name: routerAgent.name,\n      model: await routerAgent.getModel(),\n      modelSettings: routerAgent.getAgentModelSettings(),\n      instructions: routerAgent.addOutputInstructions(\n        `${RECOMMENDED_PROMPT_PREFIX}${routerAgent.instructions}`\n      ),\n      handoffs: routerAgent.handoffs,\n      outputType: routerAgent.getOutputType(),\n      inputGuardrails,\n    }) as AIAgent<TPlugins, TExtraData>\n\n    routerAgent.agent = agent\n    return routerAgent\n  }\n\n  getAgent(): AIAgent<TPlugins, TExtraData> {\n    return this.agent\n  }\n}\n"],"names":["Agent","RECOMMENDED_PROMPT_PREFIX","BaseAgent","RouterAgent","options","routerAgent","inputGuardrails","agent"],"mappings":";;;;;;;;;;;;;;;;;;AAC0E;AACA;AAMlC;AAkBjC,MAAMG,WAAWA,SAGdD,SAASA;IAYjB,aAAa,OAIXE,OAAiD,EACL;QAC5C,MAAMC,cAAc,IAAIF,WAAWA,CAAuBC;QAC1D,MAAME,kBAAkB,MAAMD,YAAY,kBAAkB;QAE5D,6FAA6F;QAC7F,MAAME,QAAQP,YAAY,CAAC;YACzB,MAAMK,YAAY,IAAI;YACtB,OAAO,MAAMA,YAAY,QAAQ;YACjC,eAAeA,YAAY,qBAAqB;YAChD,cAAcA,YAAY,qBAAqB,CAC7C,GAAGJ,yBAAyBA,GAAGI,YAAY,YAAY,EAAE;YAE3D,UAAUA,YAAY,QAAQ;YAC9B,YAAYA,YAAY,aAAa;YACrCC;QACF;QAEAD,YAAY,KAAK,GAAGE;QACpB,OAAOF;IACT;IAEA,WAA0C;QACxC,OAAO,IAAI,CAAC,KAAK;IACnB;IAjCA,YAAoBD,OAAiD,CAAE;QACrE,KAAK,CAACA,UAPR,uBAAQ,YAAR,SAIA,uBAAQ,SAAR;QAIE,IAAI,CAAC,QAAQ,GAAGA,QAAQ,QAAQ;IAClC;AA+BF"}

package/lib/{cjs/agents → agents}/specialist-agent.d.ts

@@ -1,10 +1,10 @@
 import type { CampaignV2, ContactInfo, ResolvedPlugins } from '@botonic/core';
 import type { z } from 'zod';
-import type { DebugLogger } from '../debug-logger';
-import type { GuardrailTrackingContext } from '../guardrails/input';
-import type { LLMConfig } from '../llm-config';
-import type { AIAgent, GuardrailRule, Tool } from '../types';
-import { BaseAgent } from './base-agent';
+import type { DebugLogger } from '../debug-logger.js';
+import type { GuardrailTrackingContext } from '../guardrails/input.js';
+import type { LLMConfig } from '../llm-config.js';
+import type { AIAgent, GuardrailRule, Tool } from '../types.js';
+import { BaseAgent } from './base-agent.js';
 interface SpecialistAgentOptions<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = unknown> {
     name: string;
     instructions: string;

package/lib/{cjs/agents → agents}/specialist-agent.js

@@ -1,42 +1,44 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SpecialistAgent = void 0;
-const agents_1 = require("@openai/agents");
-const constants_1 = require("../constants");
-const tools_1 = require("../tools");
-const base_agent_1 = require("./base-agent");
-class SpecialistAgent extends base_agent_1.BaseAgent {
-    constructor(options) {
-        super({
-            name: options.name,
-            instructions: options.instructions,
-            llmConfig: options.llmConfig,
-            inputGuardrailRules: options.inputGuardrailRules,
-            outputMessagesSchemas: options.outputMessagesSchemas,
-            guardrailTrackingContext: options.guardrailTrackingContext,
+import { Agent } from "@openai/agents";
+import { LLM_PROVIDER } from "../constants.js";
+import { RETRIEVE_KNOWLEDGE_TOOL_NAME, createRetrieveKnowledge, mandatoryTools } from "../tools/index.js";
+import { BaseAgent } from "./base-agent.js";
+
+
+
+
+
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
         });
-        this.instructions = this.addExtraInstructions(options.instructions, options.contactInfo, options.campaignsContext);
-        this.tools = this.addHubtypeTools(options.tools, options.sourceIds);
-        this.logger = options.logger;
-        this.forceToolNameOverride = options.forceToolNameOverride;
-        this.disableForceRetrieveKnowledge = options.disableForceRetrieveKnowledge;
-    }
+    } else obj[key] = value;
+    return obj;
+}
+
+
+
+
+class SpecialistAgent extends BaseAgent {
     static async create(options) {
         const specialistAgent = new SpecialistAgent(options);
         const model = specialistAgent.llmConfig.modelName;
         const resolvedModel = await specialistAgent.getModel();
-        const hasRetrieveKnowledge = specialistAgent.tools.some(tool => tool.name === tools_1.RETRIEVE_KNOWLEDGE_TOOL_NAME);
+        const hasRetrieveKnowledge = specialistAgent.tools.some((tool)=>tool.name === RETRIEVE_KNOWLEDGE_TOOL_NAME);
         const modelSettings = specialistAgent.getSpecialistModelSettings(hasRetrieveKnowledge);
         const inputGuardrails = await specialistAgent.getInputGuardrails();
         specialistAgent.logger.logModelSettings({
-            provider: constants_1.LLM_PROVIDER,
+            provider: LLM_PROVIDER,
             model,
             reasoning: modelSettings.reasoning,
             text: modelSettings.text,
             toolChoice: modelSettings.toolChoice,
-            hasRetrieveKnowledge,
+            hasRetrieveKnowledge
         });
-        const agent = new agents_1.Agent({
+        const agent = new Agent({
             name: specialistAgent.name,
             model: resolvedModel,
             modelSettings,
@@ -44,7 +46,7 @@ class SpecialistAgent extends base_agent_1.BaseAgent {
             tools: specialistAgent.tools,
             outputType: specialistAgent.getOutputType(),
             inputGuardrails,
-            outputGuardrails: [],
+            outputGuardrails: []
         });
         specialistAgent.agent = agent;
         return specialistAgent;
@@ -54,11 +56,9 @@ class SpecialistAgent extends base_agent_1.BaseAgent {
     }
     getSpecialistModelSettings(hasRetrieveKnowledge) {
         const modelSettings = this.getAgentModelSettings();
-        const forceRetrieveKnowledge = hasRetrieveKnowledge &&
-            !this.forceToolNameOverride &&
-            !this.disableForceRetrieveKnowledge;
+        const forceRetrieveKnowledge = hasRetrieveKnowledge && !this.forceToolNameOverride && !this.disableForceRetrieveKnowledge;
         if (forceRetrieveKnowledge) {
-            modelSettings.toolChoice = tools_1.RETRIEVE_KNOWLEDGE_TOOL_NAME;
+            modelSettings.toolChoice = RETRIEVE_KNOWLEDGE_TOOL_NAME;
         }
         if (this.forceToolNameOverride) {
             modelSettings.toolChoice = this.forceToolNameOverride;
@@ -70,15 +70,15 @@ class SpecialistAgent extends base_agent_1.BaseAgent {
             `<instructions>\n${initialInstructions.trim()}\n</instructions>`,
             this.getMetadataInstructions(),
             this.getContactInfoInstructions(contactInfo),
-            this.getCampaignInstructions(campaignsContext),
-        ].filter(section => section.length > 0);
+            this.getCampaignInstructions(campaignsContext)
+        ].filter((section)=>section.length > 0);
         return this.addOutputInstructions(sections.join('\n\n'));
     }
     getContactInfoInstructions(contactInfo) {
-        return `<contact_info_fields>${JSON.stringify(contactInfo.map(info => ({
-            name: info.name,
-            value: info.value,
-        })), null, 0)}</contact_info_fields>`;
+        return `<contact_info_fields>${JSON.stringify(contactInfo.map((info)=>({
+                name: info.name,
+                value: info.value
+            })), null, 0)}</contact_info_fields>`;
     }
     getMetadataInstructions() {
         const metadata = `Current Date: ${new Date().toISOString()}`;
@@ -88,21 +88,41 @@ class SpecialistAgent extends base_agent_1.BaseAgent {
         if (!campaignsContext || campaignsContext.length === 0) {
             return '';
         }
-        const campaignsWithContext = campaignsContext.filter(campaign => campaign.agent_context);
+        const campaignsWithContext = campaignsContext.filter((campaign)=>campaign.agent_context);
         if (campaignsWithContext.length === 0) {
             return '';
         }
-        return campaignsWithContext
-            .map((campaign, index) => `<campaign_context_${index + 1}>\n${campaign.agent_context}\n</campaign_context_${index + 1}>`)
-            .join('\n');
+        return campaignsWithContext.map((campaign, index)=>`<campaign_context_${index + 1}>\n${campaign.agent_context}\n</campaign_context_${index + 1}>`).join('\n');
     }
     addHubtypeTools(tools, sourceIds) {
-        const hubtypeTools = [...tools_1.mandatoryTools];
+        const hubtypeTools = [
+            ...mandatoryTools
+        ];
         if (sourceIds.length > 0) {
-            hubtypeTools.push((0, tools_1.createRetrieveKnowledge)(sourceIds));
+            hubtypeTools.push(createRetrieveKnowledge(sourceIds));
         }
-        return [...hubtypeTools, ...tools];
+        return [
+            ...hubtypeTools,
+            ...tools
+        ];
+    }
+    constructor(options){
+        super({
+            name: options.name,
+            instructions: options.instructions,
+            llmConfig: options.llmConfig,
+            inputGuardrailRules: options.inputGuardrailRules,
+            outputMessagesSchemas: options.outputMessagesSchemas,
+            guardrailTrackingContext: options.guardrailTrackingContext
+        }), _define_property(this, "tools", void 0), _define_property(this, "logger", void 0), _define_property(this, "agent", void 0), _define_property(this, "forceToolNameOverride", void 0), _define_property(this, "disableForceRetrieveKnowledge", void 0);
+        this.instructions = this.addExtraInstructions(options.instructions, options.contactInfo, options.campaignsContext);
+        this.tools = this.addHubtypeTools(options.tools, options.sourceIds);
+        this.logger = options.logger;
+        this.forceToolNameOverride = options.forceToolNameOverride;
+        this.disableForceRetrieveKnowledge = options.disableForceRetrieveKnowledge;
     }
 }
-exports.SpecialistAgent = SpecialistAgent;
+
+export { SpecialistAgent };
+
 //# sourceMappingURL=specialist-agent.js.map

package/lib/agents/specialist-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents/specialist-agent.js","sources":["../../src/agents/specialist-agent.ts"],"sourcesContent":["import type { CampaignV2, ContactInfo, ResolvedPlugins } from '@botonic/core'\nimport { Agent, type AgentOutputType, type ModelSettings } from '@openai/agents'\nimport type { z } from 'zod'\nimport { LLM_PROVIDER } from '../constants'\nimport type { DebugLogger } from '../debug-logger'\nimport type { GuardrailTrackingContext } from '../guardrails/input'\nimport type { LLMConfig } from '../llm-config'\nimport type { OutputSchema } from '../structured-output'\nimport {\n  createRetrieveKnowledge,\n  mandatoryTools,\n  RETRIEVE_KNOWLEDGE_TOOL_NAME,\n} from '../tools'\nimport type { AIAgent, Context, GuardrailRule, Tool } from '../types'\nimport { BaseAgent } from './base-agent'\n\ninterface SpecialistAgentOptions<\n  TPlugins extends ResolvedPlugins = ResolvedPlugins,\n  TExtraData = unknown,\n> {\n  name: string\n  instructions: string\n  tools: Tool<TPlugins, TExtraData>[]\n  campaignsContext?: CampaignV2[]\n  contactInfo: ContactInfo[]\n  inputGuardrailRules: GuardrailRule[]\n  sourceIds: string[]\n  outputMessagesSchemas?: z.ZodObject[]\n  llmConfig: LLMConfig\n  logger: DebugLogger\n  guardrailTrackingContext: GuardrailTrackingContext\n  forceToolNameOverride?: string\n  disableForceRetrieveKnowledge?: boolean\n}\n\nexport class SpecialistAgent<\n  TPlugins extends ResolvedPlugins = ResolvedPlugins,\n  TExtraData = unknown,\n> extends BaseAgent {\n  private tools: Tool<TPlugins, TExtraData>[]\n  private logger: DebugLogger\n  private agent!: AIAgent<TPlugins, TExtraData>\n  private forceToolNameOverride?: string\n  private disableForceRetrieveKnowledge?: boolean\n\n  private constructor(options: SpecialistAgentOptions<TPlugins, TExtraData>) {\n    super({\n      name: options.name,\n      instructions: options.instructions,\n      llmConfig: options.llmConfig,\n      inputGuardrailRules: options.inputGuardrailRules,\n      outputMessagesSchemas: options.outputMessagesSchemas,\n      guardrailTrackingContext: options.guardrailTrackingContext,\n    })\n    this.instructions = this.addExtraInstructions(\n      options.instructions,\n      options.contactInfo,\n      options.campaignsContext\n    )\n    this.tools = this.addHubtypeTools(options.tools, options.sourceIds)\n    this.logger = options.logger\n    this.forceToolNameOverride = options.forceToolNameOverride\n    this.disableForceRetrieveKnowledge = options.disableForceRetrieveKnowledge\n  }\n\n  static async create<\n    TPlugins extends ResolvedPlugins = ResolvedPlugins,\n    TExtraData = unknown,\n  >(\n    options: SpecialistAgentOptions<TPlugins, TExtraData>\n  ): Promise<SpecialistAgent<TPlugins, TExtraData>> {\n    const specialistAgent = new SpecialistAgent<TPlugins, TExtraData>(options)\n    const model = specialistAgent.llmConfig.modelName\n    const resolvedModel = await specialistAgent.getModel()\n    const hasRetrieveKnowledge = specialistAgent.tools.some(\n      tool => tool.name === RETRIEVE_KNOWLEDGE_TOOL_NAME\n    )\n    const modelSettings =\n      specialistAgent.getSpecialistModelSettings(hasRetrieveKnowledge)\n    const inputGuardrails = await specialistAgent.getInputGuardrails()\n\n    specialistAgent.logger.logModelSettings({\n      provider: LLM_PROVIDER,\n      model,\n      reasoning: modelSettings.reasoning as { effort: string } | undefined,\n      text: modelSettings.text as { verbosity: string } | undefined,\n      toolChoice: modelSettings.toolChoice,\n      hasRetrieveKnowledge,\n    })\n\n    const agent = new Agent<\n      Context<TPlugins, TExtraData>,\n      AgentOutputType<typeof OutputSchema>\n    >({\n      name: specialistAgent.name,\n      model: resolvedModel,\n      modelSettings,\n      instructions: specialistAgent.instructions,\n      tools: specialistAgent.tools,\n      outputType: specialistAgent.getOutputType(),\n      inputGuardrails,\n      outputGuardrails: [],\n    })\n\n    specialistAgent.agent = agent\n    return specialistAgent\n  }\n\n  getAgent(): AIAgent<TPlugins, TExtraData> {\n    return this.agent\n  }\n\n  private getSpecialistModelSettings(\n    hasRetrieveKnowledge: boolean\n  ): ModelSettings {\n    const modelSettings = this.getAgentModelSettings()\n    const forceRetrieveKnowledge =\n      hasRetrieveKnowledge &&\n      !this.forceToolNameOverride &&\n      !this.disableForceRetrieveKnowledge\n\n    if (forceRetrieveKnowledge) {\n      modelSettings.toolChoice = RETRIEVE_KNOWLEDGE_TOOL_NAME\n    }\n\n    if (this.forceToolNameOverride) {\n      modelSettings.toolChoice = this.forceToolNameOverride\n    }\n\n    return modelSettings\n  }\n\n  private addExtraInstructions(\n    initialInstructions: string,\n    contactInfo: ContactInfo[],\n    campaignsContext?: CampaignV2[]\n  ): string {\n    const sections = [\n      `<instructions>\\n${initialInstructions.trim()}\\n</instructions>`,\n      this.getMetadataInstructions(),\n      this.getContactInfoInstructions(contactInfo),\n      this.getCampaignInstructions(campaignsContext),\n    ].filter(section => section.length > 0)\n\n    return this.addOutputInstructions(sections.join('\\n\\n'))\n  }\n\n  private getContactInfoInstructions(contactInfo: ContactInfo[]): string {\n    return `<contact_info_fields>${JSON.stringify(\n      contactInfo.map(info => ({\n        name: info.name,\n        value: info.value,\n      })),\n      null,\n      0\n    )}</contact_info_fields>`\n  }\n\n  private getMetadataInstructions(): string {\n    const metadata = `Current Date: ${new Date().toISOString()}`\n    return `<metadata>\\n${metadata}\\n</metadata>`\n  }\n\n  private getCampaignInstructions(campaignsContext?: CampaignV2[]): string {\n    if (!campaignsContext || campaignsContext.length === 0) {\n      return ''\n    }\n    const campaignsWithContext = campaignsContext.filter(\n      campaign => campaign.agent_context\n    )\n    if (campaignsWithContext.length === 0) {\n      return ''\n    }\n    return campaignsWithContext\n      .map(\n        (campaign, index) =>\n          `<campaign_context_${index + 1}>\\n${campaign.agent_context}\\n</campaign_context_${index + 1}>`\n      )\n      .join('\\n')\n  }\n\n  private addHubtypeTools(\n    tools: Tool<TPlugins, TExtraData>[],\n    sourceIds: string[]\n  ): Tool<TPlugins, TExtraData>[] {\n    const hubtypeTools: Tool[] = [...mandatoryTools]\n    if (sourceIds.length > 0) {\n      hubtypeTools.push(createRetrieveKnowledge(sourceIds))\n    }\n    return [...hubtypeTools, ...tools]\n  }\n}\n"],"names":["Agent","LLM_PROVIDER","createRetrieveKnowledge","mandatoryTools","RETRIEVE_KNOWLEDGE_TOOL_NAME","BaseAgent","SpecialistAgent","options","specialistAgent","model","resolvedModel","hasRetrieveKnowledge","tool","modelSettings","inputGuardrails","agent","forceRetrieveKnowledge","initialInstructions","contactInfo","campaignsContext","sections","section","JSON","info","metadata","Date","campaignsWithContext","campaign","index","tools","sourceIds","hubtypeTools"],"mappings":"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"}

package/lib/{cjs/bot-config-tools.d.ts → bot-config-tools.d.ts}

@@ -1,5 +1,5 @@
 import type { ToolConfigJSON } from '@botonic/core';
-import type { CustomTool } from './types';
+import type { CustomTool } from './types.js';
 /**
  * Maps custom AI agent tools to the format expected by bot config (e.g. for flow-builder).
  * Converts each tool's Zod schema to JSON Schema so it can be serialized in the config.

package/lib/bot-config-tools.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+
+
+
+/**
+ * Maps custom AI agent tools to the format expected by bot config (e.g. for flow-builder).
+ * Converts each tool's Zod schema to JSON Schema so it can be serialized in the config.
+ */ function getToolsForBotConfig(customTools) {
+    return customTools.map((tool)=>({
+            name: tool.name,
+            description: tool.description,
+            schema: z.toJSONSchema(tool.schema, {
+                target: 'draft-07'
+            })
+        }));
+}
+
+export { getToolsForBotConfig };
+
+//# sourceMappingURL=bot-config-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bot-config-tools.js","sources":["../src/bot-config-tools.ts"],"sourcesContent":["import type { ToolConfigJSON } from '@botonic/core'\nimport { z } from 'zod'\n\nimport type { CustomTool } from './types'\n\n/**\n * Maps custom AI agent tools to the format expected by bot config (e.g. for flow-builder).\n * Converts each tool's Zod schema to JSON Schema so it can be serialized in the config.\n */\nexport function getToolsForBotConfig(\n  customTools: CustomTool[]\n): ToolConfigJSON[] {\n  return customTools.map(tool => ({\n    name: tool.name,\n    description: tool.description,\n    schema: z.toJSONSchema(tool.schema, {\n      target: 'draft-07',\n    }) as ToolConfigJSON['schema'],\n  }))\n}\n"],"names":["z","getToolsForBotConfig","customTools","tool"],"mappings":";;;AACuB;AAIvB;;;CAGC,GACM,SAASC,oBAAoBA,CAClCC,WAAyB;IAEzB,OAAOA,YAAY,GAAG,CAACC,CAAAA,OAAS;YAC9B,MAAMA,KAAK,IAAI;YACf,aAAaA,KAAK,WAAW;YAC7B,QAAQH,cAAc,CAACG,KAAK,MAAM,EAAE;gBAClC,QAAQ;YACV;QACF;AACF"}

package/lib/constants.js

@@ -0,0 +1,26 @@
+const HUBTYPE_API_URL = process.env.HUBTYPE_API_URL || 'https://api.hubtype.com';
+// LLM Configuration (provider-agnostic; set LLM_PROVIDER=azure|openai)
+const LLM_PROVIDERS = {
+    AZURE: 'azure',
+    OPENAI: 'openai',
+    LITELLM: 'litellm'
+};
+const LITELLM_TAG_KEYS = {
+    BOT_ID: 'bot_id',
+    ORG_ID: 'org_id',
+    SEPARATOR: ','
+};
+const LLM_PROVIDER = process.env.LLM_PROVIDER || LLM_PROVIDERS.AZURE;
+const LLM_API_KEY = process.env.LLM_API_KEY // pragma: allowlist secret
+;
+const LLM_API_URL = process.env.LLM_API_URL;
+const LLM_AZURE_API_VERSION = process.env.LLM_AZURE_API_VERSION || '2025-01-01-preview';
+const LLM_OPENAI_MODEL = process.env.LLM_OPENAI_MODEL || 'gpt-4.1-mini';
+const isProd = process.env.NODE_ENV === 'production';
+const MAX_MEMORY_LENGTH = 25;
+const DEFAULT_TIMEOUT_16_SECONDS = 16000;
+const DEFAULT_MAX_RETRIES = 2;
+
+export { DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_16_SECONDS, HUBTYPE_API_URL, LITELLM_TAG_KEYS, LLM_API_KEY, LLM_API_URL, LLM_AZURE_API_VERSION, LLM_OPENAI_MODEL, LLM_PROVIDER, LLM_PROVIDERS, MAX_MEMORY_LENGTH, isProd };
+
+//# sourceMappingURL=constants.js.map

package/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sources":["../src/constants.ts"],"sourcesContent":["export const HUBTYPE_API_URL =\n  process.env.HUBTYPE_API_URL || 'https://api.hubtype.com'\n\n// LLM Configuration (provider-agnostic; set LLM_PROVIDER=azure|openai)\nexport const LLM_PROVIDERS = {\n  AZURE: 'azure',\n  OPENAI: 'openai',\n  LITELLM: 'litellm',\n} as const\n\nexport type LLMProviderType = (typeof LLM_PROVIDERS)[keyof typeof LLM_PROVIDERS]\n\nexport const LITELLM_TAG_KEYS = {\n  BOT_ID: 'bot_id',\n  ORG_ID: 'org_id',\n  SEPARATOR: ',',\n} as const\n\nexport const LLM_PROVIDER: LLMProviderType =\n  (process.env.LLM_PROVIDER as LLMProviderType) || LLM_PROVIDERS.AZURE\nexport const LLM_API_KEY = process.env.LLM_API_KEY // pragma: allowlist secret\nexport const LLM_API_URL = process.env.LLM_API_URL\nexport const LLM_AZURE_API_VERSION =\n  process.env.LLM_AZURE_API_VERSION || '2025-01-01-preview'\nexport const LLM_OPENAI_MODEL = process.env.LLM_OPENAI_MODEL || 'gpt-4.1-mini'\n\nexport const isProd = process.env.NODE_ENV === 'production'\n\nexport const MAX_MEMORY_LENGTH = 25\n\nexport const DEFAULT_TIMEOUT_16_SECONDS = 16000\nexport const DEFAULT_MAX_RETRIES = 2\n"],"names":["HUBTYPE_API_URL","process","LLM_PROVIDERS","LITELLM_TAG_KEYS","LLM_PROVIDER","LLM_API_KEY","LLM_API_URL","LLM_AZURE_API_VERSION","LLM_OPENAI_MODEL","isProd","MAX_MEMORY_LENGTH","DEFAULT_TIMEOUT_16_SECONDS","DEFAULT_MAX_RETRIES"],"mappings":"AAAO,MAAMA,eAAeA,GAC1BC,QAAQ,GAAG,CAAC,eAAe,IAAI,0BAAyB;AAE1D,uEAAuE;AAChE,MAAMC,aAAaA,GAAG;IAC3B,OAAO;IACP,QAAQ;IACR,SAAS;AACX,EAAU;AAIH,MAAMC,gBAAgBA,GAAG;IAC9B,QAAQ;IACR,QAAQ;IACR,WAAW;AACb,EAAU;AAEH,MAAMC,YAAYA,GACtBH,QAAQ,GAAG,CAAC,YAAY,IAAwBC,aAAaA,CAAC,KAAK;AAC/D,MAAMG,WAAWA,GAAGJ,QAAQ,GAAG,CAAC,WAAW,CAAC,2BAA2B;CAA5B;AAC3C,MAAMK,WAAWA,GAAGL,QAAQ,GAAG,CAAC,WAAW;AAC3C,MAAMM,qBAAqBA,GAChCN,QAAQ,GAAG,CAAC,qBAAqB,IAAI,qBAAoB;AACpD,MAAMO,gBAAgBA,GAAGP,QAAQ,GAAG,CAAC,gBAAgB,IAAI,eAAc;AAEvE,MAAMQ,MAAMA,GAAGR,oBAAoB,KAAK,aAAY;AAEpD,MAAMS,iBAAiBA,GAAG,GAAE;AAE5B,MAAMC,0BAA0BA,GAAG,MAAK;AACxC,MAAMC,mBAAmBA,GAAG,EAAC"}

package/lib/{esm/debug-logger.d.ts → debug-logger.d.ts}

@@ -1,6 +1,6 @@
 import { type AiAgentArgs, type ToolExecution } from '@botonic/core';
 import type { ModelSettings } from '@openai/agents';
-import type { AgenticInputMessage, MemoryOptions, RunResult } from './types';
+import type { AgenticInputMessage, MemoryOptions, RunResult } from './types.js';
 export interface DebugLoggerConfig {
     messageHistoryApiVersion: string;
     maxRetries: number;

package/lib/{cjs/debug-logger.js → debug-logger.js}

@@ -1,13 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createDebugLogger = createDebugLogger;
-const core_1 = require("@botonic/core");
-const constants_1 = require("./constants");
+import { AiAgentType } from "@botonic/core";
+import { LLM_PROVIDER } from "./constants.js";
+
+
+
+
+
 const PREFIX = '[BotonicPluginAiAgents]';
 class EnabledDebugLogger {
     logInitialConfig(config) {
         console.log(`${PREFIX} === Plugin Initialization ===`);
-        console.log(`${PREFIX} Provider: ${constants_1.LLM_PROVIDER}`);
+        console.log(`${PREFIX} Provider: ${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`);
@@ -16,7 +18,7 @@ class EnabledDebugLogger {
             maxMessages: config.memory.maxMessages,
             includeToolCalls: config.memory.includeToolCalls,
             maxFullToolResults: config.memory.maxFullToolResults,
-            debugMode: config.memory.debugMode,
+            debugMode: config.memory.debugMode
         });
         console.log(`${PREFIX} === End Plugin Initialization ===`);
     }
@@ -24,7 +26,7 @@ class EnabledDebugLogger {
         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) {
+        if (aiAgentArgs.type === AiAgentType.Specialist) {
             console.log(`${PREFIX} Source IDs: ${JSON.stringify(aiAgentArgs.sourceIds || [])}`);
         }
         console.log(`${PREFIX} Message History Count: ${messages.length}`);
@@ -59,7 +61,7 @@ class EnabledDebugLogger {
         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))}`);
+        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}`);
         }
@@ -113,4 +115,7 @@ class DisabledDebugLogger {
 function createDebugLogger(enableDebug) {
     return enableDebug ? new EnabledDebugLogger() : new DisabledDebugLogger();
 }
+
+export { createDebugLogger };
+
 //# sourceMappingURL=debug-logger.js.map

package/lib/debug-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-logger.js","sources":["../src/debug-logger.ts"],"sourcesContent":["import {\n  type AiAgentArgs,\n  AiAgentType,\n  type ToolExecution,\n} from '@botonic/core'\nimport type { ModelSettings } from '@openai/agents'\nimport { LLM_PROVIDER } from './constants'\nimport type { AgenticInputMessage, MemoryOptions, RunResult } from './types'\n\nconst PREFIX = '[BotonicPluginAiAgents]'\n\nexport interface DebugLoggerConfig {\n  messageHistoryApiVersion: string\n  maxRetries: number\n  timeout: number\n  customToolNames: string[]\n  memory: MemoryOptions\n}\n\nexport interface ModelSettingsInfo {\n  provider: string\n  model: string | undefined\n  reasoning?: { effort: string }\n  text?: { verbosity: string }\n  toolChoice?: string\n  hasRetrieveKnowledge: boolean\n}\n\nexport interface DebugLogger {\n  logInitialConfig(config: DebugLoggerConfig): void\n  logAgentDebugInfo(\n    aiAgentArgs: AiAgentArgs,\n    toolNames: string[],\n    messages: AgenticInputMessage[]\n  ): void\n  logModelSettings(settings: ModelSettingsInfo): void\n  logRunnerStart(\n    model: string,\n    modelSettings: ModelSettings,\n    prompt: string\n  ): void\n  logRunResult(runResult: RunResult, startTime: number): void\n  logGuardrailTriggered(): void\n  logRunnerError(startTime: number, error: unknown): void\n  logToolExecution(toolExecution: ToolExecution): void\n}\n\nclass EnabledDebugLogger implements DebugLogger {\n  logInitialConfig(config: DebugLoggerConfig): void {\n    console.log(`${PREFIX} === Plugin Initialization ===`)\n    console.log(`${PREFIX} Provider: ${LLM_PROVIDER}`)\n    console.log(\n      `${PREFIX} Message History API Version: ${config.messageHistoryApiVersion}`\n    )\n    console.log(`${PREFIX} Max Retries: ${config.maxRetries}`)\n    console.log(`${PREFIX} Timeout: ${config.timeout}ms`)\n    console.log(\n      `${PREFIX} Custom Tools Registered: ${config.customToolNames.join(', ') || 'none'}`\n    )\n    console.log(`${PREFIX} Memory Options:`, {\n      maxMessages: config.memory.maxMessages,\n      includeToolCalls: config.memory.includeToolCalls,\n      maxFullToolResults: config.memory.maxFullToolResults,\n      debugMode: config.memory.debugMode,\n    })\n    console.log(`${PREFIX} === End Plugin Initialization ===`)\n  }\n\n  logAgentDebugInfo(\n    aiAgentArgs: AiAgentArgs,\n    toolNames: string[],\n    messages: AgenticInputMessage[]\n  ): void {\n    console.log(`${PREFIX} === AI Agent Debug Info ===`)\n    console.log(`${PREFIX} Agent Name: ${aiAgentArgs.name}`)\n    console.log(`${PREFIX} Active Tools: ${JSON.stringify(toolNames)}`)\n    if (aiAgentArgs.type === AiAgentType.Specialist) {\n      console.log(\n        `${PREFIX} Source IDs: ${JSON.stringify(aiAgentArgs.sourceIds || [])}`\n      )\n    }\n    console.log(`${PREFIX} Message History Count: ${messages.length}`)\n    console.log(`${PREFIX} Messages: ${JSON.stringify(messages, null, 2)}`)\n    console.log(\n      `${PREFIX} Input Guardrail Rules: ${aiAgentArgs.inputGuardrailRules?.length || 0}`\n    )\n    console.log(`${PREFIX} === End Debug Info ===`)\n  }\n\n  logModelSettings(settings: ModelSettingsInfo): void {\n    console.log(`${PREFIX} === Agent Model Settings ===`)\n    console.log(\n      `${PREFIX} Has Retrieve Knowledge Tool: ${settings.hasRetrieveKnowledge}`\n    )\n    if (settings.reasoning) {\n      console.log(`${PREFIX} Reasoning Effort: ${settings.reasoning.effort}`)\n    }\n    if (settings.text) {\n      console.log(`${PREFIX} Text Verbosity: ${settings.text.verbosity}`)\n    }\n    if (settings.toolChoice) {\n      console.log(`${PREFIX} Tool Choice: ${settings.toolChoice}`)\n    }\n    console.log(`${PREFIX} === End Model Settings ===`)\n  }\n\n  logRunnerStart(\n    model: string,\n    modelSettings: ModelSettings,\n    prompt: string\n  ): void {\n    console.log(`${PREFIX} === Runner Execution Start ===`)\n    console.log(`${PREFIX} Model: ${model}`)\n    console.log(`${PREFIX} Model Settings: ${JSON.stringify(modelSettings)}`)\n    console.log(`${PREFIX} Prompt: ${prompt}`)\n  }\n\n  logRunResult(runResult: RunResult, startTime: number): void {\n    const elapsedMs = Date.now() - startTime\n\n    console.log(`${PREFIX} === Runner Execution Complete ===`)\n    console.log(`${PREFIX} Execution Time: ${elapsedMs}ms`)\n    console.log(`${PREFIX} Output Messages Count: ${runResult.messages.length}`)\n    console.log(`${PREFIX} Exit: ${runResult.exit}`)\n    console.log(`${PREFIX} Error: ${runResult.error}`)\n    console.log(\n      `${PREFIX} Tools Executed: ${JSON.stringify(runResult.toolsExecuted.map(t => t.toolName))}`\n    )\n    if (runResult.inputGuardrailsTriggered.length > 0) {\n      console.log(\n        `${PREFIX} Input Guardrails Triggered: ${runResult.inputGuardrailsTriggered.length}`\n      )\n    }\n    if (runResult.outputGuardrailsTriggered.length > 0) {\n      console.log(\n        `${PREFIX} Output Guardrails Triggered: ${runResult.outputGuardrailsTriggered.length}`\n      )\n    }\n    console.log(`${PREFIX} === End Runner Execution ===`)\n  }\n\n  logGuardrailTriggered(): void {\n    console.log(`${PREFIX} Input guardrail triggered`)\n  }\n\n  logRunnerError(startTime: number, error: unknown): void {\n    const elapsedMs = Date.now() - startTime\n    console.log(`${PREFIX} Runner execution failed after ${elapsedMs}ms`)\n    console.log(`${PREFIX} Error:`, error)\n  }\n\n  logToolExecution(toolExecution: ToolExecution): void {\n    console.log(`${PREFIX} Tool Execution: ${toolExecution.toolName}`)\n    console.log(\n      `${PREFIX} Tool Arguments: ${JSON.stringify(toolExecution.toolArguments)}`\n    )\n    console.log(`${PREFIX} Tool Results: ${toolExecution.toolResults}`)\n    console.log(\n      `${PREFIX} Knowledgebase Sources IDs: ${JSON.stringify(toolExecution.knowledgebaseSourcesIds)}`\n    )\n    console.log(\n      `${PREFIX} Knowledgebase Chunks IDs: ${JSON.stringify(toolExecution.knowledgebaseChunksIds)}`\n    )\n  }\n}\n\nclass DisabledDebugLogger implements DebugLogger {\n  logInitialConfig(): void {\n    return\n  }\n  logAgentDebugInfo(): void {\n    return\n  }\n  logModelSettings(): void {\n    return\n  }\n  logRunnerStart(\n    _model: string,\n    _modelSettings: ModelSettings,\n    _prompt: string\n  ): void {\n    return\n  }\n  logRunResult(): void {\n    return\n  }\n  logGuardrailTriggered(): void {\n    return\n  }\n  logRunnerError(): void {\n    return\n  }\n  logToolExecution(): void {\n    return\n  }\n}\n\nexport function createDebugLogger(enableDebug: boolean): DebugLogger {\n  return enableDebug ? new EnabledDebugLogger() : new DisabledDebugLogger()\n}\n"],"names":["AiAgentType","LLM_PROVIDER","PREFIX","EnabledDebugLogger","config","console","aiAgentArgs","toolNames","messages","JSON","settings","model","modelSettings","prompt","runResult","startTime","elapsedMs","Date","t","error","toolExecution","DisabledDebugLogger","_model","_modelSettings","_prompt","createDebugLogger","enableDebug"],"mappings":";;;;;AAIsB;AAEoB;AAG1C,MAAME,MAAMA,GAAG;AAsCf,MAAMC,kBAAkBA;IACtB,iBAAiBC,MAAyB,EAAQ;QAChDC,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,8BAA8B,CAAC;QACrDG,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,WAAW,EAAED,YAAYA,EAAE;QACjDI,QAAQ,GAAG,CACT,GAAGH,MAAMA,CAAC,8BAA8B,EAAEE,OAAO,wBAAwB,EAAE;QAE7EC,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,cAAc,EAAEE,OAAO,UAAU,EAAE;QACzDC,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,UAAU,EAAEE,OAAO,OAAO,CAAC,EAAE,CAAC;QACpDC,QAAQ,GAAG,CACT,GAAGH,MAAMA,CAAC,0BAA0B,EAAEE,OAAO,eAAe,CAAC,IAAI,CAAC,SAAS,QAAQ;QAErFC,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,gBAAgB,CAAC,EAAE;YACvC,aAAaE,OAAO,MAAM,CAAC,WAAW;YACtC,kBAAkBA,OAAO,MAAM,CAAC,gBAAgB;YAChD,oBAAoBA,OAAO,MAAM,CAAC,kBAAkB;YACpD,WAAWA,OAAO,MAAM,CAAC,SAAS;QACpC;QACAC,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,kCAAkC,CAAC;IAC3D;IAEA,kBACEI,WAAwB,EACxBC,SAAmB,EACnBC,QAA+B,EACzB;QACNH,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,4BAA4B,CAAC;QACnDG,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,aAAa,EAAEI,YAAY,IAAI,EAAE;QACvDD,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,eAAe,EAAEO,KAAK,SAAS,CAACF,YAAY;QAClE,IAAID,YAAY,IAAI,KAAKN,sBAAsB,EAAE;YAC/CK,QAAQ,GAAG,CACT,GAAGH,MAAMA,CAAC,aAAa,EAAEO,KAAK,SAAS,CAACH,YAAY,SAAS,IAAI,EAAE,GAAG;QAE1E;QACAD,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,wBAAwB,EAAEM,SAAS,MAAM,EAAE;QACjEH,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,WAAW,EAAEO,KAAK,SAAS,CAACD,UAAU,MAAM,IAAI;QACtEH,QAAQ,GAAG,CACT,GAAGH,MAAMA,CAAC,wBAAwB,EAAEI,YAAY,mBAAmB,EAAE,UAAU,GAAG;QAEpFD,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,uBAAuB,CAAC;IAChD;IAEA,iBAAiBQ,QAA2B,EAAQ;QAClDL,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,6BAA6B,CAAC;QACpDG,QAAQ,GAAG,CACT,GAAGH,MAAMA,CAAC,8BAA8B,EAAEQ,SAAS,oBAAoB,EAAE;QAE3E,IAAIA,SAAS,SAAS,EAAE;YACtBL,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,mBAAmB,EAAEQ,SAAS,SAAS,CAAC,MAAM,EAAE;QACxE;QACA,IAAIA,SAAS,IAAI,EAAE;YACjBL,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,iBAAiB,EAAEQ,SAAS,IAAI,CAAC,SAAS,EAAE;QACpE;QACA,IAAIA,SAAS,UAAU,EAAE;YACvBL,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,cAAc,EAAEQ,SAAS,UAAU,EAAE;QAC7D;QACAL,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,2BAA2B,CAAC;IACpD;IAEA,eACES,KAAa,EACbC,aAA4B,EAC5BC,MAAc,EACR;QACNR,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,+BAA+B,CAAC;QACtDG,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,QAAQ,EAAES,OAAO;QACvCN,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,iBAAiB,EAAEO,KAAK,SAAS,CAACG,gBAAgB;QACxEP,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,SAAS,EAAEW,QAAQ;IAC3C;IAEA,aAAaC,SAAoB,EAAEC,SAAiB,EAAQ;QAC1D,MAAMC,YAAYC,KAAK,GAAG,KAAKF;QAE/BV,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,kCAAkC,CAAC;QACzDG,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,iBAAiB,EAAEc,UAAU,EAAE,CAAC;QACtDX,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,wBAAwB,EAAEY,UAAU,QAAQ,CAAC,MAAM,EAAE;QAC3ET,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,OAAO,EAAEY,UAAU,IAAI,EAAE;QAC/CT,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,QAAQ,EAAEY,UAAU,KAAK,EAAE;QACjDT,QAAQ,GAAG,CACT,GAAGH,MAAMA,CAAC,iBAAiB,EAAEO,KAAK,SAAS,CAACK,UAAU,aAAa,CAAC,GAAG,CAACI,CAAAA,IAAKA,EAAE,QAAQ,IAAI;QAE7F,IAAIJ,UAAU,wBAAwB,CAAC,MAAM,GAAG,GAAG;YACjDT,QAAQ,GAAG,CACT,GAAGH,MAAMA,CAAC,6BAA6B,EAAEY,UAAU,wBAAwB,CAAC,MAAM,EAAE;QAExF;QACA,IAAIA,UAAU,yBAAyB,CAAC,MAAM,GAAG,GAAG;YAClDT,QAAQ,GAAG,CACT,GAAGH,MAAMA,CAAC,8BAA8B,EAAEY,UAAU,yBAAyB,CAAC,MAAM,EAAE;QAE1F;QACAT,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,6BAA6B,CAAC;IACtD;IAEA,wBAA8B;QAC5BG,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,0BAA0B,CAAC;IACnD;IAEA,eAAea,SAAiB,EAAEI,KAAc,EAAQ;QACtD,MAAMH,YAAYC,KAAK,GAAG,KAAKF;QAC/BV,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,+BAA+B,EAAEc,UAAU,EAAE,CAAC;QACpEX,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,OAAO,CAAC,EAAEiB;IAClC;IAEA,iBAAiBC,aAA4B,EAAQ;QACnDf,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,iBAAiB,EAAEkB,cAAc,QAAQ,EAAE;QACjEf,QAAQ,GAAG,CACT,GAAGH,MAAMA,CAAC,iBAAiB,EAAEO,KAAK,SAAS,CAACW,cAAc,aAAa,GAAG;QAE5Ef,QAAQ,GAAG,CAAC,GAAGH,MAAMA,CAAC,eAAe,EAAEkB,cAAc,WAAW,EAAE;QAClEf,QAAQ,GAAG,CACT,GAAGH,MAAMA,CAAC,4BAA4B,EAAEO,KAAK,SAAS,CAACW,cAAc,uBAAuB,GAAG;QAEjGf,QAAQ,GAAG,CACT,GAAGH,MAAMA,CAAC,2BAA2B,EAAEO,KAAK,SAAS,CAACW,cAAc,sBAAsB,GAAG;IAEjG;AACF;AAEA,MAAMC,mBAAmBA;IACvB,mBAAyB;QACvB;IACF;IACA,oBAA0B;QACxB;IACF;IACA,mBAAyB;QACvB;IACF;IACA,eACEC,MAAc,EACdC,cAA6B,EAC7BC,OAAe,EACT;QACN;IACF;IACA,eAAqB;QACnB;IACF;IACA,wBAA8B;QAC5B;IACF;IACA,iBAAuB;QACrB;IACF;IACA,mBAAyB;QACvB;IACF;AACF;AAEO,SAASC,iBAAiBA,CAACC,WAAoB;IACpD,OAAOA,cAAc,IAAIvB,kBAAkBA,KAAK,IAAIkB,mBAAmBA;AACzE"}

package/lib/guardrails/index.d.ts

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

package/lib/guardrails/index.js

@@ -0,0 +1,6 @@
+export * from "./input.js";
+
+
+export {};
+
+//# sourceMappingURL=index.js.map

package/lib/guardrails/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails/index.js","sources":["../../src/guardrails/index.ts"],"sourcesContent":["export * from './input'\n"],"names":[],"mappings":";AAAuB"}

package/lib/{cjs/guardrails → guardrails}/input.d.ts

@@ -1,6 +1,6 @@
 import { type InputGuardrail } from '@openai/agents';
-import type { LLMConfig } from '../llm-config';
-import type { GuardrailRule } from '../types';
+import type { LLMConfig } from '../llm-config.js';
+import type { GuardrailRule } from '../types.js';
 export interface GuardrailTrackingContext {
     botId: string;
     isTest: boolean;