@spinabot/brigade 0.1.2 → 1.0.1

package/dist/storage/convex/message-store.js

@@ -0,0 +1,272 @@
+import { api } from "../../../convex/_generated/api.js";
+import { open as openSealed, sealJson } from "../encryption.js";
+import { BRIGADE_BOOTSTRAP_DELIVERED_CUSTOM_TYPE } from "../../sessions/bootstrap-marker.js";
+function jsonToBytes(value) {
+    return sealJson(value);
+}
+function bytesToJson(b) {
+    if (!b)
+        return undefined;
+    try {
+        return JSON.parse(openSealed(b).toString("utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Concatenate sealed-byte slices of a chunked transcript record back into
+ *  the whole sealed blob (slicing then re-joining AES-GCM ciphertext is
+ *  lossless — the envelope is over the full payload). */
+function concatArrayBuffers(parts) {
+    if (parts.length === 1)
+        return parts[0];
+    let total = 0;
+    for (const p of parts)
+        total += p.byteLength;
+    const joined = new Uint8Array(total);
+    let offset = 0;
+    for (const p of parts) {
+        joined.set(new Uint8Array(p), offset);
+        offset += p.byteLength;
+    }
+    return joined.buffer;
+}
+export class ConvexMessageStore {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async appendRecord(agentId, sessionId, record) {
+        const customType = record.customType;
+        await this.deps.client.mutation(api.messages.appendRecord, {
+            agentId,
+            sessionId,
+            type: record.type,
+            ...(typeof customType === "string" ? { customType } : {}),
+            payload: jsonToBytes(record),
+        });
+    }
+    async appendRecordsBatch(agentId, sessionId, records) {
+        if (records.length === 0)
+            return;
+        // Slice into byte- AND count-bounded sub-batches: one mutation can't
+        // carry an unbounded arg array (arg-size limit) or write unbounded rows
+        // (~8k-write cap; a single record may chunk into many rows). Each sub-
+        // batch is its own appendRecordsBatch call; the server derives seq from
+        // the live tail, so sequential sub-batches chain identically to one call.
+        const MAX_COUNT = 256;
+        const MAX_BYTES = 6 * 1024 * 1024;
+        let batch = [];
+        let bytes = 0;
+        const flush = async () => {
+            if (batch.length === 0)
+                return;
+            await this.deps.client.mutation(api.messages.appendRecordsBatch, {
+                agentId,
+                sessionId,
+                records: batch,
+            });
+            batch = [];
+            bytes = 0;
+        };
+        for (const record of records) {
+            const customType = record.customType;
+            const payload = jsonToBytes(record);
+            if (batch.length > 0 &&
+                (batch.length >= MAX_COUNT || bytes + payload.byteLength > MAX_BYTES)) {
+                await flush();
+            }
+            batch.push({
+                type: record.type,
+                ...(typeof customType === "string" ? { customType } : {}),
+                payload,
+            });
+            bytes += payload.byteLength;
+        }
+        await flush();
+    }
+    async replaceTranscript(agentId, sessionId, records) {
+        // Wholesale replace at ANY size, lossless: clear the session in bounded
+        // delete-pages, then append the new records in byte-bounded batches. The
+        // old single `replaceTranscript` mutation read + deleted + inserted the
+        // WHOLE transcript in one execution — it blew the 16 MiB read, the
+        // 8k-delete, the 8k-write AND the mutation arg-size caps on a long
+        // transcript. NOTE: no longer a single atomic transaction (unbounded
+        // delete+insert can't be one Convex mutation) — it deletes then appends;
+        // an interruption leaves the session empty and a re-run recovers (migrate
+        // is idempotent; Pi's _rewriteFile is always followed by a full rewrite).
+        await this.deleteTranscript(agentId, sessionId);
+        await this.appendRecordsBatch(agentId, sessionId, records);
+    }
+    async readTranscript(agentId, sessionId, opts) {
+        // Page by seq cursor until we've satisfied `want` or the transcript is
+        // exhausted. A single `take(limit)` truncates a session longer than the
+        // per-query read cap; migrate asks for "all" (a huge limit) and MUST get
+        // every record so the copy is faithful.
+        //
+        // Chunk reassembly: an oversized record was split across `chunkCount`
+        // consecutive rows on write (see convex/messages.ts). They arrive in
+        // seq order (= chunkIndex order) and contiguously (one atomic batch),
+        // so we collect `chunkCount` consecutive chunk rows, concatenate their
+        // sealed-byte slices into the whole blob, then decrypt once.
+        const want = opts?.limit && opts.limit > 0 ? opts.limit : 1000;
+        const PAGE = 4000;
+        const out = [];
+        let afterSeq;
+        // A chunk group that may straddle a page boundary.
+        let pending;
+        while (out.length < want) {
+            const rows = (await this.deps.client.query(api.messages.readTranscript, {
+                agentId,
+                sessionId,
+                limit: PAGE,
+                ...(afterSeq !== undefined ? { afterSeq } : {}),
+            }));
+            if (rows.length === 0)
+                break;
+            for (const row of rows) {
+                afterSeq = row.seq;
+                const cc = typeof row.chunkCount === "number" && row.chunkCount > 1 ? row.chunkCount : 1;
+                if (cc <= 1) {
+                    // Normal single-row record. (Defensive: a stray pending here
+                    // would mean a torn group — impossible with atomic writes —
+                    // so drop it rather than corrupt the stream.)
+                    pending = undefined;
+                    const parsed = bytesToJson(row.payload);
+                    if (parsed)
+                        out.push(parsed);
+                    continue;
+                }
+                // Chunk row — collect by arrival order (== chunkIndex order).
+                if (!pending || pending.count !== cc)
+                    pending = { count: cc, parts: [] };
+                pending.parts.push(row.payload);
+                if (pending.parts.length >= pending.count) {
+                    const parsed = bytesToJson(concatArrayBuffers(pending.parts));
+                    if (parsed)
+                        out.push(parsed);
+                    pending = undefined;
+                }
+            }
+            // Do NOT stop on a short page: the server caps each page by BYTES
+            // (~8 MiB) as well as count, so a page can be short mid-transcript.
+            // End-of-data is signalled ONLY by an empty page (handled above) —
+            // keep paging via afterSeq until then (bounded by `want`).
+        }
+        return out;
+    }
+    async hasBootstrapDelivered(agentId, sessionId) {
+        // Mirror the disk walk (hasDeliveredBootstrapToSession): scan
+        // newest-first and honour compaction-invalidation — a `compaction`
+        // record newer than the marker means the bootstrap context was likely
+        // compacted out, so the next turn must re-deliver. Walking the
+        // newest-first tail, the FIRST marker-or-compaction encountered decides:
+        // marker → delivered (still valid); compaction → invalidated.
+        const rows = (await this.deps.client.query(api.messages.readMarkerTail, {
+            agentId,
+            sessionId,
+        }));
+        for (const r of rows) {
+            if (r.type === "compaction")
+                return false;
+            if (r.type === "custom" && r.customType === BRIGADE_BOOTSTRAP_DELIVERED_CUSTOM_TYPE) {
+                return true;
+            }
+        }
+        return false;
+    }
+    async markBootstrapDelivered(agentId, sessionId) {
+        await this.appendRecord(agentId, sessionId, {
+            type: "custom",
+            customType: BRIGADE_BOOTSTRAP_DELIVERED_CUSTOM_TYPE,
+            data: { timestamp: new Date().toISOString() },
+        });
+    }
+    async deleteTranscript(agentId, sessionId) {
+        // Server deletes one bounded page per call (byte + count capped) and
+        // returns how many it removed; loop until nothing remains. A single
+        // delete-all would exceed the 16 MiB read + 8k-delete caps on a long
+        // session. Lossless — every row is removed across the loop.
+        for (;;) {
+            const deleted = (await this.deps.client.mutation(api.messages.deleteTranscript, {
+                agentId,
+                sessionId,
+            }));
+            if (deleted <= 0)
+                break;
+        }
+    }
+    async repairIfNeeded(_agentId, _sessionId) {
+        // Convex rows can't be torn mid-write — the storage layer guarantees
+        // atomicity per mutation. Repair is a no-op in convex mode.
+        return { repaired: false, reason: "convex transactional storage; no torn writes" };
+    }
+    async withWriteLock(_agentId, _sessionId, fn, _opts) {
+        // Convex mutations on the same row keys are linearised by the backend.
+        // Convex mode achieves the same property without an in-process lock.
+        return fn();
+    }
+    subscribe(_sessionId, _cb) {
+        // Convex live-query subscription is a follow-up.
+        return () => undefined;
+    }
+    async inboxEnqueue(sessionKey, event) {
+        const e = event;
+        const text = typeof e.text === "string" ? e.text : "";
+        if (!text)
+            return false;
+        const ts = e.ts;
+        await this.deps.client.mutation(api.messages.inboxEnqueue, {
+            sessionKey,
+            text: jsonToBytes(text),
+            ...(typeof ts === "number" ? { ts } : {}),
+            ...(e.contextKey !== undefined && e.contextKey !== null ? { contextKey: e.contextKey } : {}),
+            ...(e.deliveryContext !== undefined ? { deliveryContext: e.deliveryContext } : {}),
+            trusted: e.trusted !== false,
+        });
+        return true;
+    }
+    async inboxDrain(sessionKey) {
+        const rows = (await this.deps.client.mutation(api.messages.inboxDrain, {
+            sessionKey,
+        }));
+        return rows.map((r) => ({
+            text: bytesToJson(r.text) ?? "",
+            ts: r.ts,
+            ...(r.contextKey !== undefined ? { contextKey: r.contextKey } : {}),
+            ...(r.deliveryContext !== undefined ? { deliveryContext: r.deliveryContext } : {}),
+            trusted: r.trusted,
+        }));
+    }
+    async inboxConsumePrefix(sessionKey, prefix) {
+        const rows = (await this.deps.client.mutation(api.messages.inboxConsumePrefix, {
+            sessionKey,
+            prefixLength: prefix.length,
+        }));
+        return rows.map((r) => ({
+            text: bytesToJson(r.text) ?? "",
+            ts: r.ts,
+            ...(r.contextKey !== undefined ? { contextKey: r.contextKey } : {}),
+            ...(r.deliveryContext !== undefined ? { deliveryContext: r.deliveryContext } : {}),
+            ...(r.trusted !== undefined ? { trusted: r.trusted } : {}),
+        }));
+    }
+    async inboxPeek(sessionKey) {
+        const rows = (await this.deps.client.query(api.messages.inboxPeek, {
+            sessionKey,
+        }));
+        return rows.map((r) => ({
+            text: bytesToJson(r.text) ?? "",
+            ts: r.ts,
+            ...(r.contextKey !== undefined ? { contextKey: r.contextKey } : {}),
+            ...(r.deliveryContext !== undefined ? { deliveryContext: r.deliveryContext } : {}),
+            ...(r.trusted !== undefined ? { trusted: r.trusted } : {}),
+        }));
+    }
+    async inboxHasEvents(sessionKey) {
+        return (await this.deps.client.query(api.messages.inboxHasEvents, {
+            sessionKey,
+        }));
+    }
+}
+//# sourceMappingURL=message-store.js.map

package/dist/storage/convex/message-store.js.map

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

package/dist/storage/convex/org-store.d.ts

@@ -0,0 +1,46 @@
+import type { ConvexHttpClient } from "convex/browser";
+import type { OrgDeriveAuditEntry, OrgStore } from "../store.js";
+interface Deps {
+    client: ConvexHttpClient;
+    ownerId: string;
+}
+export declare class ConvexOrgStore implements OrgStore {
+    private readonly deps;
+    private readonly transientLocators;
+    constructor(deps: Deps);
+    appendDeriveAudit(entry: OrgDeriveAuditEntry): Promise<void>;
+    listDeriveAudit(filter?: {
+        since?: string;
+        limit?: number;
+    }): Promise<OrgDeriveAuditEntry[]>;
+    getChartImage(hash: string): Promise<{
+        bytes: Uint8Array;
+        width: number;
+        height: number;
+        mimeType: "image/png";
+        mtimeMs: number;
+    } | undefined>;
+    putChartImage(hash: string, bytes: Uint8Array, meta: {
+        width: number;
+        height: number;
+        themeId: string;
+        themeName: string;
+        mimeType: "image/png";
+    }): Promise<{
+        locator: string;
+    }>;
+    deleteChartImage(hash: string): Promise<void>;
+    listChartImages(): Promise<Array<{
+        hash: string;
+        mtimeMs: number;
+        bytes: number;
+    }>>;
+    markChartTransient(locator: string): void;
+    consumeChartTransient(locator: string): boolean;
+    gcChartImages(opts?: {
+        maxAgeMs?: number;
+        maxFiles?: number;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=org-store.d.ts.map

package/dist/storage/convex/org-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-store.d.ts","sourceRoot":"","sources":["../../../src/storage/convex/org-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjE,UAAU,IAAI;IAAG,MAAM,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAE5D,qBAAa,cAAe,YAAW,QAAQ;IAGlC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqB;gBAE1B,IAAI,EAAE,IAAI;IAEjC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5D,eAAe,CAAC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAU5F,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CACvC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAC5F,SAAS,CACX;IAiBK,aAAa,CAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,WAAW,CAAA;KAAE,GAChG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAazB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C,eAAe,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAWzF,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIzC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIzC,aAAa,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBnF"}

package/dist/storage/convex/org-store.js

@@ -0,0 +1,101 @@
+import { api } from "../../../convex/_generated/api.js";
+export class ConvexOrgStore {
+    deps;
+    transientLocators = new Set();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async appendDeriveAudit(entry) {
+        const e = entry;
+        await this.deps.client.mutation(api.org.appendDeriveAudit, {
+            ownerId: this.deps.ownerId,
+            ts: e.ts ?? new Date().toISOString(),
+            topOrder: e.topOrder ?? "main",
+            mode: (e.mode ?? "derived"),
+            edgeCount: e.edgeCount ?? 0,
+            memberCount: e.memberCount ?? 0,
+            extraAllowCount: e.extraAllowCount ?? 0,
+            extraDenyCount: e.extraDenyCount ?? 0,
+            warnings: e.warnings ?? 0,
+        });
+    }
+    async listDeriveAudit(filter) {
+        const rows = (await this.deps.client.query(api.org.listDeriveAudit, {
+            ownerId: this.deps.ownerId,
+            ...(filter?.limit !== undefined ? { limit: filter.limit } : {}),
+        }));
+        const since = filter?.since;
+        const filtered = since ? rows.filter((r) => r.ts >= since) : rows;
+        return filtered;
+    }
+    async getChartImage(hash) {
+        const row = (await this.deps.client.query(api.org.getChart, {
+            ownerId: this.deps.ownerId,
+            hash,
+        }));
+        if (!row)
+            return undefined;
+        return {
+            bytes: new Uint8Array(row.pngBytes),
+            width: row.width,
+            height: row.height,
+            mimeType: "image/png",
+            mtimeMs: row.mtimeMs,
+        };
+    }
+    async putChartImage(hash, bytes, meta) {
+        await this.deps.client.mutation(api.org.putChart, {
+            ownerId: this.deps.ownerId,
+            hash,
+            pngBytes: bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength),
+            width: meta.width,
+            height: meta.height,
+            themeId: meta.themeId,
+            themeName: meta.themeName,
+        });
+        return { locator: `convex://org-chart/${hash}` };
+    }
+    async deleteChartImage(hash) {
+        await this.deps.client.mutation(api.org.deleteChart, {
+            ownerId: this.deps.ownerId,
+            hash,
+        });
+    }
+    async listChartImages() {
+        const rows = (await this.deps.client.query(api.org.listCharts, {
+            ownerId: this.deps.ownerId,
+        }));
+        return rows.map((r) => ({
+            hash: r.hash,
+            mtimeMs: r.mtimeMs,
+            bytes: r.pngBytes.byteLength ?? 0,
+        }));
+    }
+    markChartTransient(locator) {
+        this.transientLocators.add(locator);
+    }
+    consumeChartTransient(locator) {
+        return this.transientLocators.delete(locator);
+    }
+    async gcChartImages(opts) {
+        const all = await this.listChartImages();
+        const now = Date.now();
+        const targets = [];
+        if (opts?.maxAgeMs !== undefined) {
+            for (const c of all) {
+                if (now - c.mtimeMs > opts.maxAgeMs)
+                    targets.push(c.hash);
+            }
+        }
+        if (opts?.maxFiles !== undefined && all.length > opts.maxFiles) {
+            const sorted = [...all].sort((a, b) => a.mtimeMs - b.mtimeMs);
+            const overflow = sorted.slice(0, sorted.length - opts.maxFiles);
+            for (const c of overflow)
+                targets.push(c.hash);
+        }
+        for (const hash of new Set(targets)) {
+            await this.deleteChartImage(hash);
+        }
+    }
+}
+//# sourceMappingURL=org-store.js.map

package/dist/storage/convex/org-store.js.map

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

package/dist/storage/convex/session-store.d.ts

@@ -0,0 +1,44 @@
+import type { ConvexHttpClient } from "convex/browser";
+import type { ResolvedSession, SessionEntry, SessionStore, SubagentSessionMetadata, Unsub } from "../store.js";
+interface Deps {
+    client: ConvexHttpClient;
+}
+/** Filesystem-shaped entry (or partial patch) → upsertEntry mutation args. */
+declare function entryToMutationArgs(patch: Partial<SessionEntry>): Record<string, unknown>;
+/** Convex row → filesystem-shaped SessionEntry. */
+declare function rowToEntry(row: Record<string, unknown>): SessionEntry;
+export declare class ConvexSessionStore implements SessionStore {
+    private readonly deps;
+    constructor(deps: Deps);
+    resolveOrCreate(args: {
+        agentId: string;
+        sessionKey: string;
+        overrides?: Partial<SessionEntry>;
+        freshnessMs?: number;
+    }): Promise<ResolvedSession>;
+    getEntry(agentId: string, sessionKey: string): Promise<SessionEntry | undefined>;
+    upsertEntry(agentId: string, sessionKey: string, patch: Partial<SessionEntry>): Promise<SessionEntry>;
+    updateEntry(agentId: string, sessionKey: string, patch: Partial<SessionEntry>): Promise<SessionEntry | null>;
+    deleteEntry(agentId: string, sessionKey: string): Promise<boolean>;
+    listEntries(agentId: string, filter?: {
+        isolatedCronRunOlderThanMs?: number;
+        subagentOnly?: boolean;
+    }): Promise<Array<{
+        sessionKey: string;
+        entry: SessionEntry;
+    }>>;
+    readSubagentMetadata(agentId: string, sessionKey: string): Promise<SubagentSessionMetadata | undefined>;
+    listSubagentEntries(agentId: string): Promise<Array<{
+        sessionKey: string;
+        entry: SessionEntry;
+        subagent: SubagentSessionMetadata;
+    }>>;
+    subscribe(agentId: string, cb: (entries: SessionEntry[]) => void): Unsub;
+}
+/** Exported for the session-cache dispatcher + tests. */
+export declare const __sessionMarshalling: {
+    entryToMutationArgs: typeof entryToMutationArgs;
+    rowToEntry: typeof rowToEntry;
+};
+export {};
+//# sourceMappingURL=session-store.d.ts.map

package/dist/storage/convex/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../../src/storage/convex/session-store.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOvD,OAAO,KAAK,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,uBAAuB,EACvB,KAAK,EACL,MAAM,aAAa,CAAC;AAErB,UAAU,IAAI;IAAG,MAAM,EAAE,gBAAgB,CAAA;CAAE;AA+B3C,8EAA8E;AAC9E,iBAAS,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBlF;AAED,mDAAmD;AACnD,iBAAS,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAsB9D;AAED,qBAAa,kBAAmB,YAAW,YAAY;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,IAAI;IAEjC,eAAe,CAAC,IAAI,EAAE;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAClC,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoDtB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAQhF,WAAW,CAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAC1B,OAAO,CAAC,YAAY,CAAC;IAclB,WAAW,CAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAC1B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAMzB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOlE,WAAW,CAChB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;QAAE,0BAA0B,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GACtE,OAAO,CAAC,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;IAqBxD,oBAAoB,CACzB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC;IAMzC,mBAAmB,CACxB,OAAO,EAAE,MAAM,GACb,OAAO,CACT,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,uBAAuB,CAAA;KAAE,CAAC,CACrF;IAeD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,GAAG,KAAK;CAqBxE;AAED,yDAAyD;AACzD,eAAO,MAAM,oBAAoB;;;CAAsC,CAAC"}