@riotprompt/riotprompt 0.0.13 → 0.0.15

package/dist/formatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatter.js","sources":["../src/formatter.ts"],"sourcesContent":["import { Instruction } from \"riotprompt\";\nimport { z } from \"zod\";\nimport * as Chat from \"./chat\";\nimport { getPersonaRole, Message, Model } from \"./chat\";\nimport { DEFAULT_FORMAT_OPTIONS } from \"./constants\";\nimport { Section } from \"./items/section\";\nimport { Weighted } from \"./items/weighted\";\nimport { DEFAULT_LOGGER, wrapLogger } from \"./logger\";\nimport { Prompt } from \"./prompt\";\nimport { clean, stringifyJSON } from \"./util/general\";\n\nexport const SectionSeparatorSchema = z.enum([\"tag\", \"markdown\"]);\nexport const SectionTitlePropertySchema = z.enum([\"title\", \"name\"]);\n\nexport type SectionSeparator = z.infer<typeof SectionSeparatorSchema>;\nexport type SectionTitleProperty = z.infer<typeof SectionTitlePropertySchema>;\n\n\nexport const FormatOptionsSchema = z.object({\n    sectionSeparator: SectionSeparatorSchema,\n    sectionIndentation: z.boolean(),\n    sectionTitleProperty: SectionTitlePropertySchema,\n    sectionTitlePrefix: z.string().optional(),\n    sectionTitleSeparator: z.string().optional(),\n    sectionDepth: z.number().default(0),\n});\n\nexport type FormatOptions = z.infer<typeof FormatOptionsSchema>;\n\n\nexport const OptionSchema = z.object({\n    logger: z.any().optional().default(DEFAULT_LOGGER),\n    formatOptions: FormatOptionsSchema.partial().optional().default(DEFAULT_FORMAT_OPTIONS),\n});\n\nexport type Options = z.infer<typeof OptionSchema>;\n\nexport type OptionsParam = Partial<Options>;\n\nexport interface Instance {\n    formatPersona: (model: Model, persona: Section<Instruction>) => Message;\n    format: <T extends Weighted>(weightedText: T | Section<T>, sectionDepth?: number) => string;\n    formatArray: <T extends Weighted>(items: (T | Section<T>)[], sectionDepth?: number) => string;\n    formatPrompt: (model: Model, prompt: Prompt) => Chat.Request;\n}\n\n// Type guard to check if an object is a Section\nfunction isSection<T extends Weighted>(obj: T | Section<T>): obj is Section<T> {\n    return obj && typeof obj === 'object' && 'items' in obj && Array.isArray((obj as Section<T>).items);\n}\n\n// Type guard to check if an object is a Section\nfunction isWeighted<T extends Weighted>(obj: T | Section<T>): obj is T {\n    return obj && typeof obj === 'object' && 'text' in obj;\n}\n\n\nexport const create = (formatterOptions?: OptionsParam): Instance => {\n    const options: Required<Options> = OptionSchema.parse(formatterOptions || {}) as Required<Options>;\n\n    const logger = wrapLogger(options.logger, 'Formatter');\n\n    let formatOptions: FormatOptions = DEFAULT_FORMAT_OPTIONS;\n    if (options?.formatOptions) {\n        formatOptions = {\n            ...formatOptions,\n            ...clean(options.formatOptions),\n        };\n    }\n\n    const formatPersona = (model: Model, persona: Section<Instruction>): Message => {\n        logger.silly(`Formatting persona`);\n        if (persona) {\n            const formattedPersona = formatSection(persona);\n\n            return {\n                role: getPersonaRole(model),\n                content: `${formattedPersona}`,\n            }\n        } else {\n            throw new Error(\"Persona is required\");\n        }\n    }\n\n    const format = <T extends Weighted>(\n        item: T | Section<T>,\n        sectionDepth?: number,\n    ): string => {\n        logger.silly(`Formatting ${isSection(item) ? \"section\" : \"item\"} Item: %s`, stringifyJSON(item));\n        const currentSectionDepth = sectionDepth ?? formatOptions.sectionDepth;\n        logger.silly(`\\t\\tCurrent section depth: ${currentSectionDepth}`);\n\n        let result: string = \"\";\n        if (isSection(item)) {\n            result = formatSection(item, currentSectionDepth + 1);\n        } else if (isWeighted(item)) {\n            result = item.text;\n        } else {\n            //If the item is neither a section nor a weighted item, it is empty.\n            result = '';\n        }\n        return result;\n    }\n\n    const formatSection = <T extends Weighted>(section: Section<T>, sectionDepth?: number): string => {\n        logger.silly(`Formatting section`);\n        const currentSectionDepth = sectionDepth ?? formatOptions.sectionDepth;\n        logger.silly(`\\t\\tCurrent section depth: ${currentSectionDepth}`);\n\n        if (section) {\n            const formattedItems = section.items.map(item => format(item, currentSectionDepth)).join(\"\\n\\n\");\n\n            if (formatOptions.sectionSeparator === \"tag\") {\n                return `<${section.title ?? \"section\"}>\\n${formattedItems}\\n</${section.title ?? \"section\"}>`;\n            } else {\n                // Use the current section depth for heading level\n                const headingLevel = currentSectionDepth;\n                const hashes = '#'.repeat(headingLevel);\n                logger.silly(`\\t\\tHeading level: ${headingLevel}`);\n                logger.silly(`\\t\\tSection title: ${section.title}`);\n                return `${hashes} ${formatOptions.sectionTitlePrefix ? `${formatOptions.sectionTitlePrefix} ${formatOptions.sectionTitleSeparator} ` : \"\"}${section.title}\\n\\n${formattedItems}`;\n            }\n        } else {\n            return '';\n        }\n    }\n\n    // Helper function to format arrays of items or sections\n    const formatArray = <T extends Weighted>(\n        items: (T | Section<T>)[],\n        sectionDepth?: number\n    ): string => {\n        logger.silly(`Formatting array`);\n        const currentSectionDepth = sectionDepth ?? formatOptions.sectionDepth;\n        return items.map(item => format(item, currentSectionDepth)).join(\"\\n\\n\");\n    }\n\n    const formatPrompt = (model: Model, prompt: Prompt): Chat.Request => {\n        logger.silly('Formatting prompt');\n        const chatRequest: Chat.Request = Chat.createRequest(model);\n\n        if (prompt.persona) {\n            [prompt.persona].forEach((persona: Section<Instruction>) => {\n                chatRequest.addMessage(formatPersona(model, persona));\n            });\n        }\n\n        let formattedAreas: string = formatSection(prompt.instructions) + '\\n\\n';\n\n        if (prompt.contents) {\n            formattedAreas += formatSection(prompt.contents) + '\\n\\n';\n        }\n\n        if (prompt.contexts) {\n            formattedAreas += formatSection(prompt.contexts) + '\\n\\n';\n        }\n\n        chatRequest.addMessage({\n            role: \"user\",\n            content: formattedAreas,\n        });\n\n        return chatRequest;\n    }\n\n    return {\n        formatPersona,\n        format,\n        formatPrompt,\n        formatArray,\n    }\n}\n"],"names":["SectionSeparatorSchema","z","enum","SectionTitlePropertySchema","FormatOptionsSchema","object","sectionSeparator","sectionIndentation","boolean","sectionTitleProperty","sectionTitlePrefix","string","optional","sectionTitleSeparator","sectionDepth","number","default","OptionSchema","logger","any","DEFAULT_LOGGER","formatOptions","partial","DEFAULT_FORMAT_OPTIONS","isSection","obj","Array","isArray","items","isWeighted","create","formatterOptions","options","parse","wrapLogger","clean","formatPersona","model","persona","silly","formattedPersona","formatSection","role","getPersonaRole","content","Error","format","item","stringifyJSON","currentSectionDepth","result","text","section","formattedItems","map","join","title","headingLevel","hashes","repeat","formatArray","formatPrompt","prompt","chatRequest","Chat","forEach","addMessage","formattedAreas","instructions","contents","contexts"],"mappings":"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"}
+{"version":3,"file":"formatter.js","sources":["../src/formatter.ts"],"sourcesContent":["import { Instruction } from \"riotprompt\";\nimport { z } from \"zod\";\nimport * as Chat from \"./chat\";\nimport { getPersonaRole, Message, Model } from \"./chat\";\nimport { DEFAULT_FORMAT_OPTIONS } from \"./constants\";\nimport { Section } from \"./items/section\";\nimport { Weighted } from \"./items/weighted\";\nimport { DEFAULT_LOGGER, wrapLogger } from \"./logger\";\nimport { Prompt } from \"./prompt\";\nimport { clean, stringifyJSON } from \"./util/general\";\n\nexport const SectionSeparatorSchema = z.enum([\"tag\", \"markdown\"]);\nexport const SectionTitlePropertySchema = z.enum([\"title\", \"name\"]);\n\nexport type SectionSeparator = z.infer<typeof SectionSeparatorSchema>;\nexport type SectionTitleProperty = z.infer<typeof SectionTitlePropertySchema>;\n\n\nexport const FormatOptionsSchema = z.object({\n    sectionSeparator: SectionSeparatorSchema,\n    sectionIndentation: z.boolean(),\n    sectionTitleProperty: SectionTitlePropertySchema,\n    sectionTitlePrefix: z.string().optional(),\n    sectionTitleSeparator: z.string().optional(),\n    sectionDepth: z.number().default(0),\n});\n\nexport type FormatOptions = z.infer<typeof FormatOptionsSchema>;\n\n\nexport const OptionSchema = z.object({\n    logger: z.any().optional().default(DEFAULT_LOGGER),\n    formatOptions: FormatOptionsSchema.partial().optional().default(DEFAULT_FORMAT_OPTIONS),\n});\n\nexport type Options = z.infer<typeof OptionSchema>;\n\nexport type OptionsParam = Partial<Options>;\n\nexport interface Instance {\n    formatPersona: (model: Model, persona: Section<Instruction>) => Message;\n    format: <T extends Weighted>(weightedText: T | Section<T>, sectionDepth?: number) => string;\n    formatArray: <T extends Weighted>(items: (T | Section<T>)[], sectionDepth?: number) => string;\n    formatPrompt: (model: Model, prompt: Prompt) => Chat.Request;\n}\n\n// Type guard to check if an object is a Section\nfunction isSection<T extends Weighted>(obj: T | Section<T>): obj is Section<T> {\n    return obj && typeof obj === 'object' && 'items' in obj && Array.isArray((obj as Section<T>).items);\n}\n\n// Type guard to check if an object is a Section\nfunction isWeighted<T extends Weighted>(obj: T | Section<T>): obj is T {\n    return obj && typeof obj === 'object' && 'text' in obj;\n}\n\n\nexport const create = (formatterOptions?: OptionsParam): Instance => {\n    const options: Required<Options> = OptionSchema.parse(formatterOptions || {}) as Required<Options>;\n\n    const logger = wrapLogger(options.logger, 'Formatter');\n\n    let formatOptions: FormatOptions = DEFAULT_FORMAT_OPTIONS;\n    if (options?.formatOptions) {\n        formatOptions = {\n            ...formatOptions,\n            ...clean(options.formatOptions),\n        };\n    }\n\n    const formatPersona = (model: Model, persona: Section<Instruction>): Message => {\n        logger.silly(`Formatting persona`);\n        if (persona) {\n            const formattedPersona = formatSection(persona);\n\n            return {\n                role: getPersonaRole(model),\n                content: `${formattedPersona}`,\n            }\n        } else {\n            throw new Error(\"Persona is required\");\n        }\n    }\n\n    const format = <T extends Weighted>(\n        item: T | Section<T>,\n        sectionDepth?: number,\n    ): string => {\n        logger.silly(`Formatting ${isSection(item) ? \"section\" : \"item\"} Item: %s`, stringifyJSON(item));\n        const currentSectionDepth = sectionDepth ?? formatOptions.sectionDepth;\n        logger.silly(`\\t\\tCurrent section depth: ${currentSectionDepth}`);\n\n        let result: string = \"\";\n        if (isSection(item)) {\n            result = formatSection(item, currentSectionDepth + 1);\n        } else if (isWeighted(item)) {\n            result = item.text;\n        } else {\n            //If the item is neither a section nor a weighted item, it is empty.\n            result = '';\n        }\n        return result;\n    }\n\n    const formatSection = <T extends Weighted>(section: Section<T>, sectionDepth?: number): string => {\n        logger.silly(`Formatting section`);\n        const currentSectionDepth = sectionDepth ?? formatOptions.sectionDepth;\n        logger.silly(`\\t\\tCurrent section depth: ${currentSectionDepth}`);\n\n        if (section) {\n            const formattedItems = section.items.map(item => format(item, currentSectionDepth)).join(\"\\n\\n\");\n\n            if (formatOptions.sectionSeparator === \"tag\") {\n                return `<${section.title ?? \"section\"}>\\n${formattedItems}\\n</${section.title ?? \"section\"}>`;\n            } else {\n                // Use the current section depth for heading level\n                const headingLevel = currentSectionDepth;\n                const hashes = '#'.repeat(headingLevel);\n                logger.silly(`\\t\\tHeading level: ${headingLevel}`);\n                logger.silly(`\\t\\tSection title: ${section.title}`);\n                return `${hashes} ${formatOptions.sectionTitlePrefix ? `${formatOptions.sectionTitlePrefix} ${formatOptions.sectionTitleSeparator} ` : \"\"}${section.title}\\n\\n${formattedItems}`;\n            }\n        } else {\n            return '';\n        }\n    }\n\n    // Helper function to format arrays of items or sections\n    const formatArray = <T extends Weighted>(\n        items: (T | Section<T>)[],\n        sectionDepth?: number\n    ): string => {\n        logger.silly(`Formatting array`);\n        const currentSectionDepth = sectionDepth ?? formatOptions.sectionDepth;\n        return items.map(item => format(item, currentSectionDepth)).join(\"\\n\\n\");\n    }\n\n    const formatPrompt = (model: Model, prompt: Prompt): Chat.Request => {\n        logger.silly('Formatting prompt');\n        const chatRequest: Chat.Request = Chat.createRequest(model);\n\n        // --- System/Role Message Construction ---\n        // Collect sections that belong in the system/developer prompt (Persona, Tone, Constraints, etc.)\n        const systemSections: Section<Instruction>[] = [];\n        if (prompt.persona) systemSections.push(prompt.persona);\n        if (prompt.tone) systemSections.push(prompt.tone);\n        if (prompt.constraints) systemSections.push(prompt.constraints);\n        if (prompt.safeguards) systemSections.push(prompt.safeguards);\n        if (prompt.responseFormat) systemSections.push(prompt.responseFormat);\n\n        if (systemSections.length > 0) {\n            // Combine all system sections into one system message content\n            const systemContent = systemSections\n                .map(section => formatSection(section))\n                .join('\\n\\n');\n            \n            chatRequest.addMessage({\n                role: getPersonaRole(model),\n                content: systemContent\n            });\n        }\n\n        // --- User/Task Message Construction ---\n        // Logical flow: Context -> Examples -> Instructions -> Content -> Reasoning -> Recap\n        // This structure guides the model through the context and examples before presenting the core task\n        const userSections: (Section<any> | undefined)[] = [\n            prompt.contexts,\n            prompt.examples,\n            prompt.instructions,\n            prompt.contents,\n            prompt.reasoning,\n            prompt.recap\n        ];\n\n        let formattedUserContent = \"\";\n        \n        for (const section of userSections) {\n            if (section) {\n                formattedUserContent += formatSection(section) + '\\n\\n';\n            }\n        }\n\n        // Ensure we always have a user message, or if we have content to send\n        if (formattedUserContent.trim().length > 0 || systemSections.length === 0) {\n            chatRequest.addMessage({\n                role: \"user\",\n                content: formattedUserContent.trim() || \" \", // Empty user message if needed (though usually not ideal)\n            });\n        }\n\n        if (prompt.schema) {\n            chatRequest.responseFormat = prompt.schema;\n        }\n\n        if (prompt.validator) {\n            chatRequest.validator = prompt.validator;\n        }\n\n        return chatRequest;\n    }\n\n    return {\n        formatPersona,\n        format,\n        formatPrompt,\n        formatArray,\n    }\n}\n"],"names":["SectionSeparatorSchema","z","enum","SectionTitlePropertySchema","FormatOptionsSchema","object","sectionSeparator","sectionIndentation","boolean","sectionTitleProperty","sectionTitlePrefix","string","optional","sectionTitleSeparator","sectionDepth","number","default","OptionSchema","logger","any","DEFAULT_LOGGER","formatOptions","partial","DEFAULT_FORMAT_OPTIONS","isSection","obj","Array","isArray","items","isWeighted","create","formatterOptions","options","parse","wrapLogger","clean","formatPersona","model","persona","silly","formattedPersona","formatSection","role","getPersonaRole","content","Error","format","item","stringifyJSON","currentSectionDepth","result","text","section","formattedItems","map","join","title","headingLevel","hashes","repeat","formatArray","formatPrompt","prompt","chatRequest","Chat","systemSections","push","tone","constraints","safeguards","responseFormat","length","systemContent","addMessage","userSections","contexts","examples","instructions","contents","reasoning","recap","formattedUserContent","trim","schema","validator"],"mappings":"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"}

package/dist/prompt.d.ts

@@ -7,10 +7,28 @@ export interface Prompt {
     instructions: Section<Instruction>;
     contents?: Section<Content>;
     contexts?: Section<Context>;
+    constraints?: Section<Instruction>;
+    tone?: Section<Instruction>;
+    examples?: Section<Content>;
+    reasoning?: Section<Instruction>;
+    responseFormat?: Section<Instruction>;
+    recap?: Section<Instruction>;
+    safeguards?: Section<Instruction>;
+    schema?: any;
+    validator?: any;
 }
-export declare const create: ({ persona, instructions, contents, contexts, }: {
+export declare const create: ({ persona, instructions, contents, contexts, constraints, tone, examples, reasoning, responseFormat, recap, safeguards, schema, validator, }: {
     persona?: Section<Instruction>;
     instructions: Section<Instruction>;
     contents?: Section<Content>;
     contexts?: Section<Context>;
+    constraints?: Section<Instruction>;
+    tone?: Section<Instruction>;
+    examples?: Section<Content>;
+    reasoning?: Section<Instruction>;
+    responseFormat?: Section<Instruction>;
+    recap?: Section<Instruction>;
+    safeguards?: Section<Instruction>;
+    schema?: any;
+    validator?: any;
 }) => Prompt;

package/dist/prompt.js

@@ -1,9 +1,18 @@
-const create = ({ persona, instructions, contents, contexts })=>{
+const create = ({ persona, instructions, contents, contexts, constraints, tone, examples, reasoning, responseFormat, recap, safeguards, schema, validator })=>{
     return {
         persona,
         instructions,
         contents,
-        contexts
+        contexts,
+        constraints,
+        tone,
+        examples,
+        reasoning,
+        responseFormat,
+        recap,
+        safeguards,
+        schema,
+        validator
     };
 };
 

package/dist/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sources":["../src/prompt.ts"],"sourcesContent":["import { Content } from \"./items/content\";\nimport { Context } from \"./items/context\";\nimport { Instruction } from \"./items/instruction\";\nimport { Section } from \"./items/section\";\n\nexport interface Prompt {\n    persona?: Section<Instruction>;\n    instructions: Section<Instruction>;\n    contents?: Section<Content>;\n    contexts?: Section<Context>;\n}\n\nexport const create = ({\n    persona,\n    instructions,\n    contents,\n    contexts,\n}: {\n    persona?: Section<Instruction>,\n    instructions: Section<Instruction>,\n    contents?: Section<Content>,\n    contexts?: Section<Context>\n}): Prompt => {\n\n    return {\n        persona,\n        instructions,\n        contents,\n        contexts,\n    }\n}"],"names":["create","persona","instructions","contents","contexts"],"mappings":"AAYO,MAAMA,MAAAA,GAAS,CAAC,EACnBC,OAAO,EACPC,YAAY,EACZC,QAAQ,EACRC,QAAQ,EAMX,GAAA;IAEG,OAAO;AACHH,QAAAA,OAAAA;AACAC,QAAAA,YAAAA;AACAC,QAAAA,QAAAA;AACAC,QAAAA;AACJ,KAAA;AACJ;;;;"}
+{"version":3,"file":"prompt.js","sources":["../src/prompt.ts"],"sourcesContent":["import { Content } from \"./items/content\";\nimport { Context } from \"./items/context\";\nimport { Instruction } from \"./items/instruction\";\nimport { Section } from \"./items/section\";\n\nexport interface Prompt {\n    persona?: Section<Instruction>;\n    instructions: Section<Instruction>;\n    contents?: Section<Content>;\n    contexts?: Section<Context>;\n    \n    // Extended sections for advanced prompting\n    constraints?: Section<Instruction>;\n    tone?: Section<Instruction>;\n    examples?: Section<Content>;\n    reasoning?: Section<Instruction>;\n    responseFormat?: Section<Instruction>;\n    recap?: Section<Instruction>;\n    safeguards?: Section<Instruction>;\n    schema?: any; // JSON Schema for the provider\n    validator?: any; // Zod schema for validation\n}\n\nexport const create = ({\n    persona,\n    instructions,\n    contents,\n    contexts,\n    constraints,\n    tone,\n    examples,\n    reasoning,\n    responseFormat,\n    recap,\n    safeguards,\n    schema,\n    validator,\n}: {\n    persona?: Section<Instruction>,\n    instructions: Section<Instruction>,\n    contents?: Section<Content>,\n    contexts?: Section<Context>,\n    constraints?: Section<Instruction>,\n    tone?: Section<Instruction>,\n    examples?: Section<Content>,\n    reasoning?: Section<Instruction>,\n    responseFormat?: Section<Instruction>,\n    recap?: Section<Instruction>,\n    safeguards?: Section<Instruction>,\n    schema?: any,\n    validator?: any,\n}): Prompt => {\n\n    return {\n        persona,\n        instructions,\n        contents,\n        contexts,\n        constraints,\n        tone,\n        examples,\n        reasoning,\n        responseFormat,\n        recap,\n        safeguards,\n        schema,\n        validator,\n    }\n}"],"names":["create","persona","instructions","contents","contexts","constraints","tone","examples","reasoning","responseFormat","recap","safeguards","schema","validator"],"mappings":"AAuBO,MAAMA,MAAAA,GAAS,CAAC,EACnBC,OAAO,EACPC,YAAY,EACZC,QAAQ,EACRC,QAAQ,EACRC,WAAW,EACXC,IAAI,EACJC,QAAQ,EACRC,SAAS,EACTC,cAAc,EACdC,KAAK,EACLC,UAAU,EACVC,MAAM,EACNC,SAAS,EAeZ,GAAA;IAEG,OAAO;AACHZ,QAAAA,OAAAA;AACAC,QAAAA,YAAAA;AACAC,QAAAA,QAAAA;AACAC,QAAAA,QAAAA;AACAC,QAAAA,WAAAA;AACAC,QAAAA,IAAAA;AACAC,QAAAA,QAAAA;AACAC,QAAAA,SAAAA;AACAC,QAAAA,cAAAA;AACAC,QAAAA,KAAAA;AACAC,QAAAA,UAAAA;AACAC,QAAAA,MAAAA;AACAC,QAAAA;AACJ,KAAA;AACJ;;;;"}

package/dist/recipes.d.ts

@@ -76,6 +76,98 @@ declare const RecipeConfigSchema: z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
         weight: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>]>>>>;
+    constraints: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        content: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        path: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        directories: z.ZodArray<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>>>;
+    tone: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        content: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        path: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        directories: z.ZodArray<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>>>;
+    examples: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        content: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        path: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        directories: z.ZodArray<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>>>;
+    reasoning: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        content: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        path: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        directories: z.ZodArray<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>>>;
+    responseFormat: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        content: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        path: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        directories: z.ZodArray<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>>>;
+    recap: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        content: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        path: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        directories: z.ZodArray<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>>>;
+    safeguards: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        content: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        path: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        directories: z.ZodArray<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        weight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>>>;
+    schema: z.ZodOptional<z.ZodAny>;
     extends: z.ZodOptional<z.ZodString>;
     template: z.ZodOptional<z.ZodString>;
     tools: z.ZodOptional<z.ZodAny>;
@@ -110,6 +202,14 @@ export interface TemplateConfig {
     instructions?: ContentItem[];
     content?: ContentItem[];
     context?: ContentItem[];
+    constraints?: ContentItem[];
+    tone?: ContentItem[];
+    examples?: ContentItem[];
+    reasoning?: ContentItem[];
+    responseFormat?: ContentItem[];
+    recap?: ContentItem[];
+    safeguards?: ContentItem[];
+    schema?: string | Record<string, any> | z.ZodType<any>;
     tools?: Tool[] | ToolRegistry;
     toolGuidance?: Partial<ToolGuidanceConfig> | 'auto' | 'minimal' | 'detailed';
 }
@@ -154,6 +254,14 @@ export declare const recipe: (basePath: string) => {
     instructions: (...instructions: ContentItem[]) => /*elided*/ any;
     content: (...content: ContentItem[]) => /*elided*/ any;
     context: (...context: ContentItem[]) => /*elided*/ any;
+    constraints: (...constraints: ContentItem[]) => /*elided*/ any;
+    tone: (...tone: ContentItem[]) => /*elided*/ any;
+    examples: (...examples: ContentItem[]) => /*elided*/ any;
+    reasoning: (...reasoning: ContentItem[]) => /*elided*/ any;
+    responseFormat: (...responseFormat: ContentItem[]) => /*elided*/ any;
+    recap: (...recap: ContentItem[]) => /*elided*/ any;
+    safeguards: (...safeguards: ContentItem[]) => /*elided*/ any;
+    schema: (schema: string | Record<string, any> | z.ZodType<any>) => /*elided*/ any;
     parameters: (parameters: any) => /*elided*/ any;
     overrides: (enabled: boolean) => /*elided*/ any;
     overridePaths: (paths: string[]) => /*elided*/ any;

package/dist/recipes.js

@@ -1,5 +1,7 @@
 import path__default from 'path';
+import fs__default from 'fs/promises';
 import { z } from 'zod';
+import zodToJsonSchema from 'zod-to-json-schema';
 import { ConversationBuilder } from './conversation.js';
 import { ParametersSchema } from './items/parameters.js';
 import { DEFAULT_LOGGER, wrapLogger } from './logger.js';
@@ -51,6 +53,15 @@ const RecipeConfigSchema = z.object({
     instructions: z.array(ContentItemSchema).optional().default([]),
     content: z.array(ContentItemSchema).optional().default([]),
     context: z.array(ContentItemSchema).optional().default([]),
+    // Advanced prompting sections
+    constraints: z.array(ContentItemSchema).optional().default([]),
+    tone: z.array(ContentItemSchema).optional().default([]),
+    examples: z.array(ContentItemSchema).optional().default([]),
+    reasoning: z.array(ContentItemSchema).optional().default([]),
+    responseFormat: z.array(ContentItemSchema).optional().default([]),
+    recap: z.array(ContentItemSchema).optional().default([]),
+    safeguards: z.array(ContentItemSchema).optional().default([]),
+    schema: z.any().optional(),
     // Templates and inheritance
     extends: z.string().optional(),
     template: z.string().optional(),
@@ -216,6 +227,13 @@ const cook = async (config)=>{
         instructions: [],
         content: [],
         context: [],
+        constraints: [],
+        tone: [],
+        examples: [],
+        reasoning: [],
+        responseFormat: [],
+        recap: [],
+        safeguards: [],
         ...config
     });
     // Handle template inheritance
@@ -239,7 +257,36 @@ const cook = async (config)=>{
                 context: [
                     ...template.context || [],
                     ...validatedConfig.context || []
-                ]
+                ],
+                constraints: [
+                    ...template.constraints || [],
+                    ...validatedConfig.constraints || []
+                ],
+                tone: [
+                    ...template.tone || [],
+                    ...validatedConfig.tone || []
+                ],
+                examples: [
+                    ...template.examples || [],
+                    ...validatedConfig.examples || []
+                ],
+                reasoning: [
+                    ...template.reasoning || [],
+                    ...validatedConfig.reasoning || []
+                ],
+                responseFormat: [
+                    ...template.responseFormat || [],
+                    ...validatedConfig.responseFormat || []
+                ],
+                recap: [
+                    ...template.recap || [],
+                    ...validatedConfig.recap || []
+                ],
+                safeguards: [
+                    ...template.safeguards || [],
+                    ...validatedConfig.safeguards || []
+                ],
+                schema: validatedConfig.schema || template.schema
             };
         }
     }
@@ -271,6 +318,39 @@ const cook = async (config)=>{
     const contextSection = create$3({
         title: "Context"
     });
+    // Advanced sections
+    const constraintSection = create$3({
+        title: "Constraints"
+    });
+    const toneSection = create$3({
+        title: "Tone"
+    });
+    const exampleSection = create$3({
+        title: "Examples"
+    });
+    const reasoningSection = create$3({
+        title: "Reasoning"
+    });
+    const responseFormatSection = create$3({
+        title: "Response Format"
+    });
+    const recapSection = create$3({
+        title: "Recap"
+    });
+    const safeguardSection = create$3({
+        title: "Safeguards"
+    });
+    // Helper for processing list items
+    const processList = async (items, section, type)=>{
+        for (const item of items){
+            await processContentItem(item, section, type, {
+                basePath: finalConfig.basePath,
+                parser: parser$1,
+                override: override$1,
+                loader: loader$1,
+                parameters: finalConfig.parameters});
+        }
+    };
     // Process persona
     if (finalConfig.persona) {
         await processContentItem(finalConfig.persona, personaSection, 'persona', {
@@ -280,15 +360,18 @@ const cook = async (config)=>{
             loader: loader$1,
             parameters: finalConfig.parameters});
     }
-    // Process instructions
-    for (const item of finalConfig.instructions || []){
-        await processContentItem(item, instructionSection, 'instruction', {
-            basePath: finalConfig.basePath,
-            parser: parser$1,
-            override: override$1,
-            loader: loader$1,
-            parameters: finalConfig.parameters});
-    }
+    // Process standard sections
+    await processList(finalConfig.instructions || [], instructionSection, 'instruction');
+    await processList(finalConfig.content || [], contentSection, 'content');
+    await processList(finalConfig.context || [], contextSection, 'context');
+    // Process advanced sections
+    await processList(finalConfig.constraints || [], constraintSection, 'instruction');
+    await processList(finalConfig.tone || [], toneSection, 'instruction');
+    await processList(finalConfig.examples || [], exampleSection, 'content');
+    await processList(finalConfig.reasoning || [], reasoningSection, 'instruction');
+    await processList(finalConfig.responseFormat || [], responseFormatSection, 'instruction');
+    await processList(finalConfig.recap || [], recapSection, 'instruction');
+    await processList(finalConfig.safeguards || [], safeguardSection, 'instruction');
     // Generate tool guidance if tools are provided
     if (finalConfig.tools) {
         const tools = Array.isArray(finalConfig.tools) ? finalConfig.tools : finalConfig.tools.getAll();
@@ -302,30 +385,59 @@ const cook = async (config)=>{
             instructionSection.add(toolSection);
         }
     }
-    // Process content
-    for (const item of finalConfig.content || []){
-        await processContentItem(item, contentSection, 'content', {
-            basePath: finalConfig.basePath,
-            parser: parser$1,
-            override: override$1,
-            loader: loader$1,
-            parameters: finalConfig.parameters});
-    }
-    // Process context
-    for (const item of finalConfig.context || []){
-        await processContentItem(item, contextSection, 'context', {
-            basePath: finalConfig.basePath,
-            parser: parser$1,
-            override: override$1,
-            loader: loader$1,
-            parameters: finalConfig.parameters});
+    // Process schema
+    let schema = finalConfig.schema;
+    let validator = undefined;
+    if (schema instanceof z.ZodType) {
+        var _jsonSchema_definitions;
+        // It's a Zod schema!
+        validator = schema;
+        const jsonSchema = zodToJsonSchema(schema, "response");
+        // Wrap in OpenAI Structured Output format
+        // zod-to-json-schema returns { "$schema": "...", "definitions": { "response": { ... } }, "$ref": "#/definitions/response" }
+        // We need to extract the schema part.
+        // Simpler usage for OpenAI: just get the schema object.
+        // Actually, zod-to-json-schema produces a full JSON schema object.
+        // OpenAI expects: { type: "json_schema", json_schema: { name: "...", schema: ... } }
+        // Let's create a clean schema object
+        // NOTE: OpenAI requires strict: true and additionalProperties: false
+        // zod-to-json-schema generally produces compatible schemas but strictness might need tweaking if required by OpenAI.
+        // For now, let's assume "response" as the name.
+        // We'll define a simpler conversion if possible, or trust the user to configure Zod strictly if they want strict mode.
+        // Extract the definition if it exists
+        const actualSchema = ((_jsonSchema_definitions = jsonSchema.definitions) === null || _jsonSchema_definitions === void 0 ? void 0 : _jsonSchema_definitions.response) || jsonSchema;
+        schema = {
+            type: "json_schema",
+            json_schema: {
+                name: "response",
+                schema: actualSchema,
+                strict: true // Try to enable strict mode for OpenAI
+            }
+        };
+    } else if (typeof schema === 'string') {
+        const schemaPath = path__default.resolve(finalConfig.basePath, schema);
+        try {
+            const schemaContent = await fs__default.readFile(schemaPath, 'utf-8');
+            schema = JSON.parse(schemaContent);
+        } catch (e) {
+            throw new Error(`Failed to load schema from ${schemaPath}: ${e.message}`);
+        }
     }
     // Build and return prompt
     return create$4({
-        persona: personaSection,
+        persona: personaSection.items.length > 0 ? personaSection : undefined,
         instructions: instructionSection,
-        contents: contentSection,
-        contexts: contextSection
+        contents: contentSection.items.length > 0 ? contentSection : undefined,
+        contexts: contextSection.items.length > 0 ? contextSection : undefined,
+        constraints: constraintSection.items.length > 0 ? constraintSection : undefined,
+        tone: toneSection.items.length > 0 ? toneSection : undefined,
+        examples: exampleSection.items.length > 0 ? exampleSection : undefined,
+        reasoning: reasoningSection.items.length > 0 ? reasoningSection : undefined,
+        responseFormat: responseFormatSection.items.length > 0 ? responseFormatSection : undefined,
+        recap: recapSection.items.length > 0 ? recapSection : undefined,
+        safeguards: safeguardSection.items.length > 0 ? safeguardSection : undefined,
+        schema,
+        validator
     });
 };
 const processContentItem = async (item, section, type, ctx)=>{
@@ -403,6 +515,59 @@ const recipe = (basePath)=>{
             ];
             return builder;
         },
+        constraints: (...constraints)=>{
+            config.constraints = [
+                ...config.constraints || [],
+                ...constraints
+            ];
+            return builder;
+        },
+        tone: (...tone)=>{
+            config.tone = [
+                ...config.tone || [],
+                ...tone
+            ];
+            return builder;
+        },
+        examples: (...examples)=>{
+            config.examples = [
+                ...config.examples || [],
+                ...examples
+            ];
+            return builder;
+        },
+        reasoning: (...reasoning)=>{
+            config.reasoning = [
+                ...config.reasoning || [],
+                ...reasoning
+            ];
+            return builder;
+        },
+        responseFormat: (...responseFormat)=>{
+            config.responseFormat = [
+                ...config.responseFormat || [],
+                ...responseFormat
+            ];
+            return builder;
+        },
+        recap: (...recap)=>{
+            config.recap = [
+                ...config.recap || [],
+                ...recap
+            ];
+            return builder;
+        },
+        safeguards: (...safeguards)=>{
+            config.safeguards = [
+                ...config.safeguards || [],
+                ...safeguards
+            ];
+            return builder;
+        },
+        schema: (schema)=>{
+            config.schema = schema;
+            return builder;
+        },
         parameters: (parameters)=>{
             config.parameters = {
                 ...config.parameters,