@llblab/pi-actors 0.22.4 → 0.23.0

package/AGENTS.md

@@ -64,6 +64,7 @@
 - `npm run check`: Lightweight extension-load sanity check
 - `npm test`: Focused regression tests for extracted pure domains
 - `npm run pack:dry`: Verify package contents and npm metadata
+- `npm run conformance`: Compact protocol conformance runner for actor/recipe behavior
 - `bash ~/.pi/agent/skills/abcd-context/scripts/validate-context.sh`: Validate context split, links, and README/docs reachability
 
 ## Pre-Task Preparation

package/BACKLOG.md

@@ -84,20 +84,6 @@ No open hotfix items.
   - `inspect` can show id, correlation, and causation.
   - No migration is forced.
 
-### M-03 Mailbox Contract v1
-
-- Priority: Medium.
-- Goal: Extend `mailbox.accepts` and `mailbox.emits` from string arrays to backward-compatible typed contracts.
-- Direction:
-  - Keep string declarations valid.
-  - Normalize typed entries for inspection.
-  - Support fields such as body schema, ack requirement, idempotency, response requirement, level, and summary.
-- Acceptance:
-  - String declarations still work.
-  - `inspect view=mailbox` shows normalized contracts.
-  - Messages outside accepts produce advisory warnings by default, not hard blocks.
-  - Docs clarify advisory versus strict mode.
-
 ### M-04 Actor Loop Helper SDK
 
 - Priority: Medium.
@@ -119,143 +105,6 @@ No open hotfix items.
   - Concurrent wake and poll paths do not double-process messages.
   - Helper supports run inbox and branch inbox.
 
-### M-05 Branch Delivery Unification
-
-- Priority: Medium.
-- Goal: Route direct branch messages and room multicast branch copies through one internal helper.
-- Target helper:
-  - `routeBranchEnvelope(stateDir, runId, message, { source })`.
-- Acceptance:
-  - Direct branch messages and room multicast produce the same durable branch inbox shape.
-  - Parent run dispatch envelope is consistent.
-  - Tests cover both paths.
-
-### M-06 Attention Semantics v1
-
-- Priority: Medium.
-- Goal: Formalize coordinator attention behavior through semantic metadata rather than transport knobs.
-- Direction:
-  - Support attention metadata such as `requires_response=true` and reason.
-  - Map response-required messages to follow-up.
-  - Keep progress/info messages inspectable or notify-only.
-  - Preserve existing internal `delivery` behavior.
-- Acceptance:
-  - `requires_response=true` becomes coordinator follow-up.
-  - Progress info stays log or notification.
-  - Explicit stop and kill controls do not create duplicate terminal follow-up.
-
-### M-07 Recipe Doctor
-
-- Priority: Medium.
-- Goal: Add intentional recipe health inspection.
-- Surface:
-  - `inspect target=recipes view=doctor`.
-  - `inspect target=recipes view=doctor verbose=true`.
-- Checks:
-  - Import graph health.
-  - Shadowing and blockers.
-  - Invalid or disabled recipes.
-  - Risky command templates.
-  - Absolute path portability.
-  - OS compatibility.
-  - Root permissions.
-  - Mailbox completeness.
-  - Artifact placeholder resolution.
-  - Stale or unused usage.
-- Acceptance:
-  - Compact output is grouped by severity.
-  - Verbose output is structured.
-  - No automatic cleanup happens.
-  - Every diagnostic has reason and suggested actions.
-
-### M-08 Artifact Manifest v1
-
-- Priority: Medium.
-- Goal: Extend recipe artifacts from string paths to backward-compatible artifact metadata.
-- Direction:
-  - Keep string artifact paths valid.
-  - Add optional object fields such as path, kind, media type, and required.
-  - Resolve manifests with existence, size, and optional hash.
-- Acceptance:
-  - String artifacts remain valid.
-  - Runtime resolves manifest with `exists`, `size`, and optional `sha256`.
-  - Terminal follow-ups group named artifacts.
-  - Missing required artifacts are visible in result and inspect output.
-
-### M-09 Lifecycle Retention Policy
-
-- Priority: Medium.
-- Goal: Add explicit archive and prune behavior for terminal run state.
-- Messages:
-  - `control.archive`.
-  - `control.prune`.
-- Direction:
-  - Only terminal runs can be archived or pruned.
-  - Active runs fail closed.
-  - Archive moves or compresses state with a tombstone.
-  - Prune deletes terminal state after ownership checks, optionally preserving artifacts.
-- Acceptance:
-  - Terminal cleanup candidates are inspectable.
-  - Artifacts can be preserved.
-  - Active run deletion is impossible.
-
-### M-10 Inspector v2 For Unread Mentions And Needs Response
-
-- Priority: Medium.
-- Goal: Strengthen the TUI inspector as the operator membrane for multi-actor sessions.
-- Direction:
-  - Add stable event ids in previews.
-  - Add unread cursor per session, run, and room.
-  - Preserve mention filtering.
-  - Add needs-response marker from attention semantics.
-  - Distinguish room timeline rows from branch inbox rows.
-- Acceptance:
-  - `/actors-inspector-filter unread` works.
-  - `/actors-inspector-filter mention <text>` works.
-  - `/actors-inspect <number>` marks the item read for the current session.
-  - Unread state stays UI/session metadata, not protocol truth.
-
-### M-11 Run State Index
-
-- Priority: Medium.
-- Goal: Add a rebuildable run-state index to reduce recursive scans and improve observability performance.
-- Target file:
-  - `~/.pi/agent/tmp/pi-actors/runs/index.json`.
-- Contents:
-  - State dir.
-  - Run id.
-  - Owner id.
-  - Status.
-  - Updated time.
-  - Recipe or tool.
-- Acceptance:
-  - Index accelerates list and summarize.
-  - Corruption falls back to scan.
-  - Rebuild helper exists.
-  - Nested runs are represented without id collision.
-
-### M-12 Internal Conformance Runner
-
-- Priority: Medium.
-- Goal: Add a CI-ready internal conformance runner for pi-actors protocol behavior.
-- Script:
-  - `npm run conformance`.
-- Suites:
-  - Recipe discovery.
-  - Register, update, and delete.
-  - Spawn lifecycle.
-  - Message routing.
-  - Room roster.
-  - Branch inbox.
-  - Ownership checks.
-  - Artifacts.
-  - Attention semantics.
-- Acceptance:
-  - Runs without Pi UI where possible.
-  - Outputs compact report.
-  - Fixtures live in the repository.
-  - CI can run it.
-
 ### M-13 Packaged Actor Worker Recipe Template
 
 - Priority: Medium.
@@ -270,50 +119,6 @@ No open hotfix items.
   - Recipe demonstrates correct mailbox loop semantics.
   - It is a recipe-authoring example, not a product feature.
 
-### M-14 Recipe Usage Integrity Improvements
-
-- Priority: Medium.
-- Goal: Make recipe usage tracking more explainable.
-- Direction:
-  - Add fingerprint diff reason.
-  - Add reset reason.
-  - Consider optional last error.
-  - Split launch counts by tool, spawn, and direct recipe.
-- Acceptance:
-  - `inspect recipes view=summary verbose=true` shows whether usage refers to current recipe content.
-  - Doctor can flag unused current meaning instead of stale old recipe history.
-
-### M-15 Safer Command Warning Policy
-
-- Priority: Medium.
-- Goal: Unify command-template diagnostics by severity and make warnings actionable without startup spam.
-- Severity:
-  - `info`: portability.
-  - `warning`: broad mutation, shell, or eval.
-  - `error`: impossible, invalid, or unsafe repeat.
-- Direction:
-  - Treat legitimate `bash` wrappers as expected trusted boundaries when already packaged or explicitly registered.
-  - Keep routine shell wrapper notes out of startup warning blocks.
-  - Surface shell/eval/destructive diagnostics through register-time warnings, doctor, and verbose recipe inspection.
-- Acceptance:
-  - Command-template warnings include command label, reason, and suggested mitigation.
-  - `register_tool` shows relevant warnings.
-  - Recipe doctor aggregates warning policy.
-  - Startup no longer emits large warning blocks only because recipes wrap `bash`.
-
-### M-16 Output And Log Size Governance
-
-- Priority: Medium.
-- Goal: Keep stdout, stderr, result, outbox, and actor-message previews bounded in agent context.
-- Direction:
-  - Centralize constants for body preview, outbox preview, inspector preview, and tail lines.
-  - Keep verbose output opt-in.
-  - Prefer files or artifacts for large bodies.
-- Acceptance:
-  - Actor messages and previews share consistent caps.
-  - Verbose mode is explicit.
-  - Large bodies do not flood normal tool output.
-
 ### M-17 Windows And Nix Portability Pass
 
 - Priority: Medium.
@@ -341,18 +146,6 @@ No open hotfix items.
   - Corrupt paths are reported clearly.
   - Canonical state is not silently rewritten without explicit action.
 
-### M-19 Recipe Import Graph Inspector
-
-- Priority: Medium.
-- Goal: Add focused inspection for recipe import graphs.
-- Surface:
-  - `inspect target=recipes view=imports`.
-  - `inspect target=recipes view=imports verbose=true`.
-- Acceptance:
-  - Shows import graph, aliases, resolved paths, and shadowed imports.
-  - Shows cyclic and depth diagnostics.
-  - Helps debug packaged and user recipe composition.
-
 ### M-20 Spawn Preflight Mode
 
 - Priority: Medium.
@@ -393,19 +186,6 @@ No open hotfix items.
   - Examples cover branch, room, run, session, and tool addresses.
   - No new public address kinds are added.
 
-### M-23 Room Compaction Metadata Improvements
-
-- Priority: Medium.
-- Goal: Record richer room compaction metadata.
-- Direction:
-  - Track dropped count.
-  - Track first and last kept timestamps.
-  - Track configured max.
-- Acceptance:
-  - `inspect room:<run> view=status verbose=true` shows compaction info.
-  - Compaction never corrupts JSONL.
-  - Tests cover low `PI_ACTORS_ROOM_MAX_MESSAGES`.
-
 ### M-24 Coordinator Follow-Up Deduplication
 
 - Priority: Medium.

package/CHANGELOG.md

@@ -1,6 +1,28 @@
 # Changelog
 
-## Unreleased
+## 0.23.0: Actor Manifests, Inspection, and Runtime Hygiene
+
+- `[Tools]` Unified branch-envelope routing for direct branch messages and selected-recipient room multicast so both paths persist the same branch-local inbox shape before dispatching through the parent run mailbox.
+- `[Async Runs]` Added attention semantics for coordinator-bound actor messages: `metadata.requires_response=true` now produces a follow-up while ordinary coordinator progress messages default to notification-level delivery.
+- `[Registry]` Added `inspect target=recipes view=doctor` as an intentional recipe health surface with compact severity/action counts and structured verbose diagnostics.
+- `[Async Runs]` Added artifact manifest resolution for string and object artifact declarations, including `exists`, `size`, `sha256`, and missing required artifact visibility in artifact inspection.
+- `[Async Runs]` Added explicit terminal run retention controls via `control.archive` and `control.prune`, with active-run fail-closed behavior and optional artifact preservation during prune.
+- `[Inspector]` Added stable event ids, needs-response markers, and session-local read markers to actor inspector previews and selected-item details.
+- `[Registry]` Suppressed routine trusted `bash` wrapper diagnostics from startup warning notifications while keeping them available through recipe diagnostics surfaces.
+- `[Async Runs]` Added a rebuildable run-state index for run listing and observability discovery, with corrupt-index fallback to recursive scan and nested-run-safe state directory entries.
+- `[Testing]` Added `npm run conformance` for a compact CI-ready protocol conformance runner covering recipes, registry, spawn lifecycle, messaging, rooms, branch inboxes, ownership, artifacts, and attention semantics.
+- `[Mailbox]` Added backward-compatible typed mailbox contracts with normalized inspection and advisory warnings for undeclared run message types.
+- `[Output]` Centralized inspect, preview, and tool-output size limits so bounded output governance is shared across tools, room previews, and the actor inspector.
+- `[Registry]` Added explicit mitigation guidance to command-template trust-boundary warnings for shells, eval modes, and broad filesystem mutation.
+- `[Scripts]` Added top-of-file descriptions to packaged helper scripts so their purpose, boundaries, and policy ownership are clear when opened directly.
+- `[Rooms]` Added room compaction metadata with dropped count, configured maximum, and first/last kept timestamps exposed through room status inspection.
+- `[Recipes]` Improved usage telemetry with launch-kind counters (`tool`, `spawn`, `direct`) and explicit reset reasons when recipe content fingerprints change.
+- `[Inspect]` Added `inspect target=recipes view=imports` to summarize recipe import aliases and source references for debugging recipe composition.
+
+## 0.22.5: CI Stability Hotfix
+
+- `[Tests]` Stabilized the Windows named-pipe control endpoint regression by keeping its synthetic run alive longer under slower full-suite CI scheduling.
+- `[Tests]` Stabilized the coordinator-locker queue/lock smoke by waiting for assignment, renewal, and denial actor messages before stopping the helper, removing a FIFO processing race from main-branch validation.
 
 ## 0.22.4: Actor Isolation and Registry Diagnostics Hotfix
 

package/README.md

@@ -161,7 +161,7 @@ The terminal actor inspector is hidden by default. When opened without an explic
 /actors-inspect 3
 ```
 
-The table is compact and optimistic by default: bounded route/type/summary/body previews, capped noisy room rows, branch-local inbox previews, and an inline roster summary in the form `name/role` that wraps only when needed. Active roster members use the target color; members that sent `actor.leave` remain visible as inactive/muted participants from the current run. Use `unread` to focus queued branch inbox work and `branch <name>` / `current-branch <name>` to focus one branch's room/direct/inbox traffic. `/actors-inspect <number>` opens the selected row as a full-message view; toggle again to return to the table or close it. Actor display names come from room `actor.join` roster metadata or branch addresses, keeping debugger output plain and name-driven.
+The table is compact and optimistic by default: bounded route/type/summary/body previews, capped noisy room rows, branch-local inbox previews, stable event ids in selected-message details, and an inline roster summary in the form `name/role` that wraps only when needed. Active roster members use the target color; members that sent `actor.leave` remain visible as inactive/muted participants from the current run. Use `unread` to focus queued branch inbox work and `branch <name>` / `current-branch <name>` to focus one branch's room/direct/inbox traffic. Rows with `metadata.requires_response=true` show a `!` attention marker. `/actors-inspect <number>` opens the selected row as a full-message view and marks it read for the current session filter; toggle again to return to the table or close it. Actor display names come from room `actor.join` roster metadata or branch addresses, keeping debugger output plain and name-driven.
 
 ## Registry Model
 

package/dist/index.js

@@ -49,6 +49,7 @@ export default function toolRegistryExtension(pi) {
     let actorInspectorUnreadOnly = false;
     let actorInspectorRoomLimitPerRun = 12;
     let selectedInspectorSequence;
+    const actorInspectorReadKeys = new Set();
     let recipeWatcherFailureNotified = false;
     const getRunOwnerId = (ctx) => ctx.sessionManager.getSessionId();
     const retireCandidateRuns = (ctx, summary) => {
@@ -84,6 +85,7 @@ export default function toolRegistryExtension(pi) {
                             branch: actorInspectorBranch,
                             mention: actorInspectorMention,
                             ownerId,
+                            readKeys: actorInspectorReadKeys,
                             roomLimitPerRun: actorInspectorRoomLimitPerRun,
                             unreadOnly: actorInspectorUnreadOnly,
                         });
@@ -356,6 +358,19 @@ export default function toolRegistryExtension(pi) {
                 ctx.ui.notify("Usage: /actors-inspect <number>", "warning");
                 return;
             }
+            const previews = ActorInspectorTui.readActorInspectorPreviews(RUN_STATE_ROOT, actorInspectorRows, {
+                channels: actorInspectorChannels,
+                currentRunOnly: true,
+                branch: actorInspectorBranch,
+                mention: actorInspectorMention,
+                ownerId: getRunOwnerId(ctx),
+                readKeys: actorInspectorReadKeys,
+                roomLimitPerRun: actorInspectorRoomLimitPerRun,
+                unreadOnly: actorInspectorUnreadOnly,
+            });
+            const preview = previews.find((item) => item.sequence === sequence);
+            if (preview)
+                actorInspectorReadKeys.add(ActorInspectorTui.inspectorPreviewReadKey(preview));
             selectedInspectorSequence = sequence;
             communicationWidgetVisible = true;
             updateRunUi(ctx);

package/dist/lib/actor-inspector-tui.d.ts

@@ -6,10 +6,12 @@ export interface ActorInspectorPreview {
     body_preview?: string;
     branch?: string;
     channel: "broadcast" | "direct" | "room";
+    event_id?: string;
     from?: string;
     from_display?: string;
     inbox_status?: string;
     message_id?: string;
+    needs_response?: boolean;
     run: string;
     sequence?: number;
     summary?: string;
@@ -44,9 +46,11 @@ export interface ActorInspectorPreviewReadOptions {
     currentRunOnly?: boolean;
     channels?: ActorInspectorPreview["channel"][];
     mention?: string;
+    readKeys?: Iterable<string>;
     roomLimitPerRun?: number;
     unreadOnly?: boolean;
 }
+export declare function inspectorPreviewReadKey(preview: ActorInspectorPreview): string;
 export declare function readActorInspectorPreviews(stateRoot?: string, limit?: number, options?: ActorInspectorPreviewReadOptions): ActorInspectorPreview[];
 export declare function readActorInspectorRoster(stateRoot: string | undefined, run: string, room?: string): ActorInspectorRosterMember[];
 export declare function renderInspectorRosterLine(members: ActorInspectorRosterMember[], width?: number, styles?: ActorInspectorWidgetStyle): string | undefined;

package/dist/lib/actor-inspector-tui.js

@@ -5,6 +5,7 @@
 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";
 function asRecord(value) {
     return value && typeof value === "object" && !Array.isArray(value)
@@ -32,7 +33,7 @@ function readJsonLines(file) {
         return [];
     }
 }
-function previewValue(value, maxLength = 320) {
+function previewValue(value, maxLength = Limits.INSPECTOR_BODY_PREVIEW_CHARS) {
     if (value === undefined)
         return undefined;
     const text = typeof value === "string" ? value : JSON.stringify(value);
@@ -58,6 +59,10 @@ function previewFromMessage(run, message, timestamp, displayNames = {}) {
     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()
@@ -68,8 +73,10 @@ function previewFromMessage(run, message, timestamp, displayNames = {}) {
             ? { 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,
@@ -129,14 +136,21 @@ function readBranchInboxPreviews(run, stateDir) {
             .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 ?? ""));
+            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 } : {}),
+                ...(typeof message.id === "string"
+                    ? { message_id: message.id }
+                    : {}),
+                ...(typeof message.status === "string"
+                    ? { inbox_status: message.status }
+                    : {}),
             };
         })
             .filter((preview) => Boolean(preview)));
@@ -167,8 +181,22 @@ function getRunOwnerId(stateDir) {
 function matchesOwner(stateDir, ownerId) {
     return ownerId === undefined || getRunOwnerId(stateDir) === ownerId;
 }
-function isUnreadPreview(preview) {
-    return preview.inbox_status === "queued" || preview.inbox_status === undefined && preview.branch !== undefined;
+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();
@@ -183,7 +211,8 @@ function matchesPreviewFilter(preview, options) {
     if (options.channels?.length && !options.channels.includes(preview.channel)) {
         return false;
     }
-    if (options.unreadOnly && !isUnreadPreview(preview))
+    const readKeys = options.readKeys ? new Set(options.readKeys) : undefined;
+    if (options.unreadOnly && !isUnreadPreview(preview, readKeys))
         return false;
     if (!matchesBranchFilter(preview, options.branch))
         return false;
@@ -298,6 +327,9 @@ function routeText(preview) {
         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;
 }
@@ -351,7 +383,7 @@ function renderCompactInspectorEntry(preview, width, sequenceWidth, routeWidth,
     const contentWidth = Math.max(8, width - prefix.length - suffix.length);
     const sequence = String(preview.sequence ?? 0).padStart(sequenceWidth, " ");
     const sequencePrefix = `${sequence}${separator}`;
-    const route = routeText(preview);
+    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);
@@ -382,7 +414,7 @@ function renderInspectorEntry(preview, width, sequenceWidth, routeWidth, typeWid
     const contentWidth = Math.max(8, width - prefix.length - suffix.length);
     const sequence = String(preview.sequence ?? 0).padStart(sequenceWidth, " ");
     const sequencePrefix = `${sequence}${separator}`;
-    const route = routeText(preview);
+    const route = `${attentionMarker(preview)}${routeText(preview)}`;
     const type = preview.type;
     const summary = preview.summary?.trim() ?? "";
     const body = preview.body_preview?.trim() || (!summary ? previewText(preview) : "-");
@@ -430,7 +462,10 @@ export function readActorInspectorRoster(stateRoot = Paths.getRunStateRoot(), ru
 }
 function rosterRoleText(role) {
     const roleLabel = role?.split(";")[0] ?? "";
-    const cleaned = roleLabel.replaceAll(/\s*\([^)]*\)\s*$/g, "").trim().toLowerCase();
+    const cleaned = roleLabel
+        .replaceAll(/\s*\([^)]*\)\s*$/g, "")
+        .trim()
+        .toLowerCase();
     if (!cleaned || cleaned === "actor")
         return undefined;
     return cleaned.replaceAll(/\s+/g, "-");
@@ -444,7 +479,10 @@ function rosterMemberText(member) {
 }
 function isRosterMemberActive(member) {
     const status = member.status?.trim().toLowerCase();
-    return !status || status === "present" || status === "active" || status === "running";
+    return (!status ||
+        status === "present" ||
+        status === "active" ||
+        status === "running");
 }
 export function renderInspectorRosterLine(members, width = 80, styles = {}) {
     return renderInspectorRosterPanel(members, width, styles)?.[0];
@@ -491,12 +529,15 @@ export function renderInspectorItemView(previews, width = 80, styles = {}, optio
     const orderedKeys = [
         "channel",
         "run",
+        "event_id",
         "from",
         "from_display",
         "to",
         "type",
         "summary",
         "body_preview",
+        "message_id",
+        "needs_response",
         "timestamp",
         "stripe",
     ];
@@ -540,7 +581,7 @@ export function renderInspectorWidget(previews, width = 80, styles = {}, options
     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(routeText(preview))));
+    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)));

package/dist/lib/actor-rooms.d.ts

@@ -32,10 +32,18 @@ export interface RoomMessagePreview {
     to: string;
     type: string;
 }
+export interface RoomCompactionInfo {
+    compacted_at: string;
+    dropped_count: number;
+    first_kept_at?: string;
+    last_kept_at?: string;
+    max_messages: number;
+}
 export interface RoomStatus {
     room: string;
     message_count: number;
     roster_count: number;
+    compaction?: RoomCompactionInfo;
     last_message_at?: string;
     last_message_from?: string;
     last_message_summary?: string;