@chances-ai/engine 24.0.0

package/dist/tools/builtins/pty.js

@@ -0,0 +1,536 @@
+/**
+ * (5.1) `pty` — interactive bidirectional PTY tool.
+ *
+ * Op-enum surface (mirrors 4.2 LSP pattern):
+ *   start | write | read | resize | kill | interrupt | adopt | list
+ *
+ * Per-op permission via `Tool.permission(args, ctx)` hook (5.1 API
+ * surface change). Each op returns either:
+ *   - a `PermissionRequest` with a per-op `cacheKey` (`start` re-prompts
+ *     per `(command, cwd, shell, env)`; `kill` per `(session_id, signal)`;
+ *     `write` per `(session_id, sha256(line))` for command-class input,
+ *     etc.), or
+ *   - `null` to bypass the gate entirely (`read`, `resize`, `list`).
+ *
+ * Codex Round-1 MUST-FIX #3 — `write` containing `\n`/`\r`/control bytes
+ * is "command-class" input that executes a line in the underlying
+ * shell/REPL; re-prompt required.
+ *
+ * Codex Round-1 MUST-FIX #7 — `start` permission summary includes
+ * resolved `cwd`, allowlisted `shell` (or rejected with `PTY_BAD_SHELL`),
+ * and non-default env keys (values redacted past 8 chars).
+ *
+ * Codex Round-1 Q4/Q7 — shell allowlist + dedicated `interrupt` op
+ * (separate gate from `kill`).
+ */
+import { createHash } from "node:crypto";
+import { basename, isAbsolute } from "node:path";
+import { AppError, ErrorCode, createId } from "@chances-ai/runtime";
+import { optNum, optStr, preview, str } from "./_shared.js";
+// ---------------------------------------------------------------------------
+// Shell allowlist
+/** Built-in allowlist by basename. Matches the design D4 table verbatim.
+ * Codex Round-1 Q4 / MUST-FIX #7. */
+const BUILTIN_SHELL_ALLOWLIST = new Set([
+    "sh",
+    "bash",
+    "zsh",
+    "fish",
+    "dash",
+    "cmd",
+    "cmd.exe",
+    "powershell",
+    "powershell.exe",
+    "pwsh",
+    "pwsh.exe",
+]);
+function isShellAllowed(shell, userExtra) {
+    // (5.1 codex Round-2 MUST-FIX #4) — reject relative-path forms
+    // outright. `./bash` or `subdir/bash` would otherwise pass the
+    // basename check, letting a model execute a workspace-resident
+    // binary disguised as `bash`. Accept ONLY:
+    //   - a bare basename in the built-in allowlist (resolved through
+    //     PATH by the shell spawn), OR
+    //   - an absolute path explicitly allowlisted by the user.
+    const looksLikePath = shell.includes("/") || shell.includes("\\");
+    if (looksLikePath) {
+        if (!isAbsolute(shell))
+            return false;
+        return userExtra.includes(shell);
+    }
+    return BUILTIN_SHELL_ALLOWLIST.has(shell.toLowerCase());
+}
+// ---------------------------------------------------------------------------
+// Per-op cache key helpers
+function startCacheKey(command, cwd, shell, env) {
+    const sortedEnv = Object.keys(env).sort().map((k) => `${k}=${env[k]}`).join("\x00");
+    const h = createHash("sha256").update(`${command}\x01${cwd}\x01${shell}\x01${sortedEnv}`).digest("hex");
+    return `pty.start/${h.slice(0, 16)}`;
+}
+function writeExecCacheKey(sessionId, line) {
+    const h = createHash("sha256").update(line).digest("hex").slice(0, 8);
+    return `pty.write.exec/${sessionId}:${h}`;
+}
+function killCacheKey(sessionId, signal) {
+    return `pty.kill.${signal}/${sessionId}`;
+}
+function interruptCacheKey(sessionId) {
+    return `pty.interrupt/${sessionId}`;
+}
+function adoptCacheKey(sessionId) {
+    return `pty.adopt/${sessionId}`;
+}
+// ---------------------------------------------------------------------------
+// Safe-write classifier
+/** "Safe-write" = short input AND no command-execution byte
+ * (`\n` / `\r` / C0 except `\t`/`\b`). Codex Round-1 MUST-FIX #3 /
+ * Q1 — newline-terminated input executes a line in the underlying
+ * shell/REPL and is treated as command-class, requiring re-prompt. */
+function isSafeWrite(input) {
+    if (input.length > 256)
+        return false;
+    for (let i = 0; i < input.length; i++) {
+        const c = input.charCodeAt(i);
+        if (c === 0x0a || c === 0x0d)
+            return false; // \n or \r
+        if (c < 0x20 && c !== 0x09 && c !== 0x08)
+            return false; // C0 except tab/backspace
+        if (c === 0x7f)
+            return false; // DEL
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Permission summary helpers
+function envDiff(env) {
+    const out = [];
+    for (const [k, v] of Object.entries(env)) {
+        if (process.env[k] === v)
+            continue;
+        out.push({ key: k, redactedValue: redactValue(v) });
+    }
+    return out.sort((a, b) => a.key.localeCompare(b.key));
+}
+function redactValue(v) {
+    if (v.length <= 8)
+        return "***";
+    return `${v.slice(0, 4)}…${v.slice(-2)}`;
+}
+function startSummary(command, cwd, shell, env) {
+    const cmdHead = command.length > 80 ? command.slice(0, 80) + "…" : command;
+    const envParts = envDiff(env);
+    const lines = [`pty start: ${cmdHead}`, `  cwd: ${cwd}`, `  shell: ${shell}`];
+    if (envParts.length > 0) {
+        const envFormatted = envParts.map((e) => `${e.key}=${e.redactedValue}`).join(", ");
+        lines.push(`  env: ${envFormatted}`);
+    }
+    return lines.join("\n");
+}
+function writeSummary(sessionInfo, input) {
+    const head = sessionInfo?.command ?? "<unknown session>";
+    return `pty write to ${head}: ${preview(input)}`;
+}
+function killSummary(sessionInfo, signal) {
+    const head = sessionInfo?.command ?? "<unknown session>";
+    return `pty kill ${signal}: ${head}`;
+}
+function interruptSummary(sessionInfo) {
+    const head = sessionInfo?.command ?? "<unknown session>";
+    return `pty interrupt (SIGINT): ${head}`;
+}
+function adoptSummary(sessionInfo) {
+    const head = sessionInfo?.command ?? "<unknown session>";
+    return `pty adopt subagent session: ${head}`;
+}
+const VALID_OPS = new Set([
+    "start",
+    "write",
+    "read",
+    "resize",
+    "kill",
+    "interrupt",
+    "adopt",
+    "list",
+]);
+function parseOp(args) {
+    if (!args || typeof args !== "object" || Array.isArray(args)) {
+        throw new AppError(ErrorCode.Tool, "pty: expected an object with an `op` field");
+    }
+    const rec = args;
+    const op = rec.op;
+    if (typeof op !== "string" || !VALID_OPS.has(op)) {
+        throw new AppError(ErrorCode.Tool, `pty: unknown op '${String(op)}'. Expected one of: ${[...VALID_OPS].join(", ")}`);
+    }
+    return { op: op, args: rec };
+}
+export function createPtyTool(deps) {
+    // (5.1 codex Round-2 follow-up to MUST-FIX #4) Default shell is the
+    // BARE basename — Round-2 tightened `isShellAllowed` to reject any
+    // path-like value not on the user allowlist, so the prior default
+    // of `/bin/sh` would self-reject. Bare `sh` resolves via PATH at
+    // spawn time, which is what we want anyway; the operator can
+    // override via `deps.defaultShell` when running in a sandbox where
+    // PATH won't surface a usable shell.
+    const defaultShell = deps.defaultShell ?? (process.platform === "win32" ? "cmd.exe" : "sh");
+    const userExtra = deps.shellAllowlistExtra ?? [];
+    function resolveStartConfig(args) {
+        const command = str(args, "command");
+        // (5.1 codex Round-2 MUST-FIX #3) Default to the per-engine
+        // `defaultCwd` when set — for isolated subagents this is the
+        // worktree path, so a `pty.start({command: "pwd"})` runs inside
+        // the worktree rather than against the parent checkout.
+        const cwd = optStr(args, "cwd") ?? deps.defaultCwd ?? deps.workspaceRoot;
+        const shell = optStr(args, "shell") ?? defaultShell;
+        const cols = optNum(args, "cols");
+        const rows = optNum(args, "rows");
+        if (!isShellAllowed(shell, userExtra)) {
+            return {
+                error: `PTY_BAD_SHELL: shell '${shell}' is not in the allowlist. Built-in allowlist: ${[...BUILTIN_SHELL_ALLOWLIST].sort().join(", ")}. User allowlist (absolute paths) via 'config.pty.shellAllowlist'.`,
+            };
+        }
+        const envRaw = args["env"];
+        let env = {};
+        if (envRaw && typeof envRaw === "object" && !Array.isArray(envRaw)) {
+            for (const [k, v] of Object.entries(envRaw)) {
+                if (typeof v !== "string") {
+                    return { error: `PTY_BAD_ARGS: env value for '${k}' must be a string` };
+                }
+                env[k] = v;
+            }
+        }
+        else if (envRaw !== undefined && envRaw !== null) {
+            return { error: `PTY_BAD_ARGS: 'env' must be an object of string→string` };
+        }
+        return { command, cwd, shell, env, cols, rows };
+    }
+    function lookupInfo(sessionId) {
+        // Use `list(agentId)` so D10 isolation is respected — model only
+        // gets to see commands for sessions it owns.
+        for (const s of deps.registry.list(deps.agentId)) {
+            if (s.sessionId === sessionId)
+                return s;
+        }
+        return undefined;
+    }
+    const description = [
+        "Drive a long-lived shell session. Use this when a command requires interactive input (REPL prompts, sudo password, dev-server tail, `python -i`, `psql`).",
+        "",
+        "Ops (pass as { op: ..., ... }):",
+        "- start({command, cwd?, cols?, rows?, shell?, env?}) → {session_id, first_chunk?, state}. Requires `shell` permission. Permission prompt includes resolved cwd, shell, and any non-default env keys.",
+        "- read({session_id, since?, timeout_ms?}) → {chunks: [{seq, text}], state, exit_code?, dropped?, truncated?, next_since?, persisted_path?}. Polls up to timeout_ms (default 1000, max 5000). Per-call cleaned-text payload capped at 30 KB; overflow persisted to .chances/tool-results/<callId>/pty.txt.",
+        "- write({session_id, input}) → {ok}. Write to stdin. Re-prompts when input contains newline/CR/control bytes (it's then command-class input that executes a line).",
+        "- resize({session_id, cols, rows}) → {ok}. SIGWINCH-equiv. Returns PTY_NO_PTY under pipe-fallback.",
+        "- interrupt({session_id}) → {ok}. Send SIGINT (operator Ctrl-C). Re-prompts.",
+        "- kill({session_id, signal?}) → {ok}. Default SIGTERM; pass 'SIGKILL' for hard kill. Re-prompts per signal — SIGTERM approval does NOT pre-approve SIGKILL.",
+        "- adopt({session_id}) → {ok}. Parent claims ownership of a subagent's session so it survives the subagent's exit. Re-prompts.",
+        "- list() → {sessions: [{session_id, command, cwd, shell, started_at, state, exit_code?}]}. Returns only sessions owned by you.",
+    ].join("\n");
+    const tool = {
+        name: "pty",
+        description,
+        // `start` is the gateway op; classifying the whole tool as `shell`
+        // makes the gate's category-default reach the right resolver. Per-op
+        // overrides happen via `permission()` below.
+        category: "shell",
+        parameters: {
+            type: "object",
+            properties: {
+                op: {
+                    type: "string",
+                    enum: [...VALID_OPS],
+                    description: "Operation: start | write | read | resize | kill | interrupt | adopt | list",
+                },
+                command: { type: "string", description: "[start] Shell command line to run." },
+                cwd: { type: "string", description: "[start] Working directory. Defaults to the workspace root." },
+                cols: { type: "number", description: "[start] PTY column count." },
+                rows: { type: "number", description: "[start] PTY row count." },
+                shell: { type: "string", description: "[start] Shell binary (must be in the allowlist)." },
+                env: { type: "object", description: "[start] Environment overrides. Keys/values must be strings." },
+                session_id: { type: "string", description: "Session id returned by start. Required for write/read/resize/kill/interrupt/adopt." },
+                since: { type: "number", description: "[read] Resume cursor (seq). 0 returns from the beginning of the ring." },
+                timeout_ms: { type: "number", description: "[read] Max poll window in ms. Default 1000, max 5000." },
+                input: { type: "string", description: "[write] Stdin payload. Include trailing \\n if the program expects it (this triggers a re-prompt — command-class input)." },
+                signal: { type: "string", enum: ["SIGTERM", "SIGKILL"], description: "[kill] Default SIGTERM." },
+            },
+            required: ["op"],
+        },
+        summarize: (args) => {
+            try {
+                const { op, args: a } = parseOp(args);
+                if (op === "start")
+                    return `pty start: ${preview(optStr(a, "command") ?? "")}`;
+                const sid = optStr(a, "session_id") ?? "?";
+                if (op === "write")
+                    return `pty write to ${sid}: ${preview(optStr(a, "input") ?? "")}`;
+                if (op === "kill")
+                    return `pty kill ${optStr(a, "signal") ?? "SIGTERM"}: ${sid}`;
+                if (op === "interrupt")
+                    return `pty interrupt (SIGINT): ${sid}`;
+                if (op === "adopt")
+                    return `pty adopt: ${sid}`;
+                return `pty ${op}: ${sid}`;
+            }
+            catch {
+                return "pty: invalid args";
+            }
+        },
+        permission(args, _ctx) {
+            let parsed;
+            try {
+                parsed = parseOp(args);
+            }
+            catch {
+                // Bad op surface as `PermissionRequest` so the engine still
+                // gates (and the tool's execute path returns the structured
+                // error). Use the tool's category default.
+                return {
+                    name: "pty",
+                    category: "shell",
+                    summary: "pty: invalid args",
+                    args,
+                };
+            }
+            const { op, args: a } = parsed;
+            if (op === "start") {
+                const cfg = resolveStartConfig(a);
+                if ("error" in cfg) {
+                    // Surface as a normal start prompt; the execute path will
+                    // return ok:false with the precise error. Re-prompting the
+                    // user for a malformed start would be confusing, but the gate
+                    // doesn't have a "skip-and-fail" channel — settle on the
+                    // generic summary; execute returns the labelled error.
+                    return {
+                        name: "pty",
+                        category: "shell",
+                        summary: `pty start: ${preview(optStr(a, "command") ?? "")}`,
+                        args,
+                    };
+                }
+                return {
+                    name: "pty",
+                    category: "shell",
+                    summary: startSummary(cfg.command, cfg.cwd, cfg.shell, cfg.env),
+                    args,
+                    cacheKey: startCacheKey(cfg.command, cfg.cwd, cfg.shell, cfg.env),
+                };
+            }
+            if (op === "read" || op === "resize" || op === "list") {
+                // Bypass the gate — D4. read/resize/list are operationally
+                // covered by the original start approval.
+                return null;
+            }
+            if (op === "write") {
+                const sessionId = optStr(a, "session_id") ?? "?";
+                const input = optStr(a, "input") ?? "";
+                if (isSafeWrite(input))
+                    return null;
+                const info = lookupInfo(sessionId);
+                return {
+                    name: "pty",
+                    category: "shell",
+                    summary: writeSummary(info, input),
+                    args,
+                    cacheKey: writeExecCacheKey(sessionId, input),
+                };
+            }
+            if (op === "kill") {
+                const sessionId = optStr(a, "session_id") ?? "?";
+                const sig = (optStr(a, "signal") ?? "SIGTERM").toUpperCase();
+                const info = lookupInfo(sessionId);
+                return {
+                    name: "pty",
+                    category: "shell",
+                    summary: killSummary(info, sig),
+                    args,
+                    cacheKey: killCacheKey(sessionId, sig),
+                };
+            }
+            if (op === "interrupt") {
+                const sessionId = optStr(a, "session_id") ?? "?";
+                const info = lookupInfo(sessionId);
+                return {
+                    name: "pty",
+                    category: "shell",
+                    summary: interruptSummary(info),
+                    args,
+                    cacheKey: interruptCacheKey(sessionId),
+                };
+            }
+            // op === "adopt"
+            const sessionId = optStr(a, "session_id") ?? "?";
+            // Adopt may target a session NOT yet owned by this agent (that's
+            // the whole point of adopt). We still look up via `lookupInfo`
+            // which returns undefined for cross-agent sessions — the prompt
+            // then shows `<unknown session>` rather than leaking the
+            // command. Operator approval still gates the transfer.
+            const info = lookupInfo(sessionId);
+            return {
+                name: "pty",
+                category: "shell",
+                summary: adoptSummary(info),
+                args,
+                cacheKey: adoptCacheKey(sessionId),
+            };
+        },
+        async execute(args, ctx) {
+            let parsed;
+            try {
+                parsed = parseOp(args);
+            }
+            catch (e) {
+                return { ok: false, output: e.message };
+            }
+            const { op, args: a } = parsed;
+            try {
+                switch (op) {
+                    case "start":
+                        return await executeStart(a, ctx);
+                    case "read":
+                        return await executeRead(a, ctx);
+                    case "write":
+                        return await executeWrite(a);
+                    case "resize":
+                        return await executeResize(a);
+                    case "kill":
+                        return await executeKill(a);
+                    case "interrupt":
+                        return await executeInterrupt(a);
+                    case "adopt":
+                        return executeAdopt(a);
+                    case "list":
+                        return executeList();
+                }
+            }
+            catch (e) {
+                return { ok: false, output: `pty ${op}: ${e.message ?? String(e)}` };
+            }
+        },
+    };
+    async function executeStart(a, ctx) {
+        const cfg = resolveStartConfig(a);
+        if ("error" in cfg)
+            return { ok: false, output: cfg.error };
+        try {
+            const result = await deps.registry.start({
+                agentId: deps.agentId,
+                agentName: deps.agentName,
+                callId: ctx.callId ?? createId("call"),
+                command: cfg.command,
+                cwd: cfg.cwd,
+                env: cfg.env,
+                cols: cfg.cols,
+                rows: cfg.rows,
+                shell: cfg.shell,
+                worktreeCwd: deps.worktreeCwd,
+                createHandle: (spawnOpts, onChunk) => 
+                // The factory is injected via the engine wiring; here we
+                // delegate to a runtime-resolved factory passed through deps.
+                deps.createHandle(spawnOpts, onChunk),
+            });
+            const payload = {
+                session_id: result.sessionId,
+                state: result.state,
+            };
+            if (result.firstChunk) {
+                payload.first_chunk = { seq: result.firstChunk.seq, text: result.firstChunk.text };
+            }
+            return { ok: true, output: jsonOutput(payload) };
+        }
+        catch (e) {
+            const msg = e.message ?? String(e);
+            // PTY_MAX_SESSIONS / spawn failure / etc. all flatten to ok:false
+            // with the labelled message so the model can recover.
+            return { ok: false, output: msg };
+        }
+    }
+    async function executeRead(a, ctx) {
+        const sessionId = str(a, "session_id");
+        const since = optNum(a, "since");
+        const timeoutMs = optNum(a, "timeout_ms");
+        try {
+            const result = await deps.registry.read(sessionId, deps.agentId, { since, timeoutMs, callId: ctx.callId ?? createId("call") }, ctx.signal);
+            const payload = {
+                state: result.state,
+                chunks: result.chunks.map((c) => ({ seq: c.seq, text: c.text })),
+            };
+            if (result.exitCode !== undefined)
+                payload.exit_code = result.exitCode;
+            if (result.dropped)
+                payload.dropped = result.dropped;
+            if (result.truncated)
+                payload.truncated = true;
+            if (result.nextSince !== undefined)
+                payload.next_since = result.nextSince;
+            if (result.persistedPath)
+                payload.persisted_path = result.persistedPath;
+            return { ok: true, output: jsonOutput(payload) };
+        }
+        catch (e) {
+            // SessionNotFoundError lands here as a typed error.
+            return { ok: false, output: e.message ?? String(e) };
+        }
+    }
+    async function executeWrite(a) {
+        const sessionId = str(a, "session_id");
+        const input = str(a, "input");
+        const bytes = Buffer.from(input, "utf8");
+        const r = await deps.registry.write(sessionId, deps.agentId, bytes);
+        return formatOpResult(r);
+    }
+    async function executeResize(a) {
+        const sessionId = str(a, "session_id");
+        const cols = optNum(a, "cols");
+        const rows = optNum(a, "rows");
+        if (cols === undefined || rows === undefined) {
+            return { ok: false, output: "PTY_BAD_ARGS: 'cols' and 'rows' required for resize" };
+        }
+        const r = await deps.registry.resize(sessionId, deps.agentId, cols, rows);
+        return formatOpResult(r);
+    }
+    async function executeKill(a) {
+        const sessionId = str(a, "session_id");
+        const sig = (optStr(a, "signal") ?? "SIGTERM").toUpperCase();
+        if (sig !== "SIGTERM" && sig !== "SIGKILL") {
+            return { ok: false, output: `PTY_BAD_ARGS: signal must be SIGTERM or SIGKILL, got '${sig}'` };
+        }
+        const r = await deps.registry.kill(sessionId, deps.agentId, sig);
+        return formatOpResult(r);
+    }
+    async function executeInterrupt(a) {
+        const sessionId = str(a, "session_id");
+        const r = await deps.registry.interrupt(sessionId, deps.agentId);
+        return formatOpResult(r);
+    }
+    function executeAdopt(a) {
+        const sessionId = str(a, "session_id");
+        const r = deps.registry.adopt(sessionId, deps.agentId);
+        return formatOpResult(r);
+    }
+    function executeList() {
+        const sessions = deps.registry.list(deps.agentId).map((s) => ({
+            session_id: s.sessionId,
+            command: s.command,
+            cwd: s.cwd,
+            shell: s.shell,
+            started_at: s.startedAt,
+            state: s.state,
+            ...(s.exitCode !== undefined ? { exit_code: s.exitCode } : {}),
+        }));
+        return { ok: true, output: jsonOutput({ sessions }) };
+    }
+    return tool;
+}
+function formatOpResult(r) {
+    if (r.ok)
+        return { ok: true, output: jsonOutput({ ok: true }) };
+    const body = r.message ? `${r.error}: ${r.message}` : r.error;
+    return { ok: false, output: body };
+}
+/** Stringify a JSON payload as the tool result body. Insertion-order
+ * (matches JSON.stringify defaults); tests construct payloads in a
+ * deterministic order so snapshots stay stable without an extra sort
+ * pass. */
+function jsonOutput(obj) {
+    return JSON.stringify(obj);
+}
+//# sourceMappingURL=pty.js.map

package/dist/tools/builtins/pty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty.js","sourceRoot":"","sources":["../../../src/tools/builtins/pty.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAE5D,8EAA8E;AAC9E,kBAAkB;AAElB;qCACqC;AACrC,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IACtC,IAAI;IACJ,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,SAAS;IACT,YAAY;IACZ,gBAAgB;IAChB,MAAM;IACN,UAAU;CACX,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,KAAa,EAAE,SAA4B;IACjE,+DAA+D;IAC/D,+DAA+D;IAC/D,+DAA+D;IAC/D,2CAA2C;IAC3C,kEAAkE;IAClE,mCAAmC;IACnC,2DAA2D;IAC3D,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACrC,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAE3B,SAAS,aAAa,CAAC,OAAe,EAAE,GAAW,EAAE,KAAa,EAAE,GAA2B;IAC7F,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrF,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO,OAAO,GAAG,OAAO,KAAK,OAAO,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxG,OAAO,aAAa,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB,EAAE,IAAY;IACxD,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtE,OAAO,kBAAkB,SAAS,IAAI,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,YAAY,CAAC,SAAiB,EAAE,MAAc;IACrD,OAAO,YAAY,MAAM,IAAI,SAAS,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,OAAO,iBAAiB,SAAS,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,aAAa,CAAC,SAAiB;IACtC,OAAO,aAAa,SAAS,EAAE,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AAExB;;;sEAGsE;AACtE,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC,CAAC,WAAW;QACvD,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC,CAAC,0BAA0B;QAClF,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC,CAAC,MAAM;IACtC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,6BAA6B;AAE7B,SAAS,OAAO,CAAC,GAA2B;IAC1C,MAAM,GAAG,GAA6C,EAAE,CAAC;IACzD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;YAAE,SAAS;QACnC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC5B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,GAAW,EAAE,KAAa,EAAE,GAA2B;IAC5F,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,CAAC,cAAc,OAAO,EAAE,EAAE,UAAU,GAAG,EAAE,EAAE,YAAY,KAAK,EAAE,CAAC,CAAC;IAC9E,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnF,KAAK,CAAC,IAAI,CAAC,UAAU,YAAY,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,WAAuC,EAAE,KAAa;IAC1E,MAAM,IAAI,GAAG,WAAW,EAAE,OAAO,IAAI,mBAAmB,CAAC;IACzD,OAAO,gBAAgB,IAAI,KAAK,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,WAAW,CAAC,WAAuC,EAAE,MAAc;IAC1E,MAAM,IAAI,GAAG,WAAW,EAAE,OAAO,IAAI,mBAAmB,CAAC;IACzD,OAAO,YAAY,MAAM,KAAK,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAuC;IAC/D,MAAM,IAAI,GAAG,WAAW,EAAE,OAAO,IAAI,mBAAmB,CAAC;IACzD,OAAO,2BAA2B,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,YAAY,CAAC,WAAuC;IAC3D,MAAM,IAAI,GAAG,WAAW,EAAE,OAAO,IAAI,mBAAmB,CAAC;IACzD,OAAO,+BAA+B,IAAI,EAAE,CAAC;AAC/C,CAAC;AAWD,MAAM,SAAS,GAAuB,IAAI,GAAG,CAAC;IAC5C,OAAO;IACP,OAAO;IACP,MAAM;IACN,QAAQ;IACR,MAAM;IACN,WAAW;IACX,OAAO;IACP,MAAM;CACE,CAAC,CAAC;AAEZ,SAAS,OAAO,CAAC,IAAe;IAC9B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,4CAA4C,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,GAAG,GAAG,IAAiC,CAAC;IAC9C,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;IAClB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAW,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,IAAI,EACd,oBAAoB,MAAM,CAAC,EAAE,CAAC,uBAAuB,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,EAAW,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AACxC,CAAC;AAyCD,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,oEAAoE;IACpE,mEAAmE;IACnE,kEAAkE;IAClE,iEAAiE;IACjE,6DAA6D;IAC7D,mEAAmE;IACnE,qCAAqC;IACrC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5F,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,IAAI,EAAE,CAAC;IAEjD,SAAS,kBAAkB,CAAC,IAA+B;QAQzD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACrC,4DAA4D;QAC5D,6DAA6D;QAC7D,gEAAgE;QAChE,wDAAwD;QACxD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,aAAa,CAAC;QACzE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,YAAY,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;YACtC,OAAO;gBACL,KAAK,EAAE,yBAAyB,KAAK,kDAAkD,CAAC,GAAG,uBAAuB,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,oEAAoE;aAC1M,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,GAAG,GAA2B,EAAE,CAAC;QACrC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAmC,CAAC,EAAE,CAAC;gBACzE,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAC1B,OAAO,EAAE,KAAK,EAAE,gCAAgC,CAAC,oBAAoB,EAAE,CAAC;gBAC1E,CAAC;gBACD,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACb,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACnD,OAAO,EAAE,KAAK,EAAE,wDAAwD,EAAE,CAAC;QAC7E,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClD,CAAC;IAED,SAAS,UAAU,CAAC,SAAiB;QACnC,iEAAiE;QACjE,6CAA6C;QAC7C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,WAAW,GAAG;QAClB,2JAA2J;QAC3J,EAAE;QACF,iCAAiC;QACjC,sMAAsM;QACtM,2SAA2S;QAC3S,oKAAoK;QACpK,oGAAoG;QACpG,8EAA8E;QAC9E,6JAA6J;QAC7J,+HAA+H;QAC/H,gIAAgI;KACjI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,IAAI,GAAS;QACjB,IAAI,EAAE,KAAK;QACX,WAAW;QACX,mEAAmE;QACnE,qEAAqE;QACrE,6CAA6C;QAC7C,QAAQ,EAAE,OAAO;QACjB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;oBACpB,WAAW,EAAE,4EAA4E;iBAC1F;gBACD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;gBAC9E,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4DAA4D,EAAE;gBAClG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;gBAClE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;gBAC/D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kDAAkD,EAAE;gBAC1F,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;gBACnG,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oFAAoF,EAAE;gBACjI,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uEAAuE,EAAE;gBAC/G,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE;gBACpG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0HAA0H,EAAE;gBAClK,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE;aACjG;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;QACD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YAClB,IAAI,CAAC;gBACH,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;gBACtC,IAAI,EAAE,KAAK,OAAO;oBAAE,OAAO,cAAc,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC/E,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,GAAG,CAAC;gBAC3C,IAAI,EAAE,KAAK,OAAO;oBAAE,OAAO,gBAAgB,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBACvF,IAAI,EAAE,KAAK,MAAM;oBAAE,OAAO,YAAY,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;gBACjF,IAAI,EAAE,KAAK,WAAW;oBAAE,OAAO,2BAA2B,GAAG,EAAE,CAAC;gBAChE,IAAI,EAAE,KAAK,OAAO;oBAAE,OAAO,cAAc,GAAG,EAAE,CAAC;gBAC/C,OAAO,OAAO,EAAE,KAAK,GAAG,EAAE,CAAC;YAC7B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,mBAAmB,CAAC;YAC7B,CAAC;QACH,CAAC;QACD,UAAU,CAAC,IAAI,EAAE,IAAI;YACnB,IAAI,MAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,4DAA4D;gBAC5D,4DAA4D;gBAC5D,2CAA2C;gBAC3C,OAAO;oBACL,IAAI,EAAE,KAAK;oBACX,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,mBAAmB;oBAC5B,IAAI;iBACL,CAAC;YACJ,CAAC;YACD,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC;YAE/B,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;gBACnB,MAAM,GAAG,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;gBAClC,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;oBACnB,0DAA0D;oBAC1D,2DAA2D;oBAC3D,8DAA8D;oBAC9D,yDAAyD;oBACzD,uDAAuD;oBACvD,OAAO;wBACL,IAAI,EAAE,KAAK;wBACX,QAAQ,EAAE,OAAO;wBACjB,OAAO,EAAE,cAAc,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE;wBAC5D,IAAI;qBACL,CAAC;gBACJ,CAAC;gBACD,OAAO;oBACL,IAAI,EAAE,KAAK;oBACX,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC;oBAC/D,IAAI;oBACJ,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC;iBAClE,CAAC;YACJ,CAAC;YAED,IAAI,EAAE,KAAK,MAAM,IAAI,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;gBACtD,2DAA2D;gBAC3D,0CAA0C;gBAC1C,OAAO,IAAI,CAAC;YACd,CAAC;YAED,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;gBACnB,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,GAAG,CAAC;gBACjD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;gBACvC,IAAI,WAAW,CAAC,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACpC,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;gBACnC,OAAO;oBACL,IAAI,EAAE,KAAK;oBACX,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC;oBAClC,IAAI;oBACJ,QAAQ,EAAE,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC;iBAC9C,CAAC;YACJ,CAAC;YAED,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;gBAClB,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,GAAG,CAAC;gBACjD,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC7D,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;gBACnC,OAAO;oBACL,IAAI,EAAE,KAAK;oBACX,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC;oBAC/B,IAAI;oBACJ,QAAQ,EAAE,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC;iBACvC,CAAC;YACJ,CAAC;YAED,IAAI,EAAE,KAAK,WAAW,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,GAAG,CAAC;gBACjD,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;gBACnC,OAAO;oBACL,IAAI,EAAE,KAAK;oBACX,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC;oBAC/B,IAAI;oBACJ,QAAQ,EAAE,iBAAiB,CAAC,SAAS,CAAC;iBACvC,CAAC;YACJ,CAAC;YAED,iBAAiB;YACjB,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,GAAG,CAAC;YACjD,iEAAiE;YACjE,+DAA+D;YAC/D,gEAAgE;YAChE,yDAAyD;YACzD,uDAAuD;YACvD,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;YACnC,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC;gBAC3B,IAAI;gBACJ,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC;aACnC,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;YACrB,IAAI,MAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC;YACrD,CAAC;YACD,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC;YAE/B,IAAI,CAAC;gBACH,QAAQ,EAAE,EAAE,CAAC;oBACX,KAAK,OAAO;wBACV,OAAO,MAAM,YAAY,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;oBACpC,KAAK,MAAM;wBACT,OAAO,MAAM,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;oBACnC,KAAK,OAAO;wBACV,OAAO,MAAM,YAAY,CAAC,CAAC,CAAC,CAAC;oBAC/B,KAAK,QAAQ;wBACX,OAAO,MAAM,aAAa,CAAC,CAAC,CAAC,CAAC;oBAChC,KAAK,MAAM;wBACT,OAAO,MAAM,WAAW,CAAC,CAAC,CAAC,CAAC;oBAC9B,KAAK,WAAW;wBACd,OAAO,MAAM,gBAAgB,CAAC,CAAC,CAAC,CAAC;oBACnC,KAAK,OAAO;wBACV,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;oBACzB,KAAK,MAAM;wBACT,OAAO,WAAW,EAAE,CAAC;gBACzB,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAM,CAAW,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAClF,CAAC;QACH,CAAC;KACF,CAAC;IAEF,KAAK,UAAU,YAAY,CAAC,CAA4B,EAAE,GAAgB;QACxE,MAAM,GAAG,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,OAAO,IAAI,GAAG;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACvC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC;gBACtC,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,YAAY,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE;gBACnC,yDAAyD;gBACzD,8DAA8D;gBAC9D,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC;aACxC,CAAC,CAAC;YACH,MAAM,OAAO,GAA8B;gBACzC,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC;YACF,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,OAAO,CAAC,WAAW,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACrF,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAI,CAAW,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;YAC9C,kEAAkE;YAClE,sDAAsD;YACtD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IAED,KAAK,UAAU,WAAW,CAAC,CAA4B,EAAE,GAAgB;QACvE,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CACrC,SAAS,EACT,IAAI,CAAC,OAAO,EACZ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,EAC5D,GAAG,CAAC,MAAM,CACX,CAAC;YACF,MAAM,OAAO,GAA8B;gBACzC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;aACjE,CAAC;YACF,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;gBAAE,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC;YACvE,IAAI,MAAM,CAAC,OAAO;gBAAE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YACrD,IAAI,MAAM,CAAC,SAAS;gBAAE,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;YAC/C,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;gBAAE,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC;YAC1E,IAAI,MAAM,CAAC,aAAa;gBAAE,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC;YACxE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,oDAAoD;YACpD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAG,CAAW,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;IAED,KAAK,UAAU,YAAY,CAAC,CAA4B;QACtD,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACpE,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,UAAU,aAAa,CAAC,CAA4B;QACvD,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,qDAAqD,EAAE,CAAC;QACtF,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1E,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,UAAU,WAAW,CAAC,CAA4B;QACrD,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7D,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC3C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,yDAAyD,GAAG,GAAG,EAAE,CAAC;QAChG,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,GAA4B,CAAC,CAAC;QAC1F,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,UAAU,gBAAgB,CAAC,CAA4B;QAC1D,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACjE,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,SAAS,YAAY,CAAC,CAA4B;QAChD,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACvD,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,SAAS,WAAW;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5D,UAAU,EAAE,CAAC,CAAC,SAAS;YACvB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,UAAU,EAAE,CAAC,CAAC,SAAS;YACvB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/D,CAAC,CAAC,CAAC;QACJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,CAAgE;IACtF,IAAI,CAAC,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAChE,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACrC,CAAC;AAED;;;WAGW;AACX,SAAS,UAAU,CAAC,GAA8B;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC"}

package/dist/tools/builtins/read.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from "../types.js";
+export declare const readTool: Tool;
+//# sourceMappingURL=read.d.ts.map

package/dist/tools/builtins/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/read.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,aAAa,CAAC;AAGpD,eAAO,MAAM,QAAQ,EAAE,IAatB,CAAC"}

package/dist/tools/builtins/read.js

@@ -0,0 +1,18 @@
+import { existsSync, readFileSync } from "node:fs";
+import { safePath, str } from "./_shared.js";
+export const readTool = {
+    name: "read",
+    description: "Read a UTF-8 text file from the workspace.",
+    category: "file-read",
+    parameters: { type: "object", properties: { path: { type: "string" } }, required: ["path"] },
+    summarize: (args) => `read ${str(args, "path")}`,
+    async execute(args, ctx) {
+        const path = safePath(ctx, str(args, "path"));
+        if (!existsSync(path))
+            return { ok: false, output: `No such file: ${str(args, "path")}` };
+        const content = readFileSync(path, "utf8");
+        const clipped = content.length > 60_000 ? content.slice(0, 60_000) + "\n…(truncated)" : content;
+        return { ok: true, output: clipped };
+    },
+};
+//# sourceMappingURL=read.js.map

package/dist/tools/builtins/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/tools/builtins/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,4CAA4C;IACzD,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;IAC5F,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;IAChD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;QACrB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QAC1F,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC;QAChG,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACvC,CAAC;CACF,CAAC"}

package/dist/tools/builtins/web-fetch.d.ts

@@ -0,0 +1,4 @@
+import type { Tool } from "../types.js";
+export declare function htmlToText(html: string): string;
+export declare const webFetchTool: Tool;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/tools/builtins/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/web-fetch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,IAAI,EAAc,MAAM,aAAa,CAAC;AAwIvE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA6B/C;AA0FD,eAAO,MAAM,YAAY,EAAE,IA8F1B,CAAC"}