@omniaura/solid-pulse 0.1.0

package/dist/cli.js

@@ -0,0 +1,229 @@
+#!/usr/bin/env node
+import {
+  DEFAULT_PATH
+} from "./chunk-4QA2G6S3.js";
+
+// src/bridge/cli.ts
+import { readFileSync, existsSync } from "fs";
+import { dirname, join } from "path";
+var HELP = `solid-pulse \u2014 agent-controllable devtools for SolidJS apps (every panel control is a command here)
+
+  solid-pulse status                         bridge + connected pages
+  solid-pulse commands                       the page's command contract (name, args, panel equivalent)
+  solid-pulse events [since=N] [kinds=dom,query] [limit=50]
+  solid-pulse tail [kinds=...]               follow events live (SSE)
+  solid-pulse <command> [key=value ...]      run any controller command, e.g.
+      solid-pulse features.set name=flash on=false
+      solid-pulse inspect.element selector='[data-testid=composer]'
+      solid-pulse scenario.select name=chat-stream-drop
+  solid-pulse bridge [--port 4567]           standalone bridge server (non-Vite apps)
+
+Options: --url <http://host:port[/__pulse]>  (or SOLID_PULSE_URL; default auto-discovery via
+         node_modules/.vite/solid-pulse.json, then http://localhost:3000)
+         --client <id>   --json   --path </__pulse>
+Values that parse as JSON (true, 3, [..], {..}, "..") are sent typed; others as strings.`;
+function parseArgs(argv) {
+  const flags = {};
+  const positional = [];
+  const kv = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith("--")) {
+      const [k, inline] = a.slice(2).split("=", 2);
+      if (inline !== void 0) flags[k] = inline;
+      else if (argv[i + 1] !== void 0 && !argv[i + 1].startsWith("--") && !argv[i + 1].includes("=")) flags[k] = argv[++i];
+      else flags[k] = true;
+    } else if (a.includes("=") && positional.length > 0) {
+      const idx = a.indexOf("=");
+      kv[a.slice(0, idx)] = coerce(a.slice(idx + 1));
+    } else positional.push(a);
+  }
+  return { flags, positional, kv };
+}
+function coerce(v) {
+  if (/^(true|false|null|-?\d+(\.\d+)?|\[.*\]|\{.*\}|".*")$/s.test(v)) {
+    try {
+      return JSON.parse(v);
+    } catch {
+      return v;
+    }
+  }
+  return v;
+}
+function discoverUrl(flag, path) {
+  if (typeof flag === "string") return flag.replace(/\/$/, "").endsWith(path) ? flag.replace(/\/$/, "") : `${flag.replace(/\/$/, "")}${path}`;
+  if (process.env.SOLID_PULSE_URL) return process.env.SOLID_PULSE_URL.replace(/\/$/, "");
+  let dir = process.cwd();
+  for (let i = 0; i < 6; i++) {
+    const f = join(dir, "node_modules", ".vite", "solid-pulse.json");
+    if (existsSync(f)) {
+      try {
+        const data = JSON.parse(readFileSync(f, "utf8"));
+        if (data.url) return data.url.replace(/\/$/, "");
+      } catch {
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return `http://localhost:3000${path}`;
+}
+async function api(base, route, init) {
+  let res;
+  try {
+    res = await fetch(`${base}/api${route}`, init);
+  } catch (err) {
+    throw new Error(`cannot reach bridge at ${base} \u2014 is the dev server (with the solid-pulse Vite plugin) or 'solid-pulse bridge' running? (${err.message})`);
+  }
+  const text = await res.text();
+  let body;
+  try {
+    body = JSON.parse(text);
+  } catch {
+    body = { error: text };
+  }
+  if (!res.ok) {
+    const msg = body.error ?? `${res.status} ${res.statusText}`;
+    throw new Error(msg);
+  }
+  return body;
+}
+function fmtEvent(e) {
+  const d = e.data;
+  const comp = e.component?.name ? ` <${e.component.name}>` : "";
+  let summary = "";
+  switch (true) {
+    case e.kind === "solid.flush":
+      summary = `${d.computations} computations ${JSON.stringify(d.byKind)} in ${JSON.stringify(d.components)}`;
+      break;
+    case e.kind.startsWith("solid.component"):
+      summary = `${d.name}${d.hydrated ? " (hydrated)" : ""}${d.gapMs !== void 0 ? ` gap=${d.gapMs}ms` : ""}${d.lifetimeMs !== void 0 ? ` lived=${d.lifetimeMs}ms` : ""}`;
+      break;
+    case e.kind === "dom.mutation": {
+      const s = d.summary ?? [];
+      summary = `${d.targets} targets: ${s.slice(0, 4).map((x) => `${x.tag}${x.id ? "#" + x.id : ""}${x.testId ? `[${x.testId}]` : ""}(${x.types.join("+")})`).join(" ")}${s.length > 4 ? " \u2026" : ""} [${d.attributedTo}]`;
+      break;
+    }
+    case e.kind === "dom.reattach": {
+      const el = d.element;
+      const resets = d.scrollReset.filter((r) => r.reset);
+      summary = `${el.tag}${el.testId ? `[${el.testId}]` : el.classes ? "." + el.classes.split(" ")[0] : ""} gap=${d.gapMs}ms${resets.length ? ` SCROLL RESET ${resets.map((r) => `${r.before}\u2192${r.after}`).join(",")}` : ""}${d.focusLost ? " FOCUS LOST" : ""}${d.suspenseInChain ? " (Suspense in chain)" : ""}`;
+      break;
+    }
+    case e.kind === "dom.detach": {
+      const el = d.element;
+      summary = `${el.tag}${el.testId ? `[${el.testId}]` : ""} scrollers=${d.scrollers.length}${d.hadFocus ? " had focus" : ""}`;
+      break;
+    }
+    case e.kind.startsWith("net.fetch"):
+      summary = `${d.method} ${d.url}${d.status !== void 0 ? ` \u2192 ${d.status} ${d.ms}ms${d.sse ? " (SSE)" : ""}` : ""}${d.message ? ` \u2717 ${d.message}` : ""}`;
+      break;
+    case e.kind.startsWith("net.ws"):
+      summary = `${d.url} ${d.state ?? d.dir ?? ""}${d.type ? ` type=${d.type}` : ""}${d.code !== void 0 ? ` code=${d.code}` : ""}`;
+      break;
+    case e.kind.startsWith("net.sse"):
+      summary = `${d.url} ${d.event ?? ""}${d.messages !== void 0 ? ` messages=${d.messages}` : ""}`;
+      break;
+    case (e.kind.startsWith("query") || e.kind.startsWith("mutation")):
+      summary = `${d.label ?? ""} ${d.role ?? d.trigger ?? d.action ?? ""}${d.ms !== void 0 && d.ms !== null ? ` ${d.ms}ms` : ""}${d.message ? ` \u2717 ${d.message}` : ""}`;
+      break;
+    case e.kind === "focus.lost":
+      summary = `${d.element.tag} \u2014 ${d.cause}`;
+      break;
+    default:
+      summary = JSON.stringify(d).slice(0, 160);
+  }
+  return `${String(e.seq).padStart(6)} ${(e.t / 1e3).toFixed(3).padStart(9)}s ${e.kind.padEnd(24)}${comp} ${summary}`;
+}
+async function main() {
+  const { flags, positional, kv } = parseArgs(process.argv.slice(2));
+  const path = typeof flags.path === "string" ? flags.path : DEFAULT_PATH;
+  const asJson = flags.json === true;
+  const client = typeof flags.client === "string" ? flags.client : void 0;
+  const cmd = positional[0];
+  if (!cmd || flags.help === true || cmd === "help") {
+    process.stdout.write(HELP + "\n");
+    return;
+  }
+  if (cmd === "bridge") {
+    const { startBridgeServer } = await import("./bridge.js");
+    const port = flags.port ? Number(flags.port) : 4567;
+    const host = typeof flags.host === "string" ? flags.host : "127.0.0.1";
+    const running = startBridgeServer({ port, host, path, allowRemote: flags["allow-remote"] === true, log: (m) => console.error(`[solid-pulse] ${m}`) });
+    const { url } = await running.ready;
+    console.error(`[solid-pulse] bridge listening at ${url}/api/status \u2014 page: initPulse({ bridge: "${url.replace(/^http/, "ws")}/ws" })`);
+    await new Promise(() => {
+    });
+    return;
+  }
+  const base = discoverUrl(flags.url, path);
+  const q = (extra) => {
+    const p = new URLSearchParams();
+    if (client) p.set("client", client);
+    for (const [k, v] of Object.entries(extra)) if (v !== void 0) p.set(k, String(v));
+    const s = p.toString();
+    return s ? `?${s}` : "";
+  };
+  const out = (v) => process.stdout.write((asJson ? JSON.stringify(v) : JSON.stringify(v, null, 2)) + "\n");
+  switch (cmd) {
+    case "status":
+      return out(await api(base, "/status"));
+    case "clients":
+      return out(await api(base, "/clients"));
+    case "commands": {
+      const r = await api(base, `/commands${q({})}`);
+      if (asJson) return out(r);
+      for (const c of r.commands) {
+        process.stdout.write(`${c.name.padEnd(22)} ${c.summary}
+`);
+        if (c.args) for (const [k, v] of Object.entries(c.args)) process.stdout.write(`${"".padEnd(24)}${k}=\u2026 ${v}
+`);
+        if (c.ui) process.stdout.write(`${"".padEnd(24)}panel: ${c.ui}
+`);
+      }
+      return;
+    }
+    case "events": {
+      const r = await api(base, `/events${q({ since: kv.since, kinds: kv.kinds, limit: kv.limit ?? 50 })}`);
+      if (asJson) return out(r);
+      for (const e of r.events) process.stdout.write(fmtEvent(e) + "\n");
+      return;
+    }
+    case "tail": {
+      const res = await fetch(`${base}/api/events/stream${q({ kinds: kv.kinds })}`);
+      if (!res.ok || !res.body) throw new Error(`stream failed: ${res.status}`);
+      const reader = res.body.getReader();
+      const dec = new TextDecoder();
+      let buf = "";
+      for (; ; ) {
+        const { value, done } = await reader.read();
+        if (done) break;
+        buf += dec.decode(value, { stream: true });
+        let idx;
+        while ((idx = buf.indexOf("\n\n")) >= 0) {
+          const frame = buf.slice(0, idx);
+          buf = buf.slice(idx + 2);
+          const data = frame.split("\n").find((l) => l.startsWith("data: "));
+          if (!data) continue;
+          const e = JSON.parse(data.slice(6));
+          process.stdout.write((asJson ? JSON.stringify(e) : fmtEvent(e)) + "\n");
+        }
+      }
+      return;
+    }
+    case "run":
+    default: {
+      const name = cmd === "run" ? positional[1] : cmd;
+      if (!name) throw new Error("run needs a command name");
+      const r = await api(base, "/command", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ client, name, args: kv }) });
+      return out(r);
+    }
+  }
+}
+main().catch((err) => {
+  process.stderr.write(`solid-pulse: ${err instanceof Error ? err.message : String(err)}
+`);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridge/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * solid-pulse CLI — the agent's hands. Every panel control is a command here.\n *\n *   solid-pulse status                         bridge + connected pages\n *   solid-pulse commands                       the page's command contract (name, args, panel equivalent)\n *   solid-pulse events [since=N] [kinds=dom,query] [limit=50]\n *   solid-pulse tail [kinds=...]               follow events live (SSE)\n *   solid-pulse <command> [key=value ...]      run any controller command, e.g.\n *       solid-pulse features.set name=flash on=false\n *       solid-pulse inspect.element selector='[data-testid=composer]'\n *       solid-pulse scenario.select name=chat-stream-drop\n *   solid-pulse bridge [--port 4567]           standalone bridge server (non-Vite apps)\n *\n * Options: --url <http://host:port[/__pulse]>  (or SOLID_PULSE_URL; default auto-discovery\n *          via node_modules/.vite/solid-pulse.json, then http://localhost:3000)\n *          --client <id>   --json   --path </__pulse>\n * Values that parse as JSON (true, 3, [..], {..}, \"..\") are sent typed; others as strings.\n */\n\nimport { readFileSync, existsSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { DEFAULT_PATH } from \"../core/protocol.js\";\n\nconst HELP = `solid-pulse — agent-controllable devtools for SolidJS apps (every panel control is a command here)\n\n  solid-pulse status                         bridge + connected pages\n  solid-pulse commands                       the page's command contract (name, args, panel equivalent)\n  solid-pulse events [since=N] [kinds=dom,query] [limit=50]\n  solid-pulse tail [kinds=...]               follow events live (SSE)\n  solid-pulse <command> [key=value ...]      run any controller command, e.g.\n      solid-pulse features.set name=flash on=false\n      solid-pulse inspect.element selector='[data-testid=composer]'\n      solid-pulse scenario.select name=chat-stream-drop\n  solid-pulse bridge [--port 4567]           standalone bridge server (non-Vite apps)\n\nOptions: --url <http://host:port[/__pulse]>  (or SOLID_PULSE_URL; default auto-discovery via\n         node_modules/.vite/solid-pulse.json, then http://localhost:3000)\n         --client <id>   --json   --path </__pulse>\nValues that parse as JSON (true, 3, [..], {..}, \"..\") are sent typed; others as strings.`;\n\ninterface Parsed {\n  flags: Record<string, string | boolean>;\n  positional: string[];\n  kv: Record<string, unknown>;\n}\n\nfunction parseArgs(argv: string[]): Parsed {\n  const flags: Record<string, string | boolean> = {};\n  const positional: string[] = [];\n  const kv: Record<string, unknown> = {};\n  for (let i = 0; i < argv.length; i++) {\n    const a = argv[i]!;\n    if (a.startsWith(\"--\")) {\n      const [k, inline] = a.slice(2).split(\"=\", 2) as [string, string | undefined];\n      if (inline !== undefined) flags[k] = inline;\n      else if (argv[i + 1] !== undefined && !argv[i + 1]!.startsWith(\"--\") && !argv[i + 1]!.includes(\"=\")) flags[k] = argv[++i]!;\n      else flags[k] = true;\n    } else if (a.includes(\"=\") && positional.length > 0) {\n      const idx = a.indexOf(\"=\");\n      kv[a.slice(0, idx)] = coerce(a.slice(idx + 1));\n    } else positional.push(a);\n  }\n  return { flags, positional, kv };\n}\n\nfunction coerce(v: string): unknown {\n  if (/^(true|false|null|-?\\d+(\\.\\d+)?|\\[.*\\]|\\{.*\\}|\".*\")$/s.test(v)) {\n    try {\n      return JSON.parse(v);\n    } catch {\n      return v;\n    }\n  }\n  return v;\n}\n\nfunction discoverUrl(flag: string | boolean | undefined, path: string): string {\n  if (typeof flag === \"string\") return flag.replace(/\\/$/, \"\").endsWith(path) ? flag.replace(/\\/$/, \"\") : `${flag.replace(/\\/$/, \"\")}${path}`;\n  if (process.env.SOLID_PULSE_URL) return process.env.SOLID_PULSE_URL.replace(/\\/$/, \"\");\n  let dir = process.cwd();\n  for (let i = 0; i < 6; i++) {\n    const f = join(dir, \"node_modules\", \".vite\", \"solid-pulse.json\");\n    if (existsSync(f)) {\n      try {\n        const data = JSON.parse(readFileSync(f, \"utf8\")) as { url?: string };\n        if (data.url) return data.url.replace(/\\/$/, \"\");\n      } catch {\n        // fall through\n      }\n    }\n    const parent = dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return `http://localhost:3000${path}`;\n}\n\nasync function api(base: string, route: string, init?: RequestInit): Promise<unknown> {\n  let res: Response;\n  try {\n    res = await fetch(`${base}/api${route}`, init);\n  } catch (err) {\n    throw new Error(`cannot reach bridge at ${base} — is the dev server (with the solid-pulse Vite plugin) or 'solid-pulse bridge' running? (${(err as Error).message})`);\n  }\n  const text = await res.text();\n  let body: unknown;\n  try {\n    body = JSON.parse(text);\n  } catch {\n    body = { error: text };\n  }\n  if (!res.ok) {\n    const msg = (body as { error?: string }).error ?? `${res.status} ${res.statusText}`;\n    throw new Error(msg);\n  }\n  return body;\n}\n\nfunction fmtEvent(e: { seq: number; t: number; kind: string; component?: { name: string } | null; data: Record<string, unknown> }): string {\n  const d = e.data;\n  const comp = e.component?.name ? ` <${e.component.name}>` : \"\";\n  let summary = \"\";\n  switch (true) {\n    case e.kind === \"solid.flush\":\n      summary = `${d.computations} computations ${JSON.stringify(d.byKind)} in ${JSON.stringify(d.components)}`;\n      break;\n    case e.kind.startsWith(\"solid.component\"):\n      summary = `${d.name}${d.hydrated ? \" (hydrated)\" : \"\"}${d.gapMs !== undefined ? ` gap=${d.gapMs}ms` : \"\"}${d.lifetimeMs !== undefined ? ` lived=${d.lifetimeMs}ms` : \"\"}`;\n      break;\n    case e.kind === \"dom.mutation\": {\n      const s = (d.summary as Array<{ tag: string; types: string[]; testId?: string; id?: string }>) ?? [];\n      summary = `${d.targets} targets: ${s.slice(0, 4).map((x) => `${x.tag}${x.id ? \"#\" + x.id : \"\"}${x.testId ? `[${x.testId}]` : \"\"}(${x.types.join(\"+\")})`).join(\" \")}${s.length > 4 ? \" …\" : \"\"} [${d.attributedTo}]`;\n      break;\n    }\n    case e.kind === \"dom.reattach\": {\n      const el = d.element as { tag: string; testId?: string; classes?: string };\n      const resets = (d.scrollReset as Array<{ reset: boolean; before: number; after: number }>).filter((r) => r.reset);\n      summary = `${el.tag}${el.testId ? `[${el.testId}]` : el.classes ? \".\" + el.classes.split(\" \")[0] : \"\"} gap=${d.gapMs}ms${resets.length ? ` SCROLL RESET ${resets.map((r) => `${r.before}→${r.after}`).join(\",\")}` : \"\"}${d.focusLost ? \" FOCUS LOST\" : \"\"}${d.suspenseInChain ? \" (Suspense in chain)\" : \"\"}`;\n      break;\n    }\n    case e.kind === \"dom.detach\": {\n      const el = d.element as { tag: string; testId?: string };\n      summary = `${el.tag}${el.testId ? `[${el.testId}]` : \"\"} scrollers=${(d.scrollers as unknown[]).length}${d.hadFocus ? \" had focus\" : \"\"}`;\n      break;\n    }\n    case e.kind.startsWith(\"net.fetch\"):\n      summary = `${d.method} ${d.url}${d.status !== undefined ? ` → ${d.status} ${d.ms}ms${d.sse ? \" (SSE)\" : \"\"}` : \"\"}${d.message ? ` ✗ ${d.message}` : \"\"}`;\n      break;\n    case e.kind.startsWith(\"net.ws\"):\n      summary = `${d.url} ${d.state ?? d.dir ?? \"\"}${d.type ? ` type=${d.type}` : \"\"}${d.code !== undefined ? ` code=${d.code}` : \"\"}`;\n      break;\n    case e.kind.startsWith(\"net.sse\"):\n      summary = `${d.url} ${d.event ?? \"\"}${d.messages !== undefined ? ` messages=${d.messages}` : \"\"}`;\n      break;\n    case e.kind.startsWith(\"query\") || e.kind.startsWith(\"mutation\"):\n      summary = `${d.label ?? \"\"} ${d.role ?? d.trigger ?? d.action ?? \"\"}${d.ms !== undefined && d.ms !== null ? ` ${d.ms}ms` : \"\"}${d.message ? ` ✗ ${d.message}` : \"\"}`;\n      break;\n    case e.kind === \"focus.lost\":\n      summary = `${(d.element as { tag: string }).tag} — ${d.cause}`;\n      break;\n    default:\n      summary = JSON.stringify(d).slice(0, 160);\n  }\n  return `${String(e.seq).padStart(6)} ${(e.t / 1000).toFixed(3).padStart(9)}s ${e.kind.padEnd(24)}${comp} ${summary}`;\n}\n\nasync function main() {\n  const { flags, positional, kv } = parseArgs(process.argv.slice(2));\n  const path = typeof flags.path === \"string\" ? flags.path : DEFAULT_PATH;\n  const asJson = flags.json === true;\n  const client = typeof flags.client === \"string\" ? flags.client : undefined;\n  const cmd = positional[0];\n\n  if (!cmd || flags.help === true || cmd === \"help\") {\n    process.stdout.write(HELP + \"\\n\");\n    return;\n  }\n\n  if (cmd === \"bridge\") {\n    const { startBridgeServer } = await import(\"./server.js\");\n    const port = flags.port ? Number(flags.port) : 4567;\n    const host = typeof flags.host === \"string\" ? flags.host : \"127.0.0.1\";\n    const running = startBridgeServer({ port, host, path, allowRemote: flags[\"allow-remote\"] === true, log: (m) => console.error(`[solid-pulse] ${m}`) });\n    const { url } = await running.ready;\n    console.error(`[solid-pulse] bridge listening at ${url}/api/status — page: initPulse({ bridge: \"${url.replace(/^http/, \"ws\")}/ws\" })`);\n    await new Promise(() => {});\n    return;\n  }\n\n  const base = discoverUrl(flags.url, path);\n  const q = (extra: Record<string, unknown>) => {\n    const p = new URLSearchParams();\n    if (client) p.set(\"client\", client);\n    for (const [k, v] of Object.entries(extra)) if (v !== undefined) p.set(k, String(v));\n    const s = p.toString();\n    return s ? `?${s}` : \"\";\n  };\n  const out = (v: unknown) => process.stdout.write((asJson ? JSON.stringify(v) : JSON.stringify(v, null, 2)) + \"\\n\");\n\n  switch (cmd) {\n    case \"status\":\n      return out(await api(base, \"/status\"));\n    case \"clients\":\n      return out(await api(base, \"/clients\"));\n    case \"commands\": {\n      const r = (await api(base, `/commands${q({})}`)) as { commands: Array<{ name: string; summary: string; args?: Record<string, string>; ui?: string }> };\n      if (asJson) return out(r);\n      for (const c of r.commands) {\n        process.stdout.write(`${c.name.padEnd(22)} ${c.summary}\\n`);\n        if (c.args) for (const [k, v] of Object.entries(c.args)) process.stdout.write(`${\"\".padEnd(24)}${k}=… ${v}\\n`);\n        if (c.ui) process.stdout.write(`${\"\".padEnd(24)}panel: ${c.ui}\\n`);\n      }\n      return;\n    }\n    case \"events\": {\n      const r = (await api(base, `/events${q({ since: kv.since, kinds: kv.kinds, limit: kv.limit ?? 50 })}`)) as { events: Parameters<typeof fmtEvent>[0][] };\n      if (asJson) return out(r);\n      for (const e of r.events) process.stdout.write(fmtEvent(e) + \"\\n\");\n      return;\n    }\n    case \"tail\": {\n      const res = await fetch(`${base}/api/events/stream${q({ kinds: kv.kinds })}`);\n      if (!res.ok || !res.body) throw new Error(`stream failed: ${res.status}`);\n      const reader = res.body.getReader();\n      const dec = new TextDecoder();\n      let buf = \"\";\n      for (;;) {\n        const { value, done } = await reader.read();\n        if (done) break;\n        buf += dec.decode(value, { stream: true });\n        let idx: number;\n        while ((idx = buf.indexOf(\"\\n\\n\")) >= 0) {\n          const frame = buf.slice(0, idx);\n          buf = buf.slice(idx + 2);\n          const data = frame.split(\"\\n\").find((l) => l.startsWith(\"data: \"));\n          if (!data) continue;\n          const e = JSON.parse(data.slice(6)) as Parameters<typeof fmtEvent>[0];\n          process.stdout.write((asJson ? JSON.stringify(e) : fmtEvent(e)) + \"\\n\");\n        }\n      }\n      return;\n    }\n    case \"run\":\n    default: {\n      const name = cmd === \"run\" ? positional[1] : cmd;\n      if (!name) throw new Error(\"run needs a command name\");\n      const r = await api(base, \"/command\", { method: \"POST\", headers: { \"content-type\": \"application/json\" }, body: JSON.stringify({ client, name, args: kv }) });\n      return out(r);\n    }\n  }\n}\n\nmain().catch((err) => {\n  process.stderr.write(`solid-pulse: ${err instanceof Error ? err.message : String(err)}\\n`);\n  process.exit(1);\n});\n"],"mappings":"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","names":[]}

package/dist/controller-3akN6Qi0.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Event model. Every observation the runtime makes is one PulseEvent with a
+ * precise `kind`. Kinds are deliberately specific: Solid has no "rerender", so
+ * we never report one. What actually happens is one of:
+ *
+ *   solid.flush            a reactive flush completed (n computations re-ran)
+ *   solid.computation      one memo/effect/render-effect re-ran (verbose mode)
+ *   solid.component.mount  a component function ran (fresh mount, or hydrate)
+ *   solid.component.dispose
+ *   solid.component.remount same-named component disposed + mounted in one flush
+ *   solid.root             a reactive root was created (multiple roots are fine)
+ *   dom.mutation           the DOM actually changed (childList/attr/text)
+ *   dom.detach             a subtree left the document (with scroll/focus state)
+ *   dom.reattach           the same node instance came back (Suspense flip etc.)
+ *   focus.lost             the focused element vanished from the document
+ *   net.fetch.*            fetch lifecycle (start/end/error), SSE-aware
+ *   net.ws.*               WebSocket lifecycle (open/message/close/error)
+ *   net.sse.*              EventSource lifecycle
+ *   query.*                Solid Query cache/observer events (adapter)
+ *   mutation.*             Solid Query mutation cache events (adapter)
+ *   pulse.*                runtime lifecycle / control-plane notes
+ */
+type PulseEventKind = "solid.flush" | "solid.computation" | "solid.component.mount" | "solid.component.dispose" | "solid.component.remount" | "solid.root" | "dom.mutation" | "dom.detach" | "dom.reattach" | "focus.lost" | "net.fetch.start" | "net.fetch.end" | "net.fetch.error" | "net.ws.open" | "net.ws.message" | "net.ws.close" | "net.ws.error" | "net.sse.open" | "net.sse.message" | "net.sse.error" | "net.sse.close" | "query.added" | "query.removed" | "query.observe" | "query.unobserve" | "query.fetch.start" | "query.fetch.success" | "query.fetch.error" | "query.invalidate" | "query.update" | "mutation.start" | "mutation.success" | "mutation.error" | "pulse.note";
+interface Rect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+interface ComponentRef {
+    id: number;
+    name: string;
+    /** Component ancestry, innermost first (names only). */
+    chain?: string[];
+    /** Source location if solid-grab's data-solid-source attribute was found. */
+    source?: string | null;
+}
+interface ElementRef {
+    tag: string;
+    id?: string;
+    testId?: string;
+    classes?: string;
+    /** Nearest `data-solid-component` ancestor name, if any. */
+    component?: string | null;
+    /** Nearest `data-solid-source` value, if any. */
+    source?: string | null;
+    rect?: Rect;
+}
+interface PulseEventBase {
+    /** Monotonic per-runtime sequence. */
+    seq: number;
+    /** performance.now() at capture. */
+    t: number;
+    /** Date.now() at capture (for cross-process correlation). */
+    wall: number;
+    kind: PulseEventKind;
+    /** Flush group the event belongs to, when attributable. */
+    flush?: number;
+    /** Component attribution, when known. */
+    component?: ComponentRef | null;
+    /** Free-form structured payload; shape depends on `kind`. */
+    data: Record<string, unknown>;
+}
+type PulseEvent = PulseEventBase;
+declare const KIND_GROUPS: Record<string, PulseEventKind[]>;
+declare const ALL_KINDS: PulseEventKind[];
+/** Expand a kind filter: exact kinds, `group` names, or `prefix.*` globs. */
+declare function expandKinds(filters: readonly string[]): Set<PulseEventKind>;
+
+/** Fixed-capacity FIFO. Overwrites the oldest entry; never grows. */
+declare class RingBuffer<T> {
+    readonly capacity: number;
+    private items;
+    private head;
+    private count;
+    /** Total number of pushes since creation (dropped + retained). */
+    pushed: number;
+    constructor(capacity: number);
+    get size(): number;
+    get dropped(): number;
+    push(item: T): void;
+    /** Oldest → newest. */
+    toArray(): T[];
+    clear(): void;
+}
+
+type Listener = (event: PulseEvent) => void;
+interface Recording {
+    id: string;
+    startedAt: number;
+    startedWall: number;
+    stoppedAt: number | null;
+    events: PulseEvent[];
+    /** Hard cap; the recording stops itself when reached. */
+    limit: number;
+}
+/**
+ * Bounded event bus. Emission is synchronous and cheap: one ring-buffer push,
+ * one optional recording push, then listeners. Filters are applied by
+ * consumers (panel/bridge), not here, so the buffer stays a faithful log.
+ */
+declare class EventBus {
+    readonly buffer: RingBuffer<PulseEvent>;
+    private listeners;
+    private seq;
+    private recording;
+    private recordings;
+    /** Kinds that are muted at the source (never buffered). */
+    muted: Set<PulseEventKind>;
+    paused: boolean;
+    constructor(capacity?: number);
+    get nextSeq(): number;
+    emit(kind: PulseEventKind, data: Record<string, unknown>, extra?: Partial<PulseEvent>): PulseEvent | null;
+    subscribe(listener: Listener): () => void;
+    /** Events with seq > since (oldest first), optionally filtered by kind. */
+    list(opts?: {
+        since?: number;
+        kinds?: Set<PulseEventKind> | null;
+        limit?: number;
+    }): PulseEvent[];
+    clear(): void;
+    startRecording(id?: string, limit?: number): Recording;
+    stopRecording(): Recording | null;
+    currentRecording(): Recording | null;
+    getRecording(id: string): Recording | null;
+    listRecordings(): {
+        id: string;
+        startedWall: number;
+        stoppedAt: number | null;
+        events: number;
+        active: boolean;
+    }[];
+}
+
+/** Runtime features that can be toggled by humans (panel) and agents (CLI) alike. */
+type Feature = "solid" | "dom" | "flash" | "network" | "query" | "queryOverlay" | "verboseComputations" | "captureBodies";
+declare const FEATURES: Feature[];
+interface CommandSpec {
+    /** Dotted command name, e.g. `features.set`. Also the CLI verb. */
+    name: string;
+    summary: string;
+    /** Argument name → short description. */
+    args?: Record<string, string>;
+    /** Where the equivalent human control lives in the panel (parity doc). */
+    ui?: string;
+}
+type CommandHandler = (args: Record<string, unknown>) => unknown | Promise<unknown>;
+type CommandResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+interface Filters {
+    /** Kind filters (exact kinds, groups, or `prefix.*`); empty = all. */
+    kinds: string[];
+    /** Case-insensitive substring on component name. */
+    component: string;
+    /** Case-insensitive substring on any string in `data` (URLs, keys). */
+    text: string;
+}
+type FeatureListener = (feature: Feature, on: boolean) => void;
+/**
+ * The single command surface. The panel's buttons, the bridge's HTTP API and
+ * the CLI all call `run()`, so parity between human and agent control is a
+ * property of the design rather than a checklist. `describe()` is the
+ * machine-readable contract the CLI prints and the parity test asserts on.
+ */
+declare class PulseController {
+    readonly bus: EventBus;
+    private commands;
+    private features;
+    private featureListeners;
+    filters: Filters;
+    private filterListeners;
+    readonly startedWall: number;
+    constructor(bus?: EventBus, initial?: Partial<Record<Feature, boolean>>);
+    isOn(feature: Feature): boolean;
+    setFeature(feature: Feature, on: boolean): void;
+    onFeature(listener: FeatureListener): () => boolean;
+    snapshotFeatures(): {
+        solid: boolean;
+        dom: boolean;
+        flash: boolean;
+        network: boolean;
+        query: boolean;
+        queryOverlay: boolean;
+        verboseComputations: boolean;
+        captureBodies: boolean;
+    };
+    setFilters(next: Partial<Filters>): void;
+    onFilters(listener: (f: Filters) => void): () => boolean;
+    matchesFilters(e: PulseEvent, f?: Filters): boolean;
+    /** Buffered events after `since`, through the active filters. */
+    events(opts?: {
+        since?: number;
+        limit?: number;
+        kinds?: string[];
+        raw?: boolean;
+    }): PulseEventBase[];
+    register(spec: CommandSpec, handler: CommandHandler): void;
+    unregister(name: string): void;
+    has(name: string): boolean;
+    describe(): CommandSpec[];
+    run(name: string, args?: Record<string, unknown>): Promise<CommandResult>;
+    private registerCore;
+}
+
+export { ALL_KINDS as A, type CommandSpec as C, type ElementRef as E, FEATURES as F, KIND_GROUPS as K, type Listener as L, type PulseEvent as P, type Recording as R, type CommandResult as a, type CommandHandler as b, type ComponentRef as c, EventBus as d, type Feature as e, type Filters as f, PulseController as g, type PulseEventBase as h, type PulseEventKind as i, type Rect as j, RingBuffer as k, expandKinds as l };

package/dist/core.d.ts

@@ -0,0 +1,76 @@
+import { P as PulseEvent, C as CommandSpec, a as CommandResult } from './controller-3akN6Qi0.js';
+export { A as ALL_KINDS, b as CommandHandler, c as ComponentRef, E as ElementRef, d as EventBus, F as FEATURES, e as Feature, f as Filters, K as KIND_GROUPS, L as Listener, g as PulseController, h as PulseEventBase, i as PulseEventKind, R as Recording, j as Rect, k as RingBuffer, l as expandKinds } from './controller-3akN6Qi0.js';
+
+/**
+ * Redaction. Devtools traffic leaves the page (bridge, CLI, exports), so
+ * anything that looks like a credential is scrubbed before it becomes an event.
+ * Bodies are never captured unless `captureBodies` is turned on explicitly.
+ */
+declare const REDACTED = "[redacted]";
+declare function redactUrl(input: string): string;
+declare function redactText(text: string): string;
+declare function redactHeaders(headers: Iterable<[string, string]>): Record<string, string>;
+/** Best-effort key redaction inside small structured payloads. */
+declare function redactValue<T>(value: T, depth?: number): T;
+
+/**
+ * Bridge protocol (JSON over WebSocket) between a page runtime and the bridge
+ * server, and the HTTP shape the server exposes to CLIs and agents.
+ *
+ * Page → server
+ *   hello      first frame; identifies the tab
+ *   events     batched PulseEvents (≤ 50 ms coalescing)
+ *   result     reply to a `command`
+ * Server → page
+ *   command    run a controller command; page answers with `result`
+ *   welcome    ack of hello with the server-assigned client id
+ */
+
+declare const PROTOCOL_VERSION = 1;
+declare const DEFAULT_PATH = "/__pulse";
+interface HelloFrame {
+    type: "hello";
+    protocol: number;
+    clientId: string;
+    url: string;
+    title: string;
+    userAgent: string;
+    commands: CommandSpec[];
+    startedWall: number;
+}
+interface EventsFrame {
+    type: "events";
+    events: PulseEvent[];
+}
+interface ResultFrame {
+    type: "result";
+    id: string;
+    result: CommandResult;
+}
+interface CommandFrame {
+    type: "command";
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+interface WelcomeFrame {
+    type: "welcome";
+    clientId: string;
+    protocol: number;
+}
+type PageFrame = HelloFrame | EventsFrame | ResultFrame;
+type ServerFrame = CommandFrame | WelcomeFrame;
+interface ClientSummary {
+    clientId: string;
+    url: string;
+    title: string;
+    userAgent: string;
+    connectedWall: number;
+    lastSeenWall: number;
+    events: number;
+    commands: number;
+}
+declare function isPageFrame(value: unknown): value is PageFrame;
+declare function isServerFrame(value: unknown): value is ServerFrame;
+
+export { type ClientSummary, type CommandFrame, CommandResult, CommandSpec, DEFAULT_PATH, type EventsFrame, type HelloFrame, PROTOCOL_VERSION, type PageFrame, PulseEvent, REDACTED, type ResultFrame, type ServerFrame, type WelcomeFrame, isPageFrame, isServerFrame, redactHeaders, redactText, redactUrl, redactValue };

package/dist/core.js

@@ -0,0 +1,41 @@
+import {
+  DEFAULT_PATH,
+  PROTOCOL_VERSION,
+  isPageFrame,
+  isServerFrame
+} from "./chunk-WIMCBTHZ.js";
+import {
+  REDACTED,
+  redactHeaders,
+  redactText,
+  redactUrl,
+  redactValue
+} from "./chunk-5FYH2KEZ.js";
+import {
+  ALL_KINDS,
+  EventBus,
+  FEATURES,
+  KIND_GROUPS,
+  PulseController,
+  RingBuffer,
+  expandKinds
+} from "./chunk-C72EYM65.js";
+export {
+  ALL_KINDS,
+  DEFAULT_PATH,
+  EventBus,
+  FEATURES,
+  KIND_GROUPS,
+  PROTOCOL_VERSION,
+  PulseController,
+  REDACTED,
+  RingBuffer,
+  expandKinds,
+  isPageFrame,
+  isServerFrame,
+  redactHeaders,
+  redactText,
+  redactUrl,
+  redactValue
+};
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}