@openai/agents-core 0.3.7 → 0.3.8

package/dist/runner/guardrails.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGuardrailTracker = void 0;
+exports.buildInputGuardrailDefinitions = buildInputGuardrailDefinitions;
+exports.splitInputGuardrails = splitInputGuardrails;
+exports.runInputGuardrails = runInputGuardrails;
+exports.runOutputGuardrails = runOutputGuardrails;
+const errors_1 = require("../errors.js");
+const guardrail_1 = require("../guardrail.js");
+const items_1 = require("./items.js");
+const tracing_1 = require("../tracing/index.js");
+const createGuardrailTracker = () => {
+    let pending = false;
+    let failed = false;
+    let error = undefined;
+    let promise;
+    const setError = (err) => {
+        failed = true;
+        error = err;
+        pending = false;
+    };
+    const setPromise = (incoming) => {
+        if (!incoming) {
+            return;
+        }
+        pending = true;
+        promise = incoming
+            .then((results) => results)
+            .catch((err) => {
+            setError(err);
+            // Swallow to keep downstream flow consistent; failure is signaled via `failed`.
+            return [];
+        })
+            .finally(() => {
+            pending = false;
+        });
+    };
+    const throwIfError = () => {
+        if (error) {
+            throw error;
+        }
+    };
+    const awaitCompletion = async (options) => {
+        if (promise) {
+            await promise;
+        }
+        if (error && !options?.suppressErrors) {
+            throw error;
+        }
+    };
+    return {
+        get pending() {
+            return pending;
+        },
+        get failed() {
+            return failed;
+        },
+        get error() {
+            return error;
+        },
+        markPending: () => {
+            pending = true;
+        },
+        setPromise,
+        setError,
+        throwIfError,
+        awaitCompletion,
+    };
+};
+exports.createGuardrailTracker = createGuardrailTracker;
+async function runGuardrailsWithTripwire(options) {
+    const { state, guardrails, guardrailArgs, resultsTarget, onTripwire, isTripwireError, onError, } = options;
+    try {
+        const results = await Promise.all(guardrails.map(async (guardrail) => {
+            return (0, tracing_1.withGuardrailSpan)(async (span) => {
+                const result = await guardrail.run(guardrailArgs);
+                span.spanData.triggered = result.output.tripwireTriggered;
+                return result;
+            }, { data: { name: guardrail.name } }, state._currentAgentSpan);
+        }));
+        resultsTarget.push(...results);
+        for (const result of results) {
+            if (result.output.tripwireTriggered) {
+                if (state._currentAgentSpan) {
+                    state._currentAgentSpan.setError({
+                        message: 'Guardrail tripwire triggered',
+                        data: { guardrail: result.guardrail.name },
+                    });
+                }
+                onTripwire(result);
+            }
+        }
+        return results;
+    }
+    catch (error) {
+        if (isTripwireError(error)) {
+            throw error;
+        }
+        onError(error);
+        return [];
+    }
+}
+function buildInputGuardrailDefinitions(state, runnerGuardrails) {
+    return runnerGuardrails.concat(state._currentAgent.inputGuardrails.map(guardrail_1.defineInputGuardrail));
+}
+function splitInputGuardrails(guardrails) {
+    const blocking = [];
+    const parallel = [];
+    for (const guardrail of guardrails) {
+        if (guardrail.runInParallel === false) {
+            blocking.push(guardrail);
+        }
+        else {
+            parallel.push(guardrail);
+        }
+    }
+    return { blocking, parallel };
+}
+async function runInputGuardrails(state, guardrails) {
+    if (guardrails.length === 0) {
+        return [];
+    }
+    const guardrailArgs = {
+        agent: state._currentAgent,
+        input: state._originalInput,
+        context: state._context,
+    };
+    return await runGuardrailsWithTripwire({
+        state,
+        guardrails,
+        guardrailArgs,
+        resultsTarget: state._inputGuardrailResults,
+        onTripwire: (result) => {
+            throw new errors_1.InputGuardrailTripwireTriggered(`Input guardrail triggered: ${JSON.stringify(result.output.outputInfo)}`, result, state);
+        },
+        isTripwireError: (error) => error instanceof errors_1.InputGuardrailTripwireTriggered,
+        onError: (error) => {
+            // roll back the current turn to enable reruns
+            state._currentTurn--;
+            throw new errors_1.GuardrailExecutionError(`Input guardrail failed to complete: ${error}`, error, state);
+        },
+    });
+}
+async function runOutputGuardrails(state, runnerOutputGuardrails, output) {
+    const guardrails = runnerOutputGuardrails.concat(state._currentAgent.outputGuardrails.map(guardrail_1.defineOutputGuardrail));
+    if (guardrails.length === 0) {
+        return;
+    }
+    const agentOutput = state._currentAgent.processFinalOutput(output);
+    const runOutput = (0, items_1.getTurnInput)([], state._generatedItems);
+    const guardrailArgs = {
+        agent: state._currentAgent,
+        agentOutput,
+        context: state._context,
+        details: {
+            modelResponse: state._lastTurnResponse,
+            output: runOutput,
+        },
+    };
+    await runGuardrailsWithTripwire({
+        state,
+        guardrails,
+        guardrailArgs,
+        resultsTarget: state._outputGuardrailResults,
+        onTripwire: (result) => {
+            throw new errors_1.OutputGuardrailTripwireTriggered(`Output guardrail triggered: ${JSON.stringify(result.output.outputInfo)}`, result, state);
+        },
+        isTripwireError: (error) => error instanceof errors_1.OutputGuardrailTripwireTriggered,
+        onError: (error) => {
+            throw new errors_1.GuardrailExecutionError(`Output guardrail failed to complete: ${error}`, error, state);
+        },
+    });
+}
+//# sourceMappingURL=guardrails.js.map

package/dist/runner/guardrails.js.map

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

package/dist/runner/guardrails.mjs

@@ -0,0 +1,166 @@
+import { GuardrailExecutionError, InputGuardrailTripwireTriggered, OutputGuardrailTripwireTriggered, } from "../errors.mjs";
+import { defineInputGuardrail, defineOutputGuardrail, } from "../guardrail.mjs";
+import { getTurnInput } from "./items.mjs";
+import { withGuardrailSpan } from "../tracing/index.mjs";
+export const createGuardrailTracker = () => {
+    let pending = false;
+    let failed = false;
+    let error = undefined;
+    let promise;
+    const setError = (err) => {
+        failed = true;
+        error = err;
+        pending = false;
+    };
+    const setPromise = (incoming) => {
+        if (!incoming) {
+            return;
+        }
+        pending = true;
+        promise = incoming
+            .then((results) => results)
+            .catch((err) => {
+            setError(err);
+            // Swallow to keep downstream flow consistent; failure is signaled via `failed`.
+            return [];
+        })
+            .finally(() => {
+            pending = false;
+        });
+    };
+    const throwIfError = () => {
+        if (error) {
+            throw error;
+        }
+    };
+    const awaitCompletion = async (options) => {
+        if (promise) {
+            await promise;
+        }
+        if (error && !options?.suppressErrors) {
+            throw error;
+        }
+    };
+    return {
+        get pending() {
+            return pending;
+        },
+        get failed() {
+            return failed;
+        },
+        get error() {
+            return error;
+        },
+        markPending: () => {
+            pending = true;
+        },
+        setPromise,
+        setError,
+        throwIfError,
+        awaitCompletion,
+    };
+};
+async function runGuardrailsWithTripwire(options) {
+    const { state, guardrails, guardrailArgs, resultsTarget, onTripwire, isTripwireError, onError, } = options;
+    try {
+        const results = await Promise.all(guardrails.map(async (guardrail) => {
+            return withGuardrailSpan(async (span) => {
+                const result = await guardrail.run(guardrailArgs);
+                span.spanData.triggered = result.output.tripwireTriggered;
+                return result;
+            }, { data: { name: guardrail.name } }, state._currentAgentSpan);
+        }));
+        resultsTarget.push(...results);
+        for (const result of results) {
+            if (result.output.tripwireTriggered) {
+                if (state._currentAgentSpan) {
+                    state._currentAgentSpan.setError({
+                        message: 'Guardrail tripwire triggered',
+                        data: { guardrail: result.guardrail.name },
+                    });
+                }
+                onTripwire(result);
+            }
+        }
+        return results;
+    }
+    catch (error) {
+        if (isTripwireError(error)) {
+            throw error;
+        }
+        onError(error);
+        return [];
+    }
+}
+export function buildInputGuardrailDefinitions(state, runnerGuardrails) {
+    return runnerGuardrails.concat(state._currentAgent.inputGuardrails.map(defineInputGuardrail));
+}
+export function splitInputGuardrails(guardrails) {
+    const blocking = [];
+    const parallel = [];
+    for (const guardrail of guardrails) {
+        if (guardrail.runInParallel === false) {
+            blocking.push(guardrail);
+        }
+        else {
+            parallel.push(guardrail);
+        }
+    }
+    return { blocking, parallel };
+}
+export async function runInputGuardrails(state, guardrails) {
+    if (guardrails.length === 0) {
+        return [];
+    }
+    const guardrailArgs = {
+        agent: state._currentAgent,
+        input: state._originalInput,
+        context: state._context,
+    };
+    return await runGuardrailsWithTripwire({
+        state,
+        guardrails,
+        guardrailArgs,
+        resultsTarget: state._inputGuardrailResults,
+        onTripwire: (result) => {
+            throw new InputGuardrailTripwireTriggered(`Input guardrail triggered: ${JSON.stringify(result.output.outputInfo)}`, result, state);
+        },
+        isTripwireError: (error) => error instanceof InputGuardrailTripwireTriggered,
+        onError: (error) => {
+            // roll back the current turn to enable reruns
+            state._currentTurn--;
+            throw new GuardrailExecutionError(`Input guardrail failed to complete: ${error}`, error, state);
+        },
+    });
+}
+export async function runOutputGuardrails(state, runnerOutputGuardrails, output) {
+    const guardrails = runnerOutputGuardrails.concat(state._currentAgent.outputGuardrails.map(defineOutputGuardrail));
+    if (guardrails.length === 0) {
+        return;
+    }
+    const agentOutput = state._currentAgent.processFinalOutput(output);
+    const runOutput = getTurnInput([], state._generatedItems);
+    const guardrailArgs = {
+        agent: state._currentAgent,
+        agentOutput,
+        context: state._context,
+        details: {
+            modelResponse: state._lastTurnResponse,
+            output: runOutput,
+        },
+    };
+    await runGuardrailsWithTripwire({
+        state,
+        guardrails,
+        guardrailArgs,
+        resultsTarget: state._outputGuardrailResults,
+        onTripwire: (result) => {
+            throw new OutputGuardrailTripwireTriggered(`Output guardrail triggered: ${JSON.stringify(result.output.outputInfo)}`, result, state);
+        },
+        isTripwireError: (error) => error instanceof OutputGuardrailTripwireTriggered,
+        onError: (error) => {
+            throw new GuardrailExecutionError(`Output guardrail failed to complete: ${error}`, error, state);
+        },
+    });
+}
+//# sourceMappingURL=guardrails.mjs.map

package/dist/runner/guardrails.mjs.map

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

package/dist/runner/items.d.ts

@@ -0,0 +1,18 @@
+import { RunItem } from '../items';
+import { AgentInputItem } from '../types';
+export type AgentInputItemPool = Map<string, AgentInputItem[]>;
+export declare function toAgentInputList(originalInput: string | AgentInputItem[]): AgentInputItem[];
+export declare function getAgentInputItemKey(item: AgentInputItem): string;
+export declare function buildAgentInputPool(items: AgentInputItem[]): AgentInputItemPool;
+export declare function takeAgentInputFromPool(pool: AgentInputItemPool, key: string): AgentInputItem | undefined;
+export declare function removeAgentInputFromPool(pool: AgentInputItemPool, item: AgentInputItem): boolean;
+export declare function agentInputSerializationReplacer(_key: string, value: unknown): unknown;
+export declare function extractOutputItemsFromRunItems(items: RunItem[]): AgentInputItem[];
+/**
+ * Constructs the model input array for the current turn by combining the original turn input with
+ * any new run items (excluding tool approval placeholders). This helps ensure that repeated calls
+ * to the Responses API only send newly generated content.
+ *
+ * See: https://platform.openai.com/docs/guides/conversation-state?api-mode=responses.
+ */
+export declare function getTurnInput(originalInput: string | AgentInputItem[], generatedItems: RunItem[]): AgentInputItem[];

package/dist/runner/items.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toAgentInputList = toAgentInputList;
+exports.getAgentInputItemKey = getAgentInputItemKey;
+exports.buildAgentInputPool = buildAgentInputPool;
+exports.takeAgentInputFromPool = takeAgentInputFromPool;
+exports.removeAgentInputFromPool = removeAgentInputFromPool;
+exports.agentInputSerializationReplacer = agentInputSerializationReplacer;
+exports.extractOutputItemsFromRunItems = extractOutputItemsFromRunItems;
+exports.getTurnInput = getTurnInput;
+const binary_1 = require("../utils/binary.js");
+// Normalizes user-provided input into the structure the model expects. Strings become user messages,
+// arrays are kept as-is so downstream loops can treat both scenarios uniformly.
+function toAgentInputList(originalInput) {
+    if (typeof originalInput === 'string') {
+        return [{ type: 'message', role: 'user', content: originalInput }];
+    }
+    return [...originalInput];
+}
+function getAgentInputItemKey(item) {
+    return JSON.stringify(item, agentInputSerializationReplacer);
+}
+function buildAgentInputPool(items) {
+    const pool = new Map();
+    for (const item of items) {
+        const key = getAgentInputItemKey(item);
+        const existing = pool.get(key);
+        if (existing) {
+            existing.push(item);
+        }
+        else {
+            pool.set(key, [item]);
+        }
+    }
+    return pool;
+}
+function takeAgentInputFromPool(pool, key) {
+    const candidates = pool.get(key);
+    if (!candidates || candidates.length === 0) {
+        return undefined;
+    }
+    const [first] = candidates;
+    candidates.shift();
+    if (candidates.length === 0) {
+        pool.delete(key);
+    }
+    return first;
+}
+function removeAgentInputFromPool(pool, item) {
+    const key = getAgentInputItemKey(item);
+    const candidates = pool.get(key);
+    if (!candidates || candidates.length === 0) {
+        return false;
+    }
+    const index = candidates.findIndex((candidate) => candidate === item);
+    if (index === -1) {
+        return false;
+    }
+    candidates.splice(index, 1);
+    if (candidates.length === 0) {
+        pool.delete(key);
+    }
+    return true;
+}
+function agentInputSerializationReplacer(_key, value) {
+    const serialized = (0, binary_1.serializeBinary)(value);
+    if (serialized) {
+        return serialized;
+    }
+    return value;
+}
+// Extracts model-ready output items from run items, excluding approval placeholders.
+function extractOutputItemsFromRunItems(items) {
+    return items
+        .filter((item) => item.type !== 'tool_approval_item')
+        .map((item) => item.rawItem);
+}
+/**
+ * Constructs the model input array for the current turn by combining the original turn input with
+ * any new run items (excluding tool approval placeholders). This helps ensure that repeated calls
+ * to the Responses API only send newly generated content.
+ *
+ * See: https://platform.openai.com/docs/guides/conversation-state?api-mode=responses.
+ */
+function getTurnInput(originalInput, generatedItems) {
+    const outputItems = extractOutputItemsFromRunItems(generatedItems);
+    return [...toAgentInputList(originalInput), ...outputItems];
+}
+//# sourceMappingURL=items.js.map

package/dist/runner/items.js.map

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

package/dist/runner/items.mjs

@@ -0,0 +1,79 @@
+import { serializeBinary } from "../utils/binary.mjs";
+// Normalizes user-provided input into the structure the model expects. Strings become user messages,
+// arrays are kept as-is so downstream loops can treat both scenarios uniformly.
+export function toAgentInputList(originalInput) {
+    if (typeof originalInput === 'string') {
+        return [{ type: 'message', role: 'user', content: originalInput }];
+    }
+    return [...originalInput];
+}
+export function getAgentInputItemKey(item) {
+    return JSON.stringify(item, agentInputSerializationReplacer);
+}
+export function buildAgentInputPool(items) {
+    const pool = new Map();
+    for (const item of items) {
+        const key = getAgentInputItemKey(item);
+        const existing = pool.get(key);
+        if (existing) {
+            existing.push(item);
+        }
+        else {
+            pool.set(key, [item]);
+        }
+    }
+    return pool;
+}
+export function takeAgentInputFromPool(pool, key) {
+    const candidates = pool.get(key);
+    if (!candidates || candidates.length === 0) {
+        return undefined;
+    }
+    const [first] = candidates;
+    candidates.shift();
+    if (candidates.length === 0) {
+        pool.delete(key);
+    }
+    return first;
+}
+export function removeAgentInputFromPool(pool, item) {
+    const key = getAgentInputItemKey(item);
+    const candidates = pool.get(key);
+    if (!candidates || candidates.length === 0) {
+        return false;
+    }
+    const index = candidates.findIndex((candidate) => candidate === item);
+    if (index === -1) {
+        return false;
+    }
+    candidates.splice(index, 1);
+    if (candidates.length === 0) {
+        pool.delete(key);
+    }
+    return true;
+}
+export function agentInputSerializationReplacer(_key, value) {
+    const serialized = serializeBinary(value);
+    if (serialized) {
+        return serialized;
+    }
+    return value;
+}
+// Extracts model-ready output items from run items, excluding approval placeholders.
+export function extractOutputItemsFromRunItems(items) {
+    return items
+        .filter((item) => item.type !== 'tool_approval_item')
+        .map((item) => item.rawItem);
+}
+/**
+ * Constructs the model input array for the current turn by combining the original turn input with
+ * any new run items (excluding tool approval placeholders). This helps ensure that repeated calls
+ * to the Responses API only send newly generated content.
+ *
+ * See: https://platform.openai.com/docs/guides/conversation-state?api-mode=responses.
+ */
+export function getTurnInput(originalInput, generatedItems) {
+    const outputItems = extractOutputItemsFromRunItems(generatedItems);
+    return [...toAgentInputList(originalInput), ...outputItems];
+}
+//# sourceMappingURL=items.mjs.map

package/dist/runner/items.mjs.map

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

package/dist/runner/mcpApprovals.d.ts

@@ -0,0 +1,25 @@
+import { Agent } from '../agent';
+import { RunItem, RunToolApprovalItem } from '../items';
+import { RunState } from '../runState';
+import { FunctionToolResult } from '../tool';
+import * as protocol from '../types/protocol';
+import type { ToolRunMCPApprovalRequest } from './types';
+type ResolveApproval = (rawItem: protocol.HostedToolCallItem) => boolean | undefined;
+type HandleHostedMcpApprovalsParams<TContext> = {
+    requests: ToolRunMCPApprovalRequest[];
+    agent: Agent<TContext, any>;
+    state: RunState<TContext, Agent<TContext, any>>;
+    functionResults: FunctionToolResult<TContext>[];
+    appendIfNew: (item: RunItem) => void;
+    resolveApproval?: ResolveApproval;
+};
+export type HandleHostedMcpApprovalsResult = {
+    pendingApprovals: Set<RunToolApprovalItem>;
+    pendingApprovalIds: Set<string>;
+};
+/**
+ * Normalizes hosted MCP approval flows so streaming and non-streaming loops share identical
+ * behavior. Handles synchronous approvals, previously decided approvals, and pending approvals.
+ */
+export declare function handleHostedMcpApprovals<TContext>({ requests, agent, state, functionResults, appendIfNew, resolveApproval, }: HandleHostedMcpApprovalsParams<TContext>): Promise<HandleHostedMcpApprovalsResult>;
+export {};

package/dist/runner/mcpApprovals.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleHostedMcpApprovals = handleHostedMcpApprovals;
+const items_1 = require("../items.js");
+/**
+ * Normalizes hosted MCP approval flows so streaming and non-streaming loops share identical
+ * behavior. Handles synchronous approvals, previously decided approvals, and pending approvals.
+ */
+async function handleHostedMcpApprovals({ requests, agent, state, functionResults, appendIfNew, resolveApproval, }) {
+    const pendingApprovals = new Set();
+    const pendingApprovalIds = new Set();
+    for (const approvalRequest of requests) {
+        const rawItem = approvalRequest.requestItem.rawItem;
+        if (rawItem.type !== 'hosted_tool_call') {
+            continue;
+        }
+        const providerData = rawItem.providerData;
+        if (!providerData) {
+            continue;
+        }
+        const toolData = approvalRequest.mcpTool.providerData;
+        const approvalRequestId = rawItem.id ?? providerData.id;
+        if (toolData?.on_approval) {
+            const approvalResult = await toolData.on_approval(state._context, approvalRequest.requestItem);
+            const approvalResponseData = {
+                approve: approvalResult.approve,
+                approval_request_id: approvalRequestId ?? providerData.id,
+                reason: approvalResult.reason,
+            };
+            appendIfNew(new items_1.RunToolCallItem({
+                type: 'hosted_tool_call',
+                name: 'mcp_approval_response',
+                providerData: approvalResponseData,
+            }, agent));
+            continue;
+        }
+        const approvalDecision = typeof resolveApproval === 'function'
+            ? resolveApproval(rawItem)
+            : undefined;
+        if (typeof approvalDecision !== 'undefined' && approvalRequestId) {
+            const approvalResponseData = {
+                approve: approvalDecision,
+                approval_request_id: approvalRequestId,
+                reason: undefined,
+            };
+            appendIfNew(new items_1.RunToolCallItem({
+                type: 'hosted_tool_call',
+                name: 'mcp_approval_response',
+                providerData: approvalResponseData,
+            }, agent));
+            continue;
+        }
+        functionResults.push({
+            type: 'hosted_mcp_tool_approval',
+            tool: approvalRequest.mcpTool,
+            runItem: approvalRequest.requestItem,
+        });
+        appendIfNew(approvalRequest.requestItem);
+        pendingApprovals.add(approvalRequest.requestItem);
+        if (approvalRequestId) {
+            pendingApprovalIds.add(approvalRequestId);
+        }
+    }
+    return { pendingApprovals, pendingApprovalIds };
+}
+//# sourceMappingURL=mcpApprovals.js.map

package/dist/runner/mcpApprovals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpApprovals.js","sourceRoot":"","sources":["../../src/runner/mcpApprovals.ts"],"names":[],"mappings":";;AA8BA,4DAyFC;AAtHD,uCAAyE;AAyBzE;;;GAGG;AACI,KAAK,UAAU,wBAAwB,CAAW,EACvD,QAAQ,EACR,KAAK,EACL,KAAK,EACL,eAAe,EACf,WAAW,EACX,eAAe,GAC0B;IACzC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAuB,CAAC;IACxD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE7C,KAAK,MAAM,eAAe,IAAI,QAAQ,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,eAAe,CAAC,WAAW,CAAC,OAAO,CAAC;QACpD,IAAI,OAAO,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YACxC,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,YAEhB,CAAC;QACd,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,YAE5B,CAAC;QACd,MAAM,iBAAiB,GAAG,OAAO,CAAC,EAAE,IAAI,YAAY,CAAC,EAAE,CAAC;QAExD,IAAI,QAAQ,EAAE,WAAW,EAAE,CAAC;YAC1B,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,WAAW,CAC/C,KAAK,CAAC,QAAQ,EACd,eAAe,CAAC,WAAW,CAC5B,CAAC;YACF,MAAM,oBAAoB,GAA2C;gBACnE,OAAO,EAAE,cAAc,CAAC,OAAO;gBAC/B,mBAAmB,EAAE,iBAAiB,IAAI,YAAY,CAAC,EAAE;gBACzD,MAAM,EAAE,cAAc,CAAC,MAAM;aAC9B,CAAC;YACF,WAAW,CACT,IAAI,uBAAe,CACjB;gBACE,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,uBAAuB;gBAC7B,YAAY,EAAE,oBAAoB;aACnC,EACD,KAA+B,CAChC,CACF,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,gBAAgB,GACpB,OAAO,eAAe,KAAK,UAAU;YACnC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC;YAC1B,CAAC,CAAC,SAAS,CAAC;QAChB,IAAI,OAAO,gBAAgB,KAAK,WAAW,IAAI,iBAAiB,EAAE,CAAC;YACjE,MAAM,oBAAoB,GAA2C;gBACnE,OAAO,EAAE,gBAAgB;gBACzB,mBAAmB,EAAE,iBAAiB;gBACtC,MAAM,EAAE,SAAS;aAClB,CAAC;YACF,WAAW,CACT,IAAI,uBAAe,CACjB;gBACE,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,uBAAuB;gBAC7B,YAAY,EAAE,oBAAoB;aACnC,EACD,KAA+B,CAChC,CACF,CAAC;YACF,SAAS;QACX,CAAC;QAED,eAAe,CAAC,IAAI,CAAC;YACnB,IAAI,EAAE,0BAA0B;YAChC,IAAI,EAAE,eAAe,CAAC,OAAO;YAC7B,OAAO,EAAE,eAAe,CAAC,WAAW;SACrC,CAAC,CAAC;QACH,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAEzC,gBAAgB,CAAC,GAAG,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,iBAAiB,EAAE,CAAC;YACtB,kBAAkB,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,CAAC;AAClD,CAAC"}