@vurb/core 3.2.3 → 3.3.4

package/dist/presenter/JudgeChain.js

@@ -0,0 +1,215 @@
+// ── Factory ──────────────────────────────────────────────
+/**
+ * Create a compiled JudgeChain from configuration.
+ *
+ * @param config - Chain configuration (adapters, strategy, timeouts)
+ * @returns A compiled {@link JudgeChain} ready for evaluation
+ *
+ * @example
+ * ```typescript
+ * import { createJudgeChain } from '@vurb/core';
+ *
+ * const chain = createJudgeChain({
+ *     adapters: [
+ *         { name: 'gpt-4o-mini', evaluate: (p) => openai.chat(p) },
+ *         { name: 'claude-haiku', evaluate: (p) => claude.message(p) },
+ *     ],
+ *     strategy: 'fallback',
+ *     timeoutMs: 3000,
+ * });
+ *
+ * const result = await chain.evaluate('Is this safe?');
+ * if (!result.passed) { // blocked }
+ * ```
+ */
+export function createJudgeChain(config) {
+    if (config.adapters.length === 0) {
+        throw new Error('[vurb] JudgeChain requires at least one adapter.');
+    }
+    const resolved = {
+        adapters: config.adapters,
+        strategy: config.strategy ?? 'fallback',
+        timeoutMs: config.timeoutMs ?? 5000,
+        failOpen: config.failOpen ?? false,
+    };
+    return {
+        config: resolved,
+        evaluate: (prompt) => executeChain(resolved, prompt),
+    };
+}
+// ── Execution ────────────────────────────────────────────
+/**
+ * Execute a single adapter with timeout guard.
+ *
+ * Uses `Promise.race` pattern. On timeout, rejects with a descriptive error.
+ *
+ * @internal
+ */
+async function executeAdapter(adapter, prompt, timeoutMs, parseFn) {
+    const start = Date.now();
+    let timer;
+    const timeoutPromise = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(`Judge "${adapter.name}" timed out after ${timeoutMs}ms`)), timeoutMs);
+    });
+    try {
+        const rawResponse = await Promise.race([
+            adapter.evaluate(prompt),
+            timeoutPromise,
+        ]);
+        clearTimeout(timer);
+        const passed = parseFn(rawResponse);
+        return {
+            adapterName: adapter.name,
+            passed,
+            rawResponse,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        clearTimeout(timer);
+        return {
+            adapterName: adapter.name,
+            passed: false,
+            rawResponse: `ERROR: ${err instanceof Error ? err.message : String(err)}`,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+/**
+ * Execute the full chain with the configured strategy.
+ *
+ * @internal
+ */
+async function executeChain(config, prompt) {
+    const start = Date.now();
+    const parseFn = parseJudgePass;
+    if (config.strategy === 'fallback') {
+        return executeFallback(config, prompt, parseFn, start);
+    }
+    return executeConsensus(config, prompt, parseFn, start);
+}
+/**
+ * Fallback strategy: try adapters sequentially until one succeeds.
+ *
+ * @internal
+ */
+async function executeFallback(config, prompt, parseFn, start) {
+    const results = [];
+    for (const adapter of config.adapters) {
+        const result = await executeAdapter(adapter, prompt, config.timeoutMs, parseFn);
+        results.push(result);
+        // If we got a real response (not an error), use it
+        if (!result.rawResponse.startsWith('ERROR:')) {
+            return {
+                passed: result.passed,
+                results,
+                totalDurationMs: Date.now() - start,
+                fallbackTriggered: false,
+            };
+        }
+        // Otherwise, try next adapter
+    }
+    // All adapters failed — apply failOpen/failClosed
+    return {
+        passed: config.failOpen,
+        results,
+        totalDurationMs: Date.now() - start,
+        fallbackTriggered: true,
+    };
+}
+/**
+ * Consensus strategy: ALL adapters must agree.
+ *
+ * Runs all adapters in parallel. If any fails with an error,
+ * the result depends on `failOpen`. If any returns `passed: false`,
+ * the content is blocked regardless of `failOpen`.
+ *
+ * @internal
+ */
+async function executeConsensus(config, prompt, parseFn, start) {
+    const settled = await Promise.allSettled(config.adapters.map(adapter => executeAdapter(adapter, prompt, config.timeoutMs, parseFn)));
+    const results = [];
+    let anyError = false;
+    let anyRejected = false;
+    for (const outcome of settled) {
+        if (outcome.status === 'fulfilled') {
+            results.push(outcome.value);
+            if (outcome.value.rawResponse.startsWith('ERROR:')) {
+                anyError = true;
+            }
+            else if (!outcome.value.passed) {
+                anyRejected = true;
+            }
+        }
+        else {
+            anyError = true;
+            results.push({
+                adapterName: 'unknown',
+                passed: false,
+                rawResponse: `ERROR: ${String(outcome.reason)}`,
+                durationMs: Date.now() - start,
+            });
+        }
+    }
+    // If any judge explicitly rejected → always blocked
+    if (anyRejected) {
+        return {
+            passed: false,
+            results,
+            totalDurationMs: Date.now() - start,
+            fallbackTriggered: false,
+        };
+    }
+    // If all judges errored → apply failOpen/failClosed
+    if (anyError) {
+        return {
+            passed: config.failOpen,
+            results,
+            totalDurationMs: Date.now() - start,
+            fallbackTriggered: true,
+        };
+    }
+    // All judges passed
+    return {
+        passed: true,
+        results,
+        totalDurationMs: Date.now() - start,
+        fallbackTriggered: false,
+    };
+}
+// ── Response Parsing ─────────────────────────────────────
+/**
+ * Parse a judge's raw response to determine pass/fail.
+ *
+ * Expects a JSON response with a `"safe"` boolean field.
+ * Falls back to text matching for non-JSON responses.
+ *
+ * @internal
+ */
+function parseJudgePass(raw) {
+    try {
+        const jsonMatch = raw.match(/\{[\s\S]*\}/);
+        if (jsonMatch) {
+            const parsed = JSON.parse(jsonMatch[0]);
+            // Support multiple field names
+            if (typeof parsed.safe === 'boolean')
+                return parsed.safe;
+            if (typeof parsed.passed === 'boolean')
+                return parsed.passed;
+            if (typeof parsed.allowed === 'boolean')
+                return parsed.allowed;
+        }
+    }
+    catch {
+        // Fall through to text matching
+    }
+    // Text-based fallback — conservative (default: fail-closed)
+    const lower = raw.toLowerCase();
+    if (lower.includes('"safe": true') || lower.includes('"safe":true'))
+        return true;
+    if (lower.includes('"safe": false') || lower.includes('"safe":false'))
+        return false;
+    // Unparseable → treated as error (passthrough depends on failOpen)
+    return false;
+}
+//# sourceMappingURL=JudgeChain.js.map

package/dist/presenter/JudgeChain.js.map

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

package/dist/presenter/PostProcessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PostProcessor.d.ts","sourceRoot":"","sources":["../../src/presenter/PostProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,YAAY,EAA8B,MAAM,qBAAqB,CAAC;AAEpF,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAIxE;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,SAAS,EACzC,GAAG,CAAC,EAAE,OAAO,EACb,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,SAAS,CAAC,EAAE,oBAAoB,GACjC,YAAY,CAqGd;AAID;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAgBpE"}
+{"version":3,"file":"PostProcessor.d.ts","sourceRoot":"","sources":["../../src/presenter/PostProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,YAAY,EAA8B,MAAM,qBAAqB,CAAC;AAEpF,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAKxE;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,SAAS,EACzC,GAAG,CAAC,EAAE,OAAO,EACb,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,SAAS,CAAC,EAAE,oBAAoB,GACjC,YAAY,CA0Cd;AAID;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAgBpE"}

package/dist/presenter/PostProcessor.js

@@ -12,7 +12,7 @@ import { success as successResponse } from '../core/response.js';
 import { isResponseBuilder } from './ResponseBuilder.js';
 import {} from './Presenter.js';
 import {} from '../observability/TelemetryEvent.js';
-const _encoder = new TextEncoder();
+import { emitPresenterTelemetry } from './TelemetryCollector.js';
 /**
  * Post-process a handler's return value through the MVA priority hierarchy.
  *
@@ -42,77 +42,22 @@ export function postProcessResult(result, presenter, ctx, selectFields, telemetr
     }
     // Priority 3: Raw data + Presenter → pipe through MVA
     if (presenter) {
-        // Measure raw data size for telemetry
-        const rawJson = telemetry ? JSON.stringify(result) : undefined;
-        const rawBytes = rawJson ? _encoder.encode(rawJson).byteLength : 0;
+        // Pre-serialize for telemetry (skip if no sink)
+        const rawJson = telemetry ? JSON.stringify(result) : '';
         const rawRows = Array.isArray(result) ? result.length : 1;
         const response = presenter.make(result, ctx, selectFields).build();
-        // Emit presenter.slice and presenter.rules events
+        // Delegate all telemetry emission to TelemetryCollector
         if (telemetry) {
-            // Measure wire bytes from the built response
-            let wireBytes = 0;
-            for (const c of response.content) {
-                if ('text' in c && typeof c.text === 'string') {
-                    wireBytes += _encoder.encode(c.text).byteLength;
-                }
-            }
-            // Compute wire rows — agentLimit may have truncated
-            const agentLimitMax = presenter.getAgentLimitMax();
-            const wireRows = (agentLimitMax !== undefined && rawRows > agentLimitMax)
-                ? agentLimitMax
-                : rawRows;
-            telemetry.sink({
-                type: 'presenter.slice',
+            emitPresenterTelemetry({
+                sink: telemetry.sink,
                 tool: telemetry.tool,
                 action: telemetry.action,
-                rawBytes,
-                wireBytes,
-                rowsRaw: rawRows,
-                rowsWire: wireRows,
-                // Enriched fields for Inspector X-Ray
-                ...(selectFields && selectFields.length > 0 ? {
-                    selectFields,
-                    totalFields: presenter.getSchemaKeys().length || undefined,
-                } : {}),
-                ...(agentLimitMax !== undefined && rawRows > agentLimitMax ? {
-                    guardrailFrom: rawRows,
-                    guardrailTo: agentLimitMax,
-                    guardrailHint: 'Results truncated by agentLimit. Use pagination or filters.',
-                } : {}),
-                timestamp: Date.now(),
+                response,
+                presenter,
+                rawJson,
+                rawRows,
+                selectFields,
             });
-            // Extract rules from the built response text content
-            // Rules are embedded as <domain_rules> XML blocks by the ResponseBuilder
-            const rulesFromResponse = [];
-            for (const c of response.content) {
-                if ('text' in c && typeof c.text === 'string') {
-                    const match = c.text.match(/<domain_rules>\n([\s\S]*?)\n<\/domain_rules>/);
-                    if (match) {
-                        rulesFromResponse.push(...match[1].split('\n').filter(Boolean).map(r => r.replace(/^- /, '')));
-                    }
-                }
-            }
-            if (rulesFromResponse.length > 0) {
-                telemetry.sink({
-                    type: 'presenter.rules',
-                    tool: telemetry.tool,
-                    action: telemetry.action,
-                    rules: rulesFromResponse,
-                    timestamp: Date.now(),
-                });
-            }
-            // Emit DLP redaction event if the Presenter has redact paths
-            const redactPaths = presenter.getRedactPaths();
-            if (redactPaths.length > 0) {
-                telemetry.sink({
-                    type: 'dlp.redact',
-                    tool: telemetry.tool,
-                    action: telemetry.action,
-                    fieldsRedacted: redactPaths.length,
-                    paths: [...redactPaths],
-                    timestamp: Date.now(),
-                });
-            }
         }
         return response;
     }

package/dist/presenter/PostProcessor.js.map

@@ -1 +1 @@
-{"version":3,"file":"PostProcessor.js","sourceRoot":"","sources":["../../src/presenter/PostProcessor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PostProcessor.js","sourceRoot":"","sources":["../../src/presenter/PostProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAqB,OAAO,IAAI,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAwB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAkB,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAsB,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAejE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAC7B,MAAe,EACf,SAAyC,EACzC,GAAa,EACb,YAAuB,EACvB,SAAgC;IAEhC,yDAAyD;IACzD,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,4DAA4D;IAC5D,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAQ,MAA0B,CAAC,KAAK,EAAE,CAAC;IAC/C,CAAC;IAED,sDAAsD;IACtD,IAAI,SAAS,EAAE,CAAC;QACZ,gDAAgD;QAChD,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAE1D,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,KAAK,EAAE,CAAC;QAEnE,wDAAwD;QACxD,IAAI,SAAS,EAAE,CAAC;YACZ,sBAAsB,CAAC;gBACnB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,QAAQ;gBACR,SAAS;gBACT,OAAO;gBACP,OAAO;gBACP,YAAY;aACf,CAAC,CAAC;QACP,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,sEAAsE;IACtE,OAAO,eAAe,CAClB,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ;QACpD,CAAC,CAAE,MAA0B;QAC7B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CACvB,CAAC;AACN,CAAC;AAED,4DAA4D;AAE5D;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IACzC,IACI,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC;QACrB,CAAC,KAAK,CAAC,OAAO,CAAE,KAA8B,CAAC,OAAO,CAAC,EACzD,CAAC;QACC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAI,KAAgC,CAAC,OAAO,CAAC;IAC1D,sDAAsD;IACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,mDAAmD;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAwC,CAAC;IAChE,OAAO,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC;AAC9D,CAAC"}

package/dist/presenter/Presenter.d.ts

@@ -55,6 +55,8 @@
 import { z, ZodType, type ZodRawShape } from 'zod';
 import { ResponseBuilder } from './ResponseBuilder.js';
 import { type UiBlock } from './ui.js';
+import { type PresenterSnapshot, type CollectionRulesFn, type ItemUiBlocksFn, type CollectionUiBlocksFn, type SuggestActionsFn, type CollectionSuggestActionsFn } from './PresenterPipeline.js';
+import { type PromptFirewallConfig } from './PromptFirewall.js';
 /**
  * Check if a value is a {@link Presenter} instance.
  *
@@ -72,12 +74,15 @@ export interface ActionSuggestion {
     /** Human-readable reason for the suggestion */
     readonly reason: string;
 }
-/** UI blocks callback — with optional context */
-type ItemUiBlocksFn<T> = (item: T, ctx?: unknown) => (UiBlock | null)[];
-/** Collection UI blocks callback — with optional context */
-type CollectionUiBlocksFn<T> = (items: T[], ctx?: unknown) => (UiBlock | null)[];
-/** Suggest actions callback — with optional context */
-type SuggestActionsFn<T> = (data: T, ctx?: unknown) => ActionSuggestion[];
+export type { RulesConfig, CollectionRulesFn, ItemUiBlocksFn, CollectionUiBlocksFn, SuggestActionsFn, CollectionSuggestActionsFn, AgentLimitConfig, EmbedEntry, } from './PresenterPipeline.js';
+/** Async UI blocks callback (single item) */
+type AsyncItemUiBlocksFn<T> = (item: T, ctx?: unknown) => Promise<(UiBlock | null)[]>;
+/** Async UI blocks callback (collection) */
+type AsyncCollectionUiBlocksFn<T> = (items: T[], ctx?: unknown) => Promise<(UiBlock | null)[]>;
+/** Async rules callback */
+type AsyncRulesFn<T> = (data: T, ctx?: unknown) => Promise<(string | null)[]>;
+/** Async suggest actions callback */
+type AsyncSuggestActionsFn<T> = (data: T, ctx?: unknown) => Promise<(ActionSuggestion | null)[]>;
 /**
  * Domain-level Presenter — the "View" in MVA (Model-View-Agent).
  *
@@ -103,13 +108,20 @@ export declare class Presenter<T> {
     private _itemUiBlocks?;
     private _collectionUiBlocks?;
     private _suggestActions?;
+    private _collectionSuggestActions?;
     private _agentLimit?;
     private _embeds;
     private _sealed;
+    private _collectionRules;
     private _compiledStringify;
     private _compiledRedactor;
     private _redactConfig;
     private _redactPaths;
+    private _asyncItemUiBlocks?;
+    private _asyncCollectionUiBlocks?;
+    private _asyncRules?;
+    private _asyncSuggestActions?;
+    private _promptFirewall?;
     /** @internal Use {@link createPresenter} factory instead */
     constructor(name: string);
     /**
@@ -270,6 +282,32 @@ export declare class Presenter<T> {
      * ```
      */
     suggestActions(fn: SuggestActionsFn<T>): this;
+    /**
+     * Define HATEOAS-style action suggestions for **collections**.
+     *
+     * Unlike `.suggestActions()`, this callback receives the **entire array**
+     * of validated items, enabling aggregate-level suggestions like batch
+     * operations, bulk approvals, or summary insights.
+     *
+     * When both `.suggestActions()` and `.collectionSuggestActions()` are set,
+     * only collectionSuggestActions is used for arrays.
+     *
+     * @param fn - `(items[], ctx?) => (ActionSuggestion | null)[]`
+     * @returns `this` for chaining
+     *
+     * @example
+     * ```typescript
+     * .collectionSuggestActions((invoices) => [
+     *     invoices.some(i => i.status === 'overdue')
+     *         ? { tool: 'billing.batch_remind', reason: 'Send batch reminders' }
+     *         : null,
+     *     invoices.length > 100
+     *         ? { tool: 'billing.export', reason: 'Export results for offline review' }
+     *         : null,
+     * ])
+     * ```
+     */
+    collectionSuggestActions(fn: CollectionSuggestActionsFn<T>): this;
     /**
      * Alias for `.suggestActions()` — fluent shorthand.
      *
@@ -292,6 +330,13 @@ export declare class Presenter<T> {
      * ```
      */
     suggest(fn: SuggestActionsFn<T>): this;
+    /**
+     * Alias for `.collectionSuggestActions()` — fluent shorthand.
+     *
+     * @param fn - `(items[], ctx?) => (ActionSuggestion | null)[]`
+     * @returns `this` for chaining
+     */
+    collectionSuggest(fn: CollectionSuggestActionsFn<T>): this;
     /**
      * Alias for `.systemRules()` — fluent shorthand.
      *
@@ -307,6 +352,29 @@ export declare class Presenter<T> {
      * ```
      */
     rules(rules: readonly string[] | ((data: T, ctx?: unknown) => (string | null)[])): this;
+    /**
+     * Set collection-level system rules.
+     *
+     * Unlike `.systemRules()`, these rules are evaluated with the **entire
+     * array** of validated items. Use for aggregate context (totals, counts,
+     * mixed-status warnings) that cannot be derived from a single item.
+     *
+     * Both per-item and collection rules are merged in the response.
+     *
+     * @param rules - Static rules array, or dynamic `(items[], ctx?) => (string | null)[]`
+     * @returns `this` for chaining
+     *
+     * @example
+     * ```typescript
+     * .collectionRules((invoices, ctx) => [
+     *     `Total: ${invoices.length} invoices found.`,
+     *     invoices.some(i => i.status === 'overdue')
+     *         ? '⚠️ Some invoices are OVERDUE. Highlight them.'
+     *         : null,
+     * ])
+     * ```
+     */
+    collectionRules(rules: CollectionRulesFn<T>): this;
     /**
      * Alias for `.uiBlocks()` — fluent shorthand.
      *
@@ -473,6 +541,69 @@ export declare class Presenter<T> {
      * @returns Static rule strings, or empty array if rules are contextual
      */
     getStaticRuleStrings(): readonly string[];
+    /**
+     * Register an **async** UI block callback for single items.
+     *
+     * Use when UI generation requires I/O (database, API, file system).
+     * Must be consumed via `makeAsync()` — `make()` ignores async callbacks.
+     *
+     * @param fn - Async function receiving validated data + optional context
+     * @returns `this` for chaining
+     *
+     * @example
+     * ```typescript
+     * createPresenter('Invoice')
+     *     .asyncUiBlocks(async (inv, ctx) => {
+     *         const history = await ctx.db.payments.history(inv.id);
+     *         return [ui.echarts(buildTimeline(history))];
+     *     });
+     * ```
+     */
+    asyncUiBlocks(fn: AsyncItemUiBlocksFn<T>): this;
+    /**
+     * Register an **async** UI block callback for collections.
+     *
+     * @param fn - Async function receiving the full validated array + optional context
+     * @returns `this` for chaining
+     */
+    asyncCollectionUiBlocks(fn: AsyncCollectionUiBlocksFn<T>): this;
+    /**
+     * Register **async** system rules generation.
+     *
+     * @param fn - Async function receiving validated data + optional context
+     * @returns `this` for chaining
+     */
+    asyncRules(fn: AsyncRulesFn<T>): this;
+    /**
+     * Register **async** action suggestions generation.
+     *
+     * @param fn - Async function receiving validated data + optional context
+     * @returns `this` for chaining
+     */
+    asyncSuggestActions(fn: AsyncSuggestActionsFn<T>): this;
+    /**
+     * Enable LLM-as-Judge evaluation of dynamic system rules.
+     *
+     * The PromptFirewall evaluates all resolved rules (sync + async)
+     * through a judge chain before they reach the LLM. This prevents
+     * prompt injection via tainted data interpolated in `.systemRules()`.
+     *
+     * **Important:** Presenters with a firewall MUST use `makeAsync()`.
+     * Calling `make()` will throw an error.
+     *
+     * @param config - Firewall configuration (adapter or chain)
+     * @returns `this` for chaining
+     *
+     * @example
+     * ```typescript
+     * createPresenter('Invoice')
+     *     .systemRules((inv) => [`Status: ${inv.description}`])
+     *     .promptFirewall({
+     *         adapter: { name: 'gpt-4o-mini', evaluate: (p) => openai.chat(p) },
+     *     });
+     * ```
+     */
+    promptFirewall(config: PromptFirewallConfig): this;
     /**
      * Compose a {@link ResponseBuilder} from raw data.
      *
@@ -511,42 +642,50 @@ export declare class Presenter<T> {
      */
     make(data: T | T[], ctx?: unknown, selectFields?: string[]): ResponseBuilder;
     /**
-     * Apply PII redaction to wire-facing data.
-     * Creates a deep clone to preserve original data for UI/rules.
-     * @internal
-     */
-    private _applyRedaction;
-    /**
-     * Validate data through the Zod schema (if configured).
-     * For arrays, each item is validated independently.
-     * @internal
-     */
-    private _validate;
-    /**
-     * Generate and attach UI blocks to the response builder.
-     * Auto-detects single vs collection. Filters `null` blocks.
-     * @internal
-     */
-    private _attachUiBlocks;
-    /**
-     * Resolve and attach domain rules to the response builder.
-     * Supports both static arrays and dynamic context-aware functions.
-     * Filters `null` rules automatically.
-     * @internal
+     * Check if this Presenter has any async callbacks configured.
+     *
+     * Used by the pipeline to decide between sync `make()` and async
+     * `makeAsync()`. When no async callbacks are set, `makeAsync()` is
+     * equivalent to `Promise.resolve(make())`, so the sync path is preferred.
+     *
+     * @returns `true` if any async callback is configured
      */
-    private _attachRules;
+    hasAsyncCallbacks(): boolean;
     /**
-     * Evaluate and attach action suggestions to the response.
-     * Generates a `[SYSTEM HINT]` block with recommended next tools.
-     * @internal
+     * Async version of `make()` — enriches the response with async callbacks.
+     *
+     * Runs all sync steps first (via `make()`), then awaits async callbacks
+     * and appends their results to the builder. The sync `make()` method
+     * remains unchanged (zero breaking changes).
+     *
+     * @param data - Raw data from the handler (object or array)
+     * @param ctx - Optional request context
+     * @param selectFields - Optional top-level field names for context window optimization
+     * @returns A Promise resolving to a {@link ResponseBuilder}
+     *
+     * @example
+     * ```typescript
+     * const presenter = createPresenter('Invoice')
+     *     .schema(invoiceSchema)
+     *     .asyncUiBlocks(async (inv, ctx) => {
+     *         const history = await ctx.db.payments.history(inv.id);
+     *         return [ui.echarts(buildTimeline(history))];
+     *     });
+     *
+     * // In handler:
+     * const builder = await presenter.makeAsync(data, ctx);
+     * return builder.build();
+     * ```
      */
-    private _attachSuggestions;
+    makeAsync(data: T | T[], ctx?: unknown, selectFields?: string[]): Promise<ResponseBuilder>;
     /**
-     * Process embedded child Presenters for nested relational data.
-     * Merges child UI blocks and rules into the parent builder.
+     * Create a read-only snapshot of the Presenter's configuration
+     * for use by the decomposed pipeline steps.
+     *
+     * @returns A {@link PresenterSnapshot} capturing the current config
      * @internal
      */
-    private _processEmbeds;
+    _toSnapshot(): PresenterSnapshot<T>;
 }
 /**
  * Create a new domain-level Presenter.
@@ -571,5 +710,4 @@ export declare class Presenter<T> {
  * @see {@link Presenter} for the full API
  */
 export declare function createPresenter(name: string): Presenter<unknown>;
-export {};
 //# sourceMappingURL=Presenter.d.ts.map

package/dist/presenter/Presenter.d.ts.map

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