@ariaflowagents/core 0.7.0 → 0.8.1

package/dist/prompts/PromptBuilder.d.ts

@@ -1,9 +1,28 @@
-import type { PromptTemplate } from './types.js';
+import type { ToolSet } from '../tools/Tool.js';
+import type { PromptTemplate, PromptBuilderConfig, BrandVoiceConfig, KnowledgeContext, SessionMemory, AgentDefinition, PolicyProfile } from './types.js';
 export declare class PromptBuilder {
-    private template;
-    constructor(template: PromptTemplate);
+    private config;
+    /**
+     * Accepts either:
+     * - PromptBuilderConfig (new fluent API)
+     * - PromptTemplate (backward compatible - treated as user template sections)
+     */
+    constructor(config?: PromptBuilderConfig | PromptTemplate);
+    withTemplate(template: PromptTemplate): this;
+    withAgentDefinition(definition: AgentDefinition): this;
+    withBrandVoice(brandVoice: BrandVoiceConfig): this;
+    withTools(tools: ToolSet): this;
+    withSessionMemory(memory: SessionMemory): this;
+    withKnowledgeContext(context: KnowledgeContext): this;
+    withPolicyProfile(profile: PolicyProfile): this;
     build(): string;
+    private buildAgentDefinitionSections;
+    private buildBrandVoiceSections;
+    private buildKnowledgeSections;
+    private buildToolsSections;
+    private buildSessionMemorySections;
     private formatSection;
     private getHeader;
 }
+export declare function createPrompt(): PromptBuilder;
 //# sourceMappingURL=PromptBuilder.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PromptBuilder.d.ts","sourceRoot":"","sources":["../../src/prompts/PromptBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhE,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAiB;gBAErB,QAAQ,EAAE,cAAc;IAIpC,KAAK,IAAI,MAAM;IASf,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,SAAS;CAkBlB"}
+{"version":3,"file":"PromptBuilder.d.ts","sourceRoot":"","sources":["../../src/prompts/PromptBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAEV,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAKpB,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAsB;IAEpC;;;;OAIG;gBACS,MAAM,GAAE,mBAAmB,GAAG,cAAmB;IAS7D,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAK5C,mBAAmB,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAKtD,cAAc,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAKlD,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAK/B,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAK9C,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAKrD,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAO/C,KAAK,IAAI,MAAM;IAyDf,OAAO,CAAC,4BAA4B;IA2BpC,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,sBAAsB;IA+C9B,OAAO,CAAC,kBAAkB;IA6B1B,OAAO,CAAC,0BAA0B;IAwClC,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,SAAS;CAmClB;AAGD,wBAAgB,YAAY,IAAI,aAAa,CAE5C"}

package/dist/prompts/PromptBuilder.js

@@ -1,15 +1,223 @@
+import { LAYER_PRIORITIES } from './types.js';
+import { getSecurityCore, SECURITY_REMINDER } from './security.js';
+import { buildBrandVoiceSection } from './brandVoice.js';
 export class PromptBuilder {
-    template;
-    constructor(template) {
-        this.template = template;
+    config;
+    /**
+     * Accepts either:
+     * - PromptBuilderConfig (new fluent API)
+     * - PromptTemplate (backward compatible - treated as user template sections)
+     */
+    constructor(config = {}) {
+        // Handle backward compatibility: if it's a PromptTemplate, wrap it
+        if ('sections' in config && 'id' in config) {
+            this.config = { template: config };
+        }
+        else {
+            this.config = config;
+        }
+    }
+    withTemplate(template) {
+        this.config.template = template;
+        return this;
+    }
+    withAgentDefinition(definition) {
+        this.config.agentDefinition = definition;
+        return this;
+    }
+    withBrandVoice(brandVoice) {
+        this.config.brandVoice = brandVoice;
+        return this;
+    }
+    withTools(tools) {
+        this.config.tools = tools;
+        return this;
+    }
+    withSessionMemory(memory) {
+        this.config.sessionMemory = memory;
+        return this;
+    }
+    withKnowledgeContext(context) {
+        this.config.knowledgeContext = context;
+        return this;
+    }
+    withPolicyProfile(profile) {
+        this.config.policyProfile = profile;
+        return this;
     }
     build() {
-        const sortedSections = [...this.template.sections].sort((a, b) => {
-            const pA = a.priority ?? 100;
-            const pB = b.priority ?? 100;
-            return pA - pB;
+        const sections = [];
+        // Layer 0: Security Core (IMMUTABLE - always first)
+        sections.push({
+            type: 'security_core',
+            content: getSecurityCore(this.config.policyProfile ?? 'minimal'),
+            priority: LAYER_PRIORITIES.SECURITY_CORE.min,
+            immutable: true,
+        });
+        // Layer 1: Agent Definition
+        if (this.config.agentDefinition) {
+            sections.push(...this.buildAgentDefinitionSections());
+        }
+        // Layer 2: Brand Voice
+        if (this.config.brandVoice) {
+            sections.push(...this.buildBrandVoiceSections());
+        }
+        // User Template Sections (priority 10-99)
+        if (this.config.template) {
+            sections.push(...this.config.template.sections);
+        }
+        // Layer 3: Knowledge & Grounding
+        if (this.config.knowledgeContext) {
+            sections.push(...this.buildKnowledgeSections());
+        }
+        // Layer 4: Tools & Actions (auto)
+        if (this.config.tools && Object.keys(this.config.tools).length > 0) {
+            sections.push(...this.buildToolsSections());
+        }
+        // Layer 5: Session Memory (auto)
+        if (this.config.sessionMemory) {
+            sections.push(...this.buildSessionMemorySections());
+        }
+        // Layer 6: Security Reminder (IMMUTABLE - always last)
+        sections.push({
+            type: 'security_reminder',
+            content: SECURITY_REMINDER,
+            priority: LAYER_PRIORITIES.SECURITY_REMINDER,
+            immutable: true,
+        });
+        // Sort by priority
+        const sorted = sections.sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+        return sorted.map(s => this.formatSection(s)).join('\n\n');
+    }
+    buildAgentDefinitionSections() {
+        const def = this.config.agentDefinition;
+        const sections = [];
+        sections.push({
+            type: 'identity',
+            content: def.identity,
+            priority: LAYER_PRIORITIES.IDENTITY,
         });
-        return sortedSections.map(section => this.formatSection(section)).join('\n\n');
+        sections.push({
+            type: 'role',
+            content: def.role,
+            priority: LAYER_PRIORITIES.ROLE,
+        });
+        if (def.capabilities?.length) {
+            sections.push({
+                type: 'capabilities',
+                content: `## Capabilities\n${def.capabilities.map(c => `- ${c}`).join('\n')}`,
+                priority: 18,
+            });
+        }
+        return sections;
+    }
+    buildBrandVoiceSections() {
+        const voice = this.config.brandVoice;
+        return [{
+                type: 'brand_voice',
+                content: buildBrandVoiceSection(voice),
+                priority: LAYER_PRIORITIES.BRAND_VOICE,
+            }];
+    }
+    buildKnowledgeSections() {
+        const knowledge = this.config.knowledgeContext;
+        const sections = [];
+        // Retrieved context (RAG/CAG)
+        if (knowledge.retrieved) {
+            sections.push({
+                type: 'knowledge',
+                content: `## Knowledge Context\n\n${knowledge.retrieved}`,
+                priority: LAYER_PRIORITIES.KNOWLEDGE,
+            });
+        }
+        // Business rules
+        if (knowledge.businessRules?.length) {
+            sections.push({
+                type: 'business_rules',
+                content: `## Business Rules\n\n${knowledge.businessRules.map(r => `- ${r}`).join('\n')}`,
+                priority: LAYER_PRIORITIES.BUSINESS_RULES,
+            });
+        }
+        // Grounding rules (always included)
+        sections.push({
+            type: 'grounding_rules',
+            content: `## Grounding Rules
+- Only state facts that are supported by the knowledge context or tool results.
+- If information is not available, say so clearly rather than guessing.
+- When citing information, reference the source naturally.`,
+            priority: LAYER_PRIORITIES.GROUNDING_RULES,
+        });
+        // Glossary
+        if (knowledge.glossary?.length) {
+            const glossaryContent = knowledge.glossary
+                .map(t => `- **${t.name}**: ${t.description}${t.synonyms ? ` (also: ${t.synonyms.join(', ')})` : ''}`)
+                .join('\n');
+            sections.push({
+                type: 'glossary',
+                content: `## Glossary\n\n${glossaryContent}`,
+                priority: LAYER_PRIORITIES.GLOSSARY,
+            });
+        }
+        return sections;
+    }
+    buildToolsSections() {
+        const tools = this.config.tools;
+        const sections = [];
+        const toolDescriptions = Object.entries(tools)
+            .map(([name, tool]) => {
+            const desc = 'description' in tool ? String(tool.description) : '';
+            return `### ${name}\n${desc}`;
+        })
+            .join('\n\n');
+        sections.push({
+            type: 'tools',
+            content: `## Available Tools\n\n${toolDescriptions}`,
+            priority: LAYER_PRIORITIES.TOOLS,
+        });
+        sections.push({
+            type: 'tool_contract',
+            content: `## Tool Usage Rules
+- Only use tools that are available.
+- Report tool failures honestly.
+- For critical operations, verify success before confirming to the user.`,
+            priority: LAYER_PRIORITIES.TOOL_CONTRACT,
+        });
+        return sections;
+    }
+    buildSessionMemorySections() {
+        const memory = this.config.sessionMemory;
+        const sections = [];
+        // Flow progress
+        if (memory.flowProgress) {
+            const collectedData = Object.keys(memory.flowProgress.collectedData).length > 0
+                ? `\n**Collected Data:**\n${JSON.stringify(memory.flowProgress.collectedData, null, 2)}`
+                : '';
+            sections.push({
+                type: 'flow_context',
+                content: `## Current Flow State\n**Current Step:** ${memory.flowProgress.currentNode}${collectedData}`,
+                priority: LAYER_PRIORITIES.FLOW_CONTEXT,
+            });
+        }
+        // Conversation state
+        if (memory.conversationState && Object.keys(memory.conversationState).length > 0) {
+            sections.push({
+                type: 'session_state',
+                content: `## Session State\n\`\`\`json\n${JSON.stringify(memory.conversationState, null, 2)}\n\`\`\``,
+                priority: LAYER_PRIORITIES.SESSION_STATE,
+            });
+        }
+        // Working memory (injection queue)
+        if (memory.workingMemory?.length) {
+            const workingContent = memory.workingMemory
+                .map(w => `### ${w.label}\n${w.content}`)
+                .join('\n\n');
+            sections.push({
+                type: 'conversation_summary',
+                content: `## Context\n\n${workingContent}`,
+                priority: LAYER_PRIORITIES.CONVERSATION_SUMMARY,
+            });
+        }
+        return sections;
     }
     formatSection(section) {
         const header = this.getHeader(section.type);
@@ -21,21 +229,42 @@ export class PromptBuilder {
     }
     getHeader(type) {
         const headers = {
+            // Security layers
+            security_core: '# Security Core',
+            security_reminder: '# Final Check',
+            // Agent definition
+            identity: '# Identity',
+            role: '# Role',
+            capabilities: '# Capabilities',
+            // Brand voice
+            brand_voice: '# Brand Voice',
+            tone: '# Tone',
             personality: '# Personality',
-            goal: '# Goal',
-            guardrails: '# Guardrails',
+            // Knowledge & grounding
+            knowledge: '# Knowledge Context',
+            grounding_rules: '# Grounding Rules',
+            business_rules: '# Business Rules',
+            // Tools
             tools: '# Tools',
-            tone: '# Tone',
+            tool_contract: '# Tool Usage',
+            // Session memory
+            session_state: '# Session State',
+            flow_context: '# Flow Context',
+            conversation_summary: '# Context',
+            // Legacy
             character_normalization: '# Character Normalization',
             voice_rules: '# Voice Output Rules',
-            glossary: '# Glossary',
             system_reminder: '# System Reminder',
             error_handling: '# Error Handling',
             brief_speech: '# Response Style',
             handoff: '',
-            custom: '', // Custom sections include their own header in content
+            custom: '',
         };
         return headers[type] || '# Custom';
     }
 }
+// Fluent builder factory
+export function createPrompt() {
+    return new PromptBuilder();
+}
 //# sourceMappingURL=PromptBuilder.js.map

package/dist/prompts/PromptBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"PromptBuilder.js","sourceRoot":"","sources":["../../src/prompts/PromptBuilder.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IAChB,QAAQ,CAAiB;IAEjC,YAAY,QAAwB;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC/D,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;YAC7B,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;YAC7B,OAAO,EAAE,GAAG,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,OAAO,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjF,CAAC;IAEO,aAAa,CAAC,OAAsB;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,kEAAkE;QAClE,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5D,OAAO,OAAO,CAAC,OAAO,CAAC;QACzB,CAAC;QACD,OAAO,GAAG,MAAM,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3C,CAAC;IAEO,SAAS,CAAC,IAA2B;QAC3C,MAAM,OAAO,GAA2B;YACtC,WAAW,EAAE,eAAe;YAC5B,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,cAAc;YAC1B,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,QAAQ;YACd,uBAAuB,EAAE,2BAA2B;YACpD,WAAW,EAAE,sBAAsB;YACnC,QAAQ,EAAE,YAAY;YACtB,eAAe,EAAE,mBAAmB;YACpC,cAAc,EAAE,kBAAkB;YAClC,YAAY,EAAE,kBAAkB;YAChC,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,EAAE,EAAE,sDAAsD;SACnE,CAAC;QACF,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC;IACrC,CAAC;CACF"}
+{"version":3,"file":"PromptBuilder.js","sourceRoot":"","sources":["../../src/prompts/PromptBuilder.ts"],"names":[],"mappings":"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"}

package/dist/prompts/PromptRenderer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * PromptRenderer — Pure functions that render resolved prompt sections to a string.
+ *
+ * Handles XML tag wrapping, token budgeting (trimming shrinkable sections in
+ * reverse priority order), and security validation.
+ *
+ * @module
+ */
+import type { ResolvedSection } from './PromptAssembly.js';
+/**
+ * Options controlling how resolved sections are rendered to a final string.
+ */
+export interface RenderOptions {
+    /** Maximum token budget for the rendered prompt. If exceeded, shrinkable sections are trimmed. */
+    maxTokens?: number;
+    /** Whether to wrap each section in XML tags. Defaults to true. */
+    useXmlTags?: boolean;
+    /** Whether to validate that security sections (security_core, security_reminder) exist. Defaults to true. */
+    validateSecurity?: boolean;
+}
+/**
+ * Thrown when prompt validation fails (e.g. missing security sections).
+ */
+export declare class PromptValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Renders an array of resolved sections into a single prompt string.
+ *
+ * Behavior:
+ * 1. Filters out sections with empty content.
+ * 2. Validates that security sections exist (if `validateSecurity` is true).
+ * 3. If total tokens exceed `maxTokens`, trims shrinkable sections in
+ *    **reverse** priority order (lowest priority trimmed first — so knowledge,
+ *    memory, and tools are trimmed before role/instructions).
+ * 4. Wraps each section in `<tag>\ncontent\n</tag>` when `useXmlTags` is true.
+ *
+ * @param sections - Pre-sorted resolved sections (ascending priority).
+ * @param options  - Render options.
+ * @returns The assembled prompt string.
+ */
+export declare function renderSections(sections: ResolvedSection[], options?: RenderOptions): string;
+//# sourceMappingURL=PromptRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PromptRenderer.d.ts","sourceRoot":"","sources":["../../src/prompts/PromptRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6GAA6G;IAC7G,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAMD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,eAAe,EAAE,EAC3B,OAAO,GAAE,aAAkB,GAC1B,MAAM,CA2CR"}

package/dist/prompts/PromptRenderer.js

@@ -0,0 +1,114 @@
+/**
+ * PromptRenderer — Pure functions that render resolved prompt sections to a string.
+ *
+ * Handles XML tag wrapping, token budgeting (trimming shrinkable sections in
+ * reverse priority order), and security validation.
+ *
+ * @module
+ */
+import { estimateTokenCount, truncateToTokenBudget } from '../runtime/ContextBudget.js';
+// ============================================
+// Error
+// ============================================
+/**
+ * Thrown when prompt validation fails (e.g. missing security sections).
+ */
+export class PromptValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PromptValidationError';
+    }
+}
+// ============================================
+// Render
+// ============================================
+/**
+ * Renders an array of resolved sections into a single prompt string.
+ *
+ * Behavior:
+ * 1. Filters out sections with empty content.
+ * 2. Validates that security sections exist (if `validateSecurity` is true).
+ * 3. If total tokens exceed `maxTokens`, trims shrinkable sections in
+ *    **reverse** priority order (lowest priority trimmed first — so knowledge,
+ *    memory, and tools are trimmed before role/instructions).
+ * 4. Wraps each section in `<tag>\ncontent\n</tag>` when `useXmlTags` is true.
+ *
+ * @param sections - Pre-sorted resolved sections (ascending priority).
+ * @param options  - Render options.
+ * @returns The assembled prompt string.
+ */
+export function renderSections(sections, options = {}) {
+    const { maxTokens, useXmlTags = true, validateSecurity = true, } = options;
+    // Filter empty sections
+    let active = sections.filter((s) => s.content.trim().length > 0);
+    // Validate security
+    if (validateSecurity) {
+        const hasSecurityCore = active.some((s) => s.type === 'security_core');
+        const hasSecurityReminder = active.some((s) => s.type === 'security_reminder');
+        if (!hasSecurityCore) {
+            throw new PromptValidationError('Missing required security_core section. ' +
+                'Disable security validation with { validateSecurity: false } if intentional.');
+        }
+        if (!hasSecurityReminder) {
+            throw new PromptValidationError('Missing required security_reminder section. ' +
+                'Disable security validation with { validateSecurity: false } if intentional.');
+        }
+    }
+    // Token budgeting — trim shrinkable sections in reverse priority order
+    if (maxTokens && maxTokens > 0) {
+        active = applyTokenBudget(active, maxTokens);
+    }
+    // Render each section
+    const rendered = active.map((section) => {
+        if (useXmlTags) {
+            return `<${section.tag}>\n${section.content}\n</${section.tag}>`;
+        }
+        return section.content;
+    });
+    return rendered.join('\n\n');
+}
+// ============================================
+// Internal
+// ============================================
+/**
+ * Applies token budgeting by trimming shrinkable sections.
+ *
+ * Strategy: iterate sections from lowest priority (highest priority number)
+ * to highest priority (lowest priority number). For each shrinkable section
+ * whose removal or truncation would bring the total under budget, truncate it.
+ */
+function applyTokenBudget(sections, maxTokens) {
+    let totalTokens = sections.reduce((sum, s) => sum + s.estimatedTokens, 0);
+    if (totalTokens <= maxTokens)
+        return sections;
+    // Work on a mutable copy, iterate from lowest priority (end) to highest (start).
+    const result = [...sections];
+    // Build indices sorted by priority descending (lowest priority = highest number first)
+    const indices = result
+        .map((_, i) => i)
+        .sort((a, b) => result[b].priority - result[a].priority);
+    for (const idx of indices) {
+        if (totalTokens <= maxTokens)
+            break;
+        const section = result[idx];
+        if (!section.shrinkable)
+            continue;
+        const excess = totalTokens - maxTokens;
+        const newBudget = Math.max(0, section.estimatedTokens - excess);
+        if (newBudget <= 0) {
+            // Remove the section entirely
+            totalTokens -= section.estimatedTokens;
+            result[idx] = { ...section, content: '', estimatedTokens: 0 };
+        }
+        else {
+            // Truncate to remaining budget
+            const truncated = truncateToTokenBudget(section.content, newBudget);
+            const newTokens = estimateTokenCount(truncated);
+            totalTokens -= section.estimatedTokens - newTokens;
+            result[idx] = { ...section, content: truncated, estimatedTokens: newTokens };
+        }
+    }
+    // Filter out emptied sections
+    return result.filter((s) => s.content.trim().length > 0);
+}
+//# sourceMappingURL=PromptRenderer.js.map

package/dist/prompts/PromptRenderer.js.map

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

package/dist/prompts/brandVoice.d.ts

@@ -0,0 +1,10 @@
+import type { BrandVoiceConfig } from './types.js';
+export interface BrandVoiceTemplate {
+    tone: string;
+    styleRules: string[];
+    avoidPhrases: string[];
+    emojiPolicy: 'never' | 'minimal' | 'moderate' | 'encouraged';
+}
+export declare const BRAND_VOICE_TEMPLATES: Record<Exclude<BrandVoiceConfig['tone'], 'custom' | undefined>, BrandVoiceTemplate>;
+export declare function buildBrandVoiceSection(config: BrandVoiceConfig): string;
+//# sourceMappingURL=brandVoice.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brandVoice.d.ts","sourceRoot":"","sources":["../../src/prompts/brandVoice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;CAC9D;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC,EAAE,kBAAkB,CAyCrH,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAoDvE"}

package/dist/prompts/brandVoice.js

@@ -0,0 +1,87 @@
+export const BRAND_VOICE_TEMPLATES = {
+    formal: {
+        tone: 'Professional and respectful. Use complete sentences and proper grammar.',
+        styleRules: [
+            'Address customers formally (use "you" respectfully)',
+            'Avoid contractions in serious contexts',
+            'Be precise and factual',
+        ],
+        avoidPhrases: ['No problem', 'Cool', 'Awesome', 'Yeah', 'Hey'],
+        emojiPolicy: 'never',
+    },
+    casual: {
+        tone: 'Friendly and conversational. Natural, human-like communication.',
+        styleRules: [
+            'Use contractions freely',
+            'Keep it light and approachable',
+            'Match customer energy level',
+        ],
+        avoidPhrases: ['Pursuant to', 'Please be advised', 'Kindly', 'At your earliest convenience'],
+        emojiPolicy: 'moderate',
+    },
+    friendly: {
+        tone: 'Warm and helpful. Balance professionalism with approachability.',
+        styleRules: [
+            'Be personable but not overly casual',
+            'Show empathy in responses',
+            'Use natural conversational language',
+        ],
+        avoidPhrases: ['As per our policy', 'Unfortunately', 'We regret to inform'],
+        emojiPolicy: 'minimal',
+    },
+    professional: {
+        tone: 'Competent and reliable. Clear, efficient communication.',
+        styleRules: [
+            'Be direct and solution-focused',
+            'Avoid unnecessary flourishes',
+            'Maintain professional boundaries',
+        ],
+        avoidPhrases: ['LOL', 'OMG', 'TBH', 'fr', 'omg'],
+        emojiPolicy: 'never',
+    },
+};
+export function buildBrandVoiceSection(config) {
+    const template = config.tone && config.tone !== 'custom' ? BRAND_VOICE_TEMPLATES[config.tone] : null;
+    const parts = [];
+    // Tone
+    const tone = config.toneCustom ?? template?.tone ?? config.tone ?? 'Professional and helpful';
+    parts.push(`**Tone:** ${tone}`);
+    // Personality
+    if (config.personality) {
+        parts.push(`**Personality:** ${config.personality}`);
+    }
+    // Style rules
+    const styleRules = config.styleRules ?? template?.styleRules ?? [];
+    if (styleRules.length > 0) {
+        parts.push(`**Style Guidelines:**\n${styleRules.map(r => `- ${r}`).join('\n')}`);
+    }
+    // Avoid phrases
+    const avoidPhrases = config.avoidPhrases ?? template?.avoidPhrases ?? [];
+    if (avoidPhrases.length > 0) {
+        parts.push(`**Avoid saying:** ${avoidPhrases.join(', ')}`);
+    }
+    // Preferred phrases
+    if (config.preferredPhrases?.length) {
+        parts.push(`**Preferred phrases:** ${config.preferredPhrases.join(', ')}`);
+    }
+    // Emoji policy
+    const emojiPolicy = config.emojiPolicy ?? template?.emojiPolicy ?? 'never';
+    const emojiGuidance = {
+        never: 'Do not use emojis.',
+        minimal: 'Use emojis sparingly, only when appropriate (e.g., simple smiley).',
+        moderate: 'Emojis are acceptable to convey tone and warmth.',
+        encouraged: 'Use emojis freely to enhance friendly communication.',
+    };
+    parts.push(`**Emoji usage:** ${emojiGuidance[emojiPolicy]}`);
+    // Response length
+    if (config.responseLength) {
+        const lengthGuidance = {
+            brief: 'Keep responses short and to the point. One to two sentences when possible.',
+            moderate: 'Balance brevity with completeness. Include necessary details but avoid verbosity.',
+            detailed: 'Provide thorough, comprehensive responses. Cover all relevant aspects.',
+        };
+        parts.push(`**Response length:** ${lengthGuidance[config.responseLength]}`);
+    }
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=brandVoice.js.map

package/dist/prompts/brandVoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brandVoice.js","sourceRoot":"","sources":["../../src/prompts/brandVoice.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,qBAAqB,GAAwF;IACxH,MAAM,EAAE;QACN,IAAI,EAAE,yEAAyE;QAC/E,UAAU,EAAE;YACV,qDAAqD;YACrD,wCAAwC;YACxC,wBAAwB;SACzB;QACD,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC;QAC9D,WAAW,EAAE,OAAO;KACrB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,iEAAiE;QACvE,UAAU,EAAE;YACV,yBAAyB;YACzB,gCAAgC;YAChC,6BAA6B;SAC9B;QACD,YAAY,EAAE,CAAC,aAAa,EAAE,mBAAmB,EAAE,QAAQ,EAAE,8BAA8B,CAAC;QAC5F,WAAW,EAAE,UAAU;KACxB;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,iEAAiE;QACvE,UAAU,EAAE;YACV,qCAAqC;YACrC,2BAA2B;YAC3B,qCAAqC;SACtC;QACD,YAAY,EAAE,CAAC,mBAAmB,EAAE,eAAe,EAAE,qBAAqB,CAAC;QAC3E,WAAW,EAAE,SAAS;KACvB;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,yDAAyD;QAC/D,UAAU,EAAE;YACV,gCAAgC;YAChC,8BAA8B;YAC9B,kCAAkC;SACnC;QACD,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC;QAChD,WAAW,EAAE,OAAO;KACrB;CACF,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,MAAwB;IAC7D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAErG,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,OAAO;IACP,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,IAAI,QAAQ,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,0BAA0B,CAAC;IAC9F,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IAEhC,cAAc;IACd,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,cAAc;IACd,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAC;IACnE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,0BAA0B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,gBAAgB;IAChB,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,QAAQ,EAAE,YAAY,IAAI,EAAE,CAAC;IACzE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,qBAAqB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,oBAAoB;IACpB,IAAI,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,0BAA0B,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,eAAe;IACf,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,QAAQ,EAAE,WAAW,IAAI,OAAO,CAAC;IAC3E,MAAM,aAAa,GAAuC;QACxD,KAAK,EAAE,oBAAoB;QAC3B,OAAO,EAAE,oEAAoE;QAC7E,QAAQ,EAAE,kDAAkD;QAC5D,UAAU,EAAE,sDAAsD;KACnE,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,oBAAoB,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAE7D,kBAAkB;IAClB,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,MAAM,cAAc,GAAiD;YACnE,KAAK,EAAE,4EAA4E;YACnF,QAAQ,EAAE,mFAAmF;YAC7F,QAAQ,EAAE,wEAAwE;SACnF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,wBAAwB,cAAc,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/prompts/index.d.ts

@@ -1,7 +1,14 @@
-export type { PromptSection, PromptTemplate, ToolGuideline, PromptTemplateBuilderOptions } from './types.js';
-export { PromptTemplateBuilder, createPromptTemplate } from './types.js';
-export type { PromptSectionType, VoiceRulesConfig, VoiceRules, GlossaryTerm, GlossaryConfig } from './types.js';
-export { PromptBuilder } from './PromptBuilder.js';
+export type { PromptSection, PromptTemplate, ToolGuideline, PromptTemplateBuilderOptions, PromptSectionType, VoiceRulesConfig, VoiceRules, GlossaryTerm, GlossaryConfig, BrandVoiceConfig, KnowledgeContext, SessionMemory, AgentDefinition, PolicyProfile, PromptBuilderConfig, } from './types.js';
+export { PromptTemplateBuilder, createPromptTemplate, LAYER_PRIORITIES } from './types.js';
+export { PromptBuilder, createPrompt } from './PromptBuilder.js';
 export { SUPPORT_AGENT_TEMPLATE, SALES_AGENT_TEMPLATE, TRIAGE_AGENT_TEMPLATE, createSupportAgentTemplate, BUILTIN_TEMPLATES, DEFAULT_HANDOFF_INSTRUCTION, } from './templates.js';
 export { getTemplate, registerTemplate, listTemplates, getAllTemplates } from './registry.js';
+export { getSecurityCore, SECURITY_REMINDER } from './security.js';
+export { buildBrandVoiceSection, BRAND_VOICE_TEMPLATES } from './brandVoice.js';
+export { PromptAssembly, PromptSecurityViolationError } from './PromptAssembly.js';
+export type { PromptSectionConfig, ResolvedSection, AssemblyDebugInfo } from './PromptAssembly.js';
+export { renderSections, PromptValidationError } from './PromptRenderer.js';
+export type { RenderOptions } from './PromptRenderer.js';
+export { AgentPrompt } from './AgentPrompt.js';
+export type { AgentPromptConfig } from './AgentPrompt.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC7G,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAChH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,4BAA4B,EAC5B,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,aAAa,EACb,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnF,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}