agent-working-memory 0.7.2 → 0.7.4

package/dist/core/salience.js

@@ -9,6 +9,31 @@
  *   - Thresholds are tunable per agent
  *   - Deterministic heuristics first, LLM augmentation optional
  */
+/**
+ * Auto-detect user-feedback memories: content that begins with a known user's
+ * name + a feedback verb. These memories represent direct human decisions and
+ * must never be discarded. Examples:
+ *   "Robert verbatim: 'LMS programs-first like CRM'"
+ *   "Katherine said the CEC cycle resets on promotion"
+ *   "Nancy directed Tier 1 has no grace period"
+ *
+ * Why this exists: the BM25 novelty check collapses near-duplicates regardless
+ * of whether the content is a NEW decision or a repeat observation. User
+ * feedback often shares terminology with prior memories ("LMS", "ECP",
+ * "officials") and gets discarded at salience 0.14 (verified in activity log
+ * 2026-05-06T19:08:47). Detecting "Robert said X" → canonical class bypasses
+ * the salience filter entirely.
+ *
+ * Tune the name list as new staff join. Pattern requires word boundary at
+ * start so "Roberta" or "Hannahs" don't match.
+ */
+const USER_FEEDBACK_PATTERN = /^(Robert|Katherine|Catherine|Nancy|Brandy|Brandi|Hannah|Marilyn|Kaylee|Pete|Abby|Tom|Wendy|Sita|Nick|Rob|Joan|Jennifer|Cindy|Jason|Alex|Molly)\s+(said|verbatim|feedback|asked|wants|prefers|requested|requested|directed|decided|confirmed|clarified|chose|specified|explained)\b/i;
+/** Returns true if the content looks like direct user feedback that should auto-promote to canonical. */
+export function detectUserFeedback(content) {
+    if (typeof content !== 'string' || content.length === 0)
+        return false;
+    return USER_FEEDBACK_PATTERN.test(content.trim());
+}
 /**
  * Weights for the salience scoring formula.
  * Novelty is the strongest signal — new information should always be stored.
@@ -25,14 +50,27 @@ const WEIGHTS = {
  * Rule-based salience scorer with full audit trail.
  */
 export function evaluateSalience(input, activeThreshold = 0.4, stagingThreshold = 0.2) {
+    // Auto-detect user feedback before scoring. If content matches the pattern,
+    // force eventType='user_feedback' and memoryClass='canonical'. This bypasses
+    // the BM25 novelty floor that was discarding pivotal user decisions at 0.14.
+    let resolvedEventType = input.eventType ?? 'observation';
+    let resolvedMemoryClass = input.memoryClass ?? 'working';
+    let autoPromoted = false;
+    if (detectUserFeedback(input.content)) {
+        resolvedEventType = 'user_feedback';
+        resolvedMemoryClass = 'canonical';
+        autoPromoted = true;
+    }
     const features = {
         surprise: input.surprise ?? 0,
         decisionMade: input.decisionMade ?? false,
         causalDepth: input.causalDepth ?? 0,
         resolutionEffort: input.resolutionEffort ?? 0,
-        eventType: input.eventType ?? 'observation',
+        eventType: resolvedEventType,
     };
     const reasonCodes = [];
+    if (autoPromoted)
+        reasonCodes.push('auto:user_feedback');
     // Novelty: 1.0 = completely new info, 0 = exact duplicate exists
     // Default to 0.8 (assume mostly novel) when caller doesn't check
     const novelty = input.novelty ?? 0.8;
@@ -73,11 +111,15 @@ export function evaluateSalience(input, activeThreshold = 0.4, stagingThreshold
             typeBonus = 0.2;
             reasonCodes.push('event:causal');
             break;
+        case 'user_feedback':
+            typeBonus = 0.3;
+            reasonCodes.push('event:user_feedback');
+            break;
         case 'observation': break;
     }
     let score = Math.min(surpriseScore + decisionScore + causalScore + effortScore + noveltyScore + typeBonus, 1.0);
     // Memory class overrides
-    const memoryClass = input.memoryClass ?? 'working';
+    const memoryClass = resolvedMemoryClass;
     if (memoryClass === 'canonical') {
         // Canonical memories: salience floor of 0.7, never go to staging
         score = Math.max(score, 0.7);
@@ -128,16 +170,35 @@ export function computeNovelty(store, agentId, concept, content) {
         // searchBM25WithRank normalizes scores to 0..1 via |rank|/(1+|rank|).
         // Higher score = stronger match = less novel.
         const topScore = results[0].bm25Score;
-        // Penalize exact concept string duplicates — if any result has the same concept,
-        // heavily reduce novelty to prevent hub toxicity from repeated task_end summaries
+        // Quadratic dampening (1 - topScore²) so mid-range matches don't kill novelty.
+        // Old curve was linear (1 - topScore) which floored at 0.1 for almost any match
+        // in a populated DB, killing the salience signal.
+        // Curve comparison (topScore → novelty):
+        //   0.30 → 0.91 (different topic — strong novelty)
+        //   0.60 → 0.64 (loosely related — partial credit)
+        //   0.80 → 0.36 (related but distinct — meaningful signal)
+        //   0.95 → 0.10 (near-dupe — still suppress)
+        const baseNovelty = 1.0 - topScore * topScore;
+        // Concept penalty scoped to recent matches only — re-using the same concept
+        // string for a NEW topic months later shouldn't be punished. Penalty was 0.4
+        // (too harsh); now 0.3 and only applies if any matched result is < 30 days old.
         const conceptLower = conceptStr.toLowerCase().trim();
-        const exactConceptMatch = results.some(r => r.engram?.concept?.toLowerCase().trim() === conceptLower);
-        const conceptPenalty = exactConceptMatch ? 0.4 : 0;
-        // Continuous novelty: inversely proportional to BM25 similarity
-        // Maps topScore (0..1) → novelty (0.1..0.95) using a smooth curve
-        // Floor at 0.1 (never zero — even duplicates might have new context)
-        // Ceiling at 0.95 (never 1.0 — always a tiny chance of overlap)
-        return Math.max(0.1, Math.min(0.95, 1.0 - topScore - conceptPenalty));
+        const cutoffMs = Date.now() - 30 * 24 * 60 * 60 * 1000;
+        const exactConceptRecent = results.some(r => {
+            if (r.engram?.concept?.toLowerCase().trim() !== conceptLower)
+                return false;
+            const created = r.engram?.createdAt;
+            if (!created)
+                return true; // No timestamp — treat as recent (conservative)
+            const createdMs = created instanceof Date
+                ? created.getTime()
+                : typeof created === 'number' ? created : Date.parse(created);
+            return Number.isFinite(createdMs) && createdMs >= cutoffMs;
+        });
+        const conceptPenalty = exactConceptRecent ? 0.3 : 0;
+        // Floor lowered to 0.05 (was 0.10) so true duplicates can score near-zero
+        // and clearly stay below stagingThreshold (0.2). Ceiling unchanged.
+        return Math.max(0.05, Math.min(0.95, baseNovelty - conceptPenalty));
     }
     catch {
         // If BM25 search fails (e.g., FTS not ready), assume novel
@@ -167,11 +228,25 @@ export function computeNoveltyWithMatch(store, agentId, concept, content, worksp
         allResults.sort((a, b) => b.bm25Score - a.bm25Score);
         const top = allResults[0];
         const topScore = top.bm25Score;
-        // Concept penalty for exact duplicates
+        // Quadratic dampening — see computeNovelty for curve rationale
+        const baseNovelty = 1.0 - topScore * topScore;
+        // Recent-only concept penalty (30d window)
         const conceptLower = conceptStr.toLowerCase().trim();
-        const exactMatch = allResults.some(r => r.engram?.concept?.toLowerCase().trim() === conceptLower);
-        const conceptPenalty = exactMatch ? 0.4 : 0;
-        const novelty = Math.max(0.1, Math.min(0.95, 1.0 - topScore - conceptPenalty));
+        const cutoffMs = Date.now() - 30 * 24 * 60 * 60 * 1000;
+        const exactConceptRecent = allResults.some(r => {
+            const eng = r.engram;
+            if (eng?.concept?.toLowerCase().trim() !== conceptLower)
+                return false;
+            const created = eng?.createdAt;
+            if (!created)
+                return true;
+            const createdMs = created instanceof Date
+                ? created.getTime()
+                : typeof created === 'number' ? created : Date.parse(created);
+            return Number.isFinite(createdMs) && createdMs >= cutoffMs;
+        });
+        const conceptPenalty = exactConceptRecent ? 0.3 : 0;
+        const novelty = Math.max(0.05, Math.min(0.95, baseNovelty - conceptPenalty));
         return { novelty, matchedEngramId: top.engram.id, matchScore: topScore };
     }
     catch {

package/dist/core/salience.js.map

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

package/dist/index.js

@@ -175,7 +175,7 @@ async function main() {
     getExpander().catch(err => console.warn('Query expander model unavailable:', err.message));
     // Start server
     await app.listen({ port: PORT, host: '0.0.0.0' });
-    console.log(`AgentWorkingMemory v0.7.2 listening on port ${PORT}`);
+    console.log(`AgentWorkingMemory v0.7.4 listening on port ${PORT}`);
     // Graceful shutdown
     const shutdown = async () => {
         clearInterval(backupTimer);

package/dist/mcp.js

@@ -71,7 +71,7 @@ import { queryPeerDecisions, formatPeerDecisions } from './coordination/peer-dec
 const INCOGNITO = process.env.AWM_INCOGNITO === '1' || process.env.AWM_INCOGNITO === 'true';
 if (INCOGNITO) {
     console.error('AWM: incognito mode — all memory tools disabled, nothing will be recorded');
-    const server = new McpServer({ name: 'agent-working-memory', version: '0.7.2' });
+    const server = new McpServer({ name: 'agent-working-memory', version: '0.7.4' });
     const transport = new StdioServerTransport();
     server.connect(transport).catch(err => {
         console.error('MCP server failed:', err);
@@ -102,7 +102,7 @@ else {
     let coordDb = null;
     const server = new McpServer({
         name: 'agent-working-memory',
-        version: '0.7.2',
+        version: '0.7.4',
     });
     server.registerResource('awm-overview', 'awm://server/overview', {
         title: 'AWM Overview',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-working-memory",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "Cognitive memory layer for AI agents — activation-based retrieval, salience filtering, associative connections",
   "type": "module",
   "main": "dist/index.js",

package/src/api/routes.ts

@@ -705,7 +705,7 @@ export function registerRoutes(app: FastifyInstance, deps: MemoryDeps): void {
     const base: Record<string, unknown> = {
       status: 'ok',
       timestamp: new Date().toISOString(),
-      version: '0.7.2',
+      version: '0.7.4',
       coordination: coordEnabled,
     };
     if (coordEnabled) {

package/src/cli.ts

@@ -334,7 +334,7 @@ async function exportMemories() {
   const agents = [...new Set(memories.map((m: any) => m.agent_id))];
 
   const exportData = {
-    version: '0.7.2',
+    version: '0.7.4',
     exported_at: new Date().toISOString(),
     source_db: dbPath,
     agent_filter: agentFilter,

package/src/coordination/index.ts

@@ -11,7 +11,7 @@ import type { EngramStore } from '../storage/sqlite.js';
 import { ZodError } from 'zod';
 import { initCoordinationTables } from './schema.js';
 import { registerCoordinationRoutes } from './routes.js';
-import { cleanSlate, pruneOldHeartbeats, purgeDeadAgents } from './stale.js';
+import { cleanSlate, pruneOldHeartbeats, purgeDeadAgents, cleanupStale } from './stale.js';
 import { createWriteMutex, needsWriteLock } from './write-mutex.js';
 import { createEventBus, type CoordinationEventBus } from './events.js';
 import { loadPlugins, teardownPlugins } from './plugin-loader.js';
@@ -106,6 +106,25 @@ export function initCoordination(app: FastifyInstance, db: Database.Database, st
     }, 60 * 60 * 1000),
   );
 
+  // Periodic stale-agent cleanup every 5 min with 600s threshold (10 min idle).
+  // Forgiving for long-running edits — workers should pulse every 60s during active
+  // work, so 10 min without a pulse is genuinely dead. This catches the
+  // "alive but not seeing each other" pattern where workers' processes persist
+  // but their heartbeats stop. Without this scheduled, only an explicit
+  // POST /stale/cleanup call (made by the coordinator agent on startup) ever
+  // fires cleanupStale, leaving zombie agents accumulating between coordinator
+  // sessions.
+  cleanupIntervals.push(
+    setInterval(() => {
+      try {
+        const result = cleanupStale(db, 600);
+        if (result.cleaned > 0) {
+          console.log(`  [stale-cleanup] auto-cleaned ${result.stale.length} stale agent(s), ${result.cleaned} resource(s) released`);
+        }
+      } catch { /* db may be closed */ }
+    }, 5 * 60 * 1000),
+  );
+
   // Periodic channel liveness probe every 60s — mark unreachable sessions as disconnected
   cleanupIntervals.push(
     setInterval(async () => {

package/src/coordination/routes.ts

@@ -33,6 +33,45 @@ function coordLog(msg: string): void {
   console.log(`${ts()} [coord] ${msg}`);
 }
 
+/**
+ * In-process counters for channel push telemetry.
+ * Reset on coordinator restart — intended for short-window observability
+ * ("ship it, watch numbers for a day"). Persistent counters would need a
+ * coord_metrics table; deferred until we know what's worth keeping.
+ *
+ * Fields:
+ *   attempts            — every call to deliverToChannel (HTTP push to worker)
+ *   delivered           — fetch returned 2xx
+ *   failed_http         — fetch returned non-2xx (worker reachable but rejected)
+ *   failed_unreachable  — fetch threw (timeout, ECONNREFUSED, etc.)
+ *   no_session          — push intent existed but no connected session
+ *   fallback_mailbox    — push failed, message queued to mailbox instead
+ *   session_disconnects — session marked 'disconnected' after delivery failure
+ */
+interface ChannelMetrics {
+  attempts: number;
+  delivered: number;
+  failed_http: number;
+  failed_unreachable: number;
+  no_session: number;
+  fallback_mailbox: number;
+  session_disconnects: number;
+  started_at: number;
+}
+
+function createChannelMetrics(): ChannelMetrics {
+  return {
+    attempts: 0,
+    delivered: 0,
+    failed_http: 0,
+    failed_unreachable: 0,
+    no_session: 0,
+    fallback_mailbox: 0,
+    session_disconnects: 0,
+    started_at: Date.now(),
+  };
+}
+
 /**
  * Optional session-token check.
  * If X-Session-Token header is present and doesn't match the stored token → returns false (caller should 403).
@@ -47,6 +86,9 @@ function sessionTokenOk(db: Database.Database, agentId: string, req: import('fas
 }
 
 export function registerCoordinationRoutes(app: FastifyInstance, db: Database.Database, store?: EngramStore, eventBus?: import('./events.js').CoordinationEventBus): void {
+  // Channel push telemetry — process-scoped counters. See ChannelMetrics docs above.
+  const channelMetrics = createChannelMetrics();
+
 
   // Request logging — one line per request with method, url, status, response time
   app.addHook('onRequest', async (request) => {
@@ -132,9 +174,14 @@ export function registerCoordinationRoutes(app: FastifyInstance, db: Database.Da
       const sessionToken = wasDead ? randomUUID() : (
         (db.prepare(`SELECT session_token FROM coord_agents WHERE id = ?`).get(existing.id) as { session_token: string | null }).session_token ?? randomUUID()
       );
+      // role IS updated on every checkin — agents know their own role and
+      // re-registrations may correct stale role values (e.g., when an old
+      // coord_agents row was inserted with role='orchestrator' before the
+      // 'coordinator' role was canonical, or when the channel-server's
+      // hardcoded role='worker' overwrote a real role).
       db.prepare(
-        `UPDATE coord_agents SET last_seen = datetime('now'), status = CASE WHEN status = 'dead' THEN 'idle' ELSE status END, pid = COALESCE(?, pid), capabilities = COALESCE(?, capabilities), workspace = COALESCE(?, workspace), session_token = ? WHERE id = ?`
-      ).run(pid ?? null, capsJson, workspace ?? null, sessionToken, existing.id);
+        `UPDATE coord_agents SET last_seen = datetime('now'), status = CASE WHEN status = 'dead' THEN 'idle' ELSE status END, role = ?, pid = COALESCE(?, pid), capabilities = COALESCE(?, capabilities), workspace = COALESCE(?, workspace), session_token = ? WHERE id = ?`
+      ).run(role, pid ?? null, capsJson, workspace ?? null, sessionToken, existing.id);
 
       const eventType = wasDead ? 'reconnected' : 'heartbeat';
       const detail = wasDead ? `${name} reconnected (was dead)` : `heartbeat from ${name}`;
@@ -544,6 +591,9 @@ export function registerCoordinationRoutes(app: FastifyInstance, db: Database.Da
             `UPDATE coord_channel_sessions SET last_push_at = datetime('now'), push_count = push_count + 1 WHERE agent_id = ?`
           ).run(agentId);
         }
+      } else {
+        // Session disappeared between intent record and delivery — race or rapid disconnect
+        channelMetrics.no_session++;
       }
     }
 
@@ -1359,28 +1409,41 @@ export function registerCoordinationRoutes(app: FastifyInstance, db: Database.Da
     const q = workersQuerySchema.safeParse(req.query);
     const { capability, status: filterStatus, workspace } = q.success ? q.data : { capability: undefined, status: undefined, workspace: undefined };
 
+    // Join with coord_channel_sessions so the coordinator agent can compute
+    // alive=true for workers that have a connected channel session even when
+    // their /pulse is stale. Without this, /workers under-reports liveness
+    // during long tool-call sequences where the worker is processing but
+    // hasn't called /pulse for >5min — leading to false-positive duplicate
+    // spawns. Channel sessions get probed every 60s (coordination/index.ts:111),
+    // so a stale channel-server.js gets status='disconnected' within 60-120s.
     let workers = workspace
       ? db.prepare(
-          `SELECT id, name, role, status, current_task, capabilities, workspace, last_seen,
-                  ROUND((julianday('now') - julianday(last_seen)) * 86400) AS seconds_since_seen
-           FROM coord_agents
-           WHERE status != 'dead' AND role NOT IN ('orchestrator', 'coordinator') AND workspace = ?
-           ORDER BY name LIMIT 200`
+          `SELECT a.id, a.name, a.role, a.status, a.current_task, a.capabilities, a.workspace, a.last_seen,
+                  ROUND((julianday('now') - julianday(a.last_seen)) * 86400) AS seconds_since_seen,
+                  cs.status AS channel_status, cs.last_push_at AS channel_last_push
+           FROM coord_agents a
+           LEFT JOIN coord_channel_sessions cs ON cs.agent_id = a.id
+           WHERE a.status != 'dead' AND a.role NOT IN ('orchestrator', 'coordinator') AND a.workspace = ?
+           ORDER BY a.name LIMIT 200`
         ).all(workspace) as Array<{
           id: string; name: string; role: string; status: string;
           current_task: string | null; capabilities: string | null;
           workspace: string | null; last_seen: string; seconds_since_seen: number;
+          channel_status: string | null; channel_last_push: string | null;
         }>
       : db.prepare(
-          `SELECT id, name, role, status, current_task, capabilities, workspace, last_seen,
-                  ROUND((julianday('now') - julianday(last_seen)) * 86400) AS seconds_since_seen
-           FROM coord_agents
-           WHERE status != 'dead' AND role NOT IN ('orchestrator', 'coordinator')
-           ORDER BY name LIMIT 200`
+          `SELECT a.id, a.name, a.role, a.status, a.current_task, a.capabilities, a.workspace, a.last_seen,
+                  ROUND((julianday('now') - julianday(a.last_seen)) * 86400) AS seconds_since_seen,
+                  cs.status AS channel_status, cs.last_push_at AS channel_last_push
+           FROM coord_agents a
+           LEFT JOIN coord_channel_sessions cs ON cs.agent_id = a.id
+           WHERE a.status != 'dead' AND a.role NOT IN ('orchestrator', 'coordinator')
+           ORDER BY a.name LIMIT 200`
         ).all() as Array<{
           id: string; name: string; role: string; status: string;
           current_task: string | null; capabilities: string | null;
           workspace: string | null; last_seen: string; seconds_since_seen: number;
+          channel_status: string | null; channel_last_push: string | null;
         }>;
 
     if (capability) {
@@ -1409,7 +1472,14 @@ export function registerCoordinationRoutes(app: FastifyInstance, db: Database.Da
       workspace: w.workspace,
       lastSeen: w.last_seen,
       secondsSinceSeen: w.seconds_since_seen,
-      alive: w.seconds_since_seen < 300,
+      // alive = recent /pulse OR connected channel session.
+      // Channel sessions get probed every 60s and marked 'disconnected'
+      // when unreachable, so a connected session is reliable proof of life
+      // even during long tool sequences where the worker hasn't pulsed.
+      // Prevents duplicate worker spawns when /pulse is stale but worker is busy.
+      alive: w.seconds_since_seen < 300 || w.channel_status === 'connected',
+      channelStatus: w.channel_status,
+      channelLastPush: w.channel_last_push,
     }));
 
     return reply.send({
@@ -1691,6 +1761,32 @@ export function registerCoordinationRoutes(app: FastifyInstance, db: Database.Da
     lines.push('# TYPE coord_uptime_seconds gauge');
     lines.push(`coord_uptime_seconds ${uptime}`);
 
+    // ─── Channel push telemetry (process-scoped, reset on restart) ───
+    lines.push('# HELP coord_channel_push_attempts_total Total channel push attempts since coordinator startup');
+    lines.push('# TYPE coord_channel_push_attempts_total counter');
+    lines.push(`coord_channel_push_attempts_total ${channelMetrics.attempts}`);
+
+    lines.push('# HELP coord_channel_push_delivered_total Successful channel deliveries');
+    lines.push('# TYPE coord_channel_push_delivered_total counter');
+    lines.push(`coord_channel_push_delivered_total ${channelMetrics.delivered}`);
+
+    lines.push('# HELP coord_channel_push_failed_total Failed channel deliveries by reason');
+    lines.push('# TYPE coord_channel_push_failed_total counter');
+    lines.push(`coord_channel_push_failed_total{reason="http"} ${channelMetrics.failed_http}`);
+    lines.push(`coord_channel_push_failed_total{reason="unreachable"} ${channelMetrics.failed_unreachable}`);
+
+    lines.push('# HELP coord_channel_no_session_total Push attempts where agent had no connected session');
+    lines.push('# TYPE coord_channel_no_session_total counter');
+    lines.push(`coord_channel_no_session_total ${channelMetrics.no_session}`);
+
+    lines.push('# HELP coord_channel_fallback_mailbox_total Pushes that fell back to mailbox after delivery failure');
+    lines.push('# TYPE coord_channel_fallback_mailbox_total counter');
+    lines.push(`coord_channel_fallback_mailbox_total ${channelMetrics.fallback_mailbox}`);
+
+    lines.push('# HELP coord_channel_session_disconnects_total Sessions marked disconnected after delivery failure');
+    lines.push('# TYPE coord_channel_session_disconnects_total counter');
+    lines.push(`coord_channel_session_disconnects_total ${channelMetrics.session_disconnects}`);
+
     return reply.type('text/plain; version=0.0.4; charset=utf-8').send(lines.join('\n') + '\n');
   });
 
@@ -1800,6 +1896,7 @@ export function registerCoordinationRoutes(app: FastifyInstance, db: Database.Da
   async function deliverToChannel(
     agentId: string, channelUrl: string, content: string, meta?: Record<string, string>
   ): Promise<{ delivered: boolean; error?: string }> {
+    channelMetrics.attempts++;
     try {
       const res = await fetch(`${channelUrl}/push`, {
         method: 'POST',
@@ -1808,11 +1905,15 @@ export function registerCoordinationRoutes(app: FastifyInstance, db: Database.Da
         signal: AbortSignal.timeout(5000),
       });
       if (!res.ok) {
+        channelMetrics.failed_http++;
         return { delivered: false, error: `channel returned ${res.status}` };
       }
+      channelMetrics.delivered++;
       return { delivered: true };
     } catch (err) {
       // Connection refused / timeout → worker process is dead, mark session disconnected
+      channelMetrics.failed_unreachable++;
+      channelMetrics.session_disconnects++;
       db.prepare(
         `UPDATE coord_channel_sessions SET status = 'disconnected' WHERE agent_id = ?`
       ).run(agentId);
@@ -1822,11 +1923,40 @@ export function registerCoordinationRoutes(app: FastifyInstance, db: Database.Da
     }
   }
 
-  /** POST /channel/push — Push a message to an agent. Tries live delivery first, falls back to mailbox queue. */
+  /** POST /channel/push — Push a message to an agent. Tries live delivery first, falls back to mailbox queue.
+   *
+   * Two addressing modes:
+   *   - {agentId, message}                — direct UUID
+   *   - {role, workspace, message}        — server resolves to most-recently-seen alive agent
+   *                                          matching role+workspace. Used by workers to notify
+   *                                          coordinator (whose UUID changes across restarts).
+   */
   app.post('/channel/push', async (request, reply) => {
     const parsed = channelPushSchema.safeParse(request.body);
     if (!parsed.success) return reply.status(400).send({ error: parsed.error.flatten() });
-    const { agentId, message } = parsed.data;
+    const { message } = parsed.data;
+    let { agentId } = parsed.data;
+
+    // Role-based addressing — resolve to a concrete agentId
+    if (!agentId && parsed.data.role && parsed.data.workspace) {
+      const resolved = db.prepare(
+        `SELECT id FROM coord_agents
+         WHERE role = ? AND workspace = ? AND status != 'dead'
+         ORDER BY last_seen DESC
+         LIMIT 1`
+      ).get(parsed.data.role, parsed.data.workspace) as { id: string } | undefined;
+      if (!resolved) {
+        return reply.status(404).send({
+          error: `No alive agent found for role='${parsed.data.role}' workspace='${parsed.data.workspace}'`,
+        });
+      }
+      agentId = resolved.id;
+    }
+
+    // Type narrowing — Zod refine guarantees agentId is set by this point,
+    // but TypeScript can't see through the refine. This guard is unreachable
+    // in practice (would have 400'd earlier).
+    if (!agentId) return reply.status(400).send({ error: 'Internal: agentId resolution failed' });
 
     const agent = db.prepare(`SELECT name, workspace FROM coord_agents WHERE id = ?`).get(agentId) as { name: string; workspace: string | null } | undefined;
     if (!agent) return reply.status(404).send({ error: 'Agent not found' });
@@ -1853,6 +1983,10 @@ export function registerCoordinationRoutes(app: FastifyInstance, db: Database.Da
         return reply.send({ ok: true, delivered: true, channelId: session.channel_id });
       }
       // Live delivery failed — fall through to mailbox
+      channelMetrics.fallback_mailbox++;
+    } else {
+      // No connected session — push went straight to mailbox
+      channelMetrics.no_session++;
     }
 
     // Queue to mailbox (delivered on next /next poll)
@@ -1914,4 +2048,48 @@ export function registerCoordinationRoutes(app: FastifyInstance, db: Database.Da
 
     return reply.send({ probed: results.length, alive, dead, results });
   });
+
+  /**
+   * GET /telemetry/channels — Channel push delivery telemetry.
+   *
+   * Counters reset on coordinator restart (in-process). Use this to answer:
+   *   "Are channels reliable enough to depend on, or do we need a polling fallback?"
+   *
+   * Response shape:
+   *   {
+   *     since: ISO timestamp of when counters started,
+   *     uptime_seconds: number,
+   *     attempts, delivered, failed_http, failed_unreachable,
+   *     no_session, fallback_mailbox, session_disconnects: number,
+   *     delivery_rate: 0..1 (delivered / attempts) or null if zero attempts,
+   *     per_agent: [{ agent_name, push_count, last_push_at, status }]
+   *   }
+   */
+  app.get('/telemetry/channels', async (_request, reply) => {
+    const perAgent = db.prepare(`
+      SELECT a.name AS agent_name, cs.push_count, cs.last_push_at, cs.status,
+             cs.connected_at
+      FROM coord_channel_sessions cs
+      JOIN coord_agents a ON a.id = cs.agent_id
+      ORDER BY cs.push_count DESC, cs.connected_at DESC
+    `).all();
+
+    const deliveryRate = channelMetrics.attempts > 0
+      ? channelMetrics.delivered / channelMetrics.attempts
+      : null;
+
+    return reply.send({
+      since: new Date(channelMetrics.started_at).toISOString(),
+      uptime_seconds: Math.round((Date.now() - channelMetrics.started_at) / 1000),
+      attempts: channelMetrics.attempts,
+      delivered: channelMetrics.delivered,
+      failed_http: channelMetrics.failed_http,
+      failed_unreachable: channelMetrics.failed_unreachable,
+      no_session: channelMetrics.no_session,
+      fallback_mailbox: channelMetrics.fallback_mailbox,
+      session_disconnects: channelMetrics.session_disconnects,
+      delivery_rate: deliveryRate,
+      per_agent: perAgent,
+    });
+  });
 }

package/src/coordination/schemas.ts

@@ -210,10 +210,25 @@ export const channelDeregisterSchema = z.object({
   agentId: z.string().uuid(),
 });
 
+/**
+ * Push to an agent's channel session. Accepts either:
+ *   - agentId (direct addressing — caller knows the UUID)
+ *   - role + workspace (role-based addressing — server resolves to the most
+ *     recently-seen alive agent matching that role and workspace)
+ *
+ * Role-based addressing is the right choice when a worker wants to notify the
+ * coordinator: workers don't know the coordinator's UUID (it changes across
+ * coordinator restarts) but they do know the role and their own workspace.
+ */
 export const channelPushSchema = z.object({
-  agentId: z.string().uuid(),
+  agentId: z.string().uuid().optional(),
+  role: agentRoleEnum.optional(),
+  workspace: z.string().min(1).max(50).optional(),
   message: z.string().min(1).max(10000),
-});
+}).refine(
+  (d) => d.agentId !== undefined || (d.role !== undefined && d.workspace !== undefined),
+  { message: 'Must provide either agentId, or both role and workspace' }
+);
 
 // ─── Stats ─────────────────────────────────────────────────────