@haywoodmarx/agent-pager 0.1.2 → 0.1.3

package/README.md

@@ -62,7 +62,7 @@ Pager does not change a harness's permission settings. A session that has to wai
 
 ## Service operations
 
-The broker starts on demand: `pager` with no command, and every harness connecting over MCP, adopts the running broker or starts one. `pager status` reports whether the broker is running, its pid, its MCP endpoint, and the database it serves. `pager exit` stops it, and `pager restart` stops it and starts a fresh one. `pager serve` runs the broker in the foreground.
+The broker starts on demand: `pager` with no command, and every harness connecting over MCP, adopts the running broker or starts one. `pager status` reports whether the broker is running, its pid, its MCP endpoint, the database it serves, the installed pager version, and the version of the running broker. `pager exit` stops it, and `pager restart` stops it and starts a fresh one. `pager serve` runs the broker in the foreground.
 
 Callers adopt a running service only when its database-adjacent lock and `/health` agree on the service identity; concurrent starters race for that lock and every caller adopts the winner. The adoption rules are declared in [`src/launch/on-demand.ts`](src/launch/on-demand.ts) and [`src/launch/broker-lock.ts`](src/launch/broker-lock.ts).
 

package/dist/src/launch/broker-lock.d.ts

@@ -83,6 +83,12 @@ export declare function brokerLockPath(databasePath: string): string;
  * @returns - Valid parsed lock data when the file is well-formed.
  */
 export declare function readBrokerLock(lockPath: string): BrokerLock | undefined;
+/**
+ * Name the package version of the build that wrote a lock record.
+ * @param lock - Lock record, possibly written by a foreign build.
+ * @returns - The version after the build id's last `@`, or the whole build id when it names no version.
+ */
+export declare function brokerLockVersion(lock: Pick<BrokerLock, "buildId">): string;
 /** Bounds how many times acquisition re-attempts after losing a lock-file race. */
 export declare const BROKER_LOCK_ACQUISITION_ATTEMPTS = 5;
 /** Reports the start time of a process, or that this platform cannot supply one. */

package/dist/src/launch/broker-lock.js

@@ -117,6 +117,15 @@ export function readBrokerLock(lockPath) {
         return undefined;
     }
 }
+/**
+ * Name the package version of the build that wrote a lock record.
+ * @param lock - Lock record, possibly written by a foreign build.
+ * @returns - The version after the build id's last `@`, or the whole build id when it names no version.
+ */
+export function brokerLockVersion(lock) {
+    const separator = lock.buildId.lastIndexOf("@");
+    return separator > 0 ? lock.buildId.slice(separator + 1) : lock.buildId;
+}
 /**
  * Structural gate, not a currency check: `serviceProtocolVersion`, `runtime`, and `protocolVersion`
  * must equal the current build's because a mismatch there means the rest of the shape cannot be

package/dist/src/launch/cli.js

@@ -10,8 +10,9 @@ import { packagedSkills } from "./skill.js";
 import { createOperatorTuiClient, fileBackedTuiLayout, DEFAULT_OPERATOR_TUI_THEME, startOperatorTui, } from "../tui/production.js";
 import { assertSupportedBunRuntime } from "./runtime.js";
 import { BrokerService } from "./service.js";
+import { PAGER_VERSION } from "../version.js";
 import { systemBrokerServiceFilesystem, systemBrokerServiceScheduler } from "./service-system.js";
-import { BrokerLockGuard, brokerLockPath, brokerLockHasCurrentIdentity, brokerLockIsLive, processIsAlive, readBrokerLock, readBrokerOwnerPid, } from "./broker-lock.js";
+import { BrokerLockGuard, brokerLockPath, brokerLockHasCurrentIdentity, brokerLockIsLive, brokerLockVersion, processIsAlive, readBrokerLock, readBrokerOwnerPid, } from "./broker-lock.js";
 /**
  * Run the operational CLI.
  *
@@ -55,6 +56,8 @@ export async function main(argv = process.argv.slice(2)) {
                     state: running ? "running" : starting ? "starting" : ownerAlive ? "incompatible" : "stopped",
                     ...(ownerAlive ? { pid: ownerPid } : {}),
                     ...(running && lock.mcpUrl ? { mcpUrl: lock.mcpUrl } : {}),
+                    version: PAGER_VERSION,
+                    ...(ownerAlive && lock ? { brokerVersion: brokerLockVersion(lock) } : {}),
                     dbPath,
                 }));
                 break;
@@ -278,7 +281,7 @@ function usage(implementations) {
         "pager                        open the operator TUI",
         "pager <harness> [--session-name <name>] [-- <harness arguments>]",
         `                             start a harness attached to the broker (installed: ${harnesses || "none"})`,
-        "pager status                 broker state, pid, MCP endpoint and database",
+        "pager status                 broker state, pid, MCP endpoint, database and versions",
         "pager exit                   stop the broker",
         "pager restart                stop the broker and start a fresh one",
         "pager serve                  run the broker in the foreground",

package/dist/src/operator/protocol.d.ts

@@ -250,6 +250,8 @@ export type OperatorSnapshot = {
     protocolVersion: typeof OPERATOR_PROTOCOL_VERSION;
     /** Identifies the broker generation that produced the snapshot. */
     epoch: string;
+    /** Names the published package version of the broker that produced the snapshot. */
+    brokerVersion: string;
     /** Identifies the last event already reflected by this snapshot. */
     cursor: OperatorCursor;
     /** Records when the projection was generated. */

package/dist/src/operator/updates.js

@@ -2,6 +2,7 @@ import { projectOperatorAgents } from "./agent-projection.js";
 import { OPERATOR_PROTOCOL_VERSION, } from "./protocol.js";
 import { operatorDiagnostic } from "./diagnostics.js";
 import { projectOperatorTraffic } from "./traffic-projection.js";
+import { PAGER_VERSION } from "../version.js";
 /** Bounds retained stream-integrity diagnostics. */
 const UPDATE_DIAGNOSTIC_LIMIT = 64;
 /** Broker tables whose rows feed the repository and agent halves of an operator snapshot. */
@@ -181,6 +182,7 @@ export class OperatorUpdateService {
         return {
             protocolVersion: OPERATOR_PROTOCOL_VERSION,
             epoch: cursor.epoch,
+            brokerVersion: PAGER_VERSION,
             cursor,
             generatedAt: this.#now(),
             repositories: projected.repositories,

package/dist/src/operator/validation.js

@@ -173,7 +173,16 @@ export function validateOperatorSnapshot(value) {
     const record = readRecord(value, "snapshot");
     exactFields({
         record,
-        required: ["protocolVersion", "epoch", "cursor", "generatedAt", "repositories", "agents", "traffic"],
+        required: [
+            "protocolVersion",
+            "epoch",
+            "brokerVersion",
+            "cursor",
+            "generatedAt",
+            "repositories",
+            "agents",
+            "traffic",
+        ],
         optional: [],
         path: "snapshot",
     });
@@ -207,6 +216,7 @@ export function validateOperatorSnapshot(value) {
     const snapshot = {
         protocolVersion,
         epoch,
+        brokerVersion: readNonemptyString(record.brokerVersion, "snapshot.brokerVersion"),
         cursor,
         generatedAt: readTimestamp(record.generatedAt, "snapshot.generatedAt"),
         repositories,

package/dist/src/tui/app.js

@@ -8,6 +8,7 @@ import { Line, Overlay, PaneBar, Rule, VERTICAL_SCROLL_STYLE, useTuiModel } from
 import { AgentTrafficLog, MessageDetail, MessageOverlays, selectNewestTuiTraffic, stepTuiTrafficSelection, } from "./message-views.js";
 import { AGENT_TREE_COLUMNS, sidePaneWidths, MESSAGE_LOG_COLUMNS, PORTRAIT_BREAKPOINT_COLUMNS, agentColor, activeAgentCount, agentLogScope, brokerIndicator, COLLAPSED_LOG_ROWS, describeCommandOutcome, diagnosticColor, fitBarLeading, formatClock, formatDiagnostic, selectedMessage, selectMessageBodyRows, selectTuiTraffic, } from "./presentation.js";
 import { dimTuiTheme } from "./theme.js";
+import { PAGER_VERSION } from "../version.js";
 /* eslint-enable jsdoc/require-jsdoc -- The collaborator declarations end here. */
 /** Rows the wide layout spends on fixed chrome rather than pane content. */
 const WIDE_PANE_CHROME_ROWS = 7;
@@ -274,11 +275,11 @@ function FollowFooter({ state, theme }) {
 }
 function StatusBar({ state, theme }) {
     const broker = brokerIndicator(state.connection, theme);
-    return (_jsxs("box", { height: 1, flexShrink: 0, flexDirection: "row", paddingLeft: 1, paddingRight: 1, justifyContent: "space-between", children: [_jsx("text", { fg: theme.structure.emphasis, children: "pager" }), _jsx("box", { flexDirection: "row", children: _jsxs("text", { fg: theme.structure.rulesAndLabels, children: [_jsx("span", { fg: broker.color, children: broker.glyph }), " broker   ", `${String(state.unreadMessageIds.size)} unread   ${String(activeAgentCount(state))} agents`] }) })] }));
+    return (_jsxs("box", { height: 1, flexShrink: 0, flexDirection: "row", paddingLeft: 1, paddingRight: 1, justifyContent: "space-between", children: [_jsx("text", { fg: theme.structure.emphasis, children: "pager" }), _jsx("box", { flexDirection: "row", children: _jsxs("text", { fg: theme.structure.rulesAndLabels, children: [_jsx("span", { fg: broker.color, children: broker.glyph }), " broker   ", `${String(state.unreadMessageIds.size)} unread   ${String(activeAgentCount(state))} agents   v${PAGER_VERSION}`] }) })] }));
 }
 function PortraitStatusBar({ state, theme }) {
     const broker = brokerIndicator(state.connection, theme);
-    return (_jsx(PaneBar, { left: _jsx("text", { fg: theme.structure.emphasis, children: "pager" }), right: _jsxs("text", { fg: theme.structure.rulesAndLabels, children: [_jsx("span", { fg: broker.color, children: broker.glyph }), ` ${String(state.unreadMessageIds.size)} unread · ${String(activeAgentCount(state))} agents`] }) }));
+    return (_jsx(PaneBar, { left: _jsx("text", { fg: theme.structure.emphasis, children: "pager" }), right: _jsxs("text", { fg: theme.structure.rulesAndLabels, children: [_jsx("span", { fg: broker.color, children: broker.glyph }), ` ${String(state.unreadMessageIds.size)} unread · ${String(activeAgentCount(state))} agents · v${PAGER_VERSION}`] }) }));
 }
 const HELP_KEYS = [
     ["↑↓", "move within the focused pane"],

package/dist/src/tui/model.js

@@ -349,7 +349,7 @@ export class TuiOperatorModel {
             if (!this.#active(generation))
                 return;
             if (this.#state.connection !== "healthy")
-                this.reportDiagnostic("info", "connection", `connected: snapshot at sequence ${String(snapshot.cursor.sequence)}`);
+                this.reportDiagnostic("info", "connection", `connected: broker ${snapshot.brokerVersion}, snapshot at sequence ${String(snapshot.cursor.sequence)}`);
             // A fetched snapshot is installed as a fresh start rather than a replacement, so unread identities
             // begin empty from it.
             this.observeSnapshot(structuredClone(snapshot), false);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haywoodmarx/agent-pager",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Durable local messaging between agent implementations.",
   "type": "module",
   "main": "./dist/src/index.js",