@llblab/pi-actors 0.42.3 → 0.43.0

package/dist/lib/inspector.js

@@ -1,15 +1,16 @@
 /**
- * Inspector preview rendering.
- * Zones: terminal run inspection, room/direct message previews, no-dependency UI formatting
- * Owns read-only previews and TUI-ready summaries; actor routing stays outside.
+ * Actor Inspector evidence readers.
+ * Zones: owned actor-instance inventory and captured Recipe projection
+ * Owns actor-instance TUI evidence; Trace, Control, and execution parsing stay in their domains.
  */
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { visibleWidth } from "@earendil-works/pi-tui";
-import * as Limits from "./limits.js";
-import * as Paths from "./paths.js";
 import * as SessionEvidence from "./session-evidence.js";
-import { readJsonFileResilient, readJsonlFileResilient, } from "./state-readers.js";
+import { readJsonFileResilient } from "./state-readers.js";
+function matchesOwner(stateDir, ownerId) {
+    const meta = readJsonFileResilient(path.join(stateDir, "run.json"), {}).value;
+    return meta.ownerId === ownerId;
+}
 export function readActorInspectorRuns(stateRoot, ownerId) {
     try {
         return fs
@@ -27,7 +28,8 @@ export function readActorInspectorRuns(stateRoot, ownerId) {
                     ...(typeof runMeta.run_instance_id === "string"
                         ? { runInstanceId: runMeta.run_instance_id }
                         : {}),
-                    status: String(progress.phase ?? (Object.keys(result).length ? "terminal" : "unknown")),
+                    status: String(progress.phase ??
+                        (Object.keys(result).length ? "terminal" : "unknown")),
                     ...(typeof progress.updatedAt === "string"
                         ? { updatedAt: progress.updatedAt }
                         : typeof result.completedAt === "string"
@@ -35,14 +37,10 @@ export function readActorInspectorRuns(stateRoot, ownerId) {
                             : {}),
                 }];
         })
-            .sort((left, right) => {
-            const recency = String(right.updatedAt ?? "").localeCompare(String(left.updatedAt ?? ""));
-            return recency || right.run.localeCompare(left.run);
-        });
+            .sort((left, right) => String(right.updatedAt ?? "").localeCompare(String(left.updatedAt ?? "")) ||
+            right.run.localeCompare(left.run));
     }
-    catch (error) {
-        if (error.code === "ENOENT")
-            return [];
+    catch {
         return [];
     }
 }
@@ -50,16 +48,15 @@ export function readActorInspectorRecipe(stateDir) {
     const result = readJsonFileResilient(path.join(stateDir, "run.json"), {});
     const meta = result.value;
     const contexts = Array.isArray(meta.recipe_context_records)
-        ? meta.recipe_context_records
-            .filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry)))
+        ? meta.recipe_context_records.filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry)))
         : [];
     const primary = contexts.find((entry) => entry.depth === 0) ?? contexts[0];
-    const definition = primary?.recipe && typeof primary.recipe === "object" &&
+    const definition = primary?.recipe &&
+        typeof primary.recipe === "object" &&
         !Array.isArray(primary.recipe)
         ? primary.recipe
         : undefined;
-    const redacted = (value) => SessionEvidence.redactSessionEvidenceValue(value);
-    const redactedRecord = (value) => redacted(Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined)));
+    const redactedRecord = (value) => SessionEvidence.redactSessionEvidenceValue(Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined)));
     return {
         composition: contexts.map((entry) => redactedRecord({
             ...(typeof entry.alias === "string" ? { alias: entry.alias } : {}),
@@ -68,9 +65,7 @@ export function readActorInspectorRecipe(stateDir) {
             import_path: entry.import_path,
             name: entry.name,
         })),
-        ...(definition
-            ? { definition: redactedRecord(definition) }
-            : {}),
+        ...(definition ? { definition: redactedRecord(definition) } : {}),
         diagnostics: result.diagnostics.map((diagnostic) => diagnostic.message),
         identity: redactedRecord({
             run: meta.run,
@@ -83,651 +78,10 @@ export function readActorInspectorRecipe(stateDir) {
             template: meta.template,
             values: meta.values,
             model_policy: meta.model_policy,
-            mailbox: meta.mailbox,
+            control: meta.control,
             artifacts: meta.artifacts,
             notification_policy: meta.notification_policy,
             retire_when: meta.retire_when,
         }),
     };
 }
-function ownedSessionPath(stateDir, sessionFile) {
-    if (path.isAbsolute(sessionFile))
-        return undefined;
-    const sessionsRoot = path.resolve(stateDir, "sessions");
-    const resolved = path.resolve(stateDir, sessionFile);
-    if (!resolved.startsWith(`${sessionsRoot}${path.sep}`))
-        return undefined;
-    try {
-        const canonicalRoot = fs.realpathSync(sessionsRoot);
-        const canonicalFile = fs.realpathSync(resolved);
-        return canonicalFile.startsWith(`${canonicalRoot}${path.sep}`)
-            ? canonicalFile
-            : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-export function readActorInspectorTurns(stateDir) {
-    const evidence = readJsonFileResilient(path.join(stateDir, "review-evidence.json"), {}).value;
-    const commands = Array.isArray(evidence.commands)
-        ? evidence.commands
-        : [];
-    const recordedFiles = new Set(commands.flatMap((command) => (Array.isArray(command.session_files) ? command.session_files : []).filter((file) => typeof file === "string")));
-    let discoveredCommands = [];
-    try {
-        const sessionsDir = path.join(stateDir, "sessions");
-        discoveredCommands = fs
-            .readdirSync(sessionsDir, { withFileTypes: true })
-            .filter((entry) => entry.isDirectory())
-            .flatMap((entry) => {
-            const files = fs
-                .readdirSync(path.join(sessionsDir, entry.name), {
-                withFileTypes: true,
-            })
-                .filter((file) => file.isFile() && file.name.endsWith(".jsonl"))
-                .map((file) => path.posix.join("sessions", entry.name, file.name))
-                .filter((file) => !recordedFiles.has(file));
-            return files.length > 0
-                ? [{ id: entry.name, session_files: files, stage: "subagent" }]
-                : [];
-        });
-    }
-    catch {
-        discoveredCommands = [];
-    }
-    return [...commands, ...discoveredCommands].flatMap((command) => (Array.isArray(command.session_files) ? command.session_files : [])
-        .filter((file) => typeof file === "string")
-        .flatMap((file) => {
-        const sessionPath = ownedSessionPath(stateDir, file);
-        if (!sessionPath)
-            return [];
-        const session = SessionEvidence.readSessionEvidence(sessionPath);
-        return session.turns.map((turn) => ({
-            ...turn,
-            commandId: String(command.id ?? "unknown"),
-            diagnostics: session.diagnostics.map((item) => `${item.line === undefined ? "" : `line ${item.line}: `}${item.message}`),
-            ...(typeof command.prompt_bytes === "number"
-                ? { promptBytes: command.prompt_bytes }
-                : {}),
-            ...(typeof command.prompt_file === "string"
-                ? { promptFile: command.prompt_file }
-                : {}),
-            ...(command.recipe_context !== undefined
-                ? { recipeContext: command.recipe_context }
-                : {}),
-            sessionFile: file,
-            sessionTruncated: session.truncated,
-            ...(typeof command.stage === "string" ? { stage: command.stage } : {}),
-        }));
-    })).map((turn, index) => ({ ...turn, index: index + 1 }));
-}
-function asRecord(value) {
-    return value && typeof value === "object" && !Array.isArray(value)
-        ? value
-        : {};
-}
-function readJsonLines(file) {
-    return readJsonlFileResilient(file).records;
-}
-function previewValue(value, maxLength = Limits.INSPECTOR_BODY_PREVIEW_CHARS) {
-    if (value === undefined)
-        return undefined;
-    const redacted = SessionEvidence.redactSessionEvidenceValue(value);
-    const text = typeof redacted === "string" ? redacted : JSON.stringify(redacted);
-    const compact = text.replaceAll(/\s+/g, " ").trim();
-    if (!compact)
-        return undefined;
-    return compact.length > maxLength
-        ? `${compact.slice(0, Math.max(0, maxLength - 1))}…`
-        : compact;
-}
-function channelFor(message) {
-    if (message.to.startsWith("room:"))
-        return "room";
-    if (message.to === "coordinator" || message.to.startsWith("session:"))
-        return "broadcast";
-    return "direct";
-}
-function previewFromMessage(run, message, timestamp, displayNames = {}) {
-    const to = typeof message.to === "string" ? message.to : undefined;
-    const type = typeof message.type === "string" ? message.type : undefined;
-    if (!to || !type)
-        return undefined;
-    const from = typeof message.from === "string" ? message.from : undefined;
-    const summary = typeof message.summary === "string" ? message.summary : undefined;
-    const body = asRecord(message.body);
-    const metadata = asRecord(message.metadata);
-    const eventId = typeof message.id === "string" && message.id.trim()
-        ? message.id.trim()
-        : undefined;
-    const display = from
-        ? typeof body.display === "string" && body.display.trim()
-            ? body.display.trim()
-            : displayNames[from]
-        : undefined;
-    return {
-        ...(previewValue(message.body)
-            ? { body_preview: previewValue(message.body) }
-            : {}),
-        channel: channelFor({ to }),
-        ...(eventId ? { event_id: eventId } : {}),
-        ...(from ? { from } : {}),
-        ...(display ? { from_display: display } : {}),
-        ...(metadata.requires_response === true ? { needs_response: true } : {}),
-        run,
-        ...(summary ? { summary } : {}),
-        timestamp,
-        to,
-        type,
-    };
-}
-function readRoomRosterRecords(stateDir, room) {
-    return readJsonFileResilient(path.join(stateDir, "rooms", room, "roster.json"), {}).value;
-}
-function memberDisplay(_address, member) {
-    const display = typeof member.display === "string" ? member.display.trim() : "";
-    return display || undefined;
-}
-function readRoomDisplayNames(stateDir, room) {
-    const roster = readRoomRosterRecords(stateDir, room);
-    return Object.fromEntries(Object.entries(roster).flatMap(([address, member]) => {
-        const display = memberDisplay(address, member);
-        return display ? [[address, display]] : [];
-    }));
-}
-function readRoomPreviews(run, stateDir) {
-    const roomsDir = path.join(stateDir, "rooms");
-    try {
-        const previews = fs
-            .readdirSync(roomsDir, { withFileTypes: true })
-            .filter((entry) => entry.isDirectory())
-            .flatMap((entry) => {
-            const displayNames = readRoomDisplayNames(stateDir, entry.name);
-            return readJsonLines(path.join(roomsDir, entry.name, "messages.jsonl"))
-                .map((message) => previewFromMessage(run, message, String(message.received_at ?? message.timestamp ?? ""), displayNames))
-                .filter((preview) => Boolean(preview));
-        });
-        return previews;
-    }
-    catch (error) {
-        if (error.code === "ENOENT")
-            return [];
-        return [];
-    }
-}
-function readInboxPreviews(run, stateDir) {
-    return readJsonLines(path.join(stateDir, "inbox.jsonl"))
-        .map((message) => previewFromMessage(run, message, String(message.received_at ?? message.timestamp ?? "")))
-        .filter((preview) => Boolean(preview));
-}
-function readBranchInboxPreviews(run, stateDir) {
-    const branchesDir = path.join(stateDir, "branches");
-    try {
-        return fs
-            .readdirSync(branchesDir, { withFileTypes: true })
-            .filter((entry) => entry.isDirectory())
-            .flatMap((entry) => readJsonLines(path.join(branchesDir, entry.name, "inbox.jsonl"))
-            .map((message) => {
-            const preview = previewFromMessage(run, message, String(message.queued_at ??
-                message.received_at ??
-                message.timestamp ??
-                ""));
-            if (!preview)
-                return undefined;
-            return {
-                ...preview,
-                branch: entry.name,
-                ...(typeof message.id === "string"
-                    ? { message_id: message.id }
-                    : {}),
-                ...(typeof message.status === "string"
-                    ? { inbox_status: message.status }
-                    : {}),
-            };
-        })
-            .filter((preview) => Boolean(preview)));
-    }
-    catch (error) {
-        if (error.code === "ENOENT")
-            return [];
-        return [];
-    }
-}
-function readOutboxPreviews(run, stateDir) {
-    return readJsonLines(path.join(stateDir, "outbox.jsonl"))
-        .map((event) => {
-        const message = asRecord(event.message ?? event);
-        return previewFromMessage(run, message, String(event.timestamp ?? event.created_at ?? event.emitted_at ?? ""));
-    })
-        .filter((preview) => Boolean(preview));
-}
-function getRunOwnerId(stateDir) {
-    const meta = readJsonFileResilient(path.join(stateDir, "run.json"), undefined).value;
-    return typeof meta?.ownerId === "string" ? meta.ownerId : undefined;
-}
-function matchesOwner(stateDir, ownerId) {
-    return ownerId === undefined || getRunOwnerId(stateDir) === ownerId;
-}
-export function inspectorPreviewReadKey(preview) {
-    return [
-        preview.channel,
-        preview.run,
-        preview.branch ?? "",
-        preview.event_id ?? preview.message_id ?? preview.timestamp,
-        preview.from ?? "",
-        preview.to,
-        preview.type,
-    ].join("|");
-}
-function isUnreadPreview(preview, readKeys) {
-    if (readKeys?.has(inspectorPreviewReadKey(preview)))
-        return false;
-    return (preview.inbox_status === "queued" ||
-        (preview.inbox_status === undefined && preview.branch !== undefined));
-}
-function matchesBranchFilter(preview, branch) {
-    const name = branch?.trim();
-    if (!name)
-        return true;
-    if (preview.branch !== undefined)
-        return preview.branch === name;
-    const address = `branch:${preview.run}/${name}`;
-    return preview.from === address || preview.to === address;
-}
-function matchesPreviewFilter(preview, options) {
-    if (options.channels?.length && !options.channels.includes(preview.channel)) {
-        return false;
-    }
-    const readKeys = options.readKeys ? new Set(options.readKeys) : undefined;
-    if (options.unreadOnly && !isUnreadPreview(preview, readKeys))
-        return false;
-    if (!matchesBranchFilter(preview, options.branch))
-        return false;
-    const mention = options.mention?.trim().toLowerCase();
-    if (!mention)
-        return true;
-    return [
-        preview.branch,
-        preview.from,
-        preview.from_display,
-        preview.inbox_status,
-        preview.to,
-        preview.type,
-        preview.summary,
-        preview.body_preview,
-    ].some((value) => value?.toLowerCase().includes(mention));
-}
-function limitRoomPreviewsPerRun(previews, limitPerRun) {
-    if (!Number.isFinite(limitPerRun))
-        return previews;
-    const limit = Math.max(0, Number(limitPerRun));
-    const remainingByRun = new Map();
-    const keep = new Set();
-    for (let index = previews.length - 1; index >= 0; index -= 1) {
-        const preview = previews[index];
-        if (preview.channel !== "room") {
-            keep.add(preview);
-            continue;
-        }
-        const remaining = remainingByRun.get(preview.run) ?? limit;
-        if (remaining <= 0) {
-            remainingByRun.set(preview.run, 0);
-            continue;
-        }
-        keep.add(preview);
-        remainingByRun.set(preview.run, remaining - 1);
-    }
-    return previews.filter((preview) => keep.has(preview));
-}
-export function readActorInspectorPreviews(stateRoot = Paths.getRunStateRoot(), limit = 8, options = {}) {
-    try {
-        const previews = fs
-            .readdirSync(stateRoot, { withFileTypes: true })
-            .filter((entry) => entry.isDirectory())
-            .flatMap((entry) => {
-            const stateDir = path.join(stateRoot, entry.name);
-            if (!matchesOwner(stateDir, options.ownerId))
-                return [];
-            if (options.run && entry.name !== options.run)
-                return [];
-            return [
-                ...readRoomPreviews(entry.name, stateDir),
-                ...readInboxPreviews(entry.name, stateDir),
-                ...readBranchInboxPreviews(entry.name, stateDir),
-                ...readOutboxPreviews(entry.name, stateDir),
-            ];
-        })
-            .filter((preview) => preview.timestamp)
-            .sort((a, b) => a.timestamp.localeCompare(b.timestamp));
-        const currentRun = options.currentRunOnly
-            ? previews.at(-1)?.run
-            : undefined;
-        const sequenced = previews
-            .filter((preview) => !currentRun || preview.run === currentRun)
-            .filter((preview) => matchesPreviewFilter(preview, options))
-            .map((preview, index) => ({
-            ...preview,
-            sequence: index + 1,
-            stripe: index % 2 === 1,
-        }));
-        return limitRoomPreviewsPerRun(sequenced, options.roomLimitPerRun).slice(-Math.max(1, limit));
-    }
-    catch (error) {
-        if (error.code === "ENOENT")
-            return [];
-        return [];
-    }
-}
-function shorten(value, maxLength, options = { preserveSpaces: true }) {
-    if (!value)
-        return "-";
-    const compact = options.preserveSpaces === false
-        ? value.replaceAll(/\s+/g, "_")
-        : value.replaceAll(/\s+/g, " ").trim();
-    if (maxLength <= 1)
-        return compact.slice(0, Math.max(0, maxLength));
-    return compact.length > maxLength
-        ? `${compact.slice(0, Math.max(0, maxLength - 1))}…`
-        : compact;
-}
-function actorName(address) {
-    if (!address)
-        return "unknown";
-    const branch = /^branch:[^/]+\/(.+)$/.exec(address);
-    if (branch)
-        return branch[1] || address;
-    const run = /^run:(.+)$/.exec(address);
-    if (run)
-        return run[1] || address;
-    return address;
-}
-function roomName(address) {
-    const room = /^room:([^/]+)(?:\/(main))?$/.exec(address);
-    return room ? room[1] : undefined;
-}
-function routeActorText(preview) {
-    return preview.from_display || actorName(preview.from);
-}
-function routeText(preview) {
-    const actor = routeActorText(preview);
-    if (preview.channel === "room")
-        return `${actor} # all`;
-    if (preview.channel === "broadcast")
-        return `${actor} ⇢ ${preview.to}`;
-    return `${actor} → ${actorName(preview.to)}`;
-}
-function attentionMarker(preview) {
-    return preview.needs_response ? "! " : "";
-}
-function style(styleFn, text) {
-    return styleFn ? styleFn(text) : text;
-}
-function previewText(preview) {
-    return preview.summary || preview.body_preview || "-";
-}
-function propertyValue(value) {
-    if (value === undefined)
-        return "";
-    if (typeof value === "string")
-        return value;
-    if (typeof value === "number" || typeof value === "boolean")
-        return String(value);
-    return JSON.stringify(value);
-}
-function displayWidth(value) {
-    return visibleWidth(value);
-}
-const lineSegmenter = new Intl.Segmenter();
-function boundedLine(value, width) {
-    if (width <= 0)
-        return "";
-    if (visibleWidth(value) <= width)
-        return value;
-    const ellipsis = "…";
-    const ellipsisWidth = visibleWidth(ellipsis);
-    if (width <= ellipsisWidth)
-        return ellipsis.slice(0, width);
-    let output = "";
-    let used = 0;
-    const maxTextWidth = width - ellipsisWidth;
-    for (const { segment } of lineSegmenter.segment(value)) {
-        const segmentWidth = visibleWidth(segment);
-        if (used + segmentWidth > maxTextWidth)
-            break;
-        output += segment;
-        used += segmentWidth;
-    }
-    return `${output}${ellipsis}`;
-}
-function padLine(plain, rendered, width, styles) {
-    const boundedPlain = boundedLine(plain, width);
-    const visible = boundedPlain === plain ? rendered : style(styles.preview, boundedPlain);
-    const padding = Math.max(0, width - visibleWidth(boundedPlain));
-    return `${visible}${" ".repeat(padding)}`;
-}
-function renderCompactInspectorEntry(preview, width, sequenceWidth, routeWidth, typeWidth, styles, stripe) {
-    const separator = "  ";
-    const prefix = " ";
-    const suffix = " ";
-    const contentWidth = Math.max(8, width - prefix.length - suffix.length);
-    const sequence = String(preview.sequence ?? 0).padStart(sequenceWidth, " ");
-    const sequencePrefix = `${sequence}${separator}`;
-    const route = `${attentionMarker(preview)}${routeText(preview)}`;
-    const routePadding = " ".repeat(Math.max(0, routeWidth - displayWidth(route)));
-    const typePadding = " ".repeat(Math.max(0, typeWidth - displayWidth(preview.type)));
-    const headline = previewText(preview);
-    const lead = `${sequencePrefix}${route}${routePadding}${separator}${preview.type}${typePadding}${separator}`;
-    const visibleHeadline = boundedLine(headline, Math.max(0, contentWidth - displayWidth(lead)));
-    const plain = `${lead}${visibleHeadline}`;
-    const rendered = [
-        style(styles.muted, sequencePrefix),
-        style(styles.target, route),
-        routePadding,
-        separator,
-        style(styles.type, preview.type),
-        typePadding,
-        separator,
-        style(styles.preview, visibleHeadline),
-    ].join("");
-    const line = `${prefix}${padLine(plain, rendered, contentWidth, styles)}${suffix}`;
-    if (stripe && styles.stripe)
-        return [styles.stripe(line)];
-    if (!stripe && styles.stripeAlt)
-        return [styles.stripeAlt(line)];
-    return [line];
-}
-function renderInspectorEntry(preview, width, sequenceWidth, routeWidth, typeWidth, summaryWidth, styles, stripe) {
-    const separator = "  ";
-    const prefix = " ";
-    const suffix = " ";
-    const contentWidth = Math.max(8, width - prefix.length - suffix.length);
-    const sequence = String(preview.sequence ?? 0).padStart(sequenceWidth, " ");
-    const sequencePrefix = `${sequence}${separator}`;
-    const route = `${attentionMarker(preview)}${routeText(preview)}`;
-    const type = preview.type;
-    const summary = preview.summary?.trim() ?? "";
-    const body = preview.body_preview?.trim() || (!summary ? previewText(preview) : "-");
-    const visibleRoute = boundedLine(route, routeWidth);
-    const visibleType = boundedLine(type, typeWidth);
-    const boundedRoutePadding = " ".repeat(Math.max(0, routeWidth - displayWidth(visibleRoute)));
-    const boundedTypePadding = " ".repeat(Math.max(0, typeWidth - displayWidth(visibleType)));
-    const leadParts = [
-        style(styles.muted, sequencePrefix),
-        style(styles.target, visibleRoute),
-        boundedRoutePadding,
-        separator,
-        style(styles.type, visibleType),
-        boundedTypePadding,
-        separator,
-    ];
-    let lead = `${sequencePrefix}${visibleRoute}${boundedRoutePadding}${separator}${visibleType}${boundedTypePadding}${separator}`;
-    if (summary) {
-        const visibleSummary = boundedLine(summary, summaryWidth);
-        const summaryPadding = " ".repeat(Math.max(0, summaryWidth - displayWidth(visibleSummary)));
-        lead += `${visibleSummary}${summaryPadding}${separator}`;
-        leadParts.push(style(styles.preview, visibleSummary), summaryPadding, separator);
-    }
-    const visibleBody = boundedLine(body, Math.max(0, contentWidth - displayWidth(lead)));
-    const plain = `${lead}${visibleBody}`;
-    const rendered = `${leadParts.join("")}${style(styles.preview, visibleBody)}`;
-    const line = `${prefix}${padLine(plain, rendered, contentWidth, styles)}${suffix}`;
-    if (stripe && styles.stripe)
-        return [styles.stripe(line)];
-    if (!stripe && styles.stripeAlt)
-        return [styles.stripeAlt(line)];
-    return [line];
-}
-export function readActorInspectorRoster(stateRoot = Paths.getRunStateRoot(), run, room = "main") {
-    const stateDir = path.join(stateRoot, run);
-    const roster = readRoomRosterRecords(stateDir, room);
-    return Object.entries(roster).map(([address, member]) => ({
-        address,
-        ...(memberDisplay(address, member)
-            ? { display: memberDisplay(address, member) }
-            : {}),
-        ...(typeof member.role === "string" ? { role: member.role } : {}),
-        ...(typeof member.status === "string" ? { status: member.status } : {}),
-    }));
-}
-function rosterRoleText(role) {
-    const roleLabel = role?.split(";")[0] ?? "";
-    const cleaned = roleLabel
-        .replaceAll(/\s*\([^)]*\)\s*$/g, "")
-        .trim()
-        .toLowerCase();
-    if (!cleaned || cleaned === "actor")
-        return undefined;
-    return cleaned.replaceAll(/\s+/g, "-");
-}
-function rosterMemberText(member) {
-    const name = member.display || actorName(member.address);
-    const role = rosterRoleText(member.role);
-    if (role === "run")
-        return `run/${name}`;
-    return role ? `${name}/${role}` : name;
-}
-function isRosterMemberActive(member) {
-    const status = member.status?.trim().toLowerCase();
-    return (!status ||
-        status === "present" ||
-        status === "active" ||
-        status === "running");
-}
-export function renderInspectorRosterLine(members, width = 80, styles = {}) {
-    return renderInspectorRosterPanel(members, width, styles)?.[0];
-}
-export function renderInspectorRosterPanel(members, width = 80, styles = {}) {
-    if (members.length === 0)
-        return undefined;
-    const safeWidth = Math.max(1, width);
-    const innerWidth = Math.max(1, safeWidth - 2);
-    const prefix = `roster ${members.length}: `;
-    const tokens = members.map((member) => ({
-        active: isRosterMemberActive(member),
-        text: rosterMemberText(member),
-    }));
-    const lines = [];
-    let plain = prefix;
-    let rendered = style(styles.muted, prefix);
-    const flush = () => {
-        const visible = boundedLine(plain, innerWidth);
-        const line = visible === plain ? rendered : style(styles.muted, visible);
-        lines.push(` ${line}${" ".repeat(Math.max(0, innerWidth - displayWidth(visible)))} `);
-    };
-    for (const token of tokens) {
-        const separator = plain === prefix ? "" : ", ";
-        const nextPlain = `${plain}${separator}${token.text}`;
-        const renderedToken = style(token.active ? styles.target : styles.muted, token.text);
-        if (plain !== prefix && displayWidth(nextPlain) > innerWidth) {
-            flush();
-            plain = `  ${token.text}`;
-            rendered = `${style(styles.muted, "  ")}${renderedToken}`;
-            continue;
-        }
-        plain = nextPlain;
-        rendered = `${rendered}${style(styles.muted, separator)}${renderedToken}`;
-    }
-    flush();
-    return lines;
-}
-export function renderInspectorItemView(previews, width = 80, styles = {}, options) {
-    const preview = previews.find((item) => item.sequence === options.sequence);
-    if (!preview)
-        return undefined;
-    const safeWidth = Math.max(1, width);
-    const prefix = " ";
-    const suffix = " ";
-    const contentWidth = Math.max(8, safeWidth - prefix.length - suffix.length);
-    const rawEntries = [
-        ["channel", preview.channel],
-        ["run", preview.run],
-        ["event_id", preview.event_id],
-        ["from", preview.from],
-        ["from_display", preview.from_display],
-        ["to", preview.to],
-        ["type", preview.type],
-        ["summary", preview.summary],
-        ["body", preview.body_preview],
-        ["message_id", preview.message_id],
-        ["needs_response", preview.needs_response],
-        ["timestamp", preview.timestamp],
-        ["stripe", preview.stripe],
-    ];
-    const entries = rawEntries
-        .filter((entry) => entry[1] !== undefined)
-        .map(([key, value]) => [key, propertyValue(value)]);
-    const keyWidth = Math.max(1, ...entries.map(([key]) => displayWidth(key)));
-    const sequenceText = String(preview.sequence ?? options.sequence);
-    const sequencePadding = " ".repeat(Math.max(0, keyWidth - displayWidth(sequenceText)));
-    const headerSeparator = "  ";
-    const route = routeText(preview);
-    const visibleRoute = boundedLine(route, Math.max(0, contentWidth - keyWidth - headerSeparator.length));
-    const headerPlain = `${sequenceText}${sequencePadding}${headerSeparator}${visibleRoute}`;
-    const header = `${style(styles.muted, sequenceText)}${sequencePadding}${headerSeparator}${style(styles.target, visibleRoute)}`;
-    const headerPadding = Math.max(0, contentWidth - visibleWidth(headerPlain));
-    const lines = [`${prefix}${header}${" ".repeat(headerPadding)}${suffix}`, ""];
-    for (const [key, value] of entries) {
-        const keyPadding = " ".repeat(Math.max(0, keyWidth - displayWidth(key)));
-        const separator = "  ";
-        const valueWidth = Math.max(0, contentWidth - keyWidth - separator.length);
-        const visibleValue = boundedLine(value, valueWidth);
-        const plain = `${key}${keyPadding}${separator}${visibleValue}`;
-        const rendered = `${style(styles.muted, key)}${keyPadding}${separator}${style(styles.preview, visibleValue)}`;
-        const padding = Math.max(0, contentWidth - visibleWidth(plain));
-        lines.push(`${prefix}${rendered}${" ".repeat(padding)}${suffix}`);
-    }
-    return lines;
-}
-export function renderInspectorWidget(previews, width = 80, styles = {}, options = {}) {
-    if (previews.length === 0)
-        return undefined;
-    const safeWidth = Math.max(1, width);
-    void options;
-    const visible = previews.map((preview, index) => ({
-        preview: { ...preview, sequence: preview.sequence ?? index + 1 },
-        stripe: preview.stripe ?? index % 2 === 1,
-    }));
-    const sequenceWidth = Math.max(1, ...visible.map(({ preview }) => String(preview.sequence ?? 0).length));
-    const lines = [];
-    const separatorWidth = 2;
-    const sequencePrefixWidth = sequenceWidth + separatorWidth;
-    const fixedSeparatorsWidth = separatorWidth * 3;
-    const availableForColumns = Math.max(0, safeWidth - 1 - sequencePrefixWidth - fixedSeparatorsWidth);
-    const naturalRouteWidth = Math.max(...visible.map(({ preview }) => displayWidth(`${attentionMarker(preview)}${routeText(preview)}`)));
-    const naturalTypeWidth = Math.max(...visible.map(({ preview }) => displayWidth(preview.type)));
-    const routeWidth = Math.min(naturalRouteWidth, Math.max(4, Math.floor(availableForColumns * 0.35)));
-    const typeWidth = Math.min(naturalTypeWidth, Math.max(4, Math.floor(availableForColumns * 0.25)));
-    const messageWidth = Math.max(0, availableForColumns - routeWidth - typeWidth);
-    const summaryWidths = visible
-        .map(({ preview }) => preview.summary?.trim())
-        .filter((summary) => Boolean(summary))
-        .map((summary) => displayWidth(summary));
-    const summaryWidth = summaryWidths.length
-        ? Math.min(Math.max(...summaryWidths), Math.max(1, Math.floor(messageWidth * 0.5)))
-        : 0;
-    for (const { preview, stripe } of visible) {
-        lines.push(...renderInspectorEntry(preview, safeWidth, sequenceWidth, routeWidth, typeWidth, summaryWidth, styles, stripe));
-    }
-    return lines;
-}