@made-by-moonlight/athene-core 0.9.1

package/dist/lifecycle-state.js

@@ -0,0 +1,446 @@
+import { z } from 'zod';
+import { parsePrFromUrl } from './utils/pr.js';
+import { safeJsonParse, validateStatus } from './utils/validation.js';
+
+const TimestampSchema = z.string().nullable();
+const RuntimeHandleSchema = z.object({
+    id: z.string(),
+    runtimeName: z.string(),
+    data: z.preprocess((value) => {
+        if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+            return value;
+        }
+        return {};
+    }, z.record(z.unknown())),
+});
+const CanonicalSessionLifecycleSchema = z.object({
+    version: z.literal(2),
+    session: z
+        .object({
+        kind: z.enum(["worker", "orchestrator"]),
+        state: z.enum([
+            "not_started",
+            "working",
+            "idle",
+            "needs_input",
+            "stuck",
+            "detecting",
+            "done",
+            "terminated",
+        ]),
+        reason: z.enum([
+            "spawn_requested",
+            "agent_acknowledged",
+            "task_in_progress",
+            "pr_created",
+            "pr_closed_waiting_decision",
+            "fixing_ci",
+            "resolving_review_comments",
+            "awaiting_user_input",
+            "awaiting_external_review",
+            "research_complete",
+            "merged_waiting_decision",
+            "manually_killed",
+            "runtime_lost",
+            "agent_process_exited",
+            "probe_failure",
+            "error_in_process",
+            "auto_cleanup",
+            "pr_merged",
+        ]),
+        startedAt: TimestampSchema,
+        completedAt: TimestampSchema,
+        terminatedAt: TimestampSchema,
+        lastTransitionAt: z.string(),
+    })
+        .partial()
+        .optional(),
+    pr: z
+        .object({
+        state: z.enum(["none", "open", "merged", "closed"]),
+        reason: z.enum([
+            "not_created",
+            "in_progress",
+            "ci_failing",
+            "review_pending",
+            "changes_requested",
+            "approved",
+            "merge_ready",
+            "merged",
+            "closed_unmerged",
+            "cleared_on_restore",
+        ]),
+        number: z.number().int().nullable(),
+        url: z.string().nullable(),
+        lastObservedAt: TimestampSchema,
+    })
+        .partial()
+        .optional(),
+    runtime: z
+        .object({
+        state: z.enum(["unknown", "alive", "exited", "missing", "probe_failed"]),
+        reason: z.enum([
+            "spawn_incomplete",
+            "process_running",
+            "process_missing",
+            "tmux_missing",
+            "manual_kill_requested",
+            "probe_error",
+            "pr_merged_cleanup",
+            "auto_cleanup",
+        ]),
+        lastObservedAt: TimestampSchema,
+        handle: RuntimeHandleSchema.nullable(),
+        tmuxName: z.string().nullable(),
+    })
+        .partial()
+        .optional(),
+});
+const TERMINAL_CANONICAL_SESSION_STATES = new Set([
+    "done",
+    "terminated",
+]);
+function clearTerminalMarkersForNonTerminalState(lifecycle) {
+    if (TERMINAL_CANONICAL_SESSION_STATES.has(lifecycle.session.state))
+        return;
+    lifecycle.session.completedAt = null;
+    lifecycle.session.terminatedAt = null;
+}
+function normalizeTimestamp(value, fallback = null) {
+    if (typeof value !== "string")
+        return fallback;
+    const parsed = Date.parse(value);
+    return Number.isNaN(parsed) ? fallback : new Date(parsed).toISOString();
+}
+function normalizeRuntimeHandle(value) {
+    if (!value || typeof value !== "object")
+        return null;
+    const record = value;
+    if (typeof record["id"] !== "string" || typeof record["runtimeName"] !== "string")
+        return null;
+    const data = record["data"];
+    return {
+        id: record["id"],
+        runtimeName: record["runtimeName"],
+        data: data && typeof data === "object" ? data : {},
+    };
+}
+function createInitialCanonicalLifecycle(kind, now = new Date()) {
+    const timestamp = now.toISOString();
+    return {
+        version: 2,
+        session: {
+            kind,
+            state: "not_started",
+            reason: "spawn_requested",
+            startedAt: null,
+            completedAt: null,
+            terminatedAt: null,
+            lastTransitionAt: timestamp,
+        },
+        pr: {
+            state: "none",
+            reason: "not_created",
+            number: null,
+            url: null,
+            lastObservedAt: null,
+        },
+        runtime: {
+            state: "unknown",
+            reason: "spawn_incomplete",
+            lastObservedAt: null,
+            handle: null,
+            tmuxName: null,
+        },
+    };
+}
+function synthesizeSessionState(status) {
+    switch (status) {
+        case "spawning":
+            return { state: "not_started", reason: "spawn_requested" };
+        case "needs_input":
+            return { state: "needs_input", reason: "awaiting_user_input" };
+        case "stuck":
+            return { state: "stuck", reason: "probe_failure" };
+        case "errored":
+            return { state: "terminated", reason: "error_in_process" };
+        case "killed":
+        case "terminated":
+        case "cleanup":
+            return { state: "terminated", reason: "manually_killed" };
+        case "done":
+            return { state: "done", reason: "research_complete" };
+        case "merged":
+            return { state: "idle", reason: "merged_waiting_decision" };
+        case "idle":
+            return { state: "idle", reason: "awaiting_external_review" };
+        default:
+            return { state: "working", reason: "task_in_progress" };
+    }
+}
+function synthesizePRState(meta, status) {
+    const prUrl = meta["pr"] ?? null;
+    if (!prUrl) {
+        // Legacy metadata can record `status=merged` without `pr=` (the PR URL was
+        // never written, or was pruned). Preserve the terminal truth — the legacy
+        // status is authoritative for session terminality — so downstream
+        // consumers like isTerminalSession don't lose the "merged" signal.
+        if (status === "merged") {
+            return { state: "merged", reason: "merged", number: null, url: null };
+        }
+        return { state: "none", reason: "not_created", number: null, url: null };
+    }
+    const parsed = parsePrFromUrl(prUrl);
+    return {
+        state: status === "merged" ? "merged" : "open",
+        reason: status === "merged" ? "merged" : "in_progress",
+        number: parsed?.number ?? null,
+        url: prUrl,
+    };
+}
+function synthesizeRuntimeState(meta, runtimeHandle) {
+    const tmuxName = meta["tmuxName"]?.trim() || null;
+    const handle = runtimeHandle ?? (meta["runtimeHandle"] ? safeJsonParse(meta["runtimeHandle"]) : null);
+    if (handle || tmuxName) {
+        return {
+            state: "unknown",
+            reason: "spawn_incomplete",
+            handle: handle ?? null,
+            tmuxName,
+        };
+    }
+    return {
+        state: "unknown",
+        reason: "spawn_incomplete",
+        handle: null,
+        tmuxName: null,
+    };
+}
+function synthesizeCanonicalLifecycle(meta, options = {}) {
+    const status = options.status ?? validateStatus(meta["status"]);
+    const sessionKind = options.sessionKind ??
+        (meta["role"] === "orchestrator" || options.sessionId?.endsWith("-orchestrator")
+            ? "orchestrator"
+            : "worker");
+    const now = options.createdAt?.toISOString() ??
+        normalizeTimestamp(meta["createdAt"], new Date().toISOString()) ??
+        new Date().toISOString();
+    const sessionState = synthesizeSessionState(status);
+    const pr = synthesizePRState(meta, status);
+    const runtime = synthesizeRuntimeState(meta, options.runtimeHandle ?? null);
+    return {
+        version: 2,
+        session: {
+            kind: sessionKind,
+            state: sessionState.state,
+            reason: sessionState.reason,
+            startedAt: status === "spawning" ? null : now,
+            completedAt: status === "done" ? now : null,
+            terminatedAt: status === "killed" || status === "terminated" || status === "cleanup" ? now : null,
+            lastTransitionAt: now,
+        },
+        pr: {
+            state: pr.state,
+            reason: pr.reason,
+            number: pr.number,
+            url: pr.url,
+            lastObservedAt: pr.url ? now : null,
+        },
+        runtime: {
+            state: runtime.state,
+            reason: runtime.reason,
+            lastObservedAt: runtime.handle || runtime.tmuxName ? now : null,
+            handle: runtime.handle,
+            tmuxName: runtime.tmuxName,
+        },
+    };
+}
+function normalizePayloadLifecycle(payload, meta, options = {}) {
+    const synthesized = synthesizeCanonicalLifecycle(meta, options);
+    const payloadSession = payload.session;
+    const payloadPr = payload.pr;
+    const payloadRuntime = payload.runtime;
+    const hasPayloadSessionKind = Object.hasOwn(payloadSession ?? {}, "kind");
+    const hasPayloadSessionState = Object.hasOwn(payloadSession ?? {}, "state");
+    const hasPayloadSessionReason = Object.hasOwn(payloadSession ?? {}, "reason");
+    const hasPayloadSessionStartedAt = Object.hasOwn(payloadSession ?? {}, "startedAt");
+    const hasPayloadSessionCompletedAt = Object.hasOwn(payloadSession ?? {}, "completedAt");
+    const hasPayloadSessionTerminatedAt = Object.hasOwn(payloadSession ?? {}, "terminatedAt");
+    const hasPayloadSessionLastTransitionAt = Object.hasOwn(payloadSession ?? {}, "lastTransitionAt");
+    const hasPayloadPrState = Object.hasOwn(payloadPr ?? {}, "state");
+    const hasPayloadPrReason = Object.hasOwn(payloadPr ?? {}, "reason");
+    const hasPayloadPrNumber = Object.hasOwn(payloadPr ?? {}, "number");
+    const hasPayloadPrUrl = Object.hasOwn(payloadPr ?? {}, "url");
+    const hasPayloadPrLastObservedAt = Object.hasOwn(payloadPr ?? {}, "lastObservedAt");
+    const hasPayloadRuntimeState = Object.hasOwn(payloadRuntime ?? {}, "state");
+    const hasPayloadRuntimeReason = Object.hasOwn(payloadRuntime ?? {}, "reason");
+    const hasPayloadRuntimeLastObservedAt = Object.hasOwn(payloadRuntime ?? {}, "lastObservedAt");
+    const hasPayloadRuntimeHandle = Object.hasOwn(payloadRuntime ?? {}, "handle");
+    const hasPayloadRuntimeTmuxName = Object.hasOwn(payloadRuntime ?? {}, "tmuxName");
+    return {
+        version: 2,
+        session: {
+            kind: hasPayloadSessionKind
+                ? payloadSession?.kind === "orchestrator"
+                    ? "orchestrator"
+                    : "worker"
+                : synthesized.session.kind,
+            state: hasPayloadSessionState
+                ? payloadSession?.state ?? synthesized.session.state
+                : synthesized.session.state,
+            reason: hasPayloadSessionReason
+                ? payloadSession?.reason ?? synthesized.session.reason
+                : synthesized.session.reason,
+            startedAt: hasPayloadSessionStartedAt
+                ? normalizeTimestamp(payloadSession?.startedAt)
+                : synthesized.session.startedAt,
+            completedAt: hasPayloadSessionCompletedAt
+                ? normalizeTimestamp(payloadSession?.completedAt)
+                : synthesized.session.completedAt,
+            terminatedAt: hasPayloadSessionTerminatedAt
+                ? normalizeTimestamp(payloadSession?.terminatedAt)
+                : synthesized.session.terminatedAt,
+            lastTransitionAt: hasPayloadSessionLastTransitionAt
+                ? normalizeTimestamp(payloadSession?.lastTransitionAt, synthesized.session.lastTransitionAt) ??
+                    synthesized.session.lastTransitionAt
+                : synthesized.session.lastTransitionAt,
+        },
+        pr: {
+            state: hasPayloadPrState
+                ? payloadPr?.state ?? synthesized.pr.state
+                : synthesized.pr.state,
+            reason: hasPayloadPrReason
+                ? payloadPr?.reason ?? synthesized.pr.reason
+                : synthesized.pr.reason,
+            number: hasPayloadPrNumber
+                ? typeof payloadPr?.number === "number"
+                    ? payloadPr.number
+                    : null
+                : synthesized.pr.number,
+            url: hasPayloadPrUrl ? (typeof payloadPr?.url === "string" ? payloadPr.url : null) : synthesized.pr.url,
+            lastObservedAt: hasPayloadPrLastObservedAt
+                ? normalizeTimestamp(payloadPr?.lastObservedAt)
+                : synthesized.pr.lastObservedAt,
+        },
+        runtime: {
+            state: hasPayloadRuntimeState
+                ? payloadRuntime?.state ?? synthesized.runtime.state
+                : synthesized.runtime.state,
+            reason: hasPayloadRuntimeReason
+                ? payloadRuntime?.reason ??
+                    synthesized.runtime.reason
+                : synthesized.runtime.reason,
+            lastObservedAt: hasPayloadRuntimeLastObservedAt
+                ? normalizeTimestamp(payloadRuntime?.lastObservedAt)
+                : synthesized.runtime.lastObservedAt,
+            handle: hasPayloadRuntimeHandle
+                ? normalizeRuntimeHandle(payloadRuntime?.handle)
+                : synthesized.runtime.handle,
+            tmuxName: hasPayloadRuntimeTmuxName
+                ? typeof payloadRuntime?.tmuxName === "string"
+                    ? payloadRuntime.tmuxName
+                    : null
+                : synthesized.runtime.tmuxName,
+        },
+    };
+}
+function parseCanonicalLifecycle(meta, options = {}) {
+    const parsed = meta["lifecycle"]
+        ? safeJsonParse(meta["lifecycle"])
+        : meta["statePayload"] && meta["stateVersion"] === "2"
+            ? safeJsonParse(meta["statePayload"])
+            : null;
+    const validated = CanonicalSessionLifecycleSchema.safeParse(parsed);
+    if (validated.success) {
+        return normalizePayloadLifecycle(validated.data, meta, options);
+    }
+    return synthesizeCanonicalLifecycle(meta, options);
+}
+function deriveLegacyStatus(lifecycle) {
+    switch (lifecycle.session.state) {
+        case "not_started":
+            return "spawning";
+        case "needs_input":
+            return "needs_input";
+        case "stuck":
+            return "stuck";
+        case "done":
+            return "done";
+        case "terminated":
+            // Derive specific terminal status from lifecycle reason
+            switch (lifecycle.session.reason) {
+                case "manually_killed":
+                case "runtime_lost":
+                    return "killed";
+                case "auto_cleanup":
+                case "pr_merged":
+                    return "cleanup";
+                case "error_in_process":
+                case "probe_failure":
+                    return "errored";
+                default:
+                    return "terminated";
+            }
+        case "detecting":
+            return "detecting";
+    }
+    if (lifecycle.pr.state === "merged") {
+        return "merged";
+    }
+    if (lifecycle.pr.state === "open") {
+        if (lifecycle.pr.reason === "ci_failing")
+            return "ci_failed";
+        if (lifecycle.pr.reason === "changes_requested")
+            return "changes_requested";
+        if (lifecycle.pr.reason === "review_pending")
+            return "review_pending";
+        if (lifecycle.pr.reason === "approved")
+            return "approved";
+        if (lifecycle.pr.reason === "merge_ready")
+            return "mergeable";
+        return "pr_open";
+    }
+    switch (lifecycle.session.state) {
+        case "idle":
+            return "idle";
+        case "working":
+            return "working";
+        default:
+            return "working";
+    }
+}
+/**
+ * Build a minimal metadata patch for persisting lifecycle state outside the polling loop.
+ * Used by writeCanonicalLifecycle() and agent-report writes. Does NOT include detecting
+ * or evidence metadata — use buildTransitionMetadataPatch() for lifecycle poll transitions.
+ */
+function buildLifecycleMetadataPatch(lifecycle) {
+    return {
+        lifecycle: JSON.stringify(lifecycle),
+        // status is NOT persisted — computed on read via deriveLegacyStatus()
+        pr: lifecycle.pr.url ?? "",
+        runtimeHandle: lifecycle.runtime.handle ? JSON.stringify(lifecycle.runtime.handle) : "",
+        tmuxName: lifecycle.runtime.tmuxName ?? "",
+        role: lifecycle.session.kind === "orchestrator" ? "orchestrator" : "",
+    };
+}
+function cloneLifecycle(lifecycle) {
+    return {
+        version: 2,
+        session: { ...lifecycle.session },
+        pr: { ...lifecycle.pr },
+        runtime: {
+            ...lifecycle.runtime,
+            handle: lifecycle.runtime.handle
+                ? {
+                    id: lifecycle.runtime.handle.id,
+                    runtimeName: lifecycle.runtime.handle.runtimeName,
+                    data: structuredClone(lifecycle.runtime.handle.data),
+                }
+                : null,
+        },
+    };
+}
+
+export { buildLifecycleMetadataPatch, clearTerminalMarkersForNonTerminalState, cloneLifecycle, createInitialCanonicalLifecycle, deriveLegacyStatus, parseCanonicalLifecycle };
+//# sourceMappingURL=lifecycle-state.js.map

package/dist/lifecycle-state.js.map

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

package/dist/lifecycle-status-decisions.d.ts

@@ -0,0 +1,85 @@
+import { type ActivitySignal, type CanonicalPRReason, type CanonicalPRState, type CanonicalSessionReason, type CanonicalSessionState, type CIStatus, type PREnrichmentData, type SessionStatus } from "./types.js";
+export declare const DETECTING_MAX_ATTEMPTS = 3;
+/** Hard time cap for detecting state — escalate after this regardless of attempts. */
+export declare const DETECTING_MAX_DURATION_MS: number;
+type ProbeState = "alive" | "dead" | "unknown";
+type PRReviewDecision = PREnrichmentData["reviewDecision"];
+type LifecycleSessionState = CanonicalSessionState;
+type LifecycleSessionReason = CanonicalSessionReason;
+type LifecyclePRState = CanonicalPRState;
+type LifecyclePRReason = CanonicalPRReason;
+interface LifecycleDecision {
+    status: SessionStatus;
+    evidence: string;
+    detecting: {
+        attempts: number;
+        /** ISO timestamp when detecting state was first entered (for time-based escalation). */
+        startedAt?: string;
+        /** Hash of evidence to detect unchanged evidence across polls. */
+        evidenceHash?: string;
+    };
+    sessionState?: LifecycleSessionState;
+    sessionReason?: LifecycleSessionReason;
+    prState?: LifecyclePRState;
+    prReason?: LifecyclePRReason;
+}
+export declare function hashEvidence(evidence: string): string;
+interface OpenPRDecisionInput {
+    reviewDecision: PRReviewDecision;
+    ciFailing: boolean;
+    mergeable: boolean;
+    shouldEscalateIdleToStuck: boolean;
+    idleWasBlocked: boolean;
+    activityEvidence: string;
+}
+interface ProbeResult {
+    state: ProbeState;
+    failed: boolean;
+}
+interface ProbeDecisionInput {
+    currentAttempts: number;
+    runtimeProbe: ProbeResult;
+    processProbe: ProbeResult;
+    canProbeRuntimeIdentity: boolean;
+    activitySignal: ActivitySignal;
+    activityEvidence: string;
+    idleWasBlocked: boolean;
+    /** ISO timestamp when detecting first started (from metadata). */
+    detectingStartedAt?: string;
+    /** Previous evidence hash (from metadata). */
+    previousEvidenceHash?: string;
+}
+export interface DetectingDecisionInput {
+    currentAttempts: number;
+    idleWasBlocked: boolean;
+    evidence: string;
+    reason?: LifecycleSessionReason;
+    /** ISO timestamp when detecting first started (from metadata). */
+    detectingStartedAt?: string;
+    /** Previous evidence hash (from metadata). */
+    previousEvidenceHash?: string;
+    /** Current time for time-based escalation check. */
+    now?: Date;
+}
+/**
+ * Check if detecting has exceeded its time budget.
+ */
+export declare function isDetectingTimedOut(detectingStartedAt: string | undefined, now?: Date): boolean;
+export declare function createDetectingDecision(input: DetectingDecisionInput | (Pick<ProbeDecisionInput, "currentAttempts" | "idleWasBlocked"> & {
+    evidence: string;
+    reason?: LifecycleSessionReason;
+})): LifecycleDecision;
+export declare function parseAttemptCount(raw: string | undefined): number;
+export declare function resolveProbeDecision(input: ProbeDecisionInput): LifecycleDecision | null;
+export declare function resolvePREnrichmentDecision(cachedData: PREnrichmentData, options: Pick<OpenPRDecisionInput, "shouldEscalateIdleToStuck" | "idleWasBlocked" | "activityEvidence">): LifecycleDecision;
+export declare function resolvePRLiveDecision(input: {
+    prState: "open" | "merged" | "closed";
+    ciStatus: CIStatus;
+    reviewDecision: PRReviewDecision;
+    mergeable: boolean;
+    shouldEscalateIdleToStuck: boolean;
+    idleWasBlocked: boolean;
+    activityEvidence: string;
+}): LifecycleDecision;
+export type { LifecycleDecision };
+//# sourceMappingURL=lifecycle-status-decisions.d.ts.map

package/dist/lifecycle-status-decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-status-decisions.d.ts","sourceRoot":"","sources":["../src/lifecycle-status-decisions.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,sFAAsF;AACtF,eAAO,MAAM,yBAAyB,QAAgB,CAAC;AAEvD,KAAK,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAC/C,KAAK,gBAAgB,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;AAC3D,KAAK,qBAAqB,GAAG,qBAAqB,CAAC;AACnD,KAAK,sBAAsB,GAAG,sBAAsB,CAAC;AACrD,KAAK,gBAAgB,GAAG,gBAAgB,CAAC;AACzC,KAAK,iBAAiB,GAAG,iBAAiB,CAAC;AAE3C,UAAU,iBAAiB;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,wFAAwF;QACxF,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kEAAkE;QAClE,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAaD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,UAAU,mBAAmB;IAC3B,cAAc,EAAE,gBAAgB,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,yBAAyB,EAAE,OAAO,CAAC;IACnC,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,WAAW;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,UAAU,kBAAkB;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,WAAW,CAAC;IAC1B,YAAY,EAAE,WAAW,CAAC;IAC1B,uBAAuB,EAAE,OAAO,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAMD,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oDAAoD;IACpD,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,GAAG,GAAE,IAAiB,GACrB,OAAO,CAKT;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,sBAAsB,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,GAAG,gBAAgB,CAAC,GAAG;IAChG,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,sBAAsB,CAAC;CACjC,CAAC,GACD,iBAAiB,CAyCnB;AAsHD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIjE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,IAAI,CA0DxF;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,IAAI,CACX,mBAAmB,EACnB,2BAA2B,GAAG,gBAAgB,GAAG,kBAAkB,CACpE,GACA,iBAAiB,CAcnB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,gBAAgB,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,yBAAyB,EAAE,OAAO,CAAC;IACnC,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,iBAAiB,CAcpB;AAED,YAAY,EAAE,iBAAiB,EAAE,CAAC"}