@cairn-tool/cairn 2.0.0

package/dist/usage/providers/opencode.js

@@ -0,0 +1,422 @@
+import fs from "node:fs";
+import path from "node:path";
+import { addTokens, emptyBucket, emptyTokens, utcDay } from "../events.js";
+import { loadSqlite } from "../../sqlite.js";
+/**
+ * OpenCode's session store.
+ *
+ * Everything lives in one SQLite database, `opencode.db`, alongside the CLI
+ * logs and per-session diffs:
+ *
+ * ```
+ * session(id, project_id, parent_id, directory, title, version, agent, model,
+ *         cost, tokens_*, time_created, time_updated)
+ * message(id, session_id, time_created, time_updated, data)          -- JSON
+ * part(id, message_id, session_id, time_created, time_updated, data) -- JSON
+ * ```
+ *
+ * **The same usage is recorded three times**: on the assistant `message`, again
+ * on that message's `step-finish` `part`, and rolled up on the `session` row.
+ * Measured against a real store, all three agree exactly and match OpenCode's
+ * own `opencode stats`. Only the **message** grain is read. Summing message
+ * tokens and step-finish tokens double-counts every figure precisely; the
+ * session rollup is a cross-check rather than a source, and `part` rows are read
+ * only for tool calls.
+ *
+ * The message grain is the right one twice over: a message that produced no
+ * step-finish part still carries usage, and `message.id` is a primary key --
+ * the same reason `claude-code.ts` deduplicates on `message.id` rather than on
+ * anything anonymous.
+ *
+ * This is the second provider reading somebody else's live database, so it
+ * follows the antigravity rules: open read-only through the **shared**
+ * `loadSqlite()`, never a second loader, and treat every failure -- a missing
+ * column, a renamed table, a runtime with no `node:sqlite` -- as an empty store
+ * rather than an exception.
+ */
+const DATABASE = "opencode.db";
+/** The synthetic shard every session is filed under; there is only one store. */
+const SHARD = "session";
+function text(value) {
+    return typeof value === "string" && value ? value : null;
+}
+function count(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "bigint")
+        return Number(value);
+    return 0;
+}
+/** An epoch-millisecond column as the ISO string every event carries. */
+function isoAt(value) {
+    const ms = count(value);
+    if (!ms)
+        return null;
+    const at = new Date(ms);
+    return Number.isNaN(at.getTime()) ? null : at.toISOString();
+}
+function parseJson(value) {
+    const raw = text(value);
+    if (!raw)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+function openDatabase(file) {
+    const sqlite = loadSqlite();
+    if (!sqlite)
+        return null;
+    try {
+        // The URI form, because the store has live `-wal`/`-shm` sidecars and this
+        // is somebody else's database: it is never opened for writing.
+        return new sqlite.DatabaseSync(`file:${file}?mode=ro`, { readOnly: true });
+    }
+    catch {
+        return null;
+    }
+}
+function closeQuietly(db) {
+    try {
+        db.close();
+    }
+    catch {
+        // Closing a read-only handle cannot lose anything.
+    }
+}
+function query(db, sql) {
+    try {
+        return db.prepare(sql).all();
+    }
+    catch {
+        // A renamed column, or a table this version of OpenCode does not have,
+        // costs exactly what it names rather than the whole provider.
+        return [];
+    }
+}
+/**
+ * Every session, with a freshness key derived from its own rows.
+ *
+ * The store's file mtime is a single value shared by every session, so using it
+ * would invalidate all of them on any write and force a full re-parse on every
+ * scan. `session.time_updated` alone is not enough either -- it is measurably
+ * stale against the messages beneath it -- so the key is the latest timestamp
+ * anywhere in the session. `size` fingerprints the row counts, because
+ * `isFresh` compares exactly the pair `(size, mtimeMs)` and neither half alone
+ * catches every edit.
+ */
+function readSessions(db) {
+    const updates = new Map();
+    const bump = (id, ms, kind) => {
+        const entry = updates.get(id) ?? { ms: 0, messages: 0, parts: 0 };
+        entry.ms = Math.max(entry.ms, ms);
+        entry[kind] += 1;
+        updates.set(id, entry);
+    };
+    for (const row of query(db, "SELECT session_id, time_updated FROM message"))
+        bump(String(row.session_id), count(row.time_updated), "messages");
+    for (const row of query(db, "SELECT session_id, time_updated FROM part"))
+        bump(String(row.session_id), count(row.time_updated), "parts");
+    const sessions = [];
+    for (const row of query(db, "SELECT * FROM session")) {
+        const id = text(row.id);
+        if (!id)
+            continue;
+        const counts = updates.get(id) ?? { ms: 0, messages: 0, parts: 0 };
+        sessions.push({
+            id,
+            parentId: text(row.parent_id),
+            directory: text(row.directory) ?? "",
+            title: text(row.title) ?? "",
+            version: text(row.version) ?? "",
+            mtimeMs: Math.max(count(row.time_updated), counts.ms),
+            size: counts.messages * 1_000_000 + counts.parts,
+        });
+    }
+    // Byte comparison, never localeCompare: the order must not depend on the ICU
+    // build of the machine that ran the scan.
+    sessions.sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+    return sessions;
+}
+/**
+ * The whole store, parsed once and memoized.
+ *
+ * `scan.ts` calls `parse` through a worker pool, and SQLite declares no index
+ * for these foreign keys, so a per-session `WHERE session_id = ?` would be a
+ * full scan of `message` and `part` for every session. One pass builds every
+ * aggregate instead. The memo holds a single entry, so a `--provider all` run
+ * does not pin two stores in memory.
+ */
+let store = null;
+function storeKey(file) {
+    try {
+        const stats = fs.statSync(file);
+        // The path is part of the key, not just the stat: two stores can share a
+        // size and an mtime, and the memo holds only one entry.
+        return `${file}\u0000${stats.mtimeMs}\u0000${stats.size}`;
+    }
+    catch {
+        return "";
+    }
+}
+function bucketFor(building, timestamp) {
+    if (!timestamp)
+        return null;
+    const day = utcDay(timestamp);
+    if (!day)
+        return null;
+    const aggregate = building.aggregate;
+    if (!aggregate.firstTs || timestamp < aggregate.firstTs)
+        aggregate.firstTs = timestamp;
+    if (!aggregate.lastTs || timestamp > aggregate.lastTs)
+        aggregate.lastTs = timestamp;
+    return (aggregate.days[day] ??= emptyBucket());
+}
+/**
+ * One assistant message's usage.
+ *
+ * Unlike Codex and Gemini CLI, `cache.read` is a field of its own rather than
+ * part of `input`, so nothing is subtracted here. `cost` is dropped: neither
+ * `TokenTotals` nor `FileAggregate` has a place for it, and adding one is a
+ * usage-store migration plus a contract change.
+ */
+function readUsage(tokens) {
+    const cache = (tokens.cache ?? {});
+    return {
+        input: count(tokens.input),
+        output: count(tokens.output),
+        cacheRead: count(cache.read),
+        cacheWrite: count(cache.write),
+        cacheWrite5m: 0,
+        cacheWrite1h: 0,
+        thinking: count(tokens.reasoning),
+        webSearch: 0,
+        webFetch: 0,
+        requests: 1,
+    };
+}
+function applyMessages(db, building) {
+    for (const row of query(db, "SELECT session_id, data FROM message ORDER BY id")) {
+        const target = building.get(String(row.session_id));
+        const data = parseJson(row.data);
+        if (!target || !data)
+            continue;
+        const time = data.time;
+        const ts = isoAt(time?.created);
+        const bucket = bucketFor(target, ts);
+        if (!bucket || !ts)
+            continue;
+        if (data.role === "user") {
+            bucket.prompts += 1;
+            target.events.push({ ts, kind: "prompt" });
+            continue;
+        }
+        if (data.role !== "assistant")
+            continue;
+        // A subagent session names its role on its own messages, which agrees with
+        // the parent's `task` call and needs no cross-session join.
+        const agent = text(data.agent);
+        if (agent && target.aggregate.kind === "subagent" && !target.aggregate.agentType)
+            target.aggregate.agentType = agent;
+        const tokens = data.tokens;
+        if (!tokens)
+            continue;
+        const provider = text(data.providerID);
+        const model = text(data.modelID);
+        // Two-part, because a bare model id collides across providers and the
+        // rollup keys on this string.
+        const name = provider && model ? `${provider}/${model}` : (model ?? "(unknown)");
+        const totals = readUsage(tokens);
+        addTokens((bucket.models[name] ??= emptyTokens()), totals);
+        target.events.push({ ts, kind: "response", model: name, tokens: totals });
+    }
+}
+function applyParts(db, building) {
+    for (const row of query(db, "SELECT session_id, time_created, data FROM part ORDER BY id")) {
+        const target = building.get(String(row.session_id));
+        const data = parseJson(row.data);
+        // `step-finish` carries a copy of the message's usage and is deliberately
+        // not read; see the note at the top of this module.
+        if (!target || !data || data.type !== "tool")
+            continue;
+        const tool = text(data.tool);
+        if (!tool)
+            continue;
+        const ts = isoAt(row.time_created) ?? target.aggregate.firstTs;
+        const bucket = bucketFor(target, ts || null);
+        if (!bucket)
+            continue;
+        bucket.tools[tool] = (bucket.tools[tool] ?? 0) + 1;
+        target.events.push({ ts, kind: "tool_use", tool });
+        const state = (data.state ?? {});
+        if (tool === "task") {
+            const input = (state.input ?? {});
+            const role = text(input.subagent_type) ?? "(unrecorded)";
+            const totals = (bucket.agents[role] ??= { count: 0, maxDepth: 0 });
+            totals.count += 1;
+            target.events.push({ ts, kind: "agent", name: role });
+        }
+        if (text(state.status) === "error") {
+            bucket.errors += 1;
+            target.events.push({ ts, kind: "error" });
+        }
+    }
+}
+function buildStore(file) {
+    const parsed = new Map();
+    const key = storeKey(file);
+    const db = openDatabase(file);
+    if (!db)
+        return { key, parsed };
+    try {
+        const building = new Map();
+        for (const session of readSessions(db)) {
+            const aggregate = {
+                file,
+                size: session.size,
+                mtimeMs: session.mtimeMs,
+                provider: opencodeProvider.name,
+                sessionId: session.id,
+                kind: session.parentId ? "subagent" : "main",
+                project: session.directory,
+                firstTs: "",
+                lastTs: "",
+                days: {},
+                malformedLines: 0,
+            };
+            if (session.parentId)
+                aggregate.parentSessionId = session.parentId;
+            if (session.title)
+                aggregate.title = session.title;
+            if (session.version)
+                aggregate.toolVersion = session.version;
+            building.set(session.id, { aggregate, events: [] });
+        }
+        applyMessages(db, building);
+        applyParts(db, building);
+        for (const [id, target] of building)
+            parsed.set(id, { aggregate: target.aggregate, events: target.events });
+    }
+    finally {
+        closeQuietly(db);
+    }
+    return { key, parsed };
+}
+function loadStore(file) {
+    const key = storeKey(file);
+    if (store && store.key === key)
+        return store;
+    store = buildStore(file);
+    return store;
+}
+export const opencodeProvider = {
+    name: "opencode",
+    title: "OpenCode",
+    source: "The session store at $XDG_DATA_HOME/opencode/opencode.db (default ~/.local/share)",
+    capabilities: {
+        tokens: true,
+        // `tokens.cache.{read,write}` are named fields on every assistant message,
+        // disjoint from `input` rather than contained in it.
+        cacheTokens: true,
+        tools: true,
+        // OpenCode records no skill in the store: the part types are text,
+        // reasoning, step-start, step-finish and tool, and none names one.
+        skills: false,
+        subagents: true,
+        // Plugins can hook the session lifecycle, but no execution of one is
+        // written to any table.
+        hooks: false,
+        // A tool part records a bare name with no server, so an MCP call cannot be
+        // told from a builtin.
+        mcp: false,
+        // A command reaches the store only as the prompt text it expanded to.
+        slashCommands: false,
+        projects: true,
+    },
+    root(context) {
+        const xdg = context.env.XDG_DATA_HOME?.trim();
+        const candidate = context.override?.trim() ||
+            (xdg ? path.join(xdg, "opencode") : path.join(context.home, ".local", "share", "opencode"));
+        try {
+            return fs.statSync(path.join(candidate, DATABASE)).isFile() ? candidate : null;
+        }
+        catch {
+            return null;
+        }
+    },
+    /**
+     * One entry per session, out of a store with no filesystem unit below itself.
+     *
+     * `FileAggregate` carries exactly one session id, kind, project and time
+     * span, so collapsing the store into a single entry would destroy
+     * `usage sessions`, `--last`, `--project`, and the main/subagent split. The
+     * unit therefore has to be synthesized, and once it is, so does its freshness
+     * key -- see {@link readSessions}.
+     */
+    discover(root, options) {
+        const file = path.join(root, DATABASE);
+        const db = openDatabase(file);
+        if (!db)
+            return [];
+        let sessions;
+        try {
+            sessions = readSessions(db);
+        }
+        finally {
+            closeQuietly(db);
+        }
+        const found = [];
+        for (const session of sessions) {
+            // `parent_id` is on the row, so subagents are pruned before anything is
+            // parsed -- the third provider that can, after claude-code and gemini-cli.
+            if (!options.subagents && session.parentId)
+                continue;
+            if (options.modifiedSince !== undefined && session.mtimeMs < options.modifiedSince)
+                continue;
+            found.push({
+                file,
+                relative: `${SHARD}/${session.id}`,
+                shard: SHARD,
+                kind: session.parentId ? "subagent" : "main",
+                size: session.size,
+                mtimeMs: session.mtimeMs,
+            });
+        }
+        found.sort((a, b) => (a.relative < b.relative ? -1 : a.relative > b.relative ? 1 : 0));
+        return found;
+    },
+    async read(file) {
+        return (await opencodeProvider.parse(file)).aggregate;
+    },
+    async parse(file) {
+        const sessionId = file.relative.slice(`${SHARD}/`.length);
+        const found = loadStore(file.file).parsed.get(sessionId);
+        if (found)
+            return found;
+        // A session that vanished between discovery and parsing, or a store that
+        // would not open. Neither is fatal: it reports as an empty transcript.
+        return {
+            aggregate: {
+                file: file.file,
+                size: file.size,
+                mtimeMs: file.mtimeMs,
+                provider: opencodeProvider.name,
+                sessionId,
+                kind: file.kind,
+                project: "",
+                firstTs: "",
+                lastTs: "",
+                days: {},
+                malformedLines: 0,
+            },
+            events: [],
+        };
+    },
+};
+//# sourceMappingURL=opencode.js.map

package/dist/usage/providers/opencode.js.map

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

package/dist/usage/providers/protobuf.d.ts

@@ -0,0 +1,35 @@
+/**
+ * A minimal protobuf wire-format reader.
+ *
+ * Antigravity stores its per-request token usage as unencrypted protobuf blobs
+ * inside SQLite columns, and ships no `.proto` — so the field *numbers* are all
+ * there is to go on. A protobuf dependency would buy nothing here: there is no
+ * schema to compile against, and the wire format itself is four cases.
+ *
+ * Reading is deliberately total rather than strict: an unknown wire type stops
+ * the scan and returns what was read so far, because a partial decode that the
+ * caller can validate is more useful than an exception from a format nobody
+ * published. Every consumer must treat a missing field as absent, never assume.
+ */
+/** Decoded fields, keyed by field number. Protobuf allows repeats, hence arrays. */
+export type ProtoFields = Record<number, ProtoValue[]>;
+export type ProtoValue = number | Buffer;
+/** Decodes one message into its fields. Never throws. */
+export declare function decode(buffer: Buffer): ProtoFields;
+/** The first value of a field as a number, or undefined when absent or not one. */
+export declare function num(fields: ProtoFields, field: number): number | undefined;
+/** A numeric field, defaulting to 0 — protobuf omits zero-valued scalars. */
+export declare function int(fields: ProtoFields, field: number): number;
+/** The first value of a field as a UTF-8 string, or undefined. */
+export declare function str(fields: ProtoFields, field: number): string | undefined;
+/** The first value of a field decoded as a nested message, or undefined. */
+export declare function sub(fields: ProtoFields, field: number): ProtoFields | undefined;
+/** Follows a chain of nested message fields, e.g. `path(root, 5, 9)`. */
+export declare function path(fields: ProtoFields, ...route: number[]): ProtoFields | undefined;
+/**
+ * A `google.protobuf.Timestamp` as an ISO instant.
+ *
+ * Field 1 is seconds since the epoch, field 2 nanoseconds. Returns null for a
+ * zero or implausible value so a missing timestamp cannot become 1970.
+ */
+export declare function timestamp(fields: ProtoFields | undefined): string | null;

package/dist/usage/providers/protobuf.js

@@ -0,0 +1,125 @@
+/**
+ * A minimal protobuf wire-format reader.
+ *
+ * Antigravity stores its per-request token usage as unencrypted protobuf blobs
+ * inside SQLite columns, and ships no `.proto` — so the field *numbers* are all
+ * there is to go on. A protobuf dependency would buy nothing here: there is no
+ * schema to compile against, and the wire format itself is four cases.
+ *
+ * Reading is deliberately total rather than strict: an unknown wire type stops
+ * the scan and returns what was read so far, because a partial decode that the
+ * caller can validate is more useful than an exception from a format nobody
+ * published. Every consumer must treat a missing field as absent, never assume.
+ */
+const VARINT = 0;
+const FIXED64 = 1;
+const LENGTH = 2;
+const FIXED32 = 5;
+/** Bounds the scan so a corrupt length prefix cannot spin. */
+const MAX_FIELDS = 4096;
+function readVarint(buffer, cursor) {
+    let result = 0n;
+    let shift = 0n;
+    while (cursor.offset < buffer.length) {
+        const byte = buffer[cursor.offset++];
+        result |= BigInt(byte & 0x7f) << shift;
+        if ((byte & 0x80) === 0)
+            break;
+        shift += 7n;
+        // A varint longer than 10 bytes is malformed; stop rather than loop.
+        if (shift > 63n)
+            break;
+    }
+    return Number(result);
+}
+/** Decodes one message into its fields. Never throws. */
+export function decode(buffer) {
+    const fields = {};
+    const cursor = { offset: 0 };
+    let seen = 0;
+    while (cursor.offset < buffer.length && seen++ < MAX_FIELDS) {
+        const tag = readVarint(buffer, cursor);
+        const field = tag >> 3;
+        const wire = tag & 0x07;
+        if (field === 0)
+            break;
+        let value;
+        switch (wire) {
+            case VARINT:
+                value = readVarint(buffer, cursor);
+                break;
+            case LENGTH: {
+                const length = readVarint(buffer, cursor);
+                if (length < 0 || cursor.offset + length > buffer.length)
+                    return fields;
+                value = buffer.subarray(cursor.offset, cursor.offset + length);
+                cursor.offset += length;
+                break;
+            }
+            case FIXED32:
+                if (cursor.offset + 4 > buffer.length)
+                    return fields;
+                value = buffer.readUInt32LE(cursor.offset);
+                cursor.offset += 4;
+                break;
+            case FIXED64:
+                if (cursor.offset + 8 > buffer.length)
+                    return fields;
+                value = Number(buffer.readBigUInt64LE(cursor.offset));
+                cursor.offset += 8;
+                break;
+            default:
+                // Groups (3 and 4) are deprecated and absent here; anything else is a
+                // desync. Return what was read rather than guessing at a resync point.
+                return fields;
+        }
+        (fields[field] ??= []).push(value);
+    }
+    return fields;
+}
+/** The first value of a field as a number, or undefined when absent or not one. */
+export function num(fields, field) {
+    const value = fields[field]?.[0];
+    return typeof value === "number" ? value : undefined;
+}
+/** A numeric field, defaulting to 0 — protobuf omits zero-valued scalars. */
+export function int(fields, field) {
+    return num(fields, field) ?? 0;
+}
+/** The first value of a field as a UTF-8 string, or undefined. */
+export function str(fields, field) {
+    const value = fields[field]?.[0];
+    return Buffer.isBuffer(value) ? value.toString("utf-8") : undefined;
+}
+/** The first value of a field decoded as a nested message, or undefined. */
+export function sub(fields, field) {
+    const value = fields[field]?.[0];
+    return Buffer.isBuffer(value) ? decode(value) : undefined;
+}
+/** Follows a chain of nested message fields, e.g. `path(root, 5, 9)`. */
+export function path(fields, ...route) {
+    let current = fields;
+    for (const field of route) {
+        if (!current)
+            return undefined;
+        current = sub(current, field);
+    }
+    return current;
+}
+/**
+ * A `google.protobuf.Timestamp` as an ISO instant.
+ *
+ * Field 1 is seconds since the epoch, field 2 nanoseconds. Returns null for a
+ * zero or implausible value so a missing timestamp cannot become 1970.
+ */
+export function timestamp(fields) {
+    if (!fields)
+        return null;
+    const seconds = int(fields, 1);
+    if (seconds <= 0)
+        return null;
+    const millis = seconds * 1000 + Math.floor(int(fields, 2) / 1_000_000);
+    const date = new Date(millis);
+    return Number.isFinite(date.getTime()) ? date.toISOString() : null;
+}
+//# sourceMappingURL=protobuf.js.map

package/dist/usage/providers/protobuf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protobuf.js","sourceRoot":"","sources":["../../../src/usage/providers/protobuf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,MAAM,GAAG,CAAC,CAAC;AACjB,MAAM,OAAO,GAAG,CAAC,CAAC;AAClB,MAAM,MAAM,GAAG,CAAC,CAAC;AACjB,MAAM,OAAO,GAAG,CAAC,CAAC;AAElB,8DAA8D;AAC9D,MAAM,UAAU,GAAG,IAAI,CAAC;AAMxB,SAAS,UAAU,CAAC,MAAc,EAAE,MAAc;IAChD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,OAAO,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACrC,MAAM,IAAI,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;YAAE,MAAM;QAC/B,KAAK,IAAI,EAAE,CAAC;QACZ,qEAAqE;QACrE,IAAI,KAAK,GAAG,GAAG;YAAE,MAAM;IACzB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAW,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACrC,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,OAAO,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,IAAI,EAAE,GAAG,UAAU,EAAE,CAAC;QAC5D,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;QACxB,IAAI,KAAK,KAAK,CAAC;YAAE,MAAM;QAEvB,IAAI,KAAiB,CAAC;QACtB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,MAAM;gBACT,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC1C,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM;oBAAE,OAAO,MAAM,CAAC;gBACxE,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;gBAC/D,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC;gBACxB,MAAM;YACR,CAAC;YACD,KAAK,OAAO;gBACV,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM;oBAAE,OAAO,MAAM,CAAC;gBACrD,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC3C,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;gBACnB,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM;oBAAE,OAAO,MAAM,CAAC;gBACrD,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;gBACtD,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;gBACnB,MAAM;YACR;gBACE,sEAAsE;gBACtE,uEAAuE;gBACvE,OAAO,MAAM,CAAC;QAClB,CAAC;QACD,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,GAAG,CAAC,MAAmB,EAAE,KAAa;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,GAAG,CAAC,MAAmB,EAAE,KAAa;IACpD,OAAO,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,GAAG,CAAC,MAAmB,EAAE,KAAa;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,GAAG,CAAC,MAAmB,EAAE,KAAa;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,IAAI,CAAC,MAAmB,EAAE,GAAG,KAAe;IAC1D,IAAI,OAAO,GAA4B,MAAM,CAAC;IAC9C,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,MAA+B;IACvD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/B,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACrE,CAAC"}