crosspad-mcp-server 8.1.2 → 9.1.0

package/dist/tools/trace-buffer.js

@@ -0,0 +1,74 @@
+export class TraceBuffer {
+    signals;
+    capacity;
+    buf = [];
+    constructor(signals, capacity) {
+        this.signals = signals;
+        this.capacity = capacity;
+    }
+    push(s) {
+        this.buf.push(s);
+        if (this.buf.length > this.capacity)
+            this.buf.shift();
+    }
+    count() { return this.buf.length; }
+    signalNames() { return [...this.signals]; }
+    /** Add a signal to the watched set (no-op if already present). Does not touch
+     *  stored samples — history of a previously-removed signal survives in the ring. */
+    addSignal(name) {
+        if (!this.signals.includes(name))
+            this.signals.push(name);
+    }
+    /** Drop a signal from the watched set (no-op if absent). Stored samples are
+     *  left intact so already-captured history remains queryable until it ages out. */
+    removeSignal(name) {
+        const i = this.signals.indexOf(name);
+        if (i >= 0)
+            this.signals.splice(i, 1);
+    }
+    stats(sig) {
+        const pts = this.buf.filter((s) => sig in s.values);
+        if (pts.length === 0)
+            return null;
+        let min = Infinity, max = -Infinity, sum = 0;
+        for (const p of pts) {
+            const v = p.values[sig];
+            if (v < min)
+                min = v;
+            if (v > max)
+                max = v;
+            sum += v;
+        }
+        const first = pts[0], last = pts[pts.length - 1];
+        const dt = last.t - first.t;
+        const slope = dt !== 0 ? (last.values[sig] - first.values[sig]) / dt : 0;
+        return { min, max, avg: sum / pts.length, last: last.values[sig], slope, first_t: first.t, last_t: last.t, n: pts.length };
+    }
+    downsample(sig, maxPoints, window) {
+        let pts = this.buf
+            .filter((s) => sig in s.values)
+            .map((s) => ({ t: s.t, v: s.values[sig] }));
+        if (window) {
+            const lo = window.fromT ?? -Infinity, hi = window.toT ?? Infinity;
+            pts = pts.filter((p) => p.t >= lo && p.t <= hi);
+        }
+        if (pts.length <= maxPoints)
+            return pts;
+        const last = pts[pts.length - 1];
+        if (maxPoints <= 1)
+            return [last];
+        const stride = Math.ceil(pts.length / maxPoints);
+        const out = [];
+        for (let i = 0; i < pts.length - 1; i += stride) {
+            out.push(pts[i]);
+            if (out.length >= maxPoints - 1)
+                break;
+        }
+        if (out[out.length - 1].t !== last.t)
+            out.push(last);
+        return out;
+    }
+    /** Read-only view of stored samples (oldest→newest). */
+    samples() { return this.buf; }
+}
+//# sourceMappingURL=trace-buffer.js.map

package/dist/tools/trace-buffer.js.map

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

package/dist/tools/trace-device.d.ts

@@ -0,0 +1,10 @@
+export interface DeviceStateResult {
+    success: boolean;
+    regs?: Record<string, number | null>;
+    decoded?: Record<string, unknown>;
+    accessible?: boolean;
+    error?: string;
+}
+/** Pure: extract the device_state JSON from mixed daemon output (scan lines reverse). */
+export declare function parseDeviceState(out: string): DeviceStateResult;
+export declare function getDeviceState(signal?: AbortSignal): Promise<DeviceStateResult>;

package/dist/tools/trace-device.js

@@ -0,0 +1,26 @@
+import { runArgvStream } from "../utils/exec.js";
+import { daemonPath, resolvedPython } from "./trace-symbols.js";
+/** Pure: extract the device_state JSON from mixed daemon output (scan lines reverse). */
+export function parseDeviceState(out) {
+    const lines = out.split("\n").map((l) => l.trim()).filter(Boolean);
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const l = lines[i];
+        if (l.startsWith("{") && l.includes('"device_state"')) {
+            try {
+                const o = JSON.parse(l);
+                if (o.type === "device_state") {
+                    return { success: true, regs: o.regs, decoded: o.decoded, accessible: o.accessible, error: o.error };
+                }
+            }
+            catch { /* keep scanning */ }
+        }
+    }
+    return { success: false, error: out.split("\n").filter(Boolean).slice(-3).join(" | ") || "no output" };
+}
+export async function getDeviceState(signal) {
+    let out = "";
+    await runArgvStream(resolvedPython(), [daemonPath(), "device-state"], process.cwd(), (s, line) => { if (s === "stdout")
+        out += line + "\n"; }, 30_000, signal);
+    return parseDeviceState(out);
+}
+//# sourceMappingURL=trace-device.js.map

package/dist/tools/trace-device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-device.js","sourceRoot":"","sources":["../../src/tools/trace-device.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAUhE,yFAAyF;AACzF,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnE,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACxB,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;gBACvG,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;AACzG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAoB;IACvD,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,MAAM,aAAa,CAAC,cAAc,EAAE,EAAE,CAAC,UAAU,EAAE,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,EACjF,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,QAAQ;QAAE,GAAG,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5E,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC"}

package/dist/tools/trace-doctor.d.ts

@@ -0,0 +1,43 @@
+export type Severity = "blocking" | "error" | "warning" | "info";
+export interface DoctorIssue {
+    id: string;
+    severity: Severity;
+    detail: string;
+    suggested_fix: string;
+}
+export interface DoctorProbe {
+    pyocdInstalled: () => boolean;
+    elfPath: () => string;
+    elfExists: () => boolean;
+    stlinkProbe: () => {
+        found: boolean;
+        serial?: string;
+        chipid?: string;
+    };
+    udevRulesPresent: () => boolean;
+    /** Which user-config keys are explicitly set (not on fallback). */
+    configKeysSet: () => string[];
+    /** §11.7 real probe-presence detection. Runs `pyocd list` (preferred, via the
+     *  daemon python) or `st-info --probe` with a short timeout. `present` =
+     *  at least one probe enumerated; `toolAvailable` distinguishes "no probe on
+     *  USB" from "neither pyocd nor st-info installed" (the latter must NOT be a
+     *  false "no probe"). */
+    probeList?: () => Promise<{
+        present: boolean;
+        toolAvailable: boolean;
+    }>;
+}
+export interface DoctorResult {
+    ok: boolean;
+    issues: DoctorIssue[];
+    probe?: {
+        serial?: string;
+        chipid?: string;
+    };
+}
+export declare function runDoctor(p: DoctorProbe): Promise<DoctorResult>;
+/**
+ * Production wiring: reads the actual filesystem, runs st-info, and imports
+ * pyocd to validate the environment. Safe to call even when tools are absent.
+ */
+export declare function realProbe(): DoctorProbe;

package/dist/tools/trace-doctor.js

@@ -0,0 +1,150 @@
+// src/tools/trace-doctor.ts
+import fs from "fs";
+import { runCommand } from "../utils/exec.js";
+import { resolveConfigValue, loadUserConfig } from "../utils/userConfig.js";
+import { STM_ELF_DEFAULT } from "../config.js";
+export async function runDoctor(p) {
+    const issues = [];
+    if (!p.pyocdInstalled()) {
+        issues.push({
+            id: "pyocd_missing",
+            severity: "blocking",
+            detail: "pyocd Python package not importable — required to talk to the ST-Link.",
+            suggested_fix: "Run: pip install pyocd pyelftools  (use the interpreter set in config key 'pyocd_python').",
+        });
+    }
+    if (!p.elfExists()) {
+        issues.push({
+            id: "elf_missing",
+            severity: "blocking",
+            detail: `Firmware ELF not found at ${p.elfPath()} — symbol resolution needs it.`,
+            suggested_fix: "Build a Debug firmware (cmake --build build/Debug) or set config key 'stm_elf_path' to the real ELF.",
+        });
+    }
+    const probe = p.stlinkProbe();
+    // st-info's negative is authoritative ONLY when the §11.7 probeList check
+    // (`pyocd list` — the actual trace mechanism) isn't wired. stlinkProbe()
+    // returns found:false when st-info is merely *not installed*, which must not
+    // block tracing if pyocd can still enumerate the probe. When probeList is
+    // present it owns probe presence (below), so skip this redundant block.
+    if (!probe.found && !p.probeList) {
+        issues.push({
+            id: "probe_missing",
+            severity: "blocking",
+            detail: "No ST-Link probe detected (st-info --probe found nothing).",
+            suggested_fix: "Connect the ST-Link, check the SWD cable and target power.",
+        });
+    }
+    if (!p.udevRulesPresent()) {
+        issues.push({
+            id: "udev_missing",
+            severity: "warning",
+            detail: "No ST-Link udev rules found in /etc/udev/rules.d — pyOCD/libusb may be denied access without root.",
+            suggested_fix: "Install ST-Link udev rules: write /etc/udev/rules.d/49-stlinkv2.rules (SUBSYSTEMS=='usb', ATTRS{idVendor}=='0483', ATTRS{idProduct}=='3748', MODE='0666'), then: sudo udevadm control --reload-rules && sudo udevadm trigger. (st-info succeeding only proves the current user already has access.)",
+        });
+    }
+    // §11.7 real probe-presence check (distinct from the st-info `probe_missing`
+    // above and from the udev warning). Blocks `start` so a vanished/replug-needed
+    // ST-Link surfaces a clear, actionable error instead of a daemon connect hang.
+    // "tool missing" (neither pyocd nor st-info installed) is a non-fatal note, not
+    // a false "no probe".
+    if (p.probeList) {
+        const r = await p.probeList();
+        if (!r.toolAvailable) {
+            issues.push({
+                id: "probe_list_tool_missing",
+                severity: "info",
+                detail: "Could not run a probe-presence check — neither `pyocd list` nor `st-info` is available.",
+                suggested_fix: "Install pyocd (pip install pyocd) or stlink-tools (st-info) to enable USB probe detection.",
+            });
+        }
+        else if (!r.present) {
+            issues.push({
+                id: "no_probe_detected",
+                severity: "error",
+                detail: "No ST-Link detected on USB (replug the probe).",
+                suggested_fix: "Reconnect the ST-Link USB cable; verify with `pyocd list` / `lsusb`.",
+            });
+        }
+    }
+    if (p.configKeysSet().length === 0) {
+        issues.push({
+            id: "config_defaults",
+            severity: "info",
+            detail: "No user-config keys set — all paths are on built-in/env defaults.",
+            suggested_fix: "After resolving the above, persist resolved paths with crosspad_trace action=config_set.",
+        });
+    }
+    const ok = !issues.some((i) => i.severity === "blocking" || i.severity === "error");
+    return { ok, issues, probe: probe.found ? { serial: probe.serial, chipid: probe.chipid } : undefined };
+}
+function resolvedElfPath() {
+    return resolveConfigValue("stm_elf_path", "CROSSPAD_STM_ELF", process.env.CROSSPAD_STM_ELF, STM_ELF_DEFAULT);
+}
+function resolvedPython() {
+    return resolveConfigValue("pyocd_python", "CROSSPAD_TRACE_PYTHON", process.env.CROSSPAD_TRACE_PYTHON, "python3");
+}
+/**
+ * Production wiring: reads the actual filesystem, runs st-info, and imports
+ * pyocd to validate the environment. Safe to call even when tools are absent.
+ */
+export function realProbe() {
+    return {
+        pyocdInstalled: () => {
+            const r = runCommand(`${resolvedPython()} -c "import pyocd, elftools"`, process.cwd(), 10_000);
+            return r.success;
+        },
+        elfPath: resolvedElfPath,
+        elfExists: () => {
+            try {
+                return fs.existsSync(resolvedElfPath());
+            }
+            catch {
+                return false;
+            }
+        },
+        stlinkProbe: () => {
+            const r = runCommand("st-info --probe", process.cwd(), 10_000);
+            if (!r.success || !/Found \d+ stlink/i.test(r.stdout))
+                return { found: false };
+            const serial = r.stdout.match(/serial:\s*([0-9A-Fa-f]+)/)?.[1];
+            const chipid = r.stdout.match(/chipid:\s*(0x[0-9A-Fa-f]+)/)?.[1];
+            return { found: true, serial, chipid };
+        },
+        udevRulesPresent: () => {
+            try {
+                return fs.readdirSync("/etc/udev/rules.d").some((f) => /stlink|49-stlinkv/i.test(f));
+            }
+            catch {
+                return false;
+            }
+        },
+        configKeysSet: () => Object.keys(loadUserConfig()),
+        // §11.7: enumerate USB probes. Prefer `pyocd list` (same python the daemon
+        // uses, so it sees exactly what the trace will); fall back to `st-info
+        // --probe`. Short timeouts — a wedged/absent probe must fail fast, not hang.
+        probeList: async () => {
+            // `<python> -m pyocd list` prints one row per probe; "No available debug
+            // probes" (or an empty table) when none are connected.
+            const py = runCommand(`${resolvedPython()} -m pyocd list`, process.cwd(), 8_000);
+            if (py.success) {
+                const present = /\b0\d{6,}|STLink|ST-LINK|\bstlink\b/i.test(py.stdout) && !/no available debug probes/i.test(py.stdout);
+                // pyocd prints a header row even with 0 probes; treat an explicit
+                // "No available debug probes" OR a body with no probe-id rows as empty.
+                const hasRow = py.stdout.split("\n").some((l) => /^\s*\d+\s/.test(l));
+                return { present: present || hasRow, toolAvailable: true };
+            }
+            // pyocd absent/failed → try st-info.
+            const st = runCommand("st-info --probe", process.cwd(), 8_000);
+            if (st.success || st.stdout.length > 0) {
+                const present = /Found [1-9]\d* stlink/i.test(st.stdout);
+                // st-info ran (even "Found 0 stlink programmers" is a successful run).
+                const toolAvailable = /Found \d+ stlink/i.test(st.stdout) || st.success;
+                return { present, toolAvailable };
+            }
+            // Neither tool produced usable output → tool missing, not "no probe".
+            return { present: false, toolAvailable: false };
+        },
+    };
+}
+//# sourceMappingURL=trace-doctor.js.map

package/dist/tools/trace-doctor.js.map

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

package/dist/tools/trace-export.d.ts

@@ -0,0 +1,4 @@
+import { TraceBuffer } from "./trace-buffer.js";
+/** Render the buffer as CSV. Uses the documented samples() accessor on TraceBuffer. */
+export declare function bufferToCsv(buf: TraceBuffer, signals: string[]): string;
+export declare function writeCsv(path: string, buf: TraceBuffer, signals: string[]): void;

package/dist/tools/trace-export.js

@@ -0,0 +1,14 @@
+import fs from "fs";
+/** Render the buffer as CSV. Uses the documented samples() accessor on TraceBuffer. */
+export function bufferToCsv(buf, signals) {
+    const rows = [signals.length ? `t,${signals.join(",")}` : "t"];
+    for (const s of buf.samples()) {
+        const cells = signals.map((sig) => (sig in s.values ? String(s.values[sig]) : ""));
+        rows.push([String(s.t), ...cells].join(","));
+    }
+    return rows.join("\n");
+}
+export function writeCsv(path, buf, signals) {
+    fs.writeFileSync(path, bufferToCsv(buf, signals));
+}
+//# sourceMappingURL=trace-export.js.map

package/dist/tools/trace-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-export.js","sourceRoot":"","sources":["../../src/tools/trace-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAGpB,uFAAuF;AACvF,MAAM,UAAU,WAAW,CAAC,GAAgB,EAAE,OAAiB;IAC7D,MAAM,IAAI,GAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACzE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,GAAgB,EAAE,OAAiB;IACxE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/tools/trace-session.d.ts

@@ -0,0 +1,118 @@
+import { TraceBuffer } from "./trace-buffer.js";
+export interface SignalSpec {
+    name: string;
+    address: number;
+    size: number;
+    encoding: string;
+}
+export type Frame = {
+    type: "sample";
+    t: number;
+    values: Record<string, number>;
+} | {
+    type: "status";
+    device_state: string;
+    t?: number;
+    samples?: number;
+} | {
+    type: "error";
+    error: string;
+} | {
+    type: "signals";
+    signals: SignalSpec[];
+    unresolved: string[];
+};
+/** Pure: parse one NDJSON line from the daemon into a Frame, or null. */
+export declare function parseFrame(line: string): Frame | null;
+export interface SessionOpts {
+    signals: string[];
+    rateHz: number;
+    elf?: string;
+    outFile?: string;
+    capacity?: number;
+    swo?: string[];
+}
+export declare class TraceSession {
+    private opts;
+    private proc;
+    buffer: TraceBuffer;
+    deviceState: string;
+    startedAt: number;
+    filePath: string | null;
+    private stdoutBuf;
+    private onFrameExtra;
+    private pendingReconcile;
+    private termTimer;
+    private killTimer;
+    private static readonly STDERR_RING;
+    private stderrLines;
+    private stderrBuf;
+    private sawErrorFrame;
+    private firstFrameSeen;
+    private firstFrameWaiters;
+    constructor(opts: SessionOpts);
+    onFrame(cb: (f: Frame) => void): void;
+    /** Detach the frame sink so late `sample`/`status` frames during a shutdown
+     *  race aren't rebroadcast after `trace_end`, and the consumer (Dashboard)
+     *  doesn't hold this session longer than necessary. */
+    offFrame(): void;
+    private stoppedCbs;
+    /** Register a callback for when the daemon process has fully exited. If the
+     *  process is already gone, fires synchronously. */
+    onStopped(cb: () => void): void;
+    private fireStopped;
+    /** The ELF this session traces against (explicit opt or the configured default).
+     *  Used by the web UI's /symbols endpoint so autocomplete matches the trace. */
+    elfPath(): string;
+    start(): void;
+    /** §11.6: fold daemon stderr into a bounded ring (last STDERR_RING lines). */
+    private ingestStderr;
+    /** §11.6: the last `n` captured daemon stderr lines, newest last. */
+    stderrTail(n?: number): string;
+    /** Daemon exited. §11.6: if it died non-zero WITHOUT emitting an error frame,
+     *  synthesize an `error: <stderr tail>` device_state so status/start never
+     *  reports a stale "running" for a process that's actually dead. */
+    private onExit;
+    private ingest;
+    /** Reconcile the buffer's watched-signal set to match the daemon's authoritative
+     *  list (from a "signals" frame): add any new names, drop any no longer present. */
+    private reconcileSignals;
+    /** Add signals to the live poll set (NDJSON `add` to daemon stdin).
+     *  Resolves with the POST-reconcile signal-name set once the daemon's next
+     *  "signals" frame is ingested (PROTOCOL §4); ~2 s timeout → resolves with the
+     *  current `buffer.signalNames()` so a missing frame never hangs the caller. */
+    addSignals(specs: string[]): Promise<string[]>;
+    /** Remove signals from the live poll set (NDJSON `remove` to daemon stdin).
+     *  Same post-reconcile / timeout contract as addSignals. */
+    removeSignals(specs: string[]): Promise<string[]>;
+    /** Queue a resolver fired by the next "signals" frame; falls back to the
+     *  current signal set after ~2 s so callers can't hang on a silent daemon. */
+    private awaitReconcile;
+    /** §11.6: resolve on the FIRST ingested frame (signals|sample|error), or
+     *  `null` on timeout / if the daemon exits first. Lets MCP `start` report a
+     *  truthful device_state instead of an optimistic "running". Idempotent:
+     *  if a frame was already seen before the call, resolves immediately. */
+    waitForFirstFrame(timeoutMs?: number): Promise<Frame | null>;
+    private lastFirstFrame;
+    /** Fire all pending first-frame waiters once. `f` is the triggering frame
+     *  (or null when the daemon exited / spawn-errored before any frame). */
+    private resolveFirstFrame;
+    /** Cancel any pending SIGTERM/SIGKILL escalation timers (clean exit). */
+    private clearKillTimers;
+    /** §11.5 guaranteed teardown — escalate {cmd:stop} → SIGTERM → SIGKILL.
+     *  Idempotent and safe to call when `proc` is already null (the daemon may
+     *  have self-exited on a connect failure / crash / target reset). A wedged
+     *  daemon blocked in uninterruptible libusb ignores SIGTERM, so the SIGKILL
+     *  fallback is the ONLY thing that guarantees no `pkill -9` is ever needed.
+     *  The escalation timers are cleared on real exit (see onExit) so a clean
+     *  shutdown never fires a stray kill at a recycled PID.
+     *
+     *  §12.1: stop() ONLY ends the daemon now. The web UI is owned by the
+     *  persistent Dashboard singleton (see trace-webui.ts), which OUTLIVES the
+     *  session — the MCP `stop` handler calls dashboard.unbind() so the server
+     *  keeps listening and the dashboard tab survives across traces. */
+    stop(): void;
+    isRunning(): boolean;
+}
+export declare function getActiveSession(): TraceSession | null;
+export declare function setActiveSession(s: TraceSession | null): void;