@ariaflowagents/core 0.7.0 → 0.8.1

package/dist/prompts/AgentPrompt.js

@@ -0,0 +1,373 @@
+/**
+ * AgentPrompt — Developer-facing class for structured prompt assembly.
+ *
+ * Provides a chainable API for composing agent prompts with automatic
+ * security sandwiching, priority-based ordering, and XML-tagged rendering.
+ *
+ * @example
+ * ```ts
+ * const prompt = new AgentPrompt()
+ *   .role('You are a helpful customer support agent.')
+ *   .instructions('Help customers with billing and account issues.')
+ *   .guardrails('Never share internal pricing or discount formulas.')
+ *   .knowledge(async () => fetchKnowledgeBase())
+ *   .tools(myToolSet);
+ *
+ * const systemPrompt = await prompt.render();
+ * ```
+ *
+ * @module
+ */
+import { getSecurityCore, SECURITY_REMINDER } from './security.js';
+import { PromptAssembly } from './PromptAssembly.js';
+import { renderSections } from './PromptRenderer.js';
+// ============================================
+// AgentPrompt
+// ============================================
+/**
+ * Developer-facing prompt builder with a chainable API.
+ *
+ * Internally creates a {@link PromptAssembly}, injects security core (priority 0)
+ * and security reminder (priority 1000), then freezes security bands.
+ *
+ * All chainable methods accept either a static string or an async function
+ * that resolves to a string.
+ */
+export class AgentPrompt {
+    _assembly;
+    renderOptions;
+    constructor(config = {}) {
+        const { policy = 'minimal', xmlTags = true, maxTokens, disableSecurity = false, } = config;
+        this._assembly = new PromptAssembly();
+        this.renderOptions = {
+            useXmlTags: xmlTags,
+            maxTokens,
+            validateSecurity: !disableSecurity,
+        };
+        if (!disableSecurity) {
+            this._assembly.addSection({
+                type: 'security_core',
+                content: getSecurityCore(policy),
+                priority: 0,
+                shrinkable: false,
+                tag: 'security_core',
+                source: 'security',
+            });
+            this._assembly.addSection({
+                type: 'security_reminder',
+                content: SECURITY_REMINDER,
+                priority: 1000,
+                shrinkable: false,
+                tag: 'security_reminder',
+                source: 'security',
+            });
+            this._assembly.freeze();
+        }
+    }
+    // ============================================
+    // Chainable section methods
+    // ============================================
+    /**
+     * Sets the agent's role description. Priority 10, non-shrinkable.
+     */
+    role(content) {
+        this._assembly.addSection({
+            type: 'role',
+            content,
+            priority: 10,
+            shrinkable: false,
+            tag: 'role',
+            source: 'developer',
+        });
+        return this;
+    }
+    /**
+     * Sets the agent's instructions. Priority 15, non-shrinkable.
+     */
+    instructions(content) {
+        this._assembly.addSection({
+            type: 'instructions',
+            content,
+            priority: 15,
+            shrinkable: false,
+            tag: 'instructions',
+            source: 'developer',
+        });
+        return this;
+    }
+    /**
+     * Sets guardrail rules. Priority 20, non-shrinkable.
+     */
+    guardrails(content) {
+        this._assembly.addSection({
+            type: 'guardrails',
+            content,
+            priority: 20,
+            shrinkable: false,
+            tag: 'guardrails',
+            source: 'developer',
+        });
+        return this;
+    }
+    /**
+     * Sets voice/personality description. Priority 25, shrinkable.
+     */
+    voice(content) {
+        this._assembly.addSection({
+            type: 'voice',
+            content,
+            priority: 25,
+            shrinkable: true,
+            tag: 'voice',
+            source: 'developer',
+        });
+        return this;
+    }
+    /**
+     * Injects knowledge context. Priority 30, shrinkable.
+     */
+    knowledge(content) {
+        this._assembly.addSection({
+            type: 'knowledge',
+            content,
+            priority: 30,
+            shrinkable: true,
+            tag: 'knowledge',
+            source: 'developer',
+        });
+        return this;
+    }
+    /**
+     * Sets business/domain rules. Priority 35, shrinkable.
+     */
+    rules(content) {
+        this._assembly.addSection({
+            type: 'rules',
+            content,
+            priority: 35,
+            shrinkable: true,
+            tag: 'rules',
+            source: 'developer',
+        });
+        return this;
+    }
+    /**
+     * Adds a glossary of domain terms. Priority 38, shrinkable.
+     * Terms are auto-formatted into a structured list.
+     */
+    glossary(terms) {
+        const content = formatGlossary(terms);
+        this._assembly.addSection({
+            type: 'glossary',
+            content,
+            priority: 38,
+            shrinkable: true,
+            tag: 'glossary',
+            source: 'developer',
+        });
+        return this;
+    }
+    /**
+     * Generates tool descriptions from a ToolSet. Priority 40, shrinkable.
+     */
+    tools(toolSet) {
+        const content = formatToolDescriptions(toolSet);
+        this._assembly.addSection({
+            type: 'tools',
+            content,
+            priority: 40,
+            shrinkable: true,
+            tag: 'tools',
+            source: 'developer',
+        });
+        return this;
+    }
+    /**
+     * Sets voice/TTS output rules. Priority 45, shrinkable.
+     * Uses the same formatting logic as PromptTemplateBuilder.formatVoiceRules.
+     */
+    voiceRules(config) {
+        const content = formatVoiceRules(config);
+        this._assembly.addSection({
+            type: 'voice_rules',
+            content,
+            priority: 45,
+            shrinkable: true,
+            tag: 'voice_rules',
+            source: 'developer',
+        });
+        return this;
+    }
+    /**
+     * Adds example interactions or few-shot prompts. Priority 50, shrinkable.
+     */
+    examples(content) {
+        this._assembly.addSection({
+            type: 'examples',
+            content,
+            priority: 50,
+            shrinkable: true,
+            tag: 'examples',
+            source: 'developer',
+        });
+        return this;
+    }
+    /**
+     * Adds an arbitrary named section. Defaults to priority 60, shrinkable.
+     */
+    section(type, content, priority = 60) {
+        this._assembly.addSection({
+            type,
+            content,
+            priority,
+            shrinkable: true,
+            tag: type,
+            source: 'developer',
+        });
+        return this;
+    }
+    // ============================================
+    // Render & Debug
+    // ============================================
+    /**
+     * Resolves all sections and renders the prompt to a string.
+     */
+    async render() {
+        const resolved = await this._assembly.resolve();
+        return renderSections(resolved, this.renderOptions);
+    }
+    /**
+     * Returns debug information about the assembly's current state.
+     */
+    async debug() {
+        return this._assembly.debug();
+    }
+    /**
+     * Exposes the underlying PromptAssembly for runtime injection.
+     */
+    get assembly() {
+        return this._assembly;
+    }
+}
+// ============================================
+// Formatters (internal)
+// ============================================
+/** Formats glossary terms into a readable list. */
+function formatGlossary(terms) {
+    if (terms.length === 0)
+        return '';
+    const lines = ['## Domain Glossary', ''];
+    lines.push('The following terms have specific meanings in this context:');
+    lines.push('');
+    for (const term of terms) {
+        lines.push(`### ${term.name}`);
+        lines.push(`**Description:** ${term.description}`);
+        if (term.synonyms && term.synonyms.length > 0) {
+            lines.push(`**Synonyms:** ${term.synonyms.join(', ')}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/** Formats a ToolSet into readable tool descriptions. */
+function formatToolDescriptions(toolSet) {
+    const entries = Object.entries(toolSet);
+    if (entries.length === 0)
+        return '';
+    const descriptions = entries.map(([name, tool]) => {
+        const desc = 'description' in tool ? String(tool.description) : '';
+        return `### ${name}\n${desc}`;
+    });
+    return `## Available Tools\n\n${descriptions.join('\n\n')}`;
+}
+/**
+ * Formats voice rules configuration into a structured text block.
+ * Logic ported from PromptTemplateBuilder.formatVoiceRules.
+ */
+function formatVoiceRules(cfg) {
+    const rules = [];
+    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").');
+    }
+    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 "\u2014" (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');
+}
+//# sourceMappingURL=AgentPrompt.js.map

package/dist/prompts/AgentPrompt.js.map

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

package/dist/prompts/PromptAssembly.d.ts

@@ -0,0 +1,119 @@
+/**
+ * PromptAssembly — Structured intermediate representation for prompt sections.
+ *
+ * Sections are stored in a Map keyed by type (except 'custom' which uses an array).
+ * Security-band sections (priority 0-9 or 1000+) are frozen after `freeze()` is called.
+ *
+ * @module
+ */
+/**
+ * Configuration for a single prompt section.
+ * Content can be a static string or an async function for deferred resolution.
+ */
+export interface PromptSectionConfig {
+    /** Section type identifier. */
+    type: string;
+    /** Static content string or async function that resolves to content. */
+    content: string | (() => Promise<string>);
+    /** Sort priority. Lower numbers appear first. */
+    priority: number;
+    /** Whether this section can be trimmed under token pressure. Defaults to true. */
+    shrinkable?: boolean;
+    /** XML tag name used when rendering. Defaults to the type value. */
+    tag?: string;
+    /** Origin of this section for debugging/auditing. */
+    source?: 'developer' | 'runtime' | 'flow' | 'security';
+}
+/**
+ * A fully resolved section with content materialized and metadata computed.
+ */
+export interface ResolvedSection {
+    /** Section type identifier. */
+    type: string;
+    /** Resolved content string. */
+    content: string;
+    /** Sort priority. */
+    priority: number;
+    /** Whether this section can be trimmed under token pressure. */
+    shrinkable: boolean;
+    /** XML tag name. */
+    tag: string;
+    /** Origin of this section. */
+    source: string;
+    /** Whether this section is in a frozen security band. */
+    frozen: boolean;
+    /** Estimated token count of the content. */
+    estimatedTokens: number;
+}
+/**
+ * Debug information about the assembly's current state.
+ */
+export interface AssemblyDebugInfo {
+    /** Per-section metadata. */
+    sections: Array<{
+        type: string;
+        priority: number;
+        tokens: number;
+        source: string;
+        shrinkable: boolean;
+        frozen: boolean;
+    }>;
+    /** Total estimated tokens across all sections. */
+    totalTokens: number;
+}
+/**
+ * Thrown when an attempt is made to modify a frozen security-band section.
+ */
+export declare class PromptSecurityViolationError extends Error {
+    constructor(message: string);
+}
+/**
+ * PromptAssembly is the structured intermediate representation for prompt construction.
+ *
+ * Sections are stored in a Map keyed by type. The special type `'custom'` is stored
+ * in a separate array to allow multiple custom sections.
+ *
+ * After `freeze()` is called, sections in security bands (priority 0-9 or 1000+)
+ * cannot be added, replaced, or removed.
+ */
+export declare class PromptAssembly {
+    private readonly sections;
+    private readonly customSections;
+    private frozen;
+    /**
+     * Adds or replaces a section. Custom-type sections are always appended.
+     *
+     * @throws {PromptSecurityViolationError} If the assembly is frozen and the
+     *   section's priority falls within a security band (0-9 or 1000+).
+     */
+    addSection(config: PromptSectionConfig): this;
+    /**
+     * Sugar for `addSection` with `source: 'runtime'`.
+     */
+    inject(type: string, content: string | (() => Promise<string>), options?: Partial<Omit<PromptSectionConfig, 'type' | 'content' | 'source'>>): this;
+    /**
+     * Freezes the assembly, preventing modification of security-band sections.
+     */
+    freeze(): this;
+    /**
+     * Resolves all sections — materializing async content functions — and
+     * returns them sorted by priority (ascending). Empty sections are filtered out.
+     */
+    resolve(): Promise<ResolvedSection[]>;
+    /**
+     * Returns the raw section config for a given type, or `undefined` if not present.
+     */
+    sectionByType(type: string): PromptSectionConfig | undefined;
+    /**
+     * Returns true if a section of the given type exists.
+     */
+    hasSection(type: string): boolean;
+    /**
+     * Returns debug information about the assembly's current state.
+     * Resolves async content to compute accurate token estimates.
+     */
+    debug(): Promise<AssemblyDebugInfo>;
+    /** Number of sections (including custom sections). */
+    get size(): number;
+}
+//# sourceMappingURL=PromptAssembly.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PromptAssembly.d.ts","sourceRoot":"","sources":["../../src/prompts/PromptAssembly.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAC;IACpB,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,MAAM,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,OAAO,CAAC;QACpB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IACH,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;gBACzC,OAAO,EAAE,MAAM;CAI5B;AAeD;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;IACxE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAiB7C;;OAEG;IACH,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,EACzC,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC,GAC1E,IAAI;IAWP;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAgC3C;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAI5D;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKjC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAiBzC,sDAAsD;IACtD,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/prompts/PromptAssembly.js

@@ -0,0 +1,150 @@
+/**
+ * PromptAssembly — Structured intermediate representation for prompt sections.
+ *
+ * Sections are stored in a Map keyed by type (except 'custom' which uses an array).
+ * Security-band sections (priority 0-9 or 1000+) are frozen after `freeze()` is called.
+ *
+ * @module
+ */
+import { estimateTokenCount } from '../runtime/ContextBudget.js';
+// ============================================
+// Error
+// ============================================
+/**
+ * Thrown when an attempt is made to modify a frozen security-band section.
+ */
+export class PromptSecurityViolationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PromptSecurityViolationError';
+    }
+}
+// ============================================
+// Helpers
+// ============================================
+/** Returns true if the priority falls within a frozen security band. */
+function isSecurityBand(priority) {
+    return priority <= 9 || priority >= 1000;
+}
+// ============================================
+// PromptAssembly
+// ============================================
+/**
+ * PromptAssembly is the structured intermediate representation for prompt construction.
+ *
+ * Sections are stored in a Map keyed by type. The special type `'custom'` is stored
+ * in a separate array to allow multiple custom sections.
+ *
+ * After `freeze()` is called, sections in security bands (priority 0-9 or 1000+)
+ * cannot be added, replaced, or removed.
+ */
+export class PromptAssembly {
+    sections = new Map();
+    customSections = [];
+    frozen = false;
+    /**
+     * Adds or replaces a section. Custom-type sections are always appended.
+     *
+     * @throws {PromptSecurityViolationError} If the assembly is frozen and the
+     *   section's priority falls within a security band (0-9 or 1000+).
+     */
+    addSection(config) {
+        if (this.frozen && isSecurityBand(config.priority)) {
+            throw new PromptSecurityViolationError(`Cannot modify section "${config.type}" at priority ${config.priority}: ` +
+                'security-band sections are frozen.');
+        }
+        if (config.type === 'custom') {
+            this.customSections.push(config);
+        }
+        else {
+            this.sections.set(config.type, config);
+        }
+        return this;
+    }
+    /**
+     * Sugar for `addSection` with `source: 'runtime'`.
+     */
+    inject(type, content, options) {
+        return this.addSection({
+            type,
+            content,
+            priority: options?.priority ?? 60,
+            shrinkable: options?.shrinkable,
+            tag: options?.tag,
+            source: 'runtime',
+        });
+    }
+    /**
+     * Freezes the assembly, preventing modification of security-band sections.
+     */
+    freeze() {
+        this.frozen = true;
+        return this;
+    }
+    /**
+     * Resolves all sections — materializing async content functions — and
+     * returns them sorted by priority (ascending). Empty sections are filtered out.
+     */
+    async resolve() {
+        const allConfigs = [
+            ...this.sections.values(),
+            ...this.customSections,
+        ];
+        const resolved = [];
+        for (const config of allConfigs) {
+            const content = typeof config.content === 'function'
+                ? await config.content()
+                : config.content;
+            if (!content || content.trim().length === 0)
+                continue;
+            resolved.push({
+                type: config.type,
+                content,
+                priority: config.priority,
+                shrinkable: config.shrinkable ?? true,
+                tag: config.tag ?? config.type,
+                source: config.source ?? 'developer',
+                frozen: this.frozen && isSecurityBand(config.priority),
+                estimatedTokens: estimateTokenCount(content),
+            });
+        }
+        resolved.sort((a, b) => a.priority - b.priority);
+        return resolved;
+    }
+    /**
+     * Returns the raw section config for a given type, or `undefined` if not present.
+     */
+    sectionByType(type) {
+        return this.sections.get(type);
+    }
+    /**
+     * Returns true if a section of the given type exists.
+     */
+    hasSection(type) {
+        if (type === 'custom')
+            return this.customSections.length > 0;
+        return this.sections.has(type);
+    }
+    /**
+     * Returns debug information about the assembly's current state.
+     * Resolves async content to compute accurate token estimates.
+     */
+    async debug() {
+        const resolved = await this.resolve();
+        const sectionInfos = resolved.map((s) => ({
+            type: s.type,
+            priority: s.priority,
+            tokens: s.estimatedTokens,
+            source: s.source,
+            shrinkable: s.shrinkable,
+            frozen: s.frozen,
+        }));
+        const totalTokens = sectionInfos.reduce((sum, s) => sum + s.tokens, 0);
+        return { sections: sectionInfos, totalTokens };
+    }
+    /** Number of sections (including custom sections). */
+    get size() {
+        return this.sections.size + this.customSections.length;
+    }
+}
+//# sourceMappingURL=PromptAssembly.js.map

package/dist/prompts/PromptAssembly.js.map

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