@jterrazz/intelligence 1.5.0 → 2.0.0

package/dist/adapters/agents/{retryable-agent.adapter.js → resilient-agent.adapter.js}

@@ -158,25 +158,25 @@ function _ts_generator(thisArg, body) {
     }
 }
 /**
- * A decorator agent that adds retry logic to an existing agent.
+ * A decorator agent that adds retry logic to an existing agent for resilient execution.
  * @template TInput - The TypeScript type of the input
  * @template TOutput - The TypeScript type of the output
- */ export var RetryableAgentAdapter = /*#__PURE__*/ function() {
+ */ export var ResilientAgent = /*#__PURE__*/ function() {
     "use strict";
-    function RetryableAgentAdapter(agent) {
+    function ResilientAgent(agent) {
         var options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
-        _class_call_check(this, RetryableAgentAdapter);
+        _class_call_check(this, ResilientAgent);
         _define_property(this, "agent", void 0);
         _define_property(this, "name", void 0);
         _define_property(this, "logger", void 0);
         _define_property(this, "retries", void 0);
         this.agent = agent;
         var logger = options.logger, _options_retries = options.retries, retries = _options_retries === void 0 ? 1 : _options_retries;
-        this.name = "Retryable(".concat(agent.name, ")");
+        this.name = "Resilient(".concat(agent.name, ")");
         this.logger = logger;
         this.retries = retries;
     }
-    _create_class(RetryableAgentAdapter, [
+    _create_class(ResilientAgent, [
         {
             key: "run",
             value: function run(input) {
@@ -201,7 +201,9 @@ function _ts_generator(thisArg, body) {
                                     ,
                                     5
                                 ]);
-                                (_this_logger1 = this.logger) === null || _this_logger1 === void 0 ? void 0 : _this_logger1.debug("[".concat(this.name, "] Attempt ").concat(attempt, " of ").concat(maxAttempts, "."));
+                                (_this_logger1 = this.logger) === null || _this_logger1 === void 0 ? void 0 : _this_logger1.debug("Attempt ".concat(attempt, " of ").concat(maxAttempts), {
+                                    agent: this.name
+                                });
                                 return [
                                     4,
                                     this.agent.run(input)
@@ -210,20 +212,25 @@ function _ts_generator(thisArg, body) {
                                 result = _state.sent();
                                 if (result !== null) {
                                     ;
-                                    (_this_logger3 = this.logger) === null || _this_logger3 === void 0 ? void 0 : _this_logger3.info("[".concat(this.name, "] Attempt ").concat(attempt, " of ").concat(maxAttempts, " succeeded."));
+                                    (_this_logger3 = this.logger) === null || _this_logger3 === void 0 ? void 0 : _this_logger3.debug("Attempt ".concat(attempt, " of ").concat(maxAttempts, " succeeded"), {
+                                        agent: this.name
+                                    });
                                     return [
                                         2,
                                         result
                                     ];
                                 }
-                                (_this_logger2 = this.logger) === null || _this_logger2 === void 0 ? void 0 : _this_logger2.warn("[".concat(this.name, "] Attempt ").concat(attempt, " of ").concat(maxAttempts, " failed: agent returned null."));
+                                (_this_logger2 = this.logger) === null || _this_logger2 === void 0 ? void 0 : _this_logger2.debug("Attempt ".concat(attempt, " of ").concat(maxAttempts, " failed: agent returned null"), {
+                                    agent: this.name
+                                });
                                 return [
                                     3,
                                     5
                                 ];
                             case 4:
                                 error = _state.sent();
-                                (_this_logger4 = this.logger) === null || _this_logger4 === void 0 ? void 0 : _this_logger4.warn("[".concat(this.name, "] Attempt ").concat(attempt, " of ").concat(maxAttempts, " failed with an error."), {
+                                (_this_logger4 = this.logger) === null || _this_logger4 === void 0 ? void 0 : _this_logger4.debug("Attempt ".concat(attempt, " of ").concat(maxAttempts, " failed with an error"), {
+                                    agent: this.name,
                                     error: _instanceof(error, Error) ? error.message : 'Unknown error'
                                 });
                                 return [
@@ -237,7 +244,9 @@ function _ts_generator(thisArg, body) {
                                     1
                                 ];
                             case 6:
-                                (_this_logger = this.logger) === null || _this_logger === void 0 ? void 0 : _this_logger.error("[".concat(this.name, "] All ").concat(maxAttempts, " attempts failed."));
+                                (_this_logger = this.logger) === null || _this_logger === void 0 ? void 0 : _this_logger.error("All ".concat(maxAttempts, " attempts failed"), {
+                                    agent: this.name
+                                });
                                 return [
                                     2,
                                     null
@@ -248,7 +257,7 @@ function _ts_generator(thisArg, body) {
             }
         }
     ]);
-    return RetryableAgentAdapter;
+    return ResilientAgent;
 }();
 
-//# sourceMappingURL=retryable-agent.adapter.js.map
+//# sourceMappingURL=resilient-agent.adapter.js.map

package/dist/adapters/agents/resilient-agent.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/agents/resilient-agent.adapter.ts"],"sourcesContent":["import { type LoggerPort } from '@jterrazz/logger';\n\nimport { type AgentPort } from '../../ports/agent.port.js';\nimport type { PromptPort } from '../../ports/prompt.port.js';\n\nexport interface ResilientAgentOptions {\n    logger?: LoggerPort;\n    retries?: number;\n}\n\n/**\n * A decorator agent that adds retry logic to an existing agent for resilient execution.\n * @template TInput - The TypeScript type of the input\n * @template TOutput - The TypeScript type of the output\n */\nexport class ResilientAgent<TInput = PromptPort, TOutput = string>\n    implements AgentPort<TInput, TOutput>\n{\n    public readonly name: string;\n    private readonly logger?: LoggerPort;\n    private readonly retries: number;\n\n    constructor(\n        private readonly agent: AgentPort<TInput, TOutput>,\n        options: ResilientAgentOptions = {},\n    ) {\n        const { logger, retries = 1 } = options;\n        this.name = `Resilient(${agent.name})`;\n        this.logger = logger;\n        this.retries = retries;\n    }\n\n    async run(input?: TInput): Promise<null | TOutput> {\n        const maxAttempts = this.retries + 1;\n\n        for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n            try {\n                this.logger?.debug(`Attempt ${attempt} of ${maxAttempts}`, { agent: this.name });\n                const result = await this.agent.run(input);\n\n                if (result !== null) {\n                    this.logger?.debug(`Attempt ${attempt} of ${maxAttempts} succeeded`, {\n                        agent: this.name,\n                    });\n                    return result;\n                }\n\n                this.logger?.debug(\n                    `Attempt ${attempt} of ${maxAttempts} failed: agent returned null`,\n                    { agent: this.name },\n                );\n            } catch (error) {\n                this.logger?.debug(`Attempt ${attempt} of ${maxAttempts} failed with an error`, {\n                    agent: this.name,\n                    error: error instanceof Error ? error.message : 'Unknown error',\n                });\n            }\n        }\n\n        this.logger?.error(`All ${maxAttempts} attempts failed`, { agent: this.name });\n        return null;\n    }\n}\n"],"names":["ResilientAgent","agent","options","name","logger","retries","run","input","maxAttempts","attempt","result","error","debug","Error","message"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA;;;;CAIC,GACD,OAAO,IAAA,AAAMA,+BAAN;;aAAMA,eAQL,AAAiBC,KAAiC;YAClDC,UAAAA,iEAAiC,CAAC;gCAT7BF;;QAGT,uBAAgBG,QAAhB,KAAA;QACA,uBAAiBC,UAAjB,KAAA;QACA,uBAAiBC,WAAjB,KAAA;aAGqBJ,QAAAA;QAGjB,IAAQG,SAAwBF,QAAxBE,2BAAwBF,QAAhBG,SAAAA,wCAAU;QAC1B,IAAI,CAACF,IAAI,GAAG,AAAC,aAAuB,OAAXF,MAAME,IAAI,EAAC;QACpC,IAAI,CAACC,MAAM,GAAGA;QACd,IAAI,CAACC,OAAO,GAAGA;;kBAdVL;;YAiBHM,KAAAA;mBAAN,SAAMA,IAAIC,KAAc;;wBA2BpB,cA1BMC,aAEGC,SAED,eAUA,eATMC,QAGF,eAUCC,OACL;;;;gCAnBFH,cAAc,IAAI,CAACH,OAAO,GAAG;gCAE1BI,UAAU;;;qCAAGA,CAAAA,WAAWD,WAAU;;;;;;;;;;;;iCAEnC,gBAAA,IAAI,CAACJ,MAAM,cAAX,oCAAA,cAAaQ,KAAK,CAAC,AAAC,WAAwBJ,OAAdC,SAAQ,QAAkB,OAAZD,cAAe;oCAAEP,OAAO,IAAI,CAACE,IAAI;gCAAC;gCAC/D;;oCAAM,IAAI,CAACF,KAAK,CAACK,GAAG,CAACC;;;gCAA9BG,SAAS;gCAEf,IAAIA,WAAW,MAAM;;qCACjB,gBAAA,IAAI,CAACN,MAAM,cAAX,oCAAA,cAAaQ,KAAK,CAAC,AAAC,WAAwBJ,OAAdC,SAAQ,QAAkB,OAAZD,aAAY,eAAa;wCACjEP,OAAO,IAAI,CAACE,IAAI;oCACpB;oCACA;;wCAAOO;;gCACX;iCAEA,gBAAA,IAAI,CAACN,MAAM,cAAX,oCAAA,cAAaQ,KAAK,CACd,AAAC,WAAwBJ,OAAdC,SAAQ,QAAkB,OAAZD,aAAY,iCACrC;oCAAEP,OAAO,IAAI,CAACE,IAAI;gCAAC;;;;;;gCAElBQ;iCACL,gBAAA,IAAI,CAACP,MAAM,cAAX,oCAAA,cAAaQ,KAAK,CAAC,AAAC,WAAwBJ,OAAdC,SAAQ,QAAkB,OAAZD,aAAY,0BAAwB;oCAC5EP,OAAO,IAAI,CAACE,IAAI;oCAChBQ,OAAOA,AAAK,YAALA,OAAiBE,SAAQF,MAAMG,OAAO,GAAG;gCACpD;;;;;;gCApBsCL;;;;;;iCAwB9C,eAAA,IAAI,CAACL,MAAM,cAAX,mCAAA,aAAaO,KAAK,CAAC,AAAC,OAAkB,OAAZH,aAAY,qBAAmB;oCAAEP,OAAO,IAAI,CAACE,IAAI;gCAAC;gCAC5E;;oCAAO;;;;gBACX;;;;WA9CSH;IA+CZ"}

package/dist/adapters/agents/{autonomous-agent.adapter.d.ts → tool-agent.adapter.d.ts}

@@ -4,24 +4,24 @@ import { type AgentPort } from '../../ports/agent.port.js';
 import type { ModelPort } from '../../ports/model.port.js';
 import type { PromptPort } from '../../ports/prompt.port.js';
 import type { ToolPort } from '../../ports/tool.port.js';
-import type { SystemPromptAdapter } from '../prompts/system-prompt.adapter.js';
-export interface AutonomousAgentOptions<TOutput = string> {
+import type { SystemPrompt } from '../prompts/system-prompt.adapter.js';
+export interface ToolAgentOptions<TOutput = string> {
     logger?: LoggerPort;
     model: ModelPort;
     schema?: z.ZodSchema<TOutput>;
-    systemPrompt: SystemPromptAdapter;
+    systemPrompt: SystemPrompt;
     tools: ToolPort[];
     verbose?: boolean;
 }
 /**
- * An autonomous agent that uses tools and a structured prompt to accomplish tasks.
+ * A tool-enabled agent that uses tools and a structured prompt to accomplish tasks.
  * It can decide whether to respond or remain silent and supports schema-validated responses.
  * @template TOutput - The TypeScript type of the output
  */
-export declare class AutonomousAgentAdapter<TOutput = string> implements AgentPort<PromptPort, TOutput> {
+export declare class ToolAgent<TOutput = string> implements AgentPort<PromptPort, TOutput> {
     readonly name: string;
     private readonly options;
-    constructor(name: string, options: AutonomousAgentOptions<TOutput>);
+    constructor(name: string, options: ToolAgentOptions<TOutput>);
     run(input?: PromptPort): Promise<null | TOutput>;
     private createExecutor;
     private parseAgentOutput;

package/dist/adapters/agents/{autonomous-agent.adapter.js → tool-agent.adapter.js}

@@ -160,22 +160,22 @@ function _ts_generator(thisArg, body) {
 import { ChatPromptTemplate } from '@langchain/core/prompts';
 import { AgentExecutor, createStructuredChatAgent } from 'langchain/agents';
 import { z } from 'zod/v4';
-import { AIResponseParser } from '../utils/ai-response-parser.js';
+import { StructuredResponseParser } from '../utils/structured-response-parser.js';
 var SYSTEM_PROMPT_TEMPLATE = '\n<OBJECTIVE>\n{mission_prompt}\n</OBJECTIVE>\n\n<GLOBAL_WRAPPER_OUTPUT_FORMAT>\nCRITICAL: The format instructions in this section are the ONLY valid way to structure your response. Your entire response MUST be a single JSON markdown code block. Any formatting guidelines within the <OBJECTIVE> section apply ONLY to the content inside the "RESPOND:" part of your final "action_input".\n\nREQUIRED: You have two ways to respond:\n\n1.  **Call a tool** to gather information. For this, you MUST output a JSON blob with the tool\'s name and its input.\n    *Valid tool names are: {tool_names}*\n    ```json\n    {{\n      "action": "tool_name_to_use",\n      "action_input": "the input for the tool, or an empty object {{}} if no input is needed"\n    }}\n    ```\n\n2.  **Provide the Final Answer** once you have enough information. For this, you MUST output a JSON blob with the "Final Answer" action.\n    The "action_input" for a "Final Answer" MUST be a string that begins with either "RESPOND: " for a message or "SILENT: " for no message. This prefix is a literal part of the output string and MUST NOT be omitted.\n    - To send a message:\n      ```json\n      {{\n        "action": "Final Answer",\n        "action_input": "RESPOND: <your response message>"\n      }}\n      ```\n    - To stay silent:\n      ```json\n      {{\n        "action": "Final Answer",\n        "action_input": "SILENT: <your reason for staying silent>"\n      }}\n      ```\n\n    YOU MUST ALWAYS INCLUDE "RESPOND:" OR "SILENT:" IN YOUR FINAL ANSWER\'S "action_input". FAILURE TO DO SO WILL CAUSE AN ERROR.\n\n{schema_format}\n</OUTPUT_FORMAT>\n\n<EXECUTION_CONTEXT>\nThis is internal data for your reference.\n\n<TOOLS>\n{tools}\n</TOOLS>\n\n<WORKING_MEMORY>\nThis is your internal thought process and previous tool usage.\n{agent_scratchpad}\n</WORKING_MEMORY>\n</EXECUTION_CONTEXT>\n';
 /**
- * An autonomous agent that uses tools and a structured prompt to accomplish tasks.
+ * A tool-enabled agent that uses tools and a structured prompt to accomplish tasks.
  * It can decide whether to respond or remain silent and supports schema-validated responses.
  * @template TOutput - The TypeScript type of the output
- */ export var AutonomousAgentAdapter = /*#__PURE__*/ function() {
+ */ export var ToolAgent = /*#__PURE__*/ function() {
     "use strict";
-    function AutonomousAgentAdapter(name, options) {
-        _class_call_check(this, AutonomousAgentAdapter);
+    function ToolAgent(name, options) {
+        _class_call_check(this, ToolAgent);
         _define_property(this, "name", void 0);
         _define_property(this, "options", void 0);
         this.name = name;
         this.options = options;
     }
-    _create_class(AutonomousAgentAdapter, [
+    _create_class(ToolAgent, [
         {
             key: "run",
             value: function run(input) {
@@ -184,7 +184,9 @@ var SYSTEM_PROMPT_TEMPLATE = '\n<OBJECTIVE>\n{mission_prompt}\n</OBJECTIVE>\n\n<
                     return _ts_generator(this, function(_state) {
                         switch(_state.label){
                             case 0:
-                                (_this_options_logger = this.options.logger) === null || _this_options_logger === void 0 ? void 0 : _this_options_logger.debug("[".concat(this.name, "] Starting chat execution."));
+                                (_this_options_logger = this.options.logger) === null || _this_options_logger === void 0 ? void 0 : _this_options_logger.debug('Starting chat execution', {
+                                    agent: this.name
+                                });
                                 _state.label = 1;
                             case 1:
                                 _state.trys.push([
@@ -208,7 +210,8 @@ var SYSTEM_PROMPT_TEMPLATE = '\n<OBJECTIVE>\n{mission_prompt}\n</OBJECTIVE>\n\n<
                                 ];
                             case 3:
                                 result = _state.sent();
-                                (_this_options_logger1 = this.options.logger) === null || _this_options_logger1 === void 0 ? void 0 : _this_options_logger1.debug("[".concat(this.name, "] Agent execution completed."), {
+                                (_this_options_logger1 = this.options.logger) === null || _this_options_logger1 === void 0 ? void 0 : _this_options_logger1.debug('Agent execution completed', {
+                                    agent: this.name,
                                     hasOutput: 'output' in result
                                 });
                                 if (!result || typeof result.output !== 'string') {
@@ -223,7 +226,8 @@ var SYSTEM_PROMPT_TEMPLATE = '\n<OBJECTIVE>\n{mission_prompt}\n</OBJECTIVE>\n\n<
                                 }
                                 if (!agentResponse.shouldRespond) {
                                     ;
-                                    (_this_options_logger2 = this.options.logger) === null || _this_options_logger2 === void 0 ? void 0 : _this_options_logger2.info("[".concat(this.name, "] Agent chose to remain silent."), {
+                                    (_this_options_logger2 = this.options.logger) === null || _this_options_logger2 === void 0 ? void 0 : _this_options_logger2.debug('Agent chose to remain silent', {
+                                        agent: this.name,
                                         reason: agentResponse.reason
                                     });
                                     return [
@@ -235,14 +239,18 @@ var SYSTEM_PROMPT_TEMPLATE = '\n<OBJECTIVE>\n{mission_prompt}\n</OBJECTIVE>\n\n<
                                 if (this.options.schema) {
                                     ;
                                     validatedResponse = this.validateResponseContent(message, this.options.schema);
-                                    (_this_options_logger3 = this.options.logger) === null || _this_options_logger3 === void 0 ? void 0 : _this_options_logger3.info("[".concat(this.name, "] Execution finished; response content validated."));
+                                    (_this_options_logger3 = this.options.logger) === null || _this_options_logger3 === void 0 ? void 0 : _this_options_logger3.debug('Execution finished; response content validated.', {
+                                        agent: this.name
+                                    });
                                     return [
                                         2,
                                         validatedResponse
                                     ];
                                 } else {
                                     ;
-                                    (_this_options_logger4 = this.options.logger) === null || _this_options_logger4 === void 0 ? void 0 : _this_options_logger4.info("[".concat(this.name, "] Execution finished."));
+                                    (_this_options_logger4 = this.options.logger) === null || _this_options_logger4 === void 0 ? void 0 : _this_options_logger4.debug('Execution finished', {
+                                        agent: this.name
+                                    });
                                     // When no schema is provided, we assume TOutput is string (default), so message is the result
                                     return [
                                         2,
@@ -255,7 +263,8 @@ var SYSTEM_PROMPT_TEMPLATE = '\n<OBJECTIVE>\n{mission_prompt}\n</OBJECTIVE>\n\n<
                                 ];
                             case 4:
                                 error = _state.sent();
-                                (_this_options_logger5 = this.options.logger) === null || _this_options_logger5 === void 0 ? void 0 : _this_options_logger5.error("[".concat(this.name, "] Chat execution failed."), {
+                                (_this_options_logger5 = this.options.logger) === null || _this_options_logger5 === void 0 ? void 0 : _this_options_logger5.error('Chat execution failed', {
+                                    agent: this.name,
                                     error: _instanceof(error, Error) ? error.message : 'Unknown error'
                                 });
                                 return [
@@ -279,7 +288,7 @@ var SYSTEM_PROMPT_TEMPLATE = '\n<OBJECTIVE>\n{mission_prompt}\n</OBJECTIVE>\n\n<
                     return _ts_generator(this, function(_state) {
                         switch(_state.label){
                             case 0:
-                                model = this.options.model.getModel();
+                                model = this.options.model.getLangchainModel();
                                 tools = this.options.tools.map(function(tool) {
                                     return tool.getDynamicTool();
                                 });
@@ -352,7 +361,8 @@ var SYSTEM_PROMPT_TEMPLATE = '\n<OBJECTIVE>\n{mission_prompt}\n</OBJECTIVE>\n\n<
                         shouldRespond: false
                     };
                 }
-                (_this_options_logger = this.options.logger) === null || _this_options_logger === void 0 ? void 0 : _this_options_logger.error("[".concat(this.name, "] Agent output was missing 'RESPOND:' or 'SILENT:' prefix."), {
+                (_this_options_logger = this.options.logger) === null || _this_options_logger === void 0 ? void 0 : _this_options_logger.error("Agent output was missing 'RESPOND:' or 'SILENT:' prefix.", {
+                    agent: this.name,
                     rawOutput: output
                 });
                 return null;
@@ -371,10 +381,11 @@ var SYSTEM_PROMPT_TEMPLATE = '\n<OBJECTIVE>\n{mission_prompt}\n</OBJECTIVE>\n\n<
             key: "validateResponseContent",
             value: function validateResponseContent(content, schema) {
                 try {
-                    return new AIResponseParser(schema).parse(content);
+                    return new StructuredResponseParser(schema).parse(content);
                 } catch (error) {
                     var _this_options_logger;
-                    (_this_options_logger = this.options.logger) === null || _this_options_logger === void 0 ? void 0 : _this_options_logger.error("[".concat(this.name, "] Failed to validate response content against schema."), {
+                    (_this_options_logger = this.options.logger) === null || _this_options_logger === void 0 ? void 0 : _this_options_logger.error('Failed to validate response content against schema.', {
+                        agent: this.name,
                         error: _instanceof(error, Error) ? error.message : 'Unknown error',
                         rawContent: content
                     });
@@ -383,7 +394,7 @@ var SYSTEM_PROMPT_TEMPLATE = '\n<OBJECTIVE>\n{mission_prompt}\n</OBJECTIVE>\n\n<
             }
         }
     ]);
-    return AutonomousAgentAdapter;
+    return ToolAgent;
 }();
 
-//# sourceMappingURL=autonomous-agent.adapter.js.map
+//# sourceMappingURL=tool-agent.adapter.js.map

package/dist/adapters/agents/tool-agent.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/agents/tool-agent.adapter.ts"],"sourcesContent":["import { type LoggerPort } from '@jterrazz/logger';\nimport { ChatPromptTemplate } from '@langchain/core/prompts';\nimport { AgentExecutor, createStructuredChatAgent } from 'langchain/agents';\nimport { z } from 'zod/v4';\n\nimport { type AgentPort } from '../../ports/agent.port.js';\nimport type { ModelPort } from '../../ports/model.port.js';\nimport type { PromptPort } from '../../ports/prompt.port.js';\nimport type { ToolPort } from '../../ports/tool.port.js';\n\nimport { StructuredResponseParser } from '../utils/structured-response-parser.js';\n\nimport type { SystemPrompt } from '../prompts/system-prompt.adapter.js';\n\nexport interface ToolAgentOptions<TOutput = string> {\n    logger?: LoggerPort;\n    model: ModelPort;\n    schema?: z.ZodSchema<TOutput>;\n    systemPrompt: SystemPrompt;\n    tools: ToolPort[];\n    verbose?: boolean;\n}\n\nconst SYSTEM_PROMPT_TEMPLATE = `\n<OBJECTIVE>\n{mission_prompt}\n</OBJECTIVE>\n\n<GLOBAL_WRAPPER_OUTPUT_FORMAT>\nCRITICAL: The format instructions in this section are the ONLY valid way to structure your response. Your entire response MUST be a single JSON markdown code block. Any formatting guidelines within the <OBJECTIVE> section apply ONLY to the content inside the \"RESPOND:\" part of your final \"action_input\".\n\nREQUIRED: You have two ways to respond:\n\n1.  **Call a tool** to gather information. For this, you MUST output a JSON blob with the tool's name and its input.\n    *Valid tool names are: {tool_names}*\n    \\`\\`\\`json\n    {{\n      \"action\": \"tool_name_to_use\",\n      \"action_input\": \"the input for the tool, or an empty object {{}} if no input is needed\"\n    }}\n    \\`\\`\\`\n\n2.  **Provide the Final Answer** once you have enough information. For this, you MUST output a JSON blob with the \"Final Answer\" action.\n    The \"action_input\" for a \"Final Answer\" MUST be a string that begins with either \"RESPOND: \" for a message or \"SILENT: \" for no message. This prefix is a literal part of the output string and MUST NOT be omitted.\n    - To send a message:\n      \\`\\`\\`json\n      {{\n        \"action\": \"Final Answer\",\n        \"action_input\": \"RESPOND: <your response message>\"\n      }}\n      \\`\\`\\`\n    - To stay silent:\n      \\`\\`\\`json\n      {{\n        \"action\": \"Final Answer\",\n        \"action_input\": \"SILENT: <your reason for staying silent>\"\n      }}\n      \\`\\`\\`\n\n    YOU MUST ALWAYS INCLUDE \"RESPOND:\" OR \"SILENT:\" IN YOUR FINAL ANSWER'S \"action_input\". FAILURE TO DO SO WILL CAUSE AN ERROR.\n\n{schema_format}\n</OUTPUT_FORMAT>\n\n<EXECUTION_CONTEXT>\nThis is internal data for your reference.\n\n<TOOLS>\n{tools}\n</TOOLS>\n\n<WORKING_MEMORY>\nThis is your internal thought process and previous tool usage.\n{agent_scratchpad}\n</WORKING_MEMORY>\n</EXECUTION_CONTEXT>\n`;\n\n/**\n * A tool-enabled agent that uses tools and a structured prompt to accomplish tasks.\n * It can decide whether to respond or remain silent and supports schema-validated responses.\n * @template TOutput - The TypeScript type of the output\n */\nexport class ToolAgent<TOutput = string> implements AgentPort<PromptPort, TOutput> {\n    constructor(\n        public readonly name: string,\n        private readonly options: ToolAgentOptions<TOutput>,\n    ) {}\n\n    async run(input?: PromptPort): Promise<null | TOutput> {\n        this.options.logger?.debug('Starting chat execution', { agent: this.name });\n\n        try {\n            const executor = await this.createExecutor();\n            const userInput = this.resolveUserInput(input);\n\n            const result = await executor.invoke({ input: userInput });\n\n            this.options.logger?.debug('Agent execution completed', {\n                agent: this.name,\n                hasOutput: 'output' in result,\n            });\n\n            if (!result || typeof result.output !== 'string') {\n                throw new Error('Agent returned an invalid result structure.');\n            }\n\n            const agentResponse = this.parseAgentOutput(result.output);\n\n            if (!agentResponse) {\n                return null;\n            }\n\n            if (!agentResponse.shouldRespond) {\n                this.options.logger?.debug('Agent chose to remain silent', {\n                    agent: this.name,\n                    reason: agentResponse.reason,\n                });\n                return null;\n            }\n\n            const message = agentResponse.message ?? '';\n\n            if (this.options.schema) {\n                const validatedResponse = this.validateResponseContent(\n                    message,\n                    this.options.schema,\n                );\n\n                this.options.logger?.debug('Execution finished; response content validated.', {\n                    agent: this.name,\n                });\n                return validatedResponse;\n            } else {\n                this.options.logger?.debug('Execution finished', { agent: this.name });\n                // When no schema is provided, we assume TOutput is string (default), so message is the result\n                return message as TOutput;\n            }\n        } catch (error) {\n            this.options.logger?.error('Chat execution failed', {\n                agent: this.name,\n                error: error instanceof Error ? error.message : 'Unknown error',\n            });\n            return null;\n        }\n    }\n\n    private async createExecutor(): Promise<AgentExecutor> {\n        const model = this.options.model.getLangchainModel();\n        const tools = this.options.tools.map((tool) => tool.getDynamicTool());\n\n        // Add schema format instructions if schema is provided\n        let schemaFormatInstructions = '';\n        if (this.options.schema) {\n            const jsonSchema = z.toJSONSchema(this.options.schema);\n            const isPrimitiveType = ['boolean', 'integer', 'number', 'string'].includes(\n                jsonSchema.type as string,\n            );\n            const jsonSchemaString = JSON.stringify(jsonSchema, null, 2)\n                .replace(/{/g, '{{')\n                .replace(/}/g, '}}');\n\n            if (isPrimitiveType) {\n                schemaFormatInstructions = `\n\nSCHEMA VALIDATION: When providing a \"RESPOND:\" answer, the content after \"RESPOND: \" must be a ${jsonSchema.type} value that matches this schema description:\n\n\\`\\`\\`json\n${jsonSchemaString}\n\\`\\`\\`\n\nExample format:\n\\`\\`\\`json\n{{\n  \"action\": \"Final Answer\",\n  \"action_input\": \"RESPOND: your ${jsonSchema.type} value here\"\n}}\n\\`\\`\\`\n\nDo not wrap the ${jsonSchema.type} value in JSON - just provide the raw value after \"RESPOND: \".`;\n            } else {\n                schemaFormatInstructions = `\n\nSCHEMA VALIDATION: When providing a \"RESPOND:\" answer, the content after \"RESPOND: \" must be valid JSON that matches this JSON schema description:\n\n\\`\\`\\`json\n${jsonSchemaString}\n\\`\\`\\`\n\nExample format:\n\\`\\`\\`json\n{{\n  \"action\": \"Final Answer\",\n  \"action_input\": \"RESPOND: {{\\\\\"field1\\\\\": \\\\\"value1\\\\\", \\\\\"field2\\\\\": \\\\\"value2\\\\\"}}\"\n}}\n\\`\\`\\`\n`;\n            }\n        }\n\n        const prompt = ChatPromptTemplate.fromMessages([\n            [\n                'system',\n                SYSTEM_PROMPT_TEMPLATE.replace(\n                    '{mission_prompt}',\n                    this.options.systemPrompt.generate(),\n                ).replace('{schema_format}', schemaFormatInstructions),\n            ],\n            ['human', '{input}'],\n        ]);\n\n        const agent = await createStructuredChatAgent({\n            llm: model,\n            prompt,\n            tools,\n        });\n\n        return AgentExecutor.fromAgentAndTools({\n            agent,\n            tools,\n            verbose: this.options.verbose,\n        });\n    }\n\n    private parseAgentOutput(output: string): null | {\n        message?: string;\n        reason?: string;\n        shouldRespond: boolean;\n    } {\n        const text = output.trim();\n\n        const respondMatch = text.match(/^RESPOND:\\s*([\\s\\S]+)$/i);\n        if (respondMatch) {\n            return { message: respondMatch[1].trim(), shouldRespond: true };\n        }\n\n        const silentMatch = text.match(/^SILENT:\\s*([\\s\\S]+)$/i);\n        if (silentMatch) {\n            return { reason: silentMatch[1].trim(), shouldRespond: false };\n        }\n\n        this.options.logger?.error(\"Agent output was missing 'RESPOND:' or 'SILENT:' prefix.\", {\n            agent: this.name,\n            rawOutput: output,\n        });\n\n        return null;\n    }\n\n    private resolveUserInput(input?: PromptPort): string {\n        if (input) {\n            return input.generate();\n        }\n        return 'Proceed with your instructions.';\n    }\n\n    private validateResponseContent<TResponse>(\n        content: string,\n        schema: z.ZodSchema<TResponse>,\n    ): TResponse {\n        try {\n            return new StructuredResponseParser(schema).parse(content);\n        } catch (error) {\n            this.options.logger?.error('Failed to validate response content against schema.', {\n                agent: this.name,\n                error: error instanceof Error ? error.message : 'Unknown error',\n                rawContent: content,\n            });\n            throw new Error('Invalid response content from model.');\n        }\n    }\n}\n"],"names":["ChatPromptTemplate","AgentExecutor","createStructuredChatAgent","z","StructuredResponseParser","SYSTEM_PROMPT_TEMPLATE","ToolAgent","name","options","run","input","executor","userInput","result","agentResponse","message","validatedResponse","error","logger","debug","agent","createExecutor","resolveUserInput","invoke","hasOutput","output","Error","parseAgentOutput","shouldRespond","reason","schema","validateResponseContent","model","tools","schemaFormatInstructions","jsonSchema","isPrimitiveType","jsonSchemaString","prompt","getLangchainModel","map","tool","getDynamicTool","toJSONSchema","includes","type","JSON","stringify","replace","fromMessages","systemPrompt","generate","llm","fromAgentAndTools","verbose","text","trim","respondMatch","match","silentMatch","rawOutput","content","parse","rawContent"],"mappings":"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"}

package/dist/adapters/models/openrouter-model.adapter.d.ts

@@ -1,38 +1,23 @@
 import type { BaseLanguageModel } from '@langchain/core/language_models/base';
-import type { ModelPort } from '../../ports/model.port.js';
-export interface OpenRouterConfig {
-    /**
-     * OpenRouter API key
-     */
-    apiKey: string;
-    /**
-     * The maximum number of tokens to generate
-     */
-    maxTokens?: number;
-    /**
-     * Optional metadata for request headers
-     */
-    metadata?: OpenRouterMetadata;
-    /**
-     * The model to use (e.g., 'google/gemini-2.5-flash-preview-05-20:thinking')
-     */
-    modelName: string;
-}
-export interface OpenRouterMetadata {
+import type { LanguageModelV1 } from 'ai';
+import type { ModelConfig, ModelPort } from '../../ports/model.port.js';
+import type { OpenRouterConfig } from '../providers/openrouter-provider.adapter.js';
+/**
+ * OpenRouter model wrapper supporting both LangChain and Vercel AI SDK
+ */
+export declare class OpenRouterModel implements ModelPort {
+    private readonly providerConfig;
+    private readonly modelName;
+    private readonly langchainModel;
+    private readonly modelConfig;
+    private readonly vercelModel;
+    constructor(providerConfig: OpenRouterConfig, modelName: string, modelConfig?: ModelConfig);
     /**
-     * Application title for X-Title header
+     * Get the configured LangChain language model instance
      */
-    application?: string;
+    getLangchainModel(): BaseLanguageModel;
     /**
-     * Website URL for HTTP-Referer header
+     * Get the configured Vercel AI SDK language model instance
      */
-    website?: string;
-}
-/**
- * OpenRouter adapter that provides access to various models through OpenRouter's API
- */
-export declare class OpenRouterModelAdapter implements ModelPort {
-    private readonly model;
-    constructor(config: OpenRouterConfig);
-    getModel(): BaseLanguageModel;
+    getVercelModel(): LanguageModelV1;
 }

package/dist/adapters/models/openrouter-model.adapter.js

@@ -45,45 +45,104 @@ function _object_spread(target) {
     }
     return target;
 }
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        if (enumerableOnly) {
+            symbols = symbols.filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+            });
+        }
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
 import { ChatOpenAI } from '@langchain/openai';
+import { createOpenRouter } from '@openrouter/ai-sdk-provider';
 /**
- * OpenRouter adapter that provides access to various models through OpenRouter's API
- */ export var OpenRouterModelAdapter = /*#__PURE__*/ function() {
+ * OpenRouter model wrapper supporting both LangChain and Vercel AI SDK
+ */ export var OpenRouterModel = /*#__PURE__*/ function() {
     "use strict";
-    function OpenRouterModelAdapter(config) {
-        _class_call_check(this, OpenRouterModelAdapter);
-        var _config_metadata, _config_metadata1;
-        _define_property(this, "model", void 0);
-        var _config_maxTokens;
-        this.model = new ChatOpenAI({
+    function OpenRouterModel(providerConfig, modelName) {
+        var modelConfig = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {};
+        _class_call_check(this, OpenRouterModel);
+        var _this_providerConfig_metadata, _this_providerConfig_metadata1;
+        _define_property(this, "providerConfig", void 0);
+        _define_property(this, "modelName", void 0);
+        _define_property(this, "langchainModel", void 0);
+        _define_property(this, "modelConfig", void 0);
+        _define_property(this, "vercelModel", void 0);
+        this.providerConfig = providerConfig;
+        this.modelName = modelName;
+        this.modelConfig = _object_spread({
+            maxTokens: 256000,
+            reasoning: {
+                effort: 'high',
+                exclude: true
+            }
+        }, modelConfig);
+        // LangChain model setup
+        this.langchainModel = new ChatOpenAI(_object_spread_props(_object_spread({
             configuration: {
                 baseURL: 'https://openrouter.ai/api/v1',
-                defaultHeaders: _object_spread({}, ((_config_metadata = config.metadata) === null || _config_metadata === void 0 ? void 0 : _config_metadata.website) && {
-                    'HTTP-Referer': config.metadata.website
-                }, ((_config_metadata1 = config.metadata) === null || _config_metadata1 === void 0 ? void 0 : _config_metadata1.application) && {
-                    'X-Title': config.metadata.application
+                defaultHeaders: _object_spread({}, ((_this_providerConfig_metadata = this.providerConfig.metadata) === null || _this_providerConfig_metadata === void 0 ? void 0 : _this_providerConfig_metadata.website) && {
+                    'HTTP-Referer': this.providerConfig.metadata.website
+                }, ((_this_providerConfig_metadata1 = this.providerConfig.metadata) === null || _this_providerConfig_metadata1 === void 0 ? void 0 : _this_providerConfig_metadata1.application) && {
+                    'X-Title': this.providerConfig.metadata.application
                 })
             },
-            maxTokens: (_config_maxTokens = config.maxTokens) !== null && _config_maxTokens !== void 0 ? _config_maxTokens : 256000,
+            maxTokens: this.modelConfig.maxTokens
+        }, this.modelConfig.reasoning && {
             modelKwargs: {
-                reasoning: {
-                    effort: 'high',
-                    exclude: true
-                }
-            },
-            modelName: config.modelName,
-            openAIApiKey: config.apiKey
+                reasoning: this.modelConfig.reasoning
+            }
+        }), {
+            modelName: this.modelName,
+            openAIApiKey: this.providerConfig.apiKey
+        }));
+        // Vercel AI SDK model setup
+        var openrouter = createOpenRouter({
+            apiKey: this.providerConfig.apiKey
         });
+        this.vercelModel = openrouter(this.modelName, _object_spread({}, this.modelConfig.maxTokens && {
+            maxTokens: this.modelConfig.maxTokens
+        }, this.modelConfig.reasoning && {
+            extraBody: {
+                reasoning: this.modelConfig.reasoning
+            }
+        }));
     }
-    _create_class(OpenRouterModelAdapter, [
+    _create_class(OpenRouterModel, [
+        {
+            /**
+     * Get the configured LangChain language model instance
+     */ key: "getLangchainModel",
+            value: function getLangchainModel() {
+                return this.langchainModel;
+            }
+        },
         {
-            key: "getModel",
-            value: function getModel() {
-                return this.model;
+            /**
+     * Get the configured Vercel AI SDK language model instance
+     */ key: "getVercelModel",
+            value: function getVercelModel() {
+                return this.vercelModel;
             }
         }
     ]);
-    return OpenRouterModelAdapter;
+    return OpenRouterModel;
 }();
 
 //# sourceMappingURL=openrouter-model.adapter.js.map

package/dist/adapters/models/openrouter-model.adapter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/adapters/models/openrouter-model.adapter.ts"],"sourcesContent":["import type { BaseLanguageModel } from '@langchain/core/language_models/base';\nimport { ChatOpenAI } from '@langchain/openai';\n\nimport type { ModelPort } from '../../ports/model.port.js';\n\nexport interface OpenRouterConfig {\n    /**\n     * OpenRouter API key\n     */\n    apiKey: string;\n    /**\n     * The maximum number of tokens to generate\n     */\n    maxTokens?: number;\n    /**\n     * Optional metadata for request headers\n     */\n    metadata?: OpenRouterMetadata;\n    /**\n     * The model to use (e.g., 'google/gemini-2.5-flash-preview-05-20:thinking')\n     */\n    modelName: string;\n}\n\nexport interface OpenRouterMetadata {\n    /**\n     * Application title for X-Title header\n     */\n    application?: string;\n    /**\n     * Website URL for HTTP-Referer header\n     */\n    website?: string;\n}\n\n/**\n * OpenRouter adapter that provides access to various models through OpenRouter's API\n */\nexport class OpenRouterModelAdapter implements ModelPort {\n    private readonly model: BaseLanguageModel;\n\n    constructor(config: OpenRouterConfig) {\n        this.model = new ChatOpenAI({\n            configuration: {\n                baseURL: 'https://openrouter.ai/api/v1',\n                defaultHeaders: {\n                    ...(config.metadata?.website && {\n                        'HTTP-Referer': config.metadata.website,\n                    }),\n                    ...(config.metadata?.application && { 'X-Title': config.metadata.application }),\n                },\n            },\n            maxTokens: config.maxTokens ?? 256_000,\n            modelKwargs: {\n                reasoning: {\n                    effort: 'high',\n                    exclude: true,\n                },\n            },\n            modelName: config.modelName,\n            openAIApiKey: config.apiKey,\n        });\n    }\n\n    getModel(): BaseLanguageModel {\n        return this.model;\n    }\n}\n"],"names":["ChatOpenAI","OpenRouterModelAdapter","config","model","configuration","baseURL","defaultHeaders","metadata","website","application","maxTokens","modelKwargs","reasoning","effort","exclude","modelName","openAIApiKey","apiKey","getModel"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,SAASA,UAAU,QAAQ,oBAAoB;AAkC/C;;CAEC,GACD,OAAO,IAAA,AAAMC,uCAAN;;aAAMA,uBAGGC,MAAwB;gCAH3BD;YAQWC,kBAGAA;QAVpB,uBAAiBC,SAAjB,KAAA;YAamBD;QAVf,IAAI,CAACC,KAAK,GAAG,IAAIH,WAAW;YACxBI,eAAe;gBACXC,SAAS;gBACTC,gBAAgB,mBACRJ,EAAAA,mBAAAA,OAAOK,QAAQ,cAAfL,uCAAAA,iBAAiBM,OAAO,KAAI;oBAC5B,gBAAgBN,OAAOK,QAAQ,CAACC,OAAO;gBAC3C,GACIN,EAAAA,oBAAAA,OAAOK,QAAQ,cAAfL,wCAAAA,kBAAiBO,WAAW,KAAI;oBAAE,WAAWP,OAAOK,QAAQ,CAACE,WAAW;gBAAC;YAErF;YACAC,WAAWR,CAAAA,oBAAAA,OAAOQ,SAAS,cAAhBR,+BAAAA,oBAAoB;YAC/BS,aAAa;gBACTC,WAAW;oBACPC,QAAQ;oBACRC,SAAS;gBACb;YACJ;YACAC,WAAWb,OAAOa,SAAS;YAC3BC,cAAcd,OAAOe,MAAM;QAC/B;;kBAvBKhB;;YA0BTiB,KAAAA;mBAAAA,SAAAA;gBACI,OAAO,IAAI,CAACf,KAAK;YACrB;;;WA5BSF;IA6BZ"}
+{"version":3,"sources":["../../../src/adapters/models/openrouter-model.adapter.ts"],"sourcesContent":["import type { BaseLanguageModel } from '@langchain/core/language_models/base';\nimport { ChatOpenAI } from '@langchain/openai';\nimport { createOpenRouter } from '@openrouter/ai-sdk-provider';\nimport type { LanguageModelV1 } from 'ai';\n\nimport type { ModelConfig, ModelPort } from '../../ports/model.port.js';\n\nimport type { OpenRouterConfig } from '../providers/openrouter-provider.adapter.js';\n\n/**\n * OpenRouter model wrapper supporting both LangChain and Vercel AI SDK\n */\nexport class OpenRouterModel implements ModelPort {\n    private readonly langchainModel: BaseLanguageModel;\n    private readonly modelConfig: ModelConfig;\n    private readonly vercelModel: LanguageModelV1;\n\n    constructor(\n        private readonly providerConfig: OpenRouterConfig,\n        private readonly modelName: string,\n        modelConfig: ModelConfig = {},\n    ) {\n        this.modelConfig = {\n            maxTokens: 256_000,\n            reasoning: {\n                effort: 'high',\n                exclude: true,\n            },\n            ...modelConfig,\n        };\n\n        // LangChain model setup\n        this.langchainModel = new ChatOpenAI({\n            configuration: {\n                baseURL: 'https://openrouter.ai/api/v1',\n                defaultHeaders: {\n                    ...(this.providerConfig.metadata?.website && {\n                        'HTTP-Referer': this.providerConfig.metadata.website,\n                    }),\n                    ...(this.providerConfig.metadata?.application && {\n                        'X-Title': this.providerConfig.metadata.application,\n                    }),\n                },\n            },\n            maxTokens: this.modelConfig.maxTokens,\n            ...(this.modelConfig.reasoning && {\n                modelKwargs: {\n                    reasoning: this.modelConfig.reasoning,\n                },\n            }),\n            modelName: this.modelName,\n            openAIApiKey: this.providerConfig.apiKey,\n        });\n\n        // Vercel AI SDK model setup\n        const openrouter = createOpenRouter({\n            apiKey: this.providerConfig.apiKey,\n        });\n\n        this.vercelModel = openrouter(this.modelName, {\n            ...(this.modelConfig.maxTokens && { maxTokens: this.modelConfig.maxTokens }),\n            ...(this.modelConfig.reasoning && {\n                extraBody: {\n                    reasoning: this.modelConfig.reasoning,\n                },\n            }),\n        });\n    }\n\n    /**\n     * Get the configured LangChain language model instance\n     */\n    getLangchainModel(): BaseLanguageModel {\n        return this.langchainModel;\n    }\n\n    /**\n     * Get the configured Vercel AI SDK language model instance\n     */\n    getVercelModel(): LanguageModelV1 {\n        return this.vercelModel;\n    }\n}\n"],"names":["ChatOpenAI","createOpenRouter","OpenRouterModel","providerConfig","modelName","modelConfig","langchainModel","vercelModel","maxTokens","reasoning","effort","exclude","configuration","baseURL","defaultHeaders","metadata","website","application","modelKwargs","openAIApiKey","apiKey","openrouter","extraBody","getLangchainModel","getVercelModel"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,SAASA,UAAU,QAAQ,oBAAoB;AAC/C,SAASC,gBAAgB,QAAQ,8BAA8B;AAO/D;;CAEC,GACD,OAAO,IAAA,AAAMC,gCAAN;;aAAMA,gBAML,AAAiBC,cAAgC,EACjD,AAAiBC,SAAiB;YAClCC,cAAAA,iEAA2B,CAAC;gCARvBH;YAwBW,+BAGA;;;QA1BpB,uBAAiBI,kBAAjB,KAAA;QACA,uBAAiBD,eAAjB,KAAA;QACA,uBAAiBE,eAAjB,KAAA;aAGqBJ,iBAAAA;aACAC,YAAAA;QAGjB,IAAI,CAACC,WAAW,GAAG;YACfG,WAAW;YACXC,WAAW;gBACPC,QAAQ;gBACRC,SAAS;YACb;WACGN;QAGP,wBAAwB;QACxB,IAAI,CAACC,cAAc,GAAG,IAAIN,WAAW;YACjCY,eAAe;gBACXC,SAAS;gBACTC,gBAAgB,mBACR,EAAA,gCAAA,IAAI,CAACX,cAAc,CAACY,QAAQ,cAA5B,oDAAA,8BAA8BC,OAAO,KAAI;oBACzC,gBAAgB,IAAI,CAACb,cAAc,CAACY,QAAQ,CAACC,OAAO;gBACxD,GACI,EAAA,iCAAA,IAAI,CAACb,cAAc,CAACY,QAAQ,cAA5B,qDAAA,+BAA8BE,WAAW,KAAI;oBAC7C,WAAW,IAAI,CAACd,cAAc,CAACY,QAAQ,CAACE,WAAW;gBACvD;YAER;YACAT,WAAW,IAAI,CAACH,WAAW,CAACG,SAAS;WACjC,IAAI,CAACH,WAAW,CAACI,SAAS,IAAI;YAC9BS,aAAa;gBACTT,WAAW,IAAI,CAACJ,WAAW,CAACI,SAAS;YACzC;QACJ;YACAL,WAAW,IAAI,CAACA,SAAS;YACzBe,cAAc,IAAI,CAAChB,cAAc,CAACiB,MAAM;;QAG5C,4BAA4B;QAC5B,IAAMC,aAAapB,iBAAiB;YAChCmB,QAAQ,IAAI,CAACjB,cAAc,CAACiB,MAAM;QACtC;QAEA,IAAI,CAACb,WAAW,GAAGc,WAAW,IAAI,CAACjB,SAAS,EAAE,mBACtC,IAAI,CAACC,WAAW,CAACG,SAAS,IAAI;YAAEA,WAAW,IAAI,CAACH,WAAW,CAACG,SAAS;QAAC,GACtE,IAAI,CAACH,WAAW,CAACI,SAAS,IAAI;YAC9Ba,WAAW;gBACPb,WAAW,IAAI,CAACJ,WAAW,CAACI,SAAS;YACzC;QACJ;;kBArDCP;;YAyDT;;KAEC,GACDqB,KAAAA;mBAAAA,SAAAA;gBACI,OAAO,IAAI,CAACjB,cAAc;YAC9B;;;YAEA;;KAEC,GACDkB,KAAAA;mBAAAA,SAAAA;gBACI,OAAO,IAAI,CAACjB,WAAW;YAC3B;;;WArESL;IAsEZ"}

package/dist/adapters/prompts/__tests__/presets.test.js

@@ -1,10 +1,10 @@
 import { describe, expect, it } from '@jterrazz/test';
 import { PROMPT_LIBRARY } from '../library/index.js';
-import { SystemPromptAdapter } from '../system-prompt.adapter.js';
+import { SystemPrompt } from '../system-prompt.adapter.js';
 describe('Prompt Library Presets', function() {
     it('should generate the correct prompt for DISCORD_COMMUNITY_ANIMATOR', function() {
         // Given - a Discord community animator preset
-        var prompt = new SystemPromptAdapter(PROMPT_LIBRARY.PRESETS.COMMUNITY_ANIMATOR);
+        var prompt = new SystemPrompt(PROMPT_LIBRARY.PRESETS.COMMUNITY_ANIMATOR);
         // When - generating the prompt
         var result = prompt.generate();
         // Then - it should match the expected snapshot
@@ -12,7 +12,7 @@ describe('Prompt Library Presets', function() {
     });
     it('should generate the correct prompt for EMPATHETIC_SUPPORT_AGENT', function() {
         // Given - an empathetic support agent preset
-        var prompt = new SystemPromptAdapter(PROMPT_LIBRARY.PRESETS.EMPATHETIC_SUPPORT_AGENT);
+        var prompt = new SystemPrompt(PROMPT_LIBRARY.PRESETS.EMPATHETIC_SUPPORT_AGENT);
         // When - generating the prompt
         var result = prompt.generate();
         // Then - it should match the expected snapshot
@@ -20,7 +20,7 @@ describe('Prompt Library Presets', function() {
     });
     it('should generate the correct prompt for CREATIVE_BRAINSTORMER', function() {
         // Given - a creative brainstormer preset
-        var prompt = new SystemPromptAdapter(PROMPT_LIBRARY.PRESETS.CREATIVE_BRAINSTORMER);
+        var prompt = new SystemPrompt(PROMPT_LIBRARY.PRESETS.CREATIVE_BRAINSTORMER);
         // When - generating the prompt
         var result = prompt.generate();
         // Then - it should match the expected snapshot

package/dist/adapters/prompts/__tests__/presets.test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/adapters/prompts/__tests__/presets.test.ts"],"sourcesContent":["import { describe, expect, it } from '@jterrazz/test';\n\nimport { PROMPT_LIBRARY } from '../library/index.js';\nimport { SystemPromptAdapter } from '../system-prompt.adapter.js';\n\ndescribe('Prompt Library Presets', () => {\n    it('should generate the correct prompt for DISCORD_COMMUNITY_ANIMATOR', () => {\n        // Given - a Discord community animator preset\n        const prompt = new SystemPromptAdapter(PROMPT_LIBRARY.PRESETS.COMMUNITY_ANIMATOR);\n\n        // When - generating the prompt\n        const result = prompt.generate();\n\n        // Then - it should match the expected snapshot\n        expect(result).toMatchSnapshot();\n    });\n\n    it('should generate the correct prompt for EMPATHETIC_SUPPORT_AGENT', () => {\n        // Given - an empathetic support agent preset\n        const prompt = new SystemPromptAdapter(PROMPT_LIBRARY.PRESETS.EMPATHETIC_SUPPORT_AGENT);\n\n        // When - generating the prompt\n        const result = prompt.generate();\n\n        // Then - it should match the expected snapshot\n        expect(result).toMatchSnapshot();\n    });\n\n    it('should generate the correct prompt for CREATIVE_BRAINSTORMER', () => {\n        // Given - a creative brainstormer preset\n        const prompt = new SystemPromptAdapter(PROMPT_LIBRARY.PRESETS.CREATIVE_BRAINSTORMER);\n\n        // When - generating the prompt\n        const result = prompt.generate();\n\n        // Then - it should match the expected snapshot\n        expect(result).toMatchSnapshot();\n    });\n});\n"],"names":["describe","expect","it","PROMPT_LIBRARY","SystemPromptAdapter","prompt","PRESETS","COMMUNITY_ANIMATOR","result","generate","toMatchSnapshot","EMPATHETIC_SUPPORT_AGENT","CREATIVE_BRAINSTORMER"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,iBAAiB;AAEtD,SAASC,cAAc,QAAQ,sBAAsB;AACrD,SAASC,mBAAmB,QAAQ,8BAA8B;AAElEJ,SAAS,0BAA0B;IAC/BE,GAAG,qEAAqE;QACpE,8CAA8C;QAC9C,IAAMG,SAAS,IAAID,oBAAoBD,eAAeG,OAAO,CAACC,kBAAkB;QAEhF,+BAA+B;QAC/B,IAAMC,SAASH,OAAOI,QAAQ;QAE9B,+CAA+C;QAC/CR,OAAOO,QAAQE,eAAe;IAClC;IAEAR,GAAG,mEAAmE;QAClE,6CAA6C;QAC7C,IAAMG,SAAS,IAAID,oBAAoBD,eAAeG,OAAO,CAACK,wBAAwB;QAEtF,+BAA+B;QAC/B,IAAMH,SAASH,OAAOI,QAAQ;QAE9B,+CAA+C;QAC/CR,OAAOO,QAAQE,eAAe;IAClC;IAEAR,GAAG,gEAAgE;QAC/D,yCAAyC;QACzC,IAAMG,SAAS,IAAID,oBAAoBD,eAAeG,OAAO,CAACM,qBAAqB;QAEnF,+BAA+B;QAC/B,IAAMJ,SAASH,OAAOI,QAAQ;QAE9B,+CAA+C;QAC/CR,OAAOO,QAAQE,eAAe;IAClC;AACJ"}
+{"version":3,"sources":["../../../../src/adapters/prompts/__tests__/presets.test.ts"],"sourcesContent":["import { describe, expect, it } from '@jterrazz/test';\n\nimport { PROMPT_LIBRARY } from '../library/index.js';\nimport { SystemPrompt } from '../system-prompt.adapter.js';\n\ndescribe('Prompt Library Presets', () => {\n    it('should generate the correct prompt for DISCORD_COMMUNITY_ANIMATOR', () => {\n        // Given - a Discord community animator preset\n        const prompt = new SystemPrompt(PROMPT_LIBRARY.PRESETS.COMMUNITY_ANIMATOR);\n\n        // When - generating the prompt\n        const result = prompt.generate();\n\n        // Then - it should match the expected snapshot\n        expect(result).toMatchSnapshot();\n    });\n\n    it('should generate the correct prompt for EMPATHETIC_SUPPORT_AGENT', () => {\n        // Given - an empathetic support agent preset\n        const prompt = new SystemPrompt(PROMPT_LIBRARY.PRESETS.EMPATHETIC_SUPPORT_AGENT);\n\n        // When - generating the prompt\n        const result = prompt.generate();\n\n        // Then - it should match the expected snapshot\n        expect(result).toMatchSnapshot();\n    });\n\n    it('should generate the correct prompt for CREATIVE_BRAINSTORMER', () => {\n        // Given - a creative brainstormer preset\n        const prompt = new SystemPrompt(PROMPT_LIBRARY.PRESETS.CREATIVE_BRAINSTORMER);\n\n        // When - generating the prompt\n        const result = prompt.generate();\n\n        // Then - it should match the expected snapshot\n        expect(result).toMatchSnapshot();\n    });\n});\n"],"names":["describe","expect","it","PROMPT_LIBRARY","SystemPrompt","prompt","PRESETS","COMMUNITY_ANIMATOR","result","generate","toMatchSnapshot","EMPATHETIC_SUPPORT_AGENT","CREATIVE_BRAINSTORMER"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,iBAAiB;AAEtD,SAASC,cAAc,QAAQ,sBAAsB;AACrD,SAASC,YAAY,QAAQ,8BAA8B;AAE3DJ,SAAS,0BAA0B;IAC/BE,GAAG,qEAAqE;QACpE,8CAA8C;QAC9C,IAAMG,SAAS,IAAID,aAAaD,eAAeG,OAAO,CAACC,kBAAkB;QAEzE,+BAA+B;QAC/B,IAAMC,SAASH,OAAOI,QAAQ;QAE9B,+CAA+C;QAC/CR,OAAOO,QAAQE,eAAe;IAClC;IAEAR,GAAG,mEAAmE;QAClE,6CAA6C;QAC7C,IAAMG,SAAS,IAAID,aAAaD,eAAeG,OAAO,CAACK,wBAAwB;QAE/E,+BAA+B;QAC/B,IAAMH,SAASH,OAAOI,QAAQ;QAE9B,+CAA+C;QAC/CR,OAAOO,QAAQE,eAAe;IAClC;IAEAR,GAAG,gEAAgE;QAC/D,yCAAyC;QACzC,IAAMG,SAAS,IAAID,aAAaD,eAAeG,OAAO,CAACM,qBAAqB;QAE5E,+BAA+B;QAC/B,IAAMJ,SAASH,OAAOI,QAAQ;QAE9B,+CAA+C;QAC/CR,OAAOO,QAAQE,eAAe;IAClC;AACJ"}

package/dist/adapters/prompts/system-prompt.adapter.d.ts

@@ -1,8 +1,8 @@
 import type { PromptPort } from '../../ports/prompt.port.js';
 /**
- * System prompt adapter that generates a system prompt from a list of strings
+ * System prompt that generates a system prompt from a list of strings
  */
-export declare class SystemPromptAdapter implements PromptPort {
+export declare class SystemPrompt implements PromptPort {
     private readonly finalPrompt;
     constructor(...prompts: readonly (readonly string[] | string)[]);
     generate(): string;