@zhixuan92/multi-model-agent-core 3.12.7 → 4.0.1

package/dist/reporting/verify-stage-runner.js

@@ -0,0 +1,102 @@
+import { spawn } from 'node:child_process';
+const DEFAULT_TIMEOUT_MS = 300_000; // 5 min
+const MAX_OUTPUT_BYTES = 64 * 1024; // 64 KB
+class RollingTail {
+    chunks = [];
+    bytes = 0;
+    push(s) {
+        const buf = Buffer.from(s, 'utf8');
+        this.chunks.push(buf);
+        this.bytes += buf.length;
+        while (this.chunks.length > 0 && this.bytes - this.chunks[0].length >= MAX_OUTPUT_BYTES) {
+            this.bytes -= this.chunks.shift().length;
+        }
+    }
+    toString() {
+        if (this.bytes === 0)
+            return '';
+        const concat = Buffer.concat(this.chunks);
+        if (concat.length <= MAX_OUTPUT_BYTES)
+            return concat.toString('utf8');
+        return concat.subarray(concat.length - MAX_OUTPUT_BYTES).toString('utf8');
+    }
+}
+export class VerifyStageRunner {
+    /**
+     * Run a post-implementation verify command (e.g. `npm test`).
+     *
+     * IMPORTANT: `command` is executed via `shell: true` and MUST be trusted input
+     * (config-supplied, not user-supplied). Do not pass unsanitized user input here.
+     */
+    async run(command, cwd, options = {}) {
+        const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        const start = Date.now();
+        return new Promise((resolve, reject) => {
+            const proc = spawn(command, { shell: true, cwd });
+            const stdout = new RollingTail();
+            const stderr = new RollingTail();
+            let resolved = false;
+            const finish = (result) => {
+                if (!resolved) {
+                    resolved = true;
+                    resolve(result);
+                }
+            };
+            const timer = setTimeout(() => {
+                finish({
+                    exitCode: -1,
+                    stdout: stdout.toString(),
+                    stderr: stderr.toString(),
+                    signal: null,
+                    durationMs: Date.now() - start,
+                    errorCode: 'validator_verify_command_failed',
+                });
+                try {
+                    proc.kill('SIGKILL');
+                }
+                catch {
+                    // best-effort kill
+                }
+            }, Math.max(1, timeoutMs));
+            proc.stdout?.on('data', (d) => stdout.push(d.toString()));
+            proc.stderr?.on('data', (d) => stderr.push(d.toString()));
+            proc.on('error', (err) => {
+                clearTimeout(timer);
+                reject(err);
+            });
+            proc.on('exit', (code, sig) => {
+                clearTimeout(timer);
+                if (sig) {
+                    finish({
+                        exitCode: code ?? -1,
+                        stdout: stdout.toString(),
+                        stderr: stderr.toString(),
+                        signal: sig,
+                        durationMs: Date.now() - start,
+                        errorCode: 'validator_verify_command_failed',
+                    });
+                }
+                else if (code === 0) {
+                    finish({
+                        exitCode: 0,
+                        stdout: stdout.toString(),
+                        stderr: stderr.toString(),
+                        signal: null,
+                        durationMs: Date.now() - start,
+                    });
+                }
+                else {
+                    finish({
+                        exitCode: code ?? -1,
+                        stdout: stdout.toString(),
+                        stderr: stderr.toString(),
+                        signal: null,
+                        durationMs: Date.now() - start,
+                        errorCode: 'validator_verify_command_failed',
+                    });
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=verify-stage-runner.js.map

package/dist/reporting/verify-stage-runner.js.map

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

package/dist/research/explore-orchestrator.d.ts

@@ -0,0 +1,14 @@
+import type { ExecutionContext } from '../lifecycle/lifecycle-context.js';
+import type { ExecutorOutput } from '../lifecycle/executor-output-types.js';
+import type { Input } from '../tools/explore/schema.js';
+import type { ResearchToolDefinition } from './types.js';
+import { type ResolvedContextBlock } from '../intake/brief-compiler-slots/explore.js';
+export interface ExploreOrchestratorInput {
+    input: Input;
+    resolvedContextBlocks: ResolvedContextBlock[];
+    canonicalizedAnchors: string[];
+    relativeAnchorsForPrompt: string[];
+    customToolset?: ResearchToolDefinition[];
+}
+export declare function executeExplore(ctx: ExecutionContext, args: ExploreOrchestratorInput): Promise<ExecutorOutput>;
+//# sourceMappingURL=explore-orchestrator.d.ts.map

package/dist/research/explore-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-orchestrator.d.ts","sourceRoot":"","sources":["../../src/research/explore-orchestrator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAExD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAOzD,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,2CAA2C,CAAC;AASnD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,KAAK,CAAC;IACb,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;IAC9C,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,aAAa,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAC1C;AAmFD,wBAAsB,cAAc,CAClC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,cAAc,CAAC,CA6UzB"}

package/dist/research/explore-orchestrator.js

@@ -0,0 +1,363 @@
+import { randomUUID } from 'node:crypto';
+import { runTaskViaDispatcher } from '../lifecycle/task-runner.js';
+import { resolveAgent } from '../escalation/agent-resolver.js';
+import { computeTimings, computeAggregateCost } from '../lifecycle/shared-compute.js';
+import { notApplicable } from '../reporting/not-applicable.js';
+import { compileExplore, } from '../intake/brief-compiler-slots/explore.js';
+import { parseExploreReport, } from '../reporting/parse-explore-report.js';
+import { deriveExploreStatus } from '../reporting/derive-explore-status.js';
+import { composeExploreHeadline } from '../reporting/compose-explore-headline.js';
+import { mapReviewVerdicts } from '../review/review-verdict-mapping.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function isFailed(result) {
+    return result.status === 'error' || result.status === 'api_error'
+        || result.status === 'provider_transport_failure' || result.status === 'unavailable'
+        || result.status === 'api_aborted' || result.status === 'timeout'
+        || result.status === 'cost_exceeded' || result.status === 'brief_too_vague'
+        || result.status === 'incomplete';
+}
+function extractReportText(result) {
+    return result?.output ?? '';
+}
+function buildFallbackResult(msg) {
+    return {
+        output: '',
+        status: 'error',
+        usage: { inputTokens: 0, outputTokens: 0, cachedReadTokens: 0, cachedNonReadTokens: 0 },
+        turns: 0,
+        filesRead: [],
+        filesWritten: [],
+        toolCalls: [],
+        outputIsDiagnostic: false,
+        escalationLog: [],
+        error: msg,
+        errorCode: 'runner_crash',
+        retryable: false,
+        durationMs: 0,
+        directoriesListed: [],
+        structuredReport: {
+            summary: null,
+            filesChanged: [],
+            validationsRun: [],
+            deviationsFromBrief: [],
+            unresolved: [],
+            extraSections: {},
+        },
+        parsedFindings: [],
+        workerStatus: 'failed',
+        structuredError: {
+            code: 'runner_crash',
+            message: msg,
+            where: 'orchestrator:explore',
+        },
+    };
+}
+async function runLifecycleTask(args) {
+    const { task, resolved, config, ctx, bus, route } = args;
+    return runTaskViaDispatcher({
+        task: task,
+        resolved,
+        config,
+        taskIndex: 0,
+        batchId: ctx.batchId,
+        recordHeartbeat: ctx.recordHeartbeat,
+        logger: ctx.logger,
+        recorder: ctx.recorder,
+        route,
+        client: ctx.client,
+        triggeringSkill: ctx.triggeringSkill,
+        bus,
+    });
+}
+// ---------------------------------------------------------------------------
+// Orchestrator
+// ---------------------------------------------------------------------------
+export async function executeExplore(ctx, args) {
+    const { config } = ctx;
+    const cwd = ctx.projectContext.cwd;
+    const batchId = ctx.batchId ?? randomUUID();
+    const research = config.research;
+    const hasBrave = (research?.brave?.apiKeys?.length ?? 0) > 0;
+    let resolved;
+    try {
+        resolved = resolveAgent('complex', config);
+    }
+    catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        const fallback = buildFallbackResult(err.message);
+        return {
+            headline: `explore: agent resolution failed — ${err.message}`,
+            results: [fallback],
+            batchTimings: computeTimings(0, [fallback]),
+            costSummary: computeAggregateCost([fallback]),
+            structuredReport: notApplicable('agent resolution failed'),
+            error: notApplicable('batch succeeded'),
+            batchId,
+            wallClockMs: 0,
+            mainModel: ctx.mainModel ?? config.defaults?.mainModel,
+            specReviewVerdict: 'not_applicable',
+            qualityReviewVerdict: 'not_applicable',
+            roundsUsed: 0,
+        };
+    }
+    const promptAnchors = args.relativeAnchorsForPrompt.length
+        ? args.relativeAnchorsForPrompt
+        : args.canonicalizedAnchors;
+    const compiled = compileExplore(args.input, args.resolvedContextBlocks, promptAnchors, cwd, {
+        userSources: research?.userSources ?? [],
+        hasBrave,
+        absoluteAnchors: args.canonicalizedAnchors,
+    });
+    if (compiled.tasks.length !== 3) {
+        throw new Error(`compileExplore produced ${compiled.tasks.length} tasks; expected exactly 3`);
+    }
+    const internalTask = compiled.tasks[0];
+    const externalTask = compiled.tasks[1];
+    if (internalTask.route !== 'explore_internal' || externalTask.route !== 'explore_external') {
+        throw new Error(`compileExplore task route mismatch: ${internalTask.route} / ${externalTask.route}`);
+    }
+    let internalProvider;
+    let externalProvider;
+    try {
+        internalProvider = resolveAgent('complex', config);
+        externalProvider = resolveAgent('complex', config);
+    }
+    catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        const fallback = buildFallbackResult(err.message);
+        return {
+            headline: `explore: provider resolution failed — ${err.message}`,
+            results: [fallback],
+            batchTimings: computeTimings(0, [fallback]),
+            costSummary: computeAggregateCost([fallback]),
+            structuredReport: notApplicable('provider resolution failed'),
+            error: notApplicable('batch succeeded'),
+            batchId,
+            wallClockMs: 0,
+            mainModel: ctx.mainModel ?? config.defaults?.mainModel,
+            specReviewVerdict: 'not_applicable',
+            qualityReviewVerdict: 'not_applicable',
+            roundsUsed: 0,
+        };
+    }
+    if (args.customToolset && args.customToolset.length > 0) {
+        externalTask.customToolset = args.customToolset;
+    }
+    const startMs = Date.now();
+    ctx.bus?.emit({
+        event: 'explore_parallel_start',
+        ts: new Date().toISOString(),
+        batchId,
+        internalRoute: internalTask.route,
+        externalRoute: externalTask.route,
+    });
+    // --- Parallel fan-out: internal (#0) + external (#1) ---
+    const [internalResult, externalResult] = await Promise.all([
+        runLifecycleTask({
+            task: internalTask,
+            resolved: internalProvider,
+            config,
+            ctx,
+            bus: ctx.bus,
+            route: internalTask.route,
+        }).catch((e) => {
+            const err = e instanceof Error ? e : new Error(String(e));
+            return buildFallbackResult(err.message);
+        }),
+        runLifecycleTask({
+            task: externalTask,
+            resolved: externalProvider,
+            config,
+            ctx,
+            bus: ctx.bus,
+            route: externalTask.route,
+        }).catch((e) => {
+            const err = e instanceof Error ? e : new Error(String(e));
+            return buildFallbackResult(err.message);
+        }),
+    ]);
+    const internalOk = !isFailed(internalResult);
+    const externalOk = !isFailed(externalResult);
+    ctx.bus?.emit({
+        event: 'explore_parallel_end',
+        ts: new Date().toISOString(),
+        batchId,
+        internalOk,
+        externalOk,
+        internalDurationMs: internalResult.durationMs ?? 0,
+        externalDurationMs: externalResult.durationMs ?? 0,
+    });
+    const degraded = [];
+    if (!internalOk) {
+        degraded.push('internal');
+        ctx.bus?.emit({
+            event: 'explore_internal_unavailable',
+            ts: new Date().toISOString(),
+            batchId,
+            reason: internalResult.structuredError?.message ?? 'internal worker failed',
+        });
+    }
+    if (!externalOk) {
+        degraded.push('external');
+        ctx.bus?.emit({
+            event: 'explore_external_unavailable',
+            ts: new Date().toISOString(),
+            batchId,
+            reason: externalResult.structuredError?.message ?? 'external worker failed',
+        });
+    }
+    // --- Synthesizer (#2) ---
+    const internalReport = internalOk ? extractReportText(internalResult) : undefined;
+    const externalReport = externalOk ? extractReportText(externalResult) : undefined;
+    const synthCompiled = compileExplore(args.input, args.resolvedContextBlocks, promptAnchors, cwd, {
+        userSources: research?.userSources ?? [],
+        hasBrave,
+        absoluteAnchors: args.canonicalizedAnchors,
+        synthesizerDegradedSources: degraded.length ? degraded : undefined,
+        internalReport,
+        externalReport,
+    });
+    const synthTask = synthCompiled.tasks[2];
+    ctx.bus?.emit({
+        event: 'explore_synthesize_start',
+        ts: new Date().toISOString(),
+        batchId,
+        internalAvailable: internalOk,
+        externalAvailable: externalOk,
+    });
+    let synthProvider;
+    try {
+        synthProvider = resolveAgent('complex', config);
+    }
+    catch (e) {
+        const err = e instanceof Error ? e : new Error(String(e));
+        const fallback = buildFallbackResult(err.message);
+        return {
+            headline: `explore: synthesizer provider resolution failed — ${err.message}`,
+            results: [internalResult, externalResult, fallback],
+            batchTimings: computeTimings(Date.now() - startMs, [internalResult, externalResult, fallback]),
+            costSummary: computeAggregateCost([internalResult, externalResult, fallback]),
+            structuredReport: notApplicable('provider resolution failed'),
+            error: notApplicable('batch succeeded'),
+            batchId,
+            wallClockMs: Date.now() - startMs,
+            mainModel: ctx.mainModel ?? config.defaults?.mainModel,
+            specReviewVerdict: 'not_applicable',
+            qualityReviewVerdict: 'not_applicable',
+            roundsUsed: 0,
+        };
+    }
+    const synthStartMs = Date.now();
+    let synthResult;
+    let synthError;
+    try {
+        synthResult = await runLifecycleTask({
+            task: synthTask,
+            resolved: synthProvider,
+            config,
+            ctx,
+            bus: ctx.bus,
+            route: synthTask.route,
+        });
+    }
+    catch (e) {
+        synthError = e instanceof Error ? e : new Error(String(e));
+        synthResult = buildFallbackResult(synthError.message);
+    }
+    const synthDurationMs = Date.now() - synthStartMs;
+    // --- Parse synthesizer output ---
+    const parseResult = parseExploreReport(synthResult?.output ?? '');
+    let parsedReport;
+    if (parseResult.kind === 'structured_report') {
+        parsedReport = parseResult.report;
+        if (!synthResult.structuredReport) {
+            synthResult.structuredReport = {
+                summary: null,
+                filesChanged: [],
+                validationsRun: [],
+                deviationsFromBrief: [],
+                unresolved: [],
+                extraSections: {},
+            };
+        }
+        synthResult.structuredReport.explore = parsedReport;
+    }
+    const threadCount = parsedReport?.threads.length ?? 0;
+    if (parsedReport) {
+        for (const thread of parsedReport.threads) {
+            ctx.bus?.emit({
+                event: 'explore_thread_started',
+                ts: new Date().toISOString(),
+                batchId,
+                threadIndex: thread.index,
+            });
+            ctx.bus?.emit({
+                event: 'explore_thread_completed',
+                ts: new Date().toISOString(),
+                batchId,
+                threadIndex: thread.index,
+            });
+        }
+    }
+    ctx.bus?.emit({
+        event: 'explore_synthesize_end',
+        ts: new Date().toISOString(),
+        batchId,
+        threadCount,
+        recommendedNextStep: parsedReport
+            ? parsedReport.recommendedNextStep !== null && parsedReport.recommendedNextStep !== undefined
+            : false,
+        durationMs: synthDurationMs,
+    });
+    // --- Derive status ---
+    const synthFailed = isFailed(synthResult) || synthError !== undefined;
+    const incompleteReason = synthResult?.incompleteReason;
+    const workerError = synthError ?? synthResult?.workerError;
+    const derived = deriveExploreStatus({
+        workerError,
+        incompleteReason,
+        parseDiagnostics: parsedReport?.diagnostics ?? {
+            malformed: false,
+            insufficientThreads: false,
+            droppedThreads: [],
+        },
+        threads: threadCount,
+    });
+    synthResult.workerStatus = derived.workerStatus;
+    if (derived.incompleteReason !== undefined) {
+        synthResult.incompleteReason = derived.incompleteReason;
+    }
+    // --- Compute failedCount for headline ---
+    let failedCount = 0;
+    if (!internalOk)
+        failedCount++;
+    if (!externalOk)
+        failedCount++;
+    const allResults = [internalResult, externalResult, synthResult];
+    const headline = composeExploreHeadline({
+        taskCount: 3,
+        failedCount,
+        threadCount,
+        synthFailed,
+    });
+    const reviewVerdicts = mapReviewVerdicts(synthResult, true);
+    // --- Aggregate ---
+    const wallClockMs = Date.now() - startMs;
+    return {
+        headline,
+        results: allResults,
+        batchTimings: computeTimings(wallClockMs, allResults),
+        costSummary: computeAggregateCost(allResults),
+        structuredReport: notApplicable('per-task structured report carried on result'),
+        error: notApplicable('batch succeeded'),
+        batchId,
+        wallClockMs,
+        mainModel: ctx.mainModel ?? config.defaults?.mainModel,
+        specReviewVerdict: reviewVerdicts.specReviewVerdict,
+        qualityReviewVerdict: reviewVerdicts.qualityReviewVerdict,
+        roundsUsed: reviewVerdicts.roundsUsed,
+    };
+}
+//# sourceMappingURL=explore-orchestrator.js.map

package/dist/research/explore-orchestrator.js.map

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

package/dist/research/index.d.ts

@@ -0,0 +1,3 @@
+export * from './web-search.js';
+export * from './web-fetch.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/research/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/research/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/dist/research/index.js

@@ -0,0 +1,4 @@
+// research/index.ts — public surface barrel; per architecture.md:262-275.
+export * from './web-search.js';
+export * from './web-fetch.js';
+//# sourceMappingURL=index.js.map

package/dist/research/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/research/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/dist/research/web-fetch-helpers.d.ts

@@ -0,0 +1,48 @@
+import type { ResearchConfig } from '../config/schema.js';
+import type { WebFetchInput, WebFetchErr } from './web-fetch.js';
+/** Max bytes to drain from a redirect response body before giving up. */
+export declare const REDIRECT_DRAIN_CAP: number;
+export declare const REDIRECT_ERR_CODE_MAP: Record<string, string>;
+export interface ValidatedURL {
+    ok: true;
+    url: URL;
+    host: string;
+    pinnedIP: string;
+}
+export interface ValidationFailed {
+    ok: false;
+    reasonCode: string;
+    host?: string;
+}
+/**
+ * Races a promise against an AbortSignal. If the signal fires first, throws
+ * a DOMException with name 'AbortError' so callers can map it to timeout.
+ */
+export declare function withDeadline<T>(promise: Promise<T>, signal: AbortSignal): Promise<T>;
+export declare function validateAndPinURL(raw: string, hostAllowlist: ReadonlySet<string>, privateNetworkHosts: ReadonlySet<string>, resolveIP: WebFetchInput['resolveIP'], signal: AbortSignal): Promise<ValidatedURL | ValidationFailed>;
+export declare function extractContentType(headers: Record<string, string | string[] | undefined>): string;
+export declare function isRedirect(status: number): boolean;
+export declare function extractLocation(headers: Record<string, string | string[] | undefined>): string | null;
+export declare function extractBodyFromHTML(html: string): string;
+export declare function stripCredentialsFromURL(url: URL): boolean;
+/**
+ * Read a response body with a byte cap and abort-signal awareness.
+ * Stream errors (non-abort) are re-thrown so the caller can map them to
+ * web_fetch_body_read_failed rather than silently returning partial content.
+ */
+export declare function readBody(body: AsyncIterable<Uint8Array | string> | null, maxBytes: number, signal: AbortSignal): Promise<{
+    text: string;
+    bytesReturned: number;
+    truncated: boolean;
+}>;
+/**
+ * Drain a response body with a size cap and abort-signal awareness.
+ * Used for redirect responses and rejected content types.
+ */
+export declare function drainBody(body: AsyncIterable<unknown> | null, signal: AbortSignal): Promise<void>;
+export declare function isUndiciTimeout(err: unknown): boolean;
+/** Close/destroy a dispatcher if it supports it (Agent instances do). */
+export declare function closeDispatcher(d: import('undici').Dispatcher | undefined): void;
+export declare function mapRequestError(err: unknown, signal: AbortSignal, host: string): WebFetchErr;
+export type _ResearchFetchCfg = ResearchConfig['fetch'];
+//# sourceMappingURL=web-fetch-helpers.d.ts.map

package/dist/research/web-fetch-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch-helpers.d.ts","sourceRoot":"","sources":["../../src/research/web-fetch-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEjE,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,QAAY,CAAC;AAE5C,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOxD,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,IAAI,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,KAAK,CAAC;IACV,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAgB1F;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,EAClC,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAC,EACxC,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,EACrC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,GAAG,gBAAgB,CAAC,CAsC1C;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,MAAM,CASjG;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,IAAI,CAKrG;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBxD;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAKzD;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,aAAa,CAAC,UAAU,GAAG,MAAM,CAAC,GAAG,IAAI,EAC/C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAkCtE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,EACnC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMrD;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAWhF;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAW5F;AAGD,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC"}