@framers/agentos 0.1.1 → 0.1.3

package/dist/core/guardrails/crossAgentGuardrailDispatcher.js

@@ -0,0 +1,221 @@
+/**
+ * @module crossAgentGuardrailDispatcher
+ *
+ * Dispatcher for cross-agent guardrail evaluations.
+ *
+ * Enables supervisor/observer guardrails to monitor and intervene in
+ * other agents' output streams within an agency.
+ *
+ * @example
+ * ```typescript
+ * // Wrap an agent's output with cross-agent guardrail supervision
+ * const supervisedStream = wrapWithCrossAgentGuardrails(
+ *   crossAgentGuardrails,
+ *   { sourceAgentId: 'worker-1', observerAgentId: 'supervisor', agencyId: 'agency-1' },
+ *   guardrailContext,
+ *   workerOutputStream,
+ *   { streamId: 'stream-123' }
+ * );
+ * ```
+ */
+import { AgentOSResponseChunkType } from '../../api/types/AgentOSResponse.js';
+import { GuardrailAction, } from './IGuardrailService.js';
+import { isCrossAgentGuardrail, shouldObserveAgent, } from './ICrossAgentGuardrailService.js';
+import { createGuardrailBlockedStream } from './guardrailDispatcher.js';
+/**
+ * Evaluate a chunk through all applicable cross-agent guardrails.
+ *
+ * Filters guardrails to only those observing the source agent, then
+ * evaluates the chunk through each. Respects `canInterruptOthers` flag.
+ *
+ * @param guardrails - Cross-agent guardrails to evaluate
+ * @param crossAgentContext - Source/observer agent context
+ * @param guardrailContext - Standard guardrail context
+ * @param chunk - The output chunk to evaluate
+ * @returns Evaluation result with blocked status and any modifications
+ *
+ * @example
+ * ```typescript
+ * const result = await evaluateCrossAgentGuardrails(
+ *   crossAgentGuardrails,
+ *   { sourceAgentId: 'worker-1', observerAgentId: 'supervisor' },
+ *   guardrailContext,
+ *   textDeltaChunk
+ * );
+ *
+ * if (result.blocked) {
+ *   // Terminate the source agent's stream
+ * } else if (result.modifiedChunk) {
+ *   // Use the sanitized chunk
+ * }
+ * ```
+ */
+export async function evaluateCrossAgentGuardrails(guardrails, crossAgentContext, guardrailContext, chunk) {
+    const evaluations = [];
+    let currentChunk = chunk;
+    let blocked = false;
+    // Filter to guardrails that should observe this agent
+    const applicableGuardrails = guardrails.filter((g) => shouldObserveAgent(g, crossAgentContext.sourceAgentId));
+    for (const guardrail of applicableGuardrails) {
+        // Skip if no cross-agent evaluation method
+        if (typeof guardrail.evaluateCrossAgentOutput !== 'function') {
+            continue;
+        }
+        // Check if this guardrail evaluates streaming chunks
+        const isStreamingChunk = currentChunk.type === AgentOSResponseChunkType.TEXT_DELTA && !currentChunk.isFinal;
+        if (isStreamingChunk && !guardrail.config?.evaluateStreamingChunks) {
+            continue;
+        }
+        // Build payload
+        const payload = {
+            sourceAgentId: crossAgentContext.sourceAgentId,
+            observerAgentId: crossAgentContext.observerAgentId,
+            agencyId: crossAgentContext.agencyId,
+            chunk: currentChunk,
+            context: guardrailContext,
+        };
+        let evaluation = null;
+        try {
+            evaluation = await guardrail.evaluateCrossAgentOutput(payload);
+        }
+        catch (error) {
+            console.warn('[AgentOS][CrossAgentGuardrails] evaluateCrossAgentOutput failed.', error);
+            continue;
+        }
+        if (!evaluation) {
+            continue;
+        }
+        // Downgrade BLOCK/SANITIZE to FLAG if canInterruptOthers is false
+        if (!guardrail.canInterruptOthers) {
+            if (evaluation.action === GuardrailAction.BLOCK ||
+                evaluation.action === GuardrailAction.SANITIZE) {
+                evaluation = {
+                    ...evaluation,
+                    action: GuardrailAction.FLAG,
+                    metadata: {
+                        ...evaluation.metadata,
+                        originalAction: evaluation.action,
+                        downgraded: true,
+                    },
+                };
+            }
+        }
+        evaluations.push(evaluation);
+        // Handle actions
+        if (evaluation.action === GuardrailAction.BLOCK) {
+            blocked = true;
+            break;
+        }
+        if (evaluation.action === GuardrailAction.SANITIZE &&
+            evaluation.modifiedText !== undefined) {
+            // Modify the chunk based on type
+            if (currentChunk.type === AgentOSResponseChunkType.TEXT_DELTA) {
+                currentChunk = {
+                    ...currentChunk,
+                    textDelta: evaluation.modifiedText,
+                };
+            }
+            else if (currentChunk.type === AgentOSResponseChunkType.FINAL_RESPONSE) {
+                currentChunk = {
+                    ...currentChunk,
+                    finalResponseText: evaluation.modifiedText,
+                };
+            }
+        }
+    }
+    return {
+        blocked,
+        modifiedChunk: currentChunk !== chunk ? currentChunk : undefined,
+        evaluations,
+    };
+}
+/**
+ * Wrap an agent's output stream with cross-agent guardrail supervision.
+ *
+ * Creates an async generator that evaluates each chunk through applicable
+ * cross-agent guardrails before yielding. If any guardrail returns BLOCK
+ * (and has `canInterruptOthers: true`), the stream is terminated.
+ *
+ * @param guardrails - Cross-agent guardrails to apply
+ * @param crossAgentContext - Source/observer agent context
+ * @param guardrailContext - Standard guardrail context
+ * @param stream - Source agent's output stream
+ * @param options - Stream options
+ * @returns Supervised stream with cross-agent guardrail filtering
+ *
+ * @example
+ * ```typescript
+ * // Supervisor monitors worker agent
+ * const supervisedStream = wrapWithCrossAgentGuardrails(
+ *   [qualityGate, policyEnforcer],
+ *   {
+ *     sourceAgentId: 'worker-analyst',
+ *     observerAgentId: 'supervisor',
+ *     agencyId: 'research-agency'
+ *   },
+ *   guardrailContext,
+ *   workerStream,
+ *   { streamId: 'stream-xyz' }
+ * );
+ *
+ * for await (const chunk of supervisedStream) {
+ *   // Chunk has been approved/modified by cross-agent guardrails
+ *   yield chunk;
+ * }
+ * ```
+ */
+export async function* wrapWithCrossAgentGuardrails(guardrails, crossAgentContext, guardrailContext, stream, options) {
+    // Filter to applicable guardrails once
+    const applicableGuardrails = guardrails.filter((g) => shouldObserveAgent(g, crossAgentContext.sourceAgentId));
+    // If no applicable guardrails, pass through unchanged
+    if (applicableGuardrails.length === 0) {
+        yield* stream;
+        return;
+    }
+    for await (const chunk of stream) {
+        const result = await evaluateCrossAgentGuardrails(applicableGuardrails, crossAgentContext, guardrailContext, chunk);
+        if (result.blocked) {
+            // Find the blocking evaluation for the error message
+            const blockingEval = result.evaluations.find((e) => e.action === GuardrailAction.BLOCK);
+            if (blockingEval) {
+                yield* createGuardrailBlockedStream(guardrailContext, blockingEval, options);
+            }
+            return;
+        }
+        // Yield the (potentially modified) chunk
+        const outputChunk = result.modifiedChunk ?? chunk;
+        // Attach cross-agent evaluation metadata
+        if (result.evaluations.length > 0) {
+            const metadata = outputChunk.metadata ?? {};
+            yield {
+                ...outputChunk,
+                metadata: {
+                    ...metadata,
+                    crossAgentGuardrail: {
+                        evaluations: result.evaluations.map((e) => ({
+                            action: e.action,
+                            reason: e.reason,
+                            reasonCode: e.reasonCode,
+                            metadata: e.metadata,
+                        })),
+                        sourceAgentId: crossAgentContext.sourceAgentId,
+                        observerAgentId: crossAgentContext.observerAgentId,
+                    },
+                },
+            };
+        }
+        else {
+            yield outputChunk;
+        }
+    }
+}
+/**
+ * Extract cross-agent guardrails from a mixed array of guardrail services.
+ *
+ * @param services - Array of guardrail services (may include non-cross-agent)
+ * @returns Only the cross-agent guardrail services
+ */
+export function filterCrossAgentGuardrails(services) {
+    return services.filter((s) => s != null && typeof s === 'object' && isCrossAgentGuardrail(s));
+}
+//# sourceMappingURL=crossAgentGuardrailDispatcher.js.map

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

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

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

@@ -2,35 +2,123 @@ import type { AgentOSInput } from '../../api/types/AgentOSInput';
 import { AgentOSResponse } from '../../api/types/AgentOSResponse';
 import { type GuardrailContext, type GuardrailEvaluationResult, type IGuardrailService } from './IGuardrailService';
 /**
- * Outcome of an input guardrail evaluation.
+ * Result of running input guardrails.
+ *
+ * Contains the potentially modified input and all evaluation results.
+ * Check `evaluation.action` to determine if processing should continue.
  */
 export interface GuardrailInputOutcome {
+    /** Input after all sanitization (may be modified from original) */
     sanitizedInput: AgentOSInput;
+    /** The last evaluation result (for backwards compatibility) */
     evaluation?: GuardrailEvaluationResult | null;
+    /** All evaluation results from all guardrails */
     evaluations?: GuardrailEvaluationResult[];
 }
+/**
+ * Options for output guardrail wrapping.
+ */
 export interface GuardrailOutputOptions {
+    /** Stream identifier for error chunks */
     streamId: string;
+    /** Persona ID for error chunks */
     personaId?: string;
+    /** Input evaluations to attach to first output chunk */
     inputEvaluations?: GuardrailEvaluationResult[] | null;
 }
 /**
- * Runs the guardrail service against the inbound request.
- * Returns the (potentially modified) input and the evaluation metadata.
+ * Evaluate user input through all registered guardrails.
+ *
+ * Runs guardrails in sequence, allowing each to modify or block the input.
+ * If any guardrail returns {@link GuardrailAction.BLOCK}, evaluation stops
+ * immediately and the blocked result is returned.
+ *
+ * @param service - Single guardrail or array of guardrails to evaluate
+ * @param input - User input to evaluate
+ * @param context - Conversation context for policy decisions
+ * @returns Outcome containing sanitized input and all evaluations
+ *
+ * @example
+ * ```typescript
+ * const outcome = await evaluateInputGuardrails(
+ *   [contentFilter, piiRedactor],
+ *   userInput,
+ *   { userId: 'user-123', sessionId: 'session-abc' }
+ * );
+ *
+ * if (outcome.evaluation?.action === GuardrailAction.BLOCK) {
+ *   // Input was blocked - return error stream
+ *   yield* createGuardrailBlockedStream(context, outcome.evaluation);
+ *   return;
+ * }
+ *
+ * // Use sanitized input for orchestration
+ * const cleanInput = outcome.sanitizedInput;
+ * ```
  */
 export declare function evaluateInputGuardrails(service: IGuardrailService | IGuardrailService[] | undefined, input: AgentOSInput, context: GuardrailContext): Promise<GuardrailInputOutcome>;
 /**
- * Creates an async generator that emits a terminal guardrail error chunk.
+ * Create a stream that emits a single error chunk for blocked content.
+ *
+ * Use this when input evaluation returns {@link GuardrailAction.BLOCK}
+ * to generate an appropriate error response without invoking orchestration.
+ *
+ * @param context - Guardrail context for the error details
+ * @param evaluation - The blocking evaluation result
+ * @param options - Stream options (streamId, personaId)
+ * @returns Async generator yielding a single ERROR chunk
+ *
+ * @example
+ * ```typescript
+ * if (outcome.evaluation?.action === GuardrailAction.BLOCK) {
+ *   yield* createGuardrailBlockedStream(
+ *     guardrailContext,
+ *     outcome.evaluation,
+ *     { streamId: 'stream-123', personaId: 'support-agent' }
+ *   );
+ *   return;
+ * }
+ * ```
  */
 export declare function createGuardrailBlockedStream(context: GuardrailContext, evaluation: GuardrailEvaluationResult, options?: GuardrailOutputOptions): AsyncGenerator<AgentOSResponse, void, undefined>;
 /**
- * Wraps a response stream and applies guardrail checks before yielding chunks
- * to the host.
+ * Wrap a response stream with guardrail filtering.
+ *
+ * Creates an async generator that evaluates each chunk through registered
+ * guardrails before yielding to the client. Supports both real-time streaming
+ * evaluation and final-only evaluation based on guardrail configuration.
  *
  * **Evaluation Strategy:**
- * - Guardrails with `config.evaluateStreamingChunks === true` evaluate TEXT_DELTA chunks (real-time)
- * - All guardrails evaluate FINAL_RESPONSE chunks (final check)
- * - This allows cost/performance tradeoffs per guardrail
+ * - Guardrails with `config.evaluateStreamingChunks === true` evaluate TEXT_DELTA chunks
+ * - All guardrails evaluate FINAL_RESPONSE chunks (final safety check)
+ * - Rate limiting via `config.maxStreamingEvaluations` per guardrail
+ *
+ * **Actions:**
+ * - {@link GuardrailAction.BLOCK} - Terminates stream immediately with error chunk
+ * - {@link GuardrailAction.SANITIZE} - Replaces chunk content with `modifiedText`
+ * - {@link GuardrailAction.FLAG} / {@link GuardrailAction.ALLOW} - Passes through
+ *
+ * @param service - Single guardrail or array of guardrails
+ * @param context - Conversation context for policy decisions
+ * @param stream - Source response stream to wrap
+ * @param options - Stream options and input evaluations to attach
+ * @returns Wrapped stream with guardrail filtering applied
+ *
+ * @example
+ * ```typescript
+ * // Wrap output stream with PII redaction
+ * const safeStream = wrapOutputGuardrails(
+ *   [piiRedactor, contentFilter],
+ *   guardrailContext,
+ *   orchestratorStream,
+ *   { streamId: 'stream-123', inputEvaluations }
+ * );
+ *
+ * for await (const chunk of safeStream) {
+ *   // Chunks are filtered/sanitized before reaching here
+ *   yield chunk;
+ * }
+ * ```
  */
 export declare function wrapOutputGuardrails(service: IGuardrailService | IGuardrailService[] | undefined, context: GuardrailContext, stream: AsyncGenerator<AgentOSResponse, void, undefined>, options: GuardrailOutputOptions): AsyncGenerator<AgentOSResponse, void, undefined>;
 //# 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":"AACA,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;AAW7B;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,YAAY,CAAC;IAC7B,UAAU,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,EAAE,yBAAyB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,yBAAyB,EAAE,GAAG,IAAI,CAAC;CACvD;AASD;;;GAGG;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;;GAEG;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;;;;;;;;GAQG;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,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"}

package/dist/core/guardrails/guardrailDispatcher.js

@@ -1,13 +1,73 @@
+/**
+ * @module guardrailDispatcher
+ *
+ * Dispatches guardrail evaluations for input and output processing.
+ *
+ * This module provides two main functions:
+ * - {@link evaluateInputGuardrails} - Evaluate user input before orchestration
+ * - {@link wrapOutputGuardrails} - Wrap output stream with guardrail filtering
+ *
+ * @example
+ * ```typescript
+ * // Input evaluation
+ * const outcome = await evaluateInputGuardrails(
+ *   guardrailServices,
+ *   userInput,
+ *   guardrailContext
+ * );
+ *
+ * if (outcome.evaluation?.action === GuardrailAction.BLOCK) {
+ *   return createGuardrailBlockedStream(context, outcome.evaluation);
+ * }
+ *
+ * // Output wrapping
+ * const safeStream = wrapOutputGuardrails(
+ *   guardrailServices,
+ *   guardrailContext,
+ *   outputStream,
+ *   { streamId, personaId }
+ * );
+ * ```
+ */
 import { uuidv4 } from '../../utils/uuid.js';
 import { AgentOSResponseChunkType, } from '../../api/types/AgentOSResponse.js';
 import { GuardrailAction, } from './IGuardrailService.js';
-// Type guard to narrow services that implement evaluateOutput
+/**
+ * Type guard to check if a guardrail service implements evaluateOutput.
+ * @internal
+ */
 function hasEvaluateOutput(svc) {
     return typeof svc.evaluateOutput === 'function';
 }
 /**
- * Runs the guardrail service against the inbound request.
- * Returns the (potentially modified) input and the evaluation metadata.
+ * Evaluate user input through all registered guardrails.
+ *
+ * Runs guardrails in sequence, allowing each to modify or block the input.
+ * If any guardrail returns {@link GuardrailAction.BLOCK}, evaluation stops
+ * immediately and the blocked result is returned.
+ *
+ * @param service - Single guardrail or array of guardrails to evaluate
+ * @param input - User input to evaluate
+ * @param context - Conversation context for policy decisions
+ * @returns Outcome containing sanitized input and all evaluations
+ *
+ * @example
+ * ```typescript
+ * const outcome = await evaluateInputGuardrails(
+ *   [contentFilter, piiRedactor],
+ *   userInput,
+ *   { userId: 'user-123', sessionId: 'session-abc' }
+ * );
+ *
+ * if (outcome.evaluation?.action === GuardrailAction.BLOCK) {
+ *   // Input was blocked - return error stream
+ *   yield* createGuardrailBlockedStream(context, outcome.evaluation);
+ *   return;
+ * }
+ *
+ * // Use sanitized input for orchestration
+ * const cleanInput = outcome.sanitizedInput;
+ * ```
  */
 export async function evaluateInputGuardrails(service, input, context) {
     const services = Array.isArray(service)
@@ -54,7 +114,27 @@ export async function evaluateInputGuardrails(service, input, context) {
     };
 }
 /**
- * Creates an async generator that emits a terminal guardrail error chunk.
+ * Create a stream that emits a single error chunk for blocked content.
+ *
+ * Use this when input evaluation returns {@link GuardrailAction.BLOCK}
+ * to generate an appropriate error response without invoking orchestration.
+ *
+ * @param context - Guardrail context for the error details
+ * @param evaluation - The blocking evaluation result
+ * @param options - Stream options (streamId, personaId)
+ * @returns Async generator yielding a single ERROR chunk
+ *
+ * @example
+ * ```typescript
+ * if (outcome.evaluation?.action === GuardrailAction.BLOCK) {
+ *   yield* createGuardrailBlockedStream(
+ *     guardrailContext,
+ *     outcome.evaluation,
+ *     { streamId: 'stream-123', personaId: 'support-agent' }
+ *   );
+ *   return;
+ * }
+ * ```
  */
 export async function* createGuardrailBlockedStream(context, evaluation, options) {
     const streamId = options?.streamId ?? uuidv4();
@@ -76,13 +156,43 @@ export async function* createGuardrailBlockedStream(context, evaluation, options
     yield errorChunk;
 }
 /**
- * Wraps a response stream and applies guardrail checks before yielding chunks
- * to the host.
+ * Wrap a response stream with guardrail filtering.
+ *
+ * Creates an async generator that evaluates each chunk through registered
+ * guardrails before yielding to the client. Supports both real-time streaming
+ * evaluation and final-only evaluation based on guardrail configuration.
  *
  * **Evaluation Strategy:**
- * - Guardrails with `config.evaluateStreamingChunks === true` evaluate TEXT_DELTA chunks (real-time)
- * - All guardrails evaluate FINAL_RESPONSE chunks (final check)
- * - This allows cost/performance tradeoffs per guardrail
+ * - Guardrails with `config.evaluateStreamingChunks === true` evaluate TEXT_DELTA chunks
+ * - All guardrails evaluate FINAL_RESPONSE chunks (final safety check)
+ * - Rate limiting via `config.maxStreamingEvaluations` per guardrail
+ *
+ * **Actions:**
+ * - {@link GuardrailAction.BLOCK} - Terminates stream immediately with error chunk
+ * - {@link GuardrailAction.SANITIZE} - Replaces chunk content with `modifiedText`
+ * - {@link GuardrailAction.FLAG} / {@link GuardrailAction.ALLOW} - Passes through
+ *
+ * @param service - Single guardrail or array of guardrails
+ * @param context - Conversation context for policy decisions
+ * @param stream - Source response stream to wrap
+ * @param options - Stream options and input evaluations to attach
+ * @returns Wrapped stream with guardrail filtering applied
+ *
+ * @example
+ * ```typescript
+ * // Wrap output stream with PII redaction
+ * const safeStream = wrapOutputGuardrails(
+ *   [piiRedactor, contentFilter],
+ *   guardrailContext,
+ *   orchestratorStream,
+ *   { streamId: 'stream-123', inputEvaluations }
+ * );
+ *
+ * for await (const chunk of safeStream) {
+ *   // Chunks are filtered/sanitized before reaching here
+ *   yield chunk;
+ * }
+ * ```
  */
 export async function* wrapOutputGuardrails(service, context, stream, options) {
     const services = Array.isArray(service)

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

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

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

@@ -0,0 +1,52 @@
+/**
+ * @module guardrails
+ *
+ * Guardrails system for content safety and policy enforcement.
+ *
+ * Guardrails intercept content at two points:
+ * 1. **Input** - Before user messages enter the orchestration pipeline
+ * 2. **Output** - Before agent responses are streamed to the client
+ *
+ * @example Basic guardrail
+ * ```typescript
+ * import {
+ *   IGuardrailService,
+ *   GuardrailAction,
+ *   type GuardrailInputPayload
+ * } from '../../core/guardrails';
+ *
+ * class ContentFilter implements IGuardrailService {
+ *   async evaluateInput({ input }: GuardrailInputPayload) {
+ *     if (containsProhibitedContent(input.textInput)) {
+ *       return {
+ *         action: GuardrailAction.BLOCK,
+ *         reason: 'Content policy violation'
+ *       };
+ *     }
+ *     return null;
+ *   }
+ * }
+ * ```
+ *
+ * @example Cross-agent supervision
+ * ```typescript
+ * import {
+ *   ICrossAgentGuardrailService,
+ *   GuardrailAction
+ * } from '../../core/guardrails';
+ *
+ * class SupervisorGuardrail implements ICrossAgentGuardrailService {
+ *   observeAgentIds = ['worker-1', 'worker-2'];
+ *   canInterruptOthers = true;
+ *
+ *   async evaluateCrossAgentOutput({ sourceAgentId, chunk }) {
+ *     // Supervise worker agents' outputs
+ *   }
+ * }
+ * ```
+ */
+export { GuardrailAction, type GuardrailConfig, type GuardrailContext, type GuardrailEvaluationResult, type GuardrailInputPayload, type GuardrailOutputPayload, type IGuardrailService, } from './IGuardrailService';
+export { createGuardrailBlockedStream, evaluateInputGuardrails, type GuardrailInputOutcome, type GuardrailOutputOptions, wrapOutputGuardrails, } from './guardrailDispatcher';
+export { type CrossAgentOutputPayload, type ICrossAgentGuardrailService, isCrossAgentGuardrail, shouldObserveAgent, } from './ICrossAgentGuardrailService';
+export { type CrossAgentEvaluationResult, type CrossAgentGuardrailContext, evaluateCrossAgentGuardrails, filterCrossAgentGuardrails, wrapWithCrossAgentGuardrails, } from './crossAgentGuardrailDispatcher';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/guardrails/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAGH,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC"}