@directive-run/ai 0.1.1

package/dist/testing.d.cts

@@ -0,0 +1,345 @@
+import { AgentOrchestrator, OrchestratorOptions } from './index.cjs';
+import { A as ApprovalRequest, I as InputGuardrailData, O as OutputGuardrailData, M as Message, T as ToolCallGuardrailData, a as ToolCall, G as GuardrailResult, b as AgentLike, c as AgentRunner, R as RunOptions, d as GuardrailFn, e as GuardrailContext } from './types-BKCdgKC-.cjs';
+import '@directive-run/core';
+import '@directive-run/core/plugins';
+
+/**
+ * OpenAI Agents Testing Utilities
+ *
+ * Provides testing helpers for:
+ * - Mock agent runners with configurable responses
+ * - Guardrail testing with assertions
+ * - Approval workflow simulation
+ * - Snapshot testing for constraint evaluation
+ *
+ * @example
+ * ```typescript
+ * import { createMockAgentRunner, testGuardrail, createApprovalSimulator } from '@directive-run/ai';
+ *
+ * describe('MyOrchestrator', () => {
+ *   it('should block PII in input', async () => {
+ *     const result = await testGuardrail(createPIIGuardrail(), {
+ *       input: 'My SSN is 123-45-6789',
+ *     });
+ *     expect(result.passed).toBe(false);
+ *     expect(result.reason).toContain('PII');
+ *   });
+ * });
+ * ```
+ */
+
+/** Configuration for mock agent responses */
+interface MockAgentConfig<T = unknown> {
+    /** Final output to return */
+    output: T;
+    /** Messages to emit during run */
+    messages?: Message[];
+    /** Tool calls to emit during run */
+    toolCalls?: ToolCall[];
+    /** Total tokens to report */
+    totalTokens?: number;
+    /** Delay before responding (ms) */
+    delay?: number;
+    /** Error to throw instead of returning */
+    error?: Error;
+    /** Function to generate dynamic responses */
+    generate?: (input: string, agent: AgentLike) => Partial<MockAgentConfig<T>>;
+}
+/** Mock agent runner options */
+interface MockAgentRunnerOptions {
+    /** Default response for unmatched agents */
+    defaultResponse?: MockAgentConfig;
+    /** Responses keyed by agent name */
+    responses?: Record<string, MockAgentConfig>;
+    /** Record all calls for assertions */
+    recordCalls?: boolean;
+    /** Callback for each run */
+    onRun?: (agent: AgentLike, input: string) => void;
+}
+/** Recorded call for assertions */
+interface RecordedCall {
+    agent: AgentLike;
+    input: string;
+    options?: RunOptions;
+    timestamp: number;
+}
+/** Mock agent runner instance */
+interface MockAgentRunner {
+    /** The run function to pass to orchestrator */
+    run: AgentRunner;
+    /** Get all recorded calls */
+    getCalls(): RecordedCall[];
+    /** Get calls for a specific agent */
+    getCallsFor(agentName: string): RecordedCall[];
+    /** Clear recorded calls */
+    clearCalls(): void;
+    /** Set response for an agent */
+    setResponse<T>(agentName: string, config: MockAgentConfig<T>): void;
+    /** Set default response */
+    setDefaultResponse<T>(config: MockAgentConfig<T>): void;
+}
+/**
+ * Create a mock agent runner for testing.
+ *
+ * @example
+ * ```typescript
+ * const mock = createMockAgentRunner({
+ *   responses: {
+ *     'my-agent': {
+ *       output: 'Hello, world!',
+ *       totalTokens: 100,
+ *     },
+ *   },
+ * });
+ *
+ * const orchestrator = createAgentOrchestrator({ runner: mock.run });
+ * const result = await orchestrator.run(myAgent, 'Hi');
+ *
+ * expect(result.output).toBe('Hello, world!');
+ * expect(mock.getCalls()).toHaveLength(1);
+ * ```
+ */
+declare function createMockAgentRunner(options?: MockAgentRunnerOptions): MockAgentRunner;
+/** Test input for guardrail testing */
+type GuardrailTestInput<T> = T extends InputGuardrailData ? {
+    input: string;
+    agentName?: string;
+} : T extends OutputGuardrailData ? {
+    output: unknown;
+    agentName?: string;
+    input?: string;
+    messages?: Message[];
+} : T extends ToolCallGuardrailData ? {
+    toolCall: ToolCall;
+    agentName?: string;
+    input?: string;
+} : Partial<T>;
+/** Extended guardrail result with test assertions */
+interface GuardrailTestResult extends GuardrailResult {
+    /** Time taken to evaluate (ms) */
+    duration: number;
+    /** The data that was tested */
+    testedData: unknown;
+    /** Assert that the guardrail passed */
+    assertPassed(): void;
+    /** Assert that the guardrail failed */
+    assertFailed(expectedReason?: string | RegExp): void;
+    /** Assert that transformation occurred */
+    assertTransformed(expected?: unknown): void;
+}
+/**
+ * Test a guardrail with assertions.
+ *
+ * @example
+ * ```typescript
+ * // Test PII detection
+ * const result = await testGuardrail(createPIIGuardrail(), {
+ *   input: 'My SSN is 123-45-6789',
+ * });
+ * result.assertFailed(/PII/);
+ *
+ * // Test input transformation
+ * const redactResult = await testGuardrail(createPIIGuardrail({ redact: true }), {
+ *   input: 'My SSN is 123-45-6789',
+ * });
+ * redactResult.assertPassed();
+ * redactResult.assertTransformed();
+ * ```
+ */
+declare function testGuardrail<T>(guardrail: GuardrailFn<T>, testInput: GuardrailTestInput<T>, context?: Partial<GuardrailContext>): Promise<GuardrailTestResult>;
+/**
+ * Test multiple inputs against a guardrail.
+ *
+ * @example
+ * ```typescript
+ * const results = await testGuardrailBatch(createPIIGuardrail(), [
+ *   { input: 'Hello world', expect: 'pass' },
+ *   { input: 'My SSN is 123-45-6789', expect: 'fail' },
+ *   { input: 'Email: test@example.com', expect: 'fail' },
+ * ]);
+ *
+ * expect(results.allPassed()).toBe(true);
+ * ```
+ */
+declare function testGuardrailBatch<T>(guardrail: GuardrailFn<T>, testCases: Array<{
+    input: GuardrailTestInput<T>;
+    expect: "pass" | "fail" | "transform";
+    context?: Partial<GuardrailContext>;
+}>): Promise<{
+    results: GuardrailTestResult[];
+    allPassed(): boolean;
+    failures(): Array<{
+        index: number;
+        expected: string;
+        actual: GuardrailTestResult;
+    }>;
+}>;
+/** Approval simulator options */
+interface ApprovalSimulatorOptions {
+    /** Auto-approve requests matching this predicate */
+    autoApprove?: (request: ApprovalRequest) => boolean;
+    /** Auto-reject requests matching this predicate */
+    autoReject?: (request: ApprovalRequest) => boolean | string;
+    /** Delay before auto-approval/rejection (ms) */
+    delay?: number;
+    /** Record all requests for assertions */
+    recordRequests?: boolean;
+}
+/** Approval simulator instance */
+interface ApprovalSimulator {
+    /** Handle an approval request */
+    handle(request: ApprovalRequest): Promise<"approved" | "rejected">;
+    /** Get all recorded requests */
+    getRequests(): ApprovalRequest[];
+    /** Clear recorded requests */
+    clearRequests(): void;
+    /** Manually approve a request */
+    approve(requestId: string): void;
+    /** Manually reject a request */
+    reject(requestId: string, reason?: string): void;
+    /** Wait for a specific request */
+    waitForRequest(predicate: (req: ApprovalRequest) => boolean, timeoutMs?: number): Promise<ApprovalRequest>;
+}
+/**
+ * Create an approval simulator for testing approval workflows.
+ *
+ * @example
+ * ```typescript
+ * const simulator = createApprovalSimulator({
+ *   autoApprove: (req) => req.type === 'tool_call' && req.data.name === 'search',
+ *   autoReject: (req) => req.type === 'tool_call' && req.data.name === 'delete',
+ * });
+ *
+ * // Use in tests
+ * orchestrator.onApprovalRequest = (req) => simulator.handle(req);
+ * ```
+ */
+declare function createApprovalSimulator(options?: ApprovalSimulatorOptions): ApprovalSimulator;
+/** Options for test orchestrator */
+interface TestOrchestratorOptions<F extends Record<string, unknown>> extends Omit<OrchestratorOptions<F>, "runner"> {
+    /** Mock responses for agents */
+    mockResponses?: Record<string, MockAgentConfig>;
+    /** Default mock response */
+    defaultMockResponse?: MockAgentConfig;
+}
+/** Test orchestrator with additional testing utilities */
+interface TestOrchestrator<F extends Record<string, unknown>> extends AgentOrchestrator<F> {
+    /** The mock runner */
+    mockRunner: MockAgentRunner;
+    /** Approval simulator */
+    approvalSimulator: ApprovalSimulator;
+    /** Get recorded agent calls */
+    getCalls(): RecordedCall[];
+    /** Get approval requests */
+    getApprovalRequests(): ApprovalRequest[];
+    /** Reset all state */
+    resetAll(): void;
+}
+/**
+ * Create a test orchestrator with mocking and simulation built in.
+ *
+ * @example
+ * ```typescript
+ * const test = createTestOrchestrator({
+ *   mockResponses: {
+ *     'my-agent': { output: 'test response' },
+ *   },
+ *   constraints: {
+ *     needsApproval: {
+ *       when: () => true,
+ *       require: { type: 'NEED_APPROVAL' },
+ *     },
+ *   },
+ * });
+ *
+ * await test.run(myAgent, 'Hello');
+ * expect(test.getCalls()).toHaveLength(1);
+ * ```
+ */
+declare function createTestOrchestrator<F extends Record<string, unknown> = Record<string, never>>(options?: TestOrchestratorOptions<F>): TestOrchestrator<F>;
+/** Constraint evaluation snapshot */
+interface ConstraintSnapshot {
+    constraintId: string;
+    triggered: boolean;
+    requirement?: unknown;
+    facts: Record<string, unknown>;
+    timestamp: number;
+}
+/**
+ * Create a constraint evaluation recorder for snapshot testing.
+ *
+ * @example
+ * ```typescript
+ * const recorder = createConstraintRecorder();
+ * const orchestrator = createAgentOrchestrator({
+ *   plugins: [recorder.plugin],
+ * });
+ *
+ * await orchestrator.run(agent, 'Hello');
+ *
+ * expect(recorder.getSnapshots()).toMatchSnapshot();
+ * ```
+ */
+declare function createConstraintRecorder(): {
+    plugin: {
+        name: string;
+        onRequirementCreated: (data: {
+            constraintId: string;
+            requirement: unknown;
+            facts: unknown;
+        }) => void;
+    };
+    getSnapshots(): ConstraintSnapshot[];
+    clearSnapshots(): void;
+};
+/**
+ * Assert that an orchestrator has specific state.
+ *
+ * @example
+ * ```typescript
+ * assertOrchestratorState(orchestrator, {
+ *   agentStatus: 'completed',
+ *   tokenUsage: { min: 0, max: 1000 },
+ *   pendingApprovals: 0,
+ * });
+ * ```
+ */
+declare function assertOrchestratorState<F extends Record<string, unknown>>(orchestrator: AgentOrchestrator<F>, expected: {
+    agentStatus?: "idle" | "running" | "paused" | "completed" | "error";
+    tokenUsage?: {
+        min?: number;
+        max?: number;
+        exact?: number;
+    };
+    pendingApprovals?: number;
+    conversationLength?: {
+        min?: number;
+        max?: number;
+        exact?: number;
+    };
+}): void;
+/**
+ * Create a time controller for testing time-dependent behavior.
+ *
+ * @example
+ * ```typescript
+ * const time = createTimeController();
+ *
+ * // Override Date.now
+ * const originalNow = Date.now;
+ * Date.now = () => time.now();
+ *
+ * time.advance(1000); // Advance 1 second
+ *
+ * // Restore
+ * Date.now = originalNow;
+ * ```
+ */
+declare function createTimeController(startTime?: number): {
+    now(): number;
+    advance(ms: number): void;
+    set(time: number): void;
+    reset(): void;
+};
+
+export { type ApprovalSimulator, type ApprovalSimulatorOptions, type ConstraintSnapshot, type GuardrailTestInput, type GuardrailTestResult, type MockAgentConfig, type MockAgentRunner, type MockAgentRunnerOptions, type RecordedCall, type TestOrchestrator, type TestOrchestratorOptions, assertOrchestratorState, createApprovalSimulator, createConstraintRecorder, createMockAgentRunner, createTestOrchestrator, createTimeController, testGuardrail, testGuardrailBatch };

package/dist/testing.d.ts

@@ -0,0 +1,345 @@
+import { AgentOrchestrator, OrchestratorOptions } from './index.js';
+import { A as ApprovalRequest, I as InputGuardrailData, O as OutputGuardrailData, M as Message, T as ToolCallGuardrailData, a as ToolCall, G as GuardrailResult, b as AgentLike, c as AgentRunner, R as RunOptions, d as GuardrailFn, e as GuardrailContext } from './types-BKCdgKC-.js';
+import '@directive-run/core';
+import '@directive-run/core/plugins';
+
+/**
+ * OpenAI Agents Testing Utilities
+ *
+ * Provides testing helpers for:
+ * - Mock agent runners with configurable responses
+ * - Guardrail testing with assertions
+ * - Approval workflow simulation
+ * - Snapshot testing for constraint evaluation
+ *
+ * @example
+ * ```typescript
+ * import { createMockAgentRunner, testGuardrail, createApprovalSimulator } from '@directive-run/ai';
+ *
+ * describe('MyOrchestrator', () => {
+ *   it('should block PII in input', async () => {
+ *     const result = await testGuardrail(createPIIGuardrail(), {
+ *       input: 'My SSN is 123-45-6789',
+ *     });
+ *     expect(result.passed).toBe(false);
+ *     expect(result.reason).toContain('PII');
+ *   });
+ * });
+ * ```
+ */
+
+/** Configuration for mock agent responses */
+interface MockAgentConfig<T = unknown> {
+    /** Final output to return */
+    output: T;
+    /** Messages to emit during run */
+    messages?: Message[];
+    /** Tool calls to emit during run */
+    toolCalls?: ToolCall[];
+    /** Total tokens to report */
+    totalTokens?: number;
+    /** Delay before responding (ms) */
+    delay?: number;
+    /** Error to throw instead of returning */
+    error?: Error;
+    /** Function to generate dynamic responses */
+    generate?: (input: string, agent: AgentLike) => Partial<MockAgentConfig<T>>;
+}
+/** Mock agent runner options */
+interface MockAgentRunnerOptions {
+    /** Default response for unmatched agents */
+    defaultResponse?: MockAgentConfig;
+    /** Responses keyed by agent name */
+    responses?: Record<string, MockAgentConfig>;
+    /** Record all calls for assertions */
+    recordCalls?: boolean;
+    /** Callback for each run */
+    onRun?: (agent: AgentLike, input: string) => void;
+}
+/** Recorded call for assertions */
+interface RecordedCall {
+    agent: AgentLike;
+    input: string;
+    options?: RunOptions;
+    timestamp: number;
+}
+/** Mock agent runner instance */
+interface MockAgentRunner {
+    /** The run function to pass to orchestrator */
+    run: AgentRunner;
+    /** Get all recorded calls */
+    getCalls(): RecordedCall[];
+    /** Get calls for a specific agent */
+    getCallsFor(agentName: string): RecordedCall[];
+    /** Clear recorded calls */
+    clearCalls(): void;
+    /** Set response for an agent */
+    setResponse<T>(agentName: string, config: MockAgentConfig<T>): void;
+    /** Set default response */
+    setDefaultResponse<T>(config: MockAgentConfig<T>): void;
+}
+/**
+ * Create a mock agent runner for testing.
+ *
+ * @example
+ * ```typescript
+ * const mock = createMockAgentRunner({
+ *   responses: {
+ *     'my-agent': {
+ *       output: 'Hello, world!',
+ *       totalTokens: 100,
+ *     },
+ *   },
+ * });
+ *
+ * const orchestrator = createAgentOrchestrator({ runner: mock.run });
+ * const result = await orchestrator.run(myAgent, 'Hi');
+ *
+ * expect(result.output).toBe('Hello, world!');
+ * expect(mock.getCalls()).toHaveLength(1);
+ * ```
+ */
+declare function createMockAgentRunner(options?: MockAgentRunnerOptions): MockAgentRunner;
+/** Test input for guardrail testing */
+type GuardrailTestInput<T> = T extends InputGuardrailData ? {
+    input: string;
+    agentName?: string;
+} : T extends OutputGuardrailData ? {
+    output: unknown;
+    agentName?: string;
+    input?: string;
+    messages?: Message[];
+} : T extends ToolCallGuardrailData ? {
+    toolCall: ToolCall;
+    agentName?: string;
+    input?: string;
+} : Partial<T>;
+/** Extended guardrail result with test assertions */
+interface GuardrailTestResult extends GuardrailResult {
+    /** Time taken to evaluate (ms) */
+    duration: number;
+    /** The data that was tested */
+    testedData: unknown;
+    /** Assert that the guardrail passed */
+    assertPassed(): void;
+    /** Assert that the guardrail failed */
+    assertFailed(expectedReason?: string | RegExp): void;
+    /** Assert that transformation occurred */
+    assertTransformed(expected?: unknown): void;
+}
+/**
+ * Test a guardrail with assertions.
+ *
+ * @example
+ * ```typescript
+ * // Test PII detection
+ * const result = await testGuardrail(createPIIGuardrail(), {
+ *   input: 'My SSN is 123-45-6789',
+ * });
+ * result.assertFailed(/PII/);
+ *
+ * // Test input transformation
+ * const redactResult = await testGuardrail(createPIIGuardrail({ redact: true }), {
+ *   input: 'My SSN is 123-45-6789',
+ * });
+ * redactResult.assertPassed();
+ * redactResult.assertTransformed();
+ * ```
+ */
+declare function testGuardrail<T>(guardrail: GuardrailFn<T>, testInput: GuardrailTestInput<T>, context?: Partial<GuardrailContext>): Promise<GuardrailTestResult>;
+/**
+ * Test multiple inputs against a guardrail.
+ *
+ * @example
+ * ```typescript
+ * const results = await testGuardrailBatch(createPIIGuardrail(), [
+ *   { input: 'Hello world', expect: 'pass' },
+ *   { input: 'My SSN is 123-45-6789', expect: 'fail' },
+ *   { input: 'Email: test@example.com', expect: 'fail' },
+ * ]);
+ *
+ * expect(results.allPassed()).toBe(true);
+ * ```
+ */
+declare function testGuardrailBatch<T>(guardrail: GuardrailFn<T>, testCases: Array<{
+    input: GuardrailTestInput<T>;
+    expect: "pass" | "fail" | "transform";
+    context?: Partial<GuardrailContext>;
+}>): Promise<{
+    results: GuardrailTestResult[];
+    allPassed(): boolean;
+    failures(): Array<{
+        index: number;
+        expected: string;
+        actual: GuardrailTestResult;
+    }>;
+}>;
+/** Approval simulator options */
+interface ApprovalSimulatorOptions {
+    /** Auto-approve requests matching this predicate */
+    autoApprove?: (request: ApprovalRequest) => boolean;
+    /** Auto-reject requests matching this predicate */
+    autoReject?: (request: ApprovalRequest) => boolean | string;
+    /** Delay before auto-approval/rejection (ms) */
+    delay?: number;
+    /** Record all requests for assertions */
+    recordRequests?: boolean;
+}
+/** Approval simulator instance */
+interface ApprovalSimulator {
+    /** Handle an approval request */
+    handle(request: ApprovalRequest): Promise<"approved" | "rejected">;
+    /** Get all recorded requests */
+    getRequests(): ApprovalRequest[];
+    /** Clear recorded requests */
+    clearRequests(): void;
+    /** Manually approve a request */
+    approve(requestId: string): void;
+    /** Manually reject a request */
+    reject(requestId: string, reason?: string): void;
+    /** Wait for a specific request */
+    waitForRequest(predicate: (req: ApprovalRequest) => boolean, timeoutMs?: number): Promise<ApprovalRequest>;
+}
+/**
+ * Create an approval simulator for testing approval workflows.
+ *
+ * @example
+ * ```typescript
+ * const simulator = createApprovalSimulator({
+ *   autoApprove: (req) => req.type === 'tool_call' && req.data.name === 'search',
+ *   autoReject: (req) => req.type === 'tool_call' && req.data.name === 'delete',
+ * });
+ *
+ * // Use in tests
+ * orchestrator.onApprovalRequest = (req) => simulator.handle(req);
+ * ```
+ */
+declare function createApprovalSimulator(options?: ApprovalSimulatorOptions): ApprovalSimulator;
+/** Options for test orchestrator */
+interface TestOrchestratorOptions<F extends Record<string, unknown>> extends Omit<OrchestratorOptions<F>, "runner"> {
+    /** Mock responses for agents */
+    mockResponses?: Record<string, MockAgentConfig>;
+    /** Default mock response */
+    defaultMockResponse?: MockAgentConfig;
+}
+/** Test orchestrator with additional testing utilities */
+interface TestOrchestrator<F extends Record<string, unknown>> extends AgentOrchestrator<F> {
+    /** The mock runner */
+    mockRunner: MockAgentRunner;
+    /** Approval simulator */
+    approvalSimulator: ApprovalSimulator;
+    /** Get recorded agent calls */
+    getCalls(): RecordedCall[];
+    /** Get approval requests */
+    getApprovalRequests(): ApprovalRequest[];
+    /** Reset all state */
+    resetAll(): void;
+}
+/**
+ * Create a test orchestrator with mocking and simulation built in.
+ *
+ * @example
+ * ```typescript
+ * const test = createTestOrchestrator({
+ *   mockResponses: {
+ *     'my-agent': { output: 'test response' },
+ *   },
+ *   constraints: {
+ *     needsApproval: {
+ *       when: () => true,
+ *       require: { type: 'NEED_APPROVAL' },
+ *     },
+ *   },
+ * });
+ *
+ * await test.run(myAgent, 'Hello');
+ * expect(test.getCalls()).toHaveLength(1);
+ * ```
+ */
+declare function createTestOrchestrator<F extends Record<string, unknown> = Record<string, never>>(options?: TestOrchestratorOptions<F>): TestOrchestrator<F>;
+/** Constraint evaluation snapshot */
+interface ConstraintSnapshot {
+    constraintId: string;
+    triggered: boolean;
+    requirement?: unknown;
+    facts: Record<string, unknown>;
+    timestamp: number;
+}
+/**
+ * Create a constraint evaluation recorder for snapshot testing.
+ *
+ * @example
+ * ```typescript
+ * const recorder = createConstraintRecorder();
+ * const orchestrator = createAgentOrchestrator({
+ *   plugins: [recorder.plugin],
+ * });
+ *
+ * await orchestrator.run(agent, 'Hello');
+ *
+ * expect(recorder.getSnapshots()).toMatchSnapshot();
+ * ```
+ */
+declare function createConstraintRecorder(): {
+    plugin: {
+        name: string;
+        onRequirementCreated: (data: {
+            constraintId: string;
+            requirement: unknown;
+            facts: unknown;
+        }) => void;
+    };
+    getSnapshots(): ConstraintSnapshot[];
+    clearSnapshots(): void;
+};
+/**
+ * Assert that an orchestrator has specific state.
+ *
+ * @example
+ * ```typescript
+ * assertOrchestratorState(orchestrator, {
+ *   agentStatus: 'completed',
+ *   tokenUsage: { min: 0, max: 1000 },
+ *   pendingApprovals: 0,
+ * });
+ * ```
+ */
+declare function assertOrchestratorState<F extends Record<string, unknown>>(orchestrator: AgentOrchestrator<F>, expected: {
+    agentStatus?: "idle" | "running" | "paused" | "completed" | "error";
+    tokenUsage?: {
+        min?: number;
+        max?: number;
+        exact?: number;
+    };
+    pendingApprovals?: number;
+    conversationLength?: {
+        min?: number;
+        max?: number;
+        exact?: number;
+    };
+}): void;
+/**
+ * Create a time controller for testing time-dependent behavior.
+ *
+ * @example
+ * ```typescript
+ * const time = createTimeController();
+ *
+ * // Override Date.now
+ * const originalNow = Date.now;
+ * Date.now = () => time.now();
+ *
+ * time.advance(1000); // Advance 1 second
+ *
+ * // Restore
+ * Date.now = originalNow;
+ * ```
+ */
+declare function createTimeController(startTime?: number): {
+    now(): number;
+    advance(ms: number): void;
+    set(time: number): void;
+    reset(): void;
+};
+
+export { type ApprovalSimulator, type ApprovalSimulatorOptions, type ConstraintSnapshot, type GuardrailTestInput, type GuardrailTestResult, type MockAgentConfig, type MockAgentRunner, type MockAgentRunnerOptions, type RecordedCall, type TestOrchestrator, type TestOrchestratorOptions, assertOrchestratorState, createApprovalSimulator, createConstraintRecorder, createMockAgentRunner, createTestOrchestrator, createTimeController, testGuardrail, testGuardrailBatch };