@jterrazz/intelligence 1.0.0 → 1.1.0

package/dist/adapters/agents/query-agent.adapter.js

@@ -0,0 +1,303 @@
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+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;
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() {
+        return this;
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+import { AIResponseParser } from '../utils/ai-response-parser.js';
+/**
+ * A simple agent for direct, one-shot interactions with a model.
+ * It supports optional response parsing against a Zod schema but does not use tools.
+ */ export var QueryAgentAdapter = /*#__PURE__*/ function() {
+    "use strict";
+    function QueryAgentAdapter(name, options) {
+        _class_call_check(this, QueryAgentAdapter);
+        _define_property(this, "name", void 0);
+        _define_property(this, "options", void 0);
+        this.name = name;
+        this.options = options;
+    }
+    _create_class(QueryAgentAdapter, [
+        {
+            key: "run",
+            value: function run(userPrompt) {
+                return _async_to_generator(function() {
+                    var _this_options_logger, content, _this_options_logger1, _this_options_logger2, error, _this_options_logger3;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                (_this_options_logger = this.options.logger) === null || _this_options_logger === void 0 ? void 0 : _this_options_logger.debug("[".concat(this.name, "] Starting query execution."));
+                                _state.label = 1;
+                            case 1:
+                                _state.trys.push([
+                                    1,
+                                    3,
+                                    ,
+                                    4
+                                ]);
+                                return [
+                                    4,
+                                    this.invokeModel(userPrompt)
+                                ];
+                            case 2:
+                                content = _state.sent();
+                                if (this.options.schema) {
+                                    ;
+                                    this.parseResponse(content, this.options.schema);
+                                    (_this_options_logger1 = this.options.logger) === null || _this_options_logger1 === void 0 ? void 0 : _this_options_logger1.info("[".concat(this.name, "] Execution finished and response parsed."));
+                                } else {
+                                    ;
+                                    (_this_options_logger2 = this.options.logger) === null || _this_options_logger2 === void 0 ? void 0 : _this_options_logger2.info("[".concat(this.name, "] Execution finished."));
+                                }
+                                return [
+                                    2,
+                                    content
+                                ];
+                            case 3:
+                                error = _state.sent();
+                                (_this_options_logger3 = this.options.logger) === null || _this_options_logger3 === void 0 ? void 0 : _this_options_logger3.error("[".concat(this.name, "] Execution failed."), {
+                                    error: _instanceof(error, Error) ? error.message : 'Unknown error'
+                                });
+                                return [
+                                    2,
+                                    null
+                                ];
+                            case 4:
+                                return [
+                                    2
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "invokeModel",
+            value: function invokeModel(userPrompt) {
+                return _async_to_generator(function() {
+                    var _this_options_logger, userInput, systemMessage, messages, _this_options_logger1, response, content;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                userInput = this.resolveUserInput(userPrompt);
+                                systemMessage = this.options.systemPrompt.generate();
+                                messages = [
+                                    {
+                                        content: systemMessage,
+                                        role: 'system'
+                                    },
+                                    {
+                                        content: userInput,
+                                        role: 'user'
+                                    }
+                                ];
+                                (_this_options_logger = this.options.logger) === null || _this_options_logger === void 0 ? void 0 : _this_options_logger.debug("[".concat(this.name, "] Invoking model..."), {
+                                    hasSchema: !!this.options.schema
+                                });
+                                if (this.options.verbose) {
+                                    ;
+                                    (_this_options_logger1 = this.options.logger) === null || _this_options_logger1 === void 0 ? void 0 : _this_options_logger1.info("[".concat(this.name, "] Sending messages to model..."), {
+                                        messages: messages
+                                    });
+                                }
+                                return [
+                                    4,
+                                    this.options.model.getModel().invoke(messages)
+                                ];
+                            case 1:
+                                response = _state.sent();
+                                content = response.content;
+                                if (typeof content !== 'string') {
+                                    throw new Error('Model returned a non-string content type.');
+                                }
+                                return [
+                                    2,
+                                    content
+                                ];
+                        }
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "parseResponse",
+            value: function parseResponse(content, schema) {
+                try {
+                    new AIResponseParser(schema).parse(content);
+                } catch (error) {
+                    var _this_options_logger;
+                    (_this_options_logger = this.options.logger) === null || _this_options_logger === void 0 ? void 0 : _this_options_logger.error("[".concat(this.name, "] Failed to parse model response."), {
+                        error: _instanceof(error, Error) ? error.message : 'Unknown error',
+                        rawContent: content
+                    });
+                    throw new Error('Invalid response format from model.');
+                }
+            }
+        },
+        {
+            key: "resolveUserInput",
+            value: function resolveUserInput(userPrompt) {
+                if (userPrompt) {
+                    return userPrompt.generate();
+                }
+                return 'Proceed with your instructions.';
+            }
+        }
+    ]);
+    return QueryAgentAdapter;
+}();
+
+//# sourceMappingURL=query-agent.adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/agents/query-agent.adapter.ts"],"sourcesContent":["import { type LoggerPort } from '@jterrazz/logger';\nimport { type 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';\n\nimport { AIResponseParser } from '../utils/ai-response-parser.js';\n\nimport type { SystemPromptAdapter } from '../prompts/system-prompt.adapter.js';\n\nexport interface QueryAgentOptions<T = string> {\n    logger?: LoggerPort;\n    model: ModelPort;\n    schema?: z.ZodSchema<T>;\n    systemPrompt: SystemPromptAdapter;\n    verbose?: boolean;\n}\n\n/**\n * A simple agent for direct, one-shot interactions with a model.\n * It supports optional response parsing against a Zod schema but does not use tools.\n */\nexport class QueryAgentAdapter<T = string> implements AgentPort {\n    constructor(\n        public readonly name: string,\n        private readonly options: QueryAgentOptions<T>,\n    ) {}\n\n    async run(userPrompt?: PromptPort): Promise<null | string> {\n        this.options.logger?.debug(`[${this.name}] Starting query execution.`);\n\n        try {\n            const content = await this.invokeModel(userPrompt);\n\n            if (this.options.schema) {\n                this.parseResponse(content, this.options.schema);\n                this.options.logger?.info(`[${this.name}] Execution finished and response parsed.`);\n            } else {\n                this.options.logger?.info(`[${this.name}] Execution finished.`);\n            }\n\n            return content;\n        } catch (error) {\n            this.options.logger?.error(`[${this.name}] Execution failed.`, {\n                error: error instanceof Error ? error.message : 'Unknown error',\n            });\n            return null;\n        }\n    }\n\n    private async invokeModel(userPrompt?: PromptPort): Promise<string> {\n        const userInput = this.resolveUserInput(userPrompt);\n        const systemMessage = this.options.systemPrompt.generate();\n\n        const messages = [\n            { content: systemMessage, role: 'system' as const },\n            { content: userInput, role: 'user' as const },\n        ];\n\n        this.options.logger?.debug(`[${this.name}] Invoking model...`, {\n            hasSchema: !!this.options.schema,\n        });\n\n        if (this.options.verbose) {\n            this.options.logger?.info(`[${this.name}] Sending messages to model...`, {\n                messages,\n            });\n        }\n\n        const response = await this.options.model.getModel().invoke(messages);\n        const { content } = response;\n\n        if (typeof content !== 'string') {\n            throw new Error('Model returned a non-string content type.');\n        }\n\n        return content;\n    }\n\n    private parseResponse<TResponse>(content: string, schema: z.ZodSchema<TResponse>): void {\n        try {\n            new AIResponseParser(schema).parse(content);\n        } catch (error) {\n            this.options.logger?.error(`[${this.name}] Failed to parse model response.`, {\n                error: error instanceof Error ? error.message : 'Unknown error',\n                rawContent: content,\n            });\n            throw new Error('Invalid response format from model.');\n        }\n    }\n\n    private resolveUserInput(userPrompt?: PromptPort): string {\n        if (userPrompt) {\n            return userPrompt.generate();\n        }\n        return 'Proceed with your instructions.';\n    }\n}\n"],"names":["AIResponseParser","QueryAgentAdapter","name","options","run","userPrompt","content","error","logger","debug","invokeModel","schema","parseResponse","info","Error","message","userInput","systemMessage","messages","response","resolveUserInput","systemPrompt","generate","role","hasSchema","verbose","model","getModel","invoke","parse","rawContent"],"mappings":"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"}

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

@@ -1,27 +1,37 @@
 import type { BaseLanguageModel } from '@langchain/core/language_models/base';
-import type { Model } from '../../ports/model.port.js';
+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 {
     /**
-     * Application title for X-Title header (optional)
+     * Application title for X-Title header
      */
-    title?: string;
+    application?: string;
     /**
-     * Website URL for HTTP-Referer header (optional)
+     * Website URL for HTTP-Referer header
      */
-    websiteUrl?: string;
+    website?: string;
 }
 /**
  * OpenRouter adapter that provides access to various models through OpenRouter's API
  */
-export declare class OpenRouterModelAdapter implements Model {
+export declare class OpenRouterModelAdapter implements ModelPort {
     private readonly model;
     constructor(config: OpenRouterConfig);
     getModel(): BaseLanguageModel;

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

@@ -52,16 +52,19 @@ import { ChatOpenAI } from '@langchain/openai';
     "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({
             configuration: {
                 baseURL: 'https://openrouter.ai/api/v1',
-                defaultHeaders: _object_spread({}, config.websiteUrl && {
-                    'HTTP-Referer': config.websiteUrl
-                }, config.title && {
-                    'X-Title': config.title
+                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
                 })
             },
+            maxTokens: (_config_maxTokens = config.maxTokens) !== null && _config_maxTokens !== void 0 ? _config_maxTokens : 64000,
             modelName: config.modelName,
             openAIApiKey: config.apiKey
         });

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 { Model } from '../../ports/model.port.js';\n\nexport interface OpenRouterConfig {\n    /**\n     * OpenRouter API key\n     */\n    apiKey: string;\n    /**\n     * The model to use (e.g., 'google/gemini-2.5-flash-preview-05-20:thinking')\n     */\n    modelName: string;\n    /**\n     * Application title for X-Title header (optional)\n     */\n    title?: string;\n    /**\n     * Website URL for HTTP-Referer header (optional)\n     */\n    websiteUrl?: string;\n}\n\n/**\n * OpenRouter adapter that provides access to various models through OpenRouter's API\n */\nexport class OpenRouterModelAdapter implements Model {\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.websiteUrl && { 'HTTP-Referer': config.websiteUrl }),\n                    ...(config.title && { 'X-Title': config.title }),\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","websiteUrl","title","modelName","openAIApiKey","apiKey","getModel"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,SAASA,UAAU,QAAQ,oBAAoB;AAuB/C;;CAEC,GACD,OAAO,IAAA,AAAMC,uCAAN;;aAAMA,uBAGGC,MAAwB;gCAH3BD;QACT,uBAAiBE,SAAjB,KAAA;QAGI,IAAI,CAACA,KAAK,GAAG,IAAIH,WAAW;YACxBI,eAAe;gBACXC,SAAS;gBACTC,gBAAgB,mBACRJ,OAAOK,UAAU,IAAI;oBAAE,gBAAgBL,OAAOK,UAAU;gBAAC,GACzDL,OAAOM,KAAK,IAAI;oBAAE,WAAWN,OAAOM,KAAK;gBAAC;YAEtD;YACAC,WAAWP,OAAOO,SAAS;YAC3BC,cAAcR,OAAOS,MAAM;QAC/B;;kBAdKV;;YAiBTW,KAAAA;mBAAAA,SAAAA;gBACI,OAAO,IAAI,CAACT,KAAK;YACrB;;;WAnBSF;IAoBZ"}
+{"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 ?? 64_000,\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","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,WAAWT,OAAOS,SAAS;YAC3BC,cAAcV,OAAOW,MAAM;QAC/B;;kBAjBKZ;;YAoBTa,KAAAA;mBAAAA,SAAAA;gBACI,OAAO,IAAI,CAACX,KAAK;YACrB;;;WAtBSF;IAuBZ"}

package/dist/adapters/prompts/__tests__/__snapshots__/presets.test.ts.snap

@@ -2,149 +2,119 @@
 
 exports[`Prompt Library Presets > should generate the correct prompt for CREATIVE_BRAINSTORMER 1`] = `
 "
-<DIRECTIVE>
-Adhere to the highest ethical standards. Do not promote hate speech, discrimination, or violence.
-Respect user privacy and do not ask for or store personally identifiable information.
-</DIRECTIVE>
+<Foundation>
+You MUST adhere to the highest ethical standards. Your conduct must be impartial and devoid of prejudice.
+You MUST NOT promote hate speech, discrimination,violence, or any form of harm.
+You MUST respect user privacy; do not ask for, store, or share personally identifiable information.
+</Foundation>
 
 
-<PERSONA>
-You are a creative partner, here to help brainstorm and explore new ideas.
-You are imaginative, encouraging, and open to unconventional thinking.
-Your goal is to inspire and collaborate.
-</PERSONA>
+<Persona>
+You are a Creative Partner, an imaginative collaborator for brainstorming and exploration.
+Your purpose is to help users generate and develop novel ideas.
+**Key Skills**: You excel at divergent thinking, making unexpected connections, and asking thought-provoking questions. You are encouraging, open-minded, and skilled at building upon abstract concepts.
+</Persona>
 
 
-<DOMAIN>
-You are a generalist with broad knowledge across many subjects.
-</DOMAIN>
+<Domain>
+You possess broad, generalist knowledge across a wide variety of subjects.
+</Domain>
 
 
-<TONE>
-Employ light-hearted humor, wit, and cleverness.
-Keep the mood fun and engaging, but avoid inappropriate or offensive jokes.
-</TONE>
+<Tone>
+You should employ light-hearted humor, wit, and cleverness. Keep the mood fun and engaging, but avoid inappropriate or offensive jokes.
+</Tone>
 
 
-<VERBOSITY>
-Provide a balanced level of detail, sufficient for a clear understanding without being overwhelming.
-</VERBOSITY>
+<Verbosity>
+You should provide a balanced level of detail, sufficient for a clear understanding without being overwhelming or too brief.
+</Verbosity>
 
 
-<FORMAT>
-Use Markdown for clear, structured responses.
-Employ headings, lists, bold/italic text, and code blocks to improve readability.
-</FORMAT>
-
-
-<AGENT_LOGIC>
-Always provide a response to the user's input, even if it's just to state that you cannot fulfill the request.
-</AGENT_LOGIC>
-
-
-<AGENT_SKILL>
-You excel at brainstorming, generating novel ideas, and thinking outside the box.
-</AGENT_SKILL>"
+<ResponseStrategy>
+You must always provide a response to the user's input. Even if you cannot fully fulfill the request, acknowledge it and explain the situation. Your primary directive is to be responsive.
+</ResponseStrategy>"
 `;
 
 exports[`Prompt Library Presets > should generate the correct prompt for DISCORD_COMMUNITY_ANIMATOR 1`] = `
 "
-<DIRECTIVE>
-Do not provide instructions or information that is illegal, dangerous, or harmful.
-Refuse to engage with requests that could cause real-world harm.
-Prioritize user safety and well-being in all responses.
-</DIRECTIVE>
-
+<Foundation>
+You MUST refuse to provide instructions or information that is illegal, dangerous, or promotes harm.
+You MUST prioritize user safety and well-being in all interactions and avoid generating unsafe content.
+</Foundation>
 
-<PERSONA>
-You are the Community Animator, the heart and soul of a digital community like Discord.
-Your main goal is to keep the community vibrant, engaged, and entertained by posting interesting content.
-You are an expert on internet culture, trends, and topics relevant to the community.
-</PERSONA>
 
+<Persona>
+You are the Community Animator, the vibrant heart of a digital community (e.g., Discord).
+Your purpose is to keep the community active, engaged, and positive.
+**Key Skills**: You are an expert on internet culture, trends, and topics relevant to the community. You excel at initiating conversations, creating engaging content (polls, questions), and fostering a welcoming environment.
+</Persona>
 
-<DOMAIN>
-You are a generalist with broad knowledge across many subjects.
-</DOMAIN>
 
+<Domain>
+You possess broad, generalist knowledge across a wide variety of subjects.
+</Domain>
 
-<TONE>
-Employ light-hearted humor, wit, and cleverness.
-Keep the mood fun and engaging, but avoid inappropriate or offensive jokes.
-</TONE>
 
+<Tone>
+You should employ light-hearted humor, wit, and cleverness. Keep the mood fun and engaging, but avoid inappropriate or offensive jokes.
+</Tone>
 
-<VERBOSITY>
-Provide a balanced level of detail, sufficient for a clear understanding without being overwhelming.
-</VERBOSITY>
 
+<Verbosity>
+You should provide a balanced level of detail, sufficient for a clear understanding without being overwhelming or too brief.
+</Verbosity>
 
-<FORMAT>
-Use Markdown for clear, structured responses.
-Employ headings, lists, bold/italic text, and code blocks to improve readability.
-</FORMAT>
 
-
-<AGENT_LOGIC>
-Always provide a response to the user's input, even if it's just to state that you cannot fulfill the request.
-</AGENT_LOGIC>
-
-
-<AGENT_SKILL>
-You excel at brainstorming, generating novel ideas, and thinking outside the box.
-</AGENT_SKILL>"
+<ResponseStrategy>
+Before responding, you must analyze the conversation history and the immediate context. Your goal is to add value; if a response is not necessary or helpful, you may remain silent.
+</ResponseStrategy>"
 `;
 
 exports[`Prompt Library Presets > should generate the correct prompt for EMPATHETIC_SUPPORT_AGENT 1`] = `
 "
-<DIRECTIVE>
-Do not provide instructions or information that is illegal, dangerous, or harmful.
-Refuse to engage with requests that could cause real-world harm.
-Prioritize user safety and well-being in all responses.
-</DIRECTIVE>
-
-
-<DIRECTIVE>
-Adhere to the highest ethical standards. Do not promote hate speech, discrimination, or violence.
-Respect user privacy and do not ask for or store personally identifiable information.
-</DIRECTIVE>
+<Foundation>
+You MUST refuse to provide instructions or information that is illegal, dangerous, or promotes harm.
+You MUST prioritize user safety and well-being in all interactions and avoid generating unsafe content.
+</Foundation>
 
 
-<PERSONA>
-You are a friendly and empathetic support agent.
-Your primary goal is to help users solve their problems with patience and understanding.
-You are a good listener and provide clear, step-by-step assistance.
-</PERSONA>
+<Foundation>
+You MUST adhere to the highest ethical standards. Your conduct must be impartial and devoid of prejudice.
+You MUST NOT promote hate speech, discrimination,violence, or any form of harm.
+You MUST respect user privacy; do not ask for, store, or share personally identifiable information.
+</Foundation>
 
 
-<DOMAIN>
-You are a generalist with broad knowledge across many subjects.
-</DOMAIN>
+<Persona>
+You are a friendly, patient, and empathetic Support Agent.
+Your purpose is to help users solve problems and navigate difficulties.
+**Key Skills**: You are an excellent listener and a clear communicator. You are skilled at de-escalating frustration, breaking down complex issues into manageable steps, and providing systematic, easy-to-follow instructions.
+</Persona>
 
 
-<TONE>
-Adopt a warm, understanding, and supportive tone.
-Acknowledge the user's feelings and show you are listening.
-</TONE>
+<Domain>
+You possess broad, generalist knowledge across a wide variety of subjects.
+</Domain>
 
 
-<VERBOSITY>
-Provide a balanced level of detail, sufficient for a clear understanding without being overwhelming.
-</VERBOSITY>
+<Tone>
+You must adopt a warm, understanding, and supportive tone. Acknowledge the user's feelings and demonstrate active listening.
+</Tone>
 
 
-<FORMAT>
-Break down instructions or processes into a clear, numbered, step-by-step list.
-Ensure each step is a distinct, actionable item.
-</FORMAT>
+<Verbosity>
+You should provide a balanced level of detail, sufficient for a clear understanding without being overwhelming or too brief.
+</Verbosity>
 
 
-<AGENT_LOGIC>
-Always provide a response to the user's input, even if it's just to state that you cannot fulfill the request.
-</AGENT_LOGIC>
+<Format>
+You MUST break down any instructions or processes into a clear, numbered, step-by-step list.
+Each step must be a distinct and actionable item.
+</Format>
 
 
-<AGENT_SKILL>
-You are skilled at analyzing complex problems, breaking them down into manageable parts, and proposing systematic solutions.
-</AGENT_SKILL>"
+<ResponseStrategy>
+You must always provide a response to the user's input. Even if you cannot fully fulfill the request, acknowledge it and explain the situation. Your primary directive is to be responsive.
+</ResponseStrategy>"
 `;

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

@@ -4,7 +4,7 @@ import { SystemPromptAdapter } 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(PROMPTS.PRESETS.DISCORD_COMMUNITY_ANIMATOR);
+        var prompt = new SystemPromptAdapter(PROMPTS.PRESETS.COMMUNITY_ANIMATOR);
         // 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 { PROMPTS } 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(PROMPTS.PRESETS.DISCORD_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(PROMPTS.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(PROMPTS.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","PROMPTS","SystemPromptAdapter","prompt","PRESETS","DISCORD_COMMUNITY_ANIMATOR","result","generate","toMatchSnapshot","EMPATHETIC_SUPPORT_AGENT","CREATIVE_BRAINSTORMER"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,iBAAiB;AAEtD,SAASC,OAAO,QAAQ,sBAAsB;AAC9C,SAASC,mBAAmB,QAAQ,8BAA8B;AAElEJ,SAAS,0BAA0B;IAC/BE,GAAG,qEAAqE;QACpE,8CAA8C;QAC9C,IAAMG,SAAS,IAAID,oBAAoBD,QAAQG,OAAO,CAACC,0BAA0B;QAEjF,+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,QAAQG,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,oBAAoBD,QAAQG,OAAO,CAACM,qBAAqB;QAE5E,+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 { PROMPTS } 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(PROMPTS.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(PROMPTS.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(PROMPTS.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","PROMPTS","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,OAAO,QAAQ,sBAAsB;AAC9C,SAASC,mBAAmB,QAAQ,8BAA8B;AAElEJ,SAAS,0BAA0B;IAC/BE,GAAG,qEAAqE;QACpE,8CAA8C;QAC9C,IAAMG,SAAS,IAAID,oBAAoBD,QAAQG,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,oBAAoBD,QAAQG,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,oBAAoBD,QAAQG,OAAO,CAACM,qBAAqB;QAE5E,+BAA+B;QAC/B,IAAMJ,SAASH,OAAOI,QAAQ;QAE9B,+CAA+C;QAC/CR,OAAOO,QAAQE,eAAe;IAClC;AACJ"}