agent-mcp-hub 0.5.2

package/dist/exec.js

@@ -0,0 +1,494 @@
+import { spawn } from "node:child_process";
+import { statSync } from "node:fs";
+import { stripAnsi } from "./ansi.js";
+/** Positive finite integer only; NaN/0/negative/non-integer all fall back to `fallback`. */
+function parsePositiveInt(raw, fallback) {
+    const n = Number(raw);
+    return Number.isInteger(n) && n > 0 ? n : fallback;
+}
+/**
+ * TOTAL runtime cap (never reset). Parsed once at module load; override via
+ * MCP_AGENT_TIMEOUT_MS. Raised to 30 min so long PRODUCTIVE runs survive — the
+ * idle timeout, not this, is the fast hung-agent detector.
+ */
+export const DEFAULT_TIMEOUT_MS = parsePositiveInt(process.env.MCP_AGENT_TIMEOUT_MS, 1_800_000);
+/**
+ * IDLE (inactivity) cap: reset on every accepted output chunk. Parsed once at
+ * module load; override via MCP_AGENT_IDLE_TIMEOUT_MS. Generous default so a
+ * slow-but-streaming CLI is not killed mid-work.
+ */
+export const DEFAULT_IDLE_TIMEOUT_MS = parsePositiveInt(process.env.MCP_AGENT_IDLE_TIMEOUT_MS, 300_000);
+export const DEFAULT_MAX_OUTPUT_BYTES = 10 * 1024 * 1024;
+export const DEFAULT_STALL_ATTEMPT_LIMIT = 2;
+export const DEFAULT_STALL_STRIKE_LIMIT = 4;
+/**
+ * Hard ceiling on any single timer (total or idle). Two jobs:
+ *  1. Correctness — `setTimeout` truncates a delay > 2^31-1 ms (~24.8 days) to
+ *     1ms and fires it IMMEDIATELY, so an unclamped huge `timeoutMs` would kill
+ *     the child the instant it starts. 24h is safely under that boundary.
+ *  2. Load-shedding — a single run can hold a concurrency slot for at most 24h,
+ *     so a caller cannot pin all slots for weeks with an enormous `timeoutMs`.
+ */
+export const MAX_TIMEOUT_MS = 24 * 60 * 60 * 1000;
+/** Clamp a caller-supplied timer to [1, MAX_TIMEOUT_MS]; floors non-integers. */
+export function clampTimer(ms) {
+    if (!Number.isFinite(ms))
+        return MAX_TIMEOUT_MS;
+    return Math.min(Math.max(1, Math.floor(ms)), MAX_TIMEOUT_MS);
+}
+/** Positive finite integer only; NaN/0/negative/non-integer all fall back to 4. */
+function parseConcurrency(raw) {
+    return parsePositiveInt(raw, 4);
+}
+/** Non-negative finite integer only; NaN/negative/non-integer all fall back to 100. */
+function parseMaxQueue(raw) {
+    const n = Number(raw);
+    return Number.isInteger(n) && n >= 0 ? n : 100;
+}
+/**
+ * Cap on children spawned concurrently across the process. Parsed once at module
+ * load; override via MCP_MAX_CONCURRENT_AGENTS.
+ */
+export const MAX_CONCURRENT_AGENTS = parseConcurrency(process.env.MCP_MAX_CONCURRENT_AGENTS);
+/**
+ * Thrown when every permit is busy AND the wait queue is already full. Overload
+ * sheds load here instead of growing latency unbounded — the caller retries
+ * later. Surfaces through runCommand → runAdapter → the tool handler's catch as
+ * an `isError` result (the 503-equivalent in the stateless per-request model).
+ */
+export class ServerBusyError extends Error {
+    code = "SERVER_BUSY";
+    constructor() {
+        super("server busy: agent queue full, retry later");
+        this.name = "ServerBusyError";
+    }
+}
+/** Thrown when the child process fails to spawn (binary missing / not on PATH). */
+export class SpawnError extends Error {
+    cause;
+    code = "spawn";
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = "SpawnError";
+    }
+}
+/**
+ * Thrown when `cwd` does not exist (or is not a directory). Checked BEFORE spawn
+ * because both a missing binary and a missing cwd surface as bare ENOENT from
+ * spawn, and collapsing them is actively misleading: a caller passing a repo path
+ * the server cannot see was told "codex was not found on PATH" while codex was
+ * installed and healthy. Distinguishing them up front makes the real fault legible.
+ */
+export class InvalidCwdError extends Error {
+    cwd;
+    code = "invalid_cwd";
+    constructor(cwd) {
+        super(`cwd does not exist or is not a directory: ${cwd}`);
+        this.cwd = cwd;
+        this.name = "InvalidCwdError";
+    }
+}
+/**
+ * Thrown when the child is killed for exceeding a timeout. Carries the bound and
+ * WHICH cap fired: `"idle"` (no output for idleTimeoutMs — likely hung/unreachable)
+ * or `"total"` (exceeded the total runtime cap). `kind` is additive and defaults
+ * to `"total"`, so `new TimeoutError(msg, ms)` call sites are unchanged.
+ */
+export class TimeoutError extends Error {
+    timeoutMs;
+    kind;
+    code = "timeout";
+    constructor(message, timeoutMs, kind = "total") {
+        super(message);
+        this.timeoutMs = timeoutMs;
+        this.kind = kind;
+        this.name = "TimeoutError";
+    }
+}
+/** Thrown when the child is killed for exceeding `maxOutputBytes`. Carries the cap. */
+export class OutputLimitError extends Error {
+    maxOutputBytes;
+    code = "output_limit";
+    constructor(message, maxOutputBytes) {
+        super(message);
+        this.maxOutputBytes = maxOutputBytes;
+        this.name = "OutputLimitError";
+    }
+}
+/**
+ * Thrown when the child is detected as stalled: it prints diagnostic reconnect
+ * phrases on stderr (the adapter's `stallSignatures`) but never produces stdout,
+ * and the attempt/strike counters corroborate that it will not recover. The
+ * process group is killed; the rejection surfaces on `close` so the semaphore
+ * permit is released only after the tree is actually gone.
+ */
+export class AgentStalledError extends Error {
+    signature;
+    strikes;
+    code = "stream_stalled";
+    constructor(message, signature, strikes) {
+        super(message);
+        this.signature = signature;
+        this.strikes = strikes;
+        this.name = "AgentStalledError";
+    }
+}
+/**
+ * Kill an entire process group. Children are spawned `detached`, making each the
+ * leader of its own group, so `process.kill(-pid, …)` reaps the child and every
+ * grandchild it forked. ESRCH (group already gone) is benign. On EPERM or any
+ * other group-kill failure we fall back to killing just the child PID. The whole
+ * kill path is best-effort: it never throws, so it can never mask the
+ * timeout-or-output-limit error being surfaced to the caller.
+ */
+function killGroup(pid, signal, fallback) {
+    if (pid == null)
+        return;
+    try {
+        process.kill(-pid, signal);
+    }
+    catch (err) {
+        if (err.code === "ESRCH")
+            return;
+        try {
+            fallback();
+        }
+        catch {
+            /* swallow: a failed fallback must not mask the original error */
+        }
+    }
+}
+/**
+ * Live children spawned by this module. Children are `detached` (their own group
+ * leaders), so if the server process dies without reaping them, their whole
+ * process tree is orphaned and keeps running. We track every live child and, on
+ * server shutdown, SIGKILL each group.
+ *
+ * Reaping uses the same POSIX `process.kill(-pid)` group kill as the rest of the
+ * module. On a platform without process groups (Windows) that falls back to
+ * killing only the direct child, so a grandchild there could still leak — a
+ * pre-existing limitation of the codebase's POSIX-oriented kill strategy, not of
+ * this reaper. The runtime target is POSIX (unix agent CLIs).
+ */
+const liveChildren = new Set();
+/** SIGKILL a child's whole process group, falling back to the bare child. */
+function killChildGroup(child) {
+    killGroup(child.pid, "SIGKILL", () => child.kill("SIGKILL"));
+}
+/** Best-effort: kill every still-live child's process group. Never throws. */
+export function reapAllChildren() {
+    for (const child of liveChildren) {
+        killChildGroup(child);
+    }
+}
+// Install the shutdown reaper exactly once, lazily on first spawn (so importing
+// this module has no global side effect). `exit` runs synchronously on any exit;
+// the SIGINT/SIGTERM/SIGHUP handlers reap first, remove themselves, then re-raise
+// the signal so the process still terminates with the default disposition.
+let shutdownHandlersInstalled = false;
+function installShutdownReaper() {
+    if (shutdownHandlersInstalled)
+        return;
+    shutdownHandlersInstalled = true;
+    process.once("exit", reapAllChildren);
+    for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+        /* v8 ignore start -- the handler re-raises the signal, which would terminate
+           the test runner; the reap it performs IS covered directly via
+           reapAllChildren() in exec.test.ts. */
+        const handler = () => {
+            reapAllChildren();
+            process.removeListener(sig, handler);
+            process.kill(process.pid, sig);
+        };
+        /* v8 ignore stop */
+        process.on(sig, handler);
+    }
+}
+/**
+ * FIFO async semaphore. `acquire` resolves to a release token that hands the
+ * permit straight to the next waiter (never bumping the count while anyone is
+ * queued) and is idempotent so a double release cannot leak an extra permit.
+ *
+ * The wait queue is bounded: when no permit is free and the queue is already at
+ * `maxQueue()`, `acquire` rejects with `ServerBusyError` BEFORE enqueuing rather
+ * than letting the backlog grow without limit. `maxQueue` is a thunk so the
+ * bound is read per-acquire (keeps the class free of env reads and lets it be
+ * overridden without reloading the module).
+ */
+class Semaphore {
+    permits;
+    waiters = [];
+    maxQueue;
+    constructor(permits, maxQueue) {
+        this.permits = permits;
+        this.maxQueue = maxQueue;
+    }
+    async acquire() {
+        if (this.permits > 0) {
+            this.permits -= 1;
+        }
+        else {
+            if (this.waiters.length >= this.maxQueue()) {
+                throw new ServerBusyError();
+            }
+            await new Promise((resolve) => this.waiters.push(resolve));
+        }
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            const next = this.waiters.shift();
+            if (next)
+                next();
+            else
+                this.permits += 1;
+        };
+    }
+}
+const sem = new Semaphore(MAX_CONCURRENT_AGENTS, () => parseMaxQueue(process.env.MCP_MAX_QUEUE));
+/** Run `fn` holding one semaphore slot; the slot is released on every exit path. */
+async function withSlot(fn) {
+    const release = await sem.acquire();
+    try {
+        return await fn();
+    }
+    finally {
+        release();
+    }
+}
+function isDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+const runCommandInner = (binary, args, opts = {}) => {
+    const timeoutMs = clampTimer(opts.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+    const idleTimeoutMs = clampTimer(opts.idleTimeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS);
+    const maxOutputBytes = opts.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES;
+    const stallSignatures = opts.stallSignatures ?? null;
+    const stallAttemptLimit = opts.stallAttemptLimit ?? DEFAULT_STALL_ATTEMPT_LIMIT;
+    const stallStrikeLimit = opts.stallStrikeLimit ?? DEFAULT_STALL_STRIKE_LIMIT;
+    return new Promise((resolve, reject) => {
+        // Pre-flight the cwd so a missing directory is never mistaken for a missing
+        // binary (spawn reports ENOENT for both). See InvalidCwdError.
+        if (opts.cwd !== undefined && !isDirectory(opts.cwd)) {
+            reject(new InvalidCwdError(opts.cwd));
+            return;
+        }
+        // Build an explicit env only when there is something to strip OR overlay;
+        // otherwise omit the option so the child inherits process.env verbatim
+        // (unchanged behavior). Strip first, then overlay — an `env` override always
+        // wins and is never removed by a later strip key.
+        const stripEnvKeys = opts.stripEnvKeys;
+        const envOverlay = opts.env;
+        let childEnv;
+        if ((stripEnvKeys && stripEnvKeys.length > 0) || envOverlay) {
+            childEnv = { ...process.env };
+            if (stripEnvKeys)
+                for (const key of stripEnvKeys)
+                    delete childEnv[key];
+            if (envOverlay)
+                Object.assign(childEnv, envOverlay);
+        }
+        const child = spawn(binary, args, {
+            cwd: opts.cwd,
+            detached: true,
+            stdio: [opts.input === undefined ? "ignore" : "pipe", "pipe", "pipe"],
+            ...(childEnv ? { env: childEnv } : {}),
+        });
+        liveChildren.add(child);
+        installShutdownReaper();
+        const killTree = () => killChildGroup(child);
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        let outputBytes = 0;
+        // Single terminal cause: first to fire wins, recorded exactly once by
+        // markTerminal so a losing timer can never overwrite it or double-kill.
+        let terminalCause;
+        let settled = false;
+        // Stall detector state (only armed when stallSignatures is non-empty).
+        let stallStrikes = 0;
+        let stallMaxAttempt = 0;
+        let stallNoAttemptStrikes = 0;
+        let stallSignatureLast = "";
+        // Rolling buffer: a data chunk may split a line mid-byte, so we keep the
+        // trailing partial across chunks and only test complete lines.
+        let stderrRemainder = "";
+        // Only stdout bytes count as "productive" — stderr reconnect phrases are
+        // diagnostic noise, not progress toward a model answer.
+        let productiveStdoutBytes = 0;
+        // The TOTAL timer bounds runtime and is NEVER reset. The IDLE timer is reset
+        // on every accepted chunk. Both start after the semaphore slot is acquired,
+        // so the caps bound the child's runtime, not time spent queued behind the cap.
+        let idleTimer;
+        const totalTimer = setTimeout(() => markTerminal({ kind: "total", windowMs: timeoutMs }), timeoutMs);
+        const clearTimers = () => {
+            clearTimeout(totalTimer);
+            clearTimeout(idleTimer);
+        };
+        // Single guarded terminal path: first cause to fire wins, records the cause,
+        // stops BOTH timers, then kills the tree. Idempotent — a second call (losing
+        // timer, or a race with settle) is a no-op, so no double-kill / overwrite.
+        function markTerminal(cause) {
+            /* v8 ignore next -- unreachable: clearTimers() cancels the losing timer before it can fire, so markTerminal runs at most once (settled/terminalCause never true on entry) */
+            if (settled || terminalCause)
+                return;
+            terminalCause = cause;
+            clearTimers();
+            killTree();
+        }
+        idleTimer = setTimeout(() => markTerminal({ kind: "idle", windowMs: idleTimeoutMs }), idleTimeoutMs);
+        if (opts.input !== undefined) {
+            // Swallow EPIPE if the child exits before reading its stdin.
+            child.stdin?.on("error", () => { });
+            child.stdin?.write(opts.input);
+            child.stdin?.end();
+        }
+        // Test a complete stderr line against the stall signatures. Returns the
+        // matched signature text (already stripped/trimmed) or undefined.
+        const testStallLine = (line) => {
+            if (!stallSignatures || stallSignatures.length === 0)
+                return undefined;
+            const stripped = stripAnsi(line).trim();
+            if (stripped.length === 0)
+                return undefined;
+            for (const re of stallSignatures) {
+                if (re.test(stripped))
+                    return stripped;
+            }
+            return undefined;
+        };
+        // Parse an attempt number out of a stall line, e.g. "… (attempt 1)…" → 1.
+        // Returns undefined when no attempt number is present.
+        const parseAttempt = (line) => {
+            const m = /attempt\D{0,10}(\d+)/i.exec(line);
+            return m ? Number(m[1]) : undefined;
+        };
+        const track = (chunk, sink, isStdout) => {
+            if (terminalCause)
+                return;
+            outputBytes += chunk.length;
+            if (outputBytes > maxOutputBytes) {
+                // Stop accumulating and drop what we captured: memory must not keep
+                // growing between the breach and the child actually dying. The fatal
+                // breach chunk is NOT activity — it neither re-arms idle nor fires a
+                // heartbeat right before the kill.
+                markTerminal({ kind: "output", maxOutputBytes });
+                stdoutChunks.length = 0;
+                stderrChunks.length = 0;
+                return;
+            }
+            if (isStdout) {
+                sink.push(chunk);
+                productiveStdoutBytes += chunk.length;
+                // ACCEPTED stdout chunk: this counts as progress. Fire the (synchronous)
+                // activity hook and reset the idle window from now.
+                opts.onActivity?.();
+                clearTimeout(idleTimer);
+                idleTimer = setTimeout(() => markTerminal({ kind: "idle", windowMs: idleTimeoutMs }), idleTimeoutMs);
+                return;
+            }
+            // stderr path.
+            if (stallSignatures && stallSignatures.length > 0) {
+                // Append to the rolling buffer and split on newlines. Keep the trailing
+                // partial so a line straddling two chunks is reassembled intact.
+                stderrRemainder += chunk.toString("utf8");
+                const lines = stderrRemainder.split("\n");
+                // The last element is the partial (may be empty if chunk ended on \n).
+                stderrRemainder = lines.pop() ?? "";
+                let matchedInBatch = false;
+                for (const line of lines) {
+                    const sig = testStallLine(line);
+                    if (sig === undefined)
+                        continue;
+                    matchedInBatch = true;
+                    stallStrikes += 1;
+                    stallSignatureLast = sig;
+                    const attempt = parseAttempt(sig);
+                    if (attempt !== undefined) {
+                        stallMaxAttempt = Math.max(stallMaxAttempt, attempt);
+                    }
+                    else {
+                        // Only attempt-less signatures feed the raw-strike fallback, so a
+                        // legitimate reconnect that keeps resetting to "attempt 1" cannot
+                        // masquerade as escalating failure.
+                        stallNoAttemptStrikes += 1;
+                    }
+                }
+                if (matchedInBatch) {
+                    // A stall line is NOT activity: sink the bytes but never re-arm idle.
+                    sink.push(chunk);
+                    if (productiveStdoutBytes === 0 &&
+                        (stallMaxAttempt >= stallAttemptLimit || stallNoAttemptStrikes >= stallStrikeLimit)) {
+                        markTerminal({
+                            kind: "stall",
+                            signature: stallSignatureLast,
+                            strikes: stallStrikes,
+                        });
+                    }
+                    return;
+                }
+                // No stall line matched — treat as ordinary activity (existing behavior).
+                sink.push(chunk);
+                opts.onActivity?.();
+                clearTimeout(idleTimer);
+                idleTimer = setTimeout(() => markTerminal({ kind: "idle", windowMs: idleTimeoutMs }), idleTimeoutMs);
+                return;
+            }
+            // No stall signatures armed: stderr behaves like stdout for activity.
+            sink.push(chunk);
+            opts.onActivity?.();
+            clearTimeout(idleTimer);
+            idleTimer = setTimeout(() => markTerminal({ kind: "idle", windowMs: idleTimeoutMs }), idleTimeoutMs);
+        };
+        child.stdout?.on("data", (chunk) => track(chunk, stdoutChunks, true));
+        child.stderr?.on("data", (chunk) => track(chunk, stderrChunks, false));
+        child.on("error", (err) => {
+            clearTimers();
+            liveChildren.delete(child);
+            if (settled)
+                return;
+            settled = true;
+            reject(new SpawnError(`Failed to start "${binary}": ${err.message}. Is it installed and on PATH?`, err));
+        });
+        child.on("close", (code) => {
+            clearTimers();
+            liveChildren.delete(child);
+            if (settled)
+                return;
+            settled = true;
+            if (terminalCause) {
+                if (terminalCause.kind === "output") {
+                    // Never echo the captured bytes back — only the limit that was breached.
+                    reject(new OutputLimitError(`"${binary}" exceeded output limit of ${terminalCause.maxOutputBytes} bytes`, terminalCause.maxOutputBytes));
+                    return;
+                }
+                if (terminalCause.kind === "idle") {
+                    reject(new TimeoutError(`"${binary}" produced no output for ${terminalCause.windowMs}ms (idle) — it may be hung or its model/backend is unreachable`, terminalCause.windowMs, "idle"));
+                    return;
+                }
+                if (terminalCause.kind === "total") {
+                    reject(new TimeoutError(`"${binary}" timed out after ${timeoutMs}ms (total runtime cap)`, timeoutMs, "total"));
+                    return;
+                }
+                if (terminalCause.kind === "stall") {
+                    reject(new AgentStalledError(`"${binary}" stalled: detected diagnostic reconnect pattern — "${terminalCause.signature}" (strike ${terminalCause.strikes}). The agent cannot complete a run in this environment (common cause: TLS-intercepting proxy). Treat this agent as unavailable until the network path is fixed.`, terminalCause.signature, terminalCause.strikes));
+                    return;
+                }
+                return;
+            }
+            resolve({
+                stdout: Buffer.concat(stdoutChunks).toString("utf8"),
+                stderr: Buffer.concat(stderrChunks).toString("utf8"),
+                exitCode: code,
+            });
+        });
+    });
+};
+export const runCommand = (binary, args, opts) => withSlot(() => runCommandInner(binary, args, opts));
+//# sourceMappingURL=exec.js.map

package/dist/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AA6DtC,4FAA4F;AAC5F,SAAS,gBAAgB,CAAC,GAAuB,EAAE,QAAgB;IACjE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;AAEhG;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAgB,CACrD,OAAO,CAAC,GAAG,CAAC,yBAAyB,EACrC,OAAO,CACR,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAElD,iFAAiF;AACjF,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,cAAc,CAAC;IAChD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;AAC/D,CAAC;AAED,mFAAmF;AACnF,SAAS,gBAAgB,CAAC,GAAuB;IAC/C,OAAO,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,uFAAuF;AACvF,SAAS,aAAa,CAAC,GAAuB;IAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAE7F;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,GAAG,aAAa,CAAC;IAC9B;QACE,KAAK,CAAC,4CAA4C,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,mFAAmF;AACnF,MAAM,OAAO,UAAW,SAAQ,KAAK;IAIxB;IAHF,IAAI,GAAG,OAAO,CAAC;IACxB,YACE,OAAe,EACN,KAAe;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,UAAK,GAAL,KAAK,CAAU;QAGxB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAEnB;IADZ,IAAI,GAAG,aAAa,CAAC;IAC9B,YAAqB,GAAW;QAC9B,KAAK,CAAC,6CAA6C,GAAG,EAAE,CAAC,CAAC;QADvC,QAAG,GAAH,GAAG,CAAQ;QAE9B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAI1B;IACA;IAJF,IAAI,GAAG,SAAS,CAAC;IAC1B,YACE,OAAe,EACN,SAAiB,EACjB,OAAyB,OAAO;QAEzC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,cAAS,GAAT,SAAS,CAAQ;QACjB,SAAI,GAAJ,IAAI,CAA4B;QAGzC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,uFAAuF;AACvF,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAI9B;IAHF,IAAI,GAAG,cAAc,CAAC;IAC/B,YACE,OAAe,EACN,cAAsB;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,mBAAc,GAAd,cAAc,CAAQ;QAG/B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAI/B;IACA;IAJF,IAAI,GAAG,gBAAgB,CAAC;IACjC,YACE,OAAe,EACN,SAAiB,EACjB,OAAe;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,cAAS,GAAT,SAAS,CAAQ;QACjB,YAAO,GAAP,OAAO,CAAQ;QAGxB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,GAAuB,EAAE,MAAsB,EAAE,QAAoB;IACtF,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO;IACxB,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO;QAC5D,IAAI,CAAC;YACH,QAAQ,EAAE,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACP,iEAAiE;QACnE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,EAAgB,CAAC;AAE7C,6EAA6E;AAC7E,SAAS,cAAc,CAAC,KAAmB;IACzC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,eAAe;IAC7B,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,cAAc,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,iFAAiF;AACjF,kFAAkF;AAClF,2EAA2E;AAC3E,IAAI,yBAAyB,GAAG,KAAK,CAAC;AACtC,SAAS,qBAAqB;IAC5B,IAAI,yBAAyB;QAAE,OAAO;IACtC,yBAAyB,GAAG,IAAI,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,EAAE,CAAC;QAC3D;;gDAEwC;QACxC,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,eAAe,EAAE,CAAC;YAClB,OAAO,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC,CAAC;QACF,oBAAoB;QACpB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,SAAS;IACL,OAAO,CAAS;IACP,OAAO,GAAsB,EAAE,CAAC;IAChC,QAAQ,CAAe;IAExC,YAAY,OAAe,EAAE,QAAsB;QACjD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;gBAC3C,MAAM,IAAI,eAAe,EAAE,CAAC;YAC9B,CAAC;YACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,IAAI;gBAAE,IAAI,EAAE,CAAC;;gBACZ,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QACzB,CAAC,CAAC;IACJ,CAAC;CACF;AAED,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;AAEjG,oFAAoF;AACpF,KAAK,UAAU,QAAQ,CAAI,EAAoB;IAC7C,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAgBD,MAAM,eAAe,GAAS,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE;IACxD,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,IAAI,kBAAkB,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,aAAa,IAAI,uBAAuB,CAAC,CAAC;IAChF,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,wBAAwB,CAAC;IACvE,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC;IACrD,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,IAAI,2BAA2B,CAAC;IAChF,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;IAC7E,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACjD,4EAA4E;QAC5E,+DAA+D;QAC/D,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QACD,0EAA0E;QAC1E,uEAAuE;QACvE,6EAA6E;QAC7E,kDAAkD;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC;QAC5B,IAAI,QAAuC,CAAC;QAC5C,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC;YAC5D,QAAQ,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAC9B,IAAI,YAAY;gBAAE,KAAK,MAAM,GAAG,IAAI,YAAY;oBAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;YACvE,IAAI,UAAU;gBAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE;YAChC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YACrE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvC,CAAC,CAAC;QACH,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxB,qBAAqB,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAE7C,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,sEAAsE;QACtE,wEAAwE;QACxE,IAAI,aAAwC,CAAC;QAC7C,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,uEAAuE;QACvE,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,qBAAqB,GAAG,CAAC,CAAC;QAC9B,IAAI,kBAAkB,GAAG,EAAE,CAAC;QAC5B,yEAAyE;QACzE,+DAA+D;QAC/D,IAAI,eAAe,GAAG,EAAE,CAAC;QACzB,yEAAyE;QACzE,wDAAwD;QACxD,IAAI,qBAAqB,GAAG,CAAC,CAAC;QAE9B,6EAA6E;QAC7E,4EAA4E;QAC5E,+EAA+E;QAC/E,IAAI,SAAyB,CAAC;QAC9B,MAAM,UAAU,GAAG,UAAU,CAC3B,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAC1D,SAAS,CACV,CAAC;QAEF,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,YAAY,CAAC,UAAU,CAAC,CAAC;YACzB,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC,CAAC;QAEF,6EAA6E;QAC7E,6EAA6E;QAC7E,2EAA2E;QAC3E,SAAS,YAAY,CAAC,KAAoB;YACxC,6KAA6K;YAC7K,IAAI,OAAO,IAAI,aAAa;gBAAE,OAAO;YACrC,aAAa,GAAG,KAAK,CAAC;YACtB,WAAW,EAAE,CAAC;YACd,QAAQ,EAAE,CAAC;QACb,CAAC;QAED,SAAS,GAAG,UAAU,CACpB,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,EAC7D,aAAa,CACd,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,6DAA6D;YAC7D,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;QACrB,CAAC;QAED,wEAAwE;QACxE,kEAAkE;QAClE,MAAM,aAAa,GAAG,CAAC,IAAY,EAAsB,EAAE;YACzD,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC;YACvE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC5C,KAAK,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;gBACjC,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;oBAAE,OAAO,QAAQ,CAAC;YACzC,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC;QAEF,0EAA0E;QAC1E,uDAAuD;QACvD,MAAM,YAAY,GAAG,CAAC,IAAY,EAAsB,EAAE;YACxD,MAAM,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtC,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,IAAc,EAAE,QAAiB,EAAE,EAAE;YACjE,IAAI,aAAa;gBAAE,OAAO;YAC1B,WAAW,IAAI,KAAK,CAAC,MAAM,CAAC;YAC5B,IAAI,WAAW,GAAG,cAAc,EAAE,CAAC;gBACjC,oEAAoE;gBACpE,qEAAqE;gBACrE,qEAAqE;gBACrE,mCAAmC;gBACnC,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;gBACjD,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;gBACxB,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;gBACxB,OAAO;YACT,CAAC;YAED,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACjB,qBAAqB,IAAI,KAAK,CAAC,MAAM,CAAC;gBACtC,yEAAyE;gBACzE,oDAAoD;gBACpD,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;gBACpB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,SAAS,GAAG,UAAU,CACpB,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,EAC7D,aAAa,CACd,CAAC;gBACF,OAAO;YACT,CAAC;YAED,eAAe;YACf,IAAI,eAAe,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClD,wEAAwE;gBACxE,iEAAiE;gBACjE,eAAe,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC1C,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1C,uEAAuE;gBACvE,eAAe,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBACpC,IAAI,cAAc,GAAG,KAAK,CAAC;gBAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;oBAChC,IAAI,GAAG,KAAK,SAAS;wBAAE,SAAS;oBAChC,cAAc,GAAG,IAAI,CAAC;oBACtB,YAAY,IAAI,CAAC,CAAC;oBAClB,kBAAkB,GAAG,GAAG,CAAC;oBACzB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;oBAClC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;wBAC1B,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;oBACvD,CAAC;yBAAM,CAAC;wBACN,kEAAkE;wBAClE,kEAAkE;wBAClE,oCAAoC;wBACpC,qBAAqB,IAAI,CAAC,CAAC;oBAC7B,CAAC;gBACH,CAAC;gBACD,IAAI,cAAc,EAAE,CAAC;oBACnB,sEAAsE;oBACtE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACjB,IACE,qBAAqB,KAAK,CAAC;wBAC3B,CAAC,eAAe,IAAI,iBAAiB,IAAI,qBAAqB,IAAI,gBAAgB,CAAC,EACnF,CAAC;wBACD,YAAY,CAAC;4BACX,IAAI,EAAE,OAAO;4BACb,SAAS,EAAE,kBAAkB;4BAC7B,OAAO,EAAE,YAAY;yBACtB,CAAC,CAAC;oBACL,CAAC;oBACD,OAAO;gBACT,CAAC;gBACD,0EAA0E;gBAC1E,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACjB,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;gBACpB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,SAAS,GAAG,UAAU,CACpB,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,EAC7D,aAAa,CACd,CAAC;gBACF,OAAO;YACT,CAAC;YAED,sEAAsE;YACtE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjB,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YACpB,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,UAAU,CACpB,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,EAC7D,aAAa,CACd,CAAC;QACJ,CAAC,CAAC;QAEF,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9E,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;QAE/E,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,WAAW,EAAE,CAAC;YACd,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,CACJ,IAAI,UAAU,CACZ,oBAAoB,MAAM,MAAM,GAAG,CAAC,OAAO,gCAAgC,EAC3E,GAAG,CACJ,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,WAAW,EAAE,CAAC;YACd,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,aAAa,EAAE,CAAC;gBAClB,IAAI,aAAa,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACpC,yEAAyE;oBACzE,MAAM,CACJ,IAAI,gBAAgB,CAClB,IAAI,MAAM,8BAA8B,aAAa,CAAC,cAAc,QAAQ,EAC5E,aAAa,CAAC,cAAc,CAC7B,CACF,CAAC;oBACF,OAAO;gBACT,CAAC;gBACD,IAAI,aAAa,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAClC,MAAM,CACJ,IAAI,YAAY,CACd,IAAI,MAAM,4BAA4B,aAAa,CAAC,QAAQ,gEAAgE,EAC5H,aAAa,CAAC,QAAQ,EACtB,MAAM,CACP,CACF,CAAC;oBACF,OAAO;gBACT,CAAC;gBACD,IAAI,aAAa,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBACnC,MAAM,CACJ,IAAI,YAAY,CACd,IAAI,MAAM,qBAAqB,SAAS,wBAAwB,EAChE,SAAS,EACT,OAAO,CACR,CACF,CAAC;oBACF,OAAO;gBACT,CAAC;gBACD,IAAI,aAAa,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBACnC,MAAM,CACJ,IAAI,iBAAiB,CACnB,IAAI,MAAM,uDAAuD,aAAa,CAAC,SAAS,aAAa,aAAa,CAAC,OAAO,iKAAiK,EAC3R,aAAa,CAAC,SAAS,EACvB,aAAa,CAAC,OAAO,CACtB,CACF,CAAC;oBACF,OAAO;gBACT,CAAC;gBACD,OAAO;YACT,CAAC;YACD,OAAO,CAAC;gBACN,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACpD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACpD,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAS,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CACrD,QAAQ,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC"}

package/dist/failure.d.ts

@@ -0,0 +1,27 @@
+import { type ExecResult } from "./exec.js";
+export { stripAnsi } from "./ansi.js";
+/** Lowercased, ANSI-free view of `s` used for phrase matching (never shown). */
+export declare function normalize(s: string): string;
+export type FailureCode = "not_installed" | "invalid_cwd" | "not_authenticated" | "not_configured" | "timed_out" | "output_limit" | "stream_stalled" | "server_busy" | "tool_failure";
+/** Static per-adapter remediation metadata (the pure subset classification needs). */
+interface AdapterMeta {
+    name: string;
+    loginCommand: string;
+    apiKeyEnv?: string;
+}
+/** What the caller supplies: exactly one of a rejected error OR a resolved result. */
+interface Outcome {
+    result?: ExecResult;
+    error?: unknown;
+}
+export interface FailureClassification {
+    code: FailureCode;
+    message: string;
+}
+/**
+ * Map any agent failure to a stable `{ code, message }` with clean, ANSI-free,
+ * actionable text. Pure — no I/O. Precedence (R3): the error branch (classified
+ * by TYPE) takes priority over the result branch; within the result branch,
+ * overload → auth → config → generic tool_failure.
+ */
+export declare function classifyFailure(adapter: AdapterMeta, outcome: Outcome): FailureClassification;