@jterrazz/intelligence 1.6.1 → 2.0.0

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) {
@@ -288,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();
                                 });
@@ -381,7 +381,7 @@ 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('Failed to validate response content against schema.', {
@@ -394,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;

package/dist/adapters/prompts/system-prompt.adapter.js

@@ -31,19 +31,19 @@ function _define_property(obj, key, value) {
     return obj;
 }
 /**
- * System prompt adapter that generates a system prompt from a list of strings
- */ export var SystemPromptAdapter = /*#__PURE__*/ function() {
+ * System prompt that generates a system prompt from a list of strings
+ */ export var SystemPrompt = /*#__PURE__*/ function() {
     "use strict";
-    function SystemPromptAdapter() {
+    function SystemPrompt() {
         for(var _len = arguments.length, prompts = new Array(_len), _key = 0; _key < _len; _key++){
             prompts[_key] = arguments[_key];
         }
-        _class_call_check(this, SystemPromptAdapter);
+        _class_call_check(this, SystemPrompt);
         _define_property(this, "finalPrompt", void 0);
         var flattenedPrompts = prompts.flat();
         this.finalPrompt = flattenedPrompts.join('\n\n');
     }
-    _create_class(SystemPromptAdapter, [
+    _create_class(SystemPrompt, [
         {
             key: "generate",
             value: function generate() {
@@ -51,7 +51,7 @@ function _define_property(obj, key, value) {
             }
         }
     ]);
-    return SystemPromptAdapter;
+    return SystemPrompt;
 }();
 
 //# sourceMappingURL=system-prompt.adapter.js.map

package/dist/adapters/prompts/system-prompt.adapter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/adapters/prompts/system-prompt.adapter.ts"],"sourcesContent":["import type { PromptPort } from '../../ports/prompt.port.js';\n\n/**\n * System prompt adapter that generates a system prompt from a list of strings\n */\nexport class SystemPromptAdapter implements PromptPort {\n    private readonly finalPrompt: string;\n\n    constructor(...prompts: readonly (readonly string[] | string)[]) {\n        const flattenedPrompts = prompts.flat();\n        this.finalPrompt = flattenedPrompts.join('\\n\\n');\n    }\n\n    generate(): string {\n        return this.finalPrompt;\n    }\n}\n"],"names":["SystemPromptAdapter","prompts","finalPrompt","flattenedPrompts","flat","join","generate"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;CAEC,GACD,OAAO,IAAA,AAAMA,oCAAN;;aAAMA;QAGG,IAAA,IAAA,OAAA,UAAA,QAAA,AAAGC,UAAH,UAAA,OAAA,OAAA,GAAA,OAAA,MAAA;YAAGA,QAAH,QAAA,SAAA,CAAA,KAAmD;;gCAHtDD;QACT,uBAAiBE,eAAjB,KAAA;QAGI,IAAMC,mBAAmBF,QAAQG,IAAI;QACrC,IAAI,CAACF,WAAW,GAAGC,iBAAiBE,IAAI,CAAC;;kBALpCL;;YAQTM,KAAAA;mBAAAA,SAAAA;gBACI,OAAO,IAAI,CAACJ,WAAW;YAC3B;;;WAVSF;IAWZ"}
+{"version":3,"sources":["../../../src/adapters/prompts/system-prompt.adapter.ts"],"sourcesContent":["import type { PromptPort } from '../../ports/prompt.port.js';\n\n/**\n * System prompt that generates a system prompt from a list of strings\n */\nexport class SystemPrompt implements PromptPort {\n    private readonly finalPrompt: string;\n\n    constructor(...prompts: readonly (readonly string[] | string)[]) {\n        const flattenedPrompts = prompts.flat();\n        this.finalPrompt = flattenedPrompts.join('\\n\\n');\n    }\n\n    generate(): string {\n        return this.finalPrompt;\n    }\n}\n"],"names":["SystemPrompt","prompts","finalPrompt","flattenedPrompts","flat","join","generate"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;CAEC,GACD,OAAO,IAAA,AAAMA,6BAAN;;aAAMA;QAGG,IAAA,IAAA,OAAA,UAAA,QAAA,AAAGC,UAAH,UAAA,OAAA,OAAA,GAAA,OAAA,MAAA;YAAGA,QAAH,QAAA,SAAA,CAAA,KAAmD;;gCAHtDD;QACT,uBAAiBE,eAAjB,KAAA;QAGI,IAAMC,mBAAmBF,QAAQG,IAAI;QACrC,IAAI,CAACF,WAAW,GAAGC,iBAAiBE,IAAI,CAAC;;kBALpCL;;YAQTM,KAAAA;mBAAAA,SAAAA;gBACI,OAAO,IAAI,CAACJ,WAAW;YAC3B;;;WAVSF;IAWZ"}

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

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

package/dist/adapters/prompts/user-prompt.adapter.js

@@ -31,19 +31,19 @@ function _define_property(obj, key, value) {
     return obj;
 }
 /**
- * User prompt adapter that generates a user prompt from a list of strings
- */ export var UserPromptAdapter = /*#__PURE__*/ function() {
+ * User prompt that generates a user prompt from a list of strings
+ */ export var UserPrompt = /*#__PURE__*/ function() {
     "use strict";
-    function UserPromptAdapter() {
+    function UserPrompt() {
         for(var _len = arguments.length, prompts = new Array(_len), _key = 0; _key < _len; _key++){
             prompts[_key] = arguments[_key];
         }
-        _class_call_check(this, UserPromptAdapter);
+        _class_call_check(this, UserPrompt);
         _define_property(this, "finalPrompt", void 0);
         var flattenedPrompts = prompts.flat();
         this.finalPrompt = flattenedPrompts.join('\n\n');
     }
-    _create_class(UserPromptAdapter, [
+    _create_class(UserPrompt, [
         {
             key: "generate",
             value: function generate() {
@@ -51,7 +51,7 @@ function _define_property(obj, key, value) {
             }
         }
     ]);
-    return UserPromptAdapter;
+    return UserPrompt;
 }();
 
 //# sourceMappingURL=user-prompt.adapter.js.map

package/dist/adapters/prompts/user-prompt.adapter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/adapters/prompts/user-prompt.adapter.ts"],"sourcesContent":["import type { PromptPort } from '../../ports/prompt.port.js';\n\n/**\n * User prompt adapter that generates a user prompt from a list of strings\n */\nexport class UserPromptAdapter implements PromptPort {\n    private readonly finalPrompt: string;\n\n    constructor(...prompts: readonly (readonly string[] | string)[]) {\n        const flattenedPrompts = prompts.flat();\n        this.finalPrompt = flattenedPrompts.join('\\n\\n');\n    }\n\n    generate(): string {\n        return this.finalPrompt;\n    }\n}\n"],"names":["UserPromptAdapter","prompts","finalPrompt","flattenedPrompts","flat","join","generate"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;CAEC,GACD,OAAO,IAAA,AAAMA,kCAAN;;aAAMA;QAGG,IAAA,IAAA,OAAA,UAAA,QAAA,AAAGC,UAAH,UAAA,OAAA,OAAA,GAAA,OAAA,MAAA;YAAGA,QAAH,QAAA,SAAA,CAAA,KAAmD;;gCAHtDD;QACT,uBAAiBE,eAAjB,KAAA;QAGI,IAAMC,mBAAmBF,QAAQG,IAAI;QACrC,IAAI,CAACF,WAAW,GAAGC,iBAAiBE,IAAI,CAAC;;kBALpCL;;YAQTM,KAAAA;mBAAAA,SAAAA;gBACI,OAAO,IAAI,CAACJ,WAAW;YAC3B;;;WAVSF;IAWZ"}
+{"version":3,"sources":["../../../src/adapters/prompts/user-prompt.adapter.ts"],"sourcesContent":["import type { PromptPort } from '../../ports/prompt.port.js';\n\n/**\n * User prompt that generates a user prompt from a list of strings\n */\nexport class UserPrompt implements PromptPort {\n    private readonly finalPrompt: string;\n\n    constructor(...prompts: readonly (readonly string[] | string)[]) {\n        const flattenedPrompts = prompts.flat();\n        this.finalPrompt = flattenedPrompts.join('\\n\\n');\n    }\n\n    generate(): string {\n        return this.finalPrompt;\n    }\n}\n"],"names":["UserPrompt","prompts","finalPrompt","flattenedPrompts","flat","join","generate"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA;;CAEC,GACD,OAAO,IAAA,AAAMA,2BAAN;;aAAMA;QAGG,IAAA,IAAA,OAAA,UAAA,QAAA,AAAGC,UAAH,UAAA,OAAA,OAAA,GAAA,OAAA,MAAA;YAAGA,QAAH,QAAA,SAAA,CAAA,KAAmD;;gCAHtDD;QACT,uBAAiBE,eAAjB,KAAA;QAGI,IAAMC,mBAAmBF,QAAQG,IAAI;QACrC,IAAI,CAACF,WAAW,GAAGC,iBAAiBE,IAAI,CAAC;;kBALpCL;;YAQTM,KAAAA;mBAAAA,SAAAA;gBACI,OAAO,IAAI,CAACJ,WAAW;YAC3B;;;WAVSF;IAWZ"}

package/dist/adapters/providers/openrouter-provider.adapter.d.ts

@@ -0,0 +1,34 @@
+import type { ModelConfig } from '../../ports/model.port.js';
+import type { ProviderPort } from '../../ports/provider.port.js';
+import { OpenRouterModel } from '../models/openrouter-model.adapter.js';
+export interface OpenRouterConfig {
+    /**
+     * OpenRouter API key
+     */
+    apiKey: string;
+    /**
+     * Optional metadata for request headers
+     */
+    metadata?: OpenRouterMetadata;
+}
+export interface OpenRouterMetadata {
+    /**
+     * Application title for X-Title header
+     */
+    application?: string;
+    /**
+     * Website URL for HTTP-Referer header
+     */
+    website?: string;
+}
+/**
+ * OpenRouter provider that manages connection configuration
+ */
+export declare class OpenRouterProvider implements ProviderPort {
+    private readonly config;
+    constructor(config: OpenRouterConfig);
+    /**
+     * Get a model instance for the specified model name
+     */
+    getModel(modelName: string, modelConfig?: ModelConfig): OpenRouterModel;
+}

package/dist/adapters/providers/openrouter-provider.adapter.js

@@ -0,0 +1,57 @@
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _defineProperties(target, props) {
+    for(var i = 0; i < props.length; i++){
+        var descriptor = props[i];
+        descriptor.enumerable = descriptor.enumerable || false;
+        descriptor.configurable = true;
+        if ("value" in descriptor) descriptor.writable = true;
+        Object.defineProperty(target, descriptor.key, descriptor);
+    }
+}
+function _create_class(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+    if (staticProps) _defineProperties(Constructor, staticProps);
+    return Constructor;
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+import { OpenRouterModel } from '../models/openrouter-model.adapter.js';
+/**
+ * OpenRouter provider that manages connection configuration
+ */ export var OpenRouterProvider = /*#__PURE__*/ function() {
+    "use strict";
+    function OpenRouterProvider(config) {
+        _class_call_check(this, OpenRouterProvider);
+        _define_property(this, "config", void 0);
+        this.config = config;
+    }
+    _create_class(OpenRouterProvider, [
+        {
+            /**
+     * Get a model instance for the specified model name
+     */ key: "getModel",
+            value: function getModel(modelName) {
+                var modelConfig = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
+                return new OpenRouterModel(this.config, modelName, modelConfig);
+            }
+        }
+    ]);
+    return OpenRouterProvider;
+}();
+
+//# sourceMappingURL=openrouter-provider.adapter.js.map

package/dist/adapters/providers/openrouter-provider.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/providers/openrouter-provider.adapter.ts"],"sourcesContent":["import type { ModelConfig } from '../../ports/model.port.js';\nimport type { ProviderPort } from '../../ports/provider.port.js';\n\nimport { OpenRouterModel } from '../models/openrouter-model.adapter.js';\n\nexport interface OpenRouterConfig {\n    /**\n     * OpenRouter API key\n     */\n    apiKey: string;\n    /**\n     * Optional metadata for request headers\n     */\n    metadata?: OpenRouterMetadata;\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 provider that manages connection configuration\n */\nexport class OpenRouterProvider implements ProviderPort {\n    constructor(private readonly config: OpenRouterConfig) {}\n\n    /**\n     * Get a model instance for the specified model name\n     */\n    getModel(modelName: string, modelConfig: ModelConfig = {}) {\n        return new OpenRouterModel(this.config, modelName, modelConfig);\n    }\n}\n"],"names":["OpenRouterModel","OpenRouterProvider","config","getModel","modelName","modelConfig"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,SAASA,eAAe,QAAQ,wCAAwC;AAwBxE;;CAEC,GACD,OAAO,IAAA,AAAMC,mCAAN;;aAAMA,mBACG,AAAiBC,MAAwB;gCAD5CD;;aACoBC,SAAAA;;kBADpBD;;YAGT;;KAEC,GACDE,KAAAA;mBAAAA,SAAAA,SAASC,SAAiB;oBAAEC,cAAAA,iEAA2B,CAAC;gBACpD,OAAO,IAAIL,gBAAgB,IAAI,CAACE,MAAM,EAAEE,WAAWC;YACvD;;;WARSJ;IASZ"}

package/dist/adapters/tools/safe-tool.adapter.d.ts

@@ -13,9 +13,9 @@ export type ToolConfig<T = void> = {
 };
 export type ToolFunction<T = void> = T extends void ? () => Promise<string> : (args: T) => Promise<string>;
 /**
- * Safe tool adapter that provides error handling and logging for LangChain tools
+ * Safe tool that provides error handling and logging for LangChain tools
  */
-export declare class SafeToolAdapter<T = void> implements ToolPort {
+export declare class SafeTool<T = void> implements ToolPort {
     private readonly config;
     private readonly options;
     private readonly dynamicTool;