@volter/supercode-orchestrator 0.5.79 → 0.5.81

package/board/machine-fleet.mjs

@@ -1,46 +1,41 @@
-// The fleet as each machine the board works on answers for itself: its panes (`harness.v1.panes.list`) and the harness
-// session beneath each live pane's process (`harness.v1.sessions.activity_under`). This is the reading the machine's
-// connector publishes to Teams, taken at its source. Each machine's reading also says what a board launch needs of it
-// (`capabilities`: its board process guard's harnesses, and whether it has the keyed launch door). Teams' session feed
-// is for viewers; dispatch never waits on it (D137, D138).
+// The fleet as each machine the board works on keeps it: its panes, the harness session beneath each live pane's
+// process, and what a board launch needs of it (`capabilities`: its board process guard's harnesses, and whether it has
+// the keyed launch door). Each machine pushes this as its record (order 3 PR 3, @volter/teams machine-records): this
+// machine's daemon holds every record it follows, with how current each is, and the owner reads them all in one local
+// call. No machine is asked at call time. Teams' session feed is for viewers; dispatch never waits on it (D137, D138).
 //
-// Every machine is read at once, each within DEADLINE_MS, in this process through its door (doors.mjs), so one hung machine or relay costs a
-// reading that long, not the sum of them. A machine that answered is `online`. A remote machine that did not is
-// `unknown` (its runs are kept, as an unread machine's always were), unless the relay positively answered that it is
-// not linked (`machine_offline`): then it is offline. This machine's door not answering is no reading at all.
+// A machine whose record is current is `online`. One whose record is out of date (its stream closed, its panes or the
+// sessions under them not read) or was never read is `unknown` (its runs are kept, as an unread machine's always were), unless its record says it was unlinked from the
+// team: then it is offline. This machine's own record not being given is no reading at all.
 import { noteStep } from '@volter/supercode-harness-sdk/slow-log';
 import { machineCall } from './doors.mjs';
-
 const DEADLINE_MS = 10_000;
 const within = (promise, ms) => Promise.race([promise, new Promise((_, reject) => setTimeout(() => reject(Object.assign(new Error(`no answer within ${ms} ms`), { code: 'timeout' })), ms).unref?.())]);
-
-// One machine's reading, through its door in this process (doors.mjs): its panes, what a board launch needs of it, and
-// the session under each live pane.
-async function readOne(name, at) {
-  const panes = await machineCall(at, 'harness.v1.panes.list', {});
-  // What a board launch needs of this machine: its board process guard (describe), and its keyed launch door, asked
-  // for a key no launch has (an answer of null is the door; an unknown method is its absence)
-  const description = await machineCall(at, 'harness.v1.machine.describe', {}).catch(() => null);
-  const keyed = await machineCall(at, 'harness.v1.launches.get', { key: 'board-capability-reading' }).then(() => null, (error) => String(error?.message ?? error).slice(0, 200));
-  const capabilities = { guard: description?.boardProcessPolicy?.version === 1 ? description.boardProcessPolicy.harnesses ?? [] : [], launches: keyed === null, launchesRefused: keyed };
-  const live = (Array.isArray(panes) ? panes : []).filter((pane) => !pane.dead && pane.pid);
-  // the session under each live pane: the harness stream, an operator's; a caller the machine admits only to its panes
-  // (a box another custodian enrolled, granting view and control) reads its panes and no sessions
-  let activities = [], sessionsUnread = null;
-  if (live.length) {
-    try { activities = (await machineCall(at, 'harness.v1.sessions.activity_under', { pids: live.map((pane) => pane.pid) }))?.activities ?? []; }
-    catch (error) { sessionsUnread = String(error?.message ?? error).slice(0, 200); }
-  }
-  return { machine: name, panes, activities, capabilities, sessionsUnread };
+// One machine's reading, from its held record: its panes, what a board launch needs of it, and the session under each
+// live pane.
+function readOne(name, held) {
+  if (!held) return { machine: name, error: 'this machine follows no record of it (not linked to the team, or not yet read)', code: 'unavailable' };
+  if (held.stream === 'unlinked') return { machine: name, error: held.why ?? 'unlinked from the team', code: 'machine_offline' };
+  if (!held.record) return { machine: name, error: `its record was never read: ${held.why ?? 'no reason given'}`, code: 'unavailable' };
+  if (held.stream !== 'open' && held.stream !== 'self') return { machine: name, error: `its record may be out of date: its stream is ${held.stream} since ${held.since ? new Date(held.since).toISOString() : 'unknown'} (${held.why ?? 'no reason given'})`, code: 'stale' };
+  const record = held.record;
+  // panes not read, or read without the sessions under them (or while the session index is lost), are no reading of
+  // what runs there: the machine is unknown, never one whose panes or sessions are absent (refused is not absent)
+  const notCurrent = record.unread?.panes ?? record.unread?.sessions_index ?? record.unread?.sessions_index_parts ?? record.unread?.claude_registry_watch ?? record.unread?.pane_exits_watch ?? record.panes?.activities_omitted ?? record.panes?.sessions_unread ?? (record.panes ? null : 'its record holds no pane list');
+  if (notCurrent) return { machine: name, error: `its panes are not current: ${notCurrent}`, code: 'stale' };
+  const panes = record.panes?.panes ?? [];
+  const capabilities = record.capabilities ?? { guard: [], launches: false };
+  return { machine: name, panes, activities: record.panes?.activities ?? [], capabilities: { guard: capabilities.guard ?? [], launches: Boolean(capabilities.launches), launchesRefused: capabilities.launches ? null : 'its record names no keyed launch door' } };
 }
-
-/** One reading of `machines` (normalized names) and this machine, `local`: every machine at once, each bounded. */
+/** One reading of `machines` (normalized names) and this machine, `local`: every record, from this machine's daemon. */
 export async function readMachineFleet(machines, local) {
   const names = [...new Set([local, ...machines])];
   const started = performance.now();
-  const rows = await Promise.all(names.map((name) => within(readOne(name, name === local ? null : name), DEADLINE_MS)
-    .catch((error) => ({ machine: name, error: String(error?.message ?? error).slice(0, 300), code: error?.code ?? 'unavailable' }))));
-  noteStep(`fleet reading (${names.length} machine${names.length === 1 ? '' : 's'})`, performance.now() - started);
+  let held = null, heldError = null;
+  try { held = (await within(machineCall(null, 'harness.v1.machine.records', {}), DEADLINE_MS))?.records ?? {}; }
+  catch (error) { heldError = String(error?.message ?? error).slice(0, 300); }
+  const rows = names.map((name) => heldError ? { machine: name, error: `this machine's daemon did not give the records it holds: ${heldError}`, code: 'unavailable' } : readOne(name, held[name]));
+  noteStep(`fleet reading (${names.length} machine${names.length === 1 ? '' : 's'}, held records)`, performance.now() - started);
   // `panes`: each answering machine's live pane ids, whether or not a session was read in them
   const online = new Set(), unknown = new Set(), alive = new Set(), native = new Map(), sessions = [], capabilities = new Map(), panes = new Map();
   let localError = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-orchestrator",
-  "version": "0.5.79",
+  "version": "0.5.81",
   "type": "module",
   "description": "The orchestrator runtime over the Volter Harness ontology: one typed operational model whose folder is its serialization, read and written through the harness orchestration doors (docs/ORCHESTRATOR-IR.md)",
   "exports": {
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@volter/supercode-harness-sdk": "^0.3.60",
-    "@volter/teams": "0.2.28",
+    "@volter/teams": "0.2.30",
     "@volter/ztrack": "^2.4.23",
     "yaml": "^2.9.0"
   },