aihand 0.0.1 → 0.1.0

package/dist/chunk-YKSYW77R.js

@@ -0,0 +1,410 @@
+// src/ui/core/util.ts
+function truncate(s, max) {
+  return s.length > max ? `${s.slice(0, max)}\u2026` : s;
+}
+function formatValue(v, seen = /* @__PURE__ */ new Set()) {
+  if (v === null || v === void 0)
+    return String(v);
+  const t = typeof v;
+  if (t === "string")
+    return v;
+  if (t === "number" || t === "boolean" || t === "bigint")
+    return String(v);
+  if (t === "symbol")
+    return v.toString();
+  if (t === "function")
+    return `[Function: ${v.name || "anonymous"}]`;
+  const obj = v;
+  if (seen.has(obj))
+    return "[Circular]";
+  if (v instanceof Error)
+    return v.stack || `${v.name}: ${v.message}`;
+  seen.add(obj);
+  if (v instanceof Map) {
+    const items = [...v.entries()].slice(0, 15).map(([k, val]) => `${formatValue(k, seen)} => ${formatValue(val, seen)}`);
+    return `Map(${v.size}) {${items.join(", ")}${v.size > 15 ? ", \u2026" : ""}}`;
+  }
+  if (v instanceof Set) {
+    const items = [...v.values()].slice(0, 15).map((val) => formatValue(val, seen));
+    return `Set(${v.size}) {${items.join(", ")}${v.size > 15 ? ", \u2026" : ""}}`;
+  }
+  if (Array.isArray(v)) {
+    const items = v.slice(0, 30).map((val) => formatValue(val, seen));
+    return `[${items.join(", ")}${v.length > 30 ? ", \u2026" : ""}]`;
+  }
+  try {
+    return JSON.stringify(v);
+  } catch {
+    const entries = Object.entries(v).slice(0, 15);
+    const parts = entries.map(([k, val]) => `${k}: ${formatValue(val, seen)}`);
+    return `{${parts.join(", ")}}`;
+  }
+}
+function appStackFrames(stack, max) {
+  return stack.split("\n").map((l) => l.trim()).filter((l) => l.startsWith("at ") && !l.includes("node_modules") && !l.includes("<anonymous>")).slice(0, max);
+}
+function compactUrl(url, search) {
+  try {
+    const u = new URL(url);
+    if (search && u.search)
+      return `${u.pathname}?${truncate(u.search.slice(1), search)}`;
+    return u.pathname;
+  } catch {
+    return truncate(url, 80);
+  }
+}
+function isRouteChange(fromUrl, toUrl) {
+  try {
+    const a = new URL(fromUrl);
+    const b = new URL(toUrl);
+    return a.pathname !== b.pathname || a.search !== b.search;
+  } catch {
+    return fromUrl !== toUrl && stripHash(fromUrl) !== stripHash(toUrl);
+  }
+}
+function stripHash(u) {
+  const i = u.indexOf("#");
+  return i < 0 ? u : u.slice(0, i);
+}
+var STALE_MS = 3e4;
+var isLive = (t, now) => now - t.lastSeen < STALE_MS;
+function formatTabs(tabs, now) {
+  const live = tabs.filter((t) => isLive(t, now));
+  if (!live.length)
+    return "(no live tabs)";
+  const rows = live.sort((a, b) => Number(b.visible) - Number(a.visible) || a.id.localeCompare(b.id)).map((t) => {
+    const age = Math.round((now - t.lastSeen) / 1e3);
+    const mark = t.visible ? "\u25CF visible" : "\u25CB background";
+    return `${t.id}  ${mark}  ${truncate(t.title || "(untitled)", 40)}  ${compactUrl(t.url)}  ${age}s ago`;
+  }).join("\n");
+  if (live.some((t) => t.visible))
+    return rows;
+  return `${rows}
+(all backgrounded because the user is looking at the terminal \u2014 this is normal. Reads and clicks/fills work on background tabs; do NOT ask the user to foreground a tab. Only /profile needs focus.)`;
+}
+function diagnose(tab, tabs, now, socketCount, port) {
+  if (tab) {
+    const t = tabs.find((x) => x.id === tab);
+    return t && isLive(t, now) ? `tab '${tab}' is connected but didn't answer in time \u2014 most likely the HMR socket dropped while the tab was backgrounded and self-heal hasn't reconnected yet (retry in ~2s, it reloads itself), or the handler threw/hung on a bad selector. Reads (/screen /dom) work backgrounded \u2014 do NOT ask the user to foreground the tab. Check /__aihand/console.` : `tab '${tab}' is not connected \u2014 it closed, or the server restarted and it hasn't re-handshaked yet. Check /__aihand/tabs for live ids; if the page is mid self-heal, retry in ~2s.`;
+  }
+  const live = tabs.filter((t) => isLive(t, now));
+  if (live.length)
+    return `${live.length} tab(s) connected but none answered \u2014 a handler threw, or they just closed. Check /__aihand/tabs (still live?) and /__aihand/console (errors?).`;
+  return socketCount > 0 ? `no aihand tab registered, but ${socketCount} page(s) are connected to this dev server via HMR \u2014 the page is open yet the aihand client didn't load. Is it served by THIS vite server on :${port}? A separate vite config / vite preview / production build won't inject it.` : `no browser tab connected to this dev server on :${port} \u2014 open the app, or check you're hitting the right port.`;
+}
+function formatActions(entries, anchorTs, dropped = 0) {
+  if (!entries.length)
+    return dropped > 0 ? `\u2504 \u2026 \u66F4\u65E9 ${dropped} \u6761\u52A8\u4F5C\u5DF2\u8D85\u51FA\u7A97\u53E3\uFF08\u6B64\u5904\u975E\u4F1A\u8BDD\u8D77\u70B9\uFF09` : "(no actions)";
+  const sorted = [...entries].sort((a, b) => a.ts - b.ts);
+  const multiTab = new Set(sorted.map((e) => e.tab).filter(Boolean)).size > 1;
+  const lines = [];
+  if (dropped > 0)
+    lines.push(`\u2504 \u2026 \u66F4\u65E9 ${dropped} \u6761\u52A8\u4F5C\u5DF2\u8D85\u51FA\u7A97\u53E3\uFF08\u4E0B\u65B9\u975E\u4F1A\u8BDD\u8D77\u70B9\uFF09`);
+  const prevByTab = /* @__PURE__ */ new Map();
+  let anchored = false;
+  for (const e of sorted) {
+    const isAnchor = anchorTs !== void 0 && !anchored && e.ts === anchorTs;
+    if (isAnchor) {
+      lines.push("\u2014\u2014\u2014\u2014\u2014\u2014 \u4F60\u5F53\u524D\u7684\u884C\u4E3A \u2014\u2014\u2014\u2014\u2014\u2014");
+      anchored = true;
+    }
+    const who = e.trusted ? "T" : "S";
+    const tag = multiTab ? `${e.tab ?? "?"} ` : "";
+    const val = e.value ? ` value="${e.value}"` : "";
+    const change = uiChange(prevByTab.get(e.tab), e);
+    lines.push(`${tag}[${who}] ${e.type} ${e.target}${val}${change ? `   \u2192 ${change}` : ""}`);
+    if (isAnchor)
+      lines.push("\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014\u2014");
+    prevByTab.set(e.tab, e);
+  }
+  return lines.join("\n");
+}
+function appendAction(log, tab, entry, max) {
+  const last = log[log.length - 1];
+  if (entry.type === "input" && last?.type === "input" && last.tab === tab && last.target === entry.target) {
+    log[log.length - 1] = { ...entry, tab };
+    return;
+  }
+  log.push({ ...entry, tab });
+  if (log.length > max)
+    log.shift();
+}
+function uiChange(prev, cur) {
+  if (cur.modal === void 0)
+    return "";
+  const prevModal = prev?.modal ?? "none";
+  if (cur.modal !== prevModal) {
+    if (cur.modal === "none")
+      return "\u5F39\u7A97\u5173\u95ED";
+    if (prevModal === "none")
+      return `\u5F39\u7A97\u6253\u5F00\u300C${cur.modal}\u300D`;
+    return `\u5F39\u7A97\u5207\u6362\u300C${cur.modal}\u300D`;
+  }
+  if (prev && cur.view !== void 0 && prev.view !== void 0 && cur.view !== prev.view)
+    return `\u89C6\u56FE ${prev.view}\u2192${cur.view}`;
+  return "";
+}
+
+// src/ui/core/candidates.ts
+var SECRET_HINTS = ["password", "api key", "apikey", "api-key", "api_key", "secret", "token", "private key", "authorization", "cookie"];
+var SECRET_EXEMPTIONS = ["tokens", "tokencount"];
+function isSecretKey(name) {
+  const lower = name.toLowerCase();
+  if (SECRET_EXEMPTIONS.some((e) => lower.includes(e)))
+    return false;
+  return SECRET_HINTS.some((h) => lower.includes(h));
+}
+function redactSecretValue(value) {
+  return value ? `\u2039redacted ${value.length} chars\u203A` : value;
+}
+
+// src/ui/core/action.ts
+var TYPES = ["click", "dblclick", "fill", "press", "wait", "screenshot", "realclick", "query", "assert", "drag", "scrollIntoView", "drop", "clipboard", "hover"];
+function resolveAction(type, args) {
+  if (!TYPES.includes(type))
+    return { valid: false, error: `unknown action: ${type}` };
+  const hasTarget = !!(args.sel || args.text);
+  switch (type) {
+    case "click":
+      return hasTarget ? { valid: true } : { valid: false, error: "click needs sel= or text=" };
+    case "dblclick":
+      return hasTarget ? { valid: true } : { valid: false, error: "dblclick needs sel= or text=" };
+    case "hover":
+      return hasTarget ? { valid: true } : { valid: false, error: "hover needs sel= or text=" };
+    case "realclick":
+      return hasTarget || args.x !== void 0 && args.y !== void 0 ? { valid: true } : { valid: false, error: "realclick needs sel=, text=, or x= & y=" };
+    case "fill":
+      if (!hasTarget)
+        return { valid: false, error: "fill needs sel= or text=" };
+      if (args.value === void 0)
+        return { valid: false, error: "fill needs value=" };
+      return { valid: true };
+    case "press":
+      return args.key ? { valid: true } : { valid: false, error: "press needs key=" };
+    case "wait":
+      return hasTarget ? { valid: true } : { valid: false, error: "wait needs sel= or text=" };
+    case "screenshot":
+      return { valid: true };
+    case "query":
+      return args.sel ? { valid: true } : { valid: false, error: "query needs sel=" };
+    case "assert":
+      if (!args.screen && !args.sel)
+        return { valid: false, error: "assert needs screen= (a __AIPEEK_SCREEN__ key) or sel=" };
+      if (args.equals === void 0)
+        return { valid: false, error: "assert needs equals=" };
+      return { valid: true };
+    case "drag":
+      if (!hasTarget)
+        return { valid: false, error: "drag needs sel= or text= (the source)" };
+      if (!args.to)
+        return { valid: false, error: "drag needs to= (destination selector)" };
+      return { valid: true };
+    case "scrollIntoView":
+      return hasTarget ? { valid: true } : { valid: false, error: "scrollIntoView needs sel= or text=" };
+    case "drop":
+      if (!hasTarget)
+        return { valid: false, error: "drop needs sel= or text= (the drop target)" };
+      if (!args.files || !args.files.length)
+        return { valid: false, error: "drop needs files= (array of file names)" };
+      return { valid: true };
+    case "clipboard":
+      if (args.mode === "write" && args.value === void 0)
+        return { valid: false, error: "clipboard write needs value=" };
+      return { valid: true };
+    default:
+      return { valid: false, error: `unknown action: ${type}` };
+  }
+}
+function diagnoseEval(code, ok, error) {
+  const has = (hay, needle) => !!hay && hay.includes(needle);
+  if (!ok) {
+    if (has(error, "is not a valid selector") || has(error, "Failed to execute 'querySelector"))
+      return "illegal CSS selector \u2014 selectors match on class/role/attr, not text. For non-ASCII or text matching use /query?sel= or /click?text=, not a raw querySelector.";
+    return void 0;
+  }
+  if (has(code, "indexedDB.open") || has(code, "localStorage.getItem") || has(code, "localforage") || has(code, "__AIPEEK_STORES__"))
+    return "reading store state by hand \u2014 the /state axis is typed: /state lists every store, /state/<name> drills into one, /state?path=store.field.0 expands a nested value (e.g. /state?path=imStore.conversations.0).";
+  return void 0;
+}
+var MISROUTE = {
+  text: "/click?text= (or /fill /press)",
+  sel: "/click?sel= (or /fill /hover)",
+  value: "/fill?sel=\u2026&value=",
+  key: "/press?key="
+};
+function misroutedAction(keys) {
+  for (const k of keys) {
+    const dest = MISROUTE[k];
+    if (dest)
+      return `\`${k}=\` is a /click\xB7/fill\xB7/press param, not /action. /action is the green channel (?knob= replays a panel morphism, ?name= calls a mounted fn). To simulate a human click/type, use ${dest}.`;
+  }
+  return void 0;
+}
+
+// src/ui/server/dispatch.ts
+var SPECIAL_CONTRACT = /* @__PURE__ */ new Set(["screenshot", "realclick", "query", "assert"]);
+var ACTION_TYPES = TYPES.filter((t) => !SPECIAL_CONTRACT.has(t));
+function isDispatchAction(type) {
+  return ACTION_TYPES.includes(type);
+}
+function argsFromQuery(q) {
+  return {
+    sel: q.get("sel") || void 0,
+    text: q.get("text") || void 0,
+    value: q.has("value") ? q.get("value") : void 0,
+    key: q.get("key") || void 0,
+    timeout: q.has("timeout") ? Number(q.get("timeout")) : void 0,
+    gone: q.has("gone") ? q.get("gone") !== "false" : void 0,
+    enabled: q.has("enabled") ? q.get("enabled") !== "false" : void 0,
+    button: q.get("button") === "right" ? "right" : q.get("button") === "left" ? "left" : void 0,
+    x: q.has("x") ? Number(q.get("x")) : void 0,
+    y: q.has("y") ? Number(q.get("y")) : void 0,
+    screen: q.get("screen") || void 0,
+    equals: q.has("equals") ? q.get("equals") : void 0,
+    to: q.get("to") || void 0,
+    files: q.has("files") ? q.get("files").split(",").map((s) => s.trim()).filter(Boolean) : void 0,
+    mode: q.get("mode") === "write" ? "write" : q.get("mode") === "read" ? "read" : void 0
+  };
+}
+async function dispatchScreen(bridge, opts) {
+  const reply = await bridge.request("aihand:collect-screen", "aihand:screen", { form: opts?.form }, { tab: opts?.tab });
+  const body = [reply.canvas, reply.screen].filter(Boolean).join("\n\n");
+  return { reply, result: { status: 200, body: body || "(empty)" } };
+}
+async function runChain(steps, runStep) {
+  const lines = [];
+  let lastActions = "";
+  let allOk = true;
+  for (let i = 0; i < steps.length; i++) {
+    const { type, ...args } = steps[i];
+    const r = await runStep(type, args, i);
+    lines.push(`[${i}] ${r.ok ? "\u2713" : "\u2717"} ${r.label}: ${r.ok ? r.detail || "ok" : r.error}`);
+    if (!r.ok && r.detail)
+      lines.push(`    clickable: ${r.detail}`);
+    if (r.screen)
+      lines.push(r.screen.split("\n").map((l) => `    ${l}`).join("\n"));
+    if (r.actions)
+      lastActions = r.actions;
+    if (!r.ok) {
+      allOk = false;
+      break;
+    }
+  }
+  if (!allOk && lines.length) {
+    const ran = lines.filter((l) => l.startsWith("[")).length;
+    const skipped = steps.length - ran;
+    if (skipped > 0)
+      lines.push(`[${ran}..${steps.length - 1}] skipped (${skipped} step${skipped > 1 ? "s" : ""} not run \u2014 chain stopped at first failure)`);
+  }
+  const chainActions = lastActions ? `
+
+--- recent actions ---
+${lastActions}` : "";
+  return { status: allOk ? 200 : 422, body: `${lines.join("\n")}${chainActions}` };
+}
+var SPA_NAV_CAP = 1500;
+function trivialDiff(changed) {
+  if (!changed)
+    return true;
+  const lines = changed.split("\n").map((l) => l.trim()).filter(Boolean);
+  return lines.length === 0 || lines.every((l) => l === "(no state change)" || l.startsWith("focus:") || l.startsWith("--- "));
+}
+async function executeAction(bridge, type, args, ctx) {
+  const check = resolveAction(type, args);
+  if (!check.valid)
+    return { status: 400 };
+  const id = ctx.nextId();
+  const fullMs = Math.max(args.timeout ?? 0, 3e3) + 2e3;
+  const preUrl = ctx.afterNav ? await ctx.afterNav.url() : void 0;
+  const spaArm = ctx.afterNav?.armSameDocNav && (type === "click" || type === "press") ? ctx.afterNav.armSameDocNav() : void 0;
+  let navigated = false;
+  const result = await bridge.request("aihand:action", "aihand:result", { id, type, args }, { tab: ctx.tab, timeoutMs: fullMs, onNav: () => {
+    navigated = true;
+  } });
+  let changed = result.screen;
+  if (ctx.afterNav && result.ok && navigated) {
+    const renav = await ctx.afterNav.renavScreen(preUrl ?? "");
+    if (renav)
+      changed = renav;
+  } else if (spaArm && result.ok && !navigated) {
+    const cap = trivialDiff(changed) ? SPA_NAV_CAP : 0;
+    if (await spaArm.wait(cap)) {
+      navigated = true;
+      const renav = await ctx.afterNav.renavScreen(preUrl ?? "");
+      if (renav)
+        changed = renav;
+    }
+  } else if (spaArm) {
+    spaArm.cancel();
+  }
+  return { status: result.ok ? 200 : 422, result, changed, navigated };
+}
+async function dispatchAction(bridge, type, args, ctx) {
+  const ex = await executeAction(bridge, type, args, ctx);
+  if (!ex.result) {
+    const check = resolveAction(type, args);
+    return { status: 400, body: check.error ?? "invalid action" };
+  }
+  const { result } = ex;
+  const head = result.ok ? result.detail || "ok" : `${result.error}${result.detail ? `
+
+clickable: ${result.detail}` : ""}`;
+  const actionsTail = result.actions && !ex.navigated ? `
+
+--- recent actions ---
+${result.actions}` : "";
+  const changedTail = ex.changed ? `
+
+--- changed ---
+${ex.changed}` : "";
+  const flowTail = result.flow ? `
+
+--- flow ---
+${result.flow}` : "";
+  return { status: result.ok ? 200 : 422, body: `${head}${actionsTail}${changedTail}${flowTail}` };
+}
+async function dispatchChainStep(bridge, type, args, ctx) {
+  if (!isDispatchAction(type))
+    return { ok: false, label: type, error: `probe chain supports ${ACTION_TYPES.join("/")} only (got ${type})` };
+  const ex = await executeAction(bridge, type, args, ctx);
+  if (!ex.result) {
+    const check = resolveAction(type, args);
+    return { ok: false, label: type, error: check.error ?? "invalid action" };
+  }
+  const { result } = ex;
+  return {
+    ok: result.ok,
+    label: type,
+    detail: result.detail,
+    error: result.error,
+    // 单发把 flow 单列一段尾;chain 单步把 changed + flow 都当缩进 delta 显示在步下。
+    screen: [ex.changed, result.flow].filter(Boolean).join("\n") || void 0,
+    // 导航步的旧页动作环同样是噪音(与单发 dispatchAction 一致),抑制。
+    actions: ex.navigated ? void 0 : result.actions
+  };
+}
+
+export {
+  truncate,
+  formatValue,
+  appStackFrames,
+  compactUrl,
+  isRouteChange,
+  isLive,
+  formatTabs,
+  diagnose,
+  formatActions,
+  appendAction,
+  isSecretKey,
+  redactSecretValue,
+  TYPES,
+  resolveAction,
+  diagnoseEval,
+  misroutedAction,
+  isDispatchAction,
+  argsFromQuery,
+  dispatchScreen,
+  runChain,
+  dispatchAction,
+  dispatchChainStep
+};

package/dist/chunk-Z2Y65YOY.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+
+
+
+exports.importMetaUrl = importMetaUrl;

package/dist/chunk-ZJQRNIK7.js

@@ -0,0 +1,104 @@
+// src/read/seam.ts
+function fileOfInspPath(inspPath) {
+  const parts = inspPath.split(":");
+  return parts.length <= 3 ? parts[0] : parts.slice(0, parts.length - 3).join(":");
+}
+var key = (label, file) => `${label}\0${file}`;
+function joinPanel(staticKnobs, runtime) {
+  const liveSet = /* @__PURE__ */ new Set();
+  for (const r of runtime)
+    for (const f of r.files)
+      liveSet.add(key(r.label, f));
+  return staticKnobs.map((k) => ({
+    ...k,
+    live: k.label !== null && liveSet.has(key(k.label, k.filePath))
+  }));
+}
+var COLLECT_KNOBS_SCRIPT = `JSON.stringify(window.__aihandCollectKnobs ? window.__aihandCollectKnobs() : null)`;
+async function fetchRuntimeKnobs(port) {
+  const resp = await fetch(`http://localhost:${port}/__aihand/eval`, {
+    method: "POST",
+    body: COLLECT_KNOBS_SCRIPT
+  });
+  if (!resp.ok)
+    throw new Error(`runtime probe failed (${resp.status}) \u2014 is the dev server running with aihand() on :${port}?`);
+  const raw = JSON.parse(await resp.text());
+  if (!raw)
+    throw new Error("runtime knob collector missing (__aihandCollectKnobs) \u2014 the page is running an older aihand client; reload it");
+  return raw.map((r) => ({ label: r.label, files: r.files, tag: r.tag }));
+}
+
+// src/read/locate.ts
+function symbolAtLine(g, file, line) {
+  let best;
+  for (const s of Object.values(g.symbols)) {
+    if (s.filePath !== file || line < s.startLine || line > s.endLine)
+      continue;
+    if (!best || s.endLine - s.startLine < best.endLine - best.startLine)
+      best = s;
+  }
+  return best;
+}
+function parseInspPath(p) {
+  const parts = p.split(":");
+  const file = fileOfInspPath(p);
+  const lineStr = parts.length <= 3 ? parts[1] : parts[parts.length - 3];
+  return { file, line: Number(lineStr) };
+}
+function locate(g, file, line) {
+  const symbol = symbolAtLine(g, file, line);
+  if (!symbol)
+    return null;
+  const byUid = (uids) => (uids ?? []).map((u) => g.symbols[u]).filter(Boolean);
+  return {
+    symbol,
+    callers: byUid(g.in[symbol.uid]),
+    callees: byUid(g.out[symbol.uid])
+  };
+}
+var at = (s) => `${s.filePath}:${s.startLine + 1}`;
+function renderLocate(r, json = false) {
+  if (json)
+    return JSON.stringify(r, null, 2);
+  const lines = [`${r.symbol.name}  ${r.symbol.kind}  ${at(r.symbol)}`];
+  if (r.callers.length) {
+    lines.push(`
+Callers (${r.callers.length}):`);
+    for (const c of r.callers)
+      lines.push(`  ${c.name}  ${at(c)}`);
+  }
+  if (r.callees.length) {
+    lines.push(`
+Callees (${r.callees.length}):`);
+    for (const c of r.callees)
+      lines.push(`  ${c.name}  ${at(c)}`);
+  }
+  if (!r.callers.length && !r.callees.length)
+    lines.push("  (no call edges found)");
+  return lines.join("\n");
+}
+function sourcePanelHtml(r, esc = escHtml) {
+  const row = (c) => `<div class="aihand-src-edge" data-src-path="${esc(at(c))}">${esc(c.name)} <span class="aihand-src-at">${esc(at(c))}</span></div>`;
+  const out = [`<div class="aihand-src-head">${esc(r.symbol.name)} <span class="aihand-src-kind">${esc(r.symbol.kind)}</span> <span class="aihand-src-at">${esc(at(r.symbol))}</span></div>`];
+  if (r.callers.length)
+    out.push(`<div class="aihand-src-sec">Callers (${r.callers.length})</div>`, ...r.callers.map(row));
+  if (r.callees.length)
+    out.push(`<div class="aihand-src-sec">Callees (${r.callees.length})</div>`, ...r.callees.map(row));
+  if (!r.callers.length && !r.callees.length)
+    out.push(`<div class="aihand-src-empty">(no call edges found)</div>`);
+  return out.join("");
+}
+function escHtml(s) {
+  return s.split("&").join("&amp;").split("<").join("&lt;").split(">").join("&gt;").split('"').join("&quot;");
+}
+
+export {
+  fileOfInspPath,
+  joinPanel,
+  fetchRuntimeKnobs,
+  symbolAtLine,
+  parseInspPath,
+  locate,
+  renderLocate,
+  sourcePanelHtml
+};