@botonic/plugin-ai-agents 0.57.0-rslib-esm.2 → 0.57.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"carousel.js","sourceRoot":"","sources":["../../../src/structured-output/carousel.ts"],"names":[],"mappings":";;;AAAA,wCAAuE;AACvE,6BAAuB;AAIV,QAAA,cAAc,GAAG,OAAC;KAC5B,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,wBAAiB,CAAC,QAAQ,CAAC;IAC3C,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACtC,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,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;aACtC,CAAC;SACH,CAAC,CACH;KACF,CAAC;CACH,CAAC;KACD,QAAQ,CAAC,kDAAkD,CAAC,CAAA"}

package/lib/cjs/structured-output/do-nothing.d.ts

@@ -0,0 +1,6 @@
+import { type DoNothingMessage, OutputMessageType } from '@botonic/core';
+import { z } from 'zod';
+export type { DoNothingMessage };
+export declare const DoNothingSchema: z.ZodObject<{
+    type: z.ZodLiteral<OutputMessageType.DoNothing>;
+}, z.core.$strip>;

package/lib/cjs/structured-output/do-nothing.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DoNothingSchema = void 0;
+const core_1 = require("@botonic/core");
+const zod_1 = require("zod");
+exports.DoNothingSchema = zod_1.z
+    .object({
+    type: zod_1.z.literal(core_1.OutputMessageType.DoNothing),
+})
+    .describe('A do nothing message is used to end the conversation without send a reply. Use it only when asked explicitly in the prompt.');
+//# sourceMappingURL=do-nothing.js.map

package/lib/cjs/structured-output/do-nothing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-nothing.js","sourceRoot":"","sources":["../../../src/structured-output/do-nothing.ts"],"names":[],"mappings":";;;AAAA,wCAAwE;AACxE,6BAAuB;AAIV,QAAA,eAAe,GAAG,OAAC;KAC7B,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,wBAAiB,CAAC,SAAS,CAAC;CAC7C,CAAC;KACD,QAAQ,CACP,6HAA6H,CAC9H,CAAA"}

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

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExitSchema = void 0;
+const core_1 = require("@botonic/core");
+const zod_1 = require("zod");
+exports.ExitSchema = zod_1.z
+    .object({
+    type: zod_1.z.literal(core_1.OutputMessageType.Exit),
+})
+    .describe('An exit message. This message should only be used to exit the agent due to out of context or the user asking to exit the conversation');
+//# sourceMappingURL=exit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exit.js","sourceRoot":"","sources":["../../../src/structured-output/exit.ts"],"names":[],"mappings":";;;AAAA,wCAAmE;AACnE,6BAAuB;AAIV,QAAA,UAAU,GAAG,OAAC;KACxB,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,wBAAiB,CAAC,IAAI,CAAC;CACxC,CAAC;KACD,QAAQ,CACP,uIAAuI,CACxI,CAAA"}

package/lib/{structured-output → cjs/structured-output}/index.d.ts

@@ -36,6 +36,8 @@ export declare const OutputSchema: z.ZodObject<{
                 }, z.core.$strip>;
             }, z.core.$strip>>;
         }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<import("@botonic/core").OutputMessageType.DoNothing>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<import("@botonic/core").OutputMessageType.Exit>;
     }, z.core.$strip>, z.ZodObject<{
@@ -87,6 +89,8 @@ export declare function getOutputSchema(externalOutputMessagesSchemas: z.ZodObje
                 }, z.core.$strip>;
             }, z.core.$strip>>;
         }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<import("@botonic/core").OutputMessageType.DoNothing>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<import("@botonic/core").OutputMessageType.Exit>;
     }, z.core.$strip>, z.ZodObject<{

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutputSchema = void 0;
+exports.getOutputSchema = getOutputSchema;
+exports.getOutputInstructions = getOutputInstructions;
+const zod_1 = require("zod");
+const bot_executor_1 = require("./bot-executor");
+const carousel_1 = require("./carousel");
+const do_nothing_1 = require("./do-nothing");
+const exit_1 = require("./exit");
+const request_contact_info_1 = require("./request-contact-info");
+const text_1 = require("./text");
+const text_with_buttons_1 = require("./text-with-buttons");
+const baseMessageSchemas = [
+    text_1.TextSchema,
+    text_with_buttons_1.TextWithButtonsSchema,
+    carousel_1.CarouselSchema,
+    do_nothing_1.DoNothingSchema,
+    exit_1.ExitSchema,
+    bot_executor_1.BotExecutorSchema,
+    request_contact_info_1.RequestContactInfoSchema,
+];
+exports.OutputSchema = zod_1.z
+    .object({
+    messages: zod_1.z.array(zod_1.z.union(baseMessageSchemas)),
+})
+    .describe('The messages to be sent to the user');
+function getOutputSchema(externalOutputMessagesSchemas) {
+    return zod_1.z.object({
+        messages: zod_1.z.array(zod_1.z.union([...baseMessageSchemas, ...externalOutputMessagesSchemas])),
+    });
+}
+function getOutputInstructions() {
+    const example = {
+        messages: [
+            {
+                type: 'text',
+                content: {
+                    text: 'Hello, how can I help you today?',
+                },
+            },
+        ],
+    };
+    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 `<output>\n${output}\n</output>`;
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/structured-output/index.ts"],"names":[],"mappings":";;;AA6BA,0CAQC;AAED,sDAaC;AAnDD,6BAAuB;AACvB,iDAAkD;AAClD,yCAA2C;AAC3C,6CAA8C;AAC9C,iCAAmC;AACnC,iEAAiE;AACjE,iCAAmC;AACnC,2DAA2D;AAM3D,MAAM,kBAAkB,GAAG;IACzB,iBAAU;IACV,yCAAqB;IACrB,yBAAc;IACd,4BAAe;IACf,iBAAU;IACV,gCAAiB;IACjB,+CAAwB;CAChB,CAAA;AACG,QAAA,YAAY,GAAG,OAAC;KAC1B,MAAM,CAAC;IACN,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;CAC/C,CAAC;KACD,QAAQ,CAAC,qCAAqC,CAAC,CAAA;AAElD,SAAgB,eAAe,CAC7B,6BAAiD;IAEjD,OAAO,OAAC,CAAC,MAAM,CAAC;QACd,QAAQ,EAAE,OAAC,CAAC,KAAK,CACf,OAAC,CAAC,KAAK,CAAC,CAAC,GAAG,kBAAkB,EAAE,GAAG,6BAA6B,CAAC,CAAC,CACnE;KACF,CAAC,CAAA;AACJ,CAAC;AAED,SAAgB,qBAAqB;IACnC,MAAM,OAAO,GAAG;QACd,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,kCAAkC;iBACzC;aACF;SACF;KACF,CAAA;IACD,MAAM,MAAM,GAAG,yIAAyI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,CAAA;IAC7L,OAAO,aAAa,MAAM,aAAa,CAAA;AACzC,CAAC"}

package/lib/cjs/structured-output/request-contact-info.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestContactInfoSchema = void 0;
+const core_1 = require("@botonic/core");
+const zod_1 = require("zod");
+exports.RequestContactInfoSchema = zod_1.z
+    .object({
+    type: zod_1.z.literal(core_1.OutputMessageType.RequestContactInfo),
+    content: zod_1.z.object({
+        text: zod_1.z.string().describe('The text of the message'),
+    }),
+})
+    .describe('A message to request phone number from the user. Use it only when asked explicitly in the prompt.');
+//# sourceMappingURL=request-contact-info.js.map

package/lib/cjs/structured-output/request-contact-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-contact-info.js","sourceRoot":"","sources":["../../../src/structured-output/request-contact-info.ts"],"names":[],"mappings":";;;AAAA,wCAGsB;AACtB,6BAAuB;AAIV,QAAA,wBAAwB,GAAG,OAAC;KACtC,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,wBAAiB,CAAC,kBAAkB,CAAC;IACrD,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;KACrD,CAAC;CACH,CAAC;KACD,QAAQ,CACP,mGAAmG,CACpG,CAAA"}

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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextWithButtonsSchema = void 0;
+const core_1 = require("@botonic/core");
+const zod_1 = require("zod");
+exports.TextWithButtonsSchema = zod_1.z
+    .object({
+    type: zod_1.z.literal(core_1.OutputMessageType.TextWithButtons),
+    content: zod_1.z.object({
+        text: zod_1.z.string(),
+        buttons: zod_1.z.array(zod_1.z.object({
+            text: zod_1.z.string(),
+            url: zod_1.z.string().nullable().optional(),
+            target: zod_1.z
+                .enum(['_blank', '_self'])
+                .default('_blank')
+                .nullable()
+                .optional()
+                .describe('The target of the button when it has an url. If not provided, it will default to _blank.'),
+        })),
+    }),
+})
+    .describe('A text message with buttons to allow the user to use quick replies');
+//# sourceMappingURL=text-with-buttons.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-with-buttons.js","sourceRoot":"","sources":["../../../src/structured-output/text-with-buttons.ts"],"names":[],"mappings":";;;AAAA,wCAA8E;AAC9E,6BAAuB;AAIV,QAAA,qBAAqB,GAAG,OAAC;KACnC,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,wBAAiB,CAAC,eAAe,CAAC;IAClD,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;QAChB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,OAAC,CAAC,KAAK,CACd,OAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;YAChB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;YACrC,MAAM,EAAE,OAAC;iBACN,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;iBACzB,OAAO,CAAC,QAAQ,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CACP,0FAA0F,CAC3F;SACJ,CAAC,CACH;KACF,CAAC;CACH,CAAC;KACD,QAAQ,CACP,oEAAoE,CACrE,CAAA"}

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextSchema = void 0;
+const core_1 = require("@botonic/core");
+const zod_1 = require("zod");
+exports.TextSchema = zod_1.z
+    .object({
+    type: zod_1.z.literal(core_1.OutputMessageType.Text),
+    content: zod_1.z.object({
+        text: zod_1.z.string(),
+    }),
+})
+    .describe('A text message');
+//# sourceMappingURL=text.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/structured-output/text.ts"],"names":[],"mappings":";;;AAAA,wCAAmE;AACnE,6BAAuB;AAIV,QAAA,UAAU,GAAG,OAAC;KACxB,MAAM,CAAC;IACN,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,wBAAiB,CAAC,IAAI,CAAC;IACvC,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/{tools → cjs/tools}/index.d.ts

@@ -1,3 +1,3 @@
-import type { Tool } from '../types.js';
-export { createRetrieveKnowledge, RETRIEVE_KNOWLEDGE_TOOL_NAME, } from './retrieve-knowledge.js';
+import type { Tool } from '../types';
+export { createRetrieveKnowledge, RETRIEVE_KNOWLEDGE_TOOL_NAME, } from './retrieve-knowledge';
 export declare const mandatoryTools: Tool[];

package/lib/cjs/tools/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mandatoryTools = exports.RETRIEVE_KNOWLEDGE_TOOL_NAME = exports.createRetrieveKnowledge = void 0;
+var retrieve_knowledge_1 = require("./retrieve-knowledge");
+Object.defineProperty(exports, "createRetrieveKnowledge", { enumerable: true, get: function () { return retrieve_knowledge_1.createRetrieveKnowledge; } });
+Object.defineProperty(exports, "RETRIEVE_KNOWLEDGE_TOOL_NAME", { enumerable: true, get: function () { return retrieve_knowledge_1.RETRIEVE_KNOWLEDGE_TOOL_NAME; } });
+exports.mandatoryTools = [];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":";;;AAEA,2DAG6B;AAF3B,6HAAA,uBAAuB,OAAA;AACvB,kIAAA,4BAA4B,OAAA;AAGjB,QAAA,cAAc,GAAW,EAAE,CAAA"}

package/lib/{tools → cjs/tools}/retrieve-knowledge.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import type { Context } from '../types.js';
+import type { Context } from '../types';
 export declare const RETRIEVE_KNOWLEDGE_TOOL_NAME = "retrieve_knowledge";
-export declare const createRetrieveKnowledge: (sourceIds: string[]) => import("@openai/agents-core").FunctionTool<Context<import("@botonic/core").ResolvedPlugins, any>, z.ZodObject<{
+export declare const createRetrieveKnowledge: (sourceIds: string[]) => import("@openai/agents").FunctionTool<Context<import("@botonic/core").ResolvedPlugins, any>, z.ZodObject<{
     query: z.ZodString;
 }, z.core.$strip>, string>;

package/lib/cjs/tools/retrieve-knowledge.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRetrieveKnowledge = exports.RETRIEVE_KNOWLEDGE_TOOL_NAME = void 0;
+const agents_1 = require("@openai/agents");
+const zod_1 = require("zod");
+const hubtype_api_client_1 = require("../services/hubtype-api-client");
+exports.RETRIEVE_KNOWLEDGE_TOOL_NAME = 'retrieve_knowledge';
+const createRetrieveKnowledge = (sourceIds) => (0, agents_1.tool)({
+    name: exports.RETRIEVE_KNOWLEDGE_TOOL_NAME,
+    description: 'Consult the knowledge base for information before answering. Use this tool to make sure the information you provide is faithful.',
+    parameters: zod_1.z.object({
+        query: zod_1.z.string().describe('The query to search the knowledge base for'),
+    }),
+    execute: async (input, runContext) => {
+        const context = runContext?.context;
+        const query = input.query;
+        if (!context) {
+            throw new Error('Context is required');
+        }
+        const client = new hubtype_api_client_1.HubtypeApiClient(context.authToken);
+        const chunks = await client.retrieveSimilarChunks(query, sourceIds);
+        const chunksIds = chunks.map(chunk => chunk.id);
+        const chunkTexts = chunks.map(chunk => chunk.text);
+        context.knowledgeUsed = {
+            query,
+            sourceIds,
+            chunksIds,
+            chunkTexts,
+        };
+        return chunkTexts;
+    },
+});
+exports.createRetrieveKnowledge = createRetrieveKnowledge;
+//# sourceMappingURL=retrieve-knowledge.js.map

package/lib/cjs/tools/retrieve-knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-knowledge.js","sourceRoot":"","sources":["../../../src/tools/retrieve-knowledge.ts"],"names":[],"mappings":";;;AAAA,2CAAsD;AACtD,6BAAuB;AAEvB,uEAAiE;AAGpD,QAAA,4BAA4B,GAAG,oBAAoB,CAAA;AAEzD,MAAM,uBAAuB,GAAG,CAAC,SAAmB,EAAE,EAAE,CAC7D,IAAA,aAAI,EAAC;IACH,IAAI,EAAE,oCAA4B;IAClC,WAAW,EACT,kIAAkI;IACpI,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;KACzE,CAAC;IACF,OAAO,EAAE,KAAK,EACZ,KAAwB,EACxB,UAAgC,EACb,EAAE;QACrB,MAAM,OAAO,GAAG,UAAU,EAAE,OAAO,CAAA;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;QACzB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;QACxC,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,qCAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QACtD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QACnE,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAElD,OAAO,CAAC,aAAa,GAAG;YACtB,KAAK;YACL,SAAS;YACT,SAAS;YACT,UAAU;SACX,CAAA;QAED,OAAO,UAAU,CAAA;IACnB,CAAC;CACF,CAAC,CAAA;AA/BS,QAAA,uBAAuB,2BA+BhC"}

package/lib/{types.d.ts → cjs/types.d.ts}

@@ -1,7 +1,7 @@
 import type { AgenticOutputMessage, AiAgentArgs, BotContext, GuardrailRule, InferenceResponse, ResolvedPlugins, RunResult } from '@botonic/core';
 import type { Agent, AgentInputItem, AgentOutputType, RunContext as OpenAIRunContext, Tool as OpenAITool } from '@openai/agents';
 import type { ZodType } from 'zod';
-import type { OutputSchema } from './structured-output/index.js';
+import type { OutputSchema } from './structured-output';
 export interface Context<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = any> {
     authToken: string;
     knowledgeUsed: {

package/lib/cjs/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/cjs/types.js.map

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

package/lib/esm/agents/base-agent.d.ts

@@ -0,0 +1,28 @@
+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';
+export interface BaseAgentOptions {
+    name: string;
+    instructions: string;
+    llmConfig: LLMConfig;
+    inputGuardrailRules: GuardrailRule[];
+    outputMessagesSchemas?: z.ZodObject[];
+    guardrailTrackingContext: GuardrailTrackingContext;
+}
+export declare abstract class BaseAgent {
+    protected name: string;
+    protected instructions: string;
+    protected llmConfig: LLMConfig;
+    private inputGuardrailRules;
+    private outputMessagesSchemas;
+    private guardrailTrackingContext;
+    constructor(options: BaseAgentOptions);
+    protected getAgentModelSettings(): ModelSettings;
+    protected getInputGuardrails(): Promise<InputGuardrail[]>;
+    protected getOutputType(): AgentOutputType<typeof OutputSchema>;
+    protected addOutputInstructions(instructions: string): string;
+    protected getModel(): Promise<string | Model>;
+}

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

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseAgent = void 0;
+const guardrails_1 = require("../guardrails");
+const structured_output_1 = require("../structured-output");
+class BaseAgent {
+    constructor(options) {
+        this.name = options.name;
+        this.instructions = options.instructions;
+        this.llmConfig = options.llmConfig;
+        this.inputGuardrailRules = options.inputGuardrailRules;
+        this.outputMessagesSchemas = options.outputMessagesSchemas || [];
+        this.guardrailTrackingContext = options.guardrailTrackingContext;
+    }
+    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 (0, guardrails_1.createInputGuardrails)(this.inputGuardrailRules, this.llmConfig, this.guardrailTrackingContext);
+    }
+    getOutputType() {
+        return (0, structured_output_1.getOutputSchema)(this.outputMessagesSchemas);
+    }
+    addOutputInstructions(instructions) {
+        return `${instructions}\n\n${(0, structured_output_1.getOutputInstructions)()}`;
+    }
+    async getModel() {
+        return await this.llmConfig.getModel();
+    }
+}
+exports.BaseAgent = BaseAgent;
+//# sourceMappingURL=base-agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-agent.js","sourceRoot":"","sources":["../../../src/agents/base-agent.ts"],"names":[],"mappings":";;;AAQA,8CAAqD;AAGrD,4DAI6B;AAY7B,MAAsB,SAAS;IAQ7B,YAAY,OAAyB;QACnC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;QACxB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAA;QACxC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;QAClC,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAA;QACtD,IAAI,CAAC,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,IAAI,EAAE,CAAA;QAChE,IAAI,CAAC,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAA;IAClE,CAAC;IAES,qBAAqB;QAC7B,MAAM,aAAa,GAAkB,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAA;QAExE,IAAI,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC;YAC3C,aAAa,CAAC,SAAS,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,SAAS,EAAE,CAAA;QACzE,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YACtC,aAAa,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,CAAA;QAC/D,CAAC;QAED,OAAO,aAAa,CAAA;IACtB,CAAC;IAES,KAAK,CAAC,kBAAkB;QAChC,OAAO,MAAM,IAAA,kCAAqB,EAChC,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,wBAAwB,CAC9B,CAAA;IACH,CAAC;IAES,aAAa;QACrB,OAAO,IAAA,mCAAe,EAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;IACpD,CAAC;IAES,qBAAqB,CAAC,YAAoB;QAClD,OAAO,GAAG,YAAY,OAAO,IAAA,yCAAqB,GAAE,EAAE,CAAA;IACxD,CAAC;IAES,KAAK,CAAC,QAAQ;QACtB,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAA;IACxC,CAAC;CACF;AAlDD,8BAkDC"}

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

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

package/lib/esm/agents/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpecialistAgent = exports.RouterAgent = void 0;
+var router_agent_1 = require("./router-agent");
+Object.defineProperty(exports, "RouterAgent", { enumerable: true, get: function () { return router_agent_1.RouterAgent; } });
+var specialist_agent_1 = require("./specialist-agent");
+Object.defineProperty(exports, "SpecialistAgent", { enumerable: true, get: function () { return specialist_agent_1.SpecialistAgent; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":";;;AAAA,+CAA4C;AAAnC,2GAAA,WAAW,OAAA;AACpB,uDAAoD;AAA3C,mHAAA,eAAe,OAAA"}

package/lib/esm/agents/router-agent.d.ts

@@ -0,0 +1,25 @@
+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';
+interface RouterAgentOptions<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = unknown> {
+    name: string;
+    instructions: string;
+    llmConfig: LLMConfig;
+    handoffs: Handoff<Context<TPlugins, TExtraData>, AgentOutputType<typeof OutputSchema>>[];
+    inputGuardrailRules: GuardrailRule[];
+    outputMessagesSchemas?: z.ZodObject[];
+    guardrailTrackingContext: GuardrailTrackingContext;
+}
+export declare class RouterAgent<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = unknown> extends BaseAgent {
+    private handoffs;
+    private agent;
+    private constructor();
+    static create<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = unknown>(options: RouterAgentOptions<TPlugins, TExtraData>): Promise<RouterAgent<TPlugins, TExtraData>>;
+    getAgent(): AIAgent<TPlugins, TExtraData>;
+}
+export {};

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

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouterAgent = void 0;
+const agents_1 = require("@openai/agents");
+const extensions_1 = require("@openai/agents-core/extensions");
+const base_agent_1 = require("./base-agent");
+class RouterAgent extends base_agent_1.BaseAgent {
+    constructor(options) {
+        super(options);
+        this.handoffs = options.handoffs;
+    }
+    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 = agents_1.Agent.create({
+            name: routerAgent.name,
+            model: await routerAgent.getModel(),
+            modelSettings: routerAgent.getAgentModelSettings(),
+            instructions: routerAgent.addOutputInstructions(`${extensions_1.RECOMMENDED_PROMPT_PREFIX}${routerAgent.instructions}`),
+            handoffs: routerAgent.handoffs,
+            outputType: routerAgent.getOutputType(),
+            inputGuardrails,
+        });
+        routerAgent.agent = agent;
+        return routerAgent;
+    }
+    getAgent() {
+        return this.agent;
+    }
+}
+exports.RouterAgent = RouterAgent;
+//# sourceMappingURL=router-agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router-agent.js","sourceRoot":"","sources":["../../../src/agents/router-agent.ts"],"names":[],"mappings":";;;AACA,2CAA0E;AAC1E,+DAA0E;AAM1E,6CAAwC;AAkBxC,MAAa,WAGX,SAAQ,sBAAS;IAOjB,YAAoB,OAAiD;QACnE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;IAClC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAIjB,OAAiD;QAEjD,MAAM,WAAW,GAAG,IAAI,WAAW,CAAuB,OAAO,CAAC,CAAA;QAClE,MAAM,eAAe,GAAG,MAAM,WAAW,CAAC,kBAAkB,EAAE,CAAA;QAE9D,6FAA6F;QAC7F,MAAM,KAAK,GAAG,cAAK,CAAC,MAAM,CAAC;YACzB,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,KAAK,EAAE,MAAM,WAAW,CAAC,QAAQ,EAAE;YACnC,aAAa,EAAE,WAAW,CAAC,qBAAqB,EAAE;YAClD,YAAY,EAAE,WAAW,CAAC,qBAAqB,CAC7C,GAAG,sCAAyB,GAAG,WAAW,CAAC,YAAY,EAAE,CAC1D;YACD,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,UAAU,EAAE,WAAW,CAAC,aAAa,EAAE;YACvC,eAAe;SAChB,CAAkC,CAAA;QAEnC,WAAW,CAAC,KAAK,GAAG,KAAK,CAAA;QACzB,OAAO,WAAW,CAAA;IACpB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;CACF;AA5CD,kCA4CC"}

package/lib/esm/agents/specialist-agent.d.ts

@@ -0,0 +1,39 @@
+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';
+interface SpecialistAgentOptions<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = unknown> {
+    name: string;
+    instructions: string;
+    tools: Tool<TPlugins, TExtraData>[];
+    campaignsContext?: CampaignV2[];
+    contactInfo: ContactInfo[];
+    inputGuardrailRules: GuardrailRule[];
+    sourceIds: string[];
+    outputMessagesSchemas?: z.ZodObject[];
+    llmConfig: LLMConfig;
+    logger: DebugLogger;
+    guardrailTrackingContext: GuardrailTrackingContext;
+    forceToolNameOverride?: string;
+    disableForceRetrieveKnowledge?: boolean;
+}
+export declare class SpecialistAgent<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = unknown> extends BaseAgent {
+    private tools;
+    private logger;
+    private agent;
+    private forceToolNameOverride?;
+    private disableForceRetrieveKnowledge?;
+    private constructor();
+    static create<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData = unknown>(options: SpecialistAgentOptions<TPlugins, TExtraData>): Promise<SpecialistAgent<TPlugins, TExtraData>>;
+    getAgent(): AIAgent<TPlugins, TExtraData>;
+    private getSpecialistModelSettings;
+    private addExtraInstructions;
+    private getContactInfoInstructions;
+    private getMetadataInstructions;
+    private getCampaignInstructions;
+    private addHubtypeTools;
+}
+export {};

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

@@ -0,0 +1,108 @@
+"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,
+        });
+        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;
+    }
+    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 modelSettings = specialistAgent.getSpecialistModelSettings(hasRetrieveKnowledge);
+        const inputGuardrails = await specialistAgent.getInputGuardrails();
+        specialistAgent.logger.logModelSettings({
+            provider: constants_1.LLM_PROVIDER,
+            model,
+            reasoning: modelSettings.reasoning,
+            text: modelSettings.text,
+            toolChoice: modelSettings.toolChoice,
+            hasRetrieveKnowledge,
+        });
+        const agent = new agents_1.Agent({
+            name: specialistAgent.name,
+            model: resolvedModel,
+            modelSettings,
+            instructions: specialistAgent.instructions,
+            tools: specialistAgent.tools,
+            outputType: specialistAgent.getOutputType(),
+            inputGuardrails,
+            outputGuardrails: [],
+        });
+        specialistAgent.agent = agent;
+        return specialistAgent;
+    }
+    getAgent() {
+        return this.agent;
+    }
+    getSpecialistModelSettings(hasRetrieveKnowledge) {
+        const modelSettings = this.getAgentModelSettings();
+        const forceRetrieveKnowledge = hasRetrieveKnowledge &&
+            !this.forceToolNameOverride &&
+            !this.disableForceRetrieveKnowledge;
+        if (forceRetrieveKnowledge) {
+            modelSettings.toolChoice = tools_1.RETRIEVE_KNOWLEDGE_TOOL_NAME;
+        }
+        if (this.forceToolNameOverride) {
+            modelSettings.toolChoice = this.forceToolNameOverride;
+        }
+        return modelSettings;
+    }
+    addExtraInstructions(initialInstructions, contactInfo, campaignsContext) {
+        const sections = [
+            `<instructions>\n${initialInstructions.trim()}\n</instructions>`,
+            this.getMetadataInstructions(),
+            this.getContactInfoInstructions(contactInfo),
+            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>`;
+    }
+    getMetadataInstructions() {
+        const metadata = `Current Date: ${new Date().toISOString()}`;
+        return `<metadata>\n${metadata}\n</metadata>`;
+    }
+    getCampaignInstructions(campaignsContext) {
+        if (!campaignsContext || campaignsContext.length === 0) {
+            return '';
+        }
+        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');
+    }
+    addHubtypeTools(tools, sourceIds) {
+        const hubtypeTools = [...tools_1.mandatoryTools];
+        if (sourceIds.length > 0) {
+            hubtypeTools.push((0, tools_1.createRetrieveKnowledge)(sourceIds));
+        }
+        return [...hubtypeTools, ...tools];
+    }
+}
+exports.SpecialistAgent = SpecialistAgent;
+//# sourceMappingURL=specialist-agent.js.map

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

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

package/lib/esm/bot-config-tools.d.ts

@@ -0,0 +1,7 @@
+import type { ToolConfigJSON } from '@botonic/core';
+import type { CustomTool } from './types';
+/**
+ * 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.
+ */
+export declare function getToolsForBotConfig(customTools: CustomTool[]): ToolConfigJSON[];

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

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getToolsForBotConfig = getToolsForBotConfig;
+const zod_1 = require("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: zod_1.z.toJSONSchema(tool.schema, {
+            target: 'draft-07',
+        }),
+    }));
+}
+//# sourceMappingURL=bot-config-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bot-config-tools.js","sourceRoot":"","sources":["../../src/bot-config-tools.ts"],"names":[],"mappings":";;AASA,oDAUC;AAlBD,6BAAuB;AAIvB;;;GAGG;AACH,SAAgB,oBAAoB,CAClC,WAAyB;IAEzB,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,OAAC,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE;YAClC,MAAM,EAAE,UAAU;SACnB,CAA6B;KAC/B,CAAC,CAAC,CAAA;AACL,CAAC"}