@mrclrchtr/supi-debug 0.1.0

package/src/format.ts

@@ -0,0 +1,89 @@
+function formatPrimitive(value: unknown): string[] {
+  if (value === null) return ["null"];
+  if (typeof value === "boolean") return [String(value)];
+  if (typeof value === "number") return [String(value)];
+  if (typeof value === "bigint") return [`${value}n`];
+  if (typeof value === "string") {
+    if (value.includes("\n")) {
+      return value.split("\n");
+    }
+    return [JSON.stringify(value)];
+  }
+  return [String(value)];
+}
+
+function formatArray(value: unknown[], seen: WeakSet<object>): string[] {
+  if (value.length === 0) return ["[]"];
+  const lines: string[] = ["["];
+  for (let i = 0; i < value.length; i++) {
+    const itemLines = formatDataLinesRecursive(value[i], seen);
+    const indented = itemLines.map((line) => `  ${line}`);
+    if (i < value.length - 1) {
+      indented[indented.length - 1] += ",";
+    }
+    lines.push(...indented);
+  }
+  lines.push("]");
+  return lines;
+}
+
+function formatObjectEntry(
+  key: string,
+  value: unknown,
+  seen: WeakSet<object>,
+  isLast: boolean,
+): string[] {
+  const keyStr = JSON.stringify(key);
+  const valueLines = formatDataLinesRecursive(value, seen);
+  const lines: string[] = [];
+
+  if (typeof value === "string" && value.includes("\n")) {
+    lines.push(`  ${keyStr}:`);
+    for (const line of valueLines) {
+      lines.push(`    ${line}`);
+    }
+  } else {
+    valueLines[0] = `  ${keyStr}: ${valueLines[0]}`;
+    for (let j = 1; j < valueLines.length; j++) {
+      valueLines[j] = `  ${valueLines[j]}`;
+    }
+    lines.push(...valueLines);
+  }
+
+  if (!isLast) {
+    lines[lines.length - 1] += ",";
+  }
+  return lines;
+}
+
+function formatObject(value: Record<string, unknown>, seen: WeakSet<object>): string[] {
+  const entries = Object.entries(value);
+  if (entries.length === 0) return ["{}"];
+  const lines: string[] = ["{"];
+  for (let i = 0; i < entries.length; i++) {
+    const [k, v] = entries[i];
+    lines.push(...formatObjectEntry(k, v, seen, i === entries.length - 1));
+  }
+  lines.push("}");
+  return lines;
+}
+
+function formatDataLinesRecursive(value: unknown, seen: WeakSet<object>): string[] {
+  if (value === undefined) return [];
+  if (value === null || typeof value !== "object") {
+    return formatPrimitive(value);
+  }
+  if (seen.has(value)) {
+    return ['"[Circular]"'];
+  }
+  seen.add(value);
+  if (Array.isArray(value)) {
+    return formatArray(value, seen);
+  }
+  return formatObject(value as Record<string, unknown>, seen);
+}
+
+/** Recursively format a debug payload into readable, indented lines. */
+export function formatDataLines(value: unknown): string[] {
+  return formatDataLinesRecursive(value, new WeakSet<object>());
+}

package/src/index.ts

@@ -0,0 +1 @@
+export { default } from "./debug.ts";

package/src/renderer.ts

@@ -0,0 +1,104 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { Text } from "@earendil-works/pi-tui";
+import type { DebugEventView } from "@mrclrchtr/supi-core";
+import { formatDataLines } from "./format.ts";
+
+const DEBUG_REPORT_TYPE = "supi-debug-report";
+
+interface DebugReportDetails {
+  events?: DebugEventView[];
+  rawAccessDenied?: boolean;
+}
+
+type Theme = Parameters<Parameters<ExtensionAPI["registerMessageRenderer"]>[1]>[2];
+
+function formatLevel(theme: Theme, level: string): string {
+  const color =
+    level === "error"
+      ? "error"
+      : level === "warning"
+        ? "warning"
+        : level === "info"
+          ? "accent"
+          : "muted";
+  return theme.fg(color, level.toUpperCase());
+}
+
+function pushEventLines(lines: string[], event: DebugEventView, theme: Theme): void {
+  const timestamp = theme.fg("dim", `[${new Date(event.timestamp).toISOString()}]`);
+  const level = formatLevel(theme, event.level);
+  const source = theme.fg("toolTitle", `${event.source}/${event.category}`);
+
+  lines.push(`${timestamp} ${level} ${source}: ${event.message}`);
+
+  if (event.cwd) {
+    lines.push(theme.fg("dim", `  cwd: ${event.cwd}`));
+  }
+
+  const dataLines = formatDataLines(event.data);
+  if (dataLines.length > 0) {
+    if (dataLines.length === 1) {
+      lines.push(theme.fg("dim", `  data: ${dataLines[0]}`));
+    } else {
+      lines.push(theme.fg("dim", "  data:"));
+      for (const dl of dataLines) {
+        lines.push(theme.fg("dim", `    ${dl}`));
+      }
+    }
+  }
+
+  const rawLines = formatDataLines(event.rawData);
+  if (rawLines.length > 0) {
+    if (rawLines.length === 1) {
+      lines.push(theme.fg("dim", `  rawData: ${rawLines[0]}`));
+    } else {
+      lines.push(theme.fg("dim", "  rawData:"));
+      for (const rl of rawLines) {
+        lines.push(theme.fg("dim", `    ${rl}`));
+      }
+    }
+  }
+}
+
+function renderExpandedReport(details: DebugReportDetails, theme: Theme): string {
+  const lines: string[] = [];
+  for (const event of details.events ?? []) {
+    if (lines.length > 0) lines.push("");
+    pushEventLines(lines, event, theme);
+  }
+
+  if (details.rawAccessDenied) {
+    lines.push("");
+    lines.push(
+      theme.fg(
+        "warning",
+        "Raw debug data was requested but is not enabled in SuPi Debug settings.",
+      ),
+    );
+  }
+
+  return lines.join("\n");
+}
+
+/** Register the TUI message renderer for supi-debug-report custom messages. */
+export function registerDebugMessageRenderer(pi: ExtensionAPI): void {
+  pi.registerMessageRenderer(DEBUG_REPORT_TYPE, (message, options, theme) => {
+    const { expanded } = options;
+    const details = (message.details ?? {}) as DebugReportDetails;
+    const events = details.events ?? [];
+
+    if (events.length === 0) {
+      const text = typeof message.content === "string" ? message.content : "No debug events.";
+      return new Text(theme.fg("muted", text), 0, 0);
+    }
+
+    if (!expanded) {
+      const first = events[0];
+      const more = events.length > 1 ? ` +${events.length - 1} more` : "";
+      const summary = `${events.length} event${events.length === 1 ? "" : "s"} — ${first.source}/${first.category}${more}`;
+      return new Text(theme.fg("muted", summary), 0, 0);
+    }
+
+    return new Text(renderExpandedReport(details, theme), 0, 0);
+  });
+}