teamshare-bridge 0.26.13 → 0.26.15

package/dist/lib/harness/opencode-control.js

@@ -2,6 +2,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildOpencodeInterruptArgs = buildOpencodeInterruptArgs;
 exports.interruptOpencodeSession = interruptOpencodeSession;
+exports.extractShellIds = extractShellIds;
+exports.buildShellListArgs = buildShellListArgs;
+exports.buildShellGetArgs = buildShellGetArgs;
+exports.buildShellRemoveArgs = buildShellRemoveArgs;
+exports.listOpencodeShells = listOpencodeShells;
+exports.getOpencodeShell = getOpencodeShell;
+exports.removeOpencodeShell = removeOpencodeShell;
+exports.shellFailureReason = shellFailureReason;
+exports.settleOpencodeShells = settleOpencodeShells;
+exports.buildSubagentListArgs = buildSubagentListArgs;
+exports.buildSessionMessagesArgs = buildSessionMessagesArgs;
+exports.listSubagentSessions = listSubagentSessions;
+exports.listSessionMessages = listSessionMessages;
+exports.formatSubagentMessage = formatSubagentMessage;
+exports.interruptSubagentSessions = interruptSubagentSessions;
 /**
  * OpenCode V2 session control (2026-10).
  *
@@ -21,6 +36,8 @@ const node_child_process_1 = require("node:child_process");
 const harness_1 = require("./harness");
 /** OpenCode session ids are `ses_` + base62-ish; reject anything else. */
 const OPENCODE_SESSION_ID = /^ses_[A-Za-z0-9]+$/;
+/** Shell ids are `sh_` + base62-ish; reject anything else (path safety). */
+const OPENCODE_SHELL_ID = /^sh_[A-Za-z0-9]+$/;
 /**
  * Build the CLI argv that interrupts `sessionId`, or null for an invalid id.
  * Exported as a pure function so the contract can be pinned by a unit test.
@@ -60,4 +77,305 @@ function interruptOpencodeSession(sessionId, timeoutMs = 15_000) {
         }
     });
 }
+/** Shell ids carried by the harness stream (`metadata.shellID` / Shell message). */
+function extractShellIds(line) {
+    if (!line || !line.includes('sh_'))
+        return [];
+    const ids = new Set();
+    const re = /"(?:shellID|shellId|shell_id)"\s*:\s*"(sh_[A-Za-z0-9]+)"/g;
+    for (const m of line.matchAll(re))
+        ids.add(m[1]);
+    return [...ids];
+}
+/** Query suffix for the location-scoped shell routes. */
+function shellLocation(cwd) {
+    return `location%5Bdirectory%5D=${encodeURIComponent(cwd)}`;
+}
+function buildShellListArgs(cwd) {
+    if (!cwd)
+        return null;
+    return ['api', 'GET', `/api/shell?${shellLocation(cwd)}`];
+}
+function buildShellGetArgs(id, cwd) {
+    if (!OPENCODE_SHELL_ID.test(id) || !cwd)
+        return null;
+    return ['api', 'GET', `/api/shell/${id}?${shellLocation(cwd)}`];
+}
+function buildShellRemoveArgs(id, cwd) {
+    if (!OPENCODE_SHELL_ID.test(id) || !cwd)
+        return null;
+    return ['api', 'DELETE', `/api/shell/${id}?${shellLocation(cwd)}`];
+}
+/** Run one `opencode api` call; returns stdout or null (never throws). */
+function runOpencodeApi(args, timeoutMs) {
+    if (!args)
+        return Promise.resolve(null);
+    const bin = (0, harness_1.resolveBin)('opencode');
+    if (!bin)
+        return Promise.resolve(null);
+    return new Promise((resolve) => {
+        try {
+            (0, node_child_process_1.execFile)(bin.file, [...(bin.args ?? []), ...args], { timeout: timeoutMs, windowsHide: true, maxBuffer: 4 * 1024 * 1024 }, (err, stdout) => {
+                if (err) {
+                    resolve(null);
+                    return;
+                }
+                resolve(String(stdout ?? ''));
+            });
+        }
+        catch {
+            resolve(null);
+        }
+    });
+}
+function parseShellInfo(raw) {
+    if (!raw)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        const data = parsed?.data;
+        if (!data || typeof data !== 'object')
+            return null;
+        const r = data;
+        if (typeof r.id !== 'string' || !OPENCODE_SHELL_ID.test(r.id))
+            return null;
+        return {
+            id: r.id,
+            status: typeof r.status === 'string' ? r.status : 'unknown',
+            ...(typeof r.command === 'string' ? { command: r.command } : {}),
+            ...(typeof r.cwd === 'string' ? { cwd: r.cwd } : {}),
+            ...(typeof r.pid === 'number' ? { pid: r.pid } : {}),
+            ...(typeof r.exit === 'number' || r.exit === null
+                ? { exit: r.exit }
+                : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** List RUNNING shells for a location (exited shells are not included). */
+async function listOpencodeShells(cwd, timeoutMs = 8_000) {
+    const raw = await runOpencodeApi(buildShellListArgs(cwd), timeoutMs);
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        const rows = Array.isArray(parsed?.data) ? parsed.data : [];
+        return rows
+            .map((row) => {
+            if (!row || typeof row !== 'object')
+                return null;
+            const r = row;
+            if (typeof r.id !== 'string' || !OPENCODE_SHELL_ID.test(r.id))
+                return null;
+            return {
+                id: r.id,
+                status: typeof r.status === 'string' ? r.status : 'unknown',
+                ...(typeof r.command === 'string' ? { command: r.command } : {}),
+                ...(typeof r.cwd === 'string' ? { cwd: r.cwd } : {}),
+                ...(typeof r.pid === 'number' ? { pid: r.pid } : {}),
+                ...(typeof r.exit === 'number' || r.exit === null
+                    ? { exit: r.exit }
+                    : {}),
+            };
+        })
+            .filter((r) => r !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/** Read one shell's status/exit; null when it cannot be read. */
+async function getOpencodeShell(id, cwd, timeoutMs = 5_000) {
+    return parseShellInfo(await runOpencodeApi(buildShellGetArgs(id, cwd), timeoutMs));
+}
+/** Terminate and remove one shell (best-effort). */
+async function removeOpencodeShell(id, cwd, timeoutMs = 5_000) {
+    const raw = await runOpencodeApi(buildShellRemoveArgs(id, cwd), timeoutMs);
+    // DELETE answers 204 with an empty body; execFile's stdout is '' on success.
+    return raw !== null;
+}
+/**
+ * Pure: why a settled shell is a FAILURE, or null when it completed cleanly.
+ * `running` at the deadline is a failure (the work is unresolved), as are
+ * `timeout`/`killed` and any non-zero exit. A shell whose status cannot be
+ * read is a failure too - success is never assumed.
+ */
+function shellFailureReason(info, stillRunning = false) {
+    if (!info)
+        return 'the shell status could not be read';
+    if (stillRunning || info.status === 'running') {
+        return 'still running at the session deadline';
+    }
+    if (info.status === 'timeout' || info.status === 'killed') {
+        return `ended as "${info.status}"`;
+    }
+    if (typeof info.exit === 'number' && info.exit !== 0) {
+        return `exited with code ${info.exit}`;
+    }
+    return null;
+}
+async function settleOpencodeShells(opts) {
+    const waitMs = Math.max(0, opts.waitMs ?? 60_000);
+    const pollMs = Math.max(200, opts.pollMs ?? 1_000);
+    const ids = new Set(opts.ids.filter((id) => OPENCODE_SHELL_ID.test(id)));
+    if (opts.includeRunning) {
+        for (const shell of await listOpencodeShells(opts.cwd)) {
+            if (shell.status === 'running')
+                ids.add(shell.id);
+        }
+    }
+    if (ids.size === 0) {
+        return {
+            ok: true,
+            failures: [],
+            removed: 0,
+            detail: 'no background shells',
+        };
+    }
+    const deadline = Date.now() + waitMs;
+    const finals = new Map();
+    const pending = new Set(ids);
+    while (pending.size > 0 && Date.now() < deadline) {
+        for (const id of [...pending]) {
+            const info = await getOpencodeShell(id, opts.cwd);
+            if (!info) {
+                finals.set(id, null);
+                pending.delete(id);
+                continue;
+            }
+            if (info.status !== 'running') {
+                finals.set(id, info);
+                pending.delete(id);
+            }
+        }
+        if (pending.size === 0)
+            break;
+        await new Promise((resolve) => setTimeout(resolve, pollMs));
+    }
+    const failures = [];
+    for (const id of ids) {
+        const info = finals.get(id) ?? (await getOpencodeShell(id, opts.cwd));
+        const reason = shellFailureReason(info, pending.has(id));
+        if (reason) {
+            const label = info?.command ? `"${info.command.slice(0, 80)}"` : id;
+            failures.push(`${label} ${reason}`);
+        }
+    }
+    let removed = 0;
+    for (const id of ids) {
+        if (await removeOpencodeShell(id, opts.cwd))
+            removed += 1;
+    }
+    const detail = failures.length
+        ? `background shell failure: ${failures.join('; ')}`
+        : `${removed} background shell(s) settled`;
+    opts.log?.(`[harness] ${detail}`, failures.length ? 'stderr' : 'stdout');
+    return { ok: failures.length === 0, failures, removed, detail };
+}
+function buildSubagentListArgs(parentId, cwd) {
+    if (!OPENCODE_SESSION_ID.test(parentId) || !cwd)
+        return null;
+    return [
+        'api',
+        'GET',
+        `/api/session?parentID=${encodeURIComponent(parentId)}&directory=${encodeURIComponent(cwd)}&limit=50`,
+    ];
+}
+function buildSessionMessagesArgs(sessionId, cwd, limit = 10) {
+    if (!OPENCODE_SESSION_ID.test(sessionId) || !cwd)
+        return null;
+    return [
+        'api',
+        'GET',
+        `/api/session/${sessionId}/message?type=assistant&order=desc&limit=${Math.max(1, Math.min(50, limit))}`,
+    ];
+}
+/** Child sessions of a run's main session (subagents). Best-effort. */
+async function listSubagentSessions(parentId, cwd, timeoutMs = 8_000) {
+    const raw = await runOpencodeApi(buildSubagentListArgs(parentId, cwd), timeoutMs);
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        const rows = Array.isArray(parsed?.data) ? parsed.data : [];
+        return rows
+            .map((row) => {
+            if (!row || typeof row !== 'object')
+                return null;
+            const r = row;
+            if (typeof r.id !== 'string' || !OPENCODE_SESSION_ID.test(r.id))
+                return null;
+            return {
+                id: r.id,
+                ...(typeof r.parentID === 'string' ? { parentID: r.parentID } : {}),
+                ...(typeof r.title === 'string' ? { title: r.title } : {}),
+                ...(typeof r.outcome === 'string' ? { outcome: r.outcome } : {}),
+            };
+        })
+            .filter((r) => r !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/** Latest assistant messages of a session, newest page reversed to oldest. */
+async function listSessionMessages(sessionId, cwd, limit = 10, timeoutMs = 8_000) {
+    const raw = await runOpencodeApi(buildSessionMessagesArgs(sessionId, cwd, limit), timeoutMs);
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        const rows = Array.isArray(parsed?.data) ? parsed.data : [];
+        return rows
+            .filter((r) => !!r && typeof r === 'object')
+            .reverse();
+    }
+    catch {
+        return [];
+    }
+}
+/** Human-readable line for a subagent assistant message (text or tool). */
+function formatSubagentMessage(message) {
+    const content = Array.isArray(message.content) ? message.content : [];
+    const parts = [];
+    for (const raw of content) {
+        if (!raw || typeof raw !== 'object')
+            continue;
+        const part = raw;
+        if (part.type === 'text' && typeof part.text === 'string') {
+            const text = part.text.trim();
+            if (text)
+                parts.push(text);
+            continue;
+        }
+        if (part.type === 'tool' && typeof part.name === 'string') {
+            const state = part.state && typeof part.state === 'object'
+                ? part.state
+                : null;
+            const status = state && typeof state.status === 'string' ? state.status : '';
+            const output = state && typeof state.output === 'string'
+                ? state.output.replace(/\s+/g, ' ').trim().slice(0, 300)
+                : '';
+            parts.push(`[tool] ${part.name}${status ? ` ${status}` : ''}${output ? `: ${output}` : ''}`);
+        }
+    }
+    return parts.join(' ').replace(/\s+/g, ' ').trim().slice(0, 2000);
+}
+/**
+ * Interrupt every child session of `parentId` (and any already-known child
+ * ids). Returns the number of children found. Best-effort: a child that
+ * cannot be interrupted is logged, never thrown.
+ */
+async function interruptSubagentSessions(parentId, cwd, knownIds = []) {
+    const ids = new Set(knownIds.filter((id) => OPENCODE_SESSION_ID.test(id)));
+    for (const child of await listSubagentSessions(parentId, cwd)) {
+        ids.add(child.id);
+    }
+    for (const id of ids) {
+        await interruptOpencodeSession(id);
+    }
+    return ids.size;
+}
 //# sourceMappingURL=opencode-control.js.map

package/dist/lib/harness/opencode-control.js.map

@@ -1 +1 @@
-{"version":3,"file":"opencode-control.js","sourceRoot":"","sources":["../../../src/lib/harness/opencode-control.ts"],"names":[],"mappings":";;AAyBA,gEAGC;AAUD,4DA0BC;AAhED;;;;;;;;;;;;;;GAcG;AACH,2DAA8C;AAC9C,uCAAuC;AAEvC,0EAA0E;AAC1E,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAEjD;;;GAGG;AACH,SAAgB,0BAA0B,CAAC,SAAiB;IAC1D,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,SAAS,YAAY,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,wBAAwB,CACtC,SAAiB,EACjB,SAAS,GAAG,MAAM;IAElB,MAAM,IAAI,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,IAAA,oBAAU,EAAC,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC;YACH,IAAA,6BAAQ,EACN,GAAG,CAAC,IAAI,EACR,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,EAC9B,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,EACjE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;gBACd,IAAI,GAAG,EAAE,CAAC;oBACR,OAAO,CAAC,KAAK,CAAC,CAAC;oBACf,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACjE,CAAC,CACF,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"opencode-control.js","sourceRoot":"","sources":["../../../src/lib/harness/opencode-control.ts"],"names":[],"mappings":"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"}

package/dist/lib/harness/opencode-outcome.d.ts

@@ -13,8 +13,21 @@ export declare function probeOpencodeOutcome(sessionId: string): SessionOutcome;
 /**
  * Pure decision: is a non-zero harness exit actually a COMPLETED run?
  *
- * Only opencode has the v2 client/server split. The idle kill (124) is OURS
- * and must stay a failure. Every other harness keeps the classic contract.
+ * 2026-10 POLICY CHANGE: it is NOT. A non-zero client exit always fails the
+ * run, even when the session record says `succeeded`. The probe is kept to
+ * EXPLAIN the failure (and to keep the session record for diagnosis), never
+ * to turn the failure into success.
+ *
+ * WHY: the recovery used to hide two real failures. A backgrounded
+ * `npm run test:run` (service-owned, outliving the CLI) finished with 230
+ * unhandled errors, and a client exit 1 was reported as "recovered" because
+ * the session outcome was `succeeded` - so a run whose verification had
+ * failed was marked complete and moved to review. The git pipeline still
+ * commits work on failure, so nothing is lost; the task is reopened for a
+ * real retry instead of being presented as verified.
+ *
+ * The idle kill (124) is OURS and stays a failure. Other harnesses keep the
+ * classic exit-code contract.
  */
 export declare function decideHarnessExit(input: {
     harness: string;
@@ -22,4 +35,5 @@ export declare function decideHarnessExit(input: {
     outcome: SessionOutcome;
 }): {
     recovered: boolean;
+    detail: string;
 };

package/dist/lib/harness/opencode-outcome.js

@@ -79,14 +79,43 @@ function probeOpencodeOutcome(sessionId) {
 /**
  * Pure decision: is a non-zero harness exit actually a COMPLETED run?
  *
- * Only opencode has the v2 client/server split. The idle kill (124) is OURS
- * and must stay a failure. Every other harness keeps the classic contract.
+ * 2026-10 POLICY CHANGE: it is NOT. A non-zero client exit always fails the
+ * run, even when the session record says `succeeded`. The probe is kept to
+ * EXPLAIN the failure (and to keep the session record for diagnosis), never
+ * to turn the failure into success.
+ *
+ * WHY: the recovery used to hide two real failures. A backgrounded
+ * `npm run test:run` (service-owned, outliving the CLI) finished with 230
+ * unhandled errors, and a client exit 1 was reported as "recovered" because
+ * the session outcome was `succeeded` - so a run whose verification had
+ * failed was marked complete and moved to review. The git pipeline still
+ * commits work on failure, so nothing is lost; the task is reopened for a
+ * real retry instead of being presented as verified.
+ *
+ * The idle kill (124) is OURS and stays a failure. Other harnesses keep the
+ * classic exit-code contract.
  */
 function decideHarnessExit(input) {
-    const recovered = input.harness === 'opencode' &&
-        input.code !== 0 &&
-        input.code !== 124 &&
-        input.outcome === 'succeeded';
-    return { recovered };
+    if (input.harness !== 'opencode' || input.code === 0) {
+        return { recovered: false, detail: '' };
+    }
+    if (input.code === 124) {
+        return {
+            recovered: false,
+            detail: 'the harness was killed after producing no output (idle timeout)',
+        };
+    }
+    if (input.outcome === 'succeeded') {
+        return {
+            recovered: false,
+            detail: 'the opencode client exited non-zero while the session record says succeeded; a non-zero client exit fails the run (work is still committed)',
+        };
+    }
+    return {
+        recovered: false,
+        detail: input.outcome === 'failed'
+            ? 'the opencode session failed'
+            : 'the opencode session outcome could not be read',
+    };
 }
 //# sourceMappingURL=opencode-outcome.js.map

package/dist/lib/harness/opencode-outcome.js.map

@@ -1 +1 @@
-{"version":3,"file":"opencode-outcome.js","sourceRoot":"","sources":["../../../src/lib/harness/opencode-outcome.ts"],"names":[],"mappings":";;AAqCA,kDAUC;AAMD,oDAqBC;AAQD,8CAWC;AA7FD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,2DAA+C;AAC/C,uCAAuC;AAIvC,2EAA2E;AAC3E,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,4EAA4E;AAC5E,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,UAAkB;IACpD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAqC,CAAC;QAC1E,MAAM,OAAO,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;QACtC,IAAI,OAAO,KAAK,WAAW;YAAE,OAAO,WAAW,CAAC;QAChD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,QAAQ,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,SAAiB;IACpD,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,oBAAU,EAAC,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAA,8BAAS,EACnB,GAAG,CAAC,IAAI,EACR,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,EACrD;YACE,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,gBAAgB;YACzB,SAAS,EAAE,gBAAgB;YAC3B,WAAW,EAAE,IAAI;SAClB,CACF,CAAC;QACF,wEAAwE;QACxE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACtD,OAAO,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,KAIjC;IACC,MAAM,SAAS,GACb,KAAK,CAAC,OAAO,KAAK,UAAU;QAC5B,KAAK,CAAC,IAAI,KAAK,CAAC;QAChB,KAAK,CAAC,IAAI,KAAK,GAAG;QAClB,KAAK,CAAC,OAAO,KAAK,WAAW,CAAC;IAChC,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC"}
+{"version":3,"file":"opencode-outcome.js","sourceRoot":"","sources":["../../../src/lib/harness/opencode-outcome.ts"],"names":[],"mappings":";;AAqCA,kDAUC;AAMD,oDAqBC;AAqBD,8CA4BC;AA3HD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,2DAA+C;AAC/C,uCAAuC;AAIvC,2EAA2E;AAC3E,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,4EAA4E;AAC5E,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,UAAkB;IACpD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAqC,CAAC;QAC1E,MAAM,OAAO,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;QACtC,IAAI,OAAO,KAAK,WAAW;YAAE,OAAO,WAAW,CAAC;QAChD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,QAAQ,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,SAAiB;IACpD,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,oBAAU,EAAC,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAA,8BAAS,EACnB,GAAG,CAAC,IAAI,EACR,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,EACrD;YACE,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,gBAAgB;YACzB,SAAS,EAAE,gBAAgB;YAC3B,WAAW,EAAE,IAAI;SAClB,CACF,CAAC;QACF,wEAAwE;QACxE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACtD,OAAO,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,iBAAiB,CAAC,KAIjC;IACC,IAAI,KAAK,CAAC,OAAO,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,iEAAiE;SAC1E,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,MAAM,EACJ,6IAA6I;SAChJ,CAAC;IACJ,CAAC;IACD,OAAO;QACL,SAAS,EAAE,KAAK;QAChB,MAAM,EACJ,KAAK,CAAC,OAAO,KAAK,QAAQ;YACxB,CAAC,CAAC,6BAA6B;YAC/B,CAAC,CAAC,gDAAgD;KACvD,CAAC;AACJ,CAAC"}