@comput/pi-intercom 0.4.2 → 0.5.2

package/src/transport.ts

@@ -35,9 +35,20 @@ export function envelope(value: unknown): Envelope {
   return m;
 }
 export interface Endpoint { port: number; close(): Promise<void> }
-export async function listen(preferred: number | undefined, accept: (message: Envelope) => Promise<void>): Promise<Endpoint> {
+export async function listen(preferred: number | undefined, accept: (message: Envelope) => Promise<void>, health?: () => { version: 1; sessionId: string }): Promise<Endpoint> {
   const server = http.createServer(async (req, res) => {
     const reply = (status: number, data: unknown) => { if (!res.destroyed) { res.writeHead(status, { 'content-type': 'application/json', connection: 'close' }); res.end(JSON.stringify(data)); } };
+    if (req.method === 'GET' && req.url === '/intercom/health') {
+      try {
+        if (!health) reply(404, { error: 'health unavailable' });
+        else {
+          const identity = health();
+          if (identity.version !== 1 || typeof identity.sessionId !== 'string' || !identity.sessionId.trim() || identity.sessionId.length > 256) throw new Error('invalid health identity');
+          reply(200, { version: 1, sessionId: identity.sessionId });
+        }
+      } catch { reply(503, { error: 'health unavailable' }); }
+      req.resume(); return;
+    }
     if (req.method !== 'POST' || req.url !== '/intercom') { reply(404, { error: 'POST /intercom required' }); req.resume(); return; }
     let bytes = 0;
     const chunks: Buffer[] = [];

package/src/version.ts

@@ -0,0 +1,13 @@
+import { readFileSync } from 'node:fs';
+
+// Both src/ and dist/ sit directly below this package's own manifest. Capture
+// once at process startup, not from cwd or on each render after an update.
+function packageVersion(): string {
+  try {
+    const manifest = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+    const version: unknown = manifest.version;
+    if (typeof version === 'string' && version.length <= 64 && /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(version)) return version;
+  } catch { /* A display label must never prevent the monitor starting. */ }
+  return 'unknown';
+}
+export const INTERCOM_VERSION = packageVersion();

package/src/worker-status.ts

@@ -1,4 +1,5 @@
 import type { ObservationSnapshot } from './snapshot.js';
+import { currentConnection, sortWorkersByConnection } from './connections.js';
 
 const labels: Record<string, string> = {
   processing: 'Processing', thinking: 'Thinking', responding: 'Writing response',
@@ -46,15 +47,16 @@ export function workerStatusPage(snapshot: ObservationSnapshot, options: { name?
     roster = roster.filter(a => a.name.toLowerCase() === options.name!.toLowerCase());
     if (snapshot.config && !roster.length) throw new Error('Worker name not found in the retained snapshot');
   }
-  const workers: Array<Record<string, unknown>> = [];
+  const workers: Array<{ sessionId: string; [key: string]: unknown }> = [];
   const result = { version: 1, source: 'local-observations', generatedAt: new Date(now).toISOString(),
-    statusMeaning: 'Last observed, not live liveness or task completion. Reports are self-reported, not approval.',
+    statusMeaning: 'Activity is last observed, not task completion. Connectivity is a separate endpoint check, never proof of termination. Reports are self-reported, not approval.',
     truncated: snapshot.truncated, errors: snapshot.errors, totalInSnapshot: roster.length, offset,
     nextOffset: null as number | null, workers };
   for (const agent of roster.slice(offset, offset + limit)) {
     const report = snapshot.reports?.find(r => r.sessionId === agent.sessionId && r.status !== 'clear');
     const reportAge = report ? now - Date.parse(report.updatedAt) : NaN;
     const entry = { sessionId: agent.sessionId, name: agent.name, ...workerObservation(snapshot, agent.sessionId, now),
+      connection: currentConnection(agent.sessionId, snapshot.connections, now),
       report: report ? { status: report.status, summary: report.summary, updatedAt: report.updatedAt,
         ageSeconds: Number.isFinite(reportAge) && reportAge >= 0 ? Math.floor(reportAge / 1000) : null,
         selfReported: true } : null };
@@ -62,5 +64,7 @@ export function workerStatusPage(snapshot: ObservationSnapshot, options: { name?
     if (Buffer.byteLength(JSON.stringify(result, null, 2)) > 40000) { workers.pop(); break; }
   }
   if (offset + workers.length < roster.length) result.nextOffset = offset + workers.length;
+  // Page boundaries remain in saved roster order; disconnected entries sort last within the page.
+  workers.splice(0, workers.length, ...sortWorkersByConnection(workers, snapshot.connections, now));
   return result;
 }