@descryy/runtime-orchestrator 0.4.8 → 0.4.9

package/dist/attach-to-running-node-process.js

@@ -1,290 +0,0 @@
-/**
- * Retroactive attach to an already-running **Node** process, via its own inspector
- * protocol (JVM Attach API and ptrace remain out of scope, per
- * `documents/decisions-inbox/RT-attach-to-running-process-scope.md`).
- *
- * Unlike the file-based `attachToRunningProcess`, this needs nothing declared at
- * launch: `SIGUSR1` (POSIX only) turns on the target's inspector after the fact,
- * making `http://127.0.0.1:<port>/json` reachable even on a process never started
- * with `--inspect`.
- *
- * **Disclosed limit:** `SIGUSR1` doesn't report which port the inspector bound —
- * Node prints that to the target's own stderr, unreadable for a process we didn't
- * spawn (RT-024). So discovery tries the default port (9229) unless the caller
- * supplies `discoveryPort`; a genuinely unknown non-default port cannot be
- * discovered (not guessed at by port-scanning, which risks attaching to the wrong
- * process).
- *
- * CDP client is `cdp-client.ts`, not Playwright's console API, which assumes a
- * Target/Page-domain session a Node inspector doesn't have (see that file).
- *
- * **Measured:** a freshly-spawned target has a brief window (sometimes under
- * 100ms) before Node installs its `SIGUSR1` handler; a signal sent inside it hits
- * POSIX's default terminate action instead of toggling the inspector. Irrelevant
- * to attaching to something already running, but real for a caller attaching
- * right after spawning.
- *
- * **Measured side effect:** once CDP connects, V8 no longer terminates on an
- * uncaught exception — it blocks ("Waiting for the debugger to disconnect...")
- * exactly as under `--inspect-brk`, until `stop()` closes the session. Standard
- * CDP/V8 behaviour, not worked around; a caller checking "did the target exit
- * yet?" must call `stop()` first.
- *
- * **Vocabulary:** `Runtime.consoleAPICalled`→`CONSOLE_MESSAGE`,
- * `Runtime.exceptionThrown`→`EXCEPTION`, same `RuntimeEventType`s
- * `browser-console-collector.ts` uses for the browser-page analogues.
- * `source: "backend-process"` (not a new value — `EvidenceSource` names what was
- * observed, not the mechanism). `capabilities()` reports `backendLogAccess`, not
- * `consoleObservation` (reserved for a browser page's console).
- */
-import { spawnSync } from "node:child_process";
-import { connectCdp } from "./cdp-client.js";
-import { isProcessAlive } from "./attach-to-running-process.js";
-import { COLLECTOR_VERSION } from "./collector-version.js";
-/**
- * A-F10: verifies `pid` is owned by this process's own user AND looks like a
- * Node process, BEFORE `SIGUSR1` is sent — a wrong-kind pid with no handler hits
- * POSIX's default terminate action; `isProcessAlive` alone doesn't rule that out.
- *
- * Uses `ps -o uid=,comm= -p <pid>` rather than `/proc/<pid>` since this module is
- * POSIX-only and `ps` works on both Linux and macOS. Refuses rather than guesses
- * when `ps` itself can't answer.
- *
- * Same-user, not same-session: the kernel lets any same-user process signal any
- * other, so this check is the only backstop for `SIGUSR1` — unlike HotSpot's
- * attach socket (the JVM sibling), which enforces uid at the OS level itself.
- */
-function verifyLikelyNodeProcessOwnedBySelf(pid) {
-    const result = spawnSync("ps", ["-o", "uid=,comm=", "-p", String(pid)], { encoding: "utf8" });
-    const line = (result.stdout ?? "").trim().split("\n")[0]?.trim();
-    if (result.status !== 0 || line === undefined || line === "") {
-        return { ok: false, reason: `could not verify pid ${String(pid)}'s owner/command via ps (exit ${String(result.status)}) — refusing to signal a process this module cannot confirm the identity of` };
-    }
-    const [uidField, ...commFields] = line.split(/\s+/);
-    const uid = Number(uidField);
-    const comm = commFields.join(" ").toLowerCase();
-    const ownUid = process.getuid?.();
-    if (ownUid !== undefined && uid !== ownUid) {
-        return { ok: false, reason: `pid ${String(pid)} is owned by uid ${String(uid)}, not this process's own uid ${String(ownUid)} — refusing to signal a process this session does not own` };
-    }
-    if (!comm.includes("node")) {
-        return { ok: false, reason: `pid ${String(pid)}'s command is "${comm}", which does not look like a Node process — refusing to send SIGUSR1 to a process that may not handle it` };
-    }
-    return { ok: true };
-}
-/**
- * Sends `SIGUSR1` to `pid`, then polls `http://<host>:<port>/json` until the
- * inspector answers or `timeoutMs` elapses. Resolves with the first entry's
- * `webSocketDebuggerUrl` — a Node process presents exactly one inspectable
- * target, unlike a browser's `/json` (one per tab).
- *
- * Rejects naming the exact blocker rather than hanging or guessing: dead pid,
- * non-POSIX platform, or a port that never answers (see module doc).
- */
-export async function discoverNodeInspectorUrl(pid, options = {}) {
-    if (!isProcessAlive(pid)) {
-        throw new Error(`discoverNodeInspectorUrl: pid ${String(pid)} is not running — cannot attach to a target that does not exist.`);
-    }
-    if (process.platform === "win32") {
-        throw new Error("discoverNodeInspectorUrl: SIGUSR1 inspector activation is POSIX-only; not available on win32.");
-    }
-    // A-F10: verified BEFORE the signal — a wrong pid must never reach process.kill
-    const identity = verifyLikelyNodeProcessOwnedBySelf(pid);
-    if (!identity.ok) {
-        throw new Error(`discoverNodeInspectorUrl: ${identity.reason}.`);
-    }
-    const host = options.host ?? "127.0.0.1";
-    const port = options.port ?? 9229;
-    const timeoutMs = options.timeoutMs ?? 5000;
-    const discoveryUrl = `http://${host}:${String(port)}/json`;
-    process.kill(pid, "SIGUSR1");
-    const deadline = Date.now() + timeoutMs;
-    let lastError = null;
-    while (Date.now() < deadline) {
-        if (!isProcessAlive(pid)) {
-            throw new Error(`discoverNodeInspectorUrl: pid ${String(pid)} exited while waiting for its inspector to come up.`);
-        }
-        try {
-            const response = await fetch(discoveryUrl);
-            if (response.ok) {
-                const targets = (await response.json());
-                const target = targets.find((candidate) => candidate.webSocketDebuggerUrl !== undefined);
-                if (target?.webSocketDebuggerUrl !== undefined)
-                    return target.webSocketDebuggerUrl;
-            }
-        }
-        catch (error) {
-            lastError = error;
-        }
-        await new Promise((resolve) => setTimeout(resolve, 50));
-    }
-    const detail = lastError instanceof Error ? `: ${lastError.message}` : "";
-    throw new Error(`discoverNodeInspectorUrl: no inspector answered at ${discoveryUrl} within ${String(timeoutMs)}ms after SIGUSR1${detail}. ` +
-        "Most likely the target's inspector bound to a different port than the one checked here (already in use by another " +
-        "process, or the target was itself configured with --inspect-port/NODE_OPTIONS) — this module cannot discover a " +
-        "non-default port from outside; a caller who knows the real port must supply discoveryPort.");
-}
-/** Decodes a `file://` URL to a plain filesystem path, matching every other adapter's convention. Anything else is passed through verbatim. */
-function pathFromCdpUrl(url) {
-    if (url === undefined || url === "")
-        return null;
-    if (!url.startsWith("file://"))
-        return url;
-    try {
-        return new URL(url).pathname;
-    }
-    catch {
-        return url;
-    }
-}
-/** CDP reports 0-based line/column; converted to this codebase's 1-based convention here, once. */
-function locationFromCallFrame(frame) {
-    return {
-        file: pathFromCdpUrl(frame.url),
-        line: typeof frame.lineNumber === "number" ? frame.lineNumber + 1 : null,
-        column: typeof frame.columnNumber === "number" ? frame.columnNumber + 1 : null,
-        functionName: frame.functionName !== undefined && frame.functionName !== "" ? frame.functionName : null,
-        // V8's own reported state, captured live -- never a side artifact resolved through
-        reliability: "self-contained",
-        resolvedVia: null,
-    };
-}
-function formatConsoleArgs(args) {
-    return args
-        .map((arg) => {
-        if (arg.value !== undefined)
-            return typeof arg.value === "string" ? arg.value : JSON.stringify(arg.value);
-        if (arg.description !== undefined)
-            return arg.description;
-        return `<${arg.type ?? "unknown"}>`;
-    })
-        .join(" ");
-}
-function notThisCollectorsJob(what) {
-    return { availability: "unavailable", reason: `attachToRunningNodeProcess observes a Node process's Runtime domain (console, exceptions) only, not ${what}.` };
-}
-const CAPABILITIES = {
-    domObservation: notThisCollectorsJob("DOM inspection"),
-    // reserved for a browser page's console; this is a backend process's, reported
-    // under backendLogAccess instead, matching LogCollector's own split
-    consoleObservation: notThisCollectorsJob("a browser page's console"),
-    networkObservation: notThisCollectorsJob("network traffic"),
-    backendLogAccess: { availability: "available", reason: null },
-    distributedTrace: notThisCollectorsJob("trace-id/request-id correlation — CDP's Runtime domain carries no such fields to extract"),
-    // self-contained reliability: a bundled/compiled target still reports positions
-    // in that output verbatim, same limit every self-contained adapter carries
-    sourceMapping: { availability: "available", reason: null },
-    stackCapture: { availability: "available", reason: null },
-    processLifecycle: notThisCollectorsJob("process lifecycle — spawn/ready/exit are ProcessCollector's to observe"),
-    databaseObservation: notThisCollectorsJob("database queries"),
-    externalServiceObservation: notThisCollectorsJob("outbound external requests"),
-};
-/**
- * Attach to an already-running Node process via `SIGUSR1` + CDP, capturing
- * `CONSOLE_MESSAGE`/`EXCEPTION` evidence from that moment forward.
- *
- * **Retroactive, not historical.** Anything logged or thrown before attach is
- * gone — CDP is a live event stream with no buffer of its own (unlike the
- * file-based `attachToRunningProcess`, which recovers pre-attach lines from disk).
- *
- * Discovery/connection happen inside `start()`, matching every other `Collector`
- * here: a routine failure resolves as `{ available: false, reason }`, never a
- * thrown exception.
- */
-export function attachToRunningNodeProcess(options) {
-    let session = null;
-    return {
-        collectorId: `attach-node-inspector:${options.processId}`,
-        async start(context) {
-            let webSocketDebuggerUrl;
-            try {
-                webSocketDebuggerUrl = await discoverNodeInspectorUrl(options.pid, {
-                    ...(options.discoveryHost !== undefined ? { host: options.discoveryHost } : {}),
-                    ...(options.discoveryPort !== undefined ? { port: options.discoveryPort } : {}),
-                    ...(options.discoveryTimeoutMs !== undefined ? { timeoutMs: options.discoveryTimeoutMs } : {}),
-                });
-            }
-            catch (error) {
-                return { available: false, reason: error instanceof Error ? error.message : String(error) };
-            }
-            try {
-                session = await connectCdp(webSocketDebuggerUrl);
-            }
-            catch (error) {
-                return {
-                    available: false,
-                    reason: `attachToRunningNodeProcess: found the inspector but could not open a CDP connection to it: ${error instanceof Error ? error.message : String(error)}`,
-                };
-            }
-            await session.send("Runtime.enable");
-            session.on("Runtime.consoleAPICalled", (params) => {
-                const p = params;
-                context.emit({
-                    timestamp: new Date().toISOString(),
-                    source: "backend-process",
-                    service: options.service ?? null,
-                    process: options.processId,
-                    eventType: "CONSOLE_MESSAGE",
-                    payload: { level: p.type ?? "log", text: formatConsoleArgs(p.args ?? []) },
-                    traceId: null,
-                    requestId: null,
-                    correlationId: null,
-                    graphNodeId: null,
-                    sourceLocation: null,
-                    stackTrace: null,
-                    confidence: 1,
-                    redactionStatus: "pending-redaction",
-                    collectorVersion: COLLECTOR_VERSION,
-                });
-            });
-            session.on("Runtime.exceptionThrown", (params) => {
-                const p = params;
-                const details = p.exceptionDetails ?? {};
-                const description = details.exception?.description;
-                const message = description !== undefined
-                    ? (description.split("\n")[0] ?? description)
-                    : details.exception?.value !== undefined
-                        ? String(details.exception.value)
-                        : (details.text ?? "Uncaught exception");
-                const callFrames = details.stackTrace?.callFrames ?? [];
-                const frames = callFrames.map((frame) => ({ location: locationFromCallFrame(frame), raw: `${frame.functionName ?? "<anonymous>"} (${frame.url ?? ""}:${String(frame.lineNumber)}:${String(frame.columnNumber)})` }));
-                // no frames from CDP: fall back to the throw site itself as a synthetic
-                // one-frame trace rather than discarding it
-                const stackTrace = frames.length > 0
-                    ? { fidelity: "synchronous", frames, primaryFrameIndex: 0 }
-                    : {
-                        fidelity: "synchronous",
-                        frames: [{ location: locationFromCallFrame({ url: details.url, lineNumber: details.lineNumber, columnNumber: details.columnNumber }), raw: description ?? message }],
-                        primaryFrameIndex: 0,
-                    };
-                context.emit({
-                    timestamp: new Date().toISOString(),
-                    source: "backend-process",
-                    service: options.service ?? null,
-                    process: options.processId,
-                    eventType: "EXCEPTION",
-                    payload: { message, stack: description ?? null },
-                    traceId: null,
-                    requestId: null,
-                    correlationId: null,
-                    graphNodeId: null,
-                    sourceLocation: stackTrace.frames[stackTrace.primaryFrameIndex]?.location ?? null,
-                    stackTrace,
-                    confidence: 1,
-                    redactionStatus: "pending-redaction",
-                    collectorVersion: COLLECTOR_VERSION,
-                });
-            });
-            return { available: true };
-        },
-        stop() {
-            session?.close();
-            session = null;
-            return Promise.resolve();
-        },
-        capabilities() {
-            return CAPABILITIES;
-        },
-    };
-}
-//# sourceMappingURL=attach-to-running-node-process.js.map

package/dist/attach-to-running-node-process.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"attach-to-running-node-process.js","sourceRoot":"","sources":["../src/attach-to-running-node-process.ts"],"names":[],"mappings":"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"}

package/dist/attach-to-running-process.d.ts

@@ -1,83 +0,0 @@
-/**
- * Attach observation to a process Descry did not spawn.
- *
- * Node/POSIX give no way to retroactively attach to another process's
- * stdout/stderr fds after the fact — pipes are only wired at spawn time. So true
- * generic attach (a process that logs to a TTY, or never wrote output anywhere
- * reachable) is not implemented; it would need a per-language debugger/inspector
- * protocol, scoped separately in `documents/decisions-inbox/RT-attach-to-running-process-scope.md`.
- *
- * What IS implemented: attaching to a process already directed to write output to
- * a file Descry can read (e.g. `npm run dev > server.log 2>&1 &`).
- * `attachToRunningProcess` verifies the target pid is alive, then reuses `execute`'s
- * live-tail machinery, catching up on what the file already held and tailing new
- * writes the same way.
- *
- * **Shares `execute`'s identity gap (RT-024).** `isProcessAlive` confirms a process
- * with this pid exists, not that it's the one the caller thinks — pids are reused.
- * Disclosed, not solved, same as `readiness.ts`.
- */
-import type { ProcessOutputSource } from "@descryy/runtime-backend-observation";
-import { type AttachFence } from "@descryy/runtime-controller";
-export interface AttachToRunningProcessOptions {
-    readonly processId: string;
-    /** The pid of the already-running target. Verified alive before attaching, and re-checked on every poll to detect exit. */
-    readonly pid: number;
-    /** Path to a file the target process is already writing its stdout/stderr to. Read in full on every poll — same growing-buffer contract `ManagedProcess.readOutput()` has, not a delta. */
-    readonly logFilePath: string;
-    /**
-     * The declared service this pid is. Optional because a bare-pid attach may
-     * genuinely have none declared — omitting it resolves to `null`, a statement,
-     * not a gap. Without it, correlation can't look up a scope for this source.
-     */
-    readonly serviceName?: string | null;
-    /**
-     * True once the caller's observation window has closed. Required: a source has
-     * two independent end conditions (target exited, or caller stopped watching),
-     * and the liveness check alone never fires for a healthy target — without this,
-     * the source polls forever, the final unflushed line is lost, and a consumer
-     * that stops iterating never gets its generator back. Same signal
-     * `instrumented-execution.ts` uses before `collector.stop()`.
-     */
-    readonly stopObserving: () => boolean;
-    readonly pollIntervalMs?: number;
-}
-/**
- * `process.kill(pid, 0)` sends no signal — it only asks the kernel whether
- * delivery would be possible. `ESRCH` means no such pid; `EPERM` means a
- * pid we don't own but that unambiguously exists, still alive for this
- * purpose. Any other error is treated as "exists" rather than guessed away.
- */
-export declare function isProcessAlive(pid: number): boolean;
-/**
- * `attachToRunningProcess`'s return value: a `ProcessOutputSource` (structurally
- * unchanged, so every existing consumer keeps working unmodified) plus the
- * attach-time fence (RT-N3) that produced its `preExistingLineCount`. Exposed so
- * a caller can disclose it -- the process's own start time, whether some other
- * process also holds the log file open, and the recorded attach offset -- rather
- * than that information existing only internally to this function.
- */
-export interface AttachedProcessOutputSource extends ProcessOutputSource {
-    readonly attachFence: AttachFence;
-}
-/**
- * Attach to an already-running process via a log file it is already writing to.
- * Throws immediately if the pid isn't alive — refuses rather than returning a
- * source that would silently never emit anything.
- *
- * Lines already in `logFilePath` at attach time are yielded first, followed by
- * whatever the target writes afterward — indistinguishable from `execute`'s live
- * tail once attached, EXCEPT that each pre-existing line carries
- * `ProcessOutputLine.preExisting: true` (RT-N3, `computeAttachFence`) — real,
- * captured evidence, but evidence this run did not watch happen. A consumer that
- * turns these lines into `Evidence` (e.g. `createLogCollector`) is expected to
- * carry that flag through to `Evidence.preExisting`, and a promotion path that
- * would otherwise mint or confirm an R4 graph edge from it must refuse (see
- * `resolveObservedCrossServiceCall`, `@descryy/runtime-graph-correlator`).
- *
- * Ends when the caller's window closes or the target exits, whichever comes
- * first (see `stopObserving`) — both are needed, or a healthy target polls
- * forever, or a dead one polls until the caller notices.
- */
-export declare function attachToRunningProcess(options: AttachToRunningProcessOptions): AttachedProcessOutputSource;
-//# sourceMappingURL=attach-to-running-process.d.ts.map

package/dist/attach-to-running-process.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attach-to-running-process.d.ts","sourceRoot":"","sources":["../src/attach-to-running-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAInF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2HAA2H;IAC3H,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2LAA2L;IAC3L,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,2BAA2B,CAkC1G"}

package/dist/attach-to-running-process.js

@@ -1,86 +0,0 @@
-/**
- * Attach observation to a process Descry did not spawn.
- *
- * Node/POSIX give no way to retroactively attach to another process's
- * stdout/stderr fds after the fact — pipes are only wired at spawn time. So true
- * generic attach (a process that logs to a TTY, or never wrote output anywhere
- * reachable) is not implemented; it would need a per-language debugger/inspector
- * protocol, scoped separately in `documents/decisions-inbox/RT-attach-to-running-process-scope.md`.
- *
- * What IS implemented: attaching to a process already directed to write output to
- * a file Descry can read (e.g. `npm run dev > server.log 2>&1 &`).
- * `attachToRunningProcess` verifies the target pid is alive, then reuses `execute`'s
- * live-tail machinery, catching up on what the file already held and tailing new
- * writes the same way.
- *
- * **Shares `execute`'s identity gap (RT-024).** `isProcessAlive` confirms a process
- * with this pid exists, not that it's the one the caller thinks — pids are reused.
- * Disclosed, not solved, same as `readiness.ts`.
- */
-import { readFileSync } from "node:fs";
-import { computeAttachFence } from "@descryy/runtime-controller";
-import { createPollingProcessOutputSource } from "./polling-output-source.js";
-/**
- * `process.kill(pid, 0)` sends no signal — it only asks the kernel whether
- * delivery would be possible. `ESRCH` means no such pid; `EPERM` means a
- * pid we don't own but that unambiguously exists, still alive for this
- * purpose. Any other error is treated as "exists" rather than guessed away.
- */
-export function isProcessAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (error) {
-        return error.code === "EPERM";
-    }
-}
-/**
- * Attach to an already-running process via a log file it is already writing to.
- * Throws immediately if the pid isn't alive — refuses rather than returning a
- * source that would silently never emit anything.
- *
- * Lines already in `logFilePath` at attach time are yielded first, followed by
- * whatever the target writes afterward — indistinguishable from `execute`'s live
- * tail once attached, EXCEPT that each pre-existing line carries
- * `ProcessOutputLine.preExisting: true` (RT-N3, `computeAttachFence`) — real,
- * captured evidence, but evidence this run did not watch happen. A consumer that
- * turns these lines into `Evidence` (e.g. `createLogCollector`) is expected to
- * carry that flag through to `Evidence.preExisting`, and a promotion path that
- * would otherwise mint or confirm an R4 graph edge from it must refuse (see
- * `resolveObservedCrossServiceCall`, `@descryy/runtime-graph-correlator`).
- *
- * Ends when the caller's window closes or the target exits, whichever comes
- * first (see `stopObserving`) — both are needed, or a healthy target polls
- * forever, or a dead one polls until the caller notices.
- */
-export function attachToRunningProcess(options) {
-    if (!isProcessAlive(options.pid)) {
-        throw new Error(`attachToRunningProcess: pid ${options.pid} for "${options.processId}" is not running — attach requires ` +
-            `a target that already exists. Use ExecutionController.run() to spawn a new process instead.`);
-    }
-    const attachFence = computeAttachFence(options.pid, options.logFilePath);
-    const source = createPollingProcessOutputSource({
-        processId: options.processId,
-        // an ad-hoc attach may have no declared service; null is the honest answer
-        serviceName: options.serviceName ?? null,
-        readOutput: () => {
-            try {
-                return readFileSync(options.logFilePath, "utf8");
-            }
-            catch (error) {
-                const detail = error instanceof Error ? error.message : String(error);
-                throw new Error(`attachToRunningProcess: could not read log file "${options.logFilePath}" for pid ${options.pid}: ${detail}`);
-            }
-        },
-        // either reason ends the source; dropping the liveness half would leave a
-        // target that dies mid-window polled until the caller noticed
-        isFinished: () => options.stopObserving() || !isProcessAlive(options.pid),
-        // RT-N3: everything already in the file at attach time is marked, not
-        // discarded -- see `AttachedProcessOutputSource`'s doc.
-        preExistingLineCount: attachFence.preExistingLineCount,
-        ...(options.pollIntervalMs !== undefined ? { pollIntervalMs: options.pollIntervalMs } : {}),
-    });
-    return { ...source, attachFence };
-}
-//# sourceMappingURL=attach-to-running-process.js.map

package/dist/attach-to-running-process.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"attach-to-running-process.js","sourceRoot":"","sources":["../src/attach-to-running-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,EAAE,kBAAkB,EAAoB,MAAM,6BAA6B,CAAC;AAEnF,OAAO,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AA0B9E;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAQ,KAA+B,CAAC,IAAI,KAAK,OAAO,CAAC;IAC3D,CAAC;AACH,CAAC;AAcD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAsC;IAC3E,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,+BAA+B,OAAO,CAAC,GAAG,SAAS,OAAO,CAAC,SAAS,qCAAqC;YACvG,6FAA6F,CAChG,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAG,gCAAgC,CAAC;QAC9C,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,2EAA2E;QAC3E,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,UAAU,EAAE,GAAG,EAAE;YACf,IAAI,CAAC;gBACH,OAAO,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtE,MAAM,IAAI,KAAK,CACb,oDAAoD,OAAO,CAAC,WAAW,aAAa,OAAO,CAAC,GAAG,KAAK,MAAM,EAAE,CAC7G,CAAC;YACJ,CAAC;QACH,CAAC;QACD,0EAA0E;QAC1E,8DAA8D;QAC9D,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC;QACzE,sEAAsE;QACtE,wDAAwD;QACxD,oBAAoB,EAAE,WAAW,CAAC,oBAAoB;QACtD,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5F,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC;AACpC,CAAC"}

package/dist/cdp-client.d.ts

@@ -1,27 +0,0 @@
-/**
- * A minimal Chrome DevTools Protocol client over a raw `ws://` URL.
- *
- * `packages/browser` speaks CDP only through Playwright's console API, which owns its
- * own WebSocket and Target/Page framing and has no "connect to an arbitrary ws:// and
- * read raw CDP frames" surface — a Node inspector session has no Target/Page domains
- * at all, so that abstraction doesn't fit. Kept protocol-family-generic (no "Node" or
- * "browser" knowledge) so either kind of CDP target can reuse it.
- *
- * CDP-over-WebSocket is JSON-RPC-shaped: a sent message carries `id` and gets exactly
- * one `{id, result}` or `{id, error}` reply; an event has `method`/`params`, no `id`.
- * This client does only that framing — method names and event shapes are the caller's.
- */
-export interface CdpSession {
-    /** Sends a CDP command and resolves with its `result` once the matching `id` reply arrives. Rejects on a CDP-reported `error` or if the socket closes first. */
-    send<T = unknown>(method: string, params?: Record<string, unknown>): Promise<T>;
-    /** Subscribes to a CDP event by method name (e.g. `"Runtime.consoleAPICalled"`). Returns an unsubscribe function. */
-    on(method: string, handler: (params: Record<string, unknown>) => void): () => void;
-    /** Closes the underlying WebSocket. Idempotent. Rejects every still-pending `send()`. */
-    close(): void;
-}
-/**
- * Resolves once the socket is open, or rejects if it errors/closes first —
- * so a caller never has to race `open` against `error` itself.
- */
-export declare function connectCdp(webSocketUrl: string): Promise<CdpSession>;
-//# sourceMappingURL=cdp-client.d.ts.map

package/dist/cdp-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cdp-client.d.ts","sourceRoot":"","sources":["../src/cdp-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,UAAU;IACzB,gKAAgK;IAChK,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChF,qHAAqH;IACrH,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnF,yFAAyF;IACzF,KAAK,IAAI,IAAI,CAAC;CACf;AAOD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAgFpE"}

package/dist/cdp-client.js

@@ -1,98 +0,0 @@
-/**
- * A minimal Chrome DevTools Protocol client over a raw `ws://` URL.
- *
- * `packages/browser` speaks CDP only through Playwright's console API, which owns its
- * own WebSocket and Target/Page framing and has no "connect to an arbitrary ws:// and
- * read raw CDP frames" surface — a Node inspector session has no Target/Page domains
- * at all, so that abstraction doesn't fit. Kept protocol-family-generic (no "Node" or
- * "browser" knowledge) so either kind of CDP target can reuse it.
- *
- * CDP-over-WebSocket is JSON-RPC-shaped: a sent message carries `id` and gets exactly
- * one `{id, result}` or `{id, error}` reply; an event has `method`/`params`, no `id`.
- * This client does only that framing — method names and event shapes are the caller's.
- */
-/**
- * Resolves once the socket is open, or rejects if it errors/closes first —
- * so a caller never has to race `open` against `error` itself.
- */
-export function connectCdp(webSocketUrl) {
-    return new Promise((resolveConnect, rejectConnect) => {
-        const socket = new WebSocket(webSocketUrl);
-        const pending = new Map();
-        const listeners = new Map();
-        let nextId = 1;
-        let settled = false;
-        function failAllPending(error) {
-            for (const { reject } of pending.values())
-                reject(error);
-            pending.clear();
-        }
-        socket.addEventListener("open", () => {
-            settled = true;
-            resolveConnect({
-                send(method, params = {}) {
-                    const id = nextId++;
-                    return new Promise((resolve, reject) => {
-                        pending.set(id, { resolve: resolve, reject });
-                        socket.send(JSON.stringify({ id, method, params }));
-                    });
-                },
-                on(method, handler) {
-                    let set = listeners.get(method);
-                    if (set === undefined) {
-                        set = new Set();
-                        listeners.set(method, set);
-                    }
-                    set.add(handler);
-                    return () => set.delete(handler);
-                },
-                close() {
-                    socket.close();
-                },
-            });
-        });
-        socket.addEventListener("message", (event) => {
-            const raw = typeof event.data === "string" ? event.data : String(event.data);
-            let msg;
-            try {
-                msg = JSON.parse(raw);
-            }
-            catch {
-                // non-JSON frame: not a valid CDP message, dropped rather than thrown
-                return;
-            }
-            if (msg.id !== undefined) {
-                const waiting = pending.get(msg.id);
-                if (waiting === undefined)
-                    return;
-                pending.delete(msg.id);
-                if (msg.error !== undefined) {
-                    waiting.reject(new Error(`CDP error for message ${String(msg.id)}: ${msg.error.message}`));
-                }
-                else {
-                    waiting.resolve(msg.result);
-                }
-                return;
-            }
-            if (msg.method !== undefined) {
-                const set = listeners.get(msg.method);
-                if (set === undefined)
-                    return;
-                for (const handler of set)
-                    handler(msg.params ?? {});
-            }
-        });
-        socket.addEventListener("error", () => {
-            const error = new Error(`CDP WebSocket error connecting to ${webSocketUrl}`);
-            if (!settled) {
-                settled = true;
-                rejectConnect(error);
-            }
-            failAllPending(error);
-        });
-        socket.addEventListener("close", () => {
-            failAllPending(new Error(`CDP WebSocket to ${webSocketUrl} closed`));
-        });
-    });
-}
-//# sourceMappingURL=cdp-client.js.map

package/dist/cdp-client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cdp-client.js","sourceRoot":"","sources":["../src/cdp-client.ts"],"names":[],"mappings":"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"}