@chances-ai/engine 24.0.0

package/dist/agents/parse.js

@@ -0,0 +1,527 @@
+/**
+ * Hand-rolled frontmatter+body parser for agent definitions. We deliberately
+ * do NOT pull in a YAML library:
+ *
+ * - The schema is fixed and tiny (six fields). A grammar we own is easier to
+ *   reason about than a YAML subset that quietly accepts surprising shapes.
+ * - `tools` and `disallowedTools` are security boundaries — codex Round 1
+ *   (`docs/3.3-design.md` finding #1, #5) ruled out the "fall back to CSV if
+ *   strict parse fails" pattern. We reject ambiguous syntax explicitly.
+ * - Cold-start budget — no extra npm dep crossing the 120 ms binary bar.
+ *
+ * The grammar is documented in `docs/3.3-design.md` under "Frontmatter
+ * grammar". Anything that doesn't match the spec is a labeled
+ * `bad-frontmatter`; that label flows up to the discovery loop's
+ * `SkippedAgent`.
+ */
+/** Maximum file size accepted before we even read the body (codex-#15). */
+export const MAX_AGENT_FILE_BYTES = 64 * 1024;
+/** Hard ceiling on `maxTurns`; values above this clamp down. Matches the
+ * subagent v1 ceiling (`packages/core/src/task-tool.ts`). */
+const MAX_TURNS_CEILING = 50;
+/** Names the model would conflate with tool names if used as agent identifiers
+ * (codex-#9). Tool names are an open set today (plugins, MCP), so we
+ * additionally reject the `mcp__` and `memory_` prefixes by predicate, not
+ * just the literal members of this set. */
+export const RESERVED_AGENT_NAMES = new Set([
+    "task",
+    "default",
+    "read",
+    "write",
+    "edit",
+    "bash",
+    "grep",
+    "glob",
+    "diff",
+    "web_fetch",
+    "memory_save",
+    "memory_delete",
+    "memory_list",
+]);
+/** Frontmatter fields reserved for future versions; using them in 3.3 is a
+ * configuration error so we surface an actionable message rather than
+ * silently ignoring (codex-#13). Pre-claiming the names lets 3.4–3.x.later
+ * introduce them without a compatibility break.
+ *
+ * **Case-sensitive** (codex Round-2 SHOULD-FIX #3): the names below are the
+ * exact spellings users must NOT use. `Spawns:` would land in the
+ * unknown-field branch rather than the reserved branch — that's correct;
+ * neither is accepted. */
+const RESERVED_FRONTMATTER_FIELDS = new Set([
+    "spawns",
+    "mcpServers",
+    "requiredMcpServers",
+    "hooks",
+    "memory",
+    "permissionMode",
+    "effort",
+    "thinkingLevel",
+    // `isolation` is now a real field as of 4.1 — see KNOWN_FIELDS.
+    "background",
+    "color",
+    "initialPrompt",
+    "output",
+    "blocking",
+]);
+/** Exact case-sensitive set of supported fields. `Tools` is NOT a synonym
+ * for `tools`; the parser surfaces it as `bad-frontmatter` "unknown field". */
+const KNOWN_FIELDS = new Set([
+    "name",
+    "description",
+    "tools",
+    "disallowedTools",
+    "model",
+    "maxTurns",
+    // (4.1) Worktree isolation. `isolation: worktree | none`. Default
+    // `none`. Round-1 MUST-FIX #2 made the MCP filter the load-bearing
+    // behaviour; `unsafeAllowMutatingMcp: true` (deliberately-loud name)
+    // opts out of it.
+    "isolation",
+    "unsafeAllowMutatingMcp",
+]);
+/** Valid values for the `isolation` frontmatter field. Round-1 codex-#5
+ * fail-closed pattern: unknown values are surfaced as `invalid-field`,
+ * not silently accepted. */
+const ISOLATION_VALUES = new Set(["worktree", "none"]);
+const NAME_RE = /^[a-z][a-z0-9_-]{0,63}$/;
+// Keys may include uppercase so camelCase field names like `maxTurns` and
+// `disallowedTools` are accepted — but lookup is **case-sensitive against
+// the literal field name** (codex Round-2 SHOULD-FIX #3). `Tools: []` and
+// `MaxTurns: 5` are rejected as unknown fields rather than silently treated
+// as their lowercase counterparts; this catches typos that previously would
+// have changed the effective allowlist meaning.
+const KEY_RE = /^[A-Za-z][A-Za-z0-9_-]*$/;
+const BARE_TOKEN_RE = /^[a-z_][a-z0-9_-]*$/;
+const INT_RE = /^\d+$/;
+/**
+ * Parse a single agent markdown file's raw text. The caller is responsible
+ * for enforcing the byte cap (`MAX_AGENT_FILE_BYTES`) before reading the
+ * file; this function operates on already-decoded UTF-16 strings.
+ */
+export function parseAgentFile(raw) {
+    // CRLF normalization so a Windows-authored file behaves like a POSIX one
+    // (codex-#2). `\r\n` and `\r` both collapse to `\n`.
+    const text = raw.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+    // The opening `---` must be the first non-empty line. Leading blank lines
+    // are tolerated (a stray newline at file head is human-easy to introduce).
+    const lines = text.split("\n");
+    let firstNonBlank = 0;
+    while (firstNonBlank < lines.length && lines[firstNonBlank].trim() === "") {
+        firstNonBlank++;
+    }
+    if (firstNonBlank >= lines.length || lines[firstNonBlank] !== "---") {
+        return fail("bad-frontmatter", "missing or malformed opening `---` delimiter");
+    }
+    // Find the closing `---`. A line whose trimmed value is exactly `---` ends
+    // the frontmatter; everything after is the body.
+    let closeIdx = -1;
+    for (let i = firstNonBlank + 1; i < lines.length; i++) {
+        if (lines[i].trim() === "---") {
+            closeIdx = i;
+            break;
+        }
+    }
+    if (closeIdx < 0)
+        return fail("bad-frontmatter", "missing closing `---` delimiter");
+    const fmLines = lines.slice(firstNonBlank + 1, closeIdx);
+    const body = lines
+        .slice(closeIdx + 1)
+        .join("\n")
+        .replace(/^\n+/, "")
+        .replace(/\s+$/g, "");
+    if (body.length === 0) {
+        return fail("missing-body", "agent body is empty after trimming; 3.3 requires a non-empty system prompt");
+    }
+    // Parse each frontmatter line as `key: value`. Comments (lines whose first
+    // non-space char is `#`) and blank lines are skipped. **Any tab in a
+    // non-comment frontmatter line is `bad-frontmatter`** (codex Round-2
+    // SHOULD-FIX #2 — the prior check only covered tabs in the key portion,
+    // so `tools:\t[read]` slipped through and produced a result that didn't
+    // match the strict grammar).
+    const fm = {};
+    for (const rawLine of fmLines) {
+        if (rawLine.length === 0)
+            continue;
+        if (/^[ \t]*$/.test(rawLine))
+            continue;
+        const trimmed = rawLine.replace(/^[ ]+/, "");
+        if (trimmed.startsWith("#"))
+            continue;
+        if (rawLine.includes("\t")) {
+            return fail("bad-frontmatter", "tab character in frontmatter line — use spaces (tabs are not part of the agent-file grammar)");
+        }
+        const colon = trimmed.indexOf(":");
+        if (colon < 0) {
+            return fail("bad-frontmatter", `frontmatter line missing colon: "${rawLine}"`);
+        }
+        const key = trimmed.slice(0, colon);
+        if (!KEY_RE.test(key)) {
+            return fail("bad-frontmatter", `invalid frontmatter key: "${key}"`);
+        }
+        // Case-sensitive lookup (codex Round-2 SHOULD-FIX #3). `Tools` is NOT
+        // a synonym for `tools` — surfacing the typo as "unknown field" is
+        // better than silently mapping it to a security-relevant field name.
+        if (RESERVED_FRONTMATTER_FIELDS.has(key)) {
+            return fail("reserved-field", `'${key}' is reserved for a future release; remove from this file or upgrade chances-cli`);
+        }
+        if (!KNOWN_FIELDS.has(key)) {
+            return fail("bad-frontmatter", `unknown frontmatter field: "${key}"`);
+        }
+        if (Object.prototype.hasOwnProperty.call(fm, key)) {
+            return fail("bad-frontmatter", `duplicate frontmatter field: "${key}"`);
+        }
+        fm[key] = trimmed.slice(colon + 1).trim();
+    }
+    // Required: name, description, tools (codex-#5/#17/#18: tools is REQUIRED).
+    if (fm["name"] === undefined)
+        return fail("missing-required-field", "missing 'name'");
+    if (fm["description"] === undefined)
+        return fail("missing-required-field", "missing 'description'");
+    if (fm["tools"] === undefined)
+        return fail("missing-required-field", "missing 'tools' (required since 3.3 — use `tools: *` to inherit the parent's full surface, or a bracketed list)");
+    // name: strict slug + reserved-name rejection.
+    const nameVal = parseStringScalar(fm["name"]);
+    if (nameVal.kind === "err")
+        return fail("bad-frontmatter", `name: ${nameVal.detail}`);
+    if (!NAME_RE.test(nameVal.value)) {
+        return fail("invalid-field", `name '${nameVal.value}' must match ${NAME_RE} (lowercase ASCII, start with a letter)`);
+    }
+    if (RESERVED_AGENT_NAMES.has(nameVal.value)) {
+        return fail("reserved-name", `name '${nameVal.value}' is reserved`);
+    }
+    if (nameVal.value.startsWith("mcp__") || nameVal.value.startsWith("memory_")) {
+        return fail("reserved-name", `name '${nameVal.value}' uses a reserved prefix (mcp__/memory_)`);
+    }
+    // description: any single-line string. We don't truncate here — the render
+    // path in the task tool does that — so the file's literal content is
+    // preserved for `/agents`. We DO reject embedded newlines because the
+    // grammar above only emits single-line values anyway.
+    const descVal = parseStringScalar(fm["description"]);
+    if (descVal.kind === "err")
+        return fail("bad-frontmatter", `description: ${descVal.detail}`);
+    if (descVal.value.length === 0)
+        return fail("invalid-field", "description is empty after parsing");
+    // tools: either the literal `*` or a bracketed list. CSV is NOT accepted
+    // (codex-#1: bare-CSV would be ambiguous; require an explicit shape).
+    const toolsVal = parseToolsField(fm["tools"]);
+    if (toolsVal.kind === "err")
+        return fail("bad-frontmatter", `tools: ${toolsVal.detail}`);
+    // disallowedTools: optional, must be a bracketed list when present.
+    let disallowed = [];
+    if (fm["disallowedTools"] !== undefined) {
+        const d = parseListField(fm["disallowedTools"]);
+        if (d.kind === "err")
+            return fail("bad-frontmatter", `disallowedTools: ${d.detail}`);
+        disallowed = d.value;
+    }
+    // model: optional; bare string or quoted scalar.
+    let model;
+    if (fm["model"] !== undefined) {
+        const m = parseStringScalar(fm["model"]);
+        if (m.kind === "err")
+            return fail("bad-frontmatter", `model: ${m.detail}`);
+        if (m.value.length === 0)
+            return fail("invalid-field", "model is empty after parsing");
+        model = m.value;
+    }
+    // maxTurns: optional positive integer, clamped to ceiling.
+    let maxTurns;
+    if (fm["maxTurns"] !== undefined) {
+        const raw = fm["maxTurns"].trim();
+        if (!INT_RE.test(raw)) {
+            return fail("invalid-field", `maxTurns must be a positive integer (got '${raw}'); decimals and scientific notation are rejected`);
+        }
+        const n = Number(raw);
+        if (!Number.isFinite(n) || n < 1) {
+            return fail("invalid-field", `maxTurns must be >= 1 (got ${raw})`);
+        }
+        maxTurns = Math.min(n, MAX_TURNS_CEILING);
+    }
+    // (4.1) isolation: optional `worktree` | `none`. Stored as the strict
+    // string `"worktree"` when set; absent / `none` collapses to
+    // `undefined` so downstream code can do a single existence check.
+    let isolation;
+    if (fm["isolation"] !== undefined) {
+        const raw = fm["isolation"].trim();
+        if (!ISOLATION_VALUES.has(raw)) {
+            return fail("invalid-field", `isolation must be one of: ${[...ISOLATION_VALUES].join(", ")} (got '${raw}')`);
+        }
+        if (raw === "worktree")
+            isolation = "worktree";
+    }
+    // (4.1) unsafeAllowMutatingMcp: optional boolean. Loud name is the
+    // documentation surface; we still parse case-sensitively as `true` /
+    // `false`.
+    let unsafeAllowMutatingMcp;
+    if (fm["unsafeAllowMutatingMcp"] !== undefined) {
+        const raw = fm["unsafeAllowMutatingMcp"].trim();
+        if (raw !== "true" && raw !== "false") {
+            return fail("invalid-field", `unsafeAllowMutatingMcp must be exactly 'true' or 'false' (got '${raw}')`);
+        }
+        unsafeAllowMutatingMcp = raw === "true";
+    }
+    return {
+        ok: true,
+        agent: {
+            name: nameVal.value,
+            description: descVal.value,
+            systemPrompt: body,
+            tools: toolsVal.value,
+            disallowedTools: disallowed,
+            model,
+            maxTurns,
+            isolation,
+            unsafeAllowMutatingMcp,
+        },
+    };
+}
+function fail(reason, detail) {
+    return { ok: false, failure: { reason, detail } };
+}
+/** Parse a single value as either a bare string, a single-quoted scalar, or a
+ * double-quoted scalar. Bracketed `[` here is invalid — fields that accept
+ * lists use `parseListField` instead. Internal `:` is part of the value
+ * (so `model: anthropic/foo:bar` round-trips). */
+function parseStringScalar(raw) {
+    const s = raw.trim();
+    if (s.startsWith("[")) {
+        return { kind: "err", detail: "expected scalar, got bracketed list" };
+    }
+    if (s.startsWith("'"))
+        return parseSingleQuoted(s);
+    if (s.startsWith('"'))
+        return parseDoubleQuoted(s);
+    // Bare scalar — the verbatim trimmed string. Internal characters are part
+    // of the value. We DO reject anything that looks like an unclosed quote
+    // sneaking through (a leading `'` already triggered the quoted branch
+    // above, but a stray `"` mid-value is a footgun worth catching).
+    return { kind: "ok", value: s };
+}
+function parseSingleQuoted(s) {
+    if (!s.startsWith("'"))
+        return { kind: "err", detail: "expected single quote" };
+    let i = 1;
+    let out = "";
+    while (i < s.length) {
+        const ch = s[i];
+        if (ch === "'") {
+            // Embedded `''` escapes a single quote.
+            if (s[i + 1] === "'") {
+                out += "'";
+                i += 2;
+                continue;
+            }
+            // Terminator. Anything after (other than whitespace) is an error.
+            const tail = s.slice(i + 1).trim();
+            if (tail.length > 0) {
+                return { kind: "err", detail: `trailing text after single-quoted scalar: "${tail}"` };
+            }
+            return { kind: "ok", value: out };
+        }
+        out += ch;
+        i += 1;
+    }
+    return { kind: "err", detail: "unterminated single-quoted scalar" };
+}
+function parseDoubleQuoted(s) {
+    if (!s.startsWith('"'))
+        return { kind: "err", detail: "expected double quote" };
+    let i = 1;
+    let out = "";
+    while (i < s.length) {
+        const ch = s[i];
+        if (ch === "\\") {
+            const next = s[i + 1];
+            if (next === '"') {
+                out += '"';
+                i += 2;
+                continue;
+            }
+            if (next === "\\") {
+                out += "\\";
+                i += 2;
+                continue;
+            }
+            if (next === "n") {
+                out += "\n";
+                i += 2;
+                continue;
+            }
+            return {
+                kind: "err",
+                detail: `unsupported escape '\\${next ?? ""}' in double-quoted scalar`,
+            };
+        }
+        if (ch === '"') {
+            const tail = s.slice(i + 1).trim();
+            if (tail.length > 0) {
+                return { kind: "err", detail: `trailing text after double-quoted scalar: "${tail}"` };
+            }
+            return { kind: "ok", value: out };
+        }
+        out += ch;
+        i += 1;
+    }
+    return { kind: "err", detail: "unterminated double-quoted scalar" };
+}
+function parseToolsField(raw) {
+    const s = raw.trim();
+    // Only bare `*` is the inherit-all sentinel. Quoted `'*'` / `"*"` are
+    // **rejected** (codex Round-2 MUST-FIX #1) — accepting them as the
+    // sentinel was an over-helpful inference that silently changed the
+    // effective allowlist meaning for a typo. The bracketed `['*']` case
+    // is handled below.
+    if (s === "*")
+        return { kind: "ok", value: "*" };
+    if (s === "'*'" || s === '"*"') {
+        return {
+            kind: "err",
+            detail: "quoted `'*'` is not the inherit-all sentinel; use bare `tools: *` (no quotes)",
+        };
+    }
+    const list = parseListField(s);
+    if (list.kind === "err")
+        return list;
+    // Reject `*` as a list element. A user writing `tools: ['*']` thinking it
+    // means "inherit all" would otherwise get a confusing fail-closed
+    // "Unknown tool '*'" at execute time (because no real tool is named `*`).
+    // Catch the intent at parse time and tell them how to spell it.
+    if (list.value.includes("*")) {
+        return {
+            kind: "err",
+            detail: "`*` is not a valid tool name inside a list; to inherit all parent tools, use `tools: *` (no brackets, no quotes)",
+        };
+    }
+    return { kind: "ok", value: list.value };
+}
+/** Parse a bracketed list `[a, b]`. Tokens may be bare slugs (relaxed regex —
+ * tool names like `web_fetch` exist) or quoted scalars. Trailing commas,
+ * nested lists, and unterminated brackets are all rejected. Duplicate
+ * tokens are silently deduped (honest mistake, not a security flaw). */
+function parseListField(raw) {
+    const s = raw.trim();
+    if (!s.startsWith("[")) {
+        return {
+            kind: "err",
+            detail: `expected bracketed list (e.g. '[read, glob]'); got "${s}"`,
+        };
+    }
+    if (!s.endsWith("]")) {
+        return { kind: "err", detail: "unterminated bracketed list (missing ']')" };
+    }
+    const inner = s.slice(1, -1).trim();
+    if (inner.length === 0)
+        return { kind: "ok", value: [] };
+    const tokens = [];
+    let i = 0;
+    let expectComma = false;
+    while (i < inner.length) {
+        // Skip whitespace.
+        while (i < inner.length && inner[i] === " ")
+            i++;
+        if (i >= inner.length)
+            break;
+        if (expectComma) {
+            if (inner[i] !== ",") {
+                return {
+                    kind: "err",
+                    detail: `expected ',' or ']' after token; got '${inner[i]}'`,
+                };
+            }
+            i += 1;
+            expectComma = false;
+            // After consuming the comma, the next iter expects a token.
+            // A trailing comma manifests as no more tokens before `]`.
+            while (i < inner.length && inner[i] === " ")
+                i++;
+            if (i >= inner.length) {
+                return { kind: "err", detail: "trailing comma in list" };
+            }
+            continue;
+        }
+        const ch = inner[i];
+        if (ch === "[") {
+            return { kind: "err", detail: "nested lists are not allowed" };
+        }
+        if (ch === "'" || ch === '"') {
+            const { token, next, err } = consumeQuoted(inner, i, ch);
+            if (err)
+                return { kind: "err", detail: err };
+            tokens.push(token);
+            i = next;
+            expectComma = true;
+            continue;
+        }
+        // Bare token.
+        const start = i;
+        while (i < inner.length && inner[i] !== "," && inner[i] !== " ") {
+            if (inner[i] === "[" || inner[i] === "]") {
+                return { kind: "err", detail: `unexpected '${inner[i]}' in list token` };
+            }
+            i += 1;
+        }
+        const tok = inner.slice(start, i);
+        if (!BARE_TOKEN_RE.test(tok)) {
+            return { kind: "err", detail: `invalid bare list token: '${tok}'` };
+        }
+        tokens.push(tok);
+        expectComma = true;
+    }
+    // Dedupe while preserving order.
+    const seen = new Set();
+    const out = [];
+    for (const t of tokens) {
+        if (seen.has(t))
+            continue;
+        seen.add(t);
+        out.push(t);
+    }
+    return { kind: "ok", value: out };
+}
+function consumeQuoted(src, start, quote) {
+    let i = start + 1;
+    let out = "";
+    while (i < src.length) {
+        const ch = src[i];
+        if (quote === "'") {
+            if (ch === "'") {
+                if (src[i + 1] === "'") {
+                    out += "'";
+                    i += 2;
+                    continue;
+                }
+                return { token: out, next: i + 1 };
+            }
+            out += ch;
+            i += 1;
+            continue;
+        }
+        // Double quoted.
+        if (ch === "\\") {
+            const next = src[i + 1];
+            if (next === '"') {
+                out += '"';
+                i += 2;
+                continue;
+            }
+            if (next === "\\") {
+                out += "\\";
+                i += 2;
+                continue;
+            }
+            if (next === "n") {
+                out += "\n";
+                i += 2;
+                continue;
+            }
+            return { next: i, err: `unsupported escape '\\${next ?? ""}'` };
+        }
+        if (ch === '"') {
+            return { token: out, next: i + 1 };
+        }
+        out += ch;
+        i += 1;
+    }
+    return { next: i, err: `unterminated ${quote === "'" ? "single" : "double"}-quoted token` };
+}
+//# sourceMappingURL=parse.js.map

package/dist/agents/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/agents/parse.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C;6DAC6D;AAC7D,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B;;;2CAG2C;AAC3C,MAAM,CAAC,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC;IAC/D,MAAM;IACN,SAAS;IACT,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,WAAW;IACX,aAAa;IACb,eAAe;IACf,aAAa;CACd,CAAC,CAAC;AAEH;;;;;;;;0BAQ0B;AAC1B,MAAM,2BAA2B,GAAwB,IAAI,GAAG,CAAC;IAC/D,QAAQ;IACR,YAAY;IACZ,oBAAoB;IACpB,OAAO;IACP,QAAQ;IACR,gBAAgB;IAChB,QAAQ;IACR,eAAe;IACf,gEAAgE;IAChE,YAAY;IACZ,OAAO;IACP,eAAe;IACf,QAAQ;IACR,UAAU;CACX,CAAC,CAAC;AAEH;+EAC+E;AAC/E,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC;IAChD,MAAM;IACN,aAAa;IACb,OAAO;IACP,iBAAiB;IACjB,OAAO;IACP,UAAU;IACV,kEAAkE;IAClE,mEAAmE;IACnE,qEAAqE;IACrE,kBAAkB;IAClB,WAAW;IACX,wBAAwB;CACzB,CAAC,CAAC;AAEH;;4BAE4B;AAC5B,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAE5E,MAAM,OAAO,GAAG,yBAAyB,CAAC;AAC1C,0EAA0E;AAC1E,0EAA0E;AAC1E,0EAA0E;AAC1E,4EAA4E;AAC5E,4EAA4E;AAC5E,gDAAgD;AAChD,MAAM,MAAM,GAAG,0BAA0B,CAAC;AAC1C,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAC5C,MAAM,MAAM,GAAG,OAAO,CAAC;AA+BvB;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,yEAAyE;IACzE,qDAAqD;IACrD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAE7D,0EAA0E;IAC1E,2EAA2E;IAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,OAAO,aAAa,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,aAAa,CAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3E,aAAa,EAAE,CAAC;IAClB,CAAC;IACD,IAAI,aAAa,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,KAAK,KAAK,EAAE,CAAC;QACpE,OAAO,IAAI,CAAC,iBAAiB,EAAE,8CAA8C,CAAC,CAAC;IACjF,CAAC;IAED,2EAA2E;IAC3E,iDAAiD;IACjD,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,aAAa,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtD,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;YAC/B,QAAQ,GAAG,CAAC,CAAC;YACb,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,iBAAiB,EAAE,iCAAiC,CAAC,CAAC;IAEpF,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,KAAK;SACf,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC;SACnB,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAExB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CACT,cAAc,EACd,4EAA4E,CAC7E,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,qEAAqE;IACrE,qEAAqE;IACrE,wEAAwE;IACxE,wEAAwE;IACxE,6BAA6B;IAC7B,MAAM,EAAE,GAA2B,EAAE,CAAC;IACtC,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,SAAS;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC7C,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACtC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CACT,iBAAiB,EACjB,8FAA8F,CAC/F,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,iBAAiB,EAAE,oCAAoC,OAAO,GAAG,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,iBAAiB,EAAE,6BAA6B,GAAG,GAAG,CAAC,CAAC;QACtE,CAAC;QACD,sEAAsE;QACtE,mEAAmE;QACnE,qEAAqE;QACrE,IAAI,2BAA2B,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CACT,gBAAgB,EAChB,IAAI,GAAG,kFAAkF,CAC1F,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,iBAAiB,EAAE,+BAA+B,GAAG,GAAG,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;YAClD,OAAO,IAAI,CAAC,iBAAiB,EAAE,iCAAiC,GAAG,GAAG,CAAC,CAAC;QAC1E,CAAC;QACD,EAAE,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,4EAA4E;IAC5E,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,CAAC;IACtF,IAAI,EAAE,CAAC,aAAa,CAAC,KAAK,SAAS;QACjC,OAAO,IAAI,CAAC,wBAAwB,EAAE,uBAAuB,CAAC,CAAC;IACjE,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,SAAS;QAC3B,OAAO,IAAI,CACT,wBAAwB,EACxB,iHAAiH,CAClH,CAAC;IAEJ,+CAA+C;IAC/C,MAAM,OAAO,GAAG,iBAAiB,CAAC,EAAE,CAAC,MAAM,CAAE,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC,iBAAiB,EAAE,SAAS,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CACT,eAAe,EACf,SAAS,OAAO,CAAC,KAAK,gBAAgB,OAAO,yCAAyC,CACvF,CAAC;IACJ,CAAC;IACD,IAAI,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,eAAe,EAAE,SAAS,OAAO,CAAC,KAAK,eAAe,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7E,OAAO,IAAI,CACT,eAAe,EACf,SAAS,OAAO,CAAC,KAAK,0CAA0C,CACjE,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,qEAAqE;IACrE,sEAAsE;IACtE,sDAAsD;IACtD,MAAM,OAAO,GAAG,iBAAiB,CAAC,EAAE,CAAC,aAAa,CAAE,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC,iBAAiB,EAAE,gBAAgB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7F,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAC5B,OAAO,IAAI,CAAC,eAAe,EAAE,oCAAoC,CAAC,CAAC;IAErE,yEAAyE;IACzE,sEAAsE;IACtE,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,CAAC,OAAO,CAAE,CAAC,CAAC;IAC/C,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC,iBAAiB,EAAE,UAAU,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAEzF,oEAAoE;IACpE,IAAI,UAAU,GAAa,EAAE,CAAC;IAC9B,IAAI,EAAE,CAAC,iBAAiB,CAAC,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,cAAc,CAAC,EAAE,CAAC,iBAAiB,CAAE,CAAC,CAAC;QACjD,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK;YAClB,OAAO,IAAI,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC;IACvB,CAAC;IAED,iDAAiD;IACjD,IAAI,KAAyB,CAAC;IAC9B,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,iBAAiB,CAAC,EAAE,CAAC,OAAO,CAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,eAAe,EAAE,8BAA8B,CAAC,CAAC;QACvF,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAClB,CAAC;IAED,2DAA2D;IAC3D,IAAI,QAA4B,CAAC;IACjC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,EAAE,CAAC,UAAU,CAAE,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,CACT,eAAe,EACf,6CAA6C,GAAG,mDAAmD,CACpG,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,eAAe,EAAE,8BAA8B,GAAG,GAAG,CAAC,CAAC;QACrE,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAC5C,CAAC;IAED,sEAAsE;IACtE,6DAA6D;IAC7D,kEAAkE;IAClE,IAAI,SAAiC,CAAC;IACtC,IAAI,EAAE,CAAC,WAAW,CAAC,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAE,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CACT,eAAe,EACf,6BAA6B,CAAC,GAAG,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAC/E,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,KAAK,UAAU;YAAE,SAAS,GAAG,UAAU,CAAC;IACjD,CAAC;IAED,mEAAmE;IACnE,qEAAqE;IACrE,WAAW;IACX,IAAI,sBAA2C,CAAC;IAChD,IAAI,EAAE,CAAC,wBAAwB,CAAC,KAAK,SAAS,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,EAAE,CAAC,wBAAwB,CAAE,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACtC,OAAO,IAAI,CACT,eAAe,EACf,kEAAkE,GAAG,IAAI,CAC1E,CAAC;QACJ,CAAC;QACD,sBAAsB,GAAG,GAAG,KAAK,MAAM,CAAC;IAC1C,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,KAAK,EAAE;YACL,IAAI,EAAE,OAAO,CAAC,KAAK;YACnB,WAAW,EAAE,OAAO,CAAC,KAAK;YAC1B,YAAY,EAAE,IAAI;YAClB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,eAAe,EAAE,UAAU;YAC3B,KAAK;YACL,QAAQ;YACR,SAAS;YACT,sBAAsB;SACvB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,MAAkB,EAAE,MAAc;IAC9C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;AACpD,CAAC;AAUD;;;kDAGkD;AAClD,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,qCAAqC,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACnD,0EAA0E;IAC1E,wEAAwE;IACxE,sEAAsE;IACtE,iEAAiE;IACjE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAS;IAClC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAChF,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACjB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,wCAAwC;YACxC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBACrB,GAAG,IAAI,GAAG,CAAC;gBACX,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,kEAAkE;YAClE,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,8CAA8C,IAAI,GAAG,EAAE,CAAC;YACxF,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACpC,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;QACV,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,mCAAmC,EAAE,CAAC;AACtE,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAS;IAClC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAChF,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACjB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACtB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,GAAG,IAAI,GAAG,CAAC;gBACX,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,GAAG,IAAI,IAAI,CAAC;gBACZ,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,GAAG,IAAI,IAAI,CAAC;gBACZ,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,MAAM,EAAE,yBAAyB,IAAI,IAAI,EAAE,2BAA2B;aACvE,CAAC;QACJ,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,8CAA8C,IAAI,GAAG,EAAE,CAAC;YACxF,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACpC,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;QACV,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,mCAAmC,EAAE,CAAC;AACtE,CAAC;AAKD,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,sEAAsE;IACtE,mEAAmE;IACnE,mEAAmE;IACnE,qEAAqE;IACrE,oBAAoB;IACpB,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACjD,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;QAC/B,OAAO;YACL,IAAI,EAAE,KAAK;YACX,MAAM,EACJ,+EAA+E;SAClF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACrC,0EAA0E;IAC1E,kEAAkE;IAClE,0EAA0E;IAC1E,gEAAgE;IAChE,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,KAAK;YACX,MAAM,EACJ,kHAAkH;SACrH,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;AAC3C,CAAC;AAKD;;;wEAGwE;AACxE,SAAS,cAAc,CAAC,GAAW;IACjC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,uDAAuD,CAAC,GAAG;SACpE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,2CAA2C,EAAE,CAAC;IAC9E,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAEzD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,mBAAmB;QACnB,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM;YAAE,MAAM;QAC7B,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBACrB,OAAO;oBACL,IAAI,EAAE,KAAK;oBACX,MAAM,EAAE,yCAAyC,KAAK,CAAC,CAAC,CAAC,GAAG;iBAC7D,CAAC;YACJ,CAAC;YACD,CAAC,IAAI,CAAC,CAAC;YACP,WAAW,GAAG,KAAK,CAAC;YACpB,4DAA4D;YAC5D,2DAA2D;YAC3D,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;gBAAE,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACtB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;YAC3D,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACrB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAC;QACjE,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC7B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACzD,IAAI,GAAG;gBAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,KAAM,CAAC,CAAC;YACpB,CAAC,GAAG,IAAI,CAAC;YACT,WAAW,GAAG,IAAI,CAAC;YACnB,SAAS;QACX,CAAC;QACD,cAAc;QACd,MAAM,KAAK,GAAG,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAChE,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBACzC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,KAAK,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC;YAC3E,CAAC;YACD,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;QACD,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,6BAA6B,GAAG,GAAG,EAAE,CAAC;QACtE,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;IACD,iCAAiC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QAC1B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,aAAa,CACpB,GAAW,EACX,KAAa,EACb,KAAgB;IAEhB,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IAClB,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QACnB,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAClB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBACvB,GAAG,IAAI,GAAG,CAAC;oBACX,CAAC,IAAI,CAAC,CAAC;oBACP,SAAS;gBACX,CAAC;gBACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,CAAC;YACD,GAAG,IAAI,EAAE,CAAC;YACV,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,iBAAiB;QACjB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACxB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,GAAG,IAAI,GAAG,CAAC;gBACX,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,GAAG,IAAI,IAAI,CAAC;gBACZ,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,GAAG,IAAI,IAAI,CAAC;gBACZ,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,yBAAyB,IAAI,IAAI,EAAE,GAAG,EAAE,CAAC;QAClE,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;QACV,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,gBAAgB,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,eAAe,EAAE,CAAC;AAC9F,CAAC"}

package/dist/agents/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Public type surface for the agent catalog. Discovery returns the maps;
+ * the task tool reads them at execute time. Kept in a separate module from
+ * the parser so consumers can import the types without pulling parser code
+ * into bundles that don't need it.
+ */
+export type AgentSource = "project" | "user" | "bundled";
+export interface AgentDefinition {
+    name: string;
+    description: string;
+    /** Body of the markdown file, trimmed. Becomes the child's `systemBaseOverride`. */
+    systemPrompt: string;
+    /**
+     * Resolved at execute time, NOT at discovery. `"*"` means "inherit parent's
+     * full tool surface (minus `task` for the recursion block)". An array means
+     * exactly these tool names — every entry must resolve in the parent's
+     * registry at execute time or the task call fails closed.
+     */
+    tools: string[] | "*";
+    /** Applied AFTER `tools`. Same fail-closed semantics as `tools`. */
+    disallowedTools: string[];
+    /** Looked up via `ModelRegistry.get`; unknown id fails closed at execute. */
+    model?: string;
+    /** Already clamped to `[1, 50]` at parse time. */
+    maxTurns?: number;
+    /** (4.1) `"worktree"` opts the spawned subagent into a git-worktree
+     * sandbox; `undefined` keeps it in the parent's workspace (the 3.x
+     * default). Source-of-truth for the `task` tool's resolution chain
+     * (input override > frontmatter > undefined). */
+    isolation?: "worktree";
+    /** (4.1) Opts out of the default MCP-mutating-tool filter that
+     * applies to isolated subagents (Round-1 MUST-FIX #2). Loud name is
+     * the documentation surface. Default `false` / `undefined`. */
+    unsafeAllowMutatingMcp?: boolean;
+    source: AgentSource;
+    /** Absolute path; surfaced in `/agents` and skipped-entry diagnostics. */
+    sourcePath: string;
+}
+/** Why a file was excluded from the catalog. Kept as a string-literal union
+ * so callers (logger, slash command) can pattern-match without an enum
+ * import. */
+export type SkipReason = "bad-frontmatter" | "missing-required-field" | "missing-body" | "invalid-field" | "reserved-name" | "reserved-field" | "duplicate-across-source" | "duplicate-within-source" | "file-read-error" | "file-too-large" | "file-too-many";
+export interface SkippedAgent {
+    path: string;
+    reason: SkipReason;
+    detail: string;
+}
+export interface DiscoveredAgents {
+    agents: ReadonlyMap<string, AgentDefinition>;
+    skipped: readonly SkippedAgent[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACtB,oEAAoE;IACpE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;qDAGiD;IACjD,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB;;mEAE+D;IAC/D,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;aAEa;AACb,MAAM,MAAM,UAAU,GAClB,iBAAiB,GACjB,wBAAwB,GACxB,cAAc,GACd,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,yBAAyB,GACzB,yBAAyB,GACzB,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;CAClC"}

package/dist/agents/types.js

@@ -0,0 +1,8 @@
+/**
+ * Public type surface for the agent catalog. Discovery returns the maps;
+ * the task tool reads them at execute time. Kept in a separate module from
+ * the parser so consumers can import the types without pulling parser code
+ * into bundles that don't need it.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/ai/adapters/ai-sdk-stream.d.ts

@@ -0,0 +1,19 @@
+import type { ChatRequest, ProviderEvent } from "../types.js";
+/**
+ * Streams a chat request through any Vercel AI SDK language model. Both
+ * {@link AiSdkAdapter} (native @ai-sdk/* providers) and
+ * {@link OpenAICompatibleAdapter} (createOpenAICompatible-backed providers)
+ * call into this so the normalization → ProviderEvent mapping lives in one
+ * place.
+ *
+ * `model` is typed as `unknown` because the AI SDK module is dynamic-imported
+ * and we don't pin its type surface here; callers pass through whatever
+ * `streamText({ model })` accepts at their installed version.
+ *
+ * `loadAi` is a test-only seam — the adapters thread their own
+ * `__loadSdkModuleForTest` through it so an end-to-end test can drive the
+ * streaming-error redaction path without depending on the real `ai`
+ * package's internals. Production callers omit it and pay one `import("ai")`.
+ */
+export declare function streamFromAiSdk(model: unknown, req: ChatRequest, signal: AbortSignal, loadAi?: () => Promise<unknown>): AsyncIterable<ProviderEvent>;
+//# sourceMappingURL=ai-sdk-stream.d.ts.map

package/dist/ai/adapters/ai-sdk-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk-stream.d.ts","sourceRoot":"","sources":["../../../src/ai/adapters/ai-sdk-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAwB,aAAa,EAAE,MAAM,aAAa,CAAC;AAmDpF;;;;;;;;;;;;;;;GAeG;AACH,wBAAuB,eAAe,CACpC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACnB,MAAM,GAAE,MAAM,OAAO,CAAC,OAAO,CAAsB,GAClD,aAAa,CAAC,aAAa,CAAC,CAwE9B"}