@botonic/plugin-ai-agents 0.37.0 → 0.37.2-alpha.0

package/README.md

@@ -2,13 +2,155 @@
 
 ## env variables
 
-You need this env variables when deploy a bot that use this plugin
+- It is necessary to add the following variables to an `.env` file:
+  - `AZURE_OPENAI_API_KEY`
+  - `AZURE_OPENAI_API_BASE`
+  - `AZURE_OPENAI_API_DEPLOYMENT_NAME`
+  - `AZURE_OPENAI_API_VERSION`
+- Add these env variables to build using rspack, for target NODE and DEV.
 
-.env
+```ts
+...
+import { config } from 'dotenv'
+config()
+...
+  const plugins = [
+    new rspack.EnvironmentPlugin({
+      NODE_ENV: process.env.NODE_ENV,
+      HUBTYPE_API_URL: process.env.HUBTYPE_API_URL || HUBTYPE_DEFAULTS.API_URL,
+      BOTONIC_TARGET: BotonicTarget.NODE,
+      WEBCHAT_PUSHER_KEY:
+        process.env.WEBCHAT_PUSHER_KEY || HUBTYPE_DEFAULTS.WEBCHAT_PUSHER_KEY,
+      ENVIRONMENT: process.env.ENVIRONMENT,
+      AZURE_OPENAI_API_KEY: isNodeOrDev
+        ? process.env.AZURE_OPENAI_API_KEY
+        : undefined,
+      AZURE_OPENAI_API_DEPLOYMENT_NAME: isNodeOrDev
+        ? process.env.AZURE_OPENAI_API_DEPLOYMENT_NAME
+        : undefined,
+      AZURE_OPENAI_API_VERSION: isNodeOrDev
+        ? process.env.AZURE_OPENAI_API_VERSION
+        : undefined,
+      AZURE_OPENAI_API_BASE: isNodeOrDev
+        ? process.env.AZURE_OPENAI_API_BASE
+        : undefined,
+    }),
+    new rspack.ProgressPlugin(),
+  ]
+```
+
+## Custom Tools
+
+- It is possible to add tools from the bot code. To do this:
+- Add the `zod` dependency.
+- Create and export the definition of the tools in a file, for example: `src/server/tools.ts`.
 
+```ts
+import { CustomTool } from '@botonic/plugin-ai-agents'
+import axios from 'axios'
+import z from 'zod'
+
+export const customTools: CustomTool[] = [
+  {
+    name: 'get_current_weather',
+    description: 'Get current weather for a city',
+    schema: z.object({
+      cityName: z.string(),
+    }),
+    func: async (input: { cityName: string }) => {
+      const baseURL = 'http://api.weatherapi.com/v1'
+      const response = await axios.get(`${baseURL}/forecast.json`, {
+        params: {
+          key: 'WEATHER_API_TOKEN',
+          q: input.cityName,
+        },
+      })
+      const data = response.data
+      console.log('get_current_weather', { data })
+      return data
+    },
+  },
+  ...
+]
 ```
-AZURE_OPENAI_API_KEY='FAKE_API_KEY' // pragma: allowlist secret
-AZURE_OPENAI_API_BASE='FAKE_API_URL_BASE'
-AZURE_OPENAI_API_DEPLOYMENT_NAME='gpt-4o-mini_p1'
-AZURE_OPENAI_API_VERSION='2024-12-01-preview'
+
+- Add these tools to:
+- Update the `BotonicPluginFlowBuilderOptions`, as we did with the knowledge base, and add the `customTools`.
+
+src/server/config.ts
+
+```ts
+import { PluginAiAgentOptions } from '@botonic/plugin-ai-agents'
+import { customTools } from './tools'
+
+...
+function getFlowBuilderConfig(
+  env: ENVIRONMENT
+): BotonicPluginFlowBuilderOptions<BotPlugins, UserData> {
+  return {
+...
+    getAiAgentResponse: async (
+      request: BotRequest,
+      aiAgentArgs: {
+        name: string
+        instructions: string
+      }
+    ) => {
+      const aiAgentPlugin = request.plugins.aiAgents
+      return await aiAgentPlugin.getInference(request, aiAgentArgs)
+    },
+...
+}
+
+function getAiAgentsConfig(): PluginAiAgentOptions {
+  return {
+    authToken: 'AUTH_TOKEN', // Used locally
+    customTools: customTools,
+  }
+}
+...
+
+interface Config {
+  // Use any for infer type for TPlugins and TExtraData
+  // to avoid type errors with circular dependencies
+  flowBuilder: BotonicPluginFlowBuilderOptions<any, any>
+  aiAgents: PluginAiAgentOptions
+  knowledgeBases: PluginKnowledgeBaseOptions
+}
+
+export const CONFIG: Record<ENVIRONMENT, Config> = {
+  [ENVIRONMENT.LOCAL]: {
+    flowBuilder: getFlowBuilderConfig(ENVIRONMENT.LOCAL),
+    aiAgents: getAiAgentsConfig(),
+    knowledgeBases: getKnowledgeBasesConfig(),
+  },
+  ...
+}
+```
+
+## Share customTools with flow builder frontend
+
+- Create new `src/bot-config.ts` file and add customTools. This file is used so that every time a bot is deployed, the Flow Builder frontend can know which tools are in the deployed bot and enable or disable tools for each AI Agent node.
+
+src/bot-config.ts
+
+```ts
+import { BotConfigJSON } from '@botonic/core'
+
+import { customTools } from './server/tools'
+
+const aiAgentTools =
+  customTools?.map(customTool => ({
+    name: customTool.name,
+    description: customTool.description,
+  })) || []
+
+/**
+ * This is the configuration is shared with flow-builder-frontend.
+ */
+export const botConfig: BotConfigJSON = {
+  tools: aiAgentTools,
+  payloads: [],
+  webviews: [],
+}
 ```

package/lib/cjs/agent-builder.d.ts

@@ -1,10 +1,14 @@
-import { AIAgent, Tool } from './types';
+import { AIAgent, ContactInfo, GuardrailRule, Tool } from './types';
 export declare class AIAgentBuilder {
     private name;
     private instructions;
     private tools;
-    constructor(name: string, instructions: string, tools: Tool[]);
+    private inputGuardrails;
+    constructor(name: string, instructions: string, tools: Tool[], contactInfo: ContactInfo, inputGuardrailRules: GuardrailRule[]);
     build(): AIAgent;
     private addExtraInstructions;
+    private getContactInfoInstructions;
+    private getMetadataInstructions;
+    private getOutputInstructions;
     private addHubtypeTools;
 }

package/lib/cjs/agent-builder.js

@@ -2,13 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AIAgentBuilder = void 0;
 const agents_1 = require("@openai/agents");
+const guardrails_1 = require("./guardrails");
 const structured_output_1 = require("./structured-output");
 const tools_1 = require("./tools");
 class AIAgentBuilder {
-    constructor(name, instructions, tools) {
+    constructor(name, instructions, tools, contactInfo, inputGuardrailRules) {
         this.name = name;
-        this.instructions = this.addExtraInstructions(instructions);
+        this.instructions = this.addExtraInstructions(instructions, contactInfo);
         this.tools = this.addHubtypeTools(tools);
+        this.inputGuardrails = [];
+        if (inputGuardrailRules.length > 0) {
+            const inputGuardrail = (0, guardrails_1.createInputGuardrail)(inputGuardrailRules);
+            this.inputGuardrails.push(inputGuardrail);
+        }
     }
     build() {
         return new agents_1.Agent({
@@ -16,10 +22,28 @@ class AIAgentBuilder {
             instructions: this.instructions,
             tools: this.tools,
             outputType: structured_output_1.OutputSchema,
+            inputGuardrails: this.inputGuardrails,
+            outputGuardrails: [],
         });
     }
-    addExtraInstructions(instructions) {
+    addExtraInstructions(initialInstructions, contactInfo) {
+        const instructions = `<instructions>\n${initialInstructions}\n</instructions>`;
+        const metadataInstructions = this.getMetadataInstructions();
+        const contactInfoInstructions = this.getContactInfoInstructions(contactInfo);
+        const outputInstructions = this.getOutputInstructions();
+        return `${instructions}\n\n${metadataInstructions}\n\n${contactInfoInstructions}\n\n${outputInstructions}`;
+    }
+    getContactInfoInstructions(contactInfo) {
+        const structuredContactInfo = Object.entries(contactInfo)
+            .map(([key, value]) => `${key}: ${value}`)
+            .join('\n');
+        return `<contact_info>\n${structuredContactInfo}\n</contact_info>`;
+    }
+    getMetadataInstructions() {
         const metadata = `Current Date: ${new Date().toISOString()}`;
+        return `<metadata>\n${metadata}\n</metadata>`;
+    }
+    getOutputInstructions() {
         const example = {
             messages: [
                 {
@@ -29,10 +53,9 @@ class AIAgentBuilder {
                     },
                 },
             ],
-            numMessages: 1,
         };
         const output = `Return a JSON that follows the output schema provided. Never return multiple output schemas concatenated by a line break.\n<example>\n${JSON.stringify(example)}\n</example>`;
-        return `<instructions>\n${instructions}\n</instructions>\n\n<metadata>\n${metadata}\n</metadata>\n\n<output>\n${output}\n</output>`;
+        return `<output>\n${output}\n</output>`;
     }
     addHubtypeTools(tools) {
         const hubtypeTools = [...tools_1.mandatoryTools];

package/lib/cjs/agent-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-builder.js","sourceRoot":"","sources":["../../src/agent-builder.ts"],"names":[],"mappings":";;;AAAA,2CAAsC;AAEtC,2DAAkD;AAClD,mCAAwC;AAGxC,MAAa,cAAc;IAKzB,YAAY,IAAY,EAAE,YAAoB,EAAE,KAAa;QAC3D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAA;QAC3D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;IAC1C,CAAC;IAED,KAAK;QACH,OAAO,IAAI,cAAK,CAAC;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,gCAAY;SACzB,CAAC,CAAA;IACJ,CAAC;IAEO,oBAAoB,CAAC,YAAoB;QAC/C,MAAM,QAAQ,GAAG,iBAAiB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAA;QAC5D,MAAM,OAAO,GAAG;YACd,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,kCAAkC;qBACzC;iBACF;aACF;YACD,WAAW,EAAE,CAAC;SACf,CAAA;QACD,MAAM,MAAM,GAAG,yIAAyI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,CAAA;QAC7L,OAAO,mBAAmB,YAAY,oCAAoC,QAAQ,8BAA8B,MAAM,aAAa,CAAA;IACrI,CAAC;IAEO,eAAe,CAAC,KAAa;QACnC,MAAM,YAAY,GAAW,CAAC,GAAG,sBAAc,CAAC,CAAA;QAChD,OAAO,CAAC,GAAG,YAAY,EAAE,GAAG,KAAK,CAAC,CAAA;IACpC,CAAC;CACF;AAzCD,wCAyCC"}
+{"version":3,"file":"agent-builder.js","sourceRoot":"","sources":["../../src/agent-builder.ts"],"names":[],"mappings":";;;AAAA,2CAAsD;AAEtD,6CAAmD;AACnD,2DAAkD;AAClD,mCAAwC;AAGxC,MAAa,cAAc;IAMzB,YACE,IAAY,EACZ,YAAoB,EACpB,KAAa,EACb,WAAwB,EACxB,mBAAoC;QAEpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,oBAAoB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAA;QACxE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;QACxC,IAAI,CAAC,eAAe,GAAG,EAAE,CAAA;QACzB,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE;YAClC,MAAM,cAAc,GAAG,IAAA,iCAAoB,EAAC,mBAAmB,CAAC,CAAA;YAChE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;SAC1C;IACH,CAAC;IAED,KAAK;QACH,OAAO,IAAI,cAAK,CAAC;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,gCAAY;YACxB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,gBAAgB,EAAE,EAAE;SACrB,CAAC,CAAA;IACJ,CAAC;IAEO,oBAAoB,CAC1B,mBAA2B,EAC3B,WAAwB;QAExB,MAAM,YAAY,GAAG,mBAAmB,mBAAmB,mBAAmB,CAAA;QAC9E,MAAM,oBAAoB,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAA;QAC3D,MAAM,uBAAuB,GAAG,IAAI,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAA;QAC5E,MAAM,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAA;QACvD,OAAO,GAAG,YAAY,OAAO,oBAAoB,OAAO,uBAAuB,OAAO,kBAAkB,EAAE,CAAA;IAC5G,CAAC;IAEO,0BAA0B,CAAC,WAAwB;QACzD,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;aACtD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC;aACzC,IAAI,CAAC,IAAI,CAAC,CAAA;QACb,OAAO,mBAAmB,qBAAqB,mBAAmB,CAAA;IACpE,CAAC;IAEO,uBAAuB;QAC7B,MAAM,QAAQ,GAAG,iBAAiB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAA;QAC5D,OAAO,eAAe,QAAQ,eAAe,CAAA;IAC/C,CAAC;IAEO,qBAAqB;QAC3B,MAAM,OAAO,GAAG;YACd,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,kCAAkC;qBACzC;iBACF;aACF;SACF,CAAA;QACD,MAAM,MAAM,GAAG,yIAAyI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,CAAA;QAC7L,OAAO,aAAa,MAAM,aAAa,CAAA;IACzC,CAAC;IAEO,eAAe,CAAC,KAAa;QACnC,MAAM,YAAY,GAAW,CAAC,GAAG,sBAAc,CAAC,CAAA;QAChD,OAAO,CAAC,GAAG,YAAY,EAAE,GAAG,KAAK,CAAC,CAAA;IACpC,CAAC;CACF;AA5ED,wCA4EC"}

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

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

package/lib/cjs/guardrails/index.js

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

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

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

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

@@ -0,0 +1,3 @@
+import { InputGuardrail } from '@openai/agents';
+import { GuardrailRule } from '../types';
+export declare function createInputGuardrail(rules: GuardrailRule[]): InputGuardrail;

package/lib/cjs/guardrails/input.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInputGuardrail = void 0;
+const tslib_1 = require("tslib");
+const agents_1 = require("@openai/agents");
+const zod_1 = require("zod");
+function createInputGuardrail(rules) {
+    const outputType = zod_1.z.object(Object.fromEntries(rules.map(rule => [rule.name, zod_1.z.boolean().describe(rule.description)])));
+    const agent = new agents_1.Agent({
+        name: 'InputGuardrail',
+        instructions: 'Check if the user triggers some of the following guardrails.',
+        outputType,
+    });
+    return {
+        name: 'InputGuardrail',
+        execute: ({ input, context }) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const lastMessage = input[input.length - 1];
+            const result = yield (0, agents_1.run)(agent, [lastMessage], { context });
+            const finalOutput = result.finalOutput;
+            if (finalOutput === undefined) {
+                throw new Error('Guardrail agent failed to produce output');
+            }
+            const triggered = Object.values(finalOutput).some(value => value === true);
+            const triggeredGuardrails = Object.keys(finalOutput).filter(key => finalOutput[key] === true);
+            return {
+                outputInfo: triggeredGuardrails,
+                tripwireTriggered: triggered,
+            };
+        }),
+    };
+}
+exports.createInputGuardrail = createInputGuardrail;
+//# sourceMappingURL=input.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../src/guardrails/input.ts"],"names":[],"mappings":";;;;AAAA,2CAA4E;AAC5E,6BAAuB;AAIvB,SAAgB,oBAAoB,CAAC,KAAsB;IACzD,MAAM,UAAU,GAAG,OAAC,CAAC,MAAM,CACzB,MAAM,CAAC,WAAW,CAChB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CACvE,CACF,CAAA;IAED,MAAM,KAAK,GAAG,IAAI,cAAK,CAAC;QACtB,IAAI,EAAE,gBAAgB;QACtB,YAAY,EACV,8DAA8D;QAChE,UAAU;KACX,CAAC,CAAA;IAEF,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,CAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;YACpC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAoB,CAAA;YAC9D,MAAM,MAAM,GAAG,MAAM,IAAA,YAAG,EAAC,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;YAC3D,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAA;YACtC,IAAI,WAAW,KAAK,SAAS,EAAE;gBAC7B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;aAC5D;YACD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAA;YAC1E,MAAM,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CACzD,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,IAAI,CACjC,CAAA;YACD,OAAO;gBACL,UAAU,EAAE,mBAAmB;gBAC/B,iBAAiB,EAAE,SAAS;aAC7B,CAAA;QACH,CAAC,CAAA;KACF,CAAA;AACH,CAAC;AAjCD,oDAiCC"}

package/lib/cjs/index.d.ts

@@ -1,11 +1,11 @@
 import { BotContext, Plugin } from '@botonic/core';
-import { AgenticOutputMessage, AiAgentArgs, CustomTool, PluginAiAgentOptions } from './types';
+import { AiAgentArgs, CustomTool, InferenceResponse, PluginAiAgentOptions } from './types';
 export default class BotonicPluginAiAgents implements Plugin {
     private readonly authToken?;
     toolDefinitions: CustomTool[];
     constructor(options?: PluginAiAgentOptions);
     pre(): void;
-    getInference(request: BotContext, aiAgentArgs: AiAgentArgs): Promise<AgenticOutputMessage[] | undefined>;
+    getInference(request: BotContext, aiAgentArgs: AiAgentArgs): Promise<InferenceResponse>;
     private getMessages;
     private buildTools;
 }

package/lib/cjs/index.js

@@ -26,7 +26,7 @@ class BotonicPluginAiAgents {
                     throw new Error('Auth token is required');
                 }
                 const tools = this.buildTools(((_a = aiAgentArgs.activeTools) === null || _a === void 0 ? void 0 : _a.map(tool => tool.name)) || []);
-                const agent = new agent_builder_1.AIAgentBuilder(aiAgentArgs.name, aiAgentArgs.instructions, tools).build();
+                const agent = new agent_builder_1.AIAgentBuilder(aiAgentArgs.name, aiAgentArgs.instructions, tools, request.session.user.contact_info || {}, aiAgentArgs.inputGuardrailRules || []).build();
                 const messages = yield this.getMessages(request, authToken, 25);
                 const context = {
                     authToken,
@@ -36,6 +36,8 @@ class BotonicPluginAiAgents {
             }
             catch (error) {
                 console.error('error plugin returns undefined', error);
+                // Here we can return a InferenceResponse as a exit
+                // but indicate that the inference failed
                 return undefined;
             }
         });

package/lib/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AACA,2CAAqC;AAErC,mDAAgD;AAChD,2CAAoC;AACpC,6DAAuD;AACvD,qCAAsC;AACtC,qCAAwC;AAWxC,MAAqB,qBAAqB;IAIxC,YAAY,OAA8B;QAFnC,oBAAe,GAAiB,EAAE,CAAA;QAGvC,IAAA,oBAAW,GAAE,CAAA;QACb,IAAI,CAAC,SAAS,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS,CAAA;QACnC,IAAI,CAAC,eAAe,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,KAAI,EAAE,CAAA;IACnD,CAAC;IAED,GAAG;QACD,OAAM;IACR,CAAC;IAEK,YAAY,CAChB,OAAmB,EACnB,WAAwB;;;YAExB,IAAI;gBACF,MAAM,SAAS,GAAG,kBAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAA;gBACzE,IAAI,CAAC,SAAS,EAAE;oBACd,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;iBAC1C;gBAED,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAC3B,CAAA,MAAA,WAAW,CAAC,WAAW,0CAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAI,EAAE,CACtD,CAAA;gBACD,MAAM,KAAK,GAAG,IAAI,8BAAc,CAC9B,WAAW,CAAC,IAAI,EAChB,WAAW,CAAC,YAAY,EACxB,KAAK,CACN,CAAC,KAAK,EAAE,CAAA;gBAET,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAA;gBAC/D,MAAM,OAAO,GAAY;oBACvB,SAAS;iBACV,CAAA;gBAED,MAAM,MAAM,GAAG,IAAI,sBAAa,CAAC,KAAK,CAAC,CAAA;gBACvC,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;aAC3C;YAAC,OAAO,KAAK,EAAE;gBACd,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAA;gBACtD,OAAO,SAAS,CAAA;aACjB;;KACF;IAEa,WAAW,CACvB,OAAmB,EACnB,SAAiB,EACjB,YAAoB;;YAEpB,IAAI,kBAAM,EAAE;gBACV,MAAM,aAAa,GAAG,IAAI,qCAAgB,CAAC,SAAS,CAAC,CAAA;gBACrD,OAAO,MAAM,aAAa,CAAC,WAAW,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;aAC9D;YACD,MAAM,aAAa,GAAG,IAAI,qCAAgB,CAAC,SAAS,CAAC,CAAA;YACrD,OAAO,MAAM,aAAa,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAA;QAC3D,CAAC;KAAA;IAEO,UAAU,CAAC,eAAyB;QAC1C,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CACxD,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CACpC,CAAA;QACD,OAAO,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE;YACzC,OAAO,IAAA,aAAI,EAAoB;gBAC7B,IAAI,EAAE,cAAc,CAAC,IAAI;gBACzB,WAAW,EAAE,cAAc,CAAC,WAAW;gBACvC,UAAU,EAAE,cAAc,CAAC,MAAM;gBACjC,OAAO,EAAE,cAAc,CAAC,IAAI;aAC7B,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;CACF;AAxED,wCAwEC;AAED,kDAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/lib/cjs/runner.d.ts

@@ -1,7 +1,8 @@
-import { AgenticInputMessage, AgenticOutputMessage, AIAgent, Context } from './types';
+import { AgenticInputMessage, AIAgent, Context, RunResult } from './types';
 export declare class AIAgentRunner {
     private agent;
     constructor(agent: AIAgent);
-    run(messages: AgenticInputMessage[], context: Context, maxRetries?: number): Promise<AgenticOutputMessage[]>;
+    run(messages: AgenticInputMessage[], context: Context, maxRetries?: number): Promise<RunResult>;
     private runWithRetry;
+    private getExecutedNameTools;
 }

package/lib/cjs/runner.js

@@ -20,9 +20,30 @@ class AIAgentRunner {
                     modelSettings: { temperature: 0 },
                 });
                 const result = yield runner.run(this.agent, messages, { context });
-                return ((_a = result.finalOutput) === null || _a === void 0 ? void 0 : _a.messages) || [];
+                const outputMessages = ((_a = result.finalOutput) === null || _a === void 0 ? void 0 : _a.messages) || [];
+                const hasExit = outputMessages.length === 0 ||
+                    outputMessages.some(message => message.type === 'exit');
+                const toolsExecuted = this.getExecutedNameTools(result);
+                return {
+                    messages: hasExit
+                        ? []
+                        : outputMessages.filter(message => message.type !== 'exit'),
+                    toolsExecuted,
+                    exit: hasExit,
+                    inputGuardrailTriggered: [],
+                    outputGuardrailTriggered: [],
+                };
             }
             catch (error) {
+                if (error instanceof agents_1.InputGuardrailTripwireTriggered) {
+                    return {
+                        messages: [],
+                        toolsExecuted: [],
+                        exit: true,
+                        inputGuardrailTriggered: error.result.output.outputInfo,
+                        outputGuardrailTriggered: [],
+                    };
+                }
                 if (attempt > maxRetries) {
                     throw error;
                 }
@@ -30,6 +51,15 @@ class AIAgentRunner {
             }
         });
     }
+    getExecutedNameTools(result) {
+        var _a;
+        return (((_a = result.newItems) === null || _a === void 0 ? void 0 : _a.filter(item => item instanceof agents_1.RunToolCallItem).map((item) => {
+            if (item.rawItem.type === 'function_call') {
+                return item.rawItem.name;
+            }
+            return '';
+        }).filter((toolName) => toolName !== '')) || []);
+    }
 }
 exports.AIAgentRunner = AIAgentRunner;
 //# sourceMappingURL=runner.js.map

package/lib/cjs/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/runner.ts"],"names":[],"mappings":";;;;AAAA,2CAAuC;AASvC,MAAa,aAAa;IAGxB,YAAY,KAAc;QACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAEK,GAAG,CACP,QAA+B,EAC/B,OAAgB,EAChB,aAAqB,CAAC;;YAEtB,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;QAC5D,CAAC;KAAA;IAEa,YAAY,CACxB,QAA+B,EAC/B,OAAgB,EAChB,UAAkB,EAClB,OAAe;;;YAEf,IAAI;gBACF,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC;oBACxB,aAAa,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE;iBAClC,CAAC,CAAA;gBACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;gBAClE,OAAO,CAAA,MAAA,MAAM,CAAC,WAAW,0CAAE,QAAQ,KAAI,EAAE,CAAA;aAC1C;YAAC,OAAO,KAAK,EAAE;gBACd,IAAI,OAAO,GAAG,UAAU,EAAE;oBACxB,MAAM,KAAK,CAAA;iBACZ;gBACD,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,CAAC,CAAC,CAAA;aACrE;;KACF;CACF;AAlCD,sCAkCC"}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/runner.ts"],"names":[],"mappings":";;;;AAAA,2CAIuB;AAUvB,MAAa,aAAa;IAGxB,YAAY,KAAc;QACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAEK,GAAG,CACP,QAA+B,EAC/B,OAAgB,EAChB,aAAqB,CAAC;;YAEtB,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;QAC5D,CAAC;KAAA;IAEa,YAAY,CACxB,QAA+B,EAC/B,OAAgB,EAChB,UAAkB,EAClB,OAAe;;;YAEf,IAAI;gBACF,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC;oBACxB,aAAa,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE;iBAClC,CAAC,CAAA;gBACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;gBAElE,MAAM,cAAc,GAAG,CAAA,MAAA,MAAM,CAAC,WAAW,0CAAE,QAAQ,KAAI,EAAE,CAAA;gBACzD,MAAM,OAAO,GACX,cAAc,CAAC,MAAM,KAAK,CAAC;oBAC3B,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAA;gBACzD,MAAM,aAAa,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAA;gBAEvD,OAAO;oBACL,QAAQ,EAAE,OAAO;wBACf,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAE,cAAc,CAAC,MAAM,CACpB,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CACR;oBAChC,aAAa;oBACb,IAAI,EAAE,OAAO;oBACb,uBAAuB,EAAE,EAAE;oBAC3B,wBAAwB,EAAE,EAAE;iBAC7B,CAAA;aACF;YAAC,OAAO,KAAK,EAAE;gBACd,IAAI,KAAK,YAAY,wCAA+B,EAAE;oBACpD,OAAO;wBACL,QAAQ,EAAE,EAAE;wBACZ,aAAa,EAAE,EAAE;wBACjB,IAAI,EAAE,IAAI;wBACV,uBAAuB,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU;wBACvD,wBAAwB,EAAE,EAAE;qBAC7B,CAAA;iBACF;gBACD,IAAI,OAAO,GAAG,UAAU,EAAE;oBACxB,MAAM,KAAK,CAAA;iBACZ;gBACD,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,CAAC,CAAC,CAAA;aACrE;;KACF;IAEO,oBAAoB,CAAC,MAAM;;QACjC,OAAO,CACL,CAAA,MAAA,MAAM,CAAC,QAAQ,0CACX,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,YAAY,wBAAe,EAC/C,GAAG,CAAC,CAAC,IAAqB,EAAE,EAAE;YAC7B,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,eAAe,EAAE;gBACzC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAA;aACzB;YACD,OAAO,EAAE,CAAA;QACX,CAAC,EACA,MAAM,CAAC,CAAC,QAAgB,EAAE,EAAE,CAAC,QAAQ,KAAK,EAAE,CAAC,KAAI,EAAE,CACvD,CAAA;IACH,CAAC;CACF;AA1ED,sCA0EC"}

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

@@ -1,20 +1,6 @@
+import { CarouselMessage } from '@botonic/core';
 import { z } from 'zod';
-import { BaseMessage } from './shared';
-interface CarouselElement {
-    title: string;
-    subtitle: string;
-    image: string;
-    button: {
-        text: string;
-        url: string;
-    };
-}
-export interface CarouselMessage extends BaseMessage {
-    type: 'carousel';
-    content: {
-        elements: CarouselElement[];
-    };
-}
+export type { CarouselMessage };
 export declare const CarouselSchema: z.ZodObject<{
     type: z.ZodEnum<["carousel"]>;
     content: z.ZodObject<{
@@ -97,4 +83,3 @@ export declare const CarouselSchema: z.ZodObject<{
         }[];
     };
 }>;
-export {};

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

@@ -1 +1 @@
-{"version":3,"file":"carousel.js","sourceRoot":"","sources":["../../../src/structured-output/carousel.ts"],"names":[],"mappings":";;;AAAA,6BAAuB;AAkBV,QAAA,cAAc,GAAG,OAAC;KAC5B,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC;IAC1B,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAC,CAAC,KAAK,CACf,OAAC,CAAC,MAAM,CAAC;YACP,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;YACpB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;gBACf,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;gBAChB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;aAChB,CAAC;SACH,CAAC,CACH;KACF,CAAC;CACH,CAAC;KACD,QAAQ,CAAC,kDAAkD,CAAC,CAAA"}
+{"version":3,"file":"carousel.js","sourceRoot":"","sources":["../../../src/structured-output/carousel.ts"],"names":[],"mappings":";;;AACA,6BAAuB;AAIV,QAAA,cAAc,GAAG,OAAC;KAC5B,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC;IAC1B,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAC,CAAC,KAAK,CACf,OAAC,CAAC,MAAM,CAAC;YACP,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;YACpB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;gBACf,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;gBAChB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;aAChB,CAAC;SACH,CAAC,CACH;KACF,CAAC;CACH,CAAC;KACD,QAAQ,CAAC,kDAAkD,CAAC,CAAA"}

package/lib/cjs/structured-output/exit.d.ts

@@ -1,8 +1,6 @@
+import { ExitMessage } from '@botonic/core';
 import z from 'zod';
-import { BaseMessage } from './shared';
-export interface ExitMessage extends BaseMessage {
-    type: 'exit';
-}
+export type { ExitMessage };
 export declare const ExitSchema: z.ZodObject<{
     type: z.ZodEnum<["exit"]>;
 }, "strip", z.ZodTypeAny, {

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

@@ -1 +1 @@
-{"version":3,"file":"exit.js","sourceRoot":"","sources":["../../../src/structured-output/exit.ts"],"names":[],"mappings":";;;;AAAA,sDAAmB;AAQN,QAAA,UAAU,GAAG,aAAC;KACxB,MAAM,CAAC;IACN,IAAI,EAAE,aAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;KACD,QAAQ,CACP,uIAAuI,CACxI,CAAA"}
+{"version":3,"file":"exit.js","sourceRoot":"","sources":["../../../src/structured-output/exit.ts"],"names":[],"mappings":";;;;AACA,sDAAmB;AAIN,QAAA,UAAU,GAAG,aAAC;KACxB,MAAM,CAAC;IACN,IAAI,EAAE,aAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;KACD,QAAQ,CACP,uIAAuI,CACxI,CAAA"}

package/lib/cjs/structured-output/index.d.ts

@@ -1,9 +1,5 @@
+import { OutputMessage } from '@botonic/core';
 import { z } from 'zod';
-import { CarouselMessage } from './carousel';
-import { ExitMessage } from './exit';
-import { TextMessage } from './text';
-import { TextWithButtonsMessage } from './text-with-buttons';
-export type OutputMessage = TextMessage | TextWithButtonsMessage | CarouselMessage | ExitMessage;
 export interface Output {
     messages: OutputMessage[];
 }

package/lib/cjs/structured-output/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/structured-output/index.ts"],"names":[],"mappings":";;;AAAA,6BAAuB;AAEvB,yCAA4D;AAC5D,iCAAgD;AAChD,iCAAgD;AAChD,2DAG4B;AAYf,QAAA,YAAY,GAAG,OAAC;KAC1B,MAAM,CAAC;IACN,QAAQ,EAAE,OAAC,CAAC,KAAK,CACf,OAAC,CAAC,KAAK,CAAC,CAAC,iBAAU,EAAE,yCAAqB,EAAE,yBAAc,EAAE,iBAAU,CAAC,CAAC,CACzE;CACF,CAAC;KACD,QAAQ,CAAC,qCAAqC,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/structured-output/index.ts"],"names":[],"mappings":";;;AACA,6BAAuB;AAEvB,yCAA2C;AAC3C,iCAAmC;AACnC,iCAAmC;AACnC,2DAA2D;AAM9C,QAAA,YAAY,GAAG,OAAC;KAC1B,MAAM,CAAC;IACN,QAAQ,EAAE,OAAC,CAAC,KAAK,CACf,OAAC,CAAC,KAAK,CAAC,CAAC,iBAAU,EAAE,yCAAqB,EAAE,yBAAc,EAAE,iBAAU,CAAC,CAAC,CACzE;CACF,CAAC;KACD,QAAQ,CAAC,qCAAqC,CAAC,CAAA"}

package/lib/cjs/structured-output/text-with-buttons.d.ts

@@ -1,12 +1,6 @@
+import { TextWithButtonsMessage } from '@botonic/core';
 import z from 'zod';
-import { BaseMessage } from './shared';
-export interface TextWithButtonsMessage extends BaseMessage {
-    type: 'textWithButtons';
-    content: {
-        text: string;
-        buttons: string[];
-    };
-}
+export type { TextWithButtonsMessage };
 export declare const TextWithButtonsSchema: z.ZodObject<{
     type: z.ZodEnum<["textWithButtons"]>;
     content: z.ZodObject<{

package/lib/cjs/structured-output/text-with-buttons.js.map

@@ -1 +1 @@
-{"version":3,"file":"text-with-buttons.js","sourceRoot":"","sources":["../../../src/structured-output/text-with-buttons.ts"],"names":[],"mappings":";;;;AAAA,sDAAmB;AAYN,QAAA,qBAAqB,GAAG,aAAC;KACnC,MAAM,CAAC;IACN,IAAI,EAAE,aAAC,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACjC,OAAO,EAAE,aAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,aAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,aAAC,CAAC,KAAK,CAAC,aAAC,CAAC,MAAM,EAAE,CAAC;KAC7B,CAAC;CACH,CAAC;KACD,QAAQ,CACP,oEAAoE,CACrE,CAAA"}
+{"version":3,"file":"text-with-buttons.js","sourceRoot":"","sources":["../../../src/structured-output/text-with-buttons.ts"],"names":[],"mappings":";;;;AACA,sDAAmB;AAIN,QAAA,qBAAqB,GAAG,aAAC;KACnC,MAAM,CAAC;IACN,IAAI,EAAE,aAAC,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACjC,OAAO,EAAE,aAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,aAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,aAAC,CAAC,KAAK,CAAC,aAAC,CAAC,MAAM,EAAE,CAAC;KAC7B,CAAC;CACH,CAAC;KACD,QAAQ,CACP,oEAAoE,CACrE,CAAA"}

package/lib/cjs/structured-output/text.d.ts

@@ -1,11 +1,6 @@
+import { TextMessage } from '@botonic/core';
 import { z } from 'zod';
-import { BaseMessage } from './shared';
-export interface TextMessage extends BaseMessage {
-    type: 'text';
-    content: {
-        text: string;
-    };
-}
+export type { TextMessage };
 export declare const TextSchema: z.ZodObject<{
     type: z.ZodEnum<["text"]>;
     content: z.ZodObject<{

package/lib/cjs/structured-output/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/structured-output/text.ts"],"names":[],"mappings":";;;AAAA,6BAAuB;AAWV,QAAA,UAAU,GAAG,OAAC;KACxB,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;IACtB,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;KACjB,CAAC;CACH,CAAC;KACD,QAAQ,CAAC,gBAAgB,CAAC,CAAA"}
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/structured-output/text.ts"],"names":[],"mappings":";;;AACA,6BAAuB;AAIV,QAAA,UAAU,GAAG,OAAC;KACxB,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;IACtB,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;KACjB,CAAC;CACH,CAAC;KACD,QAAQ,CAAC,gBAAgB,CAAC,CAAA"}

package/lib/cjs/types.d.ts

@@ -1,15 +1,22 @@
-import { Agent, AgentInputItem, RunContext, Tool as OpenAITool } from '@openai/agents';
+import { AgenticOutputMessage, InferenceResponse, RunResult } from '@botonic/core';
+import { Agent, AgentInputItem, RunContext as OpenAIRunContext, Tool as OpenAITool } from '@openai/agents';
 import { ZodSchema } from 'zod';
-import { OutputMessage, OutputSchema } from './structured-output';
+import { OutputSchema } from './structured-output';
 export interface Context {
     authToken: string;
 }
+export type RunContext = OpenAIRunContext<Context>;
 export interface CustomTool {
     name: string;
     description: string;
     schema: ZodSchema;
-    func: (input?: any, runContext?: RunContext<Context>) => Promise<any>;
+    func: (input?: any, runContext?: RunContext) => Promise<any>;
 }
+export interface GuardrailRule {
+    name: string;
+    description: string;
+}
+export type ContactInfo = Record<string, string>;
 export type Tool = OpenAITool<Context>;
 export type AIAgent = Agent<Context, typeof OutputSchema>;
 export interface PluginAiAgentOptions {
@@ -22,6 +29,7 @@ export interface AiAgentArgs {
     activeTools?: {
         name: string;
     }[];
+    inputGuardrailRules?: GuardrailRule[];
 }
 export type AgenticInputMessage = AgentInputItem;
-export type AgenticOutputMessage = OutputMessage;
+export type { AgenticOutputMessage, InferenceResponse, RunResult };

package/lib/esm/agent-builder.d.ts

@@ -1,10 +1,14 @@
-import { AIAgent, Tool } from './types';
+import { AIAgent, ContactInfo, GuardrailRule, Tool } from './types';
 export declare class AIAgentBuilder {
     private name;
     private instructions;
     private tools;
-    constructor(name: string, instructions: string, tools: Tool[]);
+    private inputGuardrails;
+    constructor(name: string, instructions: string, tools: Tool[], contactInfo: ContactInfo, inputGuardrailRules: GuardrailRule[]);
     build(): AIAgent;
     private addExtraInstructions;
+    private getContactInfoInstructions;
+    private getMetadataInstructions;
+    private getOutputInstructions;
     private addHubtypeTools;
 }