@jterrazz/intelligence 1.5.0 → 2.0.0

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;

package/dist/adapters/tools/safe-tool.adapter.js

@@ -159,12 +159,12 @@ function _ts_generator(thisArg, body) {
 }
 import { DynamicStructuredTool, DynamicTool } from 'langchain/tools';
 /**
- * Safe tool adapter that provides error handling and logging for LangChain tools
- */ export var SafeToolAdapter = /*#__PURE__*/ function() {
+ * Safe tool that provides error handling and logging for LangChain tools
+ */ export var SafeTool = /*#__PURE__*/ function() {
     "use strict";
-    function SafeToolAdapter(config) {
+    function SafeTool(config) {
         var options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
-        _class_call_check(this, SafeToolAdapter);
+        _class_call_check(this, SafeTool);
         _define_property(this, "config", void 0);
         _define_property(this, "options", void 0);
         _define_property(this, "dynamicTool", void 0);
@@ -267,7 +267,7 @@ import { DynamicStructuredTool, DynamicTool } from 'langchain/tools';
             });
         }
     }
-    _create_class(SafeToolAdapter, [
+    _create_class(SafeTool, [
         {
             /**
      * Get the underlying LangChain DynamicTool instance
@@ -277,7 +277,7 @@ import { DynamicStructuredTool, DynamicTool } from 'langchain/tools';
             }
         }
     ]);
-    return SafeToolAdapter;
+    return SafeTool;
 }();
 
 //# sourceMappingURL=safe-tool.adapter.js.map

package/dist/adapters/tools/safe-tool.adapter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/adapters/tools/safe-tool.adapter.ts"],"sourcesContent":["import type { LoggerPort } from '@jterrazz/logger';\nimport { DynamicStructuredTool, DynamicTool } from 'langchain/tools';\nimport type { z } from 'zod/v4';\n\nimport type { ToolPort } from '../../ports/tool.port.js';\n\nexport interface SafeToolOptions<T> {\n    logger?: LoggerPort;\n    schema?: z.ZodSchema<T>;\n}\n\nexport type ToolConfig<T = void> = {\n    description: string;\n    execute: ToolFunction<T>;\n    name: string;\n};\n\nexport type ToolFunction<T = void> = T extends void\n    ? () => Promise<string>\n    : (args: T) => Promise<string>;\n\n/**\n * Safe tool adapter that provides error handling and logging for LangChain tools\n */\nexport class SafeToolAdapter<T = void> implements ToolPort {\n    private readonly dynamicTool: DynamicStructuredTool<z.ZodSchema<T>> | DynamicTool;\n\n    constructor(\n        private readonly config: ToolConfig<T>,\n        private readonly options: SafeToolOptions<T> = {},\n    ) {\n        const { logger, schema } = options;\n\n        if (schema) {\n            // Use DynamicStructuredTool for parameterized tools\n            this.dynamicTool = new DynamicStructuredTool({\n                description: config.description,\n                func: async (args: T) => {\n                    try {\n                        return await (config.execute as ToolFunction<T>)(args);\n                    } catch (error) {\n                        const errorMessage = error instanceof Error ? error.message : String(error);\n\n                        logger?.error(`Unexpected error in ${config.name}`, {\n                            args,\n                            error: errorMessage,\n                            toolName: config.name,\n                        });\n\n                        return `Tool ${config.name} failed to execute`;\n                    }\n                },\n                name: config.name,\n                schema: schema,\n            });\n        } else {\n            // Use DynamicTool for simple tools\n            this.dynamicTool = new DynamicTool({\n                description: config.description,\n                func: async () => {\n                    try {\n                        return await (config.execute as ToolFunction<void>)();\n                    } catch (error) {\n                        const errorMessage = error instanceof Error ? error.message : String(error);\n\n                        logger?.error(`Unexpected error in ${config.name}`, {\n                            error: errorMessage,\n                            toolName: config.name,\n                        });\n\n                        return `Tool ${config.name} failed to execute`;\n                    }\n                },\n                name: config.name,\n            });\n        }\n    }\n\n    /**\n     * Get the underlying LangChain DynamicTool instance\n     */\n    getDynamicTool(): DynamicStructuredTool<z.ZodSchema<unknown>> | DynamicTool {\n        return this.dynamicTool as DynamicStructuredTool<z.ZodSchema<unknown>> | DynamicTool;\n    }\n}\n"],"names":["DynamicStructuredTool","DynamicTool","SafeToolAdapter","config","options","dynamicTool","logger","schema","description","func","args","error","errorMessage","execute","Error","message","String","name","toolName","getDynamicTool"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,SAASA,qBAAqB,EAAEC,WAAW,QAAQ,kBAAkB;AAoBrE;;CAEC,GACD,OAAO,IAAA,AAAMC,gCAAN;;aAAMA,gBAIL,AAAiBC,MAAqB;YACtC,AAAiBC,UAAjB,iEAA+C,CAAC;gCAL3CF;;;QACT,uBAAiBG,eAAjB,KAAA;aAGqBF,SAAAA;aACAC,UAAAA;QAEjB,IAAQE,SAAmBF,QAAnBE,QAAQC,SAAWH,QAAXG;QAEhB,IAAIA,QAAQ;YACR,oDAAoD;YACpD,IAAI,CAACF,WAAW,GAAG,IAAIL,sBAAsB;gBACzCQ,aAAaL,OAAOK,WAAW;gBAC/BC,MAAM,SAAOC;;4BAGAC,OACCC;;;;;;;;;;oCAFC;;wCAAOT,OAAOU,OAAO,CAAqBH;;;oCAAjD;;wCAAO;;;oCACFC;oCACCC,eAAeD,AAAK,YAALA,OAAiBG,SAAQH,MAAMI,OAAO,GAAGC,OAAOL;oCAErEL,mBAAAA,6BAAAA,OAAQK,KAAK,CAAC,AAAC,uBAAkC,OAAZR,OAAOc,IAAI,GAAI;wCAChDP,MAAAA;wCACAC,OAAOC;wCACPM,UAAUf,OAAOc,IAAI;oCACzB;oCAEA;;wCAAQ,QAAmB,OAAZd,OAAOc,IAAI,EAAC;;;;;;;;oBAEnC;;gBACAA,MAAMd,OAAOc,IAAI;gBACjBV,QAAQA;YACZ;QACJ,OAAO;YACH,mCAAmC;YACnC,IAAI,CAACF,WAAW,GAAG,IAAIJ,YAAY;gBAC/BO,aAAaL,OAAOK,WAAW;gBAC/BC,MAAM;;4BAGOE,OACCC;;;;;;;;;;oCAFC;;wCAAOT,OAAOU,OAAO;;;oCAA5B;;wCAAO;;;oCACFF;oCACCC,eAAeD,AAAK,YAALA,OAAiBG,SAAQH,MAAMI,OAAO,GAAGC,OAAOL;oCAErEL,mBAAAA,6BAAAA,OAAQK,KAAK,CAAC,AAAC,uBAAkC,OAAZR,OAAOc,IAAI,GAAI;wCAChDN,OAAOC;wCACPM,UAAUf,OAAOc,IAAI;oCACzB;oCAEA;;wCAAQ,QAAmB,OAAZd,OAAOc,IAAI,EAAC;;;;;;;;oBAEnC;;gBACAA,MAAMd,OAAOc,IAAI;YACrB;QACJ;;kBAnDKf;;YAsDT;;KAEC,GACDiB,KAAAA;mBAAAA,SAAAA;gBACI,OAAO,IAAI,CAACd,WAAW;YAC3B;;;WA3DSH;IA4DZ"}
+{"version":3,"sources":["../../../src/adapters/tools/safe-tool.adapter.ts"],"sourcesContent":["import type { LoggerPort } from '@jterrazz/logger';\nimport { DynamicStructuredTool, DynamicTool } from 'langchain/tools';\nimport type { z } from 'zod/v4';\n\nimport type { ToolPort } from '../../ports/tool.port.js';\n\nexport interface SafeToolOptions<T> {\n    logger?: LoggerPort;\n    schema?: z.ZodSchema<T>;\n}\n\nexport type ToolConfig<T = void> = {\n    description: string;\n    execute: ToolFunction<T>;\n    name: string;\n};\n\nexport type ToolFunction<T = void> = T extends void\n    ? () => Promise<string>\n    : (args: T) => Promise<string>;\n\n/**\n * Safe tool that provides error handling and logging for LangChain tools\n */\nexport class SafeTool<T = void> implements ToolPort {\n    private readonly dynamicTool: DynamicStructuredTool<z.ZodSchema<T>> | DynamicTool;\n\n    constructor(\n        private readonly config: ToolConfig<T>,\n        private readonly options: SafeToolOptions<T> = {},\n    ) {\n        const { logger, schema } = options;\n\n        if (schema) {\n            // Use DynamicStructuredTool for parameterized tools\n            this.dynamicTool = new DynamicStructuredTool({\n                description: config.description,\n                func: async (args: T) => {\n                    try {\n                        return await (config.execute as ToolFunction<T>)(args);\n                    } catch (error) {\n                        const errorMessage = error instanceof Error ? error.message : String(error);\n\n                        logger?.error(`Unexpected error in ${config.name}`, {\n                            args,\n                            error: errorMessage,\n                            toolName: config.name,\n                        });\n\n                        return `Tool ${config.name} failed to execute`;\n                    }\n                },\n                name: config.name,\n                schema: schema,\n            });\n        } else {\n            // Use DynamicTool for simple tools\n            this.dynamicTool = new DynamicTool({\n                description: config.description,\n                func: async () => {\n                    try {\n                        return await (config.execute as ToolFunction<void>)();\n                    } catch (error) {\n                        const errorMessage = error instanceof Error ? error.message : String(error);\n\n                        logger?.error(`Unexpected error in ${config.name}`, {\n                            error: errorMessage,\n                            toolName: config.name,\n                        });\n\n                        return `Tool ${config.name} failed to execute`;\n                    }\n                },\n                name: config.name,\n            });\n        }\n    }\n\n    /**\n     * Get the underlying LangChain DynamicTool instance\n     */\n    getDynamicTool(): DynamicStructuredTool<z.ZodSchema<unknown>> | DynamicTool {\n        return this.dynamicTool as DynamicStructuredTool<z.ZodSchema<unknown>> | DynamicTool;\n    }\n}\n"],"names":["DynamicStructuredTool","DynamicTool","SafeTool","config","options","dynamicTool","logger","schema","description","func","args","error","errorMessage","execute","Error","message","String","name","toolName","getDynamicTool"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,SAASA,qBAAqB,EAAEC,WAAW,QAAQ,kBAAkB;AAoBrE;;CAEC,GACD,OAAO,IAAA,AAAMC,yBAAN;;aAAMA,SAIL,AAAiBC,MAAqB;YACtC,AAAiBC,UAAjB,iEAA+C,CAAC;gCAL3CF;;;QACT,uBAAiBG,eAAjB,KAAA;aAGqBF,SAAAA;aACAC,UAAAA;QAEjB,IAAQE,SAAmBF,QAAnBE,QAAQC,SAAWH,QAAXG;QAEhB,IAAIA,QAAQ;YACR,oDAAoD;YACpD,IAAI,CAACF,WAAW,GAAG,IAAIL,sBAAsB;gBACzCQ,aAAaL,OAAOK,WAAW;gBAC/BC,MAAM,SAAOC;;4BAGAC,OACCC;;;;;;;;;;oCAFC;;wCAAOT,OAAOU,OAAO,CAAqBH;;;oCAAjD;;wCAAO;;;oCACFC;oCACCC,eAAeD,AAAK,YAALA,OAAiBG,SAAQH,MAAMI,OAAO,GAAGC,OAAOL;oCAErEL,mBAAAA,6BAAAA,OAAQK,KAAK,CAAC,AAAC,uBAAkC,OAAZR,OAAOc,IAAI,GAAI;wCAChDP,MAAAA;wCACAC,OAAOC;wCACPM,UAAUf,OAAOc,IAAI;oCACzB;oCAEA;;wCAAQ,QAAmB,OAAZd,OAAOc,IAAI,EAAC;;;;;;;;oBAEnC;;gBACAA,MAAMd,OAAOc,IAAI;gBACjBV,QAAQA;YACZ;QACJ,OAAO;YACH,mCAAmC;YACnC,IAAI,CAACF,WAAW,GAAG,IAAIJ,YAAY;gBAC/BO,aAAaL,OAAOK,WAAW;gBAC/BC,MAAM;;4BAGOE,OACCC;;;;;;;;;;oCAFC;;wCAAOT,OAAOU,OAAO;;;oCAA5B;;wCAAO;;;oCACFF;oCACCC,eAAeD,AAAK,YAALA,OAAiBG,SAAQH,MAAMI,OAAO,GAAGC,OAAOL;oCAErEL,mBAAAA,6BAAAA,OAAQK,KAAK,CAAC,AAAC,uBAAkC,OAAZR,OAAOc,IAAI,GAAI;wCAChDN,OAAOC;wCACPM,UAAUf,OAAOc,IAAI;oCACzB;oCAEA;;wCAAQ,QAAmB,OAAZd,OAAOc,IAAI,EAAC;;;;;;;;oBAEnC;;gBACAA,MAAMd,OAAOc,IAAI;YACrB;QACJ;;kBAnDKf;;YAsDT;;KAEC,GACDiB,KAAAA;mBAAAA,SAAAA;gBACI,OAAO,IAAI,CAACd,WAAW;YAC3B;;;WA3DSH;IA4DZ"}

package/dist/adapters/utils/__tests__/{ai-response-parser.test.js → structured-response-parser.test.js}

@@ -1,7 +1,7 @@
 import { describe, expect, it } from '@jterrazz/test';
 import { z } from 'zod/v4';
-import { AIResponseParser } from '../ai-response-parser.js';
-import { AIResponseParserError } from '../ai-response-parser-error.js';
+import { StructuredResponseParser } from '../structured-response-parser.js';
+import { StructuredResponseParserError } from '../structured-response-parser-error.js';
 // Test data
 var testSchema = z.object({
     content: z.string(),
@@ -17,12 +17,12 @@ var validJson = {
     title: 'Test Article'
 };
 var validJsonString = JSON.stringify(validJson);
-describe('AIResponseParser', function() {
+describe('StructuredResponseParser', function() {
     describe('parse', function() {
         it('should parse valid JSON object', function() {
             // Given - a valid JSON object string and parser
             var text = validJsonString;
-            var parser = new AIResponseParser(testSchema);
+            var parser = new StructuredResponseParser(testSchema);
             // When - parsing the string
             var result = parser.parse(text);
             // Then - it should return the parsed object
@@ -31,7 +31,7 @@ describe('AIResponseParser', function() {
         it('should parse JSON object with surrounding text', function() {
             // Given - a JSON object string with surrounding text and parser
             var text = "Here's the article: ".concat(validJsonString, " - end of article");
-            var parser = new AIResponseParser(testSchema);
+            var parser = new StructuredResponseParser(testSchema);
             // When - parsing the string
             var result = parser.parse(text);
             // Then - it should return the parsed object
@@ -41,7 +41,7 @@ describe('AIResponseParser', function() {
             // Given - a JSON array string and array parser
             var arraySchema = z.array(z.string());
             var text = '["test", "ai", "content"]';
-            var parser = new AIResponseParser(arraySchema);
+            var parser = new StructuredResponseParser(arraySchema);
             // When - parsing the string
             var result = parser.parse(text);
             // Then - it should return the parsed array
@@ -54,7 +54,7 @@ describe('AIResponseParser', function() {
         it('should parse primitive string value', function() {
             // Given - a JSON string value and string parser
             var text = '"test string"';
-            var parser = new AIResponseParser(z.string());
+            var parser = new StructuredResponseParser(z.string());
             // When - parsing the string
             var result = parser.parse(text);
             // Then - it should return the parsed string
@@ -63,7 +63,7 @@ describe('AIResponseParser', function() {
         it('should parse primitive number value', function() {
             // Given - a JSON number value and number parser
             var text = '42';
-            var parser = new AIResponseParser(z.number());
+            var parser = new StructuredResponseParser(z.number());
             // When - parsing the string
             var result = parser.parse(text);
             // Then - it should return the parsed number
@@ -72,7 +72,7 @@ describe('AIResponseParser', function() {
         it('should parse primitive boolean value', function() {
             // Given - a JSON boolean value and boolean parser
             var text = 'true';
-            var parser = new AIResponseParser(z["boolean"]());
+            var parser = new StructuredResponseParser(z["boolean"]());
             // When - parsing the string
             var result = parser.parse(text);
             // Then - it should return the parsed boolean
@@ -81,7 +81,7 @@ describe('AIResponseParser', function() {
         it('should parse primitive null value', function() {
             // Given - a JSON null value and null parser
             var text = 'null';
-            var parser = new AIResponseParser(z["null"]());
+            var parser = new StructuredResponseParser(z["null"]());
             // When - parsing the string
             var result = parser.parse(text);
             // Then - it should return the parsed null
@@ -90,11 +90,11 @@ describe('AIResponseParser', function() {
         it('should throw ResponseParsingError when JSON is invalid', function() {
             // Given - an invalid JSON string and parser
             var text = '{invalid json}';
-            var parser = new AIResponseParser(testSchema);
+            var parser = new StructuredResponseParser(testSchema);
             // When/Then - parsing the string should throw a ResponseParsingError
             expect(function() {
                 return parser.parse(text);
-            }).toThrow(AIResponseParserError);
+            }).toThrow(StructuredResponseParserError);
         });
         it('should throw ResponseParsingError when schema validation fails', function() {
             // Given - an invalid JSON object and parser
@@ -108,30 +108,30 @@ describe('AIResponseParser', function() {
                 title: 123
             };
             var text = JSON.stringify(invalidJson);
-            var parser = new AIResponseParser(testSchema);
+            var parser = new StructuredResponseParser(testSchema);
             // When/Then - parsing the string should throw a ResponseParsingError
             expect(function() {
                 return parser.parse(text);
-            }).toThrow(AIResponseParserError);
+            }).toThrow(StructuredResponseParserError);
         });
         it('should throw ResponseParsingError when no object found in text', function() {
             // Given - a text without a JSON object and parser
             var text = 'No JSON object here';
-            var parser = new AIResponseParser(testSchema);
+            var parser = new StructuredResponseParser(testSchema);
             // When/Then - parsing the string should throw a ResponseParsingError
             expect(function() {
                 return parser.parse(text);
-            }).toThrow(AIResponseParserError);
+            }).toThrow(StructuredResponseParserError);
         });
         it('should throw ResponseParsingError when no array found in text', function() {
             // Given - a text without a JSON array and array parser
             var text = 'No array here';
             var arraySchema = z.array(z.string());
-            var parser = new AIResponseParser(arraySchema);
+            var parser = new StructuredResponseParser(arraySchema);
             // When/Then - parsing the string should throw a ResponseParsingError
             expect(function() {
                 return parser.parse(text);
-            }).toThrow(AIResponseParserError);
+            }).toThrow(StructuredResponseParserError);
         });
         it('should throw ResponseParsingError for unsupported schema type', function() {
             // Given - a text with an unsupported schema type and parser
@@ -140,30 +140,30 @@ describe('AIResponseParser', function() {
                 z.string(),
                 z.number()
             ]);
-            var parser = new AIResponseParser(unsupportedSchema);
+            var parser = new StructuredResponseParser(unsupportedSchema);
             // When/Then - parsing the string should throw a ResponseParsingError
             expect(function() {
                 return parser.parse(text);
-            }).toThrow(AIResponseParserError);
+            }).toThrow(StructuredResponseParserError);
         });
         it('should include original text in error when parsing fails', function() {
             // Given - an invalid JSON string and parser
             var text = '{invalid json}';
-            var parser = new AIResponseParser(testSchema);
+            var parser = new StructuredResponseParser(testSchema);
             // When - parsing the string
             try {
                 parser.parse(text);
                 throw new Error('Should have thrown an error');
             } catch (error) {
                 // Then - the error should include the original text
-                expect(error).toBeInstanceOf(AIResponseParserError);
+                expect(error).toBeInstanceOf(StructuredResponseParserError);
                 expect(error.text).toBe(text);
             }
         });
         it('should handle text with newlines in JSON object', function() {
             // Given - a JSON object with newlines and parser
             var textWithNewlines = '{\n                "content": "Test\ncontent\nwith\nnewlines",\n                "tags": ["test", "ai"],\n                "title": "Test\nArticle"\n            }';
-            var parser = new AIResponseParser(testSchema);
+            var parser = new StructuredResponseParser(testSchema);
             // When - parsing the string
             var result = parser.parse(textWithNewlines);
             // Then - it should return the parsed object
@@ -179,7 +179,7 @@ describe('AIResponseParser', function() {
         it('should handle text with newlines in surrounding text', function() {
             // Given - a text with newlines around the JSON object and parser
             var textWithNewlines = "Here's the\narticle:\n".concat(validJsonString, "\n- end of\narticle");
-            var parser = new AIResponseParser(testSchema);
+            var parser = new StructuredResponseParser(testSchema);
             // When - parsing the string
             var result = parser.parse(textWithNewlines);
             // Then - it should return the parsed object
@@ -188,7 +188,7 @@ describe('AIResponseParser', function() {
         it('should handle text with multiple consecutive newlines and spaces', function() {
             // Given - a text with multiple consecutive newlines and spaces and parser
             var textWithNewlines = "Here's the\n\n  article:   \n\n".concat(validJsonString, "\n\n");
-            var parser = new AIResponseParser(testSchema);
+            var parser = new StructuredResponseParser(testSchema);
             // When - parsing the string
             var result = parser.parse(textWithNewlines);
             // Then - it should return the parsed object
@@ -197,7 +197,7 @@ describe('AIResponseParser', function() {
         it('should handle escaped characters in JSON', function() {
             // Given - a JSON string with escaped characters and parser
             var text = '{"content": "Test\\ncontent\\twith\\r\\nescapes", "tags": ["test\\u0020ai", "escaped\\"quotes\\""], "title": "Test\\\\Article"}';
-            var parser = new AIResponseParser(testSchema);
+            var parser = new StructuredResponseParser(testSchema);
             // When - parsing the string
             var result = parser.parse(text);
             // Then - it should return the parsed object
@@ -213,7 +213,7 @@ describe('AIResponseParser', function() {
         it('should handle escaped characters in markdown code blocks', function() {
             // Given - a markdown code block with escaped characters and parser
             var text = '```json\n{"content": "Test\\nContent", "tags": ["test\\u0020ai"], "title": "Test\\\\Title"}\n```';
-            var parser = new AIResponseParser(testSchema);
+            var parser = new StructuredResponseParser(testSchema);
             // When - parsing the string
             var result = parser.parse(text);
             // Then - it should return the parsed object
@@ -229,7 +229,7 @@ describe('AIResponseParser', function() {
             // Given - a markdown code block with escaped characters and array parser
             var text = '```json\n [\n{"content": "Test\\nContent", "tags": ["test\\u0020ai"], "title": "Test\\\\Title"}\n]\n```';
             var arraySchema = z.array(testSchema);
-            var parser = new AIResponseParser(arraySchema);
+            var parser = new StructuredResponseParser(arraySchema);
             // When - parsing the string
             var result = parser.parse(text);
             // Then - it should return the parsed array
@@ -258,7 +258,7 @@ describe('AIResponseParser', function() {
                 synopsis: z.string()
             });
             var text = '```json\n{\n  "category": "sports",\n  "countries": [\n    "us"\n  ],\n  "perspectives": [\n    {\n      "holisticDigest": "The NBA offseason has seen a massive blockbuster trade as the Phoenix Suns have sent Kevin Durant to the Houston Rockets. The Rockets are acquiring Durant in exchange for Jalen Green, Dillon Brooks, the No. 10 pick in the 2025 NBA draft, and five second-round picks. This move significantly boosts the Rockets\' championship aspirations, positioning them as immediate contenders in the Western Conference alongside established teams. Durant, a future Hall of Famer, is expected to provide elite scoring and shot creation, addressing the Rockets\' previous offensive struggles in the half-court, particularly in the playoffs. Durant\'s decision to list Houston as a preferred destination suggests a potential long-term commitment, with an extension likely upon the opening of the new league year. For the Suns, this trade represents a pivot towards rebuilding, allowing them to acquire young talent and draft assets after their "Big 3" experiment failed to yield a championship. The Suns\' return is viewed by some analysts as lacking compared to Durant\'s caliber, but it does provide them with a reset and a chance to retool around Devin Booker and the draft picks. The specifics of the deal, including Dillon Brooks\' contract and the distribution of second-round picks, have also been highlighted as key elements enabling the trade to go through. The Rockets\' odds to win the NBA title have shortened considerably following the acquisition.",\n      "tags": {\n        "discourse_type": "mainstream",\n        "stance": "neutral"\n      }\n    }\n  ],\n  "synopsis": "This collection of articles reports on a major NBA trade where the Phoenix Suns have sent veteran superstar Kevin Durant to the Houston Rockets. The Rockets have acquired Durant in exchange for a package that includes young players Jalen Green and Dillon Brooks, as well as the No. 10 pick in the 2025 NBA draft and five second-round picks. The trade is seen as a significant move that immediately elevates the Rockets into championship contention in the Western Conference. For the Suns, the deal signals a shift towards rebuilding, acquiring young assets and draft capital after their pursuit of a championship with Durant did not come to fruition. Analysis within the articles discusses the potential impact of Durant on the Rockets\' offense and their championship odds, as well as the Suns\' strategy in moving forward after this blockbuster deal. The player himself was reportedly informed of the trade while on stage at an event, offering a brief, somewhat non-committal reaction to the news."\n}\n```';
-            var parser = new AIResponseParser(complexSchema);
+            var parser = new StructuredResponseParser(complexSchema);
             // When - parsing the string
             var result = parser.parse(text);
             // Then - it should return the parsed object with escaped quotes properly handled
@@ -286,4 +286,4 @@ describe('AIResponseParser', function() {
     });
 });
 
-//# sourceMappingURL=ai-response-parser.test.js.map
+//# sourceMappingURL=structured-response-parser.test.js.map

package/dist/adapters/utils/__tests__/structured-response-parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/adapters/utils/__tests__/structured-response-parser.test.ts"],"sourcesContent":["import { describe, expect, it } from '@jterrazz/test';\nimport { z } from 'zod/v4';\n\nimport { StructuredResponseParser } from '../structured-response-parser.js';\nimport { StructuredResponseParserError } from '../structured-response-parser-error.js';\n\n// Test data\nconst testSchema = z.object({\n    content: z.string(),\n    tags: z.array(z.string()),\n    title: z.string(),\n});\n\nconst validJson = {\n    content: 'Test content',\n    tags: ['test', 'ai'],\n    title: 'Test Article',\n};\n\nconst validJsonString = JSON.stringify(validJson);\n\ndescribe('StructuredResponseParser', () => {\n    describe('parse', () => {\n        it('should parse valid JSON object', () => {\n            // Given - a valid JSON object string and parser\n            const text = validJsonString;\n            const parser = new StructuredResponseParser(testSchema);\n\n            // When - parsing the string\n            const result = parser.parse(text);\n\n            // Then - it should return the parsed object\n            expect(result).toEqual(validJson);\n        });\n\n        it('should parse JSON object with surrounding text', () => {\n            // Given - a JSON object string with surrounding text and parser\n            const text = `Here's the article: ${validJsonString} - end of article`;\n            const parser = new StructuredResponseParser(testSchema);\n\n            // When - parsing the string\n            const result = parser.parse(text);\n\n            // Then - it should return the parsed object\n            expect(result).toEqual(validJson);\n        });\n\n        it('should parse array response', () => {\n            // Given - a JSON array string and array parser\n            const arraySchema = z.array(z.string());\n            const text = '[\"test\", \"ai\", \"content\"]';\n            const parser = new StructuredResponseParser(arraySchema);\n\n            // When - parsing the string\n            const result = parser.parse(text);\n\n            // Then - it should return the parsed array\n            expect(result).toEqual(['test', 'ai', 'content']);\n        });\n\n        it('should parse primitive string value', () => {\n            // Given - a JSON string value and string parser\n            const text = '\"test string\"';\n            const parser = new StructuredResponseParser(z.string());\n\n            // When - parsing the string\n            const result = parser.parse(text);\n\n            // Then - it should return the parsed string\n            expect(result).toBe('test string');\n        });\n\n        it('should parse primitive number value', () => {\n            // Given - a JSON number value and number parser\n            const text = '42';\n            const parser = new StructuredResponseParser(z.number());\n\n            // When - parsing the string\n            const result = parser.parse(text);\n\n            // Then - it should return the parsed number\n            expect(result).toBe(42);\n        });\n\n        it('should parse primitive boolean value', () => {\n            // Given - a JSON boolean value and boolean parser\n            const text = 'true';\n            const parser = new StructuredResponseParser(z.boolean());\n\n            // When - parsing the string\n            const result = parser.parse(text);\n\n            // Then - it should return the parsed boolean\n            expect(result).toBe(true);\n        });\n\n        it('should parse primitive null value', () => {\n            // Given - a JSON null value and null parser\n            const text = 'null';\n            const parser = new StructuredResponseParser(z.null());\n\n            // When - parsing the string\n            const result = parser.parse(text);\n\n            // Then - it should return the parsed null\n            expect(result).toBeNull();\n        });\n\n        it('should throw ResponseParsingError when JSON is invalid', () => {\n            // Given - an invalid JSON string and parser\n            const text = '{invalid json}';\n            const parser = new StructuredResponseParser(testSchema);\n\n            // When/Then - parsing the string should throw a ResponseParsingError\n            expect(() => parser.parse(text)).toThrow(StructuredResponseParserError);\n        });\n\n        it('should throw ResponseParsingError when schema validation fails', () => {\n            // Given - an invalid JSON object and parser\n            const invalidJson = {\n                // Should be string\n                content: 'Test content',\n                tags: ['test', 'ai'],\n                title: 123,\n            };\n            const text = JSON.stringify(invalidJson);\n            const parser = new StructuredResponseParser(testSchema);\n\n            // When/Then - parsing the string should throw a ResponseParsingError\n            expect(() => parser.parse(text)).toThrow(StructuredResponseParserError);\n        });\n\n        it('should throw ResponseParsingError when no object found in text', () => {\n            // Given - a text without a JSON object and parser\n            const text = 'No JSON object here';\n            const parser = new StructuredResponseParser(testSchema);\n\n            // When/Then - parsing the string should throw a ResponseParsingError\n            expect(() => parser.parse(text)).toThrow(StructuredResponseParserError);\n        });\n\n        it('should throw ResponseParsingError when no array found in text', () => {\n            // Given - a text without a JSON array and array parser\n            const text = 'No array here';\n            const arraySchema = z.array(z.string());\n            const parser = new StructuredResponseParser(arraySchema);\n\n            // When/Then - parsing the string should throw a ResponseParsingError\n            expect(() => parser.parse(text)).toThrow(StructuredResponseParserError);\n        });\n\n        it('should throw ResponseParsingError for unsupported schema type', () => {\n            // Given - a text with an unsupported schema type and parser\n            const text = 'test';\n            const unsupportedSchema = z.union([z.string(), z.number()]);\n            const parser = new StructuredResponseParser(unsupportedSchema);\n\n            // When/Then - parsing the string should throw a ResponseParsingError\n            expect(() => parser.parse(text)).toThrow(StructuredResponseParserError);\n        });\n\n        it('should include original text in error when parsing fails', () => {\n            // Given - an invalid JSON string and parser\n            const text = '{invalid json}';\n            const parser = new StructuredResponseParser(testSchema);\n\n            // When - parsing the string\n            try {\n                parser.parse(text);\n                throw new Error('Should have thrown an error');\n            } catch (error) {\n                // Then - the error should include the original text\n                expect(error).toBeInstanceOf(StructuredResponseParserError);\n                expect((error as StructuredResponseParserError).text).toBe(text);\n            }\n        });\n\n        it('should handle text with newlines in JSON object', () => {\n            // Given - a JSON object with newlines and parser\n            const textWithNewlines = `{\n                \"content\": \"Test\\ncontent\\nwith\\nnewlines\",\n                \"tags\": [\"test\", \"ai\"],\n                \"title\": \"Test\\nArticle\"\n            }`;\n            const parser = new StructuredResponseParser(testSchema);\n\n            // When - parsing the string\n            const result = parser.parse(textWithNewlines);\n\n            // Then - it should return the parsed object\n            expect(result).toEqual({\n                content: 'Test content with newlines',\n                tags: ['test', 'ai'],\n                title: 'Test Article',\n            });\n        });\n\n        it('should handle text with newlines in surrounding text', () => {\n            // Given - a text with newlines around the JSON object and parser\n            const textWithNewlines = `Here's the\\narticle:\\n${validJsonString}\\n- end of\\narticle`;\n            const parser = new StructuredResponseParser(testSchema);\n\n            // When - parsing the string\n            const result = parser.parse(textWithNewlines);\n\n            // Then - it should return the parsed object\n            expect(result).toEqual(validJson);\n        });\n\n        it('should handle text with multiple consecutive newlines and spaces', () => {\n            // Given - a text with multiple consecutive newlines and spaces and parser\n            const textWithNewlines = `Here's the\\n\\n  article:   \\n\\n${validJsonString}\\n\\n`;\n            const parser = new StructuredResponseParser(testSchema);\n\n            // When - parsing the string\n            const result = parser.parse(textWithNewlines);\n\n            // Then - it should return the parsed object\n            expect(result).toEqual(validJson);\n        });\n\n        it('should handle escaped characters in JSON', () => {\n            // Given - a JSON string with escaped characters and parser\n            const text =\n                '{\"content\": \"Test\\\\ncontent\\\\twith\\\\r\\\\nescapes\", \"tags\": [\"test\\\\u0020ai\", \"escaped\\\\\"quotes\\\\\"\"], \"title\": \"Test\\\\\\\\Article\"}';\n            const parser = new StructuredResponseParser(testSchema);\n\n            // When - parsing the string\n            const result = parser.parse(text);\n\n            // Then - it should return the parsed object\n            expect(result).toEqual({\n                content: 'Test\\ncontent\\twith\\r\\nescapes',\n                tags: ['test ai', 'escaped\"quotes\"'],\n                title: 'Test\\\\Article',\n            });\n        });\n\n        it('should handle escaped characters in markdown code blocks', () => {\n            // Given - a markdown code block with escaped characters and parser\n            const text =\n                '```json\\n{\"content\": \"Test\\\\nContent\", \"tags\": [\"test\\\\u0020ai\"], \"title\": \"Test\\\\\\\\Title\"}\\n```';\n            const parser = new StructuredResponseParser(testSchema);\n\n            // When - parsing the string\n            const result = parser.parse(text);\n\n            // Then - it should return the parsed object\n            expect(result).toEqual({\n                content: 'Test\\nContent',\n                tags: ['test ai'],\n                title: 'Test\\\\Title',\n            });\n        });\n\n        it('should handle escaped characters in markdown code blocks', () => {\n            // Given - a markdown code block with escaped characters and array parser\n            const text =\n                '```json\\n [\\n{\"content\": \"Test\\\\nContent\", \"tags\": [\"test\\\\u0020ai\"], \"title\": \"Test\\\\\\\\Title\"}\\n]\\n```';\n            const arraySchema = z.array(testSchema);\n            const parser = new StructuredResponseParser(arraySchema);\n\n            // When - parsing the string\n            const result = parser.parse(text);\n\n            // Then - it should return the parsed array\n            expect(result).toEqual([\n                {\n                    content: 'Test\\nContent',\n                    tags: ['test ai'],\n                    title: 'Test\\\\Title',\n                },\n            ]);\n        });\n\n        it('should parse complex NBA trade analysis JSON with escaped quotes', () => {\n            // Given - a complex JSON object with nested structures and escaped quotes in markdown\n            const complexSchema = z.object({\n                category: z.string(),\n                countries: z.array(z.string()),\n                perspectives: z.array(\n                    z.object({\n                        holisticDigest: z.string(),\n                        tags: z.object({\n                            discourse_type: z.string(),\n                            stance: z.string(),\n                        }),\n                    }),\n                ),\n                synopsis: z.string(),\n            });\n\n            const text =\n                '```json\\n{\\n  \"category\": \"sports\",\\n  \"countries\": [\\n    \"us\"\\n  ],\\n  \"perspectives\": [\\n    {\\n      \"holisticDigest\": \"The NBA offseason has seen a massive blockbuster trade as the Phoenix Suns have sent Kevin Durant to the Houston Rockets. The Rockets are acquiring Durant in exchange for Jalen Green, Dillon Brooks, the No. 10 pick in the 2025 NBA draft, and five second-round picks. This move significantly boosts the Rockets\\' championship aspirations, positioning them as immediate contenders in the Western Conference alongside established teams. Durant, a future Hall of Famer, is expected to provide elite scoring and shot creation, addressing the Rockets\\' previous offensive struggles in the half-court, particularly in the playoffs. Durant\\'s decision to list Houston as a preferred destination suggests a potential long-term commitment, with an extension likely upon the opening of the new league year. For the Suns, this trade represents a pivot towards rebuilding, allowing them to acquire young talent and draft assets after their \"Big 3\" experiment failed to yield a championship. The Suns\\' return is viewed by some analysts as lacking compared to Durant\\'s caliber, but it does provide them with a reset and a chance to retool around Devin Booker and the draft picks. The specifics of the deal, including Dillon Brooks\\' contract and the distribution of second-round picks, have also been highlighted as key elements enabling the trade to go through. The Rockets\\' odds to win the NBA title have shortened considerably following the acquisition.\",\\n      \"tags\": {\\n        \"discourse_type\": \"mainstream\",\\n        \"stance\": \"neutral\"\\n      }\\n    }\\n  ],\\n  \"synopsis\": \"This collection of articles reports on a major NBA trade where the Phoenix Suns have sent veteran superstar Kevin Durant to the Houston Rockets. The Rockets have acquired Durant in exchange for a package that includes young players Jalen Green and Dillon Brooks, as well as the No. 10 pick in the 2025 NBA draft and five second-round picks. The trade is seen as a significant move that immediately elevates the Rockets into championship contention in the Western Conference. For the Suns, the deal signals a shift towards rebuilding, acquiring young assets and draft capital after their pursuit of a championship with Durant did not come to fruition. Analysis within the articles discusses the potential impact of Durant on the Rockets\\' offense and their championship odds, as well as the Suns\\' strategy in moving forward after this blockbuster deal. The player himself was reportedly informed of the trade while on stage at an event, offering a brief, somewhat non-committal reaction to the news.\"\\n}\\n```';\n\n            const parser = new StructuredResponseParser(complexSchema);\n\n            // When - parsing the string\n            const result = parser.parse(text);\n\n            // Then - it should return the parsed object with escaped quotes properly handled\n            expect(result).toEqual({\n                category: 'sports',\n                countries: ['us'],\n                perspectives: [\n                    {\n                        holisticDigest: expect.stringContaining(\n                            'The NBA offseason has seen a massive blockbuster trade',\n                        ),\n                        tags: {\n                            discourse_type: 'mainstream',\n                            stance: 'neutral',\n                        },\n                    },\n                ],\n                synopsis: expect.stringContaining(\n                    'This collection of articles reports on a major NBA trade',\n                ),\n            });\n\n            // Additional verification for escaped quotes handling\n            expect(result.perspectives[0].holisticDigest).toContain('\"Big 3\" experiment');\n            expect(result.perspectives[0].holisticDigest).toContain(\n                \"Rockets' championship aspirations\",\n            );\n            expect(result.perspectives[0].holisticDigest).toContain(\"Durant's decision\");\n        });\n    });\n});\n"],"names":["describe","expect","it","z","StructuredResponseParser","StructuredResponseParserError","testSchema","object","content","string","tags","array","title","validJson","validJsonString","JSON","stringify","text","parser","result","parse","toEqual","arraySchema","toBe","number","boolean","null","toBeNull","toThrow","invalidJson","unsupportedSchema","union","Error","error","toBeInstanceOf","textWithNewlines","complexSchema","category","countries","perspectives","holisticDigest","discourse_type","stance","synopsis","stringContaining","toContain"],"mappings":"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"}

package/dist/adapters/utils/{ai-response-parser-error.d.ts → structured-response-parser-error.d.ts}

@@ -1,7 +1,7 @@
 /**
- * Custom error for AI response parsing failures
+ * Custom error for structured response parsing failures
  */
-export declare class AIResponseParserError extends Error {
+export declare class StructuredResponseParserError extends Error {
     readonly cause?: unknown | undefined;
     readonly text?: string | undefined;
     constructor(message: string, cause?: unknown | undefined, text?: string | undefined);

package/dist/adapters/utils/{ai-response-parser-error.js → structured-response-parser-error.js}

@@ -1,5 +1,5 @@
 /**
- * Custom error for AI response parsing failures
+ * Custom error for structured response parsing failures
  */ function _assert_this_initialized(self) {
     if (self === void 0) {
         throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
@@ -118,19 +118,19 @@ function _is_native_reflect_construct() {
         return !!result;
     })();
 }
-export var AIResponseParserError = /*#__PURE__*/ function(Error1) {
+export var StructuredResponseParserError = /*#__PURE__*/ function(Error1) {
     "use strict";
-    _inherits(AIResponseParserError, Error1);
-    function AIResponseParserError(message, cause, text) {
-        _class_call_check(this, AIResponseParserError);
+    _inherits(StructuredResponseParserError, Error1);
+    function StructuredResponseParserError(message, cause, text) {
+        _class_call_check(this, StructuredResponseParserError);
         var _this;
-        _this = _call_super(this, AIResponseParserError, [
+        _this = _call_super(this, StructuredResponseParserError, [
             message
         ]), _define_property(_this, "cause", void 0), _define_property(_this, "text", void 0), _this.cause = cause, _this.text = text;
-        _this.name = 'AIResponseParserError';
+        _this.name = 'StructuredResponseParserError';
         return _this;
     }
-    return AIResponseParserError;
+    return StructuredResponseParserError;
 }(_wrap_native_super(Error));
 
-//# sourceMappingURL=ai-response-parser-error.js.map
+//# sourceMappingURL=structured-response-parser-error.js.map

package/dist/adapters/utils/structured-response-parser-error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/utils/structured-response-parser-error.ts"],"sourcesContent":["/**\n * Custom error for structured response parsing failures\n */\nexport class StructuredResponseParserError extends Error {\n    constructor(\n        message: string,\n        public readonly cause?: unknown,\n        public readonly text?: string,\n    ) {\n        super(message);\n        this.name = 'StructuredResponseParserError';\n    }\n}\n"],"names":["StructuredResponseParserError","message","cause","text","name","Error"],"mappings":"AAAA;;CAEC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACD,OAAO,IAAA,AAAMA,8CAAN;;cAAMA;aAAAA,8BAELC,OAAe,EACf,AAAgBC,KAAe,EAC/B,AAAgBC,IAAa;gCAJxBH;;gBAML,kBANKA;YAMCC;qGAHUC,QAAAA,aACAC,OAAAA;QAGhB,MAAKC,IAAI,GAAG;;;WAPPJ;qBAAsCK,QASlD"}

package/dist/adapters/utils/{ai-response-parser.d.ts → structured-response-parser.d.ts}

@@ -2,7 +2,7 @@ import { z } from 'zod/v4';
 /**
  * Parses AI response text into structured data based on Zod schema
  */
-export declare class AIResponseParser<T> {
+export declare class StructuredResponseParser<T> {
     private readonly schema;
     constructor(schema: z.ZodSchema<T>);
     /**