@open-agent-toolkit/cli 0.1.46 → 0.1.50

package/dist/providers/identity/availability.js

@@ -78,15 +78,6 @@ function parseCursorCatalog(stdout) {
     }
     return entries;
 }
-function availabilityFromCursorCatalog(value, stdout) {
-    const entries = parseCursorCatalog(stdout);
-    if (entries.length === 0) {
-        return null;
-    }
-    return entries.some((entry) => entry.slug === value)
-        ? 'valid'
-        : 'unknown-value';
-}
 const CURSOR_SUBAGENT_PROBE_SENTINEL = 'OAT_CURSOR_SUBAGENT_MODEL_VALID';
 function hasCursorSubagentProbeSentinel(stdout) {
     return stdout
@@ -150,6 +141,20 @@ function cursorCatalogContextMessage(value, availability) {
     }
     return undefined;
 }
+function availabilityDependencies(options) {
+    return {
+        ...DEFAULT_DEPENDENCIES,
+        env: options.env ?? DEFAULT_DEPENDENCIES.env,
+        ...options.dependencies,
+    };
+}
+function cursorCatalogDiagnostic(results) {
+    const messages = unique(results
+        .flatMap((result) => [result.stderr, result.stdout])
+        .map((message) => message.trim())
+        .filter((message) => message.length > 0));
+    return messages.length > 0 ? messages.join('\n') : null;
+}
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -271,18 +276,18 @@ async function validateCodexCell(value, cwd, dependencies, target) {
     }
     return { availability: 'valid' };
 }
-export async function validateCursorSubagentModel(value, options) {
-    const dependencies = {
-        ...DEFAULT_DEPENDENCIES,
-        env: options.env ?? DEFAULT_DEPENDENCIES.env,
-        ...options.dependencies,
-    };
+export async function probeCursorSubagentModel(value, options) {
+    const dependencies = availabilityDependencies(options);
     const env = dependencies.env ?? process.env;
     const runOptions = { cwd: options.cwd, env };
     const probeResult = await dependencies.runCursorAgent(cursorSubagentProbeArgs(value, env), runOptions);
     const probeOutput = `${probeResult.stdout}\n${probeResult.stderr}`;
     if (probeResult.ok && hasCursorSubagentProbeSentinel(probeResult.stdout)) {
-        return { availability: 'valid' };
+        return {
+            availability: 'valid',
+            decisive: true,
+            evidence: 'task-probe',
+        };
     }
     const allowedValues = parseCursorAllowedSubagentModels(probeOutput);
     if (allowedValues.length > 0) {
@@ -295,28 +300,70 @@ export async function validateCursorSubagentModel(value, options) {
             message: availability === 'valid'
                 ? cursorAllowedModelsMessage(allowedValues)
                 : cursorRejectedMessage(allowedValues),
+            decisive: true,
+            evidence: 'subagent-allow-list',
         };
     }
+    return {
+        availability: 'unvalidated',
+        decisive: false,
+        evidence: 'none',
+    };
+}
+export async function resolveCursorModelCatalog(options) {
+    const dependencies = availabilityDependencies(options);
+    const env = dependencies.env ?? process.env;
+    const runOptions = { cwd: options.cwd, env };
+    const attempts = [];
     const modelsResult = await dependencies.runCursorAgent([...apiKeyArgs(env), 'models'], runOptions);
+    attempts.push(modelsResult);
     if (modelsResult.ok) {
-        const availability = availabilityFromCursorCatalog(value, modelsResult.stdout);
-        if (availability !== null) {
+        const candidates = parseCursorCatalog(modelsResult.stdout).map((entry) => entry.slug);
+        if (candidates.length > 0) {
             return {
-                availability: availability === 'valid' ? 'unvalidated' : 'unknown-value',
-                message: cursorCatalogContextMessage(value, availability),
+                status: 'resolved',
+                candidates,
+                sourceCommand: 'models',
+                diagnostic: null,
             };
         }
     }
     const listResult = await dependencies.runCursorAgent([...apiKeyArgs(env), '--list-models'], runOptions);
+    attempts.push(listResult);
     if (listResult.ok) {
-        const availability = availabilityFromCursorCatalog(value, listResult.stdout);
-        if (availability !== null) {
+        const candidates = parseCursorCatalog(listResult.stdout).map((entry) => entry.slug);
+        if (candidates.length > 0) {
             return {
-                availability: availability === 'valid' ? 'unvalidated' : 'unknown-value',
-                message: cursorCatalogContextMessage(value, availability),
+                status: 'resolved',
+                candidates,
+                sourceCommand: 'list-models',
+                diagnostic: null,
             };
         }
     }
+    return {
+        status: attempts.every((result) => !result.ok) ? 'unavailable' : 'failed',
+        candidates: [],
+        sourceCommand: null,
+        diagnostic: cursorCatalogDiagnostic(attempts),
+    };
+}
+export async function validateCursorSubagentModel(value, options) {
+    const taskProbe = await probeCursorSubagentModel(value, options);
+    if (taskProbe.decisive) {
+        const { decisive: _decisive, evidence: _evidence, ...result } = taskProbe;
+        return result;
+    }
+    const catalog = await resolveCursorModelCatalog(options);
+    if (catalog.status === 'resolved') {
+        const availability = catalog.candidates.includes(value)
+            ? 'valid'
+            : 'unknown-value';
+        return {
+            availability: availability === 'valid' ? 'unvalidated' : 'unknown-value',
+            message: cursorCatalogContextMessage(value, availability),
+        };
+    }
     return { availability: 'unvalidated' };
 }
 export async function validateMatrixCell(provider, value, options) {
@@ -327,11 +374,7 @@ export async function validateMatrixCell(provider, value, options) {
             ? { availability: 'unknown-value' }
             : 'unknown-value';
     }
-    const dependencies = {
-        ...DEFAULT_DEPENDENCIES,
-        env: options.env ?? DEFAULT_DEPENDENCIES.env,
-        ...options.dependencies,
-    };
+    const dependencies = availabilityDependencies(options);
     if (normalizedProvider === 'claude') {
         const availability = VALID_CLAUDE_DISPATCH_CEILINGS.includes(normalizedValue)
             ? 'valid'

package/dist/providers/identity/dispatch-report.d.ts

@@ -0,0 +1,124 @@
+import type { WorkflowDispatchMatrixTier } from '../../config/dispatch-matrix.js';
+import type { IdentityProvenance } from './provenance.js';
+import type { DispatchAction, DispatchRole, DispatchStampRecord } from './stamp.js';
+export type DispatchReportPolicyStatus = 'resolved' | 'unresolved' | 'blocked';
+export type DispatchReportPolicyMode = 'managed' | 'inherit' | null;
+export interface ResolvedDispatchTargetReport {
+    harness: string;
+    model?: string;
+    effort?: string;
+    crossHarness: boolean;
+    routeIndex: number;
+    routeLength: number;
+}
+export interface DispatchControlRequest {
+    value: string | null;
+    mechanism: 'task-model-argument' | 'materialized-role' | 'base-role' | 'provider-default' | 'host-inherited' | 'not-applicable';
+    reason: string;
+}
+export interface DispatchRequestedControls {
+    model: DispatchControlRequest;
+    effort: DispatchControlRequest;
+}
+export interface DispatchConfiguredDefaults {
+    model: string | null;
+    modelSource: string | null;
+    effort: string | null;
+    effortSource: string | null;
+}
+export interface DispatchGateInvocation {
+    readonly runId: string;
+    readonly targetId: string;
+    readonly runtime: string;
+    readonly model: string;
+    readonly reasoningEffort: string;
+    readonly source: 'exec-target-config' | 'unknown';
+}
+export interface DispatchRuntimeIdentity {
+    producer: string | null;
+    model: string | null;
+    effort: string | null;
+    provenance: IdentityProvenance;
+    confidence: string;
+}
+export interface DispatchReportSelectionInput {
+    role: DispatchRole;
+    requestedCandidate: {
+        model: string;
+        effort?: string;
+    } | null;
+    candidateTier: WorkflowDispatchMatrixTier | null;
+    candidateIndex: number | null;
+    ceilingTier: WorkflowDispatchMatrixTier | null;
+    ceilingTarget: ResolvedDispatchTargetReport | null;
+    selectedValue: string | null;
+    selectionMode: string;
+    selectionBranch: string;
+    target: ResolvedDispatchTargetReport | null;
+    cellSource: string | null;
+}
+export interface DispatchReportProviderResolution {
+    dispatchArgs: {
+        variant?: string;
+        model?: string;
+    } | null;
+    selection: DispatchReportSelectionInput;
+}
+export interface DispatchReportResolution {
+    status: DispatchReportPolicyStatus;
+    provider: string;
+    value: string | null;
+    policyMode: DispatchReportPolicyMode;
+    policy: string | null;
+    source: string | null;
+    providers: Record<string, DispatchReportProviderResolution>;
+}
+export interface DispatchReportV1 {
+    schemaVersion: 1;
+    route: {
+        scope: string;
+        action: DispatchAction;
+        role: DispatchRole;
+        target: string;
+    };
+    policy: {
+        status: DispatchReportPolicyStatus;
+        mode: DispatchReportPolicyMode;
+        name: string | null;
+        source: string | null;
+    };
+    selection: {
+        requestedCandidate: {
+            model: string;
+            effort?: string;
+        } | null;
+        candidateTier: WorkflowDispatchMatrixTier | null;
+        candidateIndex: number | null;
+        ceilingTier: WorkflowDispatchMatrixTier | null;
+        ceilingTarget: ResolvedDispatchTargetReport | null;
+        selectedValue: string | null;
+        exactSelectedTarget: ResolvedDispatchTargetReport | null;
+        selectionMode: string;
+        selectionBranch: string;
+        cellSource: string | null;
+    };
+    requestedControls: DispatchRequestedControls;
+    configuredDefaults: DispatchConfiguredDefaults;
+    gateInvocation: Readonly<DispatchGateInvocation> | null;
+    runtimeIdentity: DispatchRuntimeIdentity;
+}
+export interface DispatchReportInput {
+    scope: string;
+    action: DispatchAction;
+    role: DispatchRole;
+    resolution: DispatchReportResolution;
+    requestedControls: DispatchRequestedControls;
+    configuredDefaults: DispatchConfiguredDefaults;
+    gateInvocation?: DispatchGateInvocation | null;
+    runtimeIdentity?: DispatchRuntimeIdentity;
+}
+export declare function buildDispatchReport(input: DispatchReportInput): DispatchReportV1;
+export declare function serializeDispatchReport(report: DispatchReportV1): string;
+export declare function formatDispatchReport(report: DispatchReportV1): string;
+export declare function toDispatchStampRecord(report: DispatchReportV1): DispatchStampRecord;
+//# sourceMappingURL=dispatch-report.d.ts.map

package/dist/providers/identity/dispatch-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-report.d.ts","sourceRoot":"","sources":["../../../src/providers/identity/dispatch-report.ts"],"names":[],"mappings":"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"}

package/dist/providers/identity/dispatch-report.js

@@ -0,0 +1,285 @@
+const ROLE_BY_ACTION = {
+    implementation: 'implementer',
+    fix: 'fix',
+    review: 'reviewer',
+};
+const NOT_REPORTED_RUNTIME_IDENTITY = {
+    producer: null,
+    model: null,
+    effort: null,
+    provenance: 'unknown',
+    confidence: 'not-reported',
+};
+function cloneTarget(target) {
+    return target ? { ...target } : null;
+}
+function invocationTarget(provider) {
+    return (provider.dispatchArgs?.variant ?? provider.dispatchArgs?.model ?? 'unknown');
+}
+function assertActionRole(action, role) {
+    if (ROLE_BY_ACTION[action] !== role) {
+        throw new Error(`Invalid dispatch report action/role pair: ${action}/${role}`);
+    }
+}
+function orderedTarget(target) {
+    if (!target) {
+        return null;
+    }
+    return {
+        harness: target.harness,
+        ...(target.model === undefined ? {} : { model: target.model }),
+        ...(target.effort === undefined ? {} : { effort: target.effort }),
+        crossHarness: target.crossHarness,
+        routeIndex: target.routeIndex,
+        routeLength: target.routeLength,
+    };
+}
+function orderedReport(report) {
+    return {
+        schemaVersion: 1,
+        route: {
+            scope: report.route.scope,
+            action: report.route.action,
+            role: report.route.role,
+            target: report.route.target,
+        },
+        policy: {
+            status: report.policy.status,
+            mode: report.policy.mode,
+            name: report.policy.name,
+            source: report.policy.source,
+        },
+        selection: {
+            requestedCandidate: report.selection.requestedCandidate
+                ? {
+                    model: report.selection.requestedCandidate.model,
+                    ...(report.selection.requestedCandidate.effort === undefined
+                        ? {}
+                        : { effort: report.selection.requestedCandidate.effort }),
+                }
+                : null,
+            candidateTier: report.selection.candidateTier,
+            candidateIndex: report.selection.candidateIndex,
+            ceilingTier: report.selection.ceilingTier,
+            ceilingTarget: orderedTarget(report.selection.ceilingTarget),
+            selectedValue: report.selection.selectedValue,
+            exactSelectedTarget: orderedTarget(report.selection.exactSelectedTarget),
+            selectionMode: report.selection.selectionMode,
+            selectionBranch: report.selection.selectionBranch,
+            cellSource: report.selection.cellSource,
+        },
+        requestedControls: {
+            model: {
+                value: report.requestedControls.model.value,
+                mechanism: report.requestedControls.model.mechanism,
+                reason: report.requestedControls.model.reason,
+            },
+            effort: {
+                value: report.requestedControls.effort.value,
+                mechanism: report.requestedControls.effort.mechanism,
+                reason: report.requestedControls.effort.reason,
+            },
+        },
+        configuredDefaults: {
+            model: report.configuredDefaults.model,
+            modelSource: report.configuredDefaults.modelSource,
+            effort: report.configuredDefaults.effort,
+            effortSource: report.configuredDefaults.effortSource,
+        },
+        gateInvocation: report.gateInvocation
+            ? {
+                runId: report.gateInvocation.runId,
+                targetId: report.gateInvocation.targetId,
+                runtime: report.gateInvocation.runtime,
+                model: report.gateInvocation.model,
+                reasoningEffort: report.gateInvocation.reasoningEffort,
+                source: report.gateInvocation.source,
+            }
+            : null,
+        runtimeIdentity: {
+            producer: report.runtimeIdentity.producer,
+            model: report.runtimeIdentity.model,
+            effort: report.runtimeIdentity.effort,
+            provenance: report.runtimeIdentity.provenance,
+            confidence: report.runtimeIdentity.confidence,
+        },
+    };
+}
+function display(value) {
+    return value === null ? 'none' : String(value);
+}
+function formatTarget(target) {
+    if (!target) {
+        return 'none';
+    }
+    return [
+        `harness=${target.harness}`,
+        target.model === undefined ? null : `model=${target.model}`,
+        target.effort === undefined ? null : `effort=${target.effort}`,
+        `crossHarness=${String(target.crossHarness)}`,
+        `routeIndex=${target.routeIndex}`,
+        `routeLength=${target.routeLength}`,
+    ]
+        .filter((part) => part !== null)
+        .join(' ');
+}
+function formatCandidate(candidate) {
+    if (!candidate) {
+        return 'none';
+    }
+    return [
+        `model=${candidate.model}`,
+        candidate.effort === undefined ? null : `effort=${candidate.effort}`,
+    ]
+        .filter((part) => part !== null)
+        .join(' ');
+}
+function formatControl(name, control) {
+    return `  ${name}: ${display(control.value)} (${control.mechanism}) — ${control.reason}`;
+}
+function controlAxis(control) {
+    if (control.mechanism === 'task-model-argument' ||
+        control.mechanism === 'materialized-role') {
+        return control.value ? `selected:${control.value}` : 'unknown';
+    }
+    if (control.mechanism === 'host-inherited') {
+        return 'inherited';
+    }
+    if (control.mechanism === 'base-role' ||
+        control.mechanism === 'provider-default') {
+        return 'provider-default';
+    }
+    return 'not-applicable';
+}
+function dispatchPolicy(report) {
+    if (report.policy.name) {
+        return report.policy.name;
+    }
+    return report.policy.mode === 'inherit' ? 'inherit-host-defaults' : 'unknown';
+}
+function dispatchCeiling(report) {
+    return (report.selection.ceilingTarget?.effort ??
+        report.selection.ceilingTarget?.model ??
+        'none');
+}
+export function buildDispatchReport(input) {
+    assertActionRole(input.action, input.role);
+    const provider = input.resolution.providers[input.resolution.provider];
+    if (!provider) {
+        throw new Error(`Dispatch report resolution is missing provider data for "${input.resolution.provider}".`);
+    }
+    const { selection } = provider;
+    const gateInvocation = input.gateInvocation
+        ? Object.freeze({ ...input.gateInvocation })
+        : null;
+    return {
+        schemaVersion: 1,
+        route: {
+            scope: input.scope,
+            action: input.action,
+            role: input.role,
+            target: invocationTarget(provider),
+        },
+        policy: {
+            status: input.resolution.status,
+            mode: input.resolution.policyMode,
+            name: input.resolution.policy,
+            source: input.resolution.source,
+        },
+        selection: {
+            requestedCandidate: selection.requestedCandidate
+                ? { ...selection.requestedCandidate }
+                : null,
+            candidateTier: selection.candidateTier,
+            candidateIndex: selection.candidateIndex,
+            ceilingTier: selection.ceilingTier,
+            ceilingTarget: cloneTarget(selection.ceilingTarget),
+            selectedValue: selection.selectedValue,
+            exactSelectedTarget: cloneTarget(selection.target),
+            selectionMode: selection.selectionMode,
+            selectionBranch: selection.selectionBranch,
+            cellSource: selection.cellSource,
+        },
+        requestedControls: {
+            model: { ...input.requestedControls.model },
+            effort: { ...input.requestedControls.effort },
+        },
+        configuredDefaults: { ...input.configuredDefaults },
+        gateInvocation,
+        runtimeIdentity: input.runtimeIdentity
+            ? { ...input.runtimeIdentity }
+            : { ...NOT_REPORTED_RUNTIME_IDENTITY },
+    };
+}
+export function serializeDispatchReport(report) {
+    return JSON.stringify(orderedReport(report), null, 2);
+}
+export function formatDispatchReport(report) {
+    const runtimeNotReported = report.runtimeIdentity.producer === null &&
+        report.runtimeIdentity.model === null &&
+        report.runtimeIdentity.effort === null &&
+        report.runtimeIdentity.confidence === 'not-reported';
+    const runtimeValue = (value) => value === null ? 'not reported' : value;
+    const gateLines = report.gateInvocation
+        ? [
+            `  Run ID: ${report.gateInvocation.runId}`,
+            `  Target ID: ${report.gateInvocation.targetId}`,
+            `  Runtime: ${report.gateInvocation.runtime}`,
+            `  Model: ${report.gateInvocation.model}`,
+            `  Reasoning effort: ${report.gateInvocation.reasoningEffort}`,
+            `  Source: ${report.gateInvocation.source}`,
+        ]
+        : ['  Not configured'];
+    return [
+        'Dispatch Report V1',
+        'Route',
+        `  Scope: ${report.route.scope}`,
+        `  Action / role: ${report.route.action} / ${report.route.role}`,
+        `  Invocation target: ${report.route.target}`,
+        'Policy',
+        `  Status: ${report.policy.status}`,
+        `  Mode / name: ${display(report.policy.mode)} / ${display(report.policy.name)}`,
+        `  Source: ${display(report.policy.source)}`,
+        'Selection',
+        `  Requested candidate: ${formatCandidate(report.selection.requestedCandidate)}`,
+        `  Candidate tier / index: ${display(report.selection.candidateTier)} / ${display(report.selection.candidateIndex)}`,
+        `  Ceiling tier: ${display(report.selection.ceilingTier)}`,
+        `  Ceiling target: ${formatTarget(report.selection.ceilingTarget)}`,
+        `  Selected value: ${display(report.selection.selectedValue)}`,
+        `  Exact selected target: ${formatTarget(report.selection.exactSelectedTarget)}`,
+        `  Mode / branch: ${report.selection.selectionMode} / ${report.selection.selectionBranch}`,
+        `  Cell source: ${display(report.selection.cellSource)}`,
+        'Requested controls',
+        formatControl('Model', report.requestedControls.model),
+        formatControl('Effort', report.requestedControls.effort),
+        'Configured defaults (not runtime observations)',
+        `  Model: ${display(report.configuredDefaults.model)}`,
+        `  Model source: ${display(report.configuredDefaults.modelSource)}`,
+        `  Effort: ${display(report.configuredDefaults.effort)}`,
+        `  Effort source: ${display(report.configuredDefaults.effortSource)}`,
+        'Gate invocation (configured, immutable)',
+        ...gateLines,
+        'Runtime identity (observed/reported separately)',
+        ...(runtimeNotReported ? ['  Runtime identity was not reported.'] : []),
+        `  Producer: ${runtimeValue(report.runtimeIdentity.producer)}`,
+        `  Model: ${runtimeValue(report.runtimeIdentity.model)}`,
+        `  Effort: ${runtimeValue(report.runtimeIdentity.effort)}`,
+        `  Provenance: ${report.runtimeIdentity.provenance}`,
+        `  Confidence: ${report.runtimeIdentity.confidence}`,
+    ].join('\n');
+}
+export function toDispatchStampRecord(report) {
+    const runtimeReported = report.runtimeIdentity.producer !== null;
+    return {
+        scope: report.route.scope,
+        action: report.route.action,
+        role: report.route.role,
+        producer: report.runtimeIdentity.producer ?? 'unknown',
+        provenance: runtimeReported ? report.runtimeIdentity.provenance : 'unknown',
+        modelAxis: controlAxis(report.requestedControls.model),
+        effortAxis: controlAxis(report.requestedControls.effort),
+        dispatchPolicy: dispatchPolicy(report),
+        dispatchCeiling: dispatchCeiling(report),
+        target: report.route.target,
+    };
+}

package/dist/providers/identity/dispatch-validation.d.ts

@@ -0,0 +1,28 @@
+import type { DispatchMatrixCellRef } from '../../config/dispatch-matrix.js';
+import { probeCursorSubagentModel, resolveCursorModelCatalog, validateMatrixCell, type CursorCatalogResult, type CursorTaskProbeResult, type MatrixCellAvailability, type ValidateMatrixCellOptions } from './availability.js';
+export type DispatchValidationEvidence = 'task-probe' | 'subagent-allow-list' | 'catalog-only' | 'none';
+export interface DispatchMatrixValidationResult {
+    ref: DispatchMatrixCellRef;
+    status: MatrixCellAvailability;
+    evidence: DispatchValidationEvidence;
+    catalogPresence: boolean | null;
+    diagnostic: string;
+}
+export interface DispatchValidationPassOptions extends Omit<ValidateMatrixCellOptions, 'detailed' | 'target'> {
+    validateMatrixCell?: typeof validateMatrixCell;
+    probeCursorSubagentModel?: typeof probeCursorSubagentModel;
+    resolveCursorModelCatalog?: typeof resolveCursorModelCatalog;
+}
+interface MemoizedCursorTaskProbe {
+    result: CursorTaskProbeResult;
+    diagnostic: string;
+}
+export interface DispatchValidationPassContext {
+    cursorCatalog: Promise<CursorCatalogResult> | null;
+    cursorTaskProbes: Map<string, Promise<MemoizedCursorTaskProbe>>;
+    options: DispatchValidationPassOptions;
+}
+export declare function createDispatchValidationPassContext(options?: DispatchValidationPassOptions): DispatchValidationPassContext;
+export declare function validateDispatchMatrixRefs(refs: DispatchMatrixCellRef[], context: DispatchValidationPassContext): Promise<DispatchMatrixValidationResult[]>;
+export {};
+//# sourceMappingURL=dispatch-validation.d.ts.map

package/dist/providers/identity/dispatch-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-validation.d.ts","sourceRoot":"","sources":["../../../src/providers/identity/dispatch-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAEL,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,0BAA0B,GAClC,YAAY,GACZ,qBAAqB,GACrB,cAAc,GACd,MAAM,CAAC;AAEX,MAAM,WAAW,8BAA8B;IAC7C,GAAG,EAAE,qBAAqB,CAAC;IAC3B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,QAAQ,EAAE,0BAA0B,CAAC;IACrC,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA8B,SAAQ,IAAI,CACzD,yBAAyB,EACzB,UAAU,GAAG,QAAQ,CACtB;IACC,kBAAkB,CAAC,EAAE,OAAO,kBAAkB,CAAC;IAC/C,wBAAwB,CAAC,EAAE,OAAO,wBAAwB,CAAC;IAC3D,yBAAyB,CAAC,EAAE,OAAO,yBAAyB,CAAC;CAC9D;AAED,UAAU,uBAAuB;IAC/B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC;IACnD,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAChE,OAAO,EAAE,6BAA6B,CAAC;CACxC;AAiMD,wBAAgB,mCAAmC,CACjD,OAAO,GAAE,6BAAsD,GAC9D,6BAA6B,CAM/B;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,qBAAqB,EAAE,EAC7B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,8BAA8B,EAAE,CAAC,CAE3C"}