@openscout/protocol 0.2.98 → 0.2.102

package/dist/scout-delivery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scout-delivery.d.ts","sourceRoot":"","sources":["../src/scout-delivery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scout-delivery.d.ts","sourceRoot":"","sources":["../src/scout-delivery.ts"],"names":[],"mappings":"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"}

package/dist/terminal-host-topology.d.ts

@@ -109,6 +109,20 @@ export type HerdrWorkspaceProjection = {
     agentStatus: HerdrAgentStatus;
     tabs: HerdrTabProjection[];
 };
+/**
+ * Why a projection is not live.
+ *
+ * `not_running` is the ordinary case: no herdr server answers for this session,
+ * so its persisted layout is the honest thing to show.
+ *
+ * `unreadable` is the case worth naming. A herdr server for this session IS
+ * running, but it did not answer the topology commands — a protocol skew
+ * between the installed client and a long-lived server is the common cause,
+ * and a busy server or a timeout look the same from here. Collapsing that into
+ * `not_running` would state, of live work, that it is not running. The
+ * projection says which it is so a reader never has to guess.
+ */
+export type HerdrTopologyUnavailableReason = "not_running" | "unreadable";
 export type HerdrSessionTopology = {
     /** Herdr session name, e.g. "openscout". */
     session: string;
@@ -123,6 +137,11 @@ export type HerdrSessionTopology = {
      * projection is live.
      */
     savedAt?: number | null;
+    /**
+     * Why this projection is not live. Set only when `running` is false; absent
+     * on a live read. See {@link HerdrTopologyUnavailableReason}.
+     */
+    unavailable?: HerdrTopologyUnavailableReason | null;
 };
-export declare function emptyHerdrSessionTopology(session: string, running: boolean): HerdrSessionTopology;
+export declare function emptyHerdrSessionTopology(session: string, running: boolean, unavailable?: HerdrTopologyUnavailableReason | null): HerdrSessionTopology;
 //# sourceMappingURL=terminal-host-topology.d.ts.map

package/dist/terminal-host-topology.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-host-topology.d.ts","sourceRoot":"","sources":["../src/terminal-host-topology.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"terminal-host-topology.d.ts","sourceRoot":"","sources":["../src/terminal-host-topology.ts"],"names":[],"mappings":"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"}

package/dist/terminal-host-topology.js

@@ -19,6 +19,12 @@
  * persisted state projects as `{ running: false, workspaces: [] }` — an
  * ordinary state, not an error.
  */
-export function emptyHerdrSessionTopology(session, running) {
-    return { session, running, workspaces: [], observedAt: Date.now() };
+export function emptyHerdrSessionTopology(session, running, unavailable) {
+    return {
+        session,
+        running,
+        workspaces: [],
+        observedAt: Date.now(),
+        ...(running ? {} : { unavailable: unavailable ?? "not_running" }),
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openscout/protocol",
-  "version": "0.2.98",
+  "version": "0.2.102",
   "description": "Typed protocol for the OpenScout local control plane",
   "license": "Apache-2.0",
   "type": "module",
@@ -57,5 +57,5 @@
   "devDependencies": {
     "typescript": "^5"
   },
-  "gitHead": "cc2fdb7c3b9205eccdb429e8c65fc48d72c5e1d6"
+  "gitHead": "c50900700bff66c1b1947d3413e54a7b1279d581"
 }

package/src/broker-routes.ts

@@ -12,9 +12,16 @@ export const scoutBrokerPaths = {
     capabilities: "/v1/capabilities",
     runtimeCatalog: "/v1/runtime-catalog",
     topologySnapshot: "/v1/topology/snapshot",
+    meshNodes: "/v1/mesh/nodes",
+    // Observe-tier compact node state. Read against a PEER broker's base URL
+    // through the signed/pinned mesh client; the local home feed is never
+    // widened for remote callers (mesh trust cone §4).
+    meshNodeState: "/v1/mesh/node-state",
     tailDiscover: "/v1/tail/discover",
     tailRecent: "/v1/tail/recent",
     repoWatchSnapshot: "/v1/repo-watch/snapshot",
+    machines: "/v1/machines",
+    machinesScan: "/v1/machines/scan",
     messages: "/v1/messages",
     brokerMessages: "/v1/broker/messages",
     eventsStream: "/v1/events/stream",
@@ -50,6 +57,11 @@ export function scoutBrokerMessagesPath(search: URLSearchParams): string {
     : scoutBrokerPaths.v1.brokerMessages;
 }
 
+/** Name a conversation. An empty title hands it back to automatic naming. */
+export function scoutBrokerConversationTitlePath(conversationId: string): string {
+  return `${scoutBrokerPaths.v1.conversations}/${encodeURIComponent(conversationId)}/title`;
+}
+
 export function scoutBrokerInvocationPath(invocationId: string): string {
   return `${scoutBrokerPaths.v1.invocations}/${encodeURIComponent(invocationId)}`;
 }
@@ -61,3 +73,7 @@ export function scoutBrokerInvocationStreamPath(invocationId: string): string {
 export function scoutBrokerInvocationLifecyclePath(invocationId: string): string {
   return `${scoutBrokerInvocationPath(invocationId)}/lifecycle`;
 }
+
+export function scoutBrokerMachinePath(machineRef: string): string {
+  return `${scoutBrokerPaths.v1.machines}/${encodeURIComponent(machineRef)}`;
+}

package/src/conversation-projection.ts

@@ -1,7 +1,7 @@
 import type { ConversationKind } from "./conversations.js";
 import type { ObservedActivity } from "./observed-status.js";
 
-export const CONVERSATION_PROJECTION_VERSION = 1;
+export const CONVERSATION_PROJECTION_VERSION = 2;
 
 export type ConversationProjectionEntityKind =
   | "scout_conversation"

package/src/herdr-workspace-digest.ts

@@ -0,0 +1,458 @@
+/**
+ * Herdr workspace digest — the presentation layer over {@link HerdrSessionTopology}.
+ *
+ * The raw projection is faithful but shapeless: a complex session is several
+ * workspaces × tabs × panes, and handing that whole tree to an operator (or to
+ * an assistant that has to answer for it) buries the one thing they came for.
+ * A digest ranks, groups, bounds, and describes it.
+ *
+ * Four commitments, in order of how much they matter:
+ *
+ * 1. **Attention leads.** A `blocked` pane is the only thing in a herdr session
+ *    that is actually waiting on a person. It comes first, always, before any
+ *    inventory. Everything else is context for it.
+ * 2. **Directory is the grouping axis, not the tab.** Operators think "which
+ *    repo", herdr thinks "which tab". Grouping is by the pane's literal working
+ *    directory — no repo-root inference, because a guessed grouping presented as
+ *    a fact is worse than an honest fragmented one.
+ * 3. **Shape is described, not dumped.** A tab's layout becomes one readable
+ *    phrase ("2×2 grid", "3 columns (2 · 1 · 1)") derived from the pane rects.
+ * 4. **Bounded and honest.** Panes are capped and truncation is declared;
+ *    `unknown` never collapses into `done`; a persisted projection is labeled
+ *    last-known rather than passed off as live.
+ *
+ * There are no mutation verbs here, for the same reason there are none in the
+ * topology projection: herdr owns workspaces, tabs and panes, and Scout's layer
+ * is coordination over whatever host is present. A digest pane carries the
+ * herdr `target` string so a caller can construct a handoff; performing it is
+ * the herdr client's job.
+ */
+
+import type {
+  HerdrAgentStatus,
+  HerdrPaneProjection,
+  HerdrSessionTopology,
+  HerdrTabLayout,
+  HerdrTopologyUnavailableReason,
+} from "./terminal-host-topology.js";
+
+/** Total emitted panes across every group before the digest declares truncation. */
+export const HERDR_DIGEST_PANE_CAP = 40;
+/** Ceiling on each of the two lead lists; attention is a shortlist, not an inventory. */
+export const HERDR_DIGEST_LEAD_CAP = 12;
+
+export type HerdrStatusCounts = Record<HerdrAgentStatus, number>;
+
+export type HerdrDigestPane = {
+  /**
+   * What `herdr agent <verb>` accepts as a target for this pane: the stable
+   * terminal id when herdr reported one, else the pane id. Null on a persisted
+   * projection, where neither is live — a pane you cannot address yet.
+   */
+  target: string | null;
+  paneId: string;
+  workspaceId: string;
+  tabId: string;
+  label: string | null;
+  /** Detected agent label ("claude", "codex"), or null for a plain shell. */
+  agent: string | null;
+  status: HerdrAgentStatus;
+  /** Working directory: the foreground process's when known, else the pane's. */
+  directory: string | null;
+  focused: boolean;
+  /**
+   * Scrollback backlog depth in lines. The cheapest activity signal a
+   * projection carries — a deep backlog on an idle pane is work that already
+   * happened, not work happening. Null when herdr did not report scroll state.
+   */
+  backlog: number | null;
+};
+
+export type HerdrDigestGroup = {
+  /** The panes' literal shared working directory; null when they report none. */
+  directory: string | null;
+  /** Last path segment — how an operator names the place. */
+  name: string;
+  counts: HerdrStatusCounts;
+  panes: HerdrDigestPane[];
+  /** Panes in this group dropped by the pane cap. */
+  omitted: number;
+  /**
+   * What was dropped, by status. A collapsed label has to carry its own scent:
+   * a reader decides whether the hidden rows matter from the label alone, so
+   * "2 idle not shown" is a usable label and "2 not shown" is not.
+   */
+  omittedCounts: HerdrStatusCounts;
+};
+
+export type HerdrDigestShape = {
+  workspaceId: string;
+  workspaceLabel: string;
+  tabId: string;
+  tabLabel: string;
+  paneCount: number;
+  /** One readable phrase for the arrangement, e.g. "2×2 grid". */
+  arrangement: string;
+  zoomed: boolean;
+  focused: boolean;
+};
+
+export type HerdrWorkspaceDigest = {
+  session: string;
+  /** True only for a projection read from a running herdr server. */
+  live: boolean;
+  observedAt: number;
+  /** Set when the projection is the persisted last-known state, not a live read. */
+  savedAt: number | null;
+  /**
+   * Why a non-live projection is not live. `unreadable` means a server for the
+   * session IS running and did not answer — the digest must not present that as
+   * a stopped session. Null on a live read.
+   */
+  unavailable: HerdrTopologyUnavailableReason | null;
+  totals: {
+    workspaces: number;
+    tabs: number;
+    panes: number;
+    /** Panes herdr recognized an agent in. The rest are plain shells. */
+    agents: number;
+  };
+  counts: HerdrStatusCounts;
+  /** Blocked panes — the only entries that represent something waiting on a person. */
+  needsYou: HerdrDigestPane[];
+  /** Panes herdr observed as working, bounded. */
+  working: HerdrDigestPane[];
+  groups: HerdrDigestGroup[];
+  shapes: HerdrDigestShape[];
+  truncated: boolean;
+  /** Caveats the reader must carry with the numbers. Never decorative. */
+  notes: string[];
+};
+
+const EMPTY_COUNTS: HerdrStatusCounts = { blocked: 0, working: 0, idle: 0, done: 0, unknown: 0 };
+
+/** Attention order. Blocked outranks working because it is the only state that waits on a person. */
+const STATUS_RANK: Record<HerdrAgentStatus, number> = {
+  blocked: 5,
+  working: 4,
+  idle: 3,
+  done: 2,
+  unknown: 1,
+};
+
+export function herdrStatusRank(status: HerdrAgentStatus): number {
+  return STATUS_RANK[status];
+}
+
+function emptyCounts(): HerdrStatusCounts {
+  return { ...EMPTY_COUNTS };
+}
+
+function totalCount(counts: HerdrStatusCounts): number {
+  return counts.blocked + counts.working + counts.idle + counts.done + counts.unknown;
+}
+
+function paneDirectory(pane: HerdrPaneProjection): string | null {
+  return pane.foregroundCwd ?? pane.cwd ?? null;
+}
+
+function directoryName(directory: string | null): string {
+  if (!directory) return "no directory";
+  const segments = directory.replace(/\/+$/, "").split("/").filter(Boolean);
+  return segments[segments.length - 1] ?? directory;
+}
+
+function toDigestPane(pane: HerdrPaneProjection): HerdrDigestPane {
+  return {
+    target: pane.terminalId ?? pane.paneId ?? null,
+    paneId: pane.paneId,
+    workspaceId: pane.workspaceId,
+    tabId: pane.tabId,
+    label: pane.label,
+    agent: pane.agent,
+    status: pane.agentStatus,
+    directory: paneDirectory(pane),
+    focused: pane.focused,
+    backlog: pane.scroll?.maxOffsetFromBottom ?? null,
+  };
+}
+
+/**
+ * Rank panes for a lead list: attention state, then the focused pane (where the
+ * operator's eyes already are), then the deepest backlog, then pane id so the
+ * order never wobbles between polls.
+ */
+function compareLeadPanes(left: HerdrDigestPane, right: HerdrDigestPane): number {
+  const byStatus = STATUS_RANK[right.status] - STATUS_RANK[left.status];
+  if (byStatus !== 0) return byStatus;
+  if (left.focused !== right.focused) return left.focused ? -1 : 1;
+  const byBacklog = (right.backlog ?? -1) - (left.backlog ?? -1);
+  if (byBacklog !== 0) return byBacklog;
+  return left.paneId.localeCompare(right.paneId, undefined, { numeric: true });
+}
+
+/**
+ * Describe a tab's arrangement from its pane rects.
+ *
+ * Panes sharing an x start a column; panes sharing a y start a row. A layout
+ * whose columns all hold the same number of panes is a grid and is named as
+ * one; anything else is named by its columns and their depths, which is both
+ * shorter and more truthful than inventing a name for an irregular split.
+ */
+export function describeHerdrArrangement(
+  layout: HerdrTabLayout | null,
+  paneCount: number,
+): string {
+  if (paneCount <= 0) return "no panes";
+  if (paneCount === 1) return "single pane";
+  const panes = layout?.panes ?? [];
+  if (panes.length !== paneCount) return `${paneCount} panes (layout unavailable)`;
+
+  const columns = new Map<number, number>();
+  const rows = new Map<number, number>();
+  for (const pane of panes) {
+    columns.set(pane.rect.x, (columns.get(pane.rect.x) ?? 0) + 1);
+    rows.set(pane.rect.y, (rows.get(pane.rect.y) ?? 0) + 1);
+  }
+  if (columns.size === 1) return `${paneCount} stacked rows`;
+  if (rows.size === 1) return `${paneCount} side-by-side columns`;
+
+  const depths = [...columns.entries()]
+    .sort((left, right) => left[0] - right[0])
+    .map(([, count]) => count);
+  const first = depths[0] ?? 0;
+  if (depths.every((depth) => depth === first) && first * columns.size === paneCount) {
+    return `${first}×${columns.size} grid`;
+  }
+  return `${columns.size} columns (${depths.join(" · ")})`;
+}
+
+/**
+ * Build the digest for one herdr session topology.
+ *
+ * Pure: the same topology always digests to the same value, so the whole
+ * presentation is testable without a herdr server.
+ */
+export function digestHerdrTopology(
+  topology: HerdrSessionTopology,
+  options: { paneCap?: number; leadCap?: number } = {},
+): HerdrWorkspaceDigest {
+  const paneCap = options.paneCap ?? HERDR_DIGEST_PANE_CAP;
+  const leadCap = options.leadCap ?? HERDR_DIGEST_LEAD_CAP;
+
+  const counts = emptyCounts();
+  const shapes: HerdrDigestShape[] = [];
+  const all: HerdrDigestPane[] = [];
+  let tabTotal = 0;
+  let agentTotal = 0;
+
+  for (const workspace of topology.workspaces) {
+    const workspaceLabel = workspace.label ?? (workspace.number != null ? `workspace ${workspace.number}` : workspace.workspaceId);
+    for (const tab of workspace.tabs) {
+      tabTotal += 1;
+      shapes.push({
+        workspaceId: workspace.workspaceId,
+        workspaceLabel,
+        tabId: tab.tabId,
+        tabLabel: tab.label ?? (tab.number != null ? `tab ${tab.number}` : tab.tabId),
+        paneCount: tab.panes.length,
+        arrangement: describeHerdrArrangement(tab.layout, tab.panes.length),
+        zoomed: tab.layout?.zoomed ?? false,
+        focused: workspace.focused && tab.focused,
+      });
+      for (const pane of tab.panes) {
+        const digestPane = toDigestPane(pane);
+        counts[digestPane.status] += 1;
+        if (digestPane.agent) agentTotal += 1;
+        all.push(digestPane);
+      }
+    }
+  }
+
+  // Groups are filled in rank order so the pane cap spends its budget on the
+  // panes that matter, not on whichever directory herdr happened to list first.
+  const ranked = [...all].sort(compareLeadPanes);
+  const kept = ranked.slice(0, paneCap);
+  const droppedByDirectory = new Map<string, HerdrStatusCounts>();
+  for (const pane of ranked.slice(paneCap)) {
+    const key = pane.directory ?? "";
+    let dropped = droppedByDirectory.get(key);
+    if (!dropped) {
+      dropped = emptyCounts();
+      droppedByDirectory.set(key, dropped);
+    }
+    dropped[pane.status] += 1;
+  }
+
+  const groupsByDirectory = new Map<string, HerdrDigestGroup>();
+  for (const pane of all) {
+    const key = pane.directory ?? "";
+    let group = groupsByDirectory.get(key);
+    if (!group) {
+      group = {
+        directory: pane.directory,
+        name: directoryName(pane.directory),
+        counts: emptyCounts(),
+        panes: [],
+        omitted: totalCount(droppedByDirectory.get(key) ?? EMPTY_COUNTS),
+        omittedCounts: { ...(droppedByDirectory.get(key) ?? EMPTY_COUNTS) },
+      };
+      groupsByDirectory.set(key, group);
+    }
+    group.counts[pane.status] += 1;
+  }
+  const keptIds = new Set(kept.map((pane) => `${pane.workspaceId}/${pane.paneId}`));
+  for (const pane of all) {
+    if (!keptIds.has(`${pane.workspaceId}/${pane.paneId}`)) continue;
+    groupsByDirectory.get(pane.directory ?? "")?.panes.push(pane);
+  }
+
+  const groups = [...groupsByDirectory.values()];
+  for (const group of groups) group.panes.sort(compareLeadPanes);
+  // Groups sort by what is waiting, then what is moving, then size — the same
+  // precedence the lead lists use, applied one level up.
+  groups.sort((left, right) =>
+    right.counts.blocked - left.counts.blocked
+    || right.counts.working - left.counts.working
+    || (right.panes.length + right.omitted) - (left.panes.length + left.omitted)
+    || left.name.localeCompare(right.name, undefined, { numeric: true }));
+
+  const notes: string[] = [];
+  if (!topology.running) {
+    // "Last known" is only useful with a when: a layout saved an hour ago and
+    // one saved in March are the same claim with very different weight.
+    const saved = topology.savedAt ? ` Last saved ${new Date(topology.savedAt).toISOString()}.` : "";
+    notes.push(topology.unavailable === "unreadable"
+      // The session IS running; herdr just would not answer. Saying "stopped"
+      // here would be the one thing a digest must never do — state, of live
+      // work, that it is not live.
+      ? `A herdr server for this session is running but did not answer, so this is the persisted last-known layout, not what is on screen. The usual cause is a protocol skew between the installed herdr client and a long-lived server; restarting that session's server (which exits its pane processes) is what clears it.${saved}`
+      : `Not live: this is the persisted last-known layout. Agent status, terminal ids and geometry are absent from it — no pane here is claimed to be running.${saved}`);
+  }
+  if (counts.unknown > 0) {
+    notes.push(
+      `${counts.unknown} ${counts.unknown === 1 ? "pane reports" : "panes report"} unknown: herdr sees an agent it cannot classify. Unknown is the absence of a signal, not completion.`,
+    );
+  }
+
+  return {
+    session: topology.session,
+    live: topology.running,
+    observedAt: topology.observedAt,
+    savedAt: topology.savedAt ?? null,
+    unavailable: topology.running ? null : topology.unavailable ?? "not_running",
+    totals: {
+      workspaces: topology.workspaces.length,
+      tabs: tabTotal,
+      panes: all.length,
+      agents: agentTotal,
+    },
+    counts,
+    needsYou: ranked.filter((pane) => pane.status === "blocked").slice(0, leadCap),
+    working: ranked.filter((pane) => pane.status === "working").slice(0, leadCap),
+    groups,
+    shapes,
+    truncated: all.length > paneCap,
+    notes,
+  };
+}
+
+/**
+ * One row, led by whatever is most specific to this pane.
+ *
+ * Rows that all begin `term-w1:p1`, `term-w1:p2` share a long prefix, and a
+ * scanning reader learns to skip the opening of every line — so the identity
+ * column becomes the one column nobody reads. The lead is therefore the pane's
+ * label when it has one, and its pane id when it does not, since a short id
+ * differs within the first couple of characters where a terminal id does not.
+ *
+ * The pane id is enough to act on: `herdr agent <verb>` accepts the pane
+ * currently hosting an agent as a target. The directory is the basename only —
+ * the full path is carried once, in the grouped section, and repeating it on
+ * every row buys nothing.
+ */
+function paneLine(pane: HerdrDigestPane): string {
+  const parts = pane.label
+    ? [pane.label, pane.agent ?? "shell", pane.paneId]
+    : [pane.paneId, pane.agent ?? "shell"];
+  if (pane.directory) parts.push(directoryName(pane.directory));
+  if (pane.focused) parts.push("focused");
+  return `  ${parts.join("  ")}`;
+}
+
+/** "2 idle not shown" — a collapsed label a reader can decide from. */
+function omittedLabel(counts: HerdrStatusCounts): string | null {
+  const total = totalCount(counts);
+  if (total === 0) return null;
+  const order: HerdrAgentStatus[] = ["blocked", "working", "idle", "done", "unknown"];
+  const present = order.filter((status) => counts[status] > 0);
+  if (present.length === 1) return `+${total} ${present[0]} not shown`;
+  return `+${total} not shown (${present.map((status) => `${counts[status]} ${status}`).join(" · ")})`;
+}
+
+function countsLine(counts: HerdrStatusCounts): string {
+  const order: HerdrAgentStatus[] = ["blocked", "working", "idle", "done", "unknown"];
+  const parts = order.filter((status) => counts[status] > 0).map((status) => `${counts[status]} ${status}`);
+  return parts.length ? parts.join(" · ") : "no panes";
+}
+
+/**
+ * Render a digest as the text an operator should actually read.
+ *
+ * Ordering is the whole design: what is waiting, then what is moving, then
+ * where things live, then how the screen is arranged. A reader who stops after
+ * the first section has still got the answer that mattered.
+ *
+ * Section heads are verb phrases rather than bare nouns, and there is no
+ * trailing caveat block: a qualifier that changes how a count should be read
+ * sits directly under that count, because a scanning reader reaches the top of
+ * the output and not the bottom of it.
+ */
+export function renderHerdrWorkspaceDigest(digest: HerdrWorkspaceDigest): string {
+  const lines: string[] = [];
+  const state = digest.live
+    ? "live"
+    : digest.unavailable === "unreadable" ? "running, not readable" : "not running";
+  const { workspaces, tabs, panes } = digest.totals;
+  lines.push(
+    `herdr · ${digest.session} — ${state} · ${workspaces} workspace${workspaces === 1 ? "" : "s"}, ${tabs} tab${tabs === 1 ? "" : "s"}, ${panes} pane${panes === 1 ? "" : "s"} (${countsLine(digest.counts)})`,
+  );
+  // Caveats sit under the counts they qualify, not in a block at the bottom.
+  // A qualifier that changes how a number should be read is body text; a
+  // scanning reader never reaches a footnote, and these are the lines that stop
+  // someone believing `unknown` meant done or that a stale layout was current.
+  for (const note of digest.notes) lines.push(`  ${note}`);
+
+  if (digest.needsYou.length) {
+    lines.push("", "Waiting on you");
+    for (const pane of digest.needsYou) lines.push(paneLine(pane));
+  }
+  if (digest.working.length) {
+    lines.push("", "Working now");
+    for (const pane of digest.working) lines.push(paneLine(pane));
+  }
+
+  if (digest.groups.length) {
+    lines.push("", "Grouped by directory");
+    for (const group of digest.groups) {
+      const total = totalCount(group.counts);
+      const where = group.directory ? ` (${group.directory})` : "";
+      const hidden = omittedLabel(group.omittedCounts);
+      lines.push(`  ${group.name}${where} — ${total} pane${total === 1 ? "" : "s"} · ${countsLine(group.counts)}${hidden ? ` · ${hidden}` : ""}`);
+    }
+  }
+
+  if (digest.shapes.length) {
+    lines.push("", "Arranged like this");
+    for (const shape of digest.shapes) {
+      const marks = [shape.arrangement];
+      if (shape.zoomed) marks.push("zoomed");
+      if (shape.focused) marks.push("focused");
+      // The tab id leads because two workspaces can carry the same label, and
+      // a label can itself contain the separator — the id cannot do either.
+      lines.push(`  ${shape.tabId}  ${shape.workspaceLabel} / ${shape.tabLabel} — ${marks.join(" · ")}`);
+    }
+  }
+
+  return lines.join("\n");
+}

package/src/index.ts

@@ -7,6 +7,7 @@ export * from "./a2a.js";
 export * from "./scout-agent-card.js";
 export * from "./relay-agent-card.js";
 export * from "./mesh.js";
+export * from "./machines.js";
 export * from "./conversations.js";
 export * from "./conversation-projection.js";
 export * from "./channel-identity.js";
@@ -53,5 +54,6 @@ export * from "./terminal-surface-id.js";
 export * from "./terminal-sessions.js";
 export * from "./terminal-workspaces.js";
 export * from "./terminal-host-topology.js";
+export * from "./herdr-workspace-digest.js";
 export * from "./broker-routes.js";
 export * from "./rendezvous.js";