@framers/agentos 0.1.56 → 0.1.58

package/dist/core/guardrails/ParallelGuardrailDispatcher.js

@@ -0,0 +1,463 @@
+import { AgentOSResponseChunkType, } from '../../api/types/AgentOSResponse.js';
+import { GuardrailAction, } from './IGuardrailService.js';
+import { serializeEvaluation, withGuardrailMetadata, createGuardrailBlockedStream, hasEvaluateOutput, } from './guardrailDispatcher.js';
+// ---------------------------------------------------------------------------
+// Severity map used by worstAction — SANITIZE is excluded because it is
+// always downgraded to FLAG before reaching the aggregator.
+// ---------------------------------------------------------------------------
+/** @internal Numeric severity for each guardrail action. Higher = worse. */
+const ACTION_SEVERITY = {
+    [GuardrailAction.ALLOW]: 0,
+    [GuardrailAction.SANITIZE]: 1, // only used as tiebreaker — should not appear in Phase 2
+    [GuardrailAction.FLAG]: 2,
+    [GuardrailAction.BLOCK]: 3,
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Race a promise against an optional timeout.
+ *
+ * If `timeoutMs` is not set (undefined / 0), the original promise is returned
+ * unmodified. On timeout or error the function returns `null` (fail-open)
+ * and logs a warning so operators can tune the timeout.
+ *
+ * @param fn        - The async function to execute
+ * @param timeoutMs - Maximum milliseconds to wait (undefined = no limit)
+ * @returns The evaluation result, or `null` on timeout / error
+ */
+async function callWithTimeout(fn, timeoutMs) {
+    try {
+        if (!timeoutMs || timeoutMs <= 0) {
+            return await fn();
+        }
+        // Race the evaluation against a timeout sentinel
+        const result = await Promise.race([
+            fn(),
+            new Promise((resolve) => {
+                setTimeout(() => resolve(null), timeoutMs);
+            }),
+        ]);
+        return result;
+    }
+    catch (error) {
+        console.warn('[AgentOS][Guardrails] callWithTimeout: guardrail threw, failing open.', error);
+        return null;
+    }
+}
+/**
+ * Determine the worst (highest-severity) action from a list of evaluations.
+ *
+ * Returns `GuardrailAction.ALLOW` when the list is empty.
+ *
+ * @param evaluations - Non-empty array of evaluation results
+ * @returns The action with the highest severity
+ */
+function worstAction(evaluations) {
+    if (evaluations.length === 0) {
+        return GuardrailAction.ALLOW;
+    }
+    let worst = evaluations[0].action;
+    for (let i = 1; i < evaluations.length; i++) {
+        const candidate = evaluations[i].action;
+        if (ACTION_SEVERITY[candidate] > ACTION_SEVERITY[worst]) {
+            worst = candidate;
+        }
+    }
+    return worst;
+}
+/**
+ * If a Phase 2 guardrail returns SANITIZE, downgrade it to FLAG with a
+ * warning. Concurrent sanitization is non-deterministic so we refuse it.
+ *
+ * @param evaluation - The raw evaluation from Phase 2
+ * @param svcIndex   - Registration index for logging
+ * @returns The (potentially downgraded) evaluation
+ */
+function downgradePhase2Sanitize(evaluation, svcIndex) {
+    if (evaluation.action !== GuardrailAction.SANITIZE) {
+        return evaluation;
+    }
+    console.warn(`[AgentOS][Guardrails] Phase 2 guardrail at index ${svcIndex} returned SANITIZE — ` +
+        'downgrading to FLAG because concurrent sanitization is non-deterministic.');
+    return {
+        ...evaluation,
+        action: GuardrailAction.FLAG,
+        reason: evaluation.reason
+            ? `${evaluation.reason} [downgraded from SANITIZE]`
+            : 'SANITIZE downgraded to FLAG in parallel phase',
+    };
+}
+// ---------------------------------------------------------------------------
+// ParallelGuardrailDispatcher
+// ---------------------------------------------------------------------------
+/**
+ * Stateless two-phase parallel guardrail dispatcher.
+ *
+ * All methods are static — no instantiation needed. The class exists purely
+ * as a namespace to keep the two public entry points grouped.
+ */
+export class ParallelGuardrailDispatcher {
+    // -----------------------------------------------------------------------
+    // evaluateInput
+    // -----------------------------------------------------------------------
+    /**
+     * Evaluate user input through registered guardrails using two-phase execution.
+     *
+     * **Phase 1 (Sequential — sanitizers):**
+     * Guardrails with `config.canSanitize === true` run one-at-a-time in
+     * registration order. Each sees (and may modify) the cumulative sanitized
+     * input. A BLOCK result short-circuits immediately — Phase 2 never runs.
+     *
+     * **Phase 2 (Parallel — classifiers):**
+     * All remaining guardrails run concurrently via `Promise.allSettled` on
+     * the text produced by Phase 1. A Phase 2 SANITIZE is downgraded to FLAG.
+     *
+     * **Aggregation:** worst-wins (BLOCK > FLAG > ALLOW). The singular
+     * `evaluation` field is set to the first BLOCK, else the worst-severity
+     * evaluation, else the last evaluation by registration order.
+     *
+     * @param services  - Array of guardrail services (already normalized)
+     * @param input     - User input to evaluate
+     * @param context   - Conversational context for policy decisions
+     * @returns Outcome with sanitized input and all evaluations in registration order
+     */
+    static async evaluateInput(services, input, context) {
+        if (services.length === 0) {
+            return { sanitizedInput: input, evaluations: [] };
+        }
+        // -- Partition into sanitizers (Phase 1) and parallel classifiers (Phase 2)
+        const sanitizers = [];
+        const parallel = [];
+        for (let i = 0; i < services.length; i++) {
+            const svc = services[i];
+            if (svc.config?.canSanitize === true) {
+                sanitizers.push(svc);
+            }
+            else {
+                parallel.push({ svc, registrationIndex: i });
+            }
+        }
+        // Pre-allocate evaluation slots so results appear in registration order.
+        // null slots are compacted away at the end.
+        const evaluationSlots = new Array(services.length).fill(null);
+        let sanitizedInput = input;
+        // -----------------------------------------------------------------
+        // Phase 1: Sequential sanitizers
+        // -----------------------------------------------------------------
+        for (let i = 0; i < services.length; i++) {
+            const svc = services[i];
+            // Only Phase 1 services (sanitizers) run sequentially
+            if (svc.config?.canSanitize !== true) {
+                continue;
+            }
+            if (!svc.evaluateInput) {
+                continue;
+            }
+            const timeoutMs = svc.config?.timeoutMs;
+            const evaluation = await callWithTimeout(() => svc.evaluateInput({ context, input: sanitizedInput }), timeoutMs);
+            if (!evaluation) {
+                continue;
+            }
+            evaluationSlots[i] = evaluation;
+            // BLOCK in Phase 1 short-circuits everything — Phase 2 never runs
+            if (evaluation.action === GuardrailAction.BLOCK) {
+                const evaluations = evaluationSlots.filter(Boolean);
+                return { sanitizedInput, evaluation, evaluations };
+            }
+            // SANITIZE: update the running sanitized input for the next sanitizer
+            if (evaluation.action === GuardrailAction.SANITIZE && evaluation.modifiedText !== undefined) {
+                sanitizedInput = {
+                    ...sanitizedInput,
+                    textInput: evaluation.modifiedText,
+                };
+            }
+        }
+        // -----------------------------------------------------------------
+        // Phase 2: Parallel classifiers
+        // -----------------------------------------------------------------
+        if (parallel.length > 0) {
+            const settled = await Promise.allSettled(parallel.map(({ svc }) => {
+                if (!svc.evaluateInput) {
+                    return Promise.resolve(null);
+                }
+                const timeoutMs = svc.config?.timeoutMs;
+                return callWithTimeout(() => svc.evaluateInput({ context, input: sanitizedInput }), timeoutMs);
+            }));
+            // Slot results back into registration order
+            for (let j = 0; j < parallel.length; j++) {
+                const outcome = settled[j];
+                if (outcome.status === 'rejected') {
+                    console.warn('[AgentOS][Guardrails] Phase 2 evaluateInput rejected.', outcome.reason);
+                    continue;
+                }
+                let evaluation = outcome.value;
+                if (!evaluation) {
+                    continue;
+                }
+                // Downgrade SANITIZE → FLAG in Phase 2
+                evaluation = downgradePhase2Sanitize(evaluation, parallel[j].registrationIndex);
+                evaluationSlots[parallel[j].registrationIndex] = evaluation;
+            }
+        }
+        // -----------------------------------------------------------------
+        // Aggregate: compact slots, pick "evaluation" (singular)
+        // -----------------------------------------------------------------
+        const evaluations = evaluationSlots.filter(Boolean);
+        if (evaluations.length === 0) {
+            return { sanitizedInput, evaluations: [] };
+        }
+        // Pick the singular evaluation: first BLOCK, else worst severity, else last
+        const blockEval = evaluations.find((e) => e.action === GuardrailAction.BLOCK);
+        if (blockEval) {
+            return { sanitizedInput, evaluation: blockEval, evaluations };
+        }
+        const worst = worstAction(evaluations);
+        // Find the first evaluation matching worst severity
+        const worstEval = evaluations.find((e) => e.action === worst) ?? evaluations.at(-1);
+        return {
+            sanitizedInput,
+            evaluation: worstEval,
+            evaluations,
+        };
+    }
+    // -----------------------------------------------------------------------
+    // wrapOutput
+    // -----------------------------------------------------------------------
+    /**
+     * Wrap a response stream with two-phase guardrail filtering.
+     *
+     * Partitions services into four groups (once, up front):
+     * 1. **Streaming sanitizers** (`canSanitize && evaluateStreamingChunks`)
+     * 2. **Streaming parallel** classifiers (`evaluateStreamingChunks && !canSanitize`)
+     * 3. **Final sanitizers** (`canSanitize && !evaluateStreamingChunks`)
+     * 4. **Final parallel** classifiers (the rest with `evaluateOutput`)
+     *
+     * For each TEXT_DELTA chunk: Phase 1 runs streaming sanitizers sequentially
+     * (with per-service rate limiting), then Phase 2 runs streaming classifiers
+     * in parallel.
+     *
+     * For each isFinal chunk: Phase 1 runs final sanitizers sequentially, then
+     * Phase 2 runs final classifiers in parallel. All services with
+     * `evaluateOutput` participate in final evaluation.
+     *
+     * A BLOCK in either phase terminates the stream immediately with an error
+     * chunk.
+     *
+     * @param services  - Array of guardrail services (already normalized)
+     * @param context   - Conversational context for policy decisions
+     * @param stream    - Source response stream to filter
+     * @param options   - Stream options and input evaluations to embed
+     * @returns Wrapped async generator with guardrail filtering applied
+     */
+    static async *wrapOutput(services, context, stream, options) {
+        if (services.length === 0) {
+            yield* stream;
+            return;
+        }
+        // -- Partition into 4 groups once --------------------------------
+        /** Streaming sanitizers: Phase 1 for TEXT_DELTA chunks */
+        const streamingSanitizers = [];
+        /** Streaming classifiers: Phase 2 for TEXT_DELTA chunks */
+        const streamingParallel = [];
+        /** Final sanitizers: Phase 1 for isFinal chunks */
+        const finalSanitizers = [];
+        /** Final classifiers: Phase 2 for isFinal chunks */
+        const finalParallel = [];
+        for (let i = 0; i < services.length; i++) {
+            const svc = services[i];
+            if (!hasEvaluateOutput(svc)) {
+                continue;
+            }
+            const isStreaming = svc.config?.evaluateStreamingChunks === true;
+            const isSanitizer = svc.config?.canSanitize === true;
+            if (isStreaming && isSanitizer) {
+                streamingSanitizers.push(svc);
+            }
+            else if (isStreaming && !isSanitizer) {
+                streamingParallel.push({ svc, registrationIndex: i });
+            }
+            // All services with evaluateOutput participate in final evaluation
+            if (isSanitizer) {
+                finalSanitizers.push(svc);
+            }
+            else {
+                finalParallel.push({ svc, registrationIndex: i });
+            }
+        }
+        // -- Metadata from input evaluation --------------------------------
+        const serializedInputEvaluations = (options.inputEvaluations ?? []).map(serializeEvaluation);
+        let inputMetadataApplied = serializedInputEvaluations.length === 0;
+        // -- Per-service rate limiting for streaming evaluation -------------
+        const streamingEvaluationCounts = new Map();
+        // -- Main stream loop ----------------------------------------------
+        for await (const chunk of stream) {
+            let currentChunk = chunk;
+            // Attach input evaluation metadata to the first output chunk
+            if (!inputMetadataApplied && serializedInputEvaluations.length > 0) {
+                currentChunk = withGuardrailMetadata(currentChunk, { input: serializedInputEvaluations });
+                inputMetadataApplied = true;
+            }
+            // ---------------------------------------------------------------
+            // TEXT_DELTA (non-final): streaming guardrails
+            // ---------------------------------------------------------------
+            if (chunk.type === AgentOSResponseChunkType.TEXT_DELTA &&
+                !chunk.isFinal &&
+                (streamingSanitizers.length > 0 || streamingParallel.length > 0)) {
+                const outputEvaluations = [];
+                let workingChunk = currentChunk;
+                // Phase 1: sequential streaming sanitizers
+                for (const svc of streamingSanitizers) {
+                    const svcId = svc.id || 'unknown';
+                    const currentCount = streamingEvaluationCounts.get(svcId) || 0;
+                    const maxEvals = svc.config?.maxStreamingEvaluations;
+                    // Skip if this service has hit its rate limit
+                    if (maxEvals !== undefined && currentCount >= maxEvals) {
+                        continue;
+                    }
+                    const timeoutMs = svc.config?.timeoutMs;
+                    const evaluation = await callWithTimeout(() => svc.evaluateOutput({ context, chunk: workingChunk, ragSources: options.ragSources }), timeoutMs);
+                    streamingEvaluationCounts.set(svcId, currentCount + 1);
+                    if (!evaluation) {
+                        continue;
+                    }
+                    outputEvaluations.push(evaluation);
+                    // BLOCK terminates the stream immediately
+                    if (evaluation.action === GuardrailAction.BLOCK) {
+                        yield* createGuardrailBlockedStream(context, evaluation, options);
+                        return;
+                    }
+                    // SANITIZE: modify the textDelta for downstream services
+                    if (evaluation.action === GuardrailAction.SANITIZE && evaluation.modifiedText !== undefined) {
+                        workingChunk = {
+                            ...workingChunk,
+                            textDelta: evaluation.modifiedText,
+                        };
+                    }
+                }
+                // Phase 2: parallel streaming classifiers
+                if (streamingParallel.length > 0) {
+                    const tasks = streamingParallel.map(({ svc, registrationIndex }) => {
+                        const svcId = svc.id || `svc-${registrationIndex}`;
+                        const currentCount = streamingEvaluationCounts.get(svcId) || 0;
+                        const maxEvals = svc.config?.maxStreamingEvaluations;
+                        // Rate-limited services return null immediately
+                        if (maxEvals !== undefined && currentCount >= maxEvals) {
+                            return Promise.resolve({ evaluation: null, registrationIndex, svcId });
+                        }
+                        const timeoutMs = svc.config?.timeoutMs;
+                        return callWithTimeout(() => svc.evaluateOutput({ context, chunk: workingChunk, ragSources: options.ragSources }), timeoutMs).then((evaluation) => {
+                            streamingEvaluationCounts.set(svcId, currentCount + 1);
+                            return { evaluation, registrationIndex, svcId };
+                        });
+                    });
+                    const results = await Promise.allSettled(tasks);
+                    for (const result of results) {
+                        if (result.status === 'rejected') {
+                            console.warn('[AgentOS][Guardrails] Phase 2 streaming evaluateOutput rejected.', result.reason);
+                            continue;
+                        }
+                        const { evaluation: rawEvaluation, registrationIndex } = result.value;
+                        if (!rawEvaluation) {
+                            continue;
+                        }
+                        // Downgrade SANITIZE → FLAG in Phase 2
+                        const evaluation = downgradePhase2Sanitize(rawEvaluation, registrationIndex);
+                        outputEvaluations.push(evaluation);
+                        // BLOCK terminates the stream immediately
+                        if (evaluation.action === GuardrailAction.BLOCK) {
+                            yield* createGuardrailBlockedStream(context, evaluation, options);
+                            return;
+                        }
+                    }
+                }
+                // Attach output evaluation metadata
+                if (outputEvaluations.length > 0) {
+                    workingChunk = withGuardrailMetadata(workingChunk, {
+                        output: outputEvaluations.map(serializeEvaluation),
+                    });
+                }
+                currentChunk = workingChunk;
+            }
+            // ---------------------------------------------------------------
+            // isFinal chunks: all guardrails participate
+            // ---------------------------------------------------------------
+            if (chunk.isFinal &&
+                (finalSanitizers.length > 0 || finalParallel.length > 0)) {
+                const outputEvaluations = [];
+                let workingChunk = currentChunk;
+                // Phase 1: sequential final sanitizers
+                for (const svc of finalSanitizers) {
+                    if (!svc.evaluateOutput) {
+                        continue;
+                    }
+                    const timeoutMs = svc.config?.timeoutMs;
+                    const evaluation = await callWithTimeout(() => svc.evaluateOutput({ context, chunk: workingChunk, ragSources: options.ragSources }), timeoutMs);
+                    if (!evaluation) {
+                        continue;
+                    }
+                    outputEvaluations.push(evaluation);
+                    // BLOCK terminates the stream
+                    if (evaluation.action === GuardrailAction.BLOCK) {
+                        yield* createGuardrailBlockedStream(context, evaluation, options);
+                        return;
+                    }
+                    // SANITIZE: modify finalResponseText or textDelta
+                    if (evaluation.action === GuardrailAction.SANITIZE &&
+                        evaluation.modifiedText !== undefined) {
+                        if (workingChunk.type === AgentOSResponseChunkType.FINAL_RESPONSE) {
+                            workingChunk = {
+                                ...workingChunk,
+                                finalResponseText: evaluation.modifiedText,
+                            };
+                        }
+                        else {
+                            workingChunk = {
+                                ...workingChunk,
+                                textDelta: evaluation.modifiedText,
+                            };
+                        }
+                    }
+                }
+                // Phase 2: parallel final classifiers
+                if (finalParallel.length > 0) {
+                    const tasks = finalParallel.map(({ svc, registrationIndex }) => {
+                        if (!svc.evaluateOutput) {
+                            return Promise.resolve({ evaluation: null, registrationIndex });
+                        }
+                        const timeoutMs = svc.config?.timeoutMs;
+                        return callWithTimeout(() => svc.evaluateOutput({ context, chunk: workingChunk, ragSources: options.ragSources }), timeoutMs).then((evaluation) => ({ evaluation, registrationIndex }));
+                    });
+                    const results = await Promise.allSettled(tasks);
+                    for (const result of results) {
+                        if (result.status === 'rejected') {
+                            console.warn('[AgentOS][Guardrails] Phase 2 final evaluateOutput rejected.', result.reason);
+                            continue;
+                        }
+                        const { evaluation: rawEvaluation, registrationIndex } = result.value;
+                        if (!rawEvaluation) {
+                            continue;
+                        }
+                        // Downgrade SANITIZE → FLAG in Phase 2
+                        const evaluation = downgradePhase2Sanitize(rawEvaluation, registrationIndex);
+                        outputEvaluations.push(evaluation);
+                        // BLOCK terminates the stream
+                        if (evaluation.action === GuardrailAction.BLOCK) {
+                            yield* createGuardrailBlockedStream(context, evaluation, options);
+                            return;
+                        }
+                    }
+                }
+                // Attach output evaluation metadata
+                if (outputEvaluations.length > 0) {
+                    workingChunk = withGuardrailMetadata(workingChunk, {
+                        output: outputEvaluations.map(serializeEvaluation),
+                    });
+                }
+                currentChunk = workingChunk;
+            }
+            yield currentChunk;
+        }
+    }
+}
+//# sourceMappingURL=ParallelGuardrailDispatcher.js.map

package/dist/core/guardrails/ParallelGuardrailDispatcher.js.map

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

package/dist/core/guardrails/guardrailDispatcher.d.ts

@@ -1,6 +1,24 @@
 import type { AgentOSInput } from '../../api/types/AgentOSInput';
 import { AgentOSResponse } from '../../api/types/AgentOSResponse';
-import { type GuardrailContext, type GuardrailEvaluationResult, type IGuardrailService } from './IGuardrailService';
+import { GuardrailAction, type GuardrailContext, type GuardrailEvaluationResult, type IGuardrailService } from './IGuardrailService';
+/**
+ * Normalize a service input (single, array, or undefined) into a flat array.
+ *
+ * Filters out falsy entries so callers never need null-checks.
+ *
+ * @param service - Single guardrail, array of guardrails, or undefined
+ * @returns Non-empty array of valid guardrail services
+ */
+export declare function normalizeServices(service: IGuardrailService | IGuardrailService[] | undefined): IGuardrailService[];
+/**
+ * Type guard to check if a guardrail service implements evaluateOutput.
+ *
+ * @param svc - The guardrail service to inspect
+ * @returns `true` when `svc.evaluateOutput` is a callable function
+ */
+export declare function hasEvaluateOutput(svc: IGuardrailService): svc is IGuardrailService & {
+    evaluateOutput: NonNullable<IGuardrailService['evaluateOutput']>;
+};
 /**
  * Result of running input guardrails.
  *
@@ -25,6 +43,20 @@ export interface GuardrailOutputOptions {
     personaId?: string;
     /** Input evaluations to attach to first output chunk */
     inputEvaluations?: GuardrailEvaluationResult[] | null;
+    /** RAG sources to thread through to output guardrails for grounding verification */
+    ragSources?: import('../../rag').RagRetrievedChunk[];
+}
+/**
+ * Metadata entry attached to response chunks.
+ *
+ * Compact representation of a {@link GuardrailEvaluationResult} that gets
+ * embedded into chunk `metadata.guardrail.input[]` / `metadata.guardrail.output[]`.
+ */
+export interface GuardrailMetadataEntry {
+    action: GuardrailAction;
+    reason?: string;
+    reasonCode?: string;
+    metadata?: Record<string, unknown>;
 }
 /**
  * Evaluate user input through all registered guardrails.
@@ -121,4 +153,30 @@ export declare function createGuardrailBlockedStream(context: GuardrailContext,
  * ```
  */
 export declare function wrapOutputGuardrails(service: IGuardrailService | IGuardrailService[] | undefined, context: GuardrailContext, stream: AsyncGenerator<AgentOSResponse, void, undefined>, options: GuardrailOutputOptions): AsyncGenerator<AgentOSResponse, void, undefined>;
+/**
+ * Convert a full {@link GuardrailEvaluationResult} into the compact
+ * {@link GuardrailMetadataEntry} shape that gets embedded in chunk metadata.
+ *
+ * Strips heavy fields (`details`, `modifiedText`) that are not needed
+ * for downstream telemetry / observability.
+ *
+ * @param evaluation - The evaluation to serialize
+ * @returns A lightweight metadata entry suitable for chunk embedding
+ */
+export declare function serializeEvaluation(evaluation: GuardrailEvaluationResult): GuardrailMetadataEntry;
+/**
+ * Attach guardrail evaluation metadata to a response chunk.
+ *
+ * Merges new input/output evaluation entries into any existing
+ * `metadata.guardrail` structure on the chunk. The result is a
+ * shallow-cloned chunk — the original is never mutated.
+ *
+ * @param chunk   - The response chunk to annotate
+ * @param entry   - Input and/or output metadata entries to merge
+ * @returns A new chunk with guardrail metadata merged in
+ */
+export declare function withGuardrailMetadata(chunk: AgentOSResponse, entry: {
+    input?: GuardrailMetadataEntry | GuardrailMetadataEntry[];
+    output?: GuardrailMetadataEntry | GuardrailMetadataEntry[];
+}): AgentOSResponse;
 //# sourceMappingURL=guardrailDispatcher.d.ts.map

package/dist/core/guardrails/guardrailDispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guardrailDispatcher.d.ts","sourceRoot":"","sources":["../../../src/core/guardrails/guardrailDispatcher.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EACL,eAAe,EAIhB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAc7B;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,cAAc,EAAE,YAAY,CAAC;IAE7B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAE9C,iDAAiD;IACjD,WAAW,CAAC,EAAE,yBAAyB,EAAE,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,yBAAyB,EAAE,GAAG,IAAI,CAAC;CACvD;AAaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,SAAS,EAC5D,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,qBAAqB,CAAC,CAmDhC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAuB,4BAA4B,CACjD,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,yBAAyB,EACrC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,CAkBlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAuB,oBAAoB,CACzC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,SAAS,EAC5D,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,EACxD,OAAO,EAAE,sBAAsB,GAC9B,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,CA8IlD"}
+{"version":3,"file":"guardrailDispatcher.d.ts","sourceRoot":"","sources":["../../../src/core/guardrails/guardrailDispatcher.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EACL,eAAe,EAGhB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAG7B;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,SAAS,GAC3D,iBAAiB,EAAE,CAMrB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,iBAAiB,GACrB,GAAG,IAAI,iBAAiB,GAAG;IAC5B,cAAc,EAAE,WAAW,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,CAAC;CAClE,CAEA;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,cAAc,EAAE,YAAY,CAAC;IAE7B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAE9C,iDAAiD;IACjD,WAAW,CAAC,EAAE,yBAAyB,EAAE,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,yBAAyB,EAAE,GAAG,IAAI,CAAC;IAEtD,oFAAoF;IACpF,UAAU,CAAC,EAAE,OAAO,WAAW,EAAE,iBAAiB,EAAE,CAAC;CACtD;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,SAAS,EAC5D,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,qBAAqB,CAAC,CAIhC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAuB,4BAA4B,CACjD,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,yBAAyB,EACrC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,CAkBlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAuB,oBAAoB,CACzC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,GAAG,SAAS,EAC5D,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,EACxD,OAAO,EAAE,sBAAsB,GAC9B,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,CAIlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,yBAAyB,GAAG,sBAAsB,CAOjG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE;IACL,KAAK,CAAC,EAAE,sBAAsB,GAAG,sBAAsB,EAAE,CAAC;IAC1D,MAAM,CAAC,EAAE,sBAAsB,GAAG,sBAAsB,EAAE,CAAC;CAC5D,GACA,eAAe,CAkCjB"}