@yjjeong/omg 0.1.0

package/dist/cli/bgTasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bgTasks.d.ts","sourceRoot":"","sources":["../../src/cli/bgTasks.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,UAAU;IACzB;4BACwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB;uEACmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB;gCAC4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,KACX,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAuB1B;;6CAE6C;AAC7C,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAA0B,GACnC,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,qBAAa,aAAa;IAIZ,OAAO,CAAC,QAAQ,CAAC,UAAU;IAHvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,KAAK,CAA+C;gBAE/B,UAAU,EAAE,cAAc;IAEvD;;wCAEoC;IACpC,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAS7B;6CACyC;IACzC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ7B,iEAAiE;IACjE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUjC,KAAK,IAAI,IAAI;YAQC,IAAI;CA6DnB;AAED;;;;;;;;;;aAUa;AACb,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,OAAO,GACd;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAY/C"}

package/dist/cli/bgTasks.js

@@ -0,0 +1,193 @@
+// Phase 257: claude-cli `run_in_background` continuation.
+//
+// claude-cli's Bash tool can run a command in the background and
+// promises "you will be notified when it completes." That promise
+// assumes an interactive Claude Code session that polls the task
+// output file. omg runs claude-cli in print mode (`claude -p ...`)
+// per turn — the process exits after the turn ends, so the
+// notification mechanism has nowhere to surface.
+//
+// User-visible symptom: claude says "I'll wait for the build" but
+// never auto-continues. User has to type "is it done?" to trigger a
+// new turn, at which point claude reads the marker and replies.
+//
+// This module watches the background task's output file. When the
+// file's size has been stable for `STABLE_MS` (and the task has
+// been running for at least `MIN_AGE_MS`), the watcher fires its
+// callback with the captured output. The CLI uses that callback to
+// auto-inject a continuation into the owning tab — same path as a
+// user typing the next message, so claude resumes naturally.
+import { promises as fs } from "node:fs";
+import { outputSignalsCompletion } from "../core/util/bgProtocol.js";
+/** Poll interval. Fast enough that long-running tasks resume soon
+ *  after completion, slow enough to ignore minor writes during
+ *  output bursts. */
+const POLL_MS = 3_000;
+/** A task must show no file growth for this long before we consider
+ *  it done. Tasks like docker builds have quiet phases — too short a
+ *  window causes false positives mid-build. */
+const STABLE_MS = 15_000;
+/** Don't fire the completion callback inside the first MIN_AGE_MS —
+ *  a fast command (≤ poll cycle) can race the first poll, look
+ *  "stable" immediately, and trigger before its output even exists.
+ *  20s is well below typical docker/test workloads. */
+const MIN_AGE_MS = 20_000;
+/** Phase 315: how many trailing bytes of the output file to scan for the
+ *  completion marker. The marker is the command's last echo, so it lives
+ *  at the very end — no need to read megabytes of build log each poll. */
+const MARKER_SCAN_BYTES = 8_192;
+/** Read the last `maxBytes` of a file as UTF-8 (the whole file when it's
+ *  smaller). Used to cheaply scan a growing output tail for the
+ *  completion marker. Exported for tests. */
+export async function readTail(path, maxBytes = MARKER_SCAN_BYTES) {
+    const { size } = await fs.stat(path);
+    if (size <= maxBytes)
+        return fs.readFile(path, "utf8");
+    const fh = await fs.open(path, "r");
+    try {
+        const buf = Buffer.alloc(maxBytes);
+        await fh.read(buf, 0, maxBytes, size - maxBytes);
+        return buf.toString("utf8");
+    }
+    finally {
+        await fh.close();
+    }
+}
+export class BgTaskWatcher {
+    onComplete;
+    tasks = new Map();
+    timer = null;
+    constructor(onComplete) {
+        this.onComplete = onComplete;
+    }
+    /** Register a task. The watcher polls until the task's output
+     *  file size has been stable for STABLE_MS, then fires the
+     *  callback once and forgets it. */
+    track(task) {
+        if (this.tasks.has(task.toolId))
+            return;
+        this.tasks.set(task.toolId, task);
+        if (this.timer === null) {
+            this.timer = setInterval(() => void this.poll(), POLL_MS);
+            this.timer.unref?.();
+        }
+    }
+    /** Drop a tracked task without firing — used when the owning tab
+     *  is closed before the task settles. */
+    untrack(toolId) {
+        this.tasks.delete(toolId);
+        if (this.tasks.size === 0 && this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /** Drop every tracked task for a given tab. Called on /close. */
+    untrackTab(tabName) {
+        for (const [id, t] of this.tasks) {
+            if (t.tabName === tabName)
+                this.tasks.delete(id);
+        }
+        if (this.tasks.size === 0 && this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    close() {
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.tasks.clear();
+    }
+    async poll() {
+        const now = Date.now();
+        for (const [toolId, task] of [...this.tasks]) {
+            let size;
+            try {
+                size = (await fs.stat(task.outputPath)).size;
+            }
+            catch {
+                // ENOENT — file hasn't appeared yet or was deleted. Reset
+                // the stable-since clock; we'll keep waiting until the file
+                // shows up or the task is untracked.
+                task.stableSince = now;
+                continue;
+            }
+            // Phase 315: an explicit completion marker is definitive — fire
+            // immediately, bypassing both MIN_AGE_MS and the STABLE_MS quiet
+            // window (which a deploy's silent phases can otherwise mis-trigger
+            // or stall on). The marker is the command's last echo, so scanning
+            // the tail is enough.
+            try {
+                if (outputSignalsCompletion(await readTail(task.outputPath))) {
+                    this.tasks.delete(toolId);
+                    const output = await fs
+                        .readFile(task.outputPath, "utf8")
+                        .catch(() => "");
+                    void Promise.resolve(this.onComplete(task, output)).catch(() => {
+                        /* the callback's own error reporting handles failures */
+                    });
+                    continue;
+                }
+            }
+            catch {
+                /* tail read raced a delete — fall through to stabilization */
+            }
+            // No marker: fall back to the output-quiet heuristic, but never
+            // before MIN_AGE_MS (a fast command can look "stable" on the first
+            // poll before its output even exists).
+            if (now - task.startedAt < MIN_AGE_MS)
+                continue;
+            if (size === task.lastSize) {
+                if (now - task.stableSince >= STABLE_MS) {
+                    // Settled. Read final content and fire.
+                    let output = "";
+                    try {
+                        output = await fs.readFile(task.outputPath, "utf8");
+                    }
+                    catch {
+                        /* file vanished between stat and read — proceed empty */
+                    }
+                    this.tasks.delete(toolId);
+                    void Promise.resolve(this.onComplete(task, output)).catch(() => {
+                        /* the callback's own error reporting handles failures */
+                    });
+                }
+                continue;
+            }
+            // File grew (or shrunk) since last poll. Reset stabilization.
+            task.lastSize = size;
+            task.stableSince = now;
+        }
+        if (this.tasks.size === 0 && this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+}
+/** Pull the task id + output path out of a Bash tool_use_end result.
+ *
+ *  claude-cli's hint reads roughly:
+ *    Command running in background with ID: <id>. Output is being
+ *    written to: <path>. You will be notified when it completes.
+ *
+ *  Both the leading text and the trailing punctuation are stable;
+ *  the regex tolerates the trailing period plus optional whitespace.
+ *  Returns null when the result doesn't match (a regular Bash result
+ *  with command output) — caller treats null as "not a background
+ *  task." */
+export function parseBgTaskResult(result) {
+    const text = typeof result === "string"
+        ? result
+        : typeof result?.stdout === "string"
+            ? result.stdout
+            : "";
+    if (!text)
+        return null;
+    const idMatch = /background with ID:\s*(\S+?)[.\s]/i.exec(text);
+    const pathMatch = /written to:\s*(\S+?)\.\s/i.exec(text);
+    if (!idMatch || !pathMatch)
+        return null;
+    return { taskId: idMatch[1], outputPath: pathMatch[1] };
+}
+//# sourceMappingURL=bgTasks.js.map

package/dist/cli/bgTasks.js.map

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

package/dist/cli/compactor.d.ts

@@ -0,0 +1,48 @@
+import { DEFAULT_COMPACT_THRESHOLD, shouldAutoCompact } from "../core/context/summarizer.js";
+import type { Tab } from "./types.js";
+export interface CompactSuccess {
+    ok: true;
+    /** How many messages got folded into the summary. */
+    compactedCount: number;
+    /** The generated summary text (already inserted into tab.messages). */
+    summary: string;
+}
+export interface CompactSkipped {
+    ok: false;
+    /** Why nothing happened. `too-short` = tab.messages has fewer than
+     *  keepLast entries; nothing earlier to compact. `empty-summary` =
+     *  the cheap summarizer model returned nothing usable. */
+    reason: "too-short" | "empty-summary";
+    /** Total messages on the tab at compact time. Surfaced in
+     *  diagnostic UI so the user understands "compact ran but couldn't
+     *  help — your tab only has N messages". */
+    messagesCount: number;
+    /** keepLast value used. */
+    keepLast: number;
+}
+export type CompactResult = CompactSuccess | CompactSkipped;
+/** Compact `tab.messages` in place. Returns a discriminated union so
+ *  callers can surface a precise diagnostic when nothing happens.
+ *  Phase 258: was returning bare null on no-op; users saw the
+ *  "compacting…" spinner with no visible follow-up and assumed the
+ *  feature was broken.
+ *  Phase 259: caller may pass an `onCancel` callback to receive a
+ *  cancel handle the compact's owner can park on `tab.cancel`. Esc
+ *  → cancel SIGTERMs the summarizer child; otherwise compact is
+ *  opaque from the user's side ("compacting… 4m" with no way out).
+ */
+export declare function compactTab(tab: Tab, baseOpts: Record<string, unknown>, opts?: {
+    keepLast?: number;
+    onCancel?: (handle: {
+        cancel: () => void;
+    }) => void;
+    onProgress?: (chars: number) => void;
+    focus?: string;
+}): Promise<CompactResult>;
+export { shouldAutoCompact, DEFAULT_COMPACT_THRESHOLD };
+/** Phase 322 (T2): user-facing success line for a completed compaction —
+ *  how many messages folded, the summary's rough token size, and a
+ *  one-line preview so the user can verify continuity. Shared by the auto
+ *  (turn.ts) and manual (/compact) paths. */
+export declare function formatCompactSuccess(r: CompactSuccess): string;
+//# sourceMappingURL=compactor.d.ts.map

package/dist/cli/compactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactor.d.ts","sourceRoot":"","sources":["../../src/cli/compactor.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EAElB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAMtC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,IAAI,CAAC;IACT,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,KAAK,CAAC;IACV;;8DAE0D;IAC1D,MAAM,EAAE,WAAW,GAAG,eAAe,CAAC;IACtC;;gDAE4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,cAAc,CAAC;AAE5D;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,GAAE;IACJ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC;IAGpD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAErC,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GACL,OAAO,CAAC,aAAa,CAAC,CA6CxB;AAED,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,CAAC;AAExD;;;6CAG6C;AAC7C,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAS9D"}

package/dist/cli/compactor.js

@@ -0,0 +1,73 @@
+// Phase 182: tab-level auto-compact. Replaces the earliest messages of
+// a tab's history with one summary message and resets the adapter's
+// captured session so the next turn re-sends the (now-compacted)
+// history from scratch.
+import { DEFAULT_COMPACT_THRESHOLD, shouldAutoCompact, summarizeMessages, } from "../core/context/summarizer.js";
+/** How many most-recent messages stay verbatim. ~2 turns of context
+ *  the model can lean on while the summary covers everything earlier. */
+const KEEP_LAST_MESSAGES = 4;
+/** Compact `tab.messages` in place. Returns a discriminated union so
+ *  callers can surface a precise diagnostic when nothing happens.
+ *  Phase 258: was returning bare null on no-op; users saw the
+ *  "compacting…" spinner with no visible follow-up and assumed the
+ *  feature was broken.
+ *  Phase 259: caller may pass an `onCancel` callback to receive a
+ *  cancel handle the compact's owner can park on `tab.cancel`. Esc
+ *  → cancel SIGTERMs the summarizer child; otherwise compact is
+ *  opaque from the user's side ("compacting… 4m" with no way out).
+ */
+export async function compactTab(tab, baseOpts, opts = {}) {
+    const keep = opts.keepLast ?? KEEP_LAST_MESSAGES;
+    if (tab.messages.length <= keep) {
+        return {
+            ok: false,
+            reason: "too-short",
+            messagesCount: tab.messages.length,
+            keepLast: keep,
+        };
+    }
+    const toCompact = tab.messages.slice(0, -keep);
+    const keepMessages = tab.messages.slice(-keep);
+    const flat = toCompact.map((m) => ({ role: m.role, text: m.text }));
+    const summary = await summarizeMessages(flat, tab.provider, tab.model, baseOpts, {
+        onCancel: opts.onCancel,
+        onProgress: opts.onProgress,
+        focus: opts.focus,
+    });
+    if (!summary) {
+        return {
+            ok: false,
+            reason: "empty-summary",
+            messagesCount: tab.messages.length,
+            keepLast: keep,
+        };
+    }
+    // Replace contents in place so the turn loop (which already holds a
+    // reference to tab.messages) sees the new history.
+    tab.messages.length = 0;
+    tab.messages.push({
+        role: "user",
+        text: `[Earlier conversation summary]\n${summary}`,
+    });
+    for (const m of keepMessages)
+        tab.messages.push(m);
+    // The captured CLI session still carries the uncompacted history;
+    // drop it so the next stream() starts a fresh session that only
+    // sees the compacted messages above.
+    tab.adapter.resetSession?.();
+    return { ok: true, compactedCount: toCompact.length, summary };
+}
+export { shouldAutoCompact, DEFAULT_COMPACT_THRESHOLD };
+/** Phase 322 (T2): user-facing success line for a completed compaction —
+ *  how many messages folded, the summary's rough token size, and a
+ *  one-line preview so the user can verify continuity. Shared by the auto
+ *  (turn.ts) and manual (/compact) paths. */
+export function formatCompactSuccess(r) {
+    const tok = Math.round(r.summary.length / 4);
+    const size = tok >= 1000 ? `${Math.round(tok / 1000)}K` : String(tok);
+    const firstLine = r.summary.split("\n").find((l) => l.trim().length > 0)?.trim() ?? "";
+    const preview = firstLine.length > 80 ? `${firstLine.slice(0, 79)}…` : firstLine;
+    const head = `[compact] folded ${r.compactedCount} earlier messages → summary ~${size} tokens (context re-measured next turn).`;
+    return preview ? `${head}\n  kept: ${preview}\n` : `${head}\n`;
+}
+//# sourceMappingURL=compactor.js.map

package/dist/cli/compactor.js.map

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

package/dist/cli/doctor.d.ts

@@ -0,0 +1,77 @@
+import { type LoginProvider } from "./login.js";
+export type BaseProvider = LoginProvider;
+export declare const BASE_PROVIDERS: readonly BaseProvider[];
+/** Which paths a base provider is needed on, derived from the active
+ *  team policy. `cli` = a role uses `<p>-cli`; `sdk` = a role uses the
+ *  bare SDK provider id. */
+export interface ProviderNeed {
+    cli: boolean;
+    sdk: boolean;
+}
+export type RequiredSet = Record<BaseProvider, ProviderNeed>;
+export declare function emptyRequired(): RequiredSet;
+/** Map a team.yaml provider string onto a base provider + path. Returns
+ *  null for non-provider ids ("stub", "policy") and unknown strings. */
+export declare function classifyProvider(raw: string): {
+    base: BaseProvider;
+    path: "cli" | "sdk";
+} | null;
+/** Build the required set from a list of team.yaml provider strings. */
+export declare function requiredFromProviders(providers: Iterable<string>): RequiredSet;
+/** Injected probe — the only seam touching the real machine. Tests pass a
+ *  fake; `nodeDoctorEnv()` is the production impl. */
+export interface DoctorEnv {
+    onPath(bin: string): boolean;
+    fileExists(path: string): boolean;
+    readFile(path: string): string | null;
+    envVar(name: string): string | undefined;
+    canImport(moduleName: string): Promise<boolean>;
+    home(): string;
+}
+export interface ProviderDiagnosis {
+    provider: BaseProvider;
+    required: ProviderNeed;
+    cliOnPath: boolean;
+    authFilePresent: boolean;
+    /** null = the SDK import was not probed (only probed when needed). */
+    sdkImportable: boolean | null;
+    keyEnvSet: boolean;
+    /** gemini only; undefined for others. */
+    geminiMcpRegistered?: boolean;
+    /** Satisfies every required path for this provider. */
+    usable: boolean;
+    /** Actionable lines, emitted only for gaps on a REQUIRED path. */
+    fixes: string[];
+}
+/** Phase 348: a configured external MCP server, as doctor sees it. */
+export interface McpServerStatus {
+    name: string;
+    enabled: boolean;
+    providers?: string[];
+}
+export interface DoctorReport {
+    providers: ProviderDiagnosis[];
+    /** True iff every required path across all providers is usable. */
+    pass: boolean;
+    /** Phase 348: external MCP servers from user + project mcp.json (optional;
+     *  populated by the CLI shell, not by diagnose()). */
+    mcp?: McpServerStatus[];
+}
+/**
+ * Diagnose every base provider against the injected environment.
+ *
+ * `probeSdks` controls when the (heavier) dynamic-import probe runs:
+ *   - "required" (default): only for providers whose SDK path is required.
+ *     Cheap enough for the startup preflight nudge.
+ *   - "all": every provider, for a full `omg doctor` picture.
+ */
+export declare function diagnose(env: DoctorEnv, required: RequiredSet, opts?: {
+    probeSdks?: "required" | "all";
+}): Promise<DoctorReport>;
+/** Production probe. */
+export declare function nodeDoctorEnv(): DoctorEnv;
+/** Human-readable report. Required providers first; fix lines only for
+ *  gaps (UI restraint — nothing rendered when a provider is fine). */
+export declare function renderReport(report: DoctorReport): string;
+export declare function renderJson(report: DoctorReport): string;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAIvE,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;AAEzC,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAIjD,CAAC;AAyBF;;4BAE4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAE7D,wBAAgB,aAAa,IAAI,WAAW,CAM3C;AAED;wEACwE;AACxE,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GACV;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,KAAK,GAAG,KAAK,CAAA;CAAE,GAAG,IAAI,CAOpD;AAED,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,WAAW,CAQ9E;AAED;sDACsD;AACtD,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,IAAI,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,sEAAsE;IACtE,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,mEAAmE;IACnE,IAAI,EAAE,OAAO,CAAC;IACd;0DACsD;IACtD,GAAG,CAAC,EAAE,eAAe,EAAE,CAAC;CACzB;AAuBD;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,WAAW,EACrB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,UAAU,GAAG,KAAK,CAAA;CAAO,GAC5C,OAAO,CAAC,YAAY,CAAC,CAuEvB;AAED,wBAAwB;AACxB,wBAAgB,aAAa,IAAI,SAAS,CA+CzC;AAiBD;sEACsE;AACtE,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAqCzD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEvD"}