@riotprompt/riotprompt 0.0.8 → 0.0.10

package/dist/model-config.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Model Configuration System
+ *
+ * Provides a flexible, user-configurable system for model detection and configuration
+ * that doesn't hardcode model names.
+ */
+/**
+ * Model role mapping for persona/system messages
+ */
+export type PersonaRole = 'system' | 'developer';
+/**
+ * Tokenizer encoding to use for token counting
+ */
+export type TokenizerEncoding = 'gpt-4o' | 'cl100k_base' | 'o200k_base';
+/**
+ * Configuration for a model or model family
+ */
+export interface ModelConfig {
+    pattern?: RegExp;
+    exactMatch?: string;
+    personaRole: PersonaRole;
+    encoding: TokenizerEncoding;
+    supportsToolCalls?: boolean;
+    maxTokens?: number;
+    family?: string;
+    description?: string;
+}
+/**
+ * Model registry for managing model configurations
+ */
+export declare class ModelRegistry {
+    private configs;
+    private cache;
+    private logger;
+    constructor(logger?: any);
+    /**
+     * Register default model configurations
+     */
+    private registerDefaults;
+    /**
+     * Register a model configuration
+     * Configs are checked in registration order (first match wins)
+     */
+    register(config: ModelConfig): void;
+    /**
+     * Get configuration for a model
+     */
+    getConfig(model: string): ModelConfig;
+    /**
+     * Get persona role for a model
+     */
+    getPersonaRole(model: string): PersonaRole;
+    /**
+     * Get tokenizer encoding for a model
+     */
+    getEncoding(model: string): TokenizerEncoding;
+    /**
+     * Check if model supports tool calls
+     */
+    supportsToolCalls(model: string): boolean;
+    /**
+     * Get model family
+     */
+    getFamily(model: string): string | undefined;
+    /**
+     * Clear all registered configs and reset to defaults
+     */
+    reset(): void;
+    /**
+     * Clear cache (useful if configs are modified)
+     */
+    clearCache(): void;
+    /**
+     * Get all registered configurations
+     */
+    getAllConfigs(): ModelConfig[];
+}
+/**
+ * Get the global model registry
+ */
+export declare function getModelRegistry(logger?: any): ModelRegistry;
+/**
+ * Reset the global registry (useful for testing)
+ */
+export declare function resetModelRegistry(): void;
+/**
+ * Helper functions using global registry
+ */
+export declare function getPersonaRole(model: string): PersonaRole;
+export declare function getEncoding(model: string): TokenizerEncoding;
+export declare function supportsToolCalls(model: string): boolean;
+export declare function getModelFamily(model: string): string | undefined;
+/**
+ * Configure a custom model
+ *
+ * @example
+ * ```typescript
+ * // Add support for a new model family
+ * configureModel({
+ *   pattern: /^gemini/i,
+ *   personaRole: 'system',
+ *   encoding: 'cl100k_base',
+ *   family: 'gemini'
+ * });
+ *
+ * // Add specific model override
+ * configureModel({
+ *   exactMatch: 'custom-model-v1',
+ *   personaRole: 'developer',
+ *   encoding: 'gpt-4o'
+ * });
+ * ```
+ */
+export declare function configureModel(config: ModelConfig): void;
+export default ModelRegistry;

package/dist/model-config.js

@@ -0,0 +1,205 @@
+import { wrapLogger, DEFAULT_LOGGER } from './logger.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;
+}
+/**
+ * Model registry for managing model configurations
+ */ class ModelRegistry {
+    /**
+     * Register default model configurations
+     */ registerDefaults() {
+        // GPT-4 family (uses 'system' role)
+        this.register({
+            pattern: /^gpt-4/i,
+            personaRole: 'system',
+            encoding: 'gpt-4o',
+            supportsToolCalls: true,
+            family: 'gpt-4',
+            description: 'GPT-4 family models'
+        });
+        // O-series models (uses 'developer' role)
+        this.register({
+            pattern: /^o\d+/i,
+            personaRole: 'developer',
+            encoding: 'gpt-4o',
+            supportsToolCalls: true,
+            family: 'o-series',
+            description: 'O-series reasoning models'
+        });
+        // Claude family (uses 'system' role)
+        this.register({
+            pattern: /^claude/i,
+            personaRole: 'system',
+            encoding: 'cl100k_base',
+            supportsToolCalls: true,
+            family: 'claude',
+            description: 'Claude family models'
+        });
+        // Default fallback
+        this.register({
+            pattern: /.*/,
+            personaRole: 'system',
+            encoding: 'gpt-4o',
+            supportsToolCalls: true,
+            family: 'unknown',
+            description: 'Default fallback configuration'
+        });
+        this.logger.debug('Registered default model configurations');
+    }
+    /**
+     * Register a model configuration
+     * Configs are checked in registration order (first match wins)
+     */ register(config) {
+        var _config_pattern;
+        // Validate config
+        if (!config.pattern && !config.exactMatch) {
+            throw new Error('Model config must have either pattern or exactMatch');
+        }
+        this.configs.push(config);
+        this.cache.clear(); // Clear cache when new config is added
+        this.logger.debug('Registered model config', {
+            family: config.family,
+            pattern: (_config_pattern = config.pattern) === null || _config_pattern === void 0 ? void 0 : _config_pattern.source,
+            exactMatch: config.exactMatch
+        });
+    }
+    /**
+     * Get configuration for a model
+     */ getConfig(model) {
+        // Check cache first
+        if (this.cache.has(model)) {
+            return this.cache.get(model);
+        }
+        // Find matching config (first match wins)
+        for (const config of this.configs){
+            if (config.exactMatch && config.exactMatch === model) {
+                this.cache.set(model, config);
+                return config;
+            }
+            if (config.pattern && config.pattern.test(model)) {
+                this.cache.set(model, config);
+                return config;
+            }
+        }
+        // Should never happen due to default fallback, but just in case
+        throw new Error(`No configuration found for model: ${model}`);
+    }
+    /**
+     * Get persona role for a model
+     */ getPersonaRole(model) {
+        return this.getConfig(model).personaRole;
+    }
+    /**
+     * Get tokenizer encoding for a model
+     */ getEncoding(model) {
+        return this.getConfig(model).encoding;
+    }
+    /**
+     * Check if model supports tool calls
+     */ supportsToolCalls(model) {
+        var _this_getConfig_supportsToolCalls;
+        return (_this_getConfig_supportsToolCalls = this.getConfig(model).supportsToolCalls) !== null && _this_getConfig_supportsToolCalls !== void 0 ? _this_getConfig_supportsToolCalls : true;
+    }
+    /**
+     * Get model family
+     */ getFamily(model) {
+        return this.getConfig(model).family;
+    }
+    /**
+     * Clear all registered configs and reset to defaults
+     */ reset() {
+        this.configs = [];
+        this.cache.clear();
+        this.registerDefaults();
+        this.logger.debug('Reset model configurations to defaults');
+    }
+    /**
+     * Clear cache (useful if configs are modified)
+     */ clearCache() {
+        this.cache.clear();
+        this.logger.debug('Cleared model configuration cache');
+    }
+    /**
+     * Get all registered configurations
+     */ getAllConfigs() {
+        return [
+            ...this.configs
+        ];
+    }
+    constructor(logger){
+        _define_property(this, "configs", void 0);
+        _define_property(this, "cache", void 0);
+        _define_property(this, "logger", void 0);
+        this.configs = [];
+        this.cache = new Map();
+        this.logger = wrapLogger(logger || DEFAULT_LOGGER, 'ModelRegistry');
+        // Register default configurations
+        this.registerDefaults();
+    }
+}
+// Global registry instance
+let globalRegistry = null;
+/**
+ * Get the global model registry
+ */ function getModelRegistry(logger) {
+    if (!globalRegistry) {
+        globalRegistry = new ModelRegistry(logger);
+    }
+    return globalRegistry;
+}
+/**
+ * Reset the global registry (useful for testing)
+ */ function resetModelRegistry() {
+    globalRegistry = null;
+}
+/**
+ * Helper functions using global registry
+ */ function getPersonaRole(model) {
+    return getModelRegistry().getPersonaRole(model);
+}
+function getEncoding(model) {
+    return getModelRegistry().getEncoding(model);
+}
+function supportsToolCalls(model) {
+    return getModelRegistry().supportsToolCalls(model);
+}
+function getModelFamily(model) {
+    return getModelRegistry().getFamily(model);
+}
+/**
+ * Configure a custom model
+ *
+ * @example
+ * ```typescript
+ * // Add support for a new model family
+ * configureModel({
+ *   pattern: /^gemini/i,
+ *   personaRole: 'system',
+ *   encoding: 'cl100k_base',
+ *   family: 'gemini'
+ * });
+ *
+ * // Add specific model override
+ * configureModel({
+ *   exactMatch: 'custom-model-v1',
+ *   personaRole: 'developer',
+ *   encoding: 'gpt-4o'
+ * });
+ * ```
+ */ function configureModel(config) {
+    getModelRegistry().register(config);
+}
+
+export { ModelRegistry, configureModel, ModelRegistry as default, getEncoding, getModelFamily, getModelRegistry, getPersonaRole, resetModelRegistry, supportsToolCalls };
+//# sourceMappingURL=model-config.js.map

package/dist/model-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-config.js","sources":["../src/model-config.ts"],"sourcesContent":["/**\n * Model Configuration System\n *\n * Provides a flexible, user-configurable system for model detection and configuration\n * that doesn't hardcode model names.\n */\n\nimport { DEFAULT_LOGGER, wrapLogger } from \"./logger\";\n\n// ===== TYPE DEFINITIONS =====\n\n/**\n * Model role mapping for persona/system messages\n */\nexport type PersonaRole = 'system' | 'developer';\n\n/**\n * Tokenizer encoding to use for token counting\n */\nexport type TokenizerEncoding = 'gpt-4o' | 'cl100k_base' | 'o200k_base';\n\n/**\n * Configuration for a model or model family\n */\nexport interface ModelConfig {\n    // Model identification\n    pattern?: RegExp;           // Pattern to match model name\n    exactMatch?: string;        // Exact model name match\n\n    // Model characteristics\n    personaRole: PersonaRole;   // Role to use for persona/system messages\n    encoding: TokenizerEncoding; // Tokenizer encoding\n\n    // Capabilities\n    supportsToolCalls?: boolean;\n    maxTokens?: number;\n\n    // Metadata\n    family?: string;            // Model family (e.g., 'gpt-4', 'o-series', 'claude')\n    description?: string;\n}\n\n/**\n * Model registry for managing model configurations\n */\nexport class ModelRegistry {\n    private configs: ModelConfig[];\n    private cache: Map<string, ModelConfig>;\n    private logger: any;\n\n    constructor(logger?: any) {\n        this.configs = [];\n        this.cache = new Map();\n        this.logger = wrapLogger(logger || DEFAULT_LOGGER, 'ModelRegistry');\n\n        // Register default configurations\n        this.registerDefaults();\n    }\n\n    /**\n     * Register default model configurations\n     */\n    private registerDefaults(): void {\n        // GPT-4 family (uses 'system' role)\n        this.register({\n            pattern: /^gpt-4/i,\n            personaRole: 'system',\n            encoding: 'gpt-4o',\n            supportsToolCalls: true,\n            family: 'gpt-4',\n            description: 'GPT-4 family models'\n        });\n\n        // O-series models (uses 'developer' role)\n        this.register({\n            pattern: /^o\\d+/i,  // Matches o1, o2, o3, o4, etc.\n            personaRole: 'developer',\n            encoding: 'gpt-4o',\n            supportsToolCalls: true,\n            family: 'o-series',\n            description: 'O-series reasoning models'\n        });\n\n        // Claude family (uses 'system' role)\n        this.register({\n            pattern: /^claude/i,\n            personaRole: 'system',\n            encoding: 'cl100k_base',\n            supportsToolCalls: true,\n            family: 'claude',\n            description: 'Claude family models'\n        });\n\n        // Default fallback\n        this.register({\n            pattern: /.*/,  // Matches anything\n            personaRole: 'system',\n            encoding: 'gpt-4o',\n            supportsToolCalls: true,\n            family: 'unknown',\n            description: 'Default fallback configuration'\n        });\n\n        this.logger.debug('Registered default model configurations');\n    }\n\n    /**\n     * Register a model configuration\n     * Configs are checked in registration order (first match wins)\n     */\n    register(config: ModelConfig): void {\n        // Validate config\n        if (!config.pattern && !config.exactMatch) {\n            throw new Error('Model config must have either pattern or exactMatch');\n        }\n\n        this.configs.push(config);\n        this.cache.clear(); // Clear cache when new config is added\n\n        this.logger.debug('Registered model config', {\n            family: config.family,\n            pattern: config.pattern?.source,\n            exactMatch: config.exactMatch\n        });\n    }\n\n    /**\n     * Get configuration for a model\n     */\n    getConfig(model: string): ModelConfig {\n        // Check cache first\n        if (this.cache.has(model)) {\n            return this.cache.get(model)!;\n        }\n\n        // Find matching config (first match wins)\n        for (const config of this.configs) {\n            if (config.exactMatch && config.exactMatch === model) {\n                this.cache.set(model, config);\n                return config;\n            }\n\n            if (config.pattern && config.pattern.test(model)) {\n                this.cache.set(model, config);\n                return config;\n            }\n        }\n\n        // Should never happen due to default fallback, but just in case\n        throw new Error(`No configuration found for model: ${model}`);\n    }\n\n    /**\n     * Get persona role for a model\n     */\n    getPersonaRole(model: string): PersonaRole {\n        return this.getConfig(model).personaRole;\n    }\n\n    /**\n     * Get tokenizer encoding for a model\n     */\n    getEncoding(model: string): TokenizerEncoding {\n        return this.getConfig(model).encoding;\n    }\n\n    /**\n     * Check if model supports tool calls\n     */\n    supportsToolCalls(model: string): boolean {\n        return this.getConfig(model).supportsToolCalls ?? true;\n    }\n\n    /**\n     * Get model family\n     */\n    getFamily(model: string): string | undefined {\n        return this.getConfig(model).family;\n    }\n\n    /**\n     * Clear all registered configs and reset to defaults\n     */\n    reset(): void {\n        this.configs = [];\n        this.cache.clear();\n        this.registerDefaults();\n        this.logger.debug('Reset model configurations to defaults');\n    }\n\n    /**\n     * Clear cache (useful if configs are modified)\n     */\n    clearCache(): void {\n        this.cache.clear();\n        this.logger.debug('Cleared model configuration cache');\n    }\n\n    /**\n     * Get all registered configurations\n     */\n    getAllConfigs(): ModelConfig[] {\n        return [...this.configs];\n    }\n}\n\n// Global registry instance\nlet globalRegistry: ModelRegistry | null = null;\n\n/**\n * Get the global model registry\n */\nexport function getModelRegistry(logger?: any): ModelRegistry {\n    if (!globalRegistry) {\n        globalRegistry = new ModelRegistry(logger);\n    }\n    return globalRegistry;\n}\n\n/**\n * Reset the global registry (useful for testing)\n */\nexport function resetModelRegistry(): void {\n    globalRegistry = null;\n}\n\n/**\n * Helper functions using global registry\n */\nexport function getPersonaRole(model: string): PersonaRole {\n    return getModelRegistry().getPersonaRole(model);\n}\n\nexport function getEncoding(model: string): TokenizerEncoding {\n    return getModelRegistry().getEncoding(model);\n}\n\nexport function supportsToolCalls(model: string): boolean {\n    return getModelRegistry().supportsToolCalls(model);\n}\n\nexport function getModelFamily(model: string): string | undefined {\n    return getModelRegistry().getFamily(model);\n}\n\n/**\n * Configure a custom model\n *\n * @example\n * ```typescript\n * // Add support for a new model family\n * configureModel({\n *   pattern: /^gemini/i,\n *   personaRole: 'system',\n *   encoding: 'cl100k_base',\n *   family: 'gemini'\n * });\n *\n * // Add specific model override\n * configureModel({\n *   exactMatch: 'custom-model-v1',\n *   personaRole: 'developer',\n *   encoding: 'gpt-4o'\n * });\n * ```\n */\nexport function configureModel(config: ModelConfig): void {\n    getModelRegistry().register(config);\n}\n\nexport default ModelRegistry;\n\n"],"names":["ModelRegistry","registerDefaults","register","pattern","personaRole","encoding","supportsToolCalls","family","description","logger","debug","config","exactMatch","Error","configs","push","cache","clear","source","getConfig","model","has","get","set","test","getPersonaRole","getEncoding","getFamily","reset","clearCache","getAllConfigs","Map","wrapLogger","DEFAULT_LOGGER","globalRegistry","getModelRegistry","resetModelRegistry","getModelFamily","configureModel"],"mappings":"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"}

package/dist/override.js

@@ -9,6 +9,9 @@ import { create as create$3 } from './parser.js';
 import './loader.js';
 import './builder.js';
 import './recipes.js';
+import './conversation.js';
+import 'tiktoken';
+import './tools.js';
 import { create as create$2 } from './util/storage.js';
 
 const OptionsSchema = z.object({
@@ -102,7 +105,11 @@ const create = (overrideOptions = {})=>{
             finalSection = finalSection.prepend(prepend);
         }
         // Apply appends in reverse order (furthest layers first, then closest)
-        for (const append of appends.reverse()){
+        // Create a copy to avoid mutating the original array
+        const reversedAppends = [
+            ...appends
+        ].reverse();
+        for (const append of reversedAppends){
             logger.silly('Append found, adding to content from file %s', append);
             finalSection = finalSection.append(append);
         }

package/dist/override.js.map

@@ -1 +1 @@
-{"version":3,"file":"override.js","sources":["../src/override.ts"],"sourcesContent":["import path from 'path';\nimport { z } from 'zod';\nimport { ParametersSchema } from './items/parameters';\nimport { SectionOptions, SectionOptionsSchema } from './items/section';\nimport { DEFAULT_LOGGER, wrapLogger } from './logger';\nimport { Formatter, Parser, Section, Weighted } from './riotprompt';\nimport * as Storage from './util/storage';\n\nconst OptionsSchema = z.object({\n    logger: z.any().optional().default(DEFAULT_LOGGER),\n    configDirs: z.array(z.string()).default(['./overrides']),\n    overrides: z.boolean().default(false),\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    customize: <T extends Weighted>(overrideFile: string, section: Section<T>, sectionOptions?: SectionOptions) => Promise<Section<T>>;\n    override: <T extends Weighted>(overrideFile: string, section: Section<T>, sectionOptions?: SectionOptions) =>\n        Promise<{ override?: Section<T>, prepends: Section<T>[], appends: Section<T>[] }>;\n}\n\nexport const create = (overrideOptions: OptionsParam = {}): Instance => {\n    const options: Required<Options> = OptionsSchema.parse(overrideOptions) as Required<Options>;\n\n    const parameters = options.parameters;\n\n    const logger = wrapLogger(options?.logger, 'Override');\n    const storage = Storage.create({ log: logger.debug });\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    const override = async <T extends Weighted>(\n        overrideFile: string,\n        section: Section<T>,\n        sectionOptions: Partial<SectionOptions> = {}\n    ): Promise<{ override?: Section<T>, prepends: Section<T>[], appends: Section<T>[] }> => {\n        const currentSectionOptions = loadOptions(sectionOptions);\n\n        const response: { override?: Section<T>, prepends: Section<T>[], appends: Section<T>[] } = {\n            prepends: [],\n            appends: []\n        };\n\n        // Process directories in order (closest to furthest)\n        for (let i = 0; i < options.configDirs.length; i++) {\n            const configDir = options.configDirs[i];\n            const baseFile = path.join(configDir, overrideFile);\n            const preFile = baseFile.replace('.md', '-pre.md');\n            const postFile = baseFile.replace('.md', '-post.md');\n\n            // Check for prepend files (-pre.md)\n            if (await storage.exists(preFile)) {\n                logger.silly('Found pre file %s (layer %d)', preFile, i + 1);\n                const parser = Parser.create({ logger });\n                const prependSection = await parser.parseFile<T>(preFile, currentSectionOptions);\n                response.prepends.push(prependSection);\n            }\n\n            // Check for append files (-post.md)\n            if (await storage.exists(postFile)) {\n                logger.silly('Found post file %s (layer %d)', postFile, i + 1);\n                const parser = Parser.create({ logger });\n                const appendSection = await parser.parseFile<T>(postFile, currentSectionOptions);\n                response.appends.push(appendSection);\n            }\n\n            // Check for complete override files - use the first (closest) one found\n            if (!response.override && await storage.exists(baseFile)) {\n                logger.silly('Found base file %s (layer %d)', baseFile, i + 1);\n                if (options.overrides) {\n                    logger.warn('WARNING: Core directives are being overwritten by custom configuration at layer %d', i + 1);\n                    const parser = Parser.create({ logger });\n                    response.override = await parser.parseFile<T>(baseFile, currentSectionOptions);\n                } else {\n                    logger.error('ERROR: Core directives are being overwritten by custom configuration');\n                    throw new Error('Core directives are being overwritten by custom configuration, but overrides are not enabled.  Please enable --overrides to use this feature.');\n                }\n            }\n        }\n\n        return response;\n    }\n\n    const customize = async <T extends Weighted>(\n        overrideFile: string,\n        section: Section<T>,\n        sectionOptions: Partial<SectionOptions> = {}\n    ): Promise<Section<T>> => {\n        const currentSectionOptions = loadOptions(sectionOptions);\n\n        const { override: overrideContent, prepends, appends }: { override?: Section<T>, prepends: Section<T>[], appends: Section<T>[] } = await override(overrideFile, section, currentSectionOptions);\n        let finalSection: Section<T> = section;\n\n        if (overrideContent) {\n            if (options.overrides) {\n                logger.warn('Override found, replacing content from file %s', overrideContent);\n                finalSection = overrideContent;\n            } else {\n                logger.error('ERROR: Core directives are being overwritten by custom configuration');\n                throw new Error('Core directives are being overwritten by custom configuration, but overrides are not enabled.  Please enable --overrides to use this feature.');\n            }\n        }\n\n        // Apply prepends in order (closest layer first)\n        for (const prepend of prepends) {\n            logger.silly('Prepend found, adding to content from file %s', prepend);\n            finalSection = finalSection.prepend(prepend);\n        }\n\n        // Apply appends in reverse order (furthest layers first, then closest)\n        for (const append of appends.reverse()) {\n            logger.silly('Append found, adding to content from file %s', append);\n            finalSection = finalSection.append(append);\n        }\n\n        const formatter = Formatter.create({ logger });\n        logger.silly('Final section %s:\\n\\n%s\\n\\n', logger.name, formatter.format(finalSection));\n\n        return finalSection;\n    }\n\n    return {\n        override,\n        customize,\n    }\n}"],"names":["OptionsSchema","z","object","logger","any","optional","default","DEFAULT_LOGGER","configDirs","array","string","overrides","boolean","parameters","ParametersSchema","create","overrideOptions","options","parse","wrapLogger","storage","Storage","log","debug","loadOptions","sectionOptions","currentOptions","SectionOptionsSchema","override","overrideFile","section","currentSectionOptions","response","prepends","appends","i","length","configDir","baseFile","path","join","preFile","replace","postFile","exists","silly","parser","Parser","prependSection","parseFile","push","appendSection","warn","error","Error","customize","overrideContent","finalSection","prepend","append","reverse","formatter","Formatter","name","format"],"mappings":"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"}
+{"version":3,"file":"override.js","sources":["../src/override.ts"],"sourcesContent":["import path from 'path';\nimport { z } from 'zod';\nimport { ParametersSchema } from './items/parameters';\nimport { SectionOptions, SectionOptionsSchema } from './items/section';\nimport { DEFAULT_LOGGER, wrapLogger } from './logger';\nimport { Formatter, Parser, Section, Weighted } from './riotprompt';\nimport * as Storage from './util/storage';\n\nconst OptionsSchema = z.object({\n    logger: z.any().optional().default(DEFAULT_LOGGER),\n    configDirs: z.array(z.string()).default(['./overrides']),\n    overrides: z.boolean().default(false),\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    customize: <T extends Weighted>(overrideFile: string, section: Section<T>, sectionOptions?: SectionOptions) => Promise<Section<T>>;\n    override: <T extends Weighted>(overrideFile: string, section: Section<T>, sectionOptions?: SectionOptions) =>\n        Promise<{ override?: Section<T>, prepends: Section<T>[], appends: Section<T>[] }>;\n}\n\nexport const create = (overrideOptions: OptionsParam = {}): Instance => {\n    const options: Required<Options> = OptionsSchema.parse(overrideOptions) as Required<Options>;\n\n    const parameters = options.parameters;\n\n    const logger = wrapLogger(options?.logger, 'Override');\n    const storage = Storage.create({ log: logger.debug });\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    const override = async <T extends Weighted>(\n        overrideFile: string,\n        section: Section<T>,\n        sectionOptions: Partial<SectionOptions> = {}\n    ): Promise<{ override?: Section<T>, prepends: Section<T>[], appends: Section<T>[] }> => {\n        const currentSectionOptions = loadOptions(sectionOptions);\n\n        const response: { override?: Section<T>, prepends: Section<T>[], appends: Section<T>[] } = {\n            prepends: [],\n            appends: []\n        };\n\n        // Process directories in order (closest to furthest)\n        for (let i = 0; i < options.configDirs.length; i++) {\n            const configDir = options.configDirs[i];\n            const baseFile = path.join(configDir, overrideFile);\n            const preFile = baseFile.replace('.md', '-pre.md');\n            const postFile = baseFile.replace('.md', '-post.md');\n\n            // Check for prepend files (-pre.md)\n            if (await storage.exists(preFile)) {\n                logger.silly('Found pre file %s (layer %d)', preFile, i + 1);\n                const parser = Parser.create({ logger });\n                const prependSection = await parser.parseFile<T>(preFile, currentSectionOptions);\n                response.prepends.push(prependSection);\n            }\n\n            // Check for append files (-post.md)\n            if (await storage.exists(postFile)) {\n                logger.silly('Found post file %s (layer %d)', postFile, i + 1);\n                const parser = Parser.create({ logger });\n                const appendSection = await parser.parseFile<T>(postFile, currentSectionOptions);\n                response.appends.push(appendSection);\n            }\n\n            // Check for complete override files - use the first (closest) one found\n            if (!response.override && await storage.exists(baseFile)) {\n                logger.silly('Found base file %s (layer %d)', baseFile, i + 1);\n                if (options.overrides) {\n                    logger.warn('WARNING: Core directives are being overwritten by custom configuration at layer %d', i + 1);\n                    const parser = Parser.create({ logger });\n                    response.override = await parser.parseFile<T>(baseFile, currentSectionOptions);\n                } else {\n                    logger.error('ERROR: Core directives are being overwritten by custom configuration');\n                    throw new Error('Core directives are being overwritten by custom configuration, but overrides are not enabled.  Please enable --overrides to use this feature.');\n                }\n            }\n        }\n\n        return response;\n    }\n\n    const customize = async <T extends Weighted>(\n        overrideFile: string,\n        section: Section<T>,\n        sectionOptions: Partial<SectionOptions> = {}\n    ): Promise<Section<T>> => {\n        const currentSectionOptions = loadOptions(sectionOptions);\n\n        const { override: overrideContent, prepends, appends }: { override?: Section<T>, prepends: Section<T>[], appends: Section<T>[] } = await override(overrideFile, section, currentSectionOptions);\n        let finalSection: Section<T> = section;\n\n        if (overrideContent) {\n            if (options.overrides) {\n                logger.warn('Override found, replacing content from file %s', overrideContent);\n                finalSection = overrideContent;\n            } else {\n                logger.error('ERROR: Core directives are being overwritten by custom configuration');\n                throw new Error('Core directives are being overwritten by custom configuration, but overrides are not enabled.  Please enable --overrides to use this feature.');\n            }\n        }\n\n        // Apply prepends in order (closest layer first)\n        for (const prepend of prepends) {\n            logger.silly('Prepend found, adding to content from file %s', prepend);\n            finalSection = finalSection.prepend(prepend);\n        }\n\n        // Apply appends in reverse order (furthest layers first, then closest)\n        // Create a copy to avoid mutating the original array\n        const reversedAppends = [...appends].reverse();\n        for (const append of reversedAppends) {\n            logger.silly('Append found, adding to content from file %s', append);\n            finalSection = finalSection.append(append);\n        }\n\n        const formatter = Formatter.create({ logger });\n        logger.silly('Final section %s:\\n\\n%s\\n\\n', logger.name, formatter.format(finalSection));\n\n        return finalSection;\n    }\n\n    return {\n        override,\n        customize,\n    }\n}\n"],"names":["OptionsSchema","z","object","logger","any","optional","default","DEFAULT_LOGGER","configDirs","array","string","overrides","boolean","parameters","ParametersSchema","create","overrideOptions","options","parse","wrapLogger","storage","Storage","log","debug","loadOptions","sectionOptions","currentOptions","SectionOptionsSchema","override","overrideFile","section","currentSectionOptions","response","prepends","appends","i","length","configDir","baseFile","path","join","preFile","replace","postFile","exists","silly","parser","Parser","prependSection","parseFile","push","appendSection","warn","error","Error","customize","overrideContent","finalSection","prepend","reversedAppends","reverse","append","formatter","Formatter","name","format"],"mappings":"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"}

package/dist/parser.js

@@ -39,13 +39,13 @@ const create = (parserOptions)=>{
             });
         } catch (error) {
             // Log the error or handle it appropriately
-            logger.error(`Error reading or parsing file with marked at ${filePath}:`, error);
-            throw new Error(`Failed to parse instructions from ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+            logger.error(`Error reading or parsing file at ${filePath}:`, error);
+            throw new Error(`Failed to parse content from ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
         }
     };
     /**
      * Reads Markdown content and parses it into a single Section.
-     * 
+     *
      * - If the content starts with a heading, that becomes the title of the returned Section
      * - If no heading at the start, creates a Section with no title
      * - Headers within the content create nested sections based on their depth

package/dist/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","sources":["../src/parser.ts"],"sourcesContent":["import * as fs from 'fs/promises';\nimport * as path from 'path';\nimport { z } from 'zod';\nimport { ParametersSchema } from './items/parameters';\nimport { Section, SectionOptions, SectionOptionsSchema } from './items/section';\nimport { Weighted } from './items/weighted';\nimport { DEFAULT_LOGGER, wrapLogger } from './logger';\nimport { parseMarkdown } from './parse/markdown';\nimport { parseText } from './parse/text';\nimport { isMarkdown } from './util/markdown';\nimport { isText } from './util/text';\n\nconst OptionsSchema = z.object({\n    logger: z.any().optional().default(DEFAULT_LOGGER),\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    parse: <T extends Weighted>(input: string | Buffer, options?: SectionOptions) => Promise<Section<T>>;\n    parseFile: <T extends Weighted>(filePath: string, options?: SectionOptions) => Promise<Section<T>>;\n}\n\nexport const create = (parserOptions?: OptionsParam): Instance => {\n    const options: Required<Options> = OptionsSchema.parse(parserOptions || {}) as Required<Options>;\n    const parameters = options.parameters;\n\n    const logger = wrapLogger(options.logger, 'Parser');\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    const parseFile = async <T extends Weighted>(\n        filePath: string,\n        options: Partial<SectionOptions> = {}\n    ): Promise<Section<T>> => {\n        const currentOptions = loadOptions(options);\n        try {\n            const content = await fs.readFile(filePath, 'utf-8');\n            // Only use the filename as title if no title was explicitly provided\n            const fileName = path.basename(filePath, path.extname(filePath));\n            return await parse(content, {\n                ...currentOptions,\n                title: currentOptions?.title || fileName\n            });\n        } catch (error) {\n            // Log the error or handle it appropriately\n            logger.error(`Error reading or parsing file with marked at ${filePath}:`, error);\n            throw new Error(`Failed to parse instructions from ${filePath}: ${error instanceof Error ? error.message : String(error)}`);\n        }\n    }\n\n    /**\n     * Reads Markdown content and parses it into a single Section.\n     * \n     * - If the content starts with a heading, that becomes the title of the returned Section\n     * - If no heading at the start, creates a Section with no title\n     * - Headers within the content create nested sections based on their depth\n     * - All content is organized in a hierarchical structure based on heading levels\n     *\n     * @param content The content to parse\n     * @returns A Section containing all content in a hierarchical structure\n     */\n    const parse = async <T extends Weighted>(\n        content: string | Buffer,\n        options: Partial<SectionOptions> = {}\n    ): Promise<Section<T>> => {\n        const currentOptions = loadOptions(options);\n\n        let mainSection: Section<T>;\n        if (isMarkdown(content)) {\n            mainSection = await parseMarkdown<T>(content, currentOptions);\n        } else if (isText(content)) {\n            mainSection = parseText<T>(content, currentOptions);\n        } else {\n            throw new Error(`Unsupported content supplied to parse, riotprompt currently only supports markdown and text`);\n        }\n        return mainSection;\n    }\n\n    return {\n        parse,\n        parseFile\n    }\n}"],"names":["OptionsSchema","z","object","logger","any","optional","default","DEFAULT_LOGGER","parameters","ParametersSchema","create","parserOptions","options","parse","wrapLogger","loadOptions","sectionOptions","currentOptions","SectionOptionsSchema","parseFile","filePath","content","fs","readFile","fileName","path","basename","extname","title","error","Error","message","String","mainSection","isMarkdown","parseMarkdown","isText","parseText"],"mappings":";;;;;;;;;;;AAYA,MAAMA,aAAAA,GAAgBC,CAAAA,CAAEC,MAAM,CAAC;AAC3BC,IAAAA,MAAAA,EAAQF,EAAEG,GAAG,EAAA,CAAGC,QAAQ,EAAA,CAAGC,OAAO,CAACC,cAAAA,CAAAA;AACnCC,IAAAA,UAAAA,EAAYC,gBAAAA,CAAiBJ,QAAQ,EAAA,CAAGC,OAAO,CAAC,EAAC;AACrD,CAAA,CAAA;AAWO,MAAMI,SAAS,CAACC,aAAAA,GAAAA;AACnB,IAAA,MAAMC,OAAAA,GAA6BZ,aAAAA,CAAca,KAAK,CAACF,iBAAiB,EAAC,CAAA;IACzE,MAAMH,UAAAA,GAAaI,QAAQJ,UAAU;AAErC,IAAA,MAAML,MAAAA,GAASW,UAAAA,CAAWF,OAAAA,CAAQT,MAAM,EAAE,QAAA,CAAA;AAE1C,IAAA,MAAMY,WAAAA,GAAc,CAACC,cAAAA,GAA0C,EAAE,GAAA;QAC7D,MAAMC,cAAAA,GAAiBC,oBAAAA,CAAqBL,KAAK,CAACG,cAAAA,CAAAA;QAClD,OAAO;AACH,YAAA,GAAGC,cAAc;YACjBT,UAAAA,EAAY;AACR,gBAAA,GAAGA,UAAU;AACb,gBAAA,GAAGS,eAAeT;AACtB;AACJ,SAAA;AACJ,IAAA,CAAA;AAEA,IAAA,MAAMW,SAAAA,GAAY,OACdC,QAAAA,EACAR,OAAAA,GAAmC,EAAE,GAAA;AAErC,QAAA,MAAMK,iBAAiBF,WAAAA,CAAYH,OAAAA,CAAAA;QACnC,IAAI;AACA,YAAA,MAAMS,OAAAA,GAAU,MAAMC,EAAAA,CAAGC,QAAQ,CAACH,QAAAA,EAAU,OAAA,CAAA;;AAE5C,YAAA,MAAMI,WAAWC,IAAAA,CAAKC,QAAQ,CAACN,QAAAA,EAAUK,IAAAA,CAAKE,OAAO,CAACP,QAAAA,CAAAA,CAAAA;YACtD,OAAO,MAAMP,MAAMQ,OAAAA,EAAS;AACxB,gBAAA,GAAGJ,cAAc;AACjBW,gBAAAA,KAAAA,EAAOX,CAAAA,cAAAA,KAAAA,IAAAA,IAAAA,cAAAA,KAAAA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA,GAAAA,cAAAA,CAAgBW,KAAK,KAAIJ;AACpC,aAAA,CAAA;AACJ,QAAA,CAAA,CAAE,OAAOK,KAAAA,EAAO;;YAEZ1B,MAAAA,CAAO0B,KAAK,CAAC,CAAC,6CAA6C,EAAET,QAAAA,CAAS,CAAC,CAAC,EAAES,KAAAA,CAAAA;AAC1E,YAAA,MAAM,IAAIC,KAAAA,CAAM,CAAC,kCAAkC,EAAEV,QAAAA,CAAS,EAAE,EAAES,KAAAA,YAAiBC,KAAAA,GAAQD,KAAAA,CAAME,OAAO,GAAGC,OAAOH,KAAAA,CAAAA,CAAAA,CAAQ,CAAA;AAC9H,QAAA;AACJ,IAAA,CAAA;AAEA;;;;;;;;;;AAUC,QACD,MAAMhB,KAAAA,GAAQ,OACVQ,OAAAA,EACAT,OAAAA,GAAmC,EAAE,GAAA;AAErC,QAAA,MAAMK,iBAAiBF,WAAAA,CAAYH,OAAAA,CAAAA;QAEnC,IAAIqB,WAAAA;AACJ,QAAA,IAAIC,WAAWb,OAAAA,CAAAA,EAAU;YACrBY,WAAAA,GAAc,MAAME,cAAiBd,OAAAA,EAASJ,cAAAA,CAAAA;QAClD,CAAA,MAAO,IAAImB,OAAOf,OAAAA,CAAAA,EAAU;AACxBY,YAAAA,WAAAA,GAAcI,UAAahB,OAAAA,EAASJ,cAAAA,CAAAA;QACxC,CAAA,MAAO;AACH,YAAA,MAAM,IAAIa,KAAAA,CAAM,CAAC,2FAA2F,CAAC,CAAA;AACjH,QAAA;QACA,OAAOG,WAAAA;AACX,IAAA,CAAA;IAEA,OAAO;AACHpB,QAAAA,KAAAA;AACAM,QAAAA;AACJ,KAAA;AACJ;;;;"}
+{"version":3,"file":"parser.js","sources":["../src/parser.ts"],"sourcesContent":["import * as fs from 'fs/promises';\nimport * as path from 'path';\nimport { z } from 'zod';\nimport { ParametersSchema } from './items/parameters';\nimport { Section, SectionOptions, SectionOptionsSchema } from './items/section';\nimport { Weighted } from './items/weighted';\nimport { DEFAULT_LOGGER, wrapLogger } from './logger';\nimport { parseMarkdown } from './parse/markdown';\nimport { parseText } from './parse/text';\nimport { isMarkdown } from './util/markdown';\nimport { isText } from './util/text';\n\nconst OptionsSchema = z.object({\n    logger: z.any().optional().default(DEFAULT_LOGGER),\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    parse: <T extends Weighted>(input: string | Buffer, options?: SectionOptions) => Promise<Section<T>>;\n    parseFile: <T extends Weighted>(filePath: string, options?: SectionOptions) => Promise<Section<T>>;\n}\n\nexport const create = (parserOptions?: OptionsParam): Instance => {\n    const options: Required<Options> = OptionsSchema.parse(parserOptions || {}) as Required<Options>;\n    const parameters = options.parameters;\n\n    const logger = wrapLogger(options.logger, 'Parser');\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    const parseFile = async <T extends Weighted>(\n        filePath: string,\n        options: Partial<SectionOptions> = {}\n    ): Promise<Section<T>> => {\n        const currentOptions = loadOptions(options);\n        try {\n            const content = await fs.readFile(filePath, 'utf-8');\n            // Only use the filename as title if no title was explicitly provided\n            const fileName = path.basename(filePath, path.extname(filePath));\n            return await parse(content, {\n                ...currentOptions,\n                title: currentOptions?.title || fileName\n            });\n        } catch (error) {\n            // Log the error or handle it appropriately\n            logger.error(`Error reading or parsing file at ${filePath}:`, error);\n            throw new Error(`Failed to parse content from ${filePath}: ${error instanceof Error ? error.message : String(error)}`);\n        }\n    }\n\n    /**\n     * Reads Markdown content and parses it into a single Section.\n     *\n     * - If the content starts with a heading, that becomes the title of the returned Section\n     * - If no heading at the start, creates a Section with no title\n     * - Headers within the content create nested sections based on their depth\n     * - All content is organized in a hierarchical structure based on heading levels\n     *\n     * @param content The content to parse\n     * @returns A Section containing all content in a hierarchical structure\n     */\n    const parse = async <T extends Weighted>(\n        content: string | Buffer,\n        options: Partial<SectionOptions> = {}\n    ): Promise<Section<T>> => {\n        const currentOptions = loadOptions(options);\n\n        let mainSection: Section<T>;\n        if (isMarkdown(content)) {\n            mainSection = await parseMarkdown<T>(content, currentOptions);\n        } else if (isText(content)) {\n            mainSection = parseText<T>(content, currentOptions);\n        } else {\n            throw new Error(`Unsupported content supplied to parse, riotprompt currently only supports markdown and text`);\n        }\n        return mainSection;\n    }\n\n    return {\n        parse,\n        parseFile\n    }\n}\n"],"names":["OptionsSchema","z","object","logger","any","optional","default","DEFAULT_LOGGER","parameters","ParametersSchema","create","parserOptions","options","parse","wrapLogger","loadOptions","sectionOptions","currentOptions","SectionOptionsSchema","parseFile","filePath","content","fs","readFile","fileName","path","basename","extname","title","error","Error","message","String","mainSection","isMarkdown","parseMarkdown","isText","parseText"],"mappings":";;;;;;;;;;;AAYA,MAAMA,aAAAA,GAAgBC,CAAAA,CAAEC,MAAM,CAAC;AAC3BC,IAAAA,MAAAA,EAAQF,EAAEG,GAAG,EAAA,CAAGC,QAAQ,EAAA,CAAGC,OAAO,CAACC,cAAAA,CAAAA;AACnCC,IAAAA,UAAAA,EAAYC,gBAAAA,CAAiBJ,QAAQ,EAAA,CAAGC,OAAO,CAAC,EAAC;AACrD,CAAA,CAAA;AAWO,MAAMI,SAAS,CAACC,aAAAA,GAAAA;AACnB,IAAA,MAAMC,OAAAA,GAA6BZ,aAAAA,CAAca,KAAK,CAACF,iBAAiB,EAAC,CAAA;IACzE,MAAMH,UAAAA,GAAaI,QAAQJ,UAAU;AAErC,IAAA,MAAML,MAAAA,GAASW,UAAAA,CAAWF,OAAAA,CAAQT,MAAM,EAAE,QAAA,CAAA;AAE1C,IAAA,MAAMY,WAAAA,GAAc,CAACC,cAAAA,GAA0C,EAAE,GAAA;QAC7D,MAAMC,cAAAA,GAAiBC,oBAAAA,CAAqBL,KAAK,CAACG,cAAAA,CAAAA;QAClD,OAAO;AACH,YAAA,GAAGC,cAAc;YACjBT,UAAAA,EAAY;AACR,gBAAA,GAAGA,UAAU;AACb,gBAAA,GAAGS,eAAeT;AACtB;AACJ,SAAA;AACJ,IAAA,CAAA;AAEA,IAAA,MAAMW,SAAAA,GAAY,OACdC,QAAAA,EACAR,OAAAA,GAAmC,EAAE,GAAA;AAErC,QAAA,MAAMK,iBAAiBF,WAAAA,CAAYH,OAAAA,CAAAA;QACnC,IAAI;AACA,YAAA,MAAMS,OAAAA,GAAU,MAAMC,EAAAA,CAAGC,QAAQ,CAACH,QAAAA,EAAU,OAAA,CAAA;;AAE5C,YAAA,MAAMI,WAAWC,IAAAA,CAAKC,QAAQ,CAACN,QAAAA,EAAUK,IAAAA,CAAKE,OAAO,CAACP,QAAAA,CAAAA,CAAAA;YACtD,OAAO,MAAMP,MAAMQ,OAAAA,EAAS;AACxB,gBAAA,GAAGJ,cAAc;AACjBW,gBAAAA,KAAAA,EAAOX,CAAAA,cAAAA,KAAAA,IAAAA,IAAAA,cAAAA,KAAAA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA,GAAAA,cAAAA,CAAgBW,KAAK,KAAIJ;AACpC,aAAA,CAAA;AACJ,QAAA,CAAA,CAAE,OAAOK,KAAAA,EAAO;;YAEZ1B,MAAAA,CAAO0B,KAAK,CAAC,CAAC,iCAAiC,EAAET,QAAAA,CAAS,CAAC,CAAC,EAAES,KAAAA,CAAAA;AAC9D,YAAA,MAAM,IAAIC,KAAAA,CAAM,CAAC,6BAA6B,EAAEV,QAAAA,CAAS,EAAE,EAAES,KAAAA,YAAiBC,KAAAA,GAAQD,KAAAA,CAAME,OAAO,GAAGC,OAAOH,KAAAA,CAAAA,CAAAA,CAAQ,CAAA;AACzH,QAAA;AACJ,IAAA,CAAA;AAEA;;;;;;;;;;AAUC,QACD,MAAMhB,KAAAA,GAAQ,OACVQ,OAAAA,EACAT,OAAAA,GAAmC,EAAE,GAAA;AAErC,QAAA,MAAMK,iBAAiBF,WAAAA,CAAYH,OAAAA,CAAAA;QAEnC,IAAIqB,WAAAA;AACJ,QAAA,IAAIC,WAAWb,OAAAA,CAAAA,EAAU;YACrBY,WAAAA,GAAc,MAAME,cAAiBd,OAAAA,EAASJ,cAAAA,CAAAA;QAClD,CAAA,MAAO,IAAImB,OAAOf,OAAAA,CAAAA,EAAU;AACxBY,YAAAA,WAAAA,GAAcI,UAAahB,OAAAA,EAASJ,cAAAA,CAAAA;QACxC,CAAA,MAAO;AACH,YAAA,MAAM,IAAIa,KAAAA,CAAM,CAAC,2FAA2F,CAAC,CAAA;AACjH,QAAA;QACA,OAAOG,WAAAA;AACX,IAAA,CAAA;IAEA,OAAO;AACHpB,QAAAA,KAAAA;AACAM,QAAAA;AACJ,KAAA;AACJ;;;;"}

package/dist/recipes.d.ts

@@ -1,5 +1,10 @@
 import { z } from 'zod';
+import { Model } from './chat';
+import { ConversationBuilder } from './conversation';
 import { Prompt } from './riotprompt';
+import { TokenBudgetConfig } from './token-budget';
+import { Tool, ToolRegistry } from './tools';
+import { IterationStrategy, LLMClient, StrategyResult } from './iteration-strategy';
 declare const ContentItemSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
     content: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
@@ -73,14 +78,40 @@ declare const RecipeConfigSchema: z.ZodObject<{
     }, z.core.$strip>]>>>>;
     extends: z.ZodOptional<z.ZodString>;
     template: z.ZodOptional<z.ZodString>;
+    tools: z.ZodOptional<z.ZodAny>;
+    toolGuidance: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        auto: "auto";
+        minimal: "minimal";
+        detailed: "detailed";
+    }>, z.ZodObject<{
+        strategy: z.ZodEnum<{
+            adaptive: "adaptive";
+            minimal: "minimal";
+            prescriptive: "prescriptive";
+        }>;
+        includeExamples: z.ZodOptional<z.ZodBoolean>;
+        explainWhenToUse: z.ZodOptional<z.ZodBoolean>;
+        includeCategories: z.ZodOptional<z.ZodBoolean>;
+        customInstructions: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    toolCategories: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 type RecipeConfig = z.infer<typeof RecipeConfigSchema>;
 type ContentItem = z.infer<typeof ContentItemSchema>;
+export interface ToolGuidanceConfig {
+    strategy: 'adaptive' | 'prescriptive' | 'minimal';
+    includeExamples?: boolean;
+    explainWhenToUse?: boolean;
+    includeCategories?: boolean;
+    customInstructions?: string;
+}
 export interface TemplateConfig {
     persona?: ContentItem;
     instructions?: ContentItem[];
     content?: ContentItem[];
     context?: ContentItem[];
+    tools?: Tool[] | ToolRegistry;
+    toolGuidance?: Partial<ToolGuidanceConfig> | 'auto' | 'minimal' | 'detailed';
 }
 /**
  * Register custom templates with the recipes system
@@ -109,6 +140,10 @@ export declare const getTemplates: () => Record<string, TemplateConfig>;
  * Clear all registered templates
  */
 export declare const clearTemplates: () => void;
+/**
+ * Generate tool guidance instructions based on strategy
+ */
+export declare const generateToolGuidance: (tools: Tool[], guidance: ToolGuidanceConfig | "auto" | "minimal" | "detailed") => string;
 export declare const cook: (config: Partial<RecipeConfig> & {
     basePath: string;
 }) => Promise<Prompt>;
@@ -122,6 +157,13 @@ export declare const recipe: (basePath: string) => {
     parameters: (parameters: any) => /*elided*/ any;
     overrides: (enabled: boolean) => /*elided*/ any;
     overridePaths: (paths: string[]) => /*elided*/ any;
+    tools: (tools: Tool[] | ToolRegistry) => /*elided*/ any;
+    toolRegistry: (registry: ToolRegistry) => /*elided*/ any;
+    toolGuidance: (guidance: ToolGuidanceConfig | "auto" | "minimal" | "detailed") => /*elided*/ any;
+    toolCategories: (categories: string[]) => /*elided*/ any;
     cook: () => Promise<Prompt>;
+    buildConversation: (model: Model, tokenBudget?: TokenBudgetConfig) => Promise<ConversationBuilder>;
+    getToolRegistry: () => ToolRegistry | undefined;
+    executeWith: (llm: LLMClient, strategy: IterationStrategy, model?: Model, tokenBudget?: TokenBudgetConfig) => Promise<StrategyResult>;
 };
 export type { RecipeConfig, ContentItem };