@openscout/protocol 0.2.84 → 0.2.85

package/dist/agent-identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-identity.d.ts","sourceRoot":"","sources":["../src/agent-identity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-identity.d.ts","sourceRoot":"","sources":["../src/agent-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5F,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAsBD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED,eAAO,MAAM,6BAA6B,sCAAgC,CAAC;AAE3E,eAAO,MAAM,yBAAyB,UAAU,CAAC;AACjD,eAAO,MAAM,8BAA8B,cAAc,CAAC;AAE1D,eAAO,MAAM,6BAA6B,EAAE,WAAW,CAAC,MAAM,CAK5D,CAAC;AAEH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGpF;AAMD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGrF;AA8ID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAetE;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,MAAM,CA0BR;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7B,aAAa,GAAG,IAAI,CAgBtB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAsBlG;AA6ID,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,sBAAsB,EAC3E,SAAS,EAAE,CAAC,EACZ,UAAU,EAAE,CAAC,EAAE,EACf,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/E,MAAM,CAqCR;AAED,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,sBAAsB,EACxE,UAAU,EAAE,CAAC,EAAE,GACd,CAAC,EAAE,CASL;AA+CD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,sBAAsB,GAChC,OAAO,CAoCT;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,sBAAsB,EACnE,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,CAAC,EAAE,GACd,CAAC,GAAG,IAAI,CAGV;AAED,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,sBAAsB,IAC/D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,CAAC,EAAE,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAExB,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,sBAAsB,EACpE,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,CAAC,EAAE,GACd,sBAAsB,CAAC,CAAC,CAAC,CAsC3B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;CAC5B,GAAG,kBAAkB,GAAG,IAAI,CAQ5B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAG5G;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,EAAE,GAC5B,aAAa,GAAG,IAAI,CAYtB;AAmDD,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,sBAAsB,EACzE,SAAS,EAAE,CAAC,EACZ,UAAU,EAAE,CAAC,EAAE,EACf,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,MAAM,CA8CR;AAED,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;AACzC,8DAA8D;AAC9D,MAAM,MAAM,qBAAqB,GAAG,sBAAsB,CAAC;AAC3D,qDAAqD;AACrD,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC;AAC1C,8DAA8D;AAC9D,MAAM,MAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAE5D,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,2BAAqB,CAAC;AACpD,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,4BAAsB,CAAC;AACtD,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,+BAAyB,CAAC;AAC5D,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,+BAAyB,CAAC;AAC5D,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,6BAAuB,CAAC;AACxD,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,6BAAuB,CAAC;AAExD,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,2BAAqB,CAAC;AACrD,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,4BAAsB,CAAC;AACvD,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,+BAAyB,CAAC;AAC5D,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,6BAAuB,CAAC;AACzD,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,6BAAuB,CAAC"}

package/dist/agent-identity.js

@@ -55,7 +55,8 @@ function canonicalizeIdentity(input) {
         ? normalizeAgentIdentitySegment(input.workspaceQualifier)
         : undefined;
     const profile = input.profile ? normalizeAgentIdentitySegment(input.profile) : undefined;
-    const harness = input.harness ? normalizeAgentIdentitySegment(input.harness) : undefined;
+    const rawHarness = input.harness ? normalizeAgentIdentitySegment(input.harness) : undefined;
+    const harness = rawHarness === "oc" ? "opencode" : rawHarness;
     const model = input.model ? normalizeAgentIdentitySegment(input.model) : undefined;
     const nodeQualifier = input.nodeQualifier
         ? normalizeAgentIdentitySegment(input.nodeQualifier)

package/dist/events.d.ts

@@ -8,6 +8,8 @@ import type { ConversationReadCursor } from "./read-receipts.js";
 import type { AgentDefinition, AgentEndpoint, ActorIdentity } from "./actors.js";
 import type { CollaborationEvent, CollaborationRecord } from "./collaboration.js";
 import type { ScoutDispatchRecord } from "./scout-dispatch.js";
+import type { PresenceBeat } from "./presence.js";
+import type { ObservedActivity } from "./observed-status.js";
 export declare const OPENSCOUT_CONTROL_EVENT_VERSION: 1;
 export interface ControlEventBase<K extends string, P> {
     id: ScoutId;
@@ -76,7 +78,33 @@ export type CollaborationEventAppendedEvent = ControlEventBase<"collaboration.ev
 export type ScoutDispatchedEvent = ControlEventBase<"scout.dispatched", {
     dispatch: ScoutDispatchRecord;
 }>;
-export type ControlEvent = NodeUpsertedEvent | ActorRegisteredEvent | AgentRegisteredEvent | AgentEndpointUpsertedEvent | AgentEndpointDeletedEvent | ConversationUpsertedEvent | BindingUpsertedEvent | MessagePostedEvent | ConversationReadCursorUpdatedEvent | InvocationRequestedEvent | FlightUpdatedEvent | DeliveryPlannedEvent | DeliveryAttemptedEvent | DeliveryStateChangedEvent | CollaborationUpsertedEvent | CollaborationEventAppendedEvent | ScoutDispatchedEvent;
+/**
+ * An agent entered a new activity.
+ *
+ * Emitted on **transition only** — heartbeats bump the broker's presence map in
+ * place and put nothing on the wire. This event is ephemeral by construction:
+ * it must never be persisted and must never enter the shared control-event
+ * backlog (see {@link isEphemeralControlEvent}). The presence map *is* its
+ * backlog — latest-per-agent — and subscribers receive that map on connect.
+ */
+export type PresenceUpdatedEvent = ControlEventBase<"presence.updated", {
+    beat: PresenceBeat;
+    /** Absent when the agent had no prior presence entry. */
+    previousActivity?: ObservedActivity;
+}>;
+export type ControlEvent = NodeUpsertedEvent | ActorRegisteredEvent | AgentRegisteredEvent | AgentEndpointUpsertedEvent | AgentEndpointDeletedEvent | ConversationUpsertedEvent | BindingUpsertedEvent | MessagePostedEvent | ConversationReadCursorUpdatedEvent | InvocationRequestedEvent | FlightUpdatedEvent | DeliveryPlannedEvent | DeliveryAttemptedEvent | DeliveryStateChangedEvent | CollaborationUpsertedEvent | CollaborationEventAppendedEvent | ScoutDispatchedEvent | PresenceUpdatedEvent;
+/**
+ * Control-event kinds that are ephemeral by construction.
+ *
+ * Ephemeral events ride the in-memory control bus for live fan-out and are
+ * dropped everywhere else: no SQLite row, no journal entry, no place in the
+ * shared bounded backlog. Presence traffic creating zero durable records is a
+ * hard constraint, so the durable and backlog paths check this set rather than
+ * trusting every call site to route correctly.
+ */
+export declare const EPHEMERAL_CONTROL_EVENT_KINDS: ReadonlySet<ControlEvent["kind"]>;
+/** True when the event must never be persisted or backlogged. */
+export declare function isEphemeralControlEvent(event: Pick<ControlEvent, "kind">): boolean;
 /**
  * Stamp the current envelope version onto a control event when it is missing.
  *

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -1,4 +1,20 @@
 export const OPENSCOUT_CONTROL_EVENT_VERSION = 1;
+/**
+ * Control-event kinds that are ephemeral by construction.
+ *
+ * Ephemeral events ride the in-memory control bus for live fan-out and are
+ * dropped everywhere else: no SQLite row, no journal entry, no place in the
+ * shared bounded backlog. Presence traffic creating zero durable records is a
+ * hard constraint, so the durable and backlog paths check this set rather than
+ * trusting every call site to route correctly.
+ */
+export const EPHEMERAL_CONTROL_EVENT_KINDS = new Set([
+    "presence.updated",
+]);
+/** True when the event must never be persisted or backlogged. */
+export function isEphemeralControlEvent(event) {
+    return EPHEMERAL_CONTROL_EVENT_KINDS.has(event.kind);
+}
 /**
  * Stamp the current envelope version onto a control event when it is missing.
  *

package/dist/index.d.ts

@@ -20,6 +20,7 @@ export * from "./budget.js";
 export * from "./agent-broker-feed.js";
 export * from "./durable-actions.js";
 export * from "./observed-status.js";
+export * from "./presence.js";
 export * from "./activity.js";
 export * from "./harness-feature-support.js";
 export * from "./host-integrations.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -20,6 +20,7 @@ export * from "./budget.js";
 export * from "./agent-broker-feed.js";
 export * from "./durable-actions.js";
 export * from "./observed-status.js";
+export * from "./presence.js";
 export * from "./activity.js";
 export * from "./harness-feature-support.js";
 export * from "./host-integrations.js";

package/dist/observed-status.d.ts

@@ -26,8 +26,25 @@ export interface ObservedStatusProjection {
     detail?: ObservedStatusDetail;
     provenance: StatusProjectionProvenance[];
     confidence: number;
+    /** Last observation. Refreshes on every sample, including no-op samples. */
     updatedAt: number;
     staleAt?: number;
+    /**
+     * When the *current* {@link ObservedActivity} began — state-entry time, not
+     * last-observation time.
+     *
+     * `updatedAt` answers "how fresh is this claim"; `transitionAt` answers "how
+     * long has it been true". Both are needed and they are not interchangeable:
+     * an agent heartbeating every 15s while stuck in `executing` for nine minutes
+     * has a constantly-moving `updatedAt` and a nine-minute-old `transitionAt`,
+     * and the second number is the one an operator acts on.
+     *
+     * Optional because a single snapshot cannot recover it: activity history is
+     * state, so only a projection given a transition log (see the runtime's
+     * `ActivityTransitionTracker`) can populate this. Pure snapshot projections
+     * leave it undefined rather than guessing.
+     */
+    transitionAt?: number;
 }
 export declare function observedStatusDisplay(status: Pick<ObservedStatusProjection, "phase" | "activity">): string;
 //# sourceMappingURL=observed-status.d.ts.map

package/dist/observed-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observed-status.d.ts","sourceRoot":"","sources":["../src/observed-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,MAAM,mBAAmB,GAC3B,cAAc,GACd,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,SAAS,GACT,UAAU,GACV,SAAS,GACT,QAAQ,GACR,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,WAAW,GACX,SAAS,GACT,mBAAmB,GACnB,kBAAkB,GAClB,SAAS,GACT,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,WAAW,GACX,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,yBAAyB,GACjC,OAAO,GACP,UAAU,GACV,QAAQ,GACR,KAAK,GACL,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,cAAc,CAAC;AAEnB,MAAM,MAAM,8BAA8B,GACtC,eAAe,GACf,UAAU,GACV,QAAQ,GACR,WAAW,GACX,sBAAsB,GACtB,eAAe,GACf,iBAAiB,GACjB,YAAY,GACZ,SAAS,GACT,MAAM,GACN,qBAAqB,CAAC;AAE1B,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,8BAA8B,CAAC;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,yBAAyB,CAAC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,UAAU,EAAE,0BAA0B,EAAE,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,wBAAwB,EAAE,OAAO,GAAG,UAAU,CAAC,GAAG,MAAM,CAK1G"}
+{"version":3,"file":"observed-status.d.ts","sourceRoot":"","sources":["../src/observed-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,MAAM,mBAAmB,GAC3B,cAAc,GACd,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,SAAS,GACT,UAAU,GACV,SAAS,GACT,QAAQ,GACR,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,WAAW,GACX,SAAS,GACT,mBAAmB,GACnB,kBAAkB,GAClB,SAAS,GACT,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,WAAW,GACX,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,yBAAyB,GACjC,OAAO,GACP,UAAU,GACV,QAAQ,GACR,KAAK,GACL,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,cAAc,CAAC;AAEnB,MAAM,MAAM,8BAA8B,GACtC,eAAe,GACf,UAAU,GACV,QAAQ,GACR,WAAW,GACX,sBAAsB,GACtB,eAAe,GACf,iBAAiB,GACjB,YAAY,GACZ,SAAS,GACT,MAAM,GACN,qBAAqB,CAAC;AAE1B,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,8BAA8B,CAAC;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,yBAAyB,CAAC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,UAAU,EAAE,0BAA0B,EAAE,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;;;;;OAcG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,wBAAwB,EAAE,OAAO,GAAG,UAAU,CAAC,GAAG,MAAM,CAK1G"}

package/dist/presence.d.ts

@@ -0,0 +1,125 @@
+import type { ScoutId } from "./common.js";
+import type { ObservedActivity, ObservedStatusPhase } from "./observed-status.js";
+/**
+ * Agent presence — the shared staleness primitive behind chat presence and the
+ * spatial fleet surface.
+ *
+ * The framing that makes both surfaces work from one implementation: presence
+ * is not a pulse, it is a *timestamped fact*.
+ *
+ *   "Agent A has been in activity S, about D, since `transitionAt` — this claim
+ *    is fresh until `staleAt`."
+ *
+ * A pulse has to keep arriving to stay true. A timestamped fact keeps rendering
+ * live without another byte on the wire, because every renderer derives the
+ * changing part (age, decay) from the static payload. That is why decay is
+ * never signalled: see {@link presenceLifecycle}.
+ */
+/**
+ * How long a beat stays fresh after its last observation.
+ *
+ * Sized at three missed observations on the ~15s broker cadence: one dropped
+ * beat must never flap an agent out of freshness.
+ */
+export declare const PRESENCE_STALE_AFTER_MS = 45000;
+/**
+ * How long a stale beat lingers before it is dropped entirely.
+ *
+ * This window is load-bearing, not a grace period. "The observer went quiet —
+ * busy in a long tool call, or dead, cannot yet tell" is a real state, and
+ * dropping cleanly at first expiry would erase exactly the ambiguity the
+ * operator needs to see.
+ */
+export declare const PRESENCE_GONE_AFTER_STALE_MS = 60000;
+/**
+ * Transport freshness of a beat. Derived from timestamps, never transmitted.
+ *
+ * IMPORTANT — this is not the agent's activity, and the two must never be
+ * conflated. `stale` means *no beats are arriving*: the observer went quiet.
+ * `activity === "stalled"` means beats **are** arriving and inference says the
+ * agent is stuck. They carry opposite information and must render oppositely:
+ * stalled is loud and fresh, stale is faded and dated.
+ */
+export type PresenceLifecycle = "fresh" | "stale" | "gone";
+/**
+ * One agent's current presence. Keyed per agent, never per (agent × room):
+ * the activity is a fact about the agent's single runtime, so a
+ * per-conversation "what am I doing in *this* room" would be fiction for any
+ * agent doing one thing at a time. Rooms filter and gate this one entry.
+ */
+export interface PresenceBeat {
+    agentId: ScoutId;
+    displayName?: string;
+    /** Existing 16-value vocabulary, verbatim — presence adds no second enum. */
+    activity: ObservedActivity;
+    /** Carried for non-running edge rendering (error, stopped, unconfigured…). */
+    phase: ObservedStatusPhase;
+    /** `ObservedStatusDetail.title` — room-gated by `conversationBound`. */
+    detail?: string;
+    /** When the current activity began. The load-bearing timestamp. */
+    transitionAt: number;
+    /** Last observation. Freshness input only. */
+    updatedAt: number;
+    /** Decay boundary. Required here even though it is optional upstream. */
+    staleAt: number;
+    confidence: number;
+    /**
+     * When waiting: the durable `scout need` record behind this state.
+     *
+     * Presence is never the carrier of a question — an ephemeral ask is a lost
+     * ask. This is a reference to the durable record, so the loud chat chip can
+     * link to the actual question. The invariant is directional: every declared
+     * ask produces a presence state; not every presence-waiting has a declared
+     * ask (a harness can observe a permission prompt with no need record); and no
+     * ask ever exists *only* in presence.
+     */
+    needRef?: ScoutId;
+    /**
+     * The conversation the agent's current work is bound to, when it is bound to
+     * one.
+     *
+     * A per-agent beat cannot carry "is this bound to *your* room" as a boolean —
+     * one global entry is read by every room at once, so the boolean would have
+     * to be true and false simultaneously. It carries the conversation id
+     * instead, and each room derives the answer with
+     * {@link isPresenceBoundToConversation}: full `activity + detail` when the
+     * work is this room's, bare activity otherwise, so the detail string does not
+     * announce what the agent is doing elsewhere.
+     */
+    boundConversationId?: ScoutId;
+}
+/** A full presence map, as handed to a subscriber on connect. */
+export interface PresenceSnapshot {
+    /** When the snapshot was taken — the "as of" for every beat in it. */
+    at: number;
+    beats: PresenceBeat[];
+}
+export interface PresenceLifecycleOptions {
+    /** Override the linger window after `staleAt`. */
+    goneAfterStaleMs?: number;
+}
+/**
+ * Classify a beat's transport freshness at `now`.
+ *
+ * Every renderer computes this locally and continuously. The broker never
+ * emits a "now stale" event — a presence-expired signal is the
+ * indicator-outlives-process bug wearing a different hat, since it can only
+ * arrive over the same transport that just went quiet.
+ */
+export declare function presenceLifecycle(beat: Pick<PresenceBeat, "staleAt">, now: number, options?: PresenceLifecycleOptions): PresenceLifecycle;
+/** Age of the current activity — the number an operator actually reads. */
+export declare function presenceAgeMs(beat: Pick<PresenceBeat, "transitionAt">, now: number): number;
+/** How long the claim itself has gone unrefreshed. Only meaningful once stale. */
+export declare function presenceSilenceMs(beat: Pick<PresenceBeat, "updatedAt">, now: number): number;
+/**
+ * Whether a room may render this beat's `detail`.
+ *
+ * Room-gating is a rendering rule over one global map, not a second map: the
+ * activity is a fact about the agent's single runtime, and a per-conversation
+ * "what am I doing in *this* room" would be fiction for any agent doing one
+ * thing at a time.
+ */
+export declare function isPresenceBoundToConversation(beat: Pick<PresenceBeat, "boundConversationId">, conversationId: ScoutId): boolean;
+/** True once the beat has decayed past the stale window and should be dropped. */
+export declare function isPresenceGone(beat: Pick<PresenceBeat, "staleAt">, now: number, options?: PresenceLifecycleOptions): boolean;
+//# sourceMappingURL=presence.d.ts.map

package/dist/presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../src/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,8EAA8E;IAC9E,KAAK,EAAE,mBAAmB,CAAC;IAC3B,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EACnC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAKnB;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5F;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,qBAAqB,CAAC,EAC/C,cAAc,EAAE,OAAO,GACtB,OAAO,CAET;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EACnC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAET"}

package/dist/presence.js

@@ -0,0 +1,70 @@
+/**
+ * Agent presence — the shared staleness primitive behind chat presence and the
+ * spatial fleet surface.
+ *
+ * The framing that makes both surfaces work from one implementation: presence
+ * is not a pulse, it is a *timestamped fact*.
+ *
+ *   "Agent A has been in activity S, about D, since `transitionAt` — this claim
+ *    is fresh until `staleAt`."
+ *
+ * A pulse has to keep arriving to stay true. A timestamped fact keeps rendering
+ * live without another byte on the wire, because every renderer derives the
+ * changing part (age, decay) from the static payload. That is why decay is
+ * never signalled: see {@link presenceLifecycle}.
+ */
+/**
+ * How long a beat stays fresh after its last observation.
+ *
+ * Sized at three missed observations on the ~15s broker cadence: one dropped
+ * beat must never flap an agent out of freshness.
+ */
+export const PRESENCE_STALE_AFTER_MS = 45_000;
+/**
+ * How long a stale beat lingers before it is dropped entirely.
+ *
+ * This window is load-bearing, not a grace period. "The observer went quiet —
+ * busy in a long tool call, or dead, cannot yet tell" is a real state, and
+ * dropping cleanly at first expiry would erase exactly the ambiguity the
+ * operator needs to see.
+ */
+export const PRESENCE_GONE_AFTER_STALE_MS = 60_000;
+/**
+ * Classify a beat's transport freshness at `now`.
+ *
+ * Every renderer computes this locally and continuously. The broker never
+ * emits a "now stale" event — a presence-expired signal is the
+ * indicator-outlives-process bug wearing a different hat, since it can only
+ * arrive over the same transport that just went quiet.
+ */
+export function presenceLifecycle(beat, now, options = {}) {
+    if (now < beat.staleAt)
+        return "fresh";
+    const goneAfterStaleMs = options.goneAfterStaleMs ?? PRESENCE_GONE_AFTER_STALE_MS;
+    if (now < beat.staleAt + goneAfterStaleMs)
+        return "stale";
+    return "gone";
+}
+/** Age of the current activity — the number an operator actually reads. */
+export function presenceAgeMs(beat, now) {
+    return Math.max(0, now - beat.transitionAt);
+}
+/** How long the claim itself has gone unrefreshed. Only meaningful once stale. */
+export function presenceSilenceMs(beat, now) {
+    return Math.max(0, now - beat.updatedAt);
+}
+/**
+ * Whether a room may render this beat's `detail`.
+ *
+ * Room-gating is a rendering rule over one global map, not a second map: the
+ * activity is a fact about the agent's single runtime, and a per-conversation
+ * "what am I doing in *this* room" would be fiction for any agent doing one
+ * thing at a time.
+ */
+export function isPresenceBoundToConversation(beat, conversationId) {
+    return beat.boundConversationId !== undefined && beat.boundConversationId === conversationId;
+}
+/** True once the beat has decayed past the stale window and should be dropped. */
+export function isPresenceGone(beat, now, options = {}) {
+    return presenceLifecycle(beat, now, options) === "gone";
+}

package/dist/runtime-execution.d.ts

@@ -139,6 +139,7 @@ export type ScoutRuntimeTupleIssue = {
     dimension: "harness" | "model" | "reasoningEffort";
     message: string;
 };
+export declare function normalizeScoutLaunchableHarness(value: string | null | undefined): ScoutLaunchableHarness | null;
 export declare function isScoutLaunchableHarness(value: string | null | undefined): value is ScoutLaunchableHarness;
 export declare function normalizeScoutReasoningEffort(value: string | null | undefined): ScoutReasoningEffort | null;
 export declare function runtimeDimensionResolution(input: {

package/dist/runtime-execution.d.ts.map

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

package/dist/runtime-execution.js

@@ -176,7 +176,8 @@ export function parseScoutRuntimeSpec(input) {
             error: "runtime must be <harness>[/<model>[/<effort>]]",
         };
     }
-    const harness = parts[0].trim().toLowerCase();
+    const rawHarness = parts[0].trim().toLowerCase();
+    const harness = (rawHarness === "oc" ? "opencode" : rawHarness);
     if (!isScoutLaunchableHarness(harness)) {
         return {
             ok: false,
@@ -213,9 +214,19 @@ export function formatScoutRuntimeSpec(spec) {
         .filter((part) => Boolean(part))
         .join("/");
 }
+export function normalizeScoutLaunchableHarness(value) {
+    if (!value)
+        return null;
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "oc")
+        return "opencode";
+    return isScoutLaunchableHarness(normalized) ? normalized : null;
+}
 export function isScoutLaunchableHarness(value) {
-    return Boolean(value)
-        && SCOUT_LAUNCHABLE_HARNESSES.includes(value.trim().toLowerCase());
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized === "oc" || SCOUT_LAUNCHABLE_HARNESSES.includes(normalized);
 }
 export function normalizeScoutReasoningEffort(value) {
     const normalized = value?.trim().toLowerCase();
@@ -260,7 +271,8 @@ export function createScoutExecutionResolution(input) {
     };
 }
 export function validateScoutRuntimeTuple(input, catalog) {
-    const harness = input.harness?.trim().toLowerCase();
+    const rawHarness = input.harness?.trim().toLowerCase();
+    const harness = rawHarness === "oc" ? "opencode" : rawHarness;
     const model = input.model?.trim();
     const effortRaw = input.reasoningEffort?.trim();
     const issues = [];
@@ -305,7 +317,8 @@ export function validateScoutRuntimeTuple(input, catalog) {
     const modelSelectableHarness = harness === "claude"
         || harness === "codex"
         || harness === "grok"
-        || harness === "grok-acp";
+        || harness === "grok-acp"
+        || harness === "opencode";
     if (model && harness && !modelSelectableHarness) {
         issues.push({
             code: "unsupported_model_dimension",

package/dist/runtime-profiles.d.ts

@@ -3,7 +3,7 @@ import { type ScoutReasoningEffort } from "./runtime-execution.js";
  * Reserved natural-language profile names. Their execution definitions stay
  * broker-owned; clients use this list only to recognize unambiguous syntax.
  */
-export declare const SCOUT_RESERVED_RUNTIME_PROFILE_IDS: readonly ["fable", "kimi", "grok", "opus"];
+export declare const SCOUT_RESERVED_RUNTIME_PROFILE_IDS: readonly ["fable", "kimi", "grok", "opus", "oc", "opencode"];
 export type ScoutReservedRuntimeProfileId = (typeof SCOUT_RESERVED_RUNTIME_PROFILE_IDS)[number];
 export declare const SCOUT_RUNTIME_PROFILE_REASONING_EFFORTS: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max", "ultra"];
 export type ScoutRuntimeProfileReasoningEffort = ScoutReasoningEffort;

package/dist/runtime-profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-profiles.d.ts","sourceRoot":"","sources":["../src/runtime-profiles.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,kCAAkC,4CAKrC,CAAC;AAEX,MAAM,MAAM,6BAA6B,GACvC,CAAC,OAAO,kCAAkC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,eAAO,MAAM,uCAAuC,gFAA0B,CAAC;AAE/E,MAAM,MAAM,kCAAkC,GAAG,oBAAoB,CAAC;AAEtE,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,MAAM,GACZ,6BAA6B,GAAG,IAAI,CAGtC;AAED,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,MAAM,GACZ,kCAAkC,GAAG,IAAI,CAE3C"}
+{"version":3,"file":"runtime-profiles.d.ts","sourceRoot":"","sources":["../src/runtime-profiles.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,kCAAkC,8DAOrC,CAAC;AAEX,MAAM,MAAM,6BAA6B,GACvC,CAAC,OAAO,kCAAkC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,eAAO,MAAM,uCAAuC,gFAA0B,CAAC;AAE/E,MAAM,MAAM,kCAAkC,GAAG,oBAAoB,CAAC;AAEtE,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,MAAM,GACZ,6BAA6B,GAAG,IAAI,CAGtC;AAED,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,MAAM,GACZ,kCAAkC,GAAG,IAAI,CAE3C"}

package/dist/runtime-profiles.js

@@ -9,6 +9,8 @@ export const SCOUT_RESERVED_RUNTIME_PROFILE_IDS = [
     "kimi",
     "grok",
     "opus",
+    "oc",
+    "opencode",
 ];
 export const SCOUT_RUNTIME_PROFILE_REASONING_EFFORTS = SCOUT_REASONING_EFFORTS;
 export function normalizeReservedRuntimeProfileId(value) {

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

@@ -13,8 +13,11 @@
  * The server builds this from `herdr --session <n> workspace list`,
  * `tab list`, and `pane list` JSON, plus the per-tab layout geometry from
  * `herdr --session <n> api snapshot`. A session whose server is stopped
- * projects as `{ running: false, workspaces: [] }` — an ordinary state, not
- * an error.
+ * projects from its persisted `session.json` instead — same shape, marked by
+ * `running: false` and `savedAt`; geometry, terminal ids, and live agent
+ * status are simply absent from a persisted projection. A session with no
+ * persisted state projects as `{ running: false, workspaces: [] }` — an
+ * ordinary state, not an error.
  */
 /** Agent state as herdr reports it, never as Scout infers it. */
 export type HerdrAgentStatus = "idle" | "working" | "blocked" | "done" | "unknown";
@@ -114,6 +117,12 @@ export type HerdrSessionTopology = {
     workspaces: HerdrWorkspaceProjection[];
     /** Server wall-clock when the projection was observed. */
     observedAt: number;
+    /**
+     * When the projection came from the persisted session state (server stopped),
+     * the mtime of that state — the session's last known change. Absent when the
+     * projection is live.
+     */
+    savedAt?: number | null;
 };
 export declare function emptyHerdrSessionTopology(session: string, running: boolean): 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":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAEnF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,YAAY,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1C,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IACnC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,eAAe,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,4EAA4E;IAC5E,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,IAAI,EAAE,kBAAkB,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,wBAAwB,EAAE,CAAC;IACvC,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAEjG"}

package/dist/terminal-host-topology.js

@@ -13,8 +13,11 @@
  * The server builds this from `herdr --session <n> workspace list`,
  * `tab list`, and `pane list` JSON, plus the per-tab layout geometry from
  * `herdr --session <n> api snapshot`. A session whose server is stopped
- * projects as `{ running: false, workspaces: [] }` — an ordinary state, not
- * an error.
+ * projects from its persisted `session.json` instead — same shape, marked by
+ * `running: false` and `savedAt`; geometry, terminal ids, and live agent
+ * status are simply absent from a persisted projection. A session with no
+ * 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() };

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@openscout/protocol",
-  "version": "0.2.84",
+  "version": "0.2.85",
   "description": "Typed protocol for the OpenScout local control plane",
   "license": "Apache-2.0",
   "type": "module",
   "author": "Arach Tchoupani",
-  "homepage": "https://github.com/oscout/scout/tree/main/packages/protocol#readme",
+  "homepage": "https://github.com/arach/openscout/tree/main/packages/protocol#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/oscout/scout.git",
+    "url": "git+https://github.com/arach/openscout.git",
     "directory": "packages/protocol"
   },
   "bugs": {
-    "url": "https://github.com/oscout/scout/issues"
+    "url": "https://github.com/arach/openscout/issues"
   },
   "keywords": [
     "openscout",

package/src/agent-identity.ts

@@ -104,7 +104,8 @@ function canonicalizeIdentity(input: AgentIdentityInput): AgentIdentityInput | n
     ? normalizeAgentIdentitySegment(input.workspaceQualifier)
     : undefined;
   const profile = input.profile ? normalizeAgentIdentitySegment(input.profile) : undefined;
-  const harness = input.harness ? normalizeAgentIdentitySegment(input.harness) : undefined;
+  const rawHarness = input.harness ? normalizeAgentIdentitySegment(input.harness) : undefined;
+  const harness = rawHarness === "oc" ? "opencode" : rawHarness;
   const model = input.model ? normalizeAgentIdentitySegment(input.model) : undefined;
   const nodeQualifier = input.nodeQualifier
     ? normalizeAgentIdentitySegment(input.nodeQualifier)

package/src/events.ts

@@ -8,6 +8,8 @@ import type { ConversationReadCursor } from "./read-receipts.js";
 import type { AgentDefinition, AgentEndpoint, ActorIdentity } from "./actors.js";
 import type { CollaborationEvent, CollaborationRecord } from "./collaboration.js";
 import type { ScoutDispatchRecord } from "./scout-dispatch.js";
+import type { PresenceBeat } from "./presence.js";
+import type { ObservedActivity } from "./observed-status.js";
 
 export const OPENSCOUT_CONTROL_EVENT_VERSION = 1 as const;
 
@@ -96,6 +98,21 @@ export type ScoutDispatchedEvent = ControlEventBase<"scout.dispatched", {
   dispatch: ScoutDispatchRecord;
 }>;
 
+/**
+ * An agent entered a new activity.
+ *
+ * Emitted on **transition only** — heartbeats bump the broker's presence map in
+ * place and put nothing on the wire. This event is ephemeral by construction:
+ * it must never be persisted and must never enter the shared control-event
+ * backlog (see {@link isEphemeralControlEvent}). The presence map *is* its
+ * backlog — latest-per-agent — and subscribers receive that map on connect.
+ */
+export type PresenceUpdatedEvent = ControlEventBase<"presence.updated", {
+  beat: PresenceBeat;
+  /** Absent when the agent had no prior presence entry. */
+  previousActivity?: ObservedActivity;
+}>;
+
 export type ControlEvent =
   | NodeUpsertedEvent
   | ActorRegisteredEvent
@@ -113,7 +130,26 @@ export type ControlEvent =
   | DeliveryStateChangedEvent
   | CollaborationUpsertedEvent
   | CollaborationEventAppendedEvent
-  | ScoutDispatchedEvent;
+  | ScoutDispatchedEvent
+  | PresenceUpdatedEvent;
+
+/**
+ * Control-event kinds that are ephemeral by construction.
+ *
+ * Ephemeral events ride the in-memory control bus for live fan-out and are
+ * dropped everywhere else: no SQLite row, no journal entry, no place in the
+ * shared bounded backlog. Presence traffic creating zero durable records is a
+ * hard constraint, so the durable and backlog paths check this set rather than
+ * trusting every call site to route correctly.
+ */
+export const EPHEMERAL_CONTROL_EVENT_KINDS: ReadonlySet<ControlEvent["kind"]> = new Set<ControlEvent["kind"]>([
+  "presence.updated",
+]);
+
+/** True when the event must never be persisted or backlogged. */
+export function isEphemeralControlEvent(event: Pick<ControlEvent, "kind">): boolean {
+  return EPHEMERAL_CONTROL_EVENT_KINDS.has(event.kind);
+}
 
 /**
  * Stamp the current envelope version onto a control event when it is missing.

package/src/index.ts

@@ -20,6 +20,7 @@ export * from "./budget.js";
 export * from "./agent-broker-feed.js";
 export * from "./durable-actions.js";
 export * from "./observed-status.js";
+export * from "./presence.js";
 export * from "./activity.js";
 export * from "./harness-feature-support.js";
 export * from "./host-integrations.js";

package/src/observed-status.ts

@@ -78,8 +78,25 @@ export interface ObservedStatusProjection {
   detail?: ObservedStatusDetail;
   provenance: StatusProjectionProvenance[];
   confidence: number;
+  /** Last observation. Refreshes on every sample, including no-op samples. */
   updatedAt: number;
   staleAt?: number;
+  /**
+   * When the *current* {@link ObservedActivity} began — state-entry time, not
+   * last-observation time.
+   *
+   * `updatedAt` answers "how fresh is this claim"; `transitionAt` answers "how
+   * long has it been true". Both are needed and they are not interchangeable:
+   * an agent heartbeating every 15s while stuck in `executing` for nine minutes
+   * has a constantly-moving `updatedAt` and a nine-minute-old `transitionAt`,
+   * and the second number is the one an operator acts on.
+   *
+   * Optional because a single snapshot cannot recover it: activity history is
+   * state, so only a projection given a transition log (see the runtime's
+   * `ActivityTransitionTracker`) can populate this. Pure snapshot projections
+   * leave it undefined rather than guessing.
+   */
+  transitionAt?: number;
 }
 
 export function observedStatusDisplay(status: Pick<ObservedStatusProjection, "phase" | "activity">): string {

package/src/presence.ts

@@ -0,0 +1,160 @@
+import type { ScoutId } from "./common.js";
+import type { ObservedActivity, ObservedStatusPhase } from "./observed-status.js";
+
+/**
+ * Agent presence — the shared staleness primitive behind chat presence and the
+ * spatial fleet surface.
+ *
+ * The framing that makes both surfaces work from one implementation: presence
+ * is not a pulse, it is a *timestamped fact*.
+ *
+ *   "Agent A has been in activity S, about D, since `transitionAt` — this claim
+ *    is fresh until `staleAt`."
+ *
+ * A pulse has to keep arriving to stay true. A timestamped fact keeps rendering
+ * live without another byte on the wire, because every renderer derives the
+ * changing part (age, decay) from the static payload. That is why decay is
+ * never signalled: see {@link presenceLifecycle}.
+ */
+
+/**
+ * How long a beat stays fresh after its last observation.
+ *
+ * Sized at three missed observations on the ~15s broker cadence: one dropped
+ * beat must never flap an agent out of freshness.
+ */
+export const PRESENCE_STALE_AFTER_MS = 45_000;
+
+/**
+ * How long a stale beat lingers before it is dropped entirely.
+ *
+ * This window is load-bearing, not a grace period. "The observer went quiet —
+ * busy in a long tool call, or dead, cannot yet tell" is a real state, and
+ * dropping cleanly at first expiry would erase exactly the ambiguity the
+ * operator needs to see.
+ */
+export const PRESENCE_GONE_AFTER_STALE_MS = 60_000;
+
+/**
+ * Transport freshness of a beat. Derived from timestamps, never transmitted.
+ *
+ * IMPORTANT — this is not the agent's activity, and the two must never be
+ * conflated. `stale` means *no beats are arriving*: the observer went quiet.
+ * `activity === "stalled"` means beats **are** arriving and inference says the
+ * agent is stuck. They carry opposite information and must render oppositely:
+ * stalled is loud and fresh, stale is faded and dated.
+ */
+export type PresenceLifecycle = "fresh" | "stale" | "gone";
+
+/**
+ * One agent's current presence. Keyed per agent, never per (agent × room):
+ * the activity is a fact about the agent's single runtime, so a
+ * per-conversation "what am I doing in *this* room" would be fiction for any
+ * agent doing one thing at a time. Rooms filter and gate this one entry.
+ */
+export interface PresenceBeat {
+  agentId: ScoutId;
+  displayName?: string;
+  /** Existing 16-value vocabulary, verbatim — presence adds no second enum. */
+  activity: ObservedActivity;
+  /** Carried for non-running edge rendering (error, stopped, unconfigured…). */
+  phase: ObservedStatusPhase;
+  /** `ObservedStatusDetail.title` — room-gated by `conversationBound`. */
+  detail?: string;
+  /** When the current activity began. The load-bearing timestamp. */
+  transitionAt: number;
+  /** Last observation. Freshness input only. */
+  updatedAt: number;
+  /** Decay boundary. Required here even though it is optional upstream. */
+  staleAt: number;
+  confidence: number;
+  /**
+   * When waiting: the durable `scout need` record behind this state.
+   *
+   * Presence is never the carrier of a question — an ephemeral ask is a lost
+   * ask. This is a reference to the durable record, so the loud chat chip can
+   * link to the actual question. The invariant is directional: every declared
+   * ask produces a presence state; not every presence-waiting has a declared
+   * ask (a harness can observe a permission prompt with no need record); and no
+   * ask ever exists *only* in presence.
+   */
+  needRef?: ScoutId;
+  /**
+   * The conversation the agent's current work is bound to, when it is bound to
+   * one.
+   *
+   * A per-agent beat cannot carry "is this bound to *your* room" as a boolean —
+   * one global entry is read by every room at once, so the boolean would have
+   * to be true and false simultaneously. It carries the conversation id
+   * instead, and each room derives the answer with
+   * {@link isPresenceBoundToConversation}: full `activity + detail` when the
+   * work is this room's, bare activity otherwise, so the detail string does not
+   * announce what the agent is doing elsewhere.
+   */
+  boundConversationId?: ScoutId;
+}
+
+/** A full presence map, as handed to a subscriber on connect. */
+export interface PresenceSnapshot {
+  /** When the snapshot was taken — the "as of" for every beat in it. */
+  at: number;
+  beats: PresenceBeat[];
+}
+
+export interface PresenceLifecycleOptions {
+  /** Override the linger window after `staleAt`. */
+  goneAfterStaleMs?: number;
+}
+
+/**
+ * Classify a beat's transport freshness at `now`.
+ *
+ * Every renderer computes this locally and continuously. The broker never
+ * emits a "now stale" event — a presence-expired signal is the
+ * indicator-outlives-process bug wearing a different hat, since it can only
+ * arrive over the same transport that just went quiet.
+ */
+export function presenceLifecycle(
+  beat: Pick<PresenceBeat, "staleAt">,
+  now: number,
+  options: PresenceLifecycleOptions = {},
+): PresenceLifecycle {
+  if (now < beat.staleAt) return "fresh";
+  const goneAfterStaleMs = options.goneAfterStaleMs ?? PRESENCE_GONE_AFTER_STALE_MS;
+  if (now < beat.staleAt + goneAfterStaleMs) return "stale";
+  return "gone";
+}
+
+/** Age of the current activity — the number an operator actually reads. */
+export function presenceAgeMs(beat: Pick<PresenceBeat, "transitionAt">, now: number): number {
+  return Math.max(0, now - beat.transitionAt);
+}
+
+/** How long the claim itself has gone unrefreshed. Only meaningful once stale. */
+export function presenceSilenceMs(beat: Pick<PresenceBeat, "updatedAt">, now: number): number {
+  return Math.max(0, now - beat.updatedAt);
+}
+
+/**
+ * Whether a room may render this beat's `detail`.
+ *
+ * Room-gating is a rendering rule over one global map, not a second map: the
+ * activity is a fact about the agent's single runtime, and a per-conversation
+ * "what am I doing in *this* room" would be fiction for any agent doing one
+ * thing at a time.
+ */
+export function isPresenceBoundToConversation(
+  beat: Pick<PresenceBeat, "boundConversationId">,
+  conversationId: ScoutId,
+): boolean {
+  return beat.boundConversationId !== undefined && beat.boundConversationId === conversationId;
+}
+
+/** True once the beat has decayed past the stale window and should be dropped. */
+export function isPresenceGone(
+  beat: Pick<PresenceBeat, "staleAt">,
+  now: number,
+  options: PresenceLifecycleOptions = {},
+): boolean {
+  return presenceLifecycle(beat, now, options) === "gone";
+}

package/src/runtime-execution.ts

@@ -352,7 +352,8 @@ export function parseScoutRuntimeSpec(input: string): ScoutRuntimeSpecParseResul
       error: "runtime must be <harness>[/<model>[/<effort>]]",
     };
   }
-  const harness = parts[0]!.trim().toLowerCase();
+  const rawHarness = parts[0]!.trim().toLowerCase();
+  const harness = (rawHarness === "oc" ? "opencode" : rawHarness) as ScoutLaunchableHarness;
   if (!isScoutLaunchableHarness(harness)) {
     return {
       ok: false,
@@ -402,9 +403,19 @@ export type ScoutRuntimeTupleIssue = {
   message: string;
 };
 
+export function normalizeScoutLaunchableHarness(
+  value: string | null | undefined,
+): ScoutLaunchableHarness | null {
+  if (!value) return null;
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "oc") return "opencode";
+  return isScoutLaunchableHarness(normalized) ? normalized : null;
+}
+
 export function isScoutLaunchableHarness(value: string | null | undefined): value is ScoutLaunchableHarness {
-  return Boolean(value)
-    && SCOUT_LAUNCHABLE_HARNESSES.includes(value!.trim().toLowerCase() as ScoutLaunchableHarness);
+  if (!value) return false;
+  const normalized = value.trim().toLowerCase();
+  return normalized === "oc" || SCOUT_LAUNCHABLE_HARNESSES.includes(normalized as ScoutLaunchableHarness);
 }
 
 export function normalizeScoutReasoningEffort(
@@ -472,7 +483,8 @@ export function validateScoutRuntimeTuple(
   input: ScoutRuntimeTuple,
   catalog?: Pick<ScoutRuntimeCapabilityCatalog, "models" | "efforts">,
 ): ScoutRuntimeTupleIssue[] {
-  const harness = input.harness?.trim().toLowerCase();
+  const rawHarness = input.harness?.trim().toLowerCase();
+  const harness = rawHarness === "oc" ? "opencode" : rawHarness;
   const model = input.model?.trim();
   const effortRaw = input.reasoningEffort?.trim();
   const issues: ScoutRuntimeTupleIssue[] = [];
@@ -523,7 +535,8 @@ export function validateScoutRuntimeTuple(
   const modelSelectableHarness = harness === "claude"
     || harness === "codex"
     || harness === "grok"
-    || harness === "grok-acp";
+    || harness === "grok-acp"
+    || harness === "opencode";
   if (model && harness && !modelSelectableHarness) {
     issues.push({
       code: "unsupported_model_dimension",

package/src/runtime-profiles.ts

@@ -14,6 +14,8 @@ export const SCOUT_RESERVED_RUNTIME_PROFILE_IDS = [
   "kimi",
   "grok",
   "opus",
+  "oc",
+  "opencode",
 ] as const;
 
 export type ScoutReservedRuntimeProfileId =

package/src/terminal-host-topology.ts

@@ -13,8 +13,11 @@
  * The server builds this from `herdr --session <n> workspace list`,
  * `tab list`, and `pane list` JSON, plus the per-tab layout geometry from
  * `herdr --session <n> api snapshot`. A session whose server is stopped
- * projects as `{ running: false, workspaces: [] }` — an ordinary state, not
- * an error.
+ * projects from its persisted `session.json` instead — same shape, marked by
+ * `running: false` and `savedAt`; geometry, terminal ids, and live agent
+ * status are simply absent from a persisted projection. A session with no
+ * persisted state projects as `{ running: false, workspaces: [] }` — an
+ * ordinary state, not an error.
  */
 
 /** Agent state as herdr reports it, never as Scout infers it. */
@@ -125,6 +128,12 @@ export type HerdrSessionTopology = {
   workspaces: HerdrWorkspaceProjection[];
   /** Server wall-clock when the projection was observed. */
   observedAt: number;
+  /**
+   * When the projection came from the persisted session state (server stopped),
+   * the mtime of that state — the session's last known change. Absent when the
+   * projection is live.
+   */
+  savedAt?: number | null;
 };
 
 export function emptyHerdrSessionTopology(session: string, running: boolean): HerdrSessionTopology {