agent-coord-mcp 0.26.24 → 0.26.26

package/src/transports/types.ts

@@ -27,17 +27,32 @@
  * instead of reading the field, and a `string` discriminant cannot tell the
  * compiler that a branch was missed. Not a two-member union either — see (1).
  */
+/**
+ * ⟨q-ec020f6a⟩ LOCAL tmux-push was DELETED outright (0 of 13 live seats used it; keeping
+ * it meant a second delivery mechanism — hooks/tmux-pusher.mjs, now removed — plus a
+ * role-card precondition that halted every live herdr seat on a false requirement).
+ *
+ * `TMUX_PUSH` stays DEFINED AND EXPORTED, but OUT of `TransportKind`/`TRANSPORT_KINDS`, for
+ * exactly one reason: a marker written to disk before this change can still literally read
+ * `"tmux-push"`, and `isLocallyProbeable`/`isTmuxKind` below must keep classifying that
+ * HISTORICAL value correctly (never `"dead"` where it used to read `"unknown"`) even
+ * though nothing can construct a NEW one — `resolveTransport` has no case for it and
+ * `config.ts` refuses it. Classifying old data and constructing new data are different
+ * questions; removing it from the union answers only the second.
+ */
 export const TMUX_PUSH = "tmux-push" as const;
 export const TMUX_PUSH_REMOTE = "tmux-push-remote" as const;
 export const HERDR = "herdr" as const;
 
-export type TransportKind = typeof TMUX_PUSH | typeof TMUX_PUSH_REMOTE | typeof HERDR;
+export type TransportKind = typeof TMUX_PUSH_REMOTE | typeof HERDR;
 
-export const TRANSPORT_KINDS: readonly TransportKind[] = [TMUX_PUSH, TMUX_PUSH_REMOTE, HERDR] as const;
+export const TRANSPORT_KINDS: readonly TransportKind[] = [TMUX_PUSH_REMOTE, HERDR] as const;
 
 /**
- * The tmux family. Both members are delivered by a pusher process typing into a
- * pane; they differ in WHERE that pane is, which is why liveness splits below.
+ * The tmux family, for LIVENESS CLASSIFICATION of whatever a marker on disk says —
+ * including the historical, no-longer-constructible local kind (`TMUX_PUSH`, above).
+ * Both members are delivered by a pusher process typing into a pane; they differed in
+ * WHERE that pane was, which is why liveness splits below.
  *
  * THIS IS THE ONE PLACE THE TMUX LITERALS LIVE. Twelve call sites used to spell
  * them; they now ask.
@@ -87,6 +102,11 @@ export type TransportMarker = {
   target?: string;
   /** The original field. Still written. See `target`. */
   tmuxTarget?: string;
+  /**
+   * ⟨q-abd88dd4⟩ herdr only: why `pid` holds what it holds (see `herdrMarkerPid`). A herdr
+   * marker's pid is addressed to PRE-HERDR readers and is never liveness for this build.
+   */
+  pidWhy?: string;
   since: number;
   /**
    * Remote pushers run on a different machine; the local pid is meaningless,