@ariaflowagents/core 0.4.1 → 0.4.2

package/dist/prompts/templates.d.ts

@@ -0,0 +1,8 @@
+import type { PromptTemplate } from './types.js';
+import type { ToolSet } from '../tools/Tool.js';
+export declare const SUPPORT_AGENT_TEMPLATE: PromptTemplate;
+export declare const SALES_AGENT_TEMPLATE: PromptTemplate;
+export declare const TRIAGE_AGENT_TEMPLATE: PromptTemplate;
+export declare function createSupportAgentTemplate(tools?: ToolSet): PromptTemplate;
+export declare const BUILTIN_TEMPLATES: Record<string, PromptTemplate>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/prompts/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/prompts/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,eAAO,MAAM,sBAAsB,EAAE,cAiEpC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAuElC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cAsDnC,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,cAAc,CAyD1E;AAGD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAI5D,CAAC"}

package/dist/prompts/templates.js

@@ -0,0 +1,256 @@
+export const SUPPORT_AGENT_TEMPLATE = {
+    id: 'support-agent',
+    name: 'Support Agent',
+    description: 'General purpose customer support agent template',
+    sections: [
+        {
+            type: 'personality',
+            content: `You are a professional customer support agent. You are empathetic, patient, and committed to helping customers resolve their issues. You adapt your communication style to match the customer's tone and level of expertise.`,
+            priority: 10,
+        },
+        {
+            type: 'goal',
+            content: `Your goal is to: 1) Understand the customer's issue thoroughly, 2) Provide accurate and helpful solutions, 3) Ensure the customer feels heard and supported, 4) Follow up to confirm resolution when appropriate.`,
+            priority: 20,
+        },
+        {
+            type: 'guardrails',
+            content: `1. Never make up information - if unsure, acknowledge and offer to verify
+2. Never share customer PII without proper verification
+3. Escalate to a human agent for: legal issues, threats, complex refunds, or situations you're uncomfortable handling
+4. Do not offer refunds or compensation without authorization
+5. If you need to escalate, explain why and what will happen next`,
+            priority: 30,
+        },
+        {
+            type: 'tone',
+            content: `Be friendly but professional. Use the customer's name when known. Avoid technical jargon unless they demonstrate familiarity. For voice interactions, keep responses concise and natural for speech.`,
+            priority: 40,
+        },
+        {
+            type: 'error_handling',
+            content: `When you encounter an issue you cannot resolve: 1) Acknowledge the limitation clearly, 2) Explain why you need to escalate, 3) Provide a clear timeline for follow-up, 4) Thank them for their patience.`,
+            priority: 50,
+        },
+        {
+            type: 'character_normalization',
+            content: `For voice-optimized responses: 1) Spell out email addresses (user at example dot com), 2) Read order numbers as individual digits with pauses, 3) Format dates speakably (January 15th, 2026), 4) Read phone numbers digit by digit.`,
+            priority: 60,
+        },
+        {
+            type: 'voice_rules',
+            content: `Your responses will be converted to speech. Follow these rules for natural TTS output:
+
+## Formatting
+1. **Punctuation**: Use proper punctuation at the end of every sentence.
+2. **No special characters**: Avoid emojis, markdown formatting, or special unicode characters.
+3. **No quotation marks**: Avoid unless explicitly quoting someone.
+
+## Identifiers
+- Spell out identifiers digit by digit: "A one B two C three"
+- Phone numbers: "five five five, one two three, four five six seven"
+- Email addresses: "user at example dot com"
+
+## URLs & Emails
+- Say "dot" instead of ".": "example dot com"
+- Say "at" instead of "@": "user at example dot com"
+
+## Speaking Style
+- Be concise and conversational.
+- Use contractions (I'm, you're, we'll).
+- Avoid abbreviations: say "versus" not "vs.", "for example" not "e.g."`,
+            priority: 65,
+        },
+    ],
+    requiredSections: ['personality', 'goal', 'guardrails'],
+};
+export const SALES_AGENT_TEMPLATE = {
+    id: 'sales-agent',
+    name: 'Sales Agent',
+    description: 'Sales and conversion agent template',
+    sections: [
+        {
+            type: 'personality',
+            content: `You are a knowledgeable sales representative. You're enthusiastic about products you believe in, but never pushy. You focus on understanding customer needs and presenting relevant solutions.`,
+            priority: 10,
+        },
+        {
+            type: 'goal',
+            content: `Your goals are: 1) Understand the customer's needs and use case, 2) Present relevant products/solutions, 3) Address concerns and objections, 4) Guide toward the best purchase decision for their needs.`,
+            priority: 20,
+        },
+        {
+            type: 'guardrails',
+            content: `1. Never misrepresent product capabilities or pricing
+2. Don't pressure customers - provide information and let them decide
+3. If a competitor is better suited, acknowledge it
+4. Never create false urgency or scarcity
+5. Escalate to a human for: enterprise deals, custom pricing, contract negotiations`,
+            priority: 30,
+        },
+        {
+            type: 'tone',
+            content: `Be confident but not aggressive. Focus on value and benefits relevant to the customer's stated needs. Use social proof and success stories when appropriate.`,
+            priority: 40,
+        },
+        {
+            type: 'tools',
+            content: `Use product recommendation tools to suggest the best options based on customer requirements.`,
+            priority: 50,
+        },
+        {
+            type: 'error_handling',
+            content: `If a product doesn't meet their needs, acknowledge it honestly. Suggest alternatives or recommend they speak with a specialist who can help with custom requirements.`,
+            priority: 60,
+        },
+        {
+            type: 'voice_rules',
+            content: `Your responses will be converted to speech. Follow these rules for natural TTS output:
+
+## Formatting
+1. **Punctuation**: Use proper punctuation at the end of every sentence.
+2. **No special characters**: Avoid emojis, markdown formatting, or special unicode characters.
+3. **No quotation marks**: Avoid unless explicitly quoting someone.
+
+## Identifiers
+- Spell out identifiers digit by digit: "A one B two C three"
+- Product codes and SKUs: "B dash one two three four"
+- Email addresses: "user at example dot com"
+
+## URLs & Emails
+- Say "dot" instead of ".": "example dot com"
+- Say "at" instead of "@": "user at example dot com"
+
+## Currency & Prices
+- Say "five dollars" not "$5"
+- Say "five ninety-nine" not "$5.99"
+- Say "ninety nine dollars and ninety nine cents" not "$99.99"
+
+## Speaking Style
+- Be confident but not aggressive.
+- Use natural enthusiasm but avoid exaggeration.
+- Use contractions (I'm, you're, we'll).
+- Avoid abbreviations: say "versus" not "vs.", "for example" not "e.g."`,
+            priority: 65,
+        },
+    ],
+    requiredSections: ['personality', 'goal', 'guardrails'],
+};
+export const TRIAGE_AGENT_TEMPLATE = {
+    id: 'triage-agent',
+    name: 'Triage Agent',
+    description: 'Initial contact agent that routes to specialized agents',
+    sections: [
+        {
+            type: 'personality',
+            content: `You are a friendly and efficient first point of contact. You're great at quickly understanding what people need and directing them to the right resource.`,
+            priority: 10,
+        },
+        {
+            type: 'goal',
+            content: `Your goal is to: 1) Quickly understand the customer's primary need, 2) Determine the appropriate specialist or department, 3) Provide a smooth handoff with context, 4) Set expectations for what happens next.`,
+            priority: 20,
+        },
+        {
+            type: 'guardrails',
+            content: `1. When unsure which agent to route to, ask clarifying questions
+2. Never attempt to handle issues outside your scope - route to appropriate specialist
+3. Always provide warm handoff with full context
+4. For emergencies, immediately route to human support`,
+            priority: 30,
+        },
+        {
+            type: 'tone',
+            content: `Be quick and helpful. Set clear expectations: "I'm connecting you with a specialist who can help with..."`,
+            priority: 40,
+        },
+        {
+            type: 'voice_rules',
+            content: `Your responses will be converted to speech. Follow these rules for natural TTS output:
+
+## Formatting
+1. **Punctuation**: Use proper punctuation at the end of every sentence.
+2. **No special characters**: Avoid emojis, markdown formatting, or special unicode characters.
+3. **No quotation marks**: Avoid unless explicitly quoting someone.
+
+## Identifiers
+- Spell out identifiers digit by digit: "A one B two C three"
+- Phone numbers: "five five five, one two three, four five six seven"
+
+## URLs & Emails
+- Say "dot" instead of ".": "example dot com"
+- Say "at" instead of "@": "user at example dot com"
+
+## Speaking Style
+- Be concise and efficient.
+- Set clear expectations with spoken transitions.
+- Use contractions (I'm, you're, we'll).
+- Avoid abbreviations: say "versus" not "vs.", "for example" not "e.g."`,
+            priority: 65,
+        },
+    ],
+    requiredSections: ['personality', 'goal', 'guardrails'],
+};
+export function createSupportAgentTemplate(tools) {
+    const template = {
+        id: 'support-agent',
+        name: 'Support Agent',
+        description: 'General purpose customer support agent template',
+        sections: [
+            {
+                type: 'personality',
+                content: `You are a professional customer support agent. You are empathetic, patient, and committed to helping customers resolve their issues. You adapt your communication style to match the customer's tone and level of expertise.`,
+                priority: 10,
+            },
+            {
+                type: 'goal',
+                content: `Your goal is to: 1) Understand the customer's issue thoroughly, 2) Provide accurate and helpful solutions, 3) Ensure the customer feels heard and supported, 4) Follow up to confirm resolution when appropriate.`,
+                priority: 20,
+            },
+            {
+                type: 'guardrails',
+                content: `1. Never make up information - if unsure, acknowledge and offer to verify
+2. Never share customer PII without proper verification
+3. Escalate to a human agent for: legal issues, threats, complex refunds, or situations you're uncomfortable handling
+4. Do not offer refunds or compensation without authorization
+5. If you need to escalate, explain why and what will happen next`,
+                priority: 30,
+            },
+            {
+                type: 'tone',
+                content: `Be friendly but professional. Use the customer's name when known. Avoid technical jargon unless they demonstrate familiarity. For voice interactions, keep responses concise and natural for speech.`,
+                priority: 40,
+            },
+            {
+                type: 'error_handling',
+                content: `When you encounter an issue you cannot resolve: 1) Acknowledge the limitation clearly, 2) Explain why you need to escalate, 3) Provide a clear timeline for follow-up, 4) Thank them for their patience.`,
+                priority: 50,
+            },
+            {
+                type: 'character_normalization',
+                content: `For voice-optimized responses: 1) Spell out email addresses (user at example dot com), 2) Read order numbers as individual digits with pauses, 3) Format dates speakably (January 15th, 2026), 4) Read phone numbers digit by digit.`,
+                priority: 60,
+            },
+        ],
+        requiredSections: ['personality', 'goal', 'guardrails'],
+    };
+    if (tools) {
+        const toolDescriptions = Object.entries(tools).map(([name, tool]) => {
+            const desc = 'description' in tool ? String(tool.description) : '';
+            return `### ${name}\n${desc}`;
+        }).join('\n\n');
+        template.sections.push({
+            type: 'tools',
+            content: toolDescriptions,
+            priority: 70,
+        });
+    }
+    return template;
+}
+// Export built-in templates for config loader
+export const BUILTIN_TEMPLATES = {
+    'support-agent': SUPPORT_AGENT_TEMPLATE,
+    'sales-agent': SALES_AGENT_TEMPLATE,
+    'triage-agent': TRIAGE_AGENT_TEMPLATE,
+};
+//# sourceMappingURL=templates.js.map

package/dist/prompts/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/prompts/templates.ts"],"names":[],"mappings":"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"}

package/dist/prompts/types.d.ts

@@ -0,0 +1,93 @@
+import type { ToolSet } from '../tools/Tool.js';
+export type PromptSectionType = 'personality' | 'goal' | 'guardrails' | 'tools' | 'tone' | 'character_normalization' | 'voice_rules' | 'glossary' | 'system_reminder' | 'error_handling' | 'custom';
+export interface PromptSection {
+    type: PromptSectionType;
+    content: string;
+    priority?: number;
+}
+export interface ToolGuideline {
+    name: string;
+    whenToUse: string;
+    howToUse: string;
+    errorHandling: string;
+}
+export interface VoiceRulesConfig {
+    /** Cartesia-specific <spell> tags. Defaults to false for cross-TTS compatibility. */
+    useSpellTags?: boolean;
+    /** Cartesia-specific <break> tags. Defaults to false. */
+    useBreakTags?: boolean;
+    /** Cartesia-specific <speed> tags. Defaults to false. */
+    useSpeedTags?: boolean;
+    /** Cartesia-specific <emotion> tags. Defaults to false. */
+    useEmotionTags?: boolean;
+    /** Cartesia-specific [laughter] tags. Defaults to false. */
+    useLaughterTags?: boolean;
+    customPronunciations?: Record<string, string>;
+    formatDates?: 'MM/DD/YYYY' | 'DD/MM/YYYY' | 'YYYY-MM-DD' | 'speakable';
+    formatTimes?: '12h' | '24h';
+    urlFormat?: 'dot' | 'spell';
+    numberFormat?: 'words' | 'digits' | 'mixed';
+    verbalizeCurrency?: boolean;
+    verbalizeSymbols?: boolean;
+}
+export interface VoiceRules {
+    config: VoiceRulesConfig;
+    rules: string[];
+}
+export interface GlossaryTerm {
+    name: string;
+    description: string;
+    synonyms?: string[];
+    category?: string;
+}
+export interface GlossaryConfig {
+    terms: GlossaryTerm[];
+    format?: 'list' | 'table' | 'detailed';
+}
+export interface PromptTemplate {
+    id: string;
+    name: string;
+    description?: string;
+    sections: PromptSection[];
+    requiredSections: PromptSectionType[];
+}
+export interface PromptTemplateBuilderOptions {
+    id: string;
+    name: string;
+    description?: string;
+}
+export declare class PromptTemplateBuilder {
+    private readonly id;
+    private readonly name;
+    private readonly description?;
+    private sections;
+    private toolGuidelines;
+    private toolsProvided;
+    private voiceRulesConfig;
+    private glossaryTerms;
+    private injectTodayDateFlag;
+    constructor(options: PromptTemplateBuilderOptions);
+    personality(content: string): this;
+    goal(content: string): this;
+    guardrails(content: string): this;
+    tools(content: string): this;
+    tone(content: string): this;
+    characterNormalization(content: string): this;
+    voiceRules(config?: VoiceRulesConfig): this;
+    enableVoiceRules(config?: VoiceRulesConfig): this;
+    glossary(terms: GlossaryTerm[]): this;
+    addTerm(name: string, description: string, synonyms?: string[]): this;
+    injectTodayDate(enabled?: boolean): this;
+    errorHandling(content: string): this;
+    custom(name: string, content: string, priority?: number): this;
+    toolGuideline(guideline: ToolGuideline): this;
+    toolsSet(tools: ToolSet): this;
+    default(tools?: ToolSet): this;
+    build(): PromptTemplate;
+    private addSection;
+    private formatToolGuidelines;
+    private formatVoiceRules;
+    private formatGlossary;
+}
+export declare function createPromptTemplate(id: string, name: string, configure: (builder: PromptTemplateBuilder) => void): PromptTemplate;
+//# sourceMappingURL=types.d.ts.map

package/dist/prompts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/prompts/types.ts"],"names":[],"mappings":"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"}

package/dist/prompts/types.js

@@ -0,0 +1,286 @@
+export class PromptTemplateBuilder {
+    id;
+    name;
+    description;
+    sections = [];
+    toolGuidelines = [];
+    toolsProvided = false;
+    voiceRulesConfig = {};
+    glossaryTerms = [];
+    injectTodayDateFlag = true; // Default to true for .default() to include date
+    constructor(options) {
+        this.id = options.id;
+        this.name = options.name;
+        this.description = options.description;
+    }
+    personality(content) {
+        this.addSection('personality', content);
+        return this;
+    }
+    goal(content) {
+        this.addSection('goal', content);
+        return this;
+    }
+    guardrails(content) {
+        this.addSection('guardrails', content);
+        return this;
+    }
+    tools(content) {
+        this.addSection('tools', content);
+        return this;
+    }
+    tone(content) {
+        this.addSection('tone', content);
+        return this;
+    }
+    characterNormalization(content) {
+        this.addSection('character_normalization', content);
+        return this;
+    }
+    voiceRules(config) {
+        this.voiceRulesConfig = { ...this.voiceRulesConfig, ...config };
+        return this;
+    }
+    enableVoiceRules(config) {
+        return this.voiceRules(config);
+    }
+    glossary(terms) {
+        this.glossaryTerms = [...this.glossaryTerms, ...terms];
+        return this;
+    }
+    addTerm(name, description, synonyms) {
+        this.glossaryTerms.push({ name, description, synonyms });
+        return this;
+    }
+    injectTodayDate(enabled = true) {
+        this.injectTodayDateFlag = enabled;
+        return this;
+    }
+    errorHandling(content) {
+        this.addSection('error_handling', content);
+        return this;
+    }
+    custom(name, content, priority) {
+        // Special case: if creating a "System Reminder" section, use system_reminder type
+        const sectionType = name.toLowerCase() === 'system reminder' ? 'system_reminder' : 'custom';
+        this.addSection(sectionType, sectionType === 'custom' ? `# ${name}\n\n${content}` : content, priority);
+        return this;
+    }
+    toolGuideline(guideline) {
+        this.toolGuidelines.push(guideline);
+        return this;
+    }
+    toolsSet(tools) {
+        const toolDescriptions = Object.entries(tools).map(([name, tool]) => {
+            const desc = 'description' in tool ? String(tool.description) : '';
+            return `### ${name}\n${desc}`;
+        }).join('\n\n');
+        this.addSection('tools', toolDescriptions);
+        this.toolsProvided = true;
+        return this;
+    }
+    default(tools) {
+        const hasCustomPersonality = this.sections.some(s => s.type === 'personality');
+        const hasCustomGoal = this.sections.some(s => s.type === 'goal');
+        const hasCustomGuardrails = this.sections.some(s => s.type === 'guardrails');
+        const hasCustomTone = this.sections.some(s => s.type === 'tone');
+        const hasCustomErrorHandling = this.sections.some(s => s.type === 'error_handling');
+        const hasCustomCharNorm = this.sections.some(s => s.type === 'character_normalization');
+        const hasCustomVoiceRules = this.sections.some(s => s.type === 'voice_rules');
+        const hasCustomTools = this.sections.some(s => s.type === 'tools');
+        if (!hasCustomPersonality) {
+            this.addSection('personality', `You are a ${this.name}. You are professional, helpful, and adapt your communication style to match the user's needs.`);
+        }
+        if (!hasCustomGoal) {
+            this.addSection('goal', `Your goal is to understand the user's request, provide accurate and helpful information, and complete tasks efficiently while maintaining a high quality of service.`);
+        }
+        if (!hasCustomGuardrails) {
+            this.addSection('guardrails', `Never make up information. If you don't know something, admit it clearly and offer to find out. Never share sensitive information unless properly verified. Escalate to a human when appropriate.`);
+        }
+        if (!hasCustomTone) {
+            this.addSection('tone', `Use clear, concise language. Be friendly but professional. Avoid jargon unless the user demonstrates familiarity with it.`);
+        }
+        if (!hasCustomErrorHandling) {
+            this.addSection('error_handling', `When you encounter an error or cannot complete a request: 1) Acknowledge the issue clearly, 2) Don't guess or make up solutions, 3) Offer alternatives or suggest next steps.`);
+        }
+        if (!hasCustomCharNorm) {
+            this.addSection('character_normalization', `Normalize user input for speech recognition systems: 1) Convert email addresses to speakable format (at-sign as "at", dot as "dot"), 2) Spell out phone numbers digit by digit, 3) Format codes and IDs with spaces or pauses.`);
+        }
+        if (tools && !hasCustomTools) {
+            this.toolsSet(tools);
+        }
+        // Set injectTodayDateFlag to true by default in .default()
+        if (this.injectTodayDateFlag === true) {
+            // Flag is already true, do nothing
+        }
+        else if (this.injectTodayDateFlag === undefined) {
+            this.injectTodayDateFlag = true; // Enable by default in .default()
+        }
+        return this;
+    }
+    build() {
+        const guidelineSection = this.toolGuidelines.length > 0
+            ? {
+                type: 'custom',
+                content: this.formatToolGuidelines(),
+                priority: 80,
+            }
+            : null;
+        if (guidelineSection) {
+            this.sections.push(guidelineSection);
+        }
+        if (Object.keys(this.voiceRulesConfig).length > 0) {
+            const voiceRulesContent = this.formatVoiceRules();
+            this.addSection('voice_rules', voiceRulesContent, 65);
+        }
+        if (this.glossaryTerms.length > 0) {
+            const glossaryContent = this.formatGlossary();
+            this.addSection('glossary', glossaryContent, 55);
+        }
+        if (this.injectTodayDateFlag) {
+            const hasCustomSystemReminder = this.sections.some(s => s.type === 'system_reminder');
+            if (!hasCustomSystemReminder) {
+                const today = new Date().toLocaleDateString('en-US', {
+                    weekday: 'long',
+                    year: 'numeric',
+                    month: 'long',
+                    day: 'numeric',
+                });
+                this.addSection('system_reminder', `Today is ${today}.`, 25);
+            }
+        }
+        const requiredSections = ['personality', 'goal', 'guardrails'];
+        this.sections.sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+        return {
+            id: this.id,
+            name: this.name,
+            description: this.description,
+            sections: this.sections,
+            requiredSections,
+        };
+    }
+    addSection(type, content, priority) {
+        const existingIndex = this.sections.findIndex(s => s.type === type);
+        if (existingIndex !== -1) {
+            this.sections[existingIndex] = { type, content, priority };
+        }
+        else {
+            this.sections.push({ type, content, priority });
+        }
+    }
+    formatToolGuidelines() {
+        return `## Tool Usage Guidelines\n\n${this.toolGuidelines.map(g => `### ${g.name}\n**When to use:** ${g.whenToUse}\n\n**How to use:** ${g.howToUse}\n\n**Error handling:** ${g.errorHandling}`).join('\n\n---\n\n')}`;
+    }
+    formatVoiceRules() {
+        const rules = [];
+        const cfg = this.voiceRulesConfig;
+        rules.push('Your responses will be converted to speech. Follow these rules for natural TTS output:');
+        rules.push('## Formatting');
+        rules.push('1. **Punctuation**: Use proper punctuation at the end of every sentence.');
+        rules.push('2. **No special characters**: Avoid emojis, markdown formatting, or special unicode characters.');
+        rules.push('3. **No quotation marks**: Avoid unless explicitly quoting someone.\n');
+        rules.push('## Numbers & Dates');
+        if (cfg.formatDates === 'MM/DD/YYYY') {
+            rules.push('- **Dates**: Write as MM/DD/YYYY (e.g., "04/20/2023" not "April 20th").');
+        }
+        else if (cfg.formatDates === 'speakable') {
+            rules.push('- **Dates**: Speak in natural form (e.g., "April twentieth, twenty twenty-three").');
+        }
+        if (cfg.formatTimes === '12h') {
+            rules.push('- **Times**: Use 12-hour format with space before AM/PM (e.g., "7:00 PM" not "7:00PM").');
+        }
+        // useSpellTags defaults to false for cross-TTS compatibility (Cartesia-specific feature)
+        if (cfg.useSpellTags) {
+            rules.push('\n## Identifiers (Spelling)');
+            rules.push('- Wrap identifiers in <spell> tags:');
+            rules.push('  - Order numbers: "<spell>A1B2C3</spell>"');
+            rules.push('  - Phone numbers: "<spell>555-123-4567</spell>"');
+            rules.push('  - Confirmation codes: "<spell>XYZ789</spell>"');
+            rules.push('  - Email addresses: "<spell>user@example.com</spell>"');
+        }
+        else {
+            rules.push('\n## Identifiers');
+            rules.push('- Spell out identifiers digit by digit: "A one B two C three"');
+            rules.push('- Phone numbers: "five five five, one two three, four five six seven"');
+            rules.push('- Email addresses: "user at example dot com"');
+        }
+        if (cfg.urlFormat === 'dot') {
+            rules.push('\n## URLs & Emails');
+            rules.push('- Say "dot" instead of ".": "example dot com"');
+            rules.push('- Say "at" instead of "@": "user at example dot com"');
+        }
+        rules.push('\n## Pauses & Breaks');
+        if (cfg.useBreakTags) {
+            rules.push('- Use <break time="Xs"/> for pauses: "Let me check.<break time="1s"/>Okay..."');
+            rules.push('- Shorter breaks (200-500ms) between list items.');
+        }
+        else {
+            rules.push('- Use natural pauses with punctuation and dashes.');
+            rules.push('- Use "—" (em dash) for longer pauses in speech.');
+        }
+        if (cfg.useSpeedTags) {
+            rules.push('\n## Speaking Pace');
+            rules.push('- Use <speed ratio="0.8"/> for slow, clear explanations.');
+            rules.push('- Use <speed ratio="1.2"/> for quick summaries.');
+            rules.push('- Normal speed is ratio 1.0.');
+        }
+        if (cfg.useEmotionTags) {
+            rules.push('\n## Emotional Expression');
+            rules.push('- Use <emotion value="..."/> for tone: neutral, excited, sympathetic, curious, etc.');
+            rules.push('- Emotions: happy, excited, content, sad, scared, curious, sympathetic, calm.');
+            rules.push('- Match emotion to content - do not use conflicting tones.');
+        }
+        if (cfg.useLaughterTags) {
+            rules.push('\n## Nonverbal Sounds');
+            rules.push('- Use [laughter] to indicate laughing: "That is funny! [laughter]"');
+            rules.push('- Use sparingly for natural effect.');
+        }
+        if (cfg.verbalizeCurrency) {
+            rules.push('\n## Currency');
+            rules.push('- Say "five dollars" not "$5"');
+            rules.push('- Say "five ninety-nine" not "$5.99"');
+        }
+        if (cfg.verbalizeSymbols) {
+            rules.push('\n## Symbols');
+            rules.push('- Say "percent" not "%"');
+            rules.push('- Say "dollar" not "$"');
+            rules.push('- Say "equals" not "="');
+        }
+        if (cfg.customPronunciations) {
+            rules.push('\n## Custom Pronunciations');
+            for (const [word, pronunciation] of Object.entries(cfg.customPronunciations)) {
+                rules.push(`- "${word}" should be pronounced: "${pronunciation}"`);
+            }
+        }
+        rules.push('\n## Speaking Style');
+        rules.push('- Be concise and conversational.');
+        rules.push('- Use contractions (I\'m, you\'re, we\'ll).');
+        rules.push('- Avoid abbreviations: say "versus" not "vs.", "for example" not "e.g."');
+        rules.push('- For lists, use natural connectors: "first, second, third" not bullet points.');
+        return rules.filter(r => r.trim()).join('\n');
+    }
+    formatGlossary() {
+        if (this.glossaryTerms.length === 0) {
+            return '';
+        }
+        const lines = ['## Domain Glossary'];
+        lines.push('');
+        lines.push('The following terms have specific meanings in this context:');
+        lines.push('');
+        for (const term of this.glossaryTerms) {
+            lines.push(`### ${term.name}`);
+            lines.push(`**Description:** ${term.description}`);
+            if (term.synonyms && term.synonyms.length > 0) {
+                lines.push(`**Synonyms:** ${term.synonyms.join(', ')}`);
+            }
+            lines.push(''); // Blank line between terms
+        }
+        return lines.join('\n');
+    }
+}
+export function createPromptTemplate(id, name, configure) {
+    const builder = new PromptTemplateBuilder({ id, name });
+    configure(builder);
+    return builder.build();
+}
+//# sourceMappingURL=types.js.map