codex-orchestrator 2.0.1 → 2.0.3

package/dist/src/v2/route-coordinator.js

@@ -0,0 +1,370 @@
+import { canonicalJson } from './containment.js';
+import { validateAmbiguityReviewArtifact, } from './route-decision.js';
+import { validateTriageRoute } from './triage-route.js';
+const TRIAGE_AUTHORITY_FACTS = [
+    'inspect=issue-body-and-comments',
+    'inspect=relevant-implementation-callers-and-tests',
+    'inspect=repository-instructions-context-domain-adrs-and-existing-behavior',
+    'unavailable-evidence=record-inspected-absence',
+    'technical-and-reversible-engineering-choices=resolve-autonomously',
+    'source-supported-interpretation=choose-and-record-assumption',
+    'awaiting-user=two-materially-different-observable-product-outcomes-only',
+];
+export function initialRouteExecution() {
+    return {
+        version: 1,
+        phase: 'triage-ready',
+        previousAttemptId: null,
+        triageRepairs: 0,
+        triageTransportRetries: 0,
+        ambiguityTransportRetries: 0,
+        candidateReviews: 0,
+    };
+}
+export class RouteCoordinator {
+    dependencies;
+    constructor(dependencies) {
+        this.dependencies = dependencies;
+    }
+    async run(input) {
+        const execution = await this.dependencies.state.read();
+        switch (execution.phase) {
+            case 'triage-ready':
+                return this.launchTriage(input, execution, null);
+            case 'malformed-repair-ready':
+                return this.launchTriage(input, execution, { kind: 'malformed', findings: execution.findings });
+            case 'candidate-repair-ready':
+                return this.launchTriage(input, execution, {
+                    kind: 'rejected-candidate',
+                    candidate: execution.candidate,
+                    triage: execution.triage,
+                    review: execution.review,
+                    findings: execution.findings,
+                });
+            case 'candidate-ready':
+                return this.launchReview(input, execution);
+            case 'triage-in-flight':
+                return this.recoverTriage(execution, null);
+            case 'repair-in-flight':
+                return this.recoverTriage(execution, execution.repairInput);
+            case 'review-in-flight':
+                return this.recoverReview(execution);
+            case 'route-complete':
+                return blocked('safety', 'route-coordinator-already-complete', ['Routed state must dispatch without rerunning routing.']);
+        }
+    }
+    async launchTriage(input, ready, repairInput) {
+        const attemptId = this.dependencies.createAttemptId();
+        if (ready.phase === 'triage-ready' && attemptId === ready.previousAttemptId) {
+            return blocked('safety', 'triage-attempt-not-fresh', ['A recovered triage launch must use a fresh attempt ID.']);
+        }
+        const inFlight = {
+            ...budgets(ready),
+            phase: repairInput === null ? 'triage-in-flight' : 'repair-in-flight',
+            attemptId,
+            startedAt: this.dependencies.now(),
+            ...(repairInput === null ? {} : { repairInput }),
+        };
+        if (!await this.dependencies.state.compareAndSwap(ready, inFlight))
+            return stateConflict();
+        const result = await this.dependencies.operation.run({
+            operation: 'triage',
+            attemptId,
+            runId: input.runId,
+            worktreePath: input.worktreePath,
+            workflowGeneration: input.workflowGeneration,
+            promptFacts: triagePromptFacts(input.promptFacts, repairInput),
+            signal: input.signal,
+        });
+        return this.adoptTriage(input, inFlight, repairInput, result);
+    }
+    async adoptTriage(input, inFlight, repairInput, result) {
+        if (result.status === 'cancelled')
+            return this.cancel(inFlight);
+        if (result.status === 'blocked')
+            return blocked(result.kind, result.code, []);
+        if (result.status === 'retryable')
+            return this.retryTriage(inFlight, repairInput, result.code);
+        if (result.status === 'safe-halt')
+            return result;
+        if (result.attemptId !== inFlight.attemptId)
+            return attemptMismatch(inFlight.attemptId, result.attemptId);
+        if (result.status === 'invalid')
+            return this.invalidTriage(inFlight, repairInput, result.findings);
+        let artifact;
+        try {
+            artifact = validateTriageRoute(result.validatedPayload);
+        }
+        catch (error) {
+            return this.invalidTriage(inFlight, repairInput, [finding(error)]);
+        }
+        if (artifact.status === 'blocked') {
+            return blocked(artifact.blocker.kind, artifact.blocker.code, artifact.blocker.evidence);
+        }
+        if (artifact.status === 'awaiting-user' && repairInput !== null) {
+            return blocked('exhausted', 'waiting-candidate-repair-exhausted', [
+                'A repaired candidate may not ask another question.',
+            ]);
+        }
+        const triage = {
+            operation: 'triage',
+            attemptId: inFlight.attemptId,
+            artifactSha256: result.artifactSha256,
+            generationHash: input.workflowGeneration.generationHash,
+        };
+        if (artifact.status === 'awaiting-user') {
+            const candidateReady = {
+                ...budgets(inFlight), phase: 'candidate-ready', candidate: artifact, triage,
+            };
+            if (!await this.dependencies.state.compareAndSwap(inFlight, candidateReady))
+                return stateConflict();
+            return this.launchReview(input, candidateReady);
+        }
+        return this.complete(inFlight, artifact, triage, null);
+    }
+    async launchReview(input, ready) {
+        if (ready.candidateReviews === 1) {
+            return blocked('exhausted', 'candidate-reviews-exhausted', [ready.triage.artifactSha256]);
+        }
+        const attemptId = this.dependencies.createAttemptId();
+        if (attemptId === ready.triage.attemptId) {
+            return blocked('safety', 'ambiguity-review-attempt-not-fresh', ['Triage and review attempt IDs must be distinct.']);
+        }
+        const inFlight = {
+            ...budgets(ready),
+            phase: 'review-in-flight',
+            attemptId,
+            startedAt: this.dependencies.now(),
+            candidate: ready.candidate,
+            triage: ready.triage,
+        };
+        if (!await this.dependencies.state.compareAndSwap(ready, inFlight))
+            return stateConflict();
+        const result = await this.dependencies.operation.run({
+            operation: 'ambiguity-review',
+            attemptId,
+            runId: input.runId,
+            worktreePath: input.worktreePath,
+            workflowGeneration: input.workflowGeneration,
+            promptFacts: reviewPromptFacts(input.promptFacts, ready),
+            signal: input.signal,
+        });
+        return this.adoptReview(input, inFlight, result);
+    }
+    async adoptReview(input, inFlight, result) {
+        if (result.status === 'cancelled')
+            return this.cancel(inFlight);
+        if (result.status === 'blocked')
+            return blocked(result.kind, result.code, []);
+        if (result.status === 'retryable')
+            return this.retryReview(inFlight, result.code);
+        if (result.status === 'safe-halt')
+            return result;
+        if (result.attemptId !== inFlight.attemptId)
+            return attemptMismatch(inFlight.attemptId, result.attemptId);
+        if (result.status === 'invalid') {
+            return blocked('safety', 'ambiguity-review-artifact-invalid', result.findings);
+        }
+        let review;
+        try {
+            review = validateAmbiguityReviewArtifact(result.validatedPayload);
+        }
+        catch (error) {
+            return blocked('safety', 'ambiguity-review-artifact-invalid', [finding(error)]);
+        }
+        if (review.candidateSha256 !== inFlight.triage.artifactSha256) {
+            return blocked('safety', 'ambiguity-review-candidate-mismatch', [
+                `Expected ${inFlight.triage.artifactSha256} but review echoed ${review.candidateSha256}.`,
+            ]);
+        }
+        if (review.verdict === 'blocked') {
+            const consumed = {
+                ...budgets(inFlight),
+                phase: 'candidate-ready',
+                candidate: inFlight.candidate,
+                triage: inFlight.triage,
+                candidateReviews: 1,
+            };
+            if (!await this.dependencies.state.compareAndSwap(inFlight, consumed))
+                return stateConflict();
+            return blocked('safety', 'ambiguity-review-blocked', nonEmptyFindings(review.findings, 'Ambiguity review blocked.'));
+        }
+        const reviewRef = {
+            operation: 'ambiguity-review',
+            attemptId: inFlight.attemptId,
+            candidateSha256: review.candidateSha256,
+            artifactSha256: result.artifactSha256,
+            verdict: review.verdict,
+            generationHash: input.workflowGeneration.generationHash,
+        };
+        if (review.verdict === 'rejected') {
+            if (inFlight.triageRepairs === 1 || inFlight.candidateReviews === 1) {
+                return blocked('exhausted', 'waiting-candidate-repair-exhausted', review.findings);
+            }
+            const findings = nonEmptyFindings(review.findings, 'Ambiguity review rejected the waiting candidate.');
+            const repairReady = {
+                ...budgets(inFlight),
+                phase: 'candidate-repair-ready',
+                candidate: inFlight.candidate,
+                triage: inFlight.triage,
+                review: reviewRef,
+                findings,
+                triageRepairs: 1,
+                candidateReviews: 1,
+            };
+            if (!await this.dependencies.state.compareAndSwap(inFlight, repairReady))
+                return stateConflict();
+            return { status: 'repairable', code: 'waiting-candidate-rejected', findings };
+        }
+        const reviewed = { ...inFlight, candidateReviews: 1 };
+        return this.complete(inFlight, inFlight.candidate, inFlight.triage, reviewRef, reviewed);
+    }
+    async invalidTriage(inFlight, repairInput, findings) {
+        findings = nonEmptyFindings(findings, 'Triage artifact validation failed.');
+        if (repairInput !== null || inFlight.triageRepairs === 1) {
+            return blocked('exhausted', 'triage-repair-exhausted', findings);
+        }
+        const repairReady = {
+            ...budgets(inFlight), phase: 'malformed-repair-ready', findings, triageRepairs: 1,
+        };
+        if (!await this.dependencies.state.compareAndSwap(inFlight, repairReady))
+            return stateConflict();
+        return { status: 'repairable', code: 'triage-artifact-invalid', findings };
+    }
+    async retryTriage(inFlight, repairInput, code) {
+        if (inFlight.triageTransportRetries === 1) {
+            return blocked('exhausted', 'triage-transport-retries-exhausted', [code]);
+        }
+        const ready = triageReadyAfterFailure(inFlight, repairInput, 1);
+        if (!await this.dependencies.state.compareAndSwap(inFlight, ready))
+            return stateConflict();
+        return { status: 'retryable', owner: 'triage', code };
+    }
+    async retryReview(inFlight, code) {
+        if (inFlight.ambiguityTransportRetries === 1) {
+            return blocked('exhausted', 'ambiguity-review-transport-retries-exhausted', [code]);
+        }
+        const ready = {
+            ...budgets(inFlight),
+            phase: 'candidate-ready',
+            candidate: inFlight.candidate,
+            triage: inFlight.triage,
+            ambiguityTransportRetries: 1,
+        };
+        if (!await this.dependencies.state.compareAndSwap(inFlight, ready))
+            return stateConflict();
+        return { status: 'retryable', owner: 'ambiguity-review', code };
+    }
+    async recoverTriage(inFlight, repairInput) {
+        if (inFlight.triageTransportRetries === 1) {
+            return blocked('exhausted', 'triage-transport-retries-exhausted', [inFlight.attemptId]);
+        }
+        const ready = triageReadyAfterFailure(inFlight, repairInput, 1);
+        if (!await this.dependencies.state.compareAndSwap(inFlight, ready))
+            return stateConflict();
+        return { status: 'retryable', owner: 'triage', code: 'abandoned-triage-attempt' };
+    }
+    async recoverReview(inFlight) {
+        if (inFlight.ambiguityTransportRetries === 1) {
+            return blocked('exhausted', 'ambiguity-review-transport-retries-exhausted', [inFlight.attemptId]);
+        }
+        const ready = {
+            ...budgets(inFlight),
+            phase: 'candidate-ready',
+            candidate: inFlight.candidate,
+            triage: inFlight.triage,
+            ambiguityTransportRetries: 1,
+        };
+        if (!await this.dependencies.state.compareAndSwap(inFlight, ready))
+            return stateConflict();
+        return { status: 'retryable', owner: 'ambiguity-review', code: 'abandoned-ambiguity-review-attempt' };
+    }
+    async complete(expected, artifact, triage, review, budgetSource = expected) {
+        let receipt;
+        try {
+            receipt = this.dependencies.createReceipt({ artifact, triage, review, decidedAt: this.dependencies.now() });
+        }
+        catch (error) {
+            return blocked('safety', 'route-receipt-creation-failed', [finding(error)]);
+        }
+        const complete = { ...budgets(budgetSource), phase: 'route-complete', triage, review };
+        if (!await this.dependencies.state.complete(expected, complete, receipt))
+            return stateConflict();
+        return artifact.status === 'awaiting-user'
+            ? { status: 'awaiting-user', receipt }
+            : { status: 'succeeded', receipt };
+    }
+    async cancel(expected) {
+        if (!await this.dependencies.state.cancel(expected))
+            return stateConflict();
+        return { status: 'cancelled' };
+    }
+}
+function triageReadyAfterFailure(inFlight, repairInput, retries) {
+    if (repairInput?.kind === 'malformed') {
+        return { ...budgets(inFlight), phase: 'malformed-repair-ready', findings: repairInput.findings, triageTransportRetries: retries };
+    }
+    if (repairInput?.kind === 'rejected-candidate') {
+        return {
+            ...budgets(inFlight),
+            phase: 'candidate-repair-ready',
+            candidate: repairInput.candidate,
+            triage: repairInput.triage,
+            review: repairInput.review,
+            findings: repairInput.findings,
+            triageTransportRetries: retries,
+        };
+    }
+    return {
+        ...budgets(inFlight),
+        phase: 'triage-ready',
+        previousAttemptId: inFlight.attemptId,
+        triageTransportRetries: retries,
+    };
+}
+function triagePromptFacts(base, repairInput) {
+    const facts = [...base, ...TRIAGE_AUTHORITY_FACTS];
+    if (repairInput === null)
+        return facts;
+    facts.push(`repairKind=${repairInput.kind}`, `repairFindings=${canonicalJson(repairInput.findings)}`);
+    if (repairInput.kind === 'rejected-candidate') {
+        facts.push(`candidateSha256=${repairInput.triage.artifactSha256}`, `candidateArtifact=${canonicalJson(repairInput.candidate)}`, `reviewRef=${canonicalJson(repairInput.review)}`, 'repairResult=direct-or-spec-required-or-typed-blocker', 'repairResultMayNotAwaitUser=true');
+    }
+    return facts;
+}
+function reviewPromptFacts(base, ready) {
+    return [
+        ...base,
+        `candidateSha256=${ready.triage.artifactSha256}`,
+        `candidateArtifact=${canonicalJson(ready.candidate)}`,
+        `candidateEvidence=${canonicalJson(ready.candidate.inspectedEvidence)}`,
+        'review=materially-different-observable-product-outcomes',
+        'review=authorized-source-choice-must-be-absent',
+        'triage-process-identity=withheld',
+    ];
+}
+function budgets(execution) {
+    return {
+        version: execution.version,
+        triageRepairs: execution.triageRepairs,
+        triageTransportRetries: execution.triageTransportRetries,
+        ambiguityTransportRetries: execution.ambiguityTransportRetries,
+        candidateReviews: execution.candidateReviews,
+    };
+}
+function blocked(kind, code, evidence) {
+    return { status: 'blocked', kind, code, evidence };
+}
+function stateConflict() {
+    return blocked('safety', 'route-state-conflict', ['Durable route state changed before compare-and-swap.']);
+}
+function attemptMismatch(expected, actual) {
+    return blocked('safety', 'route-attempt-mismatch', [`Expected ${expected} but operation returned ${actual}.`]);
+}
+function finding(error) {
+    return error instanceof Error && error.message.length > 0 ? error.message : 'route validation failed';
+}
+function nonEmptyFindings(findings, fallback) {
+    return findings.length > 0 ? findings : [fallback];
+}
+//# sourceMappingURL=route-coordinator.js.map

package/dist/src/v2/route-coordinator.js.map

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

package/dist/src/v2/route-decision.d.ts

@@ -0,0 +1,129 @@
+import { type TriageRouteV1 } from './triage-route.js';
+import type { WaitingHumanExecutionV1 } from './waiting-human.js';
+export type DeliveryRoute = 'direct' | 'spec-required' | 'awaiting-user';
+export interface RouteArtifactRefV1 {
+    operation: 'triage';
+    attemptId: string;
+    artifactSha256: string;
+    generationHash: string;
+}
+export interface AmbiguityReviewRefV1 {
+    operation: 'ambiguity-review';
+    attemptId: string;
+    candidateSha256: string;
+    artifactSha256: string;
+    verdict: 'approved' | 'rejected';
+    generationHash: string;
+}
+export interface AmbiguityReviewArtifactV1 {
+    version: 1;
+    candidateSha256: string;
+    verdict: 'approved' | 'rejected' | 'blocked';
+    evidenceReviewed: string[];
+    findings: string[];
+    recommendation: string;
+}
+export interface RouteReceiptV1 {
+    version: 1;
+    route: DeliveryRoute;
+    triage: RouteArtifactRefV1;
+    review: AmbiguityReviewRefV1 | null;
+    artifact: TriageRouteV1;
+    decisionSha256: string;
+    decidedAt: string;
+    assumptions: string[];
+}
+export interface RouteBudgetsV1 {
+    version: 1;
+    triageRepairs: 0 | 1;
+    triageTransportRetries: 0 | 1;
+    ambiguityTransportRetries: 0 | 1;
+    candidateReviews: 0 | 1;
+}
+export type MalformedRepairInputV1 = {
+    kind: 'malformed';
+    findings: string[];
+};
+export type CandidateRepairInputV1 = {
+    kind: 'rejected-candidate';
+    candidate: TriageRouteV1;
+    triage: RouteArtifactRefV1;
+    review: AmbiguityReviewRefV1;
+    findings: string[];
+};
+export type RouteExecutionV1 = RouteBudgetsV1 & ({
+    phase: 'triage-ready';
+    previousAttemptId: string | null;
+} | {
+    phase: 'triage-in-flight';
+    attemptId: string;
+    startedAt: string;
+} | {
+    phase: 'candidate-ready';
+    candidate: TriageRouteV1;
+    triage: RouteArtifactRefV1;
+} | {
+    phase: 'review-in-flight';
+    attemptId: string;
+    startedAt: string;
+    candidate: TriageRouteV1;
+    triage: RouteArtifactRefV1;
+} | {
+    phase: 'malformed-repair-ready';
+    findings: string[];
+} | {
+    phase: 'candidate-repair-ready';
+    candidate: TriageRouteV1;
+    triage: RouteArtifactRefV1;
+    review: AmbiguityReviewRefV1;
+    findings: string[];
+} | {
+    phase: 'repair-in-flight';
+    attemptId: string;
+    startedAt: string;
+    repairInput: MalformedRepairInputV1 | CandidateRepairInputV1;
+} | {
+    phase: 'route-complete';
+    triage: RouteArtifactRefV1;
+    review: AmbiguityReviewRefV1 | null;
+});
+export type RouteLifecycle = 'claimed' | 'triaging' | 'routed' | 'implementing' | 'waiting-human' | 'spec-authoring' | 'reworking' | 'checking' | 'proving' | 'publishing' | 'safe-halt' | 'review-ready' | 'blocked' | 'transport-failed' | 'cancelled' | 'internal-error';
+export type RoutedLifecycle = 'implementing' | 'spec-authoring' | 'waiting-human';
+export declare function hashTriageArtifact(value: unknown): string;
+export declare function hashAmbiguityReviewArtifact(value: unknown): string;
+export declare function hashRouteDecision(value: RouteReceiptV1): string;
+export declare function validateAmbiguityReviewArtifact(value: unknown): AmbiguityReviewArtifactV1;
+export declare function validateRouteArtifactRef(value: unknown, expectedGenerationHash?: string): RouteArtifactRefV1;
+export declare function validateAmbiguityReviewRef(value: unknown, expectedGenerationHash?: string): AmbiguityReviewRefV1;
+export declare function validateRouteReceipt(value: unknown, expectedGenerationHash?: string): RouteReceiptV1;
+export declare function validateRouteExecution(value: unknown, expectedGenerationHash?: string): RouteExecutionV1;
+export declare function validateRouteStateInvariant(input: {
+    lifecycle: RouteLifecycle;
+    routeExecution: unknown;
+    routeReceipt: unknown;
+    generationHash: string;
+}): void;
+export declare function downstreamLifecycleForRoute(receiptValue: unknown, expectedGenerationHash?: string): RoutedLifecycle;
+export declare function validateRouteTransition(previous: {
+    lifecycle: RouteLifecycle;
+    routeExecution: unknown;
+    routeReceipt: unknown;
+    generationHash: string;
+}, next: {
+    lifecycle: RouteLifecycle;
+    routeExecution: unknown;
+    routeReceipt: unknown;
+    generationHash: string;
+}): void;
+export declare function validateTrustedAnswerResumeTransition(previous: {
+    lifecycle: RouteLifecycle;
+    routeExecution: unknown;
+    routeReceipt: unknown;
+    generationHash: string;
+}, next: {
+    lifecycle: RouteLifecycle;
+    routeExecution: unknown;
+    routeReceipt: unknown;
+    generationHash: string;
+}, waitingHuman: WaitingHumanExecutionV1): void;
+//# sourceMappingURL=route-decision.d.ts.map

package/dist/src/v2/route-decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-decision.d.ts","sourceRoot":"","sources":["../../../src/v2/route-decision.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAUlE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,eAAe,GAAG,eAAe,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,UAAU,GAAG,UAAU,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,CAAC,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC7C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC,QAAQ,EAAE,aAAa,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC;IACrB,sBAAsB,EAAE,CAAC,GAAG,CAAC,CAAC;IAC9B,yBAAyB,EAAE,CAAC,GAAG,CAAC,CAAC;IACjC,gBAAgB,EAAE,CAAC,GAAG,CAAC,CAAC;CACzB;AAED,MAAM,MAAM,sBAAsB,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,CAC5C;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,KAAK,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAClF;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GACzH;IAAE,KAAK,EAAE,wBAAwB,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACvD;IAAE,KAAK,EAAE,wBAAwB,CAAC;IAAC,SAAS,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAC3I;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,sBAAsB,GAAG,sBAAsB,CAAA;CAAE,GACjI;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAA;CAAE,CAC/F,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,UAAU,GACV,QAAQ,GACR,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,UAAU,GACV,SAAS,GACT,YAAY,GACZ,WAAW,GACX,cAAc,GACd,SAAS,GACT,kBAAkB,GAClB,WAAW,GACX,gBAAgB,CAAC;AAErB,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAElF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAG/D;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CAezF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAO5G;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAWhH;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,cAAc,CAEpG;AAsDD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAqDxG;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,SAAS,EAAE,cAAc,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,IAAI,CAwCP;AAED,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,OAAO,EACrB,sBAAsB,CAAC,EAAE,MAAM,GAC9B,eAAe,CAKjB;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE;IACR,SAAS,EAAE,cAAc,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,EACD,IAAI,EAAE;IACJ,SAAS,EAAE,cAAc,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,GACA,IAAI,CAcN;AAED,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE;IAAE,SAAS,EAAE,cAAc,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EAC/G,IAAI,EAAE;IAAE,SAAS,EAAE,cAAc,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EAC3G,YAAY,EAAE,uBAAuB,GACpC,IAAI,CAcN"}