@evelinka-ai/core 0.1.3

package/dist/lib/delivery/push.js

@@ -0,0 +1,97 @@
+import { consolePath } from "../observability/console-link.js";
+import { logger } from "../observability/logger.js";
+import { tenant } from "../../tenant.js";
+import { readPrefs, readSubscriptions, removeSubscription } from "./push-store.js";
+const log = logger.child({ module: "push" });
+export function vapidConfigured() {
+    return !!(process.env.VAPID_PUBLIC_KEY && process.env.VAPID_PRIVATE_KEY);
+}
+export function vapidPublicKey() {
+    return process.env.VAPID_PUBLIC_KEY ?? null;
+}
+let vapidSet = false;
+async function getWebPush() {
+    const mod = await import("web-push");
+    const webpush = mod.default ?? mod;
+    if (!vapidSet && vapidConfigured()) {
+        webpush.setVapidDetails(process.env.VAPID_SUBJECT ?? "mailto:ops@localhost", process.env.VAPID_PUBLIC_KEY, process.env.VAPID_PRIVATE_KEY);
+        vapidSet = true;
+    }
+    return webpush;
+}
+export async function sendPushToAll(payload) {
+    if (!vapidConfigured())
+        return { sent: 0, pruned: 0 };
+    let webpush;
+    try {
+        webpush = await getWebPush();
+    }
+    catch (err) {
+        log.error({ err }, "web-push unavailable");
+        return { sent: 0, pruned: 0 };
+    }
+    const subs = readSubscriptions();
+    let sent = 0;
+    let pruned = 0;
+    await Promise.all(subs.map(async (sub) => {
+        try {
+            await webpush.sendNotification(sub, JSON.stringify(payload));
+            sent++;
+        }
+        catch (err) {
+            const status = err.statusCode;
+            if (status === 404 || status === 410) {
+                removeSubscription(sub.endpoint);
+                pruned++;
+            }
+            else {
+                log.warn({ status, endpoint: sub.endpoint.slice(0, 48) }, "push send failed");
+            }
+        }
+    }));
+    return { sent, pruned };
+}
+const notified = new Set();
+export async function notify(kind, sessionId) {
+    try {
+        if (!vapidConfigured())
+            return;
+        const key = `${sessionId}:${kind}`;
+        if (notified.has(key))
+            return;
+        const prefs = readPrefs();
+        if (kind === "approval" && !prefs.approvalWaiting)
+            return;
+        if (kind === "failed" && !prefs.runFailed)
+            return;
+        if (kind === "done" && !prefs.runDone)
+            return;
+        notified.add(key);
+        const product = tenant().displayName ?? tenant().name;
+        const payload = kind === "approval"
+            ? {
+                title: "Approval needed",
+                body: `${product} is waiting for your approval — tap to review.`,
+                url: consolePath("/approvals"),
+                tag: "eve-approval",
+            }
+            : kind === "failed"
+                ? {
+                    title: "Run failed",
+                    body: `A ${product} run failed — tap to view.`,
+                    url: consolePath(`/runs/${sessionId}`),
+                    tag: `eve-fail-${sessionId}`,
+                }
+                : {
+                    title: "Run complete",
+                    body: `A ${product} run finished.`,
+                    url: consolePath(`/runs/${sessionId}`),
+                    tag: `eve-done-${sessionId}`,
+                };
+        await sendPushToAll(payload);
+    }
+    catch (err) {
+        log.warn({ err, kind, sessionId }, "push notify failed");
+    }
+}
+//# sourceMappingURL=push.js.map

package/dist/lib/delivery/push.js.map

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

package/dist/lib/delivery/schedule-lock.d.ts

@@ -0,0 +1,16 @@
+import type { ScheduleRunHandler } from "eve/schedules";
+export interface LockClient {
+    query(sql: string, values?: unknown[]): Promise<{
+        rows: Array<Record<string, unknown>>;
+    }>;
+    release(destroy?: boolean): void;
+}
+export interface LockPool {
+    connect(): Promise<LockClient>;
+}
+export declare function schedulePoolConfig(): {
+    max: number;
+    connectionTimeoutMillis: number;
+};
+export declare function exclusiveSchedule(name: string, run: ScheduleRunHandler, injectedPool?: LockPool): ScheduleRunHandler;
+//# sourceMappingURL=schedule-lock.d.ts.map

package/dist/lib/delivery/schedule-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-lock.d.ts","sourceRoot":"","sources":["../../../src/lib/delivery/schedule-lock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuB,kBAAkB,EAAE,MAAM,eAAe,CAAC;AA0B7E,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,CAAC,CAAC;IAE1F,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAClC;AAGD,MAAM,WAAW,QAAQ;IACvB,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CAChC;AA0BD,wBAAgB,kBAAkB,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,uBAAuB,EAAE,MAAM,CAAA;CAAE,CAErF;AA8BD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,kBAAkB,EACvB,YAAY,CAAC,EAAE,QAAQ,GACtB,kBAAkB,CA4EpB"}

package/dist/lib/delivery/schedule-lock.js

@@ -0,0 +1,86 @@
+import { Pool } from "pg";
+import { logger } from "../observability/logger.js";
+const log = logger.child({ module: "schedule-lock" });
+let pool;
+const registered = new Set();
+const CONNECT_TIMEOUT_MS = 5_000;
+export function schedulePoolConfig() {
+    return { max: registered.size + 2, connectionTimeoutMillis: CONNECT_TIMEOUT_MS };
+}
+function getPool() {
+    const url = process.env.WORKFLOW_POSTGRES_URL;
+    if (!url)
+        return undefined;
+    if (!pool)
+        pool = new Pool({ connectionString: url, ...schedulePoolConfig() });
+    return pool;
+}
+function acquired(rows) {
+    const v = rows[0]?.ok;
+    return v === true || v === "t";
+}
+export function exclusiveSchedule(name, run, injectedPool) {
+    const key = `eve-schedule:${name}`;
+    registered.add(name);
+    return async (args) => {
+        const p = injectedPool ?? getPool();
+        if (!p) {
+            log.debug({ schedule: name }, "WORKFLOW_POSTGRES_URL unset — running tick unguarded");
+            await run(args);
+            return;
+        }
+        let client;
+        try {
+            client = await p.connect();
+        }
+        catch (err) {
+            log.error({ err, schedule: name }, "advisory-lock connect failed — running tick unguarded");
+            await run(args);
+            return;
+        }
+        let locked = false;
+        try {
+            const res = await client.query("SELECT pg_try_advisory_lock(hashtext($1)::bigint) AS ok", [
+                key,
+            ]);
+            locked = acquired(res.rows);
+        }
+        catch (err) {
+            client.release();
+            log.error({ err, schedule: name }, "advisory-lock query failed — running tick unguarded");
+            await run(args);
+            return;
+        }
+        if (!locked) {
+            client.release();
+            log.debug({ schedule: name }, "tick skipped — another replica holds the schedule lock");
+            return;
+        }
+        const tracked = [];
+        const ctx = {
+            ...args,
+            waitUntil: (task) => {
+                tracked.push(task);
+                args.waitUntil(task);
+            },
+        };
+        try {
+            await run(ctx);
+        }
+        finally {
+            while (tracked.length > 0) {
+                await Promise.allSettled(tracked.splice(0, tracked.length));
+            }
+            let unlocked = false;
+            try {
+                await client.query("SELECT pg_advisory_unlock(hashtext($1)::bigint) AS ok", [key]);
+                unlocked = true;
+            }
+            catch (err) {
+                log.error({ err, schedule: name }, "advisory unlock failed — destroying the connection");
+            }
+            client.release(unlocked ? undefined : true);
+        }
+    };
+}
+//# sourceMappingURL=schedule-lock.js.map

package/dist/lib/delivery/schedule-lock.js.map

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

package/dist/lib/memory/memory-dream.d.ts

@@ -0,0 +1,181 @@
+import { z } from "zod";
+export type RuleLayer = "domain" | "profile";
+export type RuleProvenance = "operator" | "dreamed" | "migrated";
+export interface MemoryEvent {
+    id: string;
+    scope: string;
+    kind: string;
+    summary: string;
+    payload: Record<string, unknown>;
+    sourceSession: string | null;
+    createdAt: string;
+}
+export interface MemoryRule {
+    id: string;
+    scope: string;
+    layer: RuleLayer;
+    rule: string;
+    why: string | null;
+    confidence: number;
+    support: number;
+    provenance: RuleProvenance;
+    pinned: boolean;
+    sources: string[];
+    createdAt: string;
+    lastReinforcedAt: string;
+    invalidatedAt: string | null;
+    invalidatedBy: string | null;
+    meta: Record<string, string>;
+}
+export interface RuleInsert {
+    id?: string;
+    scope: string;
+    layer?: RuleLayer;
+    rule: string;
+    why?: string | null;
+    confidence: number;
+    support?: number;
+    provenance: RuleProvenance;
+    pinned?: boolean;
+    sources?: string[];
+    createdAt?: string;
+    meta?: Record<string, string>;
+}
+export type PlannedChange = {
+    type: "insert";
+    row: RuleInsert & {
+        id: string;
+    };
+} | {
+    type: "reinforce";
+    id: string;
+    confidence: number;
+    addSources: string[];
+} | {
+    type: "invalidate";
+    id: string;
+    byId: string | null;
+};
+export interface DreamRunOp {
+    scope: string;
+    op: string;
+    detail: string;
+}
+export interface DreamLogger {
+    warn(fields: Record<string, unknown>, message: string): void;
+    error(fields: Record<string, unknown>, message: string): void;
+    info(fields: Record<string, unknown>, message: string): void;
+}
+export interface MemoryDreamAdapter {
+    logger: DreamLogger;
+    ingesters: ReadonlyArray<{
+        name: string;
+        run: () => Promise<number>;
+    }>;
+    listMemoryRules(opts?: {
+        scope?: string;
+        includeInvalidated?: boolean;
+    }): Promise<MemoryRule[]>;
+    applyPlannedChanges(changes: PlannedChange[]): Promise<number | null>;
+    markEventsProcessed(ids: string[]): Promise<void>;
+    decayStaleRules(opts?: {
+        reviewFloor?: number;
+    }): Promise<MemoryRule[]>;
+    unprocessedEventsByScope(): Promise<Map<string, MemoryEvent[]>>;
+    pruneMemoryEngineEvents(days?: number): Promise<number>;
+    startDreamRun(kind: "nightly" | "weekly" | "manual"): Promise<string | null>;
+    finishDreamRun(id: string | null, result: {
+        summary: string;
+        scopes: string[];
+        ops: DreamRunOp[];
+        counts: Record<string, number>;
+        error?: string | null;
+    }): Promise<void>;
+    rebuildMemoryRenderings(): Promise<void>;
+    writeDreamNote(input: {
+        kind: "nightly" | "weekly" | "manual";
+        summary: string;
+        ops: DreamRunOp[];
+    }): Promise<unknown>;
+}
+export declare const REVIEW_FLOOR = 20;
+declare const OpSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    op: z.ZodLiteral<"add">;
+    rule: z.ZodString;
+    why: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodNumber;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"strengthen">;
+    ruleId: z.ZodString;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"generalize">;
+    ruleIds: z.ZodArray<z.ZodString>;
+    rule: z.ZodString;
+    why: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodNumber;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"invalidate">;
+    ruleId: z.ZodString;
+    reason: z.ZodString;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>], "op">;
+export declare const DreamOpsSchema: z.ZodObject<{
+    ops: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        op: z.ZodLiteral<"add">;
+        rule: z.ZodString;
+        why: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodNumber;
+        sources: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"strengthen">;
+        ruleId: z.ZodString;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        sources: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"generalize">;
+        ruleIds: z.ZodArray<z.ZodString>;
+        rule: z.ZodString;
+        why: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodNumber;
+        sources: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"invalidate">;
+        ruleId: z.ZodString;
+        reason: z.ZodString;
+        sources: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>], "op">>>;
+}, z.core.$strip>;
+export type DreamOp = z.infer<typeof OpSchema>;
+export type DreamOps = z.infer<typeof DreamOpsSchema>;
+export interface DreamDeps {
+    generate(prompt: string): Promise<DreamOps>;
+}
+export declare function extractJsonObject(text: string): unknown;
+export declare const OPS_FORMAT = "\nReturn ONLY a JSON object of the shape {\"ops\": [...]} \u2014 no prose, no code fences.\nEach op is one of:\n  {\"op\":\"add\",\"rule\":\"\u2026\",\"why\":\"\u2026?\",\"confidence\":0-100,\"sources\":[\"<event id>\",\u2026]}\n  {\"op\":\"strengthen\",\"ruleId\":\"<rule id>\",\"confidence\":0-100?,\"sources\":[\u2026]}\n  {\"op\":\"generalize\",\"ruleIds\":[\"<rule id>\",\"<rule id>\",\u2026],\"rule\":\"\u2026\",\"why\":\"\u2026?\",\"confidence\":0-100,\"sources\":[\u2026]}\n  {\"op\":\"invalidate\",\"ruleId\":\"<rule id>\",\"reason\":\"\u2026\",\"sources\":[\u2026]}\n{\"ops\":[]} is a perfectly good answer.";
+export interface PlanResult {
+    changes: PlannedChange[];
+    rejected: {
+        op: string;
+        reason: string;
+    }[];
+}
+export declare function planOps(scope: string, layer: RuleLayer, current: MemoryRule[], allowedSources: Set<string>, ops: DreamOp[], makeId?: () => string): PlanResult;
+export declare function buildScopePrompt(scope: string, rules: MemoryRule[], events: MemoryEvent[], stale: MemoryRule[]): string;
+export declare function buildProfilePrompt(scope: string, profileRules: MemoryRule[], evidence: MemoryRule[]): string;
+export interface DreamResult {
+    runId: string | null;
+    scopes: string[];
+    counts: Record<string, number>;
+    summary: string;
+    error: string | null;
+}
+export declare function createMemoryDreamEngine(adapter: MemoryDreamAdapter, defaultDeps: DreamDeps): {
+    consolidateScope: (scope: string, events: MemoryEvent[], stale: MemoryRule[], deps: DreamDeps) => Promise<PlanResult>;
+    runDream: (kind: "nightly" | "weekly" | "manual", deps?: DreamDeps) => Promise<DreamResult>;
+};
+export {};
+//# sourceMappingURL=memory-dream.d.ts.map

package/dist/lib/memory/memory-dream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-dream.d.ts","sourceRoot":"","sources":["../../../src/lib/memory/memory-dream.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC7C,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,cAAc,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,cAAc,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,UAAU,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7D,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC;IACvE,eAAe,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAChG,mBAAmB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtE,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,eAAe,CAAC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACxE,wBAAwB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAChE,uBAAuB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7E,cAAc,CACZ,EAAE,EAAE,MAAM,GAAG,IAAI,EACjB,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,GAAG,EAAE,UAAU,EAAE,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,GACA,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,cAAc,CAAC,KAAK,EAAE;QACpB,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACtC,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,UAAU,EAAE,CAAC;KACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AASD,eAAO,MAAM,YAAY,KAAK,CAAC;AAI/B,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;yBA4BZ,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;iBAAmD,CAAC;AAC/E,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC/C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7C;AAUD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAwBvD;AAED,eAAO,MAAM,UAAU,8mBAOgB,CAAC;AAOxC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5C;AAMD,wBAAgB,OAAO,CACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,UAAU,EAAE,EACrB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,EAC3B,GAAG,EAAE,OAAO,EAAE,EACd,MAAM,GAAE,MAAM,MAAmB,GAChC,UAAU,CAkHZ;AASD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EAAE,EACnB,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,UAAU,EAAE,GAClB,MAAM,CA0BR;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,UAAU,EAAE,EAC1B,QAAQ,EAAE,UAAU,EAAE,GACrB,MAAM,CAuBR;AAID,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,SAAS;8BAmBhF,MAAM,UACL,WAAW,EAAE,SACd,UAAU,EAAE,QACb,SAAS,KACd,OAAO,CAAC,UAAU,CAAC;qBAqBd,SAAS,GAAG,QAAQ,GAAG,QAAQ,SAC/B,SAAS,KACd,OAAO,CAAC,WAAW,CAAC;EA6IxB"}