@harperfast/harper 5.2.0-alpha.4 → 5.2.0-alpha.6

package/dist/agent/tools/inspectorTool.js

@@ -0,0 +1,428 @@
+"use strict";
+/**
+ * V8 inspector (CDP) tools for the built-in agent (#626).
+ *
+ * The agent runs on the main thread; these tools attach over the Chrome
+ * DevTools Protocol to *worker* thread inspector ports so it can evaluate,
+ * set breakpoints/logpoints, and CPU-profile a worker without stalling the
+ * thread it runs on. A worker's debug port is `threads_debug_startingPort +
+ * workerIndex` (see `server/threads/threadServer.js`); attaching therefore
+ * requires `threads_debug: true` and a configured `threads_debug_startingPort`.
+ *
+ * Attaching to the main thread (`workerIndex < 0`) is rejected — that's the
+ * agent's own thread, and a self-attach + breakpoint would deadlock. This is
+ * the operator-only counterpart to the app-developer agent, which runs on a
+ * worker and must never inspector-attach to itself.
+ *
+ * Safety against wedging a live worker: every connection registers a
+ * `Debugger.paused` handler that logs a stack snapshot and immediately resumes,
+ * so a breakpoint hit is observable (via the Harper log) but never leaves the
+ * worker paused. CDP calls carry a per-call abort signal + timeout so an
+ * unresponsive worker can't hang the agent loop.
+ *
+ * Dependencies (debug config + live worker count) are injected so the tool is
+ * unit-testable without booting a server.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeProfile = summarizeProfile;
+exports.buildInspectorTools = buildInspectorTools;
+exports._closeInspectorSessions = _closeInspectorSessions;
+const ws_1 = __importDefault(require("ws"));
+const harper_logger_ts_1 = __importDefault(require("../../utility/logging/harper_logger.js"));
+const log = harper_logger_ts_1.default.loggerWithTag('agent');
+const DEFAULT_CALL_TIMEOUT_MS = 30_000;
+const MAX_TCP_PORT = 65535;
+// One live CDP connection per worker debug port, reused across tool calls. Keyed by port and
+// storing the *promise* so concurrent opens dedupe onto a single connection.
+const sessions = new Map();
+/** Strictly parse a worker index — reject `""`/`null`/`false`/`[]`, which `Number()` would coerce to 0. */
+function toWorkerIndex(raw) {
+    if (typeof raw === 'number' && Number.isInteger(raw))
+        return raw;
+    if (typeof raw === 'string' && raw.trim() !== '' && Number.isInteger(Number(raw)))
+        return Number(raw);
+    throw new Error('workerIndex must be an integer');
+}
+/**
+ * Resolve the worker's inspector port, enforcing the safety envelope:
+ * debug enabled, a starting port configured, and an in-range worker index that
+ * is NOT the main thread (`< 0`).
+ */
+function resolvePort(deps, workerIndex) {
+    if (!deps.debugEnabled) {
+        throw new Error('threads_debug is not enabled; set threads_debug: true to allow inspector attach');
+    }
+    if (deps.startingPort == null) {
+        throw new Error('threads_debug_startingPort is not configured; per-worker inspector ports are unavailable');
+    }
+    if (workerIndex < 0) {
+        throw new Error('cannot attach to the main thread (the agent runs there); specify a worker index >= 0');
+    }
+    const count = deps.getWorkerCount();
+    if (workerIndex >= count)
+        throw new Error(`no worker at index ${workerIndex} (worker count is ${count})`);
+    const port = deps.startingPort + workerIndex;
+    if (port > MAX_TCP_PORT)
+        throw new Error(`resolved inspector port ${port} exceeds ${MAX_TCP_PORT}`);
+    return port;
+}
+async function fetchWebSocketUrl(host, port, signal) {
+    const res = await fetch(`http://${host}:${port}/json/list`, { signal });
+    if (!res.ok)
+        throw new Error(`inspector /json/list on ${host}:${port} returned ${res.status}`);
+    const targets = (await res.json());
+    const target = Array.isArray(targets) ? targets.find((t) => t.webSocketDebuggerUrl) : undefined;
+    if (!target?.webSocketDebuggerUrl) {
+        throw new Error(`no debuggable target at ${host}:${port} (is the worker inspector open?)`);
+    }
+    return { wsUrl: target.webSocketDebuggerUrl, title: target.title };
+}
+function openCdp(wsUrl, opts) {
+    return new Promise((resolve, reject) => {
+        const ws = new ws_1.default(wsUrl);
+        let opened = false;
+        let nextId = 1;
+        const pending = new Map();
+        const listeners = new Map();
+        const failPending = (err) => {
+            for (const p of pending.values())
+                p.reject(err);
+            pending.clear();
+        };
+        // The connect signal guards ONLY the handshake — once open, per-call signals take over, so
+        // aborting the first caller must not tear down the shared connection.
+        const onConnectAbort = () => {
+            try {
+                ws.terminate();
+            }
+            catch {
+                /* already gone */
+            }
+        };
+        if (opts.signal) {
+            if (opts.signal.aborted) {
+                onConnectAbort();
+                return reject(new Error('aborted'));
+            }
+            opts.signal.addEventListener('abort', onConnectAbort, { once: true });
+        }
+        ws.on('message', (data) => {
+            let msg;
+            try {
+                msg = JSON.parse(data.toString());
+            }
+            catch {
+                return;
+            }
+            if (msg.id != null && pending.has(msg.id)) {
+                const p = pending.get(msg.id);
+                pending.delete(msg.id);
+                if (msg.error)
+                    p.reject(new Error(msg.error.message ?? 'CDP error'));
+                else
+                    p.resolve(msg.result);
+            }
+            else if (msg.method) {
+                for (const cb of listeners.get(msg.method) ?? [])
+                    cb(msg.params);
+            }
+        });
+        ws.on('error', (err) => {
+            if (!opened)
+                reject(err);
+            failPending(err instanceof Error ? err : new Error(String(err)));
+        });
+        ws.on('close', () => {
+            opts.signal?.removeEventListener('abort', onConnectAbort);
+            if (!opened)
+                reject(new Error('CDP connection closed before it opened'));
+            failPending(new Error('CDP connection closed'));
+            opts.onClose();
+        });
+        ws.on('open', () => {
+            opened = true;
+            opts.signal?.removeEventListener('abort', onConnectAbort);
+            const session = {
+                send(method, params, signal) {
+                    return new Promise((res, rej) => {
+                        if (signal?.aborted)
+                            return rej(new Error('aborted'));
+                        const id = nextId++;
+                        const timer = setTimeout(() => {
+                            if (pending.delete(id))
+                                rej(new Error(`CDP ${method} timed out after ${DEFAULT_CALL_TIMEOUT_MS}ms`));
+                        }, DEFAULT_CALL_TIMEOUT_MS);
+                        const onAbort = () => {
+                            if (pending.delete(id)) {
+                                clearTimeout(timer);
+                                rej(new Error('aborted'));
+                            }
+                        };
+                        signal?.addEventListener('abort', onAbort, { once: true });
+                        pending.set(id, {
+                            resolve: (v) => {
+                                clearTimeout(timer);
+                                signal?.removeEventListener('abort', onAbort);
+                                res(v);
+                            },
+                            reject: (e) => {
+                                clearTimeout(timer);
+                                signal?.removeEventListener('abort', onAbort);
+                                rej(e);
+                            },
+                        });
+                        try {
+                            ws.send(JSON.stringify({ id, method, params: params ?? {} }));
+                        }
+                        catch (e) {
+                            if (pending.delete(id)) {
+                                clearTimeout(timer);
+                                rej(e);
+                            }
+                        }
+                    });
+                },
+                on(event, cb) {
+                    let set = listeners.get(event);
+                    if (!set)
+                        listeners.set(event, (set = new Set()));
+                    set.add(cb);
+                },
+                close() {
+                    try {
+                        ws.close();
+                    }
+                    catch {
+                        /* already closing */
+                    }
+                },
+            };
+            // A breakpoint hit pauses the worker; log a stack snapshot and resume immediately so the
+            // worker is never left wedged. Fires only when Debugger is enabled (i.e. a breakpoint was set).
+            session.on('Debugger.paused', (params) => {
+                const frames = (params?.callFrames ?? [])
+                    .slice(0, 5)
+                    .map((f) => `${f.functionName || '(anonymous)'}@${f.url}:${f.location?.lineNumber}`);
+                log.info?.(`[agent breakpoint hit] reason=${params?.reason} ${frames.join(' <- ')}`);
+                session.send('Debugger.resume').catch(() => { });
+            });
+            resolve(session);
+        });
+    });
+}
+function sessionFor(port, host, signal) {
+    const existing = sessions.get(port);
+    if (existing)
+        return existing;
+    const promise = (async () => {
+        const { wsUrl, title } = await fetchWebSocketUrl(host, port, signal);
+        const session = await openCdp(wsUrl, {
+            signal,
+            // Evict only if this exact promise is still the cached one — a stale close from a replaced
+            // connection must not drop a newer active session.
+            onClose: () => {
+                if (sessions.get(port) === promise)
+                    sessions.delete(port);
+            },
+        });
+        session.title = title;
+        return session;
+    })();
+    // Drop a failed connect from the cache so the next call retries instead of re-awaiting a rejection.
+    promise.catch(() => {
+        if (sessions.get(port) === promise)
+            sessions.delete(port);
+    });
+    sessions.set(port, promise);
+    return promise;
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted)
+            return reject(new Error('aborted'));
+        const timer = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(timer);
+            reject(new Error('aborted'));
+        }, { once: true });
+    });
+}
+/** Reduce a CDP CPU profile to the hottest functions by self time — the raw profile is megabytes. */
+function summarizeProfile(profile, topN) {
+    const nodes = profile?.nodes ?? [];
+    const byId = new Map(nodes.map((n) => [n.id, n]));
+    const samples = profile?.samples ?? [];
+    const deltas = profile?.timeDeltas ?? [];
+    const selfUs = new Map();
+    for (let i = 0; i < samples.length; i++) {
+        const id = samples[i];
+        selfUs.set(id, (selfUs.get(id) ?? 0) + (deltas[i] ?? 0));
+    }
+    const topFunctions = [...selfUs.entries()]
+        .map(([id, us]) => {
+        const cf = byId.get(id)?.callFrame ?? {};
+        return {
+            function: cf.functionName || '(anonymous)',
+            url: cf.url,
+            line: cf.lineNumber,
+            selfMs: +(us / 1000).toFixed(1),
+        };
+    })
+        .sort((a, b) => b.selfMs - a.selfMs)
+        .slice(0, topN);
+    const totalMs = deltas.reduce((a, b) => a + b, 0) / 1000;
+    return { totalMs: +totalMs.toFixed(1), sampleCount: samples.length, topFunctions };
+}
+const workerIndexProp = { type: 'integer', minimum: 0, description: '0-based worker thread index' };
+function buildInspectorTools(deps) {
+    const attach = {
+        def: {
+            name: 'inspector_attach',
+            description: 'Attach the V8 inspector to a worker thread so it can be evaluated, breakpointed, or CPU-profiled. Requires threads_debug + threads_debug_startingPort. Rejects the main thread.',
+            parameters: { type: 'object', properties: { workerIndex: workerIndexProp }, required: ['workerIndex'] },
+        },
+        handler: async (args, ctx) => {
+            const workerIndex = toWorkerIndex(args.workerIndex);
+            const port = resolvePort(deps, workerIndex);
+            const session = await sessionFor(port, deps.host, ctx.signal);
+            await session.send('Runtime.enable', {}, ctx.signal);
+            await session.send('Debugger.enable', {}, ctx.signal);
+            return { attached: true, workerIndex, port, target: session.title };
+        },
+    };
+    const evaluate = {
+        def: {
+            name: 'inspector_evaluate',
+            description: 'Evaluate a JavaScript expression in a worker thread and return the result. Runs arbitrary code in the worker.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    workerIndex: workerIndexProp,
+                    expression: { type: 'string' },
+                    awaitPromise: { type: 'boolean', description: 'Await the result if it is a promise.' },
+                },
+                required: ['workerIndex', 'expression'],
+            },
+        },
+        destructive: true, // arbitrary in-worker code execution
+        handler: async (args, ctx) => {
+            const port = resolvePort(deps, toWorkerIndex(args.workerIndex));
+            const session = await sessionFor(port, deps.host, ctx.signal);
+            await session.send('Runtime.enable', {}, ctx.signal);
+            const res = await session.send('Runtime.evaluate', { expression: String(args.expression), returnByValue: true, awaitPromise: !!args.awaitPromise }, ctx.signal);
+            if (res.exceptionDetails) {
+                throw new Error(res.exceptionDetails.exception?.description ?? res.exceptionDetails.text ?? 'evaluation threw');
+            }
+            return { value: res.result?.value, type: res.result?.type };
+        },
+    };
+    const setBreakpoint = {
+        def: {
+            name: 'inspector_set_breakpoint',
+            description: 'Set a breakpoint by script URL + line in a worker. lineNumber is 0-based (CDP). On hit, a stack snapshot is written to the Harper log and the worker is auto-resumed (it is NOT left paused).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    workerIndex: workerIndexProp,
+                    url: { type: 'string', description: 'Exact script URL (usually file:///…) to break in.' },
+                    lineNumber: { type: 'integer', minimum: 0, description: '0-based line number.' },
+                    columnNumber: { type: 'integer', minimum: 0 },
+                    condition: { type: 'string', description: 'Optional JS condition; breaks only when it is truthy.' },
+                },
+                required: ['workerIndex', 'url', 'lineNumber'],
+            },
+        },
+        destructive: true, // runs a condition in the worker; a hit briefly pauses it before auto-resume
+        handler: async (args, ctx) => {
+            const port = resolvePort(deps, toWorkerIndex(args.workerIndex));
+            const session = await sessionFor(port, deps.host, ctx.signal);
+            await session.send('Debugger.enable', {}, ctx.signal);
+            const res = await session.send('Debugger.setBreakpointByUrl', {
+                url: String(args.url),
+                lineNumber: Number(args.lineNumber),
+                ...(args.columnNumber != null ? { columnNumber: Number(args.columnNumber) } : {}),
+                ...(args.condition ? { condition: String(args.condition) } : {}),
+            }, ctx.signal);
+            return { breakpointId: res.breakpointId, locations: res.locations };
+        },
+    };
+    const setLogpoint = {
+        def: {
+            name: 'inspector_set_logpoint',
+            description: 'Set a non-pausing logpoint: logs an expression each time the line is hit, without stopping the worker. lineNumber is 0-based. Runs the expression in the worker.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    workerIndex: workerIndexProp,
+                    url: { type: 'string', description: 'Exact script URL (usually file:///…).' },
+                    lineNumber: { type: 'integer', minimum: 0, description: '0-based line number.' },
+                    logExpression: { type: 'string', description: 'JS expression whose value is logged on each hit.' },
+                },
+                required: ['workerIndex', 'url', 'lineNumber', 'logExpression'],
+            },
+        },
+        destructive: true, // runs an arbitrary expression in the worker on every hit
+        handler: async (args, ctx) => {
+            const port = resolvePort(deps, toWorkerIndex(args.workerIndex));
+            const session = await sessionFor(port, deps.host, ctx.signal);
+            await session.send('Debugger.enable', {}, ctx.signal);
+            // A logpoint is a breakpoint whose condition logs and returns false, so it never pauses. The
+            // expression is JSON-encoded into a string and eval'd (not spliced as raw code), so it can't
+            // break out of the wrapper to force a pause; a stray pause would auto-resume anyway (see
+            // openCdp). Direct eval keeps the paused frame's locals in scope.
+            const condition = `(function(){try{console.log('[agent logpoint]',eval(${JSON.stringify(String(args.logExpression))}));}catch(e){}return false;})()`;
+            const res = await session.send('Debugger.setBreakpointByUrl', { url: String(args.url), lineNumber: Number(args.lineNumber), condition }, ctx.signal);
+            return { breakpointId: res.breakpointId, locations: res.locations };
+        },
+    };
+    const profileCpu = {
+        def: {
+            name: 'inspector_profile_cpu',
+            description: 'Record a CPU profile of a worker for durationMs and return the hottest functions by self time.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    workerIndex: workerIndexProp,
+                    durationMs: { type: 'integer', minimum: 100, maximum: 60000 },
+                    topN: {
+                        type: 'integer',
+                        minimum: 1,
+                        maximum: 50,
+                        description: 'How many hot functions to return (default 15).',
+                    },
+                },
+                required: ['workerIndex', 'durationMs'],
+            },
+        },
+        handler: async (args, ctx) => {
+            const port = resolvePort(deps, toWorkerIndex(args.workerIndex));
+            const duration = Math.min(Math.max(Number(args.durationMs), 100), 60000);
+            const session = await sessionFor(port, deps.host, ctx.signal);
+            await session.send('Profiler.enable', {}, ctx.signal);
+            await session.send('Profiler.start', {}, ctx.signal);
+            let stopped;
+            try {
+                await sleep(duration, ctx.signal);
+            }
+            finally {
+                // Always stop + disable the profiler even if aborted, so we don't leave it running on the worker.
+                stopped = await session.send('Profiler.stop').catch(() => undefined);
+                await session.send('Profiler.disable').catch(() => { });
+            }
+            if (!stopped?.profile)
+                throw new Error('profiling produced no profile');
+            return summarizeProfile(stopped.profile, args.topN ? Number(args.topN) : 15);
+        },
+    };
+    return [attach, evaluate, setBreakpoint, setLogpoint, profileCpu];
+}
+/** Close all live inspector connections (agent shutdown / test teardown). Handles in-flight opens. */
+function _closeInspectorSessions() {
+    for (const promise of sessions.values())
+        promise.then((s) => s.close()).catch(() => { });
+    sessions.clear();
+}
+//# sourceMappingURL=inspectorTool.js.map

package/dist/agent/tools/inspectorTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectorTool.js","sourceRoot":"","sources":["../../../agent/tools/inspectorTool.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;;;AA+OH,4CAwBC;AAID,kDAkKC;AAGD,0DAGC;AAjbD,4CAA2B;AAC3B,8FAAkE;AAGlE,MAAM,GAAG,GAAG,0BAAY,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAEhD,MAAM,uBAAuB,GAAG,MAAM,CAAC;AACvC,MAAM,YAAY,GAAG,KAAK,CAAC;AAoB3B,6FAA6F;AAC7F,6EAA6E;AAC7E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;AAExD,2GAA2G;AAC3G,SAAS,aAAa,CAAC,GAAY;IAClC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACjE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACtG,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAmB,EAAE,WAAmB;IAC5D,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACpG,CAAC;IACD,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,0FAA0F,CAAC,CAAC;IAC7G,CAAC;IACD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;IACzG,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACpC,IAAI,WAAW,IAAI,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,WAAW,qBAAqB,KAAK,GAAG,CAAC,CAAC;IAC1G,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IAC7C,IAAI,IAAI,GAAG,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,YAAY,YAAY,EAAE,CAAC,CAAC;IACpG,OAAO,IAAI,CAAC;AACb,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC/B,IAAY,EACZ,IAAY,EACZ,MAAoB;IAEpB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,UAAU,IAAI,IAAI,IAAI,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACxE,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,IAAI,IAAI,aAAa,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/F,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA6D,CAAC;IAC/F,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChG,IAAI,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,IAAI,IAAI,kCAAkC,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,oBAAoB,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,OAAO,CAAC,KAAa,EAAE,IAAmD;IAClF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,MAAM,EAAE,GAAG,IAAI,YAAS,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqE,CAAC;QAC7F,MAAM,SAAS,GAAG,IAAI,GAAG,EAAsC,CAAC;QAEhE,MAAM,WAAW,GAAG,CAAC,GAAU,EAAE,EAAE;YAClC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE;gBAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChD,OAAO,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC,CAAC;QACF,2FAA2F;QAC3F,sEAAsE;QACtE,MAAM,cAAc,GAAG,GAAG,EAAE;YAC3B,IAAI,CAAC;gBACJ,EAAE,CAAC,SAAS,EAAE,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACR,kBAAkB;YACnB,CAAC;QACF,CAAC,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACzB,cAAc,EAAE,CAAC;gBACjB,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;YACrC,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAuB,EAAE,EAAE;YAC5C,IAAI,GAAQ,CAAC;YACb,IAAI,CAAC;gBACJ,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACR,OAAO;YACR,CAAC;YACD,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC3C,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;gBAC/B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACvB,IAAI,GAAG,CAAC,KAAK;oBAAE,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC;;oBAChE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;iBAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBACvB,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;oBAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAClE,CAAC;QACF,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAC7B,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,WAAW,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAC1D,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC,CAAC;YACzE,WAAW,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;YAChD,IAAI,CAAC,OAAO,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YAClB,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAe;gBAC3B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM;oBAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;wBAC/B,IAAI,MAAM,EAAE,OAAO;4BAAE,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;wBACtD,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;wBACpB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;4BAC7B,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gCAAE,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,MAAM,oBAAoB,uBAAuB,IAAI,CAAC,CAAC,CAAC;wBACtG,CAAC,EAAE,uBAAuB,CAAC,CAAC;wBAC5B,MAAM,OAAO,GAAG,GAAG,EAAE;4BACpB,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gCACxB,YAAY,CAAC,KAAK,CAAC,CAAC;gCACpB,GAAG,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;4BAC3B,CAAC;wBACF,CAAC,CAAC;wBACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;wBAC3D,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE;4BACf,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;gCACd,YAAY,CAAC,KAAK,CAAC,CAAC;gCACpB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gCAC9C,GAAG,CAAC,CAAC,CAAC,CAAC;4BACR,CAAC;4BACD,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;gCACb,YAAY,CAAC,KAAK,CAAC,CAAC;gCACpB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gCAC9C,GAAG,CAAC,CAAC,CAAC,CAAC;4BACR,CAAC;yBACD,CAAC,CAAC;wBACH,IAAI,CAAC;4BACJ,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;wBAC/D,CAAC;wBAAC,OAAO,CAAC,EAAE,CAAC;4BACZ,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gCACxB,YAAY,CAAC,KAAK,CAAC,CAAC;gCACpB,GAAG,CAAC,CAAU,CAAC,CAAC;4BACjB,CAAC;wBACF,CAAC;oBACF,CAAC,CAAC,CAAC;gBACJ,CAAC;gBACD,EAAE,CAAC,KAAK,EAAE,EAAE;oBACX,IAAI,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBAC/B,IAAI,CAAC,GAAG;wBAAE,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;oBAClD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACb,CAAC;gBACD,KAAK;oBACJ,IAAI,CAAC;wBACJ,EAAE,CAAC,KAAK,EAAE,CAAC;oBACZ,CAAC;oBAAC,MAAM,CAAC;wBACR,qBAAqB;oBACtB,CAAC;gBACF,CAAC;aACD,CAAC;YACF,yFAAyF;YACzF,gGAAgG;YAChG,OAAO,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,MAAW,EAAE,EAAE;gBAC7C,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,UAAU,IAAI,EAAE,CAAC;qBACvC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;qBACX,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,YAAY,IAAI,aAAa,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC3F,GAAG,CAAC,IAAI,EAAE,CAAC,iCAAiC,MAAM,EAAE,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACrF,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,OAAO,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,IAAY,EAAE,MAAoB;IACnE,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;QAC3B,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE;YACpC,MAAM;YACN,2FAA2F;YAC3F,mDAAmD;YACnD,OAAO,EAAE,GAAG,EAAE;gBACb,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,OAAO;oBAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3D,CAAC;SACD,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QACtB,OAAO,OAAO,CAAC;IAChB,CAAC,CAAC,EAAE,CAAC;IACL,oGAAoG;IACpG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;QAClB,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,OAAO;YAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,IAAI,MAAM,EAAE,OAAO;YAAE,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,EAAE,gBAAgB,CACvB,OAAO,EACP,GAAG,EAAE;YACJ,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9B,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACd,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,qGAAqG;AACrG,SAAgB,gBAAgB,CAAC,OAAY,EAAE,IAAY;IAC1D,MAAM,KAAK,GAAU,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,OAAO,GAAa,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IACjD,MAAM,MAAM,GAAa,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,YAAY,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SACxC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;QACjB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;QACzC,OAAO;YACN,QAAQ,EAAE,EAAE,CAAC,YAAY,IAAI,aAAa;YAC1C,GAAG,EAAE,EAAE,CAAC,GAAG;YACX,IAAI,EAAE,EAAE,CAAC,UAAU;YACnB,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;SAC/B,CAAC;IACH,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;SACnC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACjB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACzD,OAAO,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;AACpF,CAAC;AAED,MAAM,eAAe,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,6BAA6B,EAAE,CAAC;AAEpG,SAAgB,mBAAmB,CAAC,IAAmB;IACtD,MAAM,MAAM,GAAc;QACzB,GAAG,EAAE;YACJ,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACV,iLAAiL;YAClL,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,CAAC,aAAa,CAAC,EAAE;SACvG;QACD,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,GAAqB,EAAE,EAAE;YACnD,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAC9D,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACrD,MAAM,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACtD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QACrE,CAAC;KACD,CAAC;IAEF,MAAM,QAAQ,GAAc;QAC3B,GAAG,EAAE;YACJ,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACV,+GAA+G;YAChH,UAAU,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACX,WAAW,EAAE,eAAe;oBAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC9B,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sCAAsC,EAAE;iBACtF;gBACD,QAAQ,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC;aACvC;SACD;QACD,WAAW,EAAE,IAAI,EAAE,qCAAqC;QACxD,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,GAAqB,EAAE,EAAE;YACnD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YAChE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAC9D,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACrD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC7B,kBAAkB,EAClB,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,EAC/F,GAAG,CAAC,MAAM,CACV,CAAC;YACF,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW,IAAI,GAAG,CAAC,gBAAgB,CAAC,IAAI,IAAI,kBAAkB,CAAC,CAAC;YACjH,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAC7D,CAAC;KACD,CAAC;IAEF,MAAM,aAAa,GAAc;QAChC,GAAG,EAAE;YACJ,IAAI,EAAE,0BAA0B;YAChC,WAAW,EACV,+LAA+L;YAChM,UAAU,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACX,WAAW,EAAE,eAAe;oBAC5B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mDAAmD,EAAE;oBACzF,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE;oBAChF,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;oBAC7C,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE;iBACnG;gBACD,QAAQ,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,YAAY,CAAC;aAC9C;SACD;QACD,WAAW,EAAE,IAAI,EAAE,6EAA6E;QAChG,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,GAAqB,EAAE,EAAE;YACnD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YAChE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAC9D,MAAM,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACtD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC7B,6BAA6B,EAC7B;gBACC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;gBACrB,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;gBACnC,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjF,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChE,EACD,GAAG,CAAC,MAAM,CACV,CAAC;YACF,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;QACrE,CAAC;KACD,CAAC;IAEF,MAAM,WAAW,GAAc;QAC9B,GAAG,EAAE;YACJ,IAAI,EAAE,wBAAwB;YAC9B,WAAW,EACV,kKAAkK;YACnK,UAAU,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACX,WAAW,EAAE,eAAe;oBAC5B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;oBAC7E,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE;oBAChF,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kDAAkD,EAAE;iBAClG;gBACD,QAAQ,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,YAAY,EAAE,eAAe,CAAC;aAC/D;SACD;QACD,WAAW,EAAE,IAAI,EAAE,0DAA0D;QAC7E,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,GAAqB,EAAE,EAAE;YACnD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YAChE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAC9D,MAAM,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACtD,6FAA6F;YAC7F,6FAA6F;YAC7F,yFAAyF;YACzF,kEAAkE;YAClE,MAAM,SAAS,GAAG,uDAAuD,IAAI,CAAC,SAAS,CACtF,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAC1B,iCAAiC,CAAC;YACnC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAC7B,6BAA6B,EAC7B,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,EACzE,GAAG,CAAC,MAAM,CACV,CAAC;YACF,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;QACrE,CAAC;KACD,CAAC;IAEF,MAAM,UAAU,GAAc;QAC7B,GAAG,EAAE;YACJ,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EAAE,gGAAgG;YAC7G,UAAU,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACX,WAAW,EAAE,eAAe;oBAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;oBAC7D,IAAI,EAAE;wBACL,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,EAAE;wBACX,WAAW,EAAE,gDAAgD;qBAC7D;iBACD;gBACD,QAAQ,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC;aACvC;SACD;QACD,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,GAAqB,EAAE,EAAE;YACnD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YACzE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAC9D,MAAM,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACtD,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACrD,IAAI,OAAY,CAAC;YACjB,IAAI,CAAC;gBACJ,MAAM,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;oBAAS,CAAC;gBACV,kGAAkG;gBAClG,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACrE,MAAM,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACxD,CAAC;YACD,IAAI,CAAC,OAAO,EAAE,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACxE,OAAO,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;KACD,CAAC;IAEF,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;AACnE,CAAC;AAED,sGAAsG;AACtG,SAAgB,uBAAuB;IACtC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACxF,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/dist/agent/toolset.d.ts

@@ -1,12 +1,12 @@
 /**
  * Tool composer for the built-in agent (#626).
  *
- * Operator-only tools (FS, schedule, fetch) are inline today. Once the
- * unified MCP tool registry (#615) lands with the Operations (#617) and
- * Application (#618) profiles, this is the seam where RBAC-filtered
- * registry tools get folded in for the agent's configured user. The shape
- * of {@link composeToolset} won't change — only the body gains a registry
- * lookup.
+ * Two sources merge here: operator-only tools (FS, schedule, fetch, inspector)
+ * that are private to this component, and RBAC-filtered tools drained from the
+ * unified MCP tool registry (#615) for the agent's configured user — the
+ * Operations profile (#617) today, adapted in `registryTools.ts`. Operator-only
+ * tools win on a name collision: a private tool must never be shadowed by a
+ * same-named registry tool, since the two have different runtime assumptions.
  */
 import { type ScheduleToolDeps, type ScheduledFollowup } from './tools/scheduleTool.ts';
 import type { AgentTool } from './types.ts';
@@ -15,6 +15,16 @@ export interface ComposeToolsetOpts extends ScheduleToolDeps {
     allowDestructive?: boolean;
     /** Operator-injected extras (tests, custom plugins). */
     extraTools?: AgentTool[];
+    /**
+     * V8 inspector (CDP) tools, built from runtime debug config (`buildInspectorTools`).
+     * Operator-only, like the FS/schedule/fetch tools.
+     */
+    inspectorTools?: AgentTool[];
+    /**
+     * RBAC-filtered registry tools for the agent's configured user (from
+     * `composeRegistryTools`). Shadowed by any operator-only tool of the same name.
+     */
+    registryTools?: AgentTool[];
 }
 export interface ComposedToolset {
     tools: AgentTool[];

package/dist/agent/toolset.js

@@ -2,12 +2,12 @@
 /**
  * Tool composer for the built-in agent (#626).
  *
- * Operator-only tools (FS, schedule, fetch) are inline today. Once the
- * unified MCP tool registry (#615) lands with the Operations (#617) and
- * Application (#618) profiles, this is the seam where RBAC-filtered
- * registry tools get folded in for the agent's configured user. The shape
- * of {@link composeToolset} won't change — only the body gains a registry
- * lookup.
+ * Two sources merge here: operator-only tools (FS, schedule, fetch, inspector)
+ * that are private to this component, and RBAC-filtered tools drained from the
+ * unified MCP tool registry (#615) for the agent's configured user — the
+ * Operations profile (#617) today, adapted in `registryTools.ts`. Operator-only
+ * tools win on a name collision: a private tool must never be shadowed by a
+ * same-named registry tool, since the two have different runtime assumptions.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.composeToolset = composeToolset;
@@ -17,7 +17,17 @@ const httpFetchTool_ts_1 = require("./tools/httpFetchTool.js");
 const scheduleTool_ts_1 = require("./tools/scheduleTool.js");
 function composeToolset(opts) {
     const schedule = (0, scheduleTool_ts_1.buildScheduleTool)(opts);
-    const all = [...fsTools_ts_1.fsTools, httpFetchTool_ts_1.httpFetchTool, schedule.tool, ...(opts.extraTools ?? [])];
+    // Operator-only tools first — they own their names. Registry tools that collide are dropped.
+    const operator = [
+        ...fsTools_ts_1.fsTools,
+        httpFetchTool_ts_1.httpFetchTool,
+        schedule.tool,
+        ...(opts.inspectorTools ?? []),
+        ...(opts.extraTools ?? []),
+    ];
+    const operatorNames = new Set(operator.map((t) => t.def.name));
+    const registry = (opts.registryTools ?? []).filter((t) => !operatorNames.has(t.def.name));
+    const all = [...operator, ...registry];
     const tools = opts.allowDestructive === false ? all.filter((t) => !t.destructive) : all;
     return { tools, scheduled: schedule.pending };
 }

package/dist/agent/toolset.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolset.js","sourceRoot":"","sources":["../../agent/toolset.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAmBH,wCAKC;AAED,sCAOC;AA/BD,mDAA6C;AAC7C,+DAAyD;AACzD,6DAA2G;AAe3G,SAAgB,cAAc,CAAC,IAAwB;IACtD,MAAM,QAAQ,GAAG,IAAA,mCAAiB,EAAC,IAAI,CAAC,CAAC;IACzC,MAAM,GAAG,GAAgB,CAAC,GAAG,oBAAO,EAAE,gCAAa,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;IAChG,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACxF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,SAAgB,aAAa,CAAC,KAAkB;IAC/C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAqB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3F,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}
+{"version":3,"file":"toolset.js","sourceRoot":"","sources":["../../agent/toolset.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AA6BH,wCAeC;AAED,sCAOC;AAnDD,mDAA6C;AAC7C,+DAAyD;AACzD,6DAA2G;AAyB3G,SAAgB,cAAc,CAAC,IAAwB;IACtD,MAAM,QAAQ,GAAG,IAAA,mCAAiB,EAAC,IAAI,CAAC,CAAC;IACzC,6FAA6F;IAC7F,MAAM,QAAQ,GAAgB;QAC7B,GAAG,oBAAO;QACV,gCAAa;QACb,QAAQ,CAAC,IAAI;QACb,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;KAC1B,CAAC;IACF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1F,MAAM,GAAG,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACxF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,SAAgB,aAAa,CAAC,KAAkB;IAC/C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAqB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3F,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/agent/types.d.ts

@@ -72,4 +72,6 @@ export interface AgentConfig {
     allowDestructive: boolean;
     user: string;
     componentsScope?: string;
+    /** Operator text appended to the agent's system prompt (after the built-in grounding + best practices). */
+    systemPromptAppend?: string;
 }