@openrig/cli 0.5.0 → 0.5.1

package/node_modules/@openrig/daemon/dist/domain/watchdog-jobs-repository.js

@@ -0,0 +1,317 @@
+import { ulid } from "ulid";
+/**
+ * Watchdog jobs repository (PL-004 Phase C; extended in Phase D).
+ *
+ * Owns all reads/writes against `watchdog_jobs`. Pure persistence; no
+ * event-bus, no scheduler, no policy dispatch. Composed by the
+ * scheduler and policy engine.
+ *
+ * Phase D v1 accepts FOUR policy values (the orch-ratified Phase C
+ * `workflow-keepalive` deferral has been lifted; the policy module
+ * now exists at `policies/workflow-keepalive.ts` and reads from the
+ * SQLite `workflow_instances` table introduced in Phase D):
+ *   - periodic-reminder (Phase C)
+ *   - artifact-pool-ready (Phase C)
+ *   - edge-artifact-required (Phase C)
+ *   - workflow-keepalive (Phase D)
+ *
+ * PHASE_C_POLICIES retained as a deprecated alias for callers that
+ * still reference it; new code uses PHASE_D_POLICIES.
+ */
+export const PHASE_D_POLICIES = [
+    "periodic-reminder",
+    "artifact-pool-ready",
+    "edge-artifact-required",
+    "workflow-keepalive",
+    // OPR.0.4.3.16 — idle-seat gate watchdog. DB-backed (queue_items) +
+    // AgentActivityStore-backed; factory-constructed at startup and injected
+    // via WatchdogPolicyEngine additionalPolicies (like workflow-keepalive).
+    "idle-gate-qitem",
+];
+/** @deprecated since Phase D — use PHASE_D_POLICIES. */
+export const PHASE_C_POLICIES = PHASE_D_POLICIES;
+export class WatchdogJobsError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "WatchdogJobsError";
+    }
+}
+/** Defensive additive-column detect (mirrors queue-repository's detectQueueColumn): a harness whose
+ *  db predates migration 063 lacks the generation columns, so writers degrade instead of throwing. */
+function detectWatchdogColumn(db, columnName) {
+    try {
+        return db.prepare("PRAGMA table_info(watchdog_jobs)").all()
+            .some((row) => row.name === columnName);
+    }
+    catch {
+        return false;
+    }
+}
+export class WatchdogJobsRepository {
+    db;
+    now;
+    resolveOccupantGeneration;
+    hasGenColumn;
+    hasTargetGenColumn;
+    constructor(db, now = () => new Date(), 
+    // GHOST-STAGE (e/Class-B): resolve the ARMING occupant's atom-B generation so a job carries the
+    // generation that registered it. null/absent ⇒ UNKNOWN → the column stays NULL and the swap-time
+    // gen predicate never matches it (never dropped on unknown). Injected in startup (SessionRegistry).
+    resolveOccupantGeneration) {
+        this.db = db;
+        this.now = now;
+        this.resolveOccupantGeneration = resolveOccupantGeneration;
+        this.hasGenColumn = detectWatchdogColumn(db, "registered_by_generation_uuid");
+        this.hasTargetGenColumn = detectWatchdogColumn(db, "target_generation_uuid");
+    }
+    register(input) {
+        if (!PHASE_D_POLICIES.includes(input.policy)) {
+            throw new WatchdogJobsError("policy_unknown", `unknown watchdog policy '${input.policy}'; Phase D v1 supports: ${PHASE_D_POLICIES.join(", ")}`, { policy: input.policy, supported: [...PHASE_D_POLICIES] });
+        }
+        if (!Number.isInteger(input.intervalSeconds) || input.intervalSeconds <= 0) {
+            throw new WatchdogJobsError("interval_invalid", `interval_seconds must be a positive integer (got ${input.intervalSeconds})`, { intervalSeconds: input.intervalSeconds });
+        }
+        if (!input.targetSession || !input.targetSession.includes("@")) {
+            throw new WatchdogJobsError("target_session_invalid", `target_session must be canonical '<member>@<rig>' (got '${input.targetSession}')`, { targetSession: input.targetSession });
+        }
+        const jobId = ulid();
+        const registeredAt = this.now().toISOString();
+        // (e/Class-B): stamp the ARMING occupant's generation so a swap can drop THIS gen's armed jobs
+        // (a stale wake firing into the successor's context is the ghost). NULL when unresolved/pre-063.
+        const registeredByGeneration = this.hasGenColumn
+            ? (this.resolveOccupantGeneration?.(input.registeredBySession) ?? null)
+            : null;
+        // (i-c) opt-in TARGET generation: caller-supplied (NULL = role-bound). Stored only when the 066
+        // column exists; pre-066 dbs silently degrade the opt-in to role-bound. 066 ⟹ 063 (additive order).
+        const targetGenerationUuid = this.hasTargetGenColumn ? (input.targetGenerationUuid ?? null) : null;
+        if (this.hasTargetGenColumn) {
+            this.db
+                .prepare(`INSERT INTO watchdog_jobs (
+            job_id, policy, spec_yaml, target_session,
+            interval_seconds, active_wake_interval_seconds, scan_interval_seconds,
+            last_evaluation_at, last_fire_at, state,
+            registered_by_session, registered_at, terminal_reason,
+            registered_by_generation_uuid, target_generation_uuid
+          ) VALUES (?, ?, ?, ?, ?, ?, ?, NULL, NULL, 'active', ?, ?, NULL, ?, ?)`)
+                .run(jobId, input.policy, input.specYaml, input.targetSession, input.intervalSeconds, input.activeWakeIntervalSeconds ?? null, input.scanIntervalSeconds ?? null, input.registeredBySession, registeredAt, registeredByGeneration, targetGenerationUuid);
+        }
+        else if (this.hasGenColumn) {
+            this.db
+                .prepare(`INSERT INTO watchdog_jobs (
+            job_id, policy, spec_yaml, target_session,
+            interval_seconds, active_wake_interval_seconds, scan_interval_seconds,
+            last_evaluation_at, last_fire_at, state,
+            registered_by_session, registered_at, terminal_reason,
+            registered_by_generation_uuid
+          ) VALUES (?, ?, ?, ?, ?, ?, ?, NULL, NULL, 'active', ?, ?, NULL, ?)`)
+                .run(jobId, input.policy, input.specYaml, input.targetSession, input.intervalSeconds, input.activeWakeIntervalSeconds ?? null, input.scanIntervalSeconds ?? null, input.registeredBySession, registeredAt, registeredByGeneration);
+        }
+        else {
+            this.db
+                .prepare(`INSERT INTO watchdog_jobs (
+            job_id, policy, spec_yaml, target_session,
+            interval_seconds, active_wake_interval_seconds, scan_interval_seconds,
+            last_evaluation_at, last_fire_at, state,
+            registered_by_session, registered_at, terminal_reason
+          ) VALUES (?, ?, ?, ?, ?, ?, ?, NULL, NULL, 'active', ?, ?, NULL)`)
+                .run(jobId, input.policy, input.specYaml, input.targetSession, input.intervalSeconds, input.activeWakeIntervalSeconds ?? null, input.scanIntervalSeconds ?? null, input.registeredBySession, registeredAt);
+        }
+        return this.getByIdOrThrow(jobId);
+    }
+    /**
+     * Ensure the daemon-owned, role-bound auto-registration tuple has exactly
+     * one nonterminal row. Stopped is an operator opt-out and is therefore as
+     * durable as active; terminal-only history is replaced. The table has no
+     * uniqueness constraint, so every matching row must be inspected.
+     */
+    ensureAutoRegistration(input, historicalTargetSessions = [input.targetSession]) {
+        const existing = this.findAutoRegistration(input.policy, input.targetSession, input.targetGenerationUuid ?? null, historicalTargetSessions);
+        if (existing) {
+            this.db.prepare(`UPDATE watchdog_jobs
+            SET spec_yaml = ?, target_session = ?, interval_seconds = ?,
+                active_wake_interval_seconds = ?, scan_interval_seconds = ?
+          WHERE job_id = ?`).run(input.specYaml, input.targetSession, input.intervalSeconds, input.activeWakeIntervalSeconds ?? null, input.scanIntervalSeconds ?? null, existing.jobId);
+            return this.getByIdOrThrow(existing.jobId);
+        }
+        return this.register(input);
+    }
+    /**
+     * Resolve the one active/stopped role-bound row across every historical
+     * session alias for a node. Persisted states are intentionally closed:
+     * unknown values are neither runnable jobs nor operator opt-outs.
+     */
+    findAutoRegistration(policy, targetSession, targetGenerationUuid, historicalTargetSessions = [targetSession]) {
+        const rows = this.listAliasTuples(policy, historicalTargetSessions, targetGenerationUuid);
+        const invalid = rows.filter((row) => row.state !== "active" && row.state !== "stopped" && row.state !== "terminal");
+        if (invalid.length > 0) {
+            throw new WatchdogJobsError("auto_registration_state_invalid", `auto_registration_state_invalid: auto-registration has invalid persisted state for ${policy}/${targetSession}`, {
+                policy,
+                targetSession,
+                targetGenerationUuid,
+                rows: invalid.map((row) => ({ jobId: row.jobId, state: row.state })),
+            });
+        }
+        const nonterminal = rows.filter((row) => row.state === "active" || row.state === "stopped");
+        if (nonterminal.length > 1) {
+            throw new WatchdogJobsError("auto_registration_ambiguous", `auto-registration is ambiguous for ${policy}/${targetSession}: ${nonterminal.length} nonterminal rows`, {
+                policy,
+                targetSession,
+                targetGenerationUuid,
+                rows: nonterminal.map((row) => ({ jobId: row.jobId, state: row.state })),
+            });
+        }
+        return nonterminal[0] ?? null;
+    }
+    /** All rows for the exact policy/seat/generation tuple, including history. */
+    listExactTuple(policy, targetSession, targetGenerationUuid) {
+        const targetClause = this.hasTargetGenColumn
+            ? "target_generation_uuid IS ?"
+            : targetGenerationUuid === null
+                ? "1 = 1"
+                : "0 = 1";
+        const params = this.hasTargetGenColumn
+            ? [policy, targetSession, targetGenerationUuid]
+            : [policy, targetSession];
+        const rows = this.db.prepare(`SELECT * FROM watchdog_jobs
+       WHERE policy = ? AND target_session = ? AND ${targetClause}
+       ORDER BY registered_at ASC, job_id ASC`).all(...params);
+        return rows.map(rowToJob);
+    }
+    listAliasTuples(policy, targetSessions, targetGenerationUuid) {
+        const aliases = [...new Set(targetSessions)];
+        if (aliases.length === 0)
+            return [];
+        const targetClause = this.hasTargetGenColumn
+            ? "target_generation_uuid IS ?"
+            : targetGenerationUuid === null
+                ? "1 = 1"
+                : "0 = 1";
+        const placeholders = aliases.map(() => "?").join(", ");
+        const params = this.hasTargetGenColumn
+            ? [policy, ...aliases, targetGenerationUuid]
+            : [policy, ...aliases];
+        const rows = this.db.prepare(`SELECT * FROM watchdog_jobs
+       WHERE policy = ? AND target_session IN (${placeholders}) AND ${targetClause}
+       ORDER BY registered_at ASC, job_id ASC`).all(...params);
+        return rows.map(rowToJob);
+    }
+    getById(jobId) {
+        const row = this.db
+            .prepare(`SELECT * FROM watchdog_jobs WHERE job_id = ?`)
+            .get(jobId);
+        return row ? rowToJob(row) : null;
+    }
+    getByIdOrThrow(jobId) {
+        const job = this.getById(jobId);
+        if (!job) {
+            throw new WatchdogJobsError("job_not_found", `watchdog job ${jobId} not found`, { jobId });
+        }
+        return job;
+    }
+    listAll() {
+        const rows = this.db
+            .prepare(`SELECT * FROM watchdog_jobs ORDER BY registered_at ASC`)
+            .all();
+        return rows.map(rowToJob);
+    }
+    listActive() {
+        const rows = this.db
+            .prepare(`SELECT * FROM watchdog_jobs WHERE state = 'active' ORDER BY registered_at ASC`)
+            .all();
+        return rows.map(rowToJob);
+    }
+    recordEvaluation(jobId, evaluatedAt, fired) {
+        if (fired) {
+            this.db
+                .prepare(`UPDATE watchdog_jobs SET last_evaluation_at = ?, last_fire_at = ? WHERE job_id = ?`)
+                .run(evaluatedAt, evaluatedAt, jobId);
+        }
+        else {
+            this.db
+                .prepare(`UPDATE watchdog_jobs SET last_evaluation_at = ? WHERE job_id = ?`)
+                .run(evaluatedAt, jobId);
+        }
+    }
+    /**
+     * R1 fix: write the actionable-state machine columns. Mirrors POC
+     * engine's `state.actionable` + `state.last_actionable_at`. Called
+     * by the policy engine after every meaningful evaluation:
+     *   - newActionable=false (skip): clears actionable + last_actionable_at.
+     *   - newActionable=true with no preserveLastActionableAt: stamps
+     *     last_actionable_at to evaluatedAt (newly actionable).
+     *   - newActionable=true with preserveLastActionableAt set: keeps the
+     *     existing first-actionable timestamp (continued actionable window).
+     */
+    setActionable(jobId, newActionable, evaluatedAt, preserveLastActionableAt = null) {
+        if (!newActionable) {
+            this.db
+                .prepare(`UPDATE watchdog_jobs SET actionable = 0, last_actionable_at = NULL WHERE job_id = ?`)
+                .run(jobId);
+            return;
+        }
+        const stamp = preserveLastActionableAt ?? evaluatedAt;
+        this.db
+            .prepare(`UPDATE watchdog_jobs SET actionable = 1, last_actionable_at = ? WHERE job_id = ?`)
+            .run(stamp, jobId);
+    }
+    markTerminal(jobId, reason) {
+        this.db
+            .prepare(`UPDATE watchdog_jobs SET state = 'terminal', terminal_reason = ? WHERE job_id = ?`)
+            .run(reason, jobId);
+    }
+    stop(jobId, reason = "operator_stopped") {
+        const existing = this.getByIdOrThrow(jobId);
+        if (existing.state === "terminal") {
+            throw new WatchdogJobsError("job_terminal", `cannot stop watchdog job ${jobId}: state is terminal`, { jobId, state: existing.state });
+        }
+        if (existing.state === "stopped")
+            return existing;
+        this.db
+            .prepare(`UPDATE watchdog_jobs SET state = 'stopped', terminal_reason = ? WHERE job_id = ?`)
+            .run(reason, jobId);
+        return this.getByIdOrThrow(jobId);
+    }
+    /**
+     * GHOST-STAGE (e/Class-B): at a seat swap, stop every ARMED (state='active') job registered by the
+     * RETIRING generation — a stale wake firing into the successor's context is the specimen; the
+     * successor re-arms its own. Gen-scoped, NEVER name-scoped (the successor shares the seat name, so a
+     * name-scoped stop would kill the successor's own jobs). A NULL/empty generation never matches
+     * (UNKNOWN ≠ retired — note-2). Returns the count stopped. Auditable (terminal_reason), not a hard
+     * delete — the row stays for forensics. Pre-063 dbs no-op.
+     */
+    dropArmedByRegisteringGeneration(generationUuid) {
+        if (!this.hasGenColumn || !generationUuid)
+            return 0;
+        const res = this.db
+            .prepare(`UPDATE watchdog_jobs SET state = 'stopped', terminal_reason = 'registering generation retired (seat handover)'
+         WHERE state = 'active' AND registered_by_generation_uuid = ?`)
+            .run(generationUuid);
+        return res.changes;
+    }
+}
+function rowToJob(row) {
+    return {
+        jobId: row.job_id,
+        policy: row.policy,
+        specYaml: row.spec_yaml,
+        targetSession: row.target_session,
+        intervalSeconds: row.interval_seconds,
+        activeWakeIntervalSeconds: row.active_wake_interval_seconds,
+        scanIntervalSeconds: row.scan_interval_seconds,
+        lastEvaluationAt: row.last_evaluation_at,
+        lastFireAt: row.last_fire_at,
+        actionable: row.actionable !== 0,
+        lastActionableAt: row.last_actionable_at,
+        state: row.state,
+        registeredBySession: row.registered_by_session,
+        registeredAt: row.registered_at,
+        terminalReason: row.terminal_reason,
+        registeredByGeneration: row.registered_by_generation_uuid ?? null,
+        targetGeneration: row.target_generation_uuid ?? null,
+    };
+}
+//# sourceMappingURL=watchdog-jobs-repository.js.map

package/node_modules/@openrig/daemon/dist/domain/watchdog-jobs-repository.js.map

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

package/node_modules/@openrig/daemon/dist/domain/watchdog-policy-engine.d.ts

@@ -0,0 +1,101 @@
+import type { EventBus } from "./event-bus.js";
+import type { Policy, PolicyEvaluation } from "./policies/types.js";
+import { type WatchdogJob, type WatchdogJobsRepository } from "./watchdog-jobs-repository.js";
+import type { WatchdogHistoryEntry, WatchdogHistoryLog } from "./watchdog-history-log.js";
+/**
+ * Watchdog policy engine (PL-004 Phase C R1).
+ *
+ * Owns the per-evaluation state machine that mirrors POC engine
+ * `lib/engine.mjs`:
+ *   1. Resolve policy by name from registry. Unknown policy → terminal.
+ *   2. Parse spec_yaml into top-level `target:` + top-level `message?:` +
+ *      nested `context:` block, then build a PolicyJob with the
+ *      resolved target object (falls back to registered targetSession
+ *      when spec lacks an explicit `target:`).
+ *   3. Dispatch policy.evaluate(policyJob).
+ *   4. Action handling:
+ *      - skip: clear actionable=false; record history + emit event
+ *        ONLY if reason is "loud" (not in QUIET_SKIP_REASONS).
+ *      - send: enforce active-wake throttle. If state.actionable was
+ *        already true AND active_wake_interval_seconds is set AND not
+ *        elapsed since last_fire_at → emit/record `active_wake_not_due`
+ *        (quiet skip per POC). Otherwise call delivery, record history
+ *        with sent outcome, emit evaluation_fired, set actionable=true.
+ *      - terminal: mark job terminal, record history, emit terminal.
+ *
+ * `not_due` polls are filtered upstream by the scheduler and never
+ * reach this engine.
+ */
+export interface DeliveryRequest {
+    targetSession: string;
+    message: string;
+}
+export interface DeliveryOutcome {
+    status: "ok" | "failed";
+    error?: string;
+}
+export type DeliveryFn = (req: DeliveryRequest) => Promise<DeliveryOutcome>;
+export interface PolicyContextParser {
+    /**
+     * Parse the operator-supplied spec_yaml into the structured fields the
+     * engine needs. Returns the top-level `target` (object), top-level
+     * `message` (string), and the `context:` block (Record).
+     */
+    (specYaml: string): {
+        target: {
+            session: string;
+        } | null;
+        message: string | null;
+        context: Record<string, unknown>;
+    };
+}
+interface WatchdogPolicyEngineDeps {
+    jobsRepo: WatchdogJobsRepository;
+    historyLog: WatchdogHistoryLog;
+    eventBus: EventBus;
+    deliver: DeliveryFn;
+    parseSpec?: PolicyContextParser;
+    now?: () => Date;
+    /**
+     * PL-004 Phase D extension point (orch-ratified per slice IMPL):
+     * additional policies to register alongside the Phase C built-in
+     * three. Used to register `workflow-keepalive` (which depends on
+     * the Phase D workflow_instances DB and so must be constructed at
+     * daemon startup with a db handle injected).
+     */
+    additionalPolicies?: Policy[];
+    /**
+     * (i-c) FIRE-TIME target-generation gate. Resolve a target session's LIVE occupant-generation (P12
+     * `occupant_tenures`) so a GENERATION-bound wake (job.targetGeneration set) can be refused when the
+     * target has been handed over to a different generation since the job was armed. Absent → gate off
+     * (jobs fire unchanged). A null return = UNKNOWN → fail-open (deliver): the protective act is
+     * SKIPPING, so an unknown target-generation must never skip a legitimate wake (note-2 inversion).
+     */
+    resolveTargetGeneration?: (sessionName: string) => string | null;
+}
+export interface EvaluationResult {
+    job: WatchdogJob;
+    outcome: PolicyEvaluation | {
+        action: "skip";
+        reason: "active_wake_not_due";
+    };
+    history: WatchdogHistoryEntry | null;
+    delivery: DeliveryOutcome | null;
+    /** True if this evaluation produced a history record + event. */
+    meaningful: boolean;
+}
+export declare class WatchdogPolicyEngine {
+    private readonly jobsRepo;
+    private readonly historyLog;
+    private readonly eventBus;
+    private readonly deliver;
+    private readonly parseSpec;
+    private readonly now;
+    private readonly policies;
+    private readonly resolveTargetGeneration?;
+    constructor(deps: WatchdogPolicyEngineDeps);
+    resolvePolicy(name: string): Policy | undefined;
+    evaluate(job: WatchdogJob): Promise<EvaluationResult>;
+}
+export {};
+//# sourceMappingURL=watchdog-policy-engine.d.ts.map

package/node_modules/@openrig/daemon/dist/domain/watchdog-policy-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchdog-policy-engine.d.ts","sourceRoot":"","sources":["../../src/domain/watchdog-policy-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAa,MAAM,qBAAqB,CAAC;AAI/E,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE1F;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,CAAC,QAAQ,EAAE,MAAM,GAAG;QAClB,MAAM,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;QACnC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;CACH;AAED,UAAU,wBAAwB;IAChC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAClE;AAwCD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,WAAW,CAAC;IACjB,OAAO,EAAE,gBAAgB,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,qBAAqB,CAAA;KAAE,CAAC;IAC9E,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACrC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,iEAAiE;IACjE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAyC;gBAEtE,IAAI,EAAE,wBAAwB;IAe1C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIzC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAgN5D"}