@geohar/un-bien 0.7.0

package/dist/panel_bridge.js

@@ -0,0 +1,409 @@
+// Bridge the in-process plan + subagents buses to the paired app as
+// `panel_update` frames. pi-plan renders these same sources to a local TUI
+// widget (render-only, process-local) and never puts them on the relay; this
+// module mirrors that data over the wire so the app's side-panels populate
+// from a live session.
+//
+// Two sources, ported from pi-plan (wire.ts + agents.ts):
+//   plan:snapshot { ns, seq?, items }            — replace a source's whole set
+//   plan:update   { ns, seq?, upsert?, remove? }  — part-by-part patch
+//   subagents:*   { id, type?, description? }      — 6 lifecycle channels
+//
+// Each source accumulates and broadcasts `panel_update { key, title, data }`,
+// coalesced so a burst of bus events yields one frame per tick. `data` is
+// `{ items: [...] }`; the app decodes the plan panel's items through its own
+// wave-order model, and renders others generically.
+//
+// Inert when the SDK exposes no events bus. Faithful to pi-plan so the two
+// stay wire-compatible; kept self-contained (pi-plan is not a dependency).
+import { appendFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { loadConfig } from "./config.js";
+import { unbienStateHome } from "./paths.js";
+/** Coalesce window: bus events often arrive in bursts (a plan snapshot + N
+ *  updates); one frame per source per tick is plenty and spares the relay. */
+const COALESCE_MS = 60;
+const PLAN_KEY = "plan";
+const AGENTS_KEY = "subagents";
+/**
+ * Subscribe the plan + subagents buses and broadcast `panel_update` frames.
+ * Returns `null` when the SDK exposes no usable events bus (defensive — modern
+ * Pi always has one); callers stay null-safe.
+ */
+export function createPanelBridge(pi, broadcast) {
+    const eventsRaw = pi.events;
+    if (!eventsRaw || typeof eventsRaw.on !== "function") {
+        return null;
+    }
+    const events = eventsRaw;
+    // Opt-in tracing: shows whether bus events land and whether a panel frame is
+    // broadcast, to isolate capture vs render. Enabled by the `debug.panels` pref
+    // in the global config (`extensions/un-bien.json`) — logs to stderr AND appends
+    // to `<state>/panel-bridge.log`. stderr scrolls too fast — tail the file.
+    const debug = (() => {
+        if (loadConfig().debug?.panels !== true)
+            return () => { };
+        // Stable, findable location: `<state>/panel-bridge.log`.
+        const dir = unbienStateHome();
+        try {
+            mkdirSync(dir, { recursive: true });
+        }
+        catch {
+            /* best-effort */
+        }
+        const logFile = join(dir, "panel-bridge.log");
+        return (msg) => {
+            const line = `${new Date().toISOString()} [panel-bridge] ${msg}`;
+            try {
+                console.error(line);
+            }
+            catch {
+                /* stderr closed */
+            }
+            try {
+                appendFileSync(logFile, `${line}\n`);
+            }
+            catch {
+                /* best-effort file log */
+            }
+        };
+    })();
+    // ── Plan accumulation (port of pi-plan wire.ts) ──────────────────────────
+    // Per-source (`ns`) item maps + last-seen seq to drop out-of-order frames.
+    const planByNs = new Map();
+    const planLastSeq = new Map();
+    const allPlanItems = () => {
+        const out = [];
+        for (const map of planByNs.values())
+            for (const it of map.values())
+                out.push(it);
+        return out;
+    };
+    // ── Subagents fleet (port of pi-plan agents.ts) ──────────────────────────
+    const fleet = new Map();
+    // pi-plan's buildView SEPARATES agents from plans. A plan source can fold the
+    // fleet into its snapshot as `kind:"agent"` nodes (pi-acp does), so route those
+    // to the AGENTS panel and keep them out of the plan rows. Direct `subagents:*`
+    // fleet + any agent-kind plan items are merged by id (live fleet wins status).
+    const isAgent = (it) => it.kind === "agent";
+    const planPanelItems = () => allPlanItems().filter((it) => !isAgent(it));
+    const agentItems = () => {
+        const byId = new Map();
+        for (const it of allPlanItems())
+            if (isAgent(it))
+                byId.set(it.id, it);
+        for (const a of fleet.values()) {
+            const item = toAgentItem(a);
+            byId.set(item.id, item); // live fleet status wins
+        }
+        return [...byId.values()];
+    };
+    // ── Coalesced broadcast ──────────────────────────────────────────────────
+    const timers = new Map();
+    let disposed = false;
+    const planFrame = () => ({
+        type: "panel_update",
+        key: PLAN_KEY,
+        title: "Plan",
+        icon: "checklist",
+        data: { items: planPanelItems() },
+    });
+    const agentsFrame = () => ({
+        type: "panel_update",
+        key: AGENTS_KEY,
+        title: "Agents",
+        icon: "person.2",
+        data: { items: agentItems() },
+    });
+    const scheduleBroadcast = (key, build) => {
+        if (disposed)
+            return;
+        if (timers.has(key)) {
+            debug(`schedule ${key} coalesced (timer pending)`);
+            return;
+        }
+        debug(`schedule ${key}`);
+        timers.set(key, setTimeout(() => {
+            timers.delete(key);
+            if (disposed)
+                return;
+            let frame;
+            try {
+                frame = build();
+            }
+            catch (error) {
+                debug(`build ${key} THREW: ${error instanceof Error ? error.message : String(error)}`);
+                return;
+            }
+            const fitems = frame.type === "panel_update" &&
+                frame.data &&
+                typeof frame.data === "object"
+                ? (frame.data.items ?? [])
+                : [];
+            const kinds = fitems.reduce((acc, it) => {
+                const k = typeof it?.kind === "string" ? it.kind : "?";
+                acc[k] = (acc[k] ?? 0) + 1;
+                return acc;
+            }, {});
+            debug(`broadcast ${key} items=${fitems.length} kinds=${JSON.stringify(kinds)}`);
+            broadcast(frame);
+        }, COALESCE_MS));
+    };
+    // Broadcast NOW (no coalesce). Subagent lifecycle events are infrequent and
+    // discrete — coalescing them risks losing the frame if the bridge is disposed
+    // (session replacement / name collision) within the coalesce window, which is
+    // exactly what dropped the subagents panel. Plan stays coalesced (it bursts).
+    const broadcastNow = (key, build) => {
+        if (disposed)
+            return;
+        let frame;
+        try {
+            frame = build();
+        }
+        catch (error) {
+            debug(`build ${key} THREW: ${error instanceof Error ? error.message : String(error)}`);
+            return;
+        }
+        const items = frame.type === "panel_update" &&
+            frame.data &&
+            typeof frame.data === "object"
+            ? (frame.data.items?.length ?? 0)
+            : 0;
+        debug(`broadcast ${key} now items=${items}`);
+        broadcast(frame);
+    };
+    // ── Plan subscriptions ───────────────────────────────────────────────────
+    const onSnapshot = (raw) => {
+        const snap = parseSnapshot(raw);
+        if (!snap)
+            return;
+        const last = planLastSeq.get(snap.ns);
+        if (last != null && snap.seq < last)
+            return; // stale
+        planLastSeq.set(snap.ns, snap.seq);
+        const next = new Map();
+        for (const it of snap.items)
+            next.set(it.id, it);
+        planByNs.set(snap.ns, next);
+        scheduleBroadcast(PLAN_KEY, planFrame);
+        // Refresh the agents panel only when agents exist — never broadcast an empty
+        // agents frame off a plain plan update (that would spawn a bogus subagents icon).
+        if (agentItems().length > 0)
+            broadcastNow(AGENTS_KEY, agentsFrame);
+    };
+    const onUpdate = (raw) => {
+        const up = parseUpdate(raw);
+        if (!up)
+            return;
+        const last = planLastSeq.get(up.ns);
+        if (last != null && up.seq < last)
+            return; // stale
+        planLastSeq.set(up.ns, up.seq);
+        const map = planByNs.get(up.ns) ?? new Map();
+        let changed = false;
+        for (const it of up.upsert) {
+            map.set(it.id, it);
+            changed = true;
+        }
+        for (const id of up.remove)
+            changed = map.delete(id) || changed;
+        if (!changed)
+            return;
+        planByNs.set(up.ns, map);
+        scheduleBroadcast(PLAN_KEY, planFrame);
+        if (agentItems().length > 0)
+            broadcastNow(AGENTS_KEY, agentsFrame);
+    };
+    const unsubPlan = [
+        events.on("plan:snapshot", onSnapshot),
+        events.on("plan:update", onUpdate),
+    ];
+    // ── Subagents subscriptions ──────────────────────────────────────────────
+    const recordAgent = (status) => (data) => {
+        const p = (data ?? {});
+        const id = str(p.id);
+        debug(`event ${status} id=${id ?? "<none>"}`);
+        if (!id)
+            return;
+        const prev = fleet.get(id);
+        const incoming = {
+            id,
+            type: str(p.type),
+            description: str(p.description),
+            status,
+            startedAt: prev?.startedAt ?? (IN_PROGRESS.has(status) ? Date.now() : undefined),
+        };
+        fleet.set(id, mergeAgentState(prev, incoming));
+        debug(`fleet=${fleet.size} after ${status} ${id}`);
+        broadcastNow(AGENTS_KEY, agentsFrame);
+    };
+    const unsubAgents = Object.entries(LIFECYCLE).map(([channel, status]) => events.on(channel, recordAgent(status)));
+    // NB: unlike pi-plan's TUI (which clears its fleet on session_shutdown to reset
+    // the widget), we deliberately KEEP finished agents. Broadcasting an empty
+    // frame on shutdown would clobber the app's panel the instant a fast agent
+    // completes — the user expects done agents to linger for a while. The fleet
+    // resets naturally when the pi process restarts (a new session = a fresh
+    // bridge), and `pendingPanels` still replays the last fleet to a reconnecting
+    // app.
+    return {
+        pendingPanels() {
+            const out = [];
+            if (planPanelItems().length > 0)
+                out.push(planFrame());
+            if (agentItems().length > 0)
+                out.push(agentsFrame());
+            return out;
+        },
+        dispose() {
+            disposed = true;
+            for (const u of unsubPlan)
+                safeUnsub(u);
+            for (const u of unsubAgents)
+                safeUnsub(u);
+            for (const t of timers.values())
+                clearTimeout(t);
+            timers.clear();
+            planByNs.clear();
+            planLastSeq.clear();
+            fleet.clear();
+        },
+    };
+}
+function parseItem(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const r = raw;
+    if (typeof r.id !== "string")
+        return null;
+    const display = typeof r.title === "string"
+        ? r.title
+        : typeof r.name === "string"
+            ? r.name
+            : r.id;
+    return {
+        id: r.id,
+        kind: typeof r.kind === "string" ? r.kind : "plan",
+        title: display,
+        status: typeof r.status === "string" ? r.status : null,
+        deps: Array.isArray(r.deps)
+            ? r.deps.filter((x) => typeof x === "string")
+            : [],
+        tainted: typeof r.tainted === "boolean" ? r.tainted : undefined,
+        meta: r.meta && typeof r.meta === "object"
+            ? r.meta
+            : undefined,
+    };
+}
+/** Parse `plan:snapshot`. Accepts `source` as a legacy alias for `ns`. */
+function parseSnapshot(data) {
+    if (!data || typeof data !== "object")
+        return null;
+    const d = data;
+    const ns = typeof d.ns === "string"
+        ? d.ns
+        : typeof d.source === "string"
+            ? d.source
+            : null;
+    if (!ns || !Array.isArray(d.items))
+        return null;
+    const items = d.items.map(parseItem).filter((x) => x !== null);
+    return { ns, seq: typeof d.seq === "number" ? d.seq : 0, items };
+}
+/** Parse `plan:update`. Returns null when unusable or a no-op. */
+function parseUpdate(data) {
+    if (!data || typeof data !== "object")
+        return null;
+    const d = data;
+    const ns = typeof d.ns === "string" ? d.ns : null;
+    if (!ns)
+        return null;
+    const upsert = Array.isArray(d.upsert)
+        ? d.upsert.map(parseItem).filter((x) => x !== null)
+        : [];
+    const remove = Array.isArray(d.remove)
+        ? d.remove.filter((x) => typeof x === "string")
+        : [];
+    if (upsert.length === 0 && remove.length === 0)
+        return null;
+    return { ns, seq: typeof d.seq === "number" ? d.seq : 0, upsert, remove };
+}
+const IN_PROGRESS = new Set(["started", "running", "steered", "compacted"]);
+const FAILED = new Set(["failed", "stopped", "aborted", "error"]);
+const LIFECYCLE = {
+    "subagents:created": "created",
+    "subagents:started": "started",
+    "subagents:completed": "completed",
+    "subagents:failed": "failed",
+    "subagents:steered": "steered",
+    "subagents:compacted": "compacted",
+};
+/** Lifecycle rank: pending(0) < in_progress(1) < terminal(2). */
+function statusRank(status) {
+    const s = String(status ?? "").toLowerCase();
+    if (s === "completed" || FAILED.has(s))
+        return 2;
+    if (IN_PROGRESS.has(s))
+        return 1;
+    return 0;
+}
+/** Merge a lifecycle event into kept state: never downgrade status, keep a
+ *  specific terminal reason over a generic `failed`. */
+function mergeAgentState(prev, incoming) {
+    const merged = { ...prev, ...incoming };
+    if (prev?.type && !incoming.type)
+        merged.type = prev.type;
+    if (prev?.description && !incoming.description)
+        merged.description = prev.description;
+    if (prev) {
+        const prevStatus = String(prev.status ?? "").toLowerCase();
+        const inStatus = String(incoming.status ?? "").toLowerCase();
+        const prevRank = statusRank(prevStatus);
+        const inRank = statusRank(inStatus);
+        if (prevRank > inRank)
+            merged.status = prev.status;
+        else if (prevRank === 2 &&
+            inRank === 2 &&
+            inStatus === "failed" &&
+            prevStatus !== "failed")
+            merged.status = prev.status;
+    }
+    return merged;
+}
+/** Map a raw lifecycle status to the display status the app renders. */
+function displayStatus(status) {
+    const s = String(status ?? "").toLowerCase();
+    if (s === "completed")
+        return "done";
+    if (FAILED.has(s))
+        return "failed";
+    if (IN_PROGRESS.has(s))
+        return "in_progress";
+    return "pending";
+}
+/** An AgentState → a `kind:"agent"` plan item for the Agents panel. */
+function toAgentItem(a) {
+    const title = a.description?.trim() || a.type || a.id;
+    return {
+        id: `agent:${a.id}`,
+        kind: "agent",
+        title,
+        status: displayStatus(a.status),
+        deps: [],
+        meta: { agentType: a.type, startedAt: a.startedAt },
+    };
+}
+function str(v) {
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+/** Unsubscribe handles may be `() => void` or undefined; tolerate both. */
+function safeUnsub(u) {
+    if (typeof u === "function") {
+        try {
+            u();
+        }
+        catch {
+            /* best-effort teardown */
+        }
+    }
+}
+//# sourceMappingURL=panel_bridge.js.map

package/dist/panel_bridge.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Absolute root for un-bien on-disk STATE: `sessions/`, `skills/`, the
+ * paired-identity/`peers.json` store, the daemon registries (`daemons.json`,
+ * `cron.json`), the cron/audit logs, the supervisor socket, and the cwd lock
+ * dir. Every state path in the codebase derives from this one resolver so a
+ * relocated install can never split its state across two roots.
+ *
+ * The GLOBAL config is the one exception — it follows the coding-agent dir via
+ * `unbienConfigHome()` (below) as `extensions/un-bien.json`, not this resolver.
+ *
+ * Precedence (resolved at CALL time so tests — and a relocated deployment —
+ * can override via env without re-importing):
+ *
+ *   1. `UNBIEN_DIR`  — an ABSOLUTE override of the state dir itself. Lets the
+ *      state live at an arbitrary path (e.g. an XDG-style `~/.config/pi/un-bien`)
+ *      with no forced `.pi/un-bien` suffix. This is the knob to reach for when
+ *      relocating; `UNBIEN_HOME` cannot express it.
+ *   2. `UNBIEN_HOME` — a stand-in `$HOME`; state lives at
+ *      `<UNBIEN_HOME>/.pi/un-bien`. Long-standing test/override knob.
+ *   3. `os.homedir()`   — the default, `~/.pi/un-bien`.
+ */
+export declare function unbienStateHome(): string;
+/**
+ * Root for un-bien's global config specifically — the machine-wide relay URL,
+ * the `defaults` block, and the `debug` prefs. The Pi host keeps its own global
+ * settings under `PI_CODING_AGENT_DIR`, and un-bien's config is a pi extension
+ * config: `<PI_CODING_AGENT_DIR|~/.pi>/extensions/un-bien.json`. This resolver
+ * returns the `extensions` dir; `config.ts` appends `un-bien.json`.
+ *
+ * Precedence (resolved at CALL time):
+ *
+ *   1. `PI_CODING_AGENT_DIR` — the Pi host's settings root (default `~/.pi`).
+ *      Config lives at `<PI_CODING_AGENT_DIR>/extensions/un-bien.json`.
+ *   2. otherwise `~/.pi/extensions` — the default agent-dir location.
+ *
+ * State (sessions, daemon registries, cwd locks, identity) is unaffected — only
+ * the global config honours `PI_CODING_AGENT_DIR` this way.
+ */
+export declare function unbienConfigHome(): string;

package/dist/paths.js

@@ -0,0 +1,51 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * Absolute root for un-bien on-disk STATE: `sessions/`, `skills/`, the
+ * paired-identity/`peers.json` store, the daemon registries (`daemons.json`,
+ * `cron.json`), the cron/audit logs, the supervisor socket, and the cwd lock
+ * dir. Every state path in the codebase derives from this one resolver so a
+ * relocated install can never split its state across two roots.
+ *
+ * The GLOBAL config is the one exception — it follows the coding-agent dir via
+ * `unbienConfigHome()` (below) as `extensions/un-bien.json`, not this resolver.
+ *
+ * Precedence (resolved at CALL time so tests — and a relocated deployment —
+ * can override via env without re-importing):
+ *
+ *   1. `UNBIEN_DIR`  — an ABSOLUTE override of the state dir itself. Lets the
+ *      state live at an arbitrary path (e.g. an XDG-style `~/.config/pi/un-bien`)
+ *      with no forced `.pi/un-bien` suffix. This is the knob to reach for when
+ *      relocating; `UNBIEN_HOME` cannot express it.
+ *   2. `UNBIEN_HOME` — a stand-in `$HOME`; state lives at
+ *      `<UNBIEN_HOME>/.pi/un-bien`. Long-standing test/override knob.
+ *   3. `os.homedir()`   — the default, `~/.pi/un-bien`.
+ */
+export function unbienStateHome() {
+    const dir = process.env["UNBIEN_DIR"];
+    if (dir && dir.length > 0)
+        return dir;
+    return join(process.env["UNBIEN_HOME"] || homedir(), ".pi", "un-bien");
+}
+/**
+ * Root for un-bien's global config specifically — the machine-wide relay URL,
+ * the `defaults` block, and the `debug` prefs. The Pi host keeps its own global
+ * settings under `PI_CODING_AGENT_DIR`, and un-bien's config is a pi extension
+ * config: `<PI_CODING_AGENT_DIR|~/.pi>/extensions/un-bien.json`. This resolver
+ * returns the `extensions` dir; `config.ts` appends `un-bien.json`.
+ *
+ * Precedence (resolved at CALL time):
+ *
+ *   1. `PI_CODING_AGENT_DIR` — the Pi host's settings root (default `~/.pi`).
+ *      Config lives at `<PI_CODING_AGENT_DIR>/extensions/un-bien.json`.
+ *   2. otherwise `~/.pi/extensions` — the default agent-dir location.
+ *
+ * State (sessions, daemon registries, cwd locks, identity) is unaffected — only
+ * the global config honours `PI_CODING_AGENT_DIR` this way.
+ */
+export function unbienConfigHome() {
+    const agentDir = process.env["PI_CODING_AGENT_DIR"];
+    const base = agentDir && agentDir.length > 0 ? agentDir : join(homedir(), ".pi");
+    return join(base, "extensions");
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACtC,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACtC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACpD,MAAM,IAAI,GACR,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AAClC,CAAC"}

package/dist/protocol/codec.d.ts

@@ -0,0 +1,7 @@
+import type { ClientMessage, ServerMessage } from "./types.js";
+export declare class DecodeError extends Error {
+    readonly code: "invalid_message" | "unsupported_type";
+    constructor(code: "invalid_message" | "unsupported_type", message: string);
+}
+export declare function encodeClient(msg: ClientMessage): string;
+export declare function decodeServer(line: string): ServerMessage;

package/dist/protocol/codec.js

@@ -0,0 +1,48 @@
+const SERVER_TYPES = new Set([
+    "pair_ok",
+    "pair_error",
+    "user_input",
+    "queued_message_state",
+    "agent_chunk",
+    "agent_reasoning",
+    "agent_done",
+    "agent_message",
+    "tool_request",
+    "tool_result",
+    "error",
+    "cancelled",
+    "pong",
+    // Plan/57 — interactive extension prompt (ask_user via pi-ask).
+    "extension_ui_request",
+]);
+export class DecodeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "DecodeError";
+    }
+}
+export function encodeClient(msg) {
+    return JSON.stringify(msg) + "\n";
+}
+export function decodeServer(line) {
+    let obj;
+    try {
+        obj = JSON.parse(line.trim());
+    }
+    catch (e) {
+        throw new DecodeError("invalid_message", `not JSON: ${e.message}`);
+    }
+    if (!obj ||
+        typeof obj !== "object" ||
+        typeof obj.type !== "string") {
+        throw new DecodeError("invalid_message", "missing 'type'");
+    }
+    const t = obj.type;
+    if (!SERVER_TYPES.has(t)) {
+        throw new DecodeError("unsupported_type", `unknown type: ${t}`);
+    }
+    return obj;
+}
+//# sourceMappingURL=codec.js.map

package/dist/protocol/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../../src/protocol/codec.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,IAAI,GAAG,CAAwB;IAClD,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,sBAAsB;IACtB,aAAa;IACb,iBAAiB;IACjB,YAAY;IACZ,eAAe;IACf,cAAc;IACd,aAAa;IACb,OAAO;IACP,WAAW;IACX,MAAM;IACN,gEAAgE;IAChE,sBAAsB;CACvB,CAAC,CAAC;AAEH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAElB;IADlB,YACkB,IAA4C,EAC5D,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAwC;QAI5D,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,GAAkB;IAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,WAAW,CACnB,iBAAiB,EACjB,aAAc,CAAW,CAAC,OAAO,EAAE,CACpC,CAAC;IACJ,CAAC;IACD,IACE,CAAC,GAAG;QACJ,OAAO,GAAG,KAAK,QAAQ;QACvB,OAAQ,GAA+B,CAAC,IAAI,KAAK,QAAQ,EACzD,CAAC;QACD,MAAM,IAAI,WAAW,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,CAAC,GAAI,GAA+B,CAAC,IAAc,CAAC;IAC1D,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAA0B,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,WAAW,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,GAAoB,CAAC;AAC9B,CAAC"}