@riotprompt/riotprompt 0.0.8 → 0.0.10

package/dist/loader.js

@@ -10,6 +10,9 @@ import './parser.js';
 import './override.js';
 import './builder.js';
 import './recipes.js';
+import './conversation.js';
+import 'tiktoken';
+import './tools.js';
 import { create as create$1 } from './util/storage.js';
 
 const OptionsSchema = z.object({
@@ -60,7 +63,7 @@ const create = (loaderOptions)=>{
     };
     /**
      * Loads context from the provided directories and returns instruction sections
-     * 
+     *
      * @param contextDirectories Directories containing context files
      * @returns Array of instruction sections loaded from context directories
      */ const load = async (contextDirectories = [], options = {})=>{
@@ -112,8 +115,22 @@ const create = (loaderOptions)=>{
                 }
                 // Get all other files in the directory
                 const files = await storage.listFiles(contextDir);
-                const ignorePatternsRegex = ignorePatterns.map((pattern)=>new RegExp(pattern, 'i'));
-                const filteredFiles = files.filter((file)=>!ignorePatternsRegex.some((regex)=>regex.test(file)));
+                const ignorePatternsRegex = ignorePatterns.map((pattern)=>{
+                    try {
+                        return new RegExp(pattern, 'i');
+                    } catch (error) {
+                        logger.error(`Invalid ignore pattern: ${pattern}`, {
+                            error
+                        });
+                        // Return a pattern that matches nothing
+                        return /(?!)/; // Negative lookahead that always fails
+                    }
+                });
+                const filteredFiles = files.filter((file)=>{
+                    const fullPath = path__default.join(contextDir, file);
+                    // Test against both filename and full path for flexibility
+                    return !ignorePatternsRegex.some((regex)=>regex.test(file) || regex.test(fullPath));
+                });
                 for (const file of filteredFiles){
                     // Skip the context.md file as it's already processed
                     if (file === 'context.md') continue;
@@ -141,6 +158,7 @@ const create = (loaderOptions)=>{
                             ...sectionOptions
                         });
                         // Add this file section to the main context section
+                        // Type is correct - Section.add() accepts Section<T>
                         mainContextSection.add(fileSection, {
                             ...sectionOptions
                         });

package/dist/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sources":["../src/loader.ts"],"sourcesContent":["import path from \"path\";\nimport { z } from \"zod\";\nimport { DEFAULT_IGNORE_PATTERNS } from \"./constants\";\nimport { ParametersSchema } from \"./items/parameters\";\nimport { SectionOptions, SectionOptionsSchema } from \"./items/section\";\nimport { DEFAULT_LOGGER, wrapLogger } from \"./logger\";\nimport { Section, Weighted, createSection } from \"./riotprompt\";\nimport * as Storage from \"./util/storage\";\n\nconst OptionsSchema = z.object({\n    logger: z.any().optional().default(DEFAULT_LOGGER),\n    ignorePatterns: z.array(z.string()).optional().default(DEFAULT_IGNORE_PATTERNS),\n    parameters: ParametersSchema.optional().default({}),\n});\n\nexport type Options = z.infer<typeof OptionsSchema>;\n\nexport type OptionsParam = Partial<Options>;\n\nexport interface Instance {\n    load: <T extends Weighted>(contextDirectories?: string[], options?: SectionOptions) => Promise<Section<T>[]>;\n}\n\n/**\n * Extracts the first header from Markdown text\n * @param markdownText The Markdown text to parse\n * @returns The first header found in the Markdown or null if none is found\n */\nexport function extractFirstHeader(markdownText: string): string | null {\n    // Regular expression to match Markdown headers (# Header, ## Header, etc.)\n    const headerRegex = /^(#{1,6})\\s+(.+?)(?:\\n|$)/m;\n    const match = markdownText.match(headerRegex);\n\n    if (match && match[2]) {\n        return match[2].trim();\n    }\n\n    return null;\n}\n\n/**\n * Removes the first header from Markdown text\n * @param markdownText The Markdown text to process\n * @returns The Markdown text without the first header\n */\nexport function removeFirstHeader(markdownText: string): string {\n    // Regular expression to match Markdown headers (# Header, ## Header, etc.)\n    const headerRegex = /^(#{1,6})\\s+(.+?)(?:\\n|$)/m;\n    const match = markdownText.match(headerRegex);\n\n    if (match) {\n        return markdownText.replace(headerRegex, '').trim();\n    }\n\n    return markdownText;\n}\n\nexport const create = (loaderOptions?: OptionsParam): Instance => {\n    const options: Required<Options> = OptionsSchema.parse(loaderOptions || {}) as Required<Options>;\n    const parameters = options.parameters;\n\n    const logger = wrapLogger(options.logger, 'Loader');\n    const ignorePatterns = options.ignorePatterns;\n\n    const loadOptions = (sectionOptions: Partial<SectionOptions> = {}): SectionOptions => {\n        const currentOptions = SectionOptionsSchema.parse(sectionOptions);\n        return {\n            ...currentOptions,\n            parameters: {\n                ...parameters,\n                ...currentOptions.parameters\n            }\n        }\n    }\n\n    /**\n     * Loads context from the provided directories and returns instruction sections\n     * \n     * @param contextDirectories Directories containing context files\n     * @returns Array of instruction sections loaded from context directories\n     */\n    const load = async<T extends Weighted>(\n        contextDirectories: string[] = [],\n        options: Partial<SectionOptions> = {}\n    ): Promise<Section<T>[]> => {\n        const sectionOptions = loadOptions(options);\n\n        logger.debug(`Loading context from ${contextDirectories}`);\n        const contextSections: Section<T>[] = [];\n\n        if (!contextDirectories || contextDirectories.length === 0) {\n            logger.debug(`No context directories provided, returning empty context`);\n            return contextSections;\n        }\n\n        const storage = Storage.create({ log: logger.debug });\n\n        // Add context sections from each directory\n        for (const contextDir of contextDirectories) {\n            try {\n                const dirName = path.basename(contextDir);\n                logger.debug(`Processing context directory ${dirName}`);\n                let mainContextSection: Section<T>;\n\n                // First check if there's a context.md file\n                const contextFile = path.join(contextDir, 'context.md');\n\n                if (await storage.exists(contextFile)) {\n                    logger.debug(`Found context.md file in ${contextDir}`);\n                    const mainContextContent = await storage.readFile(contextFile, 'utf8');\n                    // Extract the first header from the Markdown content\n                    const firstHeader = extractFirstHeader(mainContextContent);\n\n                    // Use the header from context.md as the section title, or fallback to directory name\n                    const sectionTitle = firstHeader || dirName;\n                    mainContextSection = createSection<T>({ ...sectionOptions, title: sectionTitle });\n\n                    // Add content without the header\n                    if (firstHeader) {\n                        mainContextSection.add(removeFirstHeader(mainContextContent), { ...sectionOptions });\n                    } else {\n                        mainContextSection.add(mainContextContent, { ...sectionOptions });\n                    }\n                } else {\n                    // If no context.md exists, use directory name as title\n                    mainContextSection = createSection<T>({ ...sectionOptions, title: dirName });\n                }\n\n                // Get all other files in the directory\n                const files = await storage.listFiles(contextDir);\n                const ignorePatternsRegex = ignorePatterns.map(pattern => new RegExp(pattern, 'i'));\n\n                const filteredFiles = files.filter(file =>\n                    !ignorePatternsRegex.some(regex => regex.test(file))\n                );\n\n                for (const file of filteredFiles) {\n                    // Skip the context.md file as it's already processed\n                    if (file === 'context.md') continue;\n\n                    logger.debug(`Processing file ${file} in ${contextDir}`);\n                    const filePath = path.join(contextDir, file);\n                    if (await storage.isFile(filePath)) {\n                        const fileContent = await storage.readFile(filePath, 'utf8');\n                        let sectionName = file;\n                        let contentToAdd = fileContent;\n\n                        // Extract header if it exists\n                        if (file.endsWith('.md')) {\n                            const fileHeader = extractFirstHeader(fileContent);\n                            if (fileHeader) {\n                                sectionName = fileHeader;\n                                // Remove the header from the content\n                                contentToAdd = removeFirstHeader(fileContent);\n                            }\n                        }\n\n                        // Create a subsection with the extracted name\n                        const fileSection = createSection<T>({ ...sectionOptions, title: sectionName });\n                        fileSection.add(contentToAdd, { ...sectionOptions });\n\n                        // Add this file section to the main context section\n                        mainContextSection.add(fileSection as unknown as T, { ...sectionOptions });\n                    }\n                }\n\n                contextSections.push(mainContextSection);\n            } catch (error) {\n                logger.error(`Error processing context directory ${contextDir}: ${error}`);\n            }\n        }\n\n        return contextSections;\n    }\n\n\n    return {\n        load\n    }\n}\n"],"names":["OptionsSchema","z","object","logger","any","optional","default","DEFAULT_LOGGER","ignorePatterns","array","string","DEFAULT_IGNORE_PATTERNS","parameters","ParametersSchema","extractFirstHeader","markdownText","headerRegex","match","trim","removeFirstHeader","replace","create","loaderOptions","options","parse","wrapLogger","loadOptions","sectionOptions","currentOptions","SectionOptionsSchema","load","contextDirectories","debug","contextSections","length","storage","Storage","log","contextDir","dirName","path","basename","mainContextSection","contextFile","join","exists","mainContextContent","readFile","firstHeader","sectionTitle","createSection","title","add","files","listFiles","ignorePatternsRegex","map","pattern","RegExp","filteredFiles","filter","file","some","regex","test","filePath","isFile","fileContent","sectionName","contentToAdd","endsWith","fileHeader","fileSection","push","error"],"mappings":"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"}
+{"version":3,"file":"loader.js","sources":["../src/loader.ts"],"sourcesContent":["import path from \"path\";\nimport { z } from \"zod\";\nimport { DEFAULT_IGNORE_PATTERNS } from \"./constants\";\nimport { ParametersSchema } from \"./items/parameters\";\nimport { SectionOptions, SectionOptionsSchema } from \"./items/section\";\nimport { DEFAULT_LOGGER, wrapLogger } from \"./logger\";\nimport { Section, Weighted, createSection } from \"./riotprompt\";\nimport * as Storage from \"./util/storage\";\n\nconst OptionsSchema = z.object({\n    logger: z.any().optional().default(DEFAULT_LOGGER),\n    ignorePatterns: z.array(z.string()).optional().default(DEFAULT_IGNORE_PATTERNS),\n    parameters: ParametersSchema.optional().default({}),\n});\n\nexport type Options = z.infer<typeof OptionsSchema>;\n\nexport type OptionsParam = Partial<Options>;\n\nexport interface Instance {\n    load: <T extends Weighted>(contextDirectories?: string[], options?: SectionOptions) => Promise<Section<T>[]>;\n}\n\n/**\n * Extracts the first header from Markdown text\n * @param markdownText The Markdown text to parse\n * @returns The first header found in the Markdown or null if none is found\n */\nexport function extractFirstHeader(markdownText: string): string | null {\n    // Regular expression to match Markdown headers (# Header, ## Header, etc.)\n    const headerRegex = /^(#{1,6})\\s+(.+?)(?:\\n|$)/m;\n    const match = markdownText.match(headerRegex);\n\n    if (match && match[2]) {\n        return match[2].trim();\n    }\n\n    return null;\n}\n\n/**\n * Removes the first header from Markdown text\n * @param markdownText The Markdown text to process\n * @returns The Markdown text without the first header\n */\nexport function removeFirstHeader(markdownText: string): string {\n    // Regular expression to match Markdown headers (# Header, ## Header, etc.)\n    const headerRegex = /^(#{1,6})\\s+(.+?)(?:\\n|$)/m;\n    const match = markdownText.match(headerRegex);\n\n    if (match) {\n        return markdownText.replace(headerRegex, '').trim();\n    }\n\n    return markdownText;\n}\n\nexport const create = (loaderOptions?: OptionsParam): Instance => {\n    const options: Required<Options> = OptionsSchema.parse(loaderOptions || {}) as Required<Options>;\n    const parameters = options.parameters;\n\n    const logger = wrapLogger(options.logger, 'Loader');\n    const ignorePatterns = options.ignorePatterns;\n\n    const loadOptions = (sectionOptions: Partial<SectionOptions> = {}): SectionOptions => {\n        const currentOptions = SectionOptionsSchema.parse(sectionOptions);\n        return {\n            ...currentOptions,\n            parameters: {\n                ...parameters,\n                ...currentOptions.parameters\n            }\n        }\n    }\n\n    /**\n     * Loads context from the provided directories and returns instruction sections\n     *\n     * @param contextDirectories Directories containing context files\n     * @returns Array of instruction sections loaded from context directories\n     */\n    const load = async<T extends Weighted>(\n        contextDirectories: string[] = [],\n        options: Partial<SectionOptions> = {}\n    ): Promise<Section<T>[]> => {\n        const sectionOptions = loadOptions(options);\n\n        logger.debug(`Loading context from ${contextDirectories}`);\n        const contextSections: Section<T>[] = [];\n\n        if (!contextDirectories || contextDirectories.length === 0) {\n            logger.debug(`No context directories provided, returning empty context`);\n            return contextSections;\n        }\n\n        const storage = Storage.create({ log: logger.debug });\n\n        // Add context sections from each directory\n        for (const contextDir of contextDirectories) {\n            try {\n                const dirName = path.basename(contextDir);\n                logger.debug(`Processing context directory ${dirName}`);\n                let mainContextSection: Section<T>;\n\n                // First check if there's a context.md file\n                const contextFile = path.join(contextDir, 'context.md');\n\n                if (await storage.exists(contextFile)) {\n                    logger.debug(`Found context.md file in ${contextDir}`);\n                    const mainContextContent = await storage.readFile(contextFile, 'utf8');\n                    // Extract the first header from the Markdown content\n                    const firstHeader = extractFirstHeader(mainContextContent);\n\n                    // Use the header from context.md as the section title, or fallback to directory name\n                    const sectionTitle = firstHeader || dirName;\n                    mainContextSection = createSection<T>({ ...sectionOptions, title: sectionTitle });\n\n                    // Add content without the header\n                    if (firstHeader) {\n                        mainContextSection.add(removeFirstHeader(mainContextContent), { ...sectionOptions });\n                    } else {\n                        mainContextSection.add(mainContextContent, { ...sectionOptions });\n                    }\n                } else {\n                    // If no context.md exists, use directory name as title\n                    mainContextSection = createSection<T>({ ...sectionOptions, title: dirName });\n                }\n\n                // Get all other files in the directory\n                const files = await storage.listFiles(contextDir);\n                const ignorePatternsRegex = ignorePatterns.map(pattern => {\n                    try {\n                        return new RegExp(pattern, 'i');\n                    } catch (error) {\n                        logger.error(`Invalid ignore pattern: ${pattern}`, { error });\n                        // Return a pattern that matches nothing\n                        return /(?!)/;  // Negative lookahead that always fails\n                    }\n                });\n\n                const filteredFiles = files.filter(file => {\n                    const fullPath = path.join(contextDir, file);\n                    // Test against both filename and full path for flexibility\n                    return !ignorePatternsRegex.some(regex => regex.test(file) || regex.test(fullPath));\n                });\n\n                for (const file of filteredFiles) {\n                    // Skip the context.md file as it's already processed\n                    if (file === 'context.md') continue;\n\n                    logger.debug(`Processing file ${file} in ${contextDir}`);\n                    const filePath = path.join(contextDir, file);\n                    if (await storage.isFile(filePath)) {\n                        const fileContent = await storage.readFile(filePath, 'utf8');\n                        let sectionName = file;\n                        let contentToAdd = fileContent;\n\n                        // Extract header if it exists\n                        if (file.endsWith('.md')) {\n                            const fileHeader = extractFirstHeader(fileContent);\n                            if (fileHeader) {\n                                sectionName = fileHeader;\n                                // Remove the header from the content\n                                contentToAdd = removeFirstHeader(fileContent);\n                            }\n                        }\n\n                        // Create a subsection with the extracted name\n                        const fileSection = createSection<T>({ ...sectionOptions, title: sectionName });\n                        fileSection.add(contentToAdd, { ...sectionOptions });\n\n                        // Add this file section to the main context section\n                        // Type is correct - Section.add() accepts Section<T>\n                        mainContextSection.add(fileSection, { ...sectionOptions });\n                    }\n                }\n\n                contextSections.push(mainContextSection);\n            } catch (error) {\n                logger.error(`Error processing context directory ${contextDir}: ${error}`);\n            }\n        }\n\n        return contextSections;\n    }\n\n\n    return {\n        load\n    }\n}\n"],"names":["OptionsSchema","z","object","logger","any","optional","default","DEFAULT_LOGGER","ignorePatterns","array","string","DEFAULT_IGNORE_PATTERNS","parameters","ParametersSchema","extractFirstHeader","markdownText","headerRegex","match","trim","removeFirstHeader","replace","create","loaderOptions","options","parse","wrapLogger","loadOptions","sectionOptions","currentOptions","SectionOptionsSchema","load","contextDirectories","debug","contextSections","length","storage","Storage","log","contextDir","dirName","path","basename","mainContextSection","contextFile","join","exists","mainContextContent","readFile","firstHeader","sectionTitle","createSection","title","add","files","listFiles","ignorePatternsRegex","map","pattern","RegExp","error","filteredFiles","filter","file","fullPath","some","regex","test","filePath","isFile","fileContent","sectionName","contentToAdd","endsWith","fileHeader","fileSection","push"],"mappings":"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"}

package/dist/message-builder.d.ts

@@ -0,0 +1,156 @@
+import { Model } from './chat';
+import { Context } from './items/context';
+import { Instruction } from './items/instruction';
+import { Section } from './items/section';
+import { ConversationMessage, ToolCall } from './conversation';
+import * as Formatter from "./formatter";
+/**
+ * Semantic message role
+ */
+export type SemanticRole = 'system' | 'user' | 'assistant' | 'tool' | 'developer';
+/**
+ * Message metadata
+ */
+export interface MessageMetadata {
+    priority?: 'high' | 'medium' | 'low';
+    timestamp?: Date;
+    source?: string;
+    [key: string]: any;
+}
+/**
+ * MessageBuilder provides semantic, type-safe message construction.
+ *
+ * Features:
+ * - Semantic message types (system, user, assistant, tool)
+ * - Model-specific role handling (system vs developer)
+ * - Structured content composition
+ * - Metadata attachment
+ * - Format-aware building
+ *
+ * @example
+ * ```typescript
+ * const message = MessageBuilder.system()
+ *   .withContent('You are a helpful assistant')
+ *   .withInstructions(instructionSection)
+ *   .buildForModel('gpt-4o');
+ *
+ * const toolMessage = MessageBuilder.tool('call_123')
+ *   .withResult(result)
+ *   .withMetadata({ duration: 45 })
+ *   .build();
+ * ```
+ */
+export declare class MessageBuilder {
+    private semanticRole;
+    private contentParts;
+    private metadata;
+    private formatter?;
+    private toolCallId?;
+    private toolCalls?;
+    private logger;
+    private constructor();
+    /**
+     * Create system message builder
+     */
+    static system(logger?: any): MessageBuilder;
+    /**
+     * Create user message builder
+     */
+    static user(logger?: any): MessageBuilder;
+    /**
+     * Create assistant message builder
+     */
+    static assistant(logger?: any): MessageBuilder;
+    /**
+     * Create tool message builder
+     */
+    static tool(callId: string, logger?: any): MessageBuilder;
+    /**
+     * Create developer message builder (for o1 models)
+     */
+    static developer(logger?: any): MessageBuilder;
+    /**
+     * Add content to message
+     */
+    withContent(content: string | Section<any>): this;
+    /**
+     * Add persona section (typically for system messages)
+     */
+    withPersona(persona: Section<Instruction>): this;
+    /**
+     * Add instructions section
+     */
+    withInstructions(instructions: Section<Instruction> | string[]): this;
+    /**
+     * Add context section
+     */
+    withContext(context: Section<Context> | Array<{
+        content: string;
+        title?: string;
+    }>): this;
+    /**
+     * Set tool call ID (for tool messages)
+     */
+    withCallId(id: string): this;
+    /**
+     * Set tool result (for tool messages)
+     */
+    withResult(result: any): this;
+    /**
+     * Add tool calls (for assistant messages)
+     */
+    withToolCalls(calls: ToolCall[]): this;
+    /**
+     * Add metadata
+     */
+    withMetadata(metadata: Record<string, any>): this;
+    /**
+     * Add timestamp to metadata
+     */
+    withTimestamp(): this;
+    /**
+     * Set priority in metadata
+     */
+    withPriority(priority: 'high' | 'medium' | 'low'): this;
+    /**
+     * Set formatter for section rendering
+     */
+    withFormatter(formatter: Formatter.Instance): this;
+    /**
+     * Build message with semantic role
+     */
+    build(): ConversationMessage;
+    /**
+     * Build message with model-specific role
+     */
+    buildForModel(model: Model): ConversationMessage;
+}
+/**
+ * Message template functions for common patterns
+ */
+export declare const MessageTemplates: {
+    /**
+     * System message for agentic tasks
+     */
+    agenticSystem: (persona?: string, instructions?: string[]) => MessageBuilder;
+    /**
+     * User query with optional context
+     */
+    userQuery: (query: string, context?: Array<{
+        content: string;
+        title?: string;
+    }>) => MessageBuilder;
+    /**
+     * Tool result with metadata
+     */
+    toolResult: (callId: string, result: any, metadata?: Record<string, any>) => MessageBuilder;
+    /**
+     * Tool success result
+     */
+    toolSuccess: (callId: string, result: any, duration?: number) => MessageBuilder;
+    /**
+     * Tool failure result
+     */
+    toolFailure: (callId: string, error: Error) => MessageBuilder;
+};
+export default MessageBuilder;

package/dist/message-builder.js

@@ -0,0 +1,256 @@
+import { wrapLogger, DEFAULT_LOGGER } from './logger.js';
+import { create } from './formatter.js';
+import { getPersonaRole } from './model-config.js';
+
+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;
+}
+/**
+ * MessageBuilder provides semantic, type-safe message construction.
+ *
+ * Features:
+ * - Semantic message types (system, user, assistant, tool)
+ * - Model-specific role handling (system vs developer)
+ * - Structured content composition
+ * - Metadata attachment
+ * - Format-aware building
+ *
+ * @example
+ * ```typescript
+ * const message = MessageBuilder.system()
+ *   .withContent('You are a helpful assistant')
+ *   .withInstructions(instructionSection)
+ *   .buildForModel('gpt-4o');
+ *
+ * const toolMessage = MessageBuilder.tool('call_123')
+ *   .withResult(result)
+ *   .withMetadata({ duration: 45 })
+ *   .build();
+ * ```
+ */ class MessageBuilder {
+    /**
+     * Create system message builder
+     */ static system(logger) {
+        return new MessageBuilder('system', logger);
+    }
+    /**
+     * Create user message builder
+     */ static user(logger) {
+        return new MessageBuilder('user', logger);
+    }
+    /**
+     * Create assistant message builder
+     */ static assistant(logger) {
+        return new MessageBuilder('assistant', logger);
+    }
+    /**
+     * Create tool message builder
+     */ static tool(callId, logger) {
+        const builder = new MessageBuilder('tool', logger);
+        builder.toolCallId = callId;
+        return builder;
+    }
+    /**
+     * Create developer message builder (for o1 models)
+     */ static developer(logger) {
+        return new MessageBuilder('developer', logger);
+    }
+    /**
+     * Add content to message
+     */ withContent(content) {
+        if (typeof content === 'string') {
+            this.contentParts.push(content);
+        } else {
+            // Format section
+            const formatter$1 = this.formatter || create();
+            this.contentParts.push(formatter$1.format(content));
+        }
+        return this;
+    }
+    /**
+     * Add persona section (typically for system messages)
+     */ withPersona(persona) {
+        const formatter$1 = this.formatter || create();
+        this.contentParts.push(formatter$1.format(persona));
+        return this;
+    }
+    /**
+     * Add instructions section
+     */ withInstructions(instructions) {
+        if (Array.isArray(instructions)) {
+            this.contentParts.push(instructions.join('\n'));
+        } else {
+            const formatter$1 = this.formatter || create();
+            this.contentParts.push(formatter$1.format(instructions));
+        }
+        return this;
+    }
+    /**
+     * Add context section
+     */ withContext(context) {
+        if (Array.isArray(context)) {
+            const contextStr = context.map((c)=>c.title ? `## ${c.title}\n\n${c.content}` : c.content).join('\n\n');
+            this.contentParts.push(contextStr);
+        } else {
+            const formatter$1 = this.formatter || create();
+            this.contentParts.push(formatter$1.format(context));
+        }
+        return this;
+    }
+    /**
+     * Set tool call ID (for tool messages)
+     */ withCallId(id) {
+        this.toolCallId = id;
+        return this;
+    }
+    /**
+     * Set tool result (for tool messages)
+     */ withResult(result) {
+        const resultStr = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+        this.contentParts.push(resultStr);
+        return this;
+    }
+    /**
+     * Add tool calls (for assistant messages)
+     */ withToolCalls(calls) {
+        this.toolCalls = calls;
+        return this;
+    }
+    /**
+     * Add metadata
+     */ withMetadata(metadata) {
+        this.metadata = {
+            ...this.metadata,
+            ...metadata
+        };
+        return this;
+    }
+    /**
+     * Add timestamp to metadata
+     */ withTimestamp() {
+        this.metadata.timestamp = new Date();
+        return this;
+    }
+    /**
+     * Set priority in metadata
+     */ withPriority(priority) {
+        this.metadata.priority = priority;
+        return this;
+    }
+    /**
+     * Set formatter for section rendering
+     */ withFormatter(formatter) {
+        this.formatter = formatter;
+        return this;
+    }
+    /**
+     * Build message with semantic role
+     */ build() {
+        const content = this.contentParts.join('\n\n');
+        const message = {
+            role: this.semanticRole,
+            content: content || null
+        };
+        // Add tool-specific fields
+        if (this.semanticRole === 'tool' && this.toolCallId) {
+            message.tool_call_id = this.toolCallId;
+        }
+        if (this.toolCalls) {
+            message.tool_calls = this.toolCalls;
+        }
+        return message;
+    }
+    /**
+     * Build message with model-specific role
+     */ buildForModel(model) {
+        const message = this.build();
+        // Handle model-specific role requirements
+        if (this.semanticRole === 'system') {
+            // Use model registry to determine correct role
+            const personaRole = getPersonaRole(model);
+            if (personaRole === 'developer') {
+                message.role = 'developer';
+            }
+        }
+        return message;
+    }
+    constructor(role, logger){
+        _define_property(this, "semanticRole", void 0);
+        _define_property(this, "contentParts", void 0);
+        _define_property(this, "metadata", void 0);
+        _define_property(this, "formatter", void 0);
+        _define_property(this, "toolCallId", void 0);
+        _define_property(this, "toolCalls", void 0);
+        _define_property(this, "logger", void 0);
+        this.semanticRole = role;
+        this.contentParts = [];
+        this.metadata = {};
+        this.logger = wrapLogger(logger || DEFAULT_LOGGER, 'MessageBuilder');
+    }
+}
+/**
+ * Message template functions for common patterns
+ */ const MessageTemplates = {
+    /**
+     * System message for agentic tasks
+     */ agenticSystem: (persona, instructions)=>{
+        const builder = MessageBuilder.system();
+        if (persona) {
+            builder.withContent(persona);
+        }
+        if (instructions) {
+            builder.withInstructions(instructions);
+        }
+        return builder;
+    },
+    /**
+     * User query with optional context
+     */ userQuery: (query, context)=>{
+        const builder = MessageBuilder.user().withContent(query);
+        if (context) {
+            builder.withContext(context);
+        }
+        return builder;
+    },
+    /**
+     * Tool result with metadata
+     */ toolResult: (callId, result, metadata)=>{
+        const builder = MessageBuilder.tool(callId).withResult(result).withTimestamp();
+        if (metadata) {
+            builder.withMetadata(metadata);
+        }
+        return builder;
+    },
+    /**
+     * Tool success result
+     */ toolSuccess: (callId, result, duration)=>{
+        return MessageBuilder.tool(callId).withResult(result).withMetadata({
+            success: true,
+            duration
+        }).withTimestamp();
+    },
+    /**
+     * Tool failure result
+     */ toolFailure: (callId, error)=>{
+        return MessageBuilder.tool(callId).withResult({
+            error: error.message,
+            stack: error.stack
+        }).withMetadata({
+            success: false,
+            errorName: error.name
+        }).withTimestamp();
+    }
+};
+
+export { MessageBuilder, MessageTemplates, MessageBuilder as default };
+//# sourceMappingURL=message-builder.js.map

package/dist/message-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-builder.js","sources":["../src/message-builder.ts"],"sourcesContent":["import { Model } from \"./chat\";\nimport { Context } from \"./items/context\";\nimport { Instruction } from \"./items/instruction\";\nimport { Section } from \"./items/section\";\nimport { DEFAULT_LOGGER, wrapLogger } from \"./logger\";\nimport type { ConversationMessage, ToolCall } from \"./conversation\";\nimport * as Formatter from \"./formatter\";\nimport { getPersonaRole as getPersonaRoleFromRegistry } from \"./model-config\";\n\n// ===== TYPE DEFINITIONS =====\n\n/**\n * Semantic message role\n */\nexport type SemanticRole = 'system' | 'user' | 'assistant' | 'tool' | 'developer';\n\n/**\n * Message metadata\n */\nexport interface MessageMetadata {\n    priority?: 'high' | 'medium' | 'low';\n    timestamp?: Date;\n    source?: string;\n    [key: string]: any;\n}\n\n/**\n * MessageBuilder provides semantic, type-safe message construction.\n *\n * Features:\n * - Semantic message types (system, user, assistant, tool)\n * - Model-specific role handling (system vs developer)\n * - Structured content composition\n * - Metadata attachment\n * - Format-aware building\n *\n * @example\n * ```typescript\n * const message = MessageBuilder.system()\n *   .withContent('You are a helpful assistant')\n *   .withInstructions(instructionSection)\n *   .buildForModel('gpt-4o');\n *\n * const toolMessage = MessageBuilder.tool('call_123')\n *   .withResult(result)\n *   .withMetadata({ duration: 45 })\n *   .build();\n * ```\n */\nexport class MessageBuilder {\n    private semanticRole: SemanticRole;\n    private contentParts: string[];\n    private metadata: MessageMetadata;\n    private formatter?: Formatter.Instance;\n    private toolCallId?: string;\n    private toolCalls?: ToolCall[];\n    private logger: any;\n\n    private constructor(role: SemanticRole, logger?: any) {\n        this.semanticRole = role;\n        this.contentParts = [];\n        this.metadata = {};\n        this.logger = wrapLogger(logger || DEFAULT_LOGGER, 'MessageBuilder');\n    }\n\n    /**\n     * Create system message builder\n     */\n    static system(logger?: any): MessageBuilder {\n        return new MessageBuilder('system', logger);\n    }\n\n    /**\n     * Create user message builder\n     */\n    static user(logger?: any): MessageBuilder {\n        return new MessageBuilder('user', logger);\n    }\n\n    /**\n     * Create assistant message builder\n     */\n    static assistant(logger?: any): MessageBuilder {\n        return new MessageBuilder('assistant', logger);\n    }\n\n    /**\n     * Create tool message builder\n     */\n    static tool(callId: string, logger?: any): MessageBuilder {\n        const builder = new MessageBuilder('tool', logger);\n        builder.toolCallId = callId;\n        return builder;\n    }\n\n    /**\n     * Create developer message builder (for o1 models)\n     */\n    static developer(logger?: any): MessageBuilder {\n        return new MessageBuilder('developer', logger);\n    }\n\n    /**\n     * Add content to message\n     */\n    withContent(content: string | Section<any>): this {\n        if (typeof content === 'string') {\n            this.contentParts.push(content);\n        } else {\n            // Format section\n            const formatter = this.formatter || Formatter.create();\n            this.contentParts.push(formatter.format(content));\n        }\n        return this;\n    }\n\n    /**\n     * Add persona section (typically for system messages)\n     */\n    withPersona(persona: Section<Instruction>): this {\n        const formatter = this.formatter || Formatter.create();\n        this.contentParts.push(formatter.format(persona));\n        return this;\n    }\n\n    /**\n     * Add instructions section\n     */\n    withInstructions(instructions: Section<Instruction> | string[]): this {\n        if (Array.isArray(instructions)) {\n            this.contentParts.push(instructions.join('\\n'));\n        } else {\n            const formatter = this.formatter || Formatter.create();\n            this.contentParts.push(formatter.format(instructions));\n        }\n        return this;\n    }\n\n    /**\n     * Add context section\n     */\n    withContext(context: Section<Context> | Array<{ content: string; title?: string }>): this {\n        if (Array.isArray(context)) {\n            const contextStr = context.map(c =>\n                c.title ? `## ${c.title}\\n\\n${c.content}` : c.content\n            ).join('\\n\\n');\n            this.contentParts.push(contextStr);\n        } else {\n            const formatter = this.formatter || Formatter.create();\n            this.contentParts.push(formatter.format(context));\n        }\n        return this;\n    }\n\n    /**\n     * Set tool call ID (for tool messages)\n     */\n    withCallId(id: string): this {\n        this.toolCallId = id;\n        return this;\n    }\n\n    /**\n     * Set tool result (for tool messages)\n     */\n    withResult(result: any): this {\n        const resultStr = typeof result === 'string' ? result : JSON.stringify(result, null, 2);\n        this.contentParts.push(resultStr);\n        return this;\n    }\n\n    /**\n     * Add tool calls (for assistant messages)\n     */\n    withToolCalls(calls: ToolCall[]): this {\n        this.toolCalls = calls;\n        return this;\n    }\n\n    /**\n     * Add metadata\n     */\n    withMetadata(metadata: Record<string, any>): this {\n        this.metadata = { ...this.metadata, ...metadata };\n        return this;\n    }\n\n    /**\n     * Add timestamp to metadata\n     */\n    withTimestamp(): this {\n        this.metadata.timestamp = new Date();\n        return this;\n    }\n\n    /**\n     * Set priority in metadata\n     */\n    withPriority(priority: 'high' | 'medium' | 'low'): this {\n        this.metadata.priority = priority;\n        return this;\n    }\n\n    /**\n     * Set formatter for section rendering\n     */\n    withFormatter(formatter: Formatter.Instance): this {\n        this.formatter = formatter;\n        return this;\n    }\n\n    /**\n     * Build message with semantic role\n     */\n    build(): ConversationMessage {\n        const content = this.contentParts.join('\\n\\n');\n\n        const message: ConversationMessage = {\n            role: this.semanticRole as any,\n            content: content || null,\n        };\n\n        // Add tool-specific fields\n        if (this.semanticRole === 'tool' && this.toolCallId) {\n            message.tool_call_id = this.toolCallId;\n        }\n\n        if (this.toolCalls) {\n            message.tool_calls = this.toolCalls;\n        }\n\n        return message;\n    }\n\n    /**\n     * Build message with model-specific role\n     */\n    buildForModel(model: Model): ConversationMessage {\n        const message = this.build();\n\n        // Handle model-specific role requirements\n        if (this.semanticRole === 'system') {\n            // Use model registry to determine correct role\n            const personaRole = getPersonaRoleFromRegistry(model);\n            if (personaRole === 'developer') {\n                message.role = 'developer' as any;\n            }\n        }\n\n        return message;\n    }\n}\n\n/**\n * Message template functions for common patterns\n */\nexport const MessageTemplates = {\n    /**\n     * System message for agentic tasks\n     */\n    agenticSystem: (persona?: string, instructions?: string[]) => {\n        const builder = MessageBuilder.system();\n\n        if (persona) {\n            builder.withContent(persona);\n        }\n\n        if (instructions) {\n            builder.withInstructions(instructions);\n        }\n\n        return builder;\n    },\n\n    /**\n     * User query with optional context\n     */\n    userQuery: (query: string, context?: Array<{ content: string; title?: string }>) => {\n        const builder = MessageBuilder.user().withContent(query);\n\n        if (context) {\n            builder.withContext(context);\n        }\n\n        return builder;\n    },\n\n    /**\n     * Tool result with metadata\n     */\n    toolResult: (callId: string, result: any, metadata?: Record<string, any>) => {\n        const builder = MessageBuilder.tool(callId)\n            .withResult(result)\n            .withTimestamp();\n\n        if (metadata) {\n            builder.withMetadata(metadata);\n        }\n\n        return builder;\n    },\n\n    /**\n     * Tool success result\n     */\n    toolSuccess: (callId: string, result: any, duration?: number) => {\n        return MessageBuilder.tool(callId)\n            .withResult(result)\n            .withMetadata({ success: true, duration })\n            .withTimestamp();\n    },\n\n    /**\n     * Tool failure result\n     */\n    toolFailure: (callId: string, error: Error) => {\n        return MessageBuilder.tool(callId)\n            .withResult({ error: error.message, stack: error.stack })\n            .withMetadata({ success: false, errorName: error.name })\n            .withTimestamp();\n    },\n};\n\nexport default MessageBuilder;\n\n"],"names":["MessageBuilder","system","logger","user","assistant","tool","callId","builder","toolCallId","developer","withContent","content","contentParts","push","formatter","Formatter","format","withPersona","persona","withInstructions","instructions","Array","isArray","join","withContext","context","contextStr","map","c","title","withCallId","id","withResult","result","resultStr","JSON","stringify","withToolCalls","calls","toolCalls","withMetadata","metadata","withTimestamp","timestamp","Date","withPriority","priority","withFormatter","build","message","role","semanticRole","tool_call_id","tool_calls","buildForModel","model","personaRole","getPersonaRoleFromRegistry","wrapLogger","DEFAULT_LOGGER","MessageTemplates","agenticSystem","userQuery","query","toolResult","toolSuccess","duration","success","toolFailure","error","stack","errorName","name"],"mappings":"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"}