@pingagent/sdk 0.1.14 → 0.1.15

package/bin/pingagent.js

@@ -25,12 +25,21 @@ import {
   TaskHandoffManager,
   TrustPolicyAuditManager,
   CollaborationEventManager,
+  CollaborationProjectionOutboxManager,
+  OperatorSeenStateManager,
   TrustRecommendationManager,
   getTrustRecommendationActionLabel,
   formatCapabilityCardSummary,
   defaultTrustPolicyDoc,
   normalizeTrustPolicyDoc,
   upsertTrustPolicyRecommendation,
+  summarizeSinceLastSeen,
+  buildDeliveryTimeline,
+  buildProjectionPreview,
+  listPendingDecisionViews,
+  deriveTransportHealth,
+  readTransportPreference,
+  switchTransportPreference,
   getActiveSessionFilePath,
   getSessionMapFilePath,
   getSessionBindingAlertsFilePath,
@@ -243,7 +252,16 @@ function formatSessionRow(session, selected) {
   const trust = session.trust_state || 'unknown';
   const unread = session.unread_count ?? 0;
   const who = truncateLine(session.remote_did || session.conversation_id || 'unknown', 40);
-  return `${marker} ${who} [${trust}] unread=${unread}${reconnect}`;
+  const seen = session.since_last_seen || {};
+  const sinceCount = (seen.new_external_messages ?? 0)
+    + (seen.new_conclusions ?? 0)
+    + (seen.new_handoffs ?? 0)
+    + (seen.new_decisions ?? 0)
+    + (seen.new_failures ?? 0)
+    + (seen.new_repairs ?? 0)
+    + (seen.new_projection_failures ?? 0);
+  const sinceBadge = sinceCount > 0 ? ` new=${sinceCount}` : '';
+  return `${marker} ${who} [${trust}] unread=${unread}${sinceBadge}${reconnect}`;
 }
 
 function formatMessageRow(message) {
@@ -346,6 +364,21 @@ function buildHostState(identityPath, selectedSessionKey = null, historyPageInde
     const alertByConversation = new Map(alerts.map((row) => [row.conversation_id, row]));
     const activeChatSession = readCurrentActiveSessionKey();
     const ingressRuntime = readIngressRuntimeStatus();
+    const transportPreference = readTransportPreference();
+    const transportHealth = deriveTransportHealth({
+      runtime_status: ingressRuntime
+        ? {
+            ...ingressRuntime,
+            preferred_transport_mode: transportPreference?.preferred_mode ?? ingressRuntime.preferred_transport_mode ?? 'bridge',
+          }
+        : {
+            receive_mode: 'webhook',
+            transport_mode: transportPreference?.preferred_mode ?? 'bridge',
+            preferred_transport_mode: transportPreference?.preferred_mode ?? 'bridge',
+          },
+      recent_events: collaborationEventManager.listRecent(30),
+      projection_outbox_failed: new CollaborationProjectionOutboxManager(store).listByStatus('failed', 20),
+    });
     const desiredSelectedSessionKey =
       (selectedSessionKey && sessions.some((session) => session.session_key === selectedSessionKey) ? selectedSessionKey : null) ??
       sessionManager.getActiveSession()?.session_key ??
@@ -376,9 +409,9 @@ function buildHostState(identityPath, selectedSessionKey = null, historyPageInde
       ? collaborationEventManager.listBySession(selectedSession.session_key, 12)
       : [];
     const selectedPendingCollaborationEvents = selectedSession
-      ? collaborationEventManager.listPendingBySession(selectedSession.session_key, 12)
+      ? listPendingDecisionViews(store, 100).filter((event) => event.session_key === selectedSession.session_key).slice(0, 12)
       : [];
-    const pendingCollaborationEventsGlobal = collaborationEventManager.listPending(50);
+    const pendingCollaborationEventsGlobal = listPendingDecisionViews(store, 50);
     const selectedMessages = selectedSession?.conversation_id
       ? historyManager.listRecent(selectedSession.conversation_id, 12)
       : [];
@@ -402,18 +435,39 @@ function buildHostState(identityPath, selectedSessionKey = null, historyPageInde
       : [];
     const unreadTotal = sessionsWithMeta.reduce((sum, session) => sum + (session.unread_count ?? 0), 0);
     const alertSessions = sessionsWithMeta.filter((session) => !!session.binding_alert).length;
+    const sinceLastSeenGlobal = summarizeSinceLastSeen(store, {
+      operator_id: 'tui',
+      scope_type: 'global',
+    });
+    const sessionsWithSeen = sessionsWithMeta.map((session) => ({
+      ...session,
+      since_last_seen: summarizeSinceLastSeen(store, {
+        operator_id: 'tui',
+        scope_type: 'session',
+        scope_key: session.session_key,
+      }),
+    }));
+    const selectedDeliveryTimeline = selectedSession
+      ? buildDeliveryTimeline(store, selectedSession.session_key, 30)
+      : [];
+    const selectedProjectionPreview = selectedSession
+      ? buildProjectionPreview(store, selectedSession.session_key, policy.doc.collaboration_projection?.preset || 'balanced', 5)
+      : null;
     return {
       identity,
       runtimeMode,
       activeChatSession,
       ingressRuntime,
+      transportPreference,
+      transportHealth,
       activeChatSessionFile: getActiveSessionFilePath(),
       sessionMapPath: getSessionMapFilePath(),
       sessionBindingAlertsPath: getSessionBindingAlertsFilePath(),
       policyPath: policy.path,
       policyDoc: policy.doc,
       projectionPreset: policy.doc.collaboration_projection?.preset || 'balanced',
-      sessions: sessionsWithMeta,
+      sinceLastSeenGlobal,
+      sessions: sessionsWithSeen,
       tasks: taskManager.listRecent(30).map((task) => ({
         ...task,
         handoff: taskHandoffManager.get(task.task_id),
@@ -426,6 +480,8 @@ function buildHostState(identityPath, selectedSessionKey = null, historyPageInde
       selectedAuditEvents,
       selectedCollaborationEvents,
       selectedPendingCollaborationEvents,
+      selectedDeliveryTimeline,
+      selectedProjectionPreview,
       pendingCollaborationEventsGlobal,
       selectedMessages,
       selectedHistoryPage,
@@ -450,6 +506,8 @@ function renderHostTuiScreen(hostState, uiState) {
   const pendingCollaborationEvents = hostState.selectedPendingCollaborationEvents || [];
   const pendingCollaborationEventsGlobal = hostState.pendingCollaborationEventsGlobal || [];
   const messages = hostState.selectedMessages || [];
+  const deliveryTimeline = hostState.selectedDeliveryTimeline || [];
+  const projectionPreview = hostState.selectedProjectionPreview || null;
   const recommendations = hostState.selectedRecommendations || [];
   const openRecommendation = recommendations.find((item) => item.status === 'open') || null;
   const reopenRecommendation = recommendations.find((item) => item.status === 'dismissed' || item.status === 'superseded') || null;
@@ -469,14 +527,18 @@ function renderHostTuiScreen(hostState, uiState) {
     || hostState.ingressRuntime.receive_mode === 'polling_degraded'
     || !!hostState.ingressRuntime.hooks_last_error;
   const ingressLabel = degraded ? 'Degraded' : 'Ready';
+  const transportHealth = hostState.transportHealth || { state: 'Ready', transport_mode: 'bridge', preferred_transport_mode: 'bridge', retry_queue_length: 0, consecutive_failures: 0 };
+  const sinceLastSeenGlobal = hostState.sinceLastSeenGlobal || {};
   const lines = [
     'PingAgent Host TUI',
     `DID: ${hostState.identity.did}`,
     `status=${formatStatusLine(uiState?.statusLevel || 'info', uiState?.statusMessage || '(ready)')}${statusTs}${statusCountdown}`,
     `runtime_mode=${hostState.runtimeMode}  receive_mode=${hostState.ingressRuntime?.receive_mode || 'webhook'}  current_openclaw_chat=${hostState.activeChatSession || '(none)'}`,
     `ingress=${ingressLabel}${degraded ? '  action=[f] fix-now' : ''}`,
+    `transport=${transportHealth.transport_mode} preferred=${transportHealth.preferred_transport_mode} state=${transportHealth.state} retry_queue=${transportHealth.retry_queue_length} failures=${transportHealth.consecutive_failures}`,
     uiState?.publicLinkUrl ? `public_link=${uiState.publicLinkUrl}` : null,
     `sessions=${sessions.length}  unread_total=${hostState.unreadTotal ?? 0}  alert_sessions=${hostState.alertSessions ?? 0}  view=${view}  projection=${hostState.projectionPreset || 'balanced'}`,
+    `since_last_seen external=${sinceLastSeenGlobal.new_external_messages ?? 0} conclusions=${sinceLastSeenGlobal.new_conclusions ?? 0} decisions=${sinceLastSeenGlobal.new_decisions ?? 0} failures=${sinceLastSeenGlobal.new_failures ?? 0}`,
     `policy=${hostState.policyPath}`,
     `chat_link_map=${hostState.sessionMapPath}`,
     `chat_link_alerts=${hostState.sessionBindingAlertsPath}`,
@@ -505,12 +567,14 @@ function renderHostTuiScreen(hostState, uiState) {
     lines.push('- y: dump task detail to stdout (task-detail view, choose json/plain)');
     lines.push('- u: approve the selected collaboration decision');
     lines.push('- U: reject the selected collaboration decision');
+    lines.push('- b: switch preferred transport to bridge');
+    lines.push('- c: switch preferred transport to channel');
     lines.push('- f: repair OpenClaw hooks config');
     lines.push('- A: apply first open trust recommendation for selected session');
     lines.push('- D: dismiss current open recommendation');
     lines.push('- R: reopen dismissed/superseded recommendation');
-    lines.push('- b: attach selected session to the current OpenClaw chat');
-    lines.push('- c: detach the selected chat link');
+    lines.push('- B: attach selected session to the current OpenClaw chat');
+    lines.push('- C: detach the selected chat link');
     lines.push('- q: quit');
   } else if (view === 'history') {
     lines.push('Conversation History');
@@ -576,7 +640,7 @@ function renderHostTuiScreen(hostState, uiState) {
     lines.push(...(pendingCollaborationEventsGlobal.length
       ? pendingCollaborationEventsGlobal.map((event, idx) => {
           const marker = idx === selectedDecisionIndex ? '>' : ' ';
-          return `${marker} ${event.id} [${event.severity}] ${truncateLine(event.summary || '(none)', 88)} session=${event.session_key || '(none)'}`;
+          return `${marker} ${event.id} [${event.severity}${event.overdue ? ':overdue' : ''}] ${truncateLine(event.summary || '(none)', 88)} session=${event.session_key || '(none)'}`;
         })
       : ['- none']));
   } else if (view === 'tasks') {
@@ -642,7 +706,12 @@ function renderHostTuiScreen(hostState, uiState) {
       if (pendingCollaborationEvents.length > 0) {
         lines.push(`pending_collaboration_decisions=${pendingCollaborationEvents.length}`);
         lines.push(`next_decision=${truncateLine(pendingCollaborationEvents[0].summary || '(none)', 100)}`);
+        if (pendingCollaborationEvents[0].overdue) {
+          lines.push(`next_decision_overdue=${Math.ceil((pendingCollaborationEvents[0].overdue_by_ms || 0) / 60000)}m`);
+        }
       }
+      const sessionSeen = selected.since_last_seen || {};
+      lines.push(`since_last_seen external=${sessionSeen.new_external_messages ?? 0} conclusions=${sessionSeen.new_conclusions ?? 0} decisions=${sessionSeen.new_decisions ?? 0} failures=${sessionSeen.new_failures ?? 0}`);
       const actionBar = [
         selected.trust_state === 'pending' ? '[a] approve' : null,
         '[A] apply-rec',
@@ -656,8 +725,8 @@ function renderHostTuiScreen(hostState, uiState) {
         pendingCollaborationEvents.length ? '[U] reject-decision' : null,
         '[o] history',
         '[t] tasks',
-        '[b] attach-chat',
-        '[c] detach-chat',
+        '[B] attach-chat',
+        '[C] detach-chat',
       ].filter(Boolean).join('  ');
       lines.push(`actions=${actionBar}`);
       lines.push('');
@@ -688,6 +757,20 @@ function renderHostTuiScreen(hostState, uiState) {
       lines.push(...(collaborationEvents.length
         ? collaborationEvents.map((event) => `- ${event.event_type} [${event.severity}${event.approval_required ? `:${event.approval_status}` : ''}] ${truncateLine(event.summary || '', 90)}`)
         : ['- none']));
+      if (projectionPreview) {
+        lines.push('');
+        lines.push(`Projection Preview [preset=${projectionPreview.preset}]`);
+        lines.push(...(projectionPreview.recent.length
+          ? projectionPreview.recent.map((entry) => `- ${entry.event_type} => ${entry.disposition} (${truncateLine(entry.reason, 70)})`)
+          : ['- none']));
+      }
+      if (view === 'detail') {
+        lines.push('');
+        lines.push('Delivery Timeline');
+        lines.push(...(deliveryTimeline.length
+          ? deliveryTimeline.slice(0, 10).map((entry) => `- ${formatTs(entry.ts_ms, false)} ${entry.kind} ${truncateLine(entry.summary || '', 72)}`)
+          : ['- none']));
+      }
       lines.push('');
       lines.push('Audit');
       lines.push(...(auditEvents.length
@@ -699,7 +782,7 @@ function renderHostTuiScreen(hostState, uiState) {
   }
 
   lines.push('');
-  lines.push('Keys: ↑/↓ or j/k select  Enter/l open  Esc/h back  g/G jump  r refresh  a approve  u/U decide  A apply-rec  D dismiss-rec  R reopen-rec  d demo  m read  p reply  o history  s search  t tasks  x cancel-task  y dump  f fix-hooks  b attach-chat  c detach-chat  ? help  q quit');
+  lines.push('Keys: ↑/↓ or j/k select  Enter/l open  Esc/h back  g/G jump  r refresh  a approve  u/U decide  A apply-rec  D dismiss-rec  R reopen-rec  d demo  m read  p reply  o history  s search  t tasks  x cancel-task  y dump  f fix-hooks  b transport->bridge  c transport->channel  B attach-chat  C detach-chat  ? help  q quit');
   return lines.join('\n');
 }
 
@@ -720,6 +803,10 @@ async function runHostTui(identityPath, opts) {
     historySearchQuery: '',
     publicLinkUrl: '',
   };
+  const seenState = {
+    globalView: null,
+    sessionKey: null,
+  };
 
   const render = () => {
     if (uiState.statusExpiresAt && Date.now() >= uiState.statusExpiresAt) {
@@ -762,7 +849,49 @@ async function runHostTui(identityPath, opts) {
     return rendered.hostState;
   };
 
+  const markSeen = (scopeType, scopeKey = null) => {
+    const store = openStore(identityPath);
+    try {
+      return new OperatorSeenStateManager(store).markSeen({
+        operator_id: 'tui',
+        scope_type: scopeType,
+        scope_key: scopeType === 'session' ? (scopeKey || null) : null,
+        last_seen_ts: Date.now(),
+      });
+    } finally {
+      store.close();
+    }
+  };
+
+  const refreshSeenMarkers = (hostState, options = {}) => {
+    let changed = false;
+    const forceGlobal = !!options.forceGlobal;
+    const forceSession = !!options.forceSession;
+    if (uiState.view === 'overview' || uiState.view === 'decisions') {
+      if (forceGlobal || seenState.globalView !== uiState.view) {
+        markSeen('global');
+        seenState.globalView = uiState.view;
+        changed = true;
+      }
+      if (uiState.view === 'overview') seenState.sessionKey = null;
+    } else if (['detail', 'history', 'tasks', 'task-detail'].includes(uiState.view)) {
+      const sessionKey = hostState.selectedSession?.session_key || null;
+      if (sessionKey && (forceSession || seenState.sessionKey !== sessionKey)) {
+        markSeen('session', sessionKey);
+        seenState.sessionKey = sessionKey;
+        changed = true;
+      }
+    }
+    return changed;
+  };
+
+  const rerenderAfterSeenUpdate = (hostState, options = {}) => {
+    if (!refreshSeenMarkers(hostState, options)) return hostState;
+    return redraw();
+  };
+
   let latestState = redraw();
+  latestState = rerenderAfterSeenUpdate(latestState, { forceGlobal: true });
   readline.emitKeypressEvents(process.stdin);
   if (process.stdin.setRawMode) process.stdin.setRawMode(true);
 
@@ -779,6 +908,50 @@ async function runHostTui(identityPath, opts) {
     uiState.statusAt = Date.now();
   };
 
+  const switchTransport = async (mode) => {
+    const label = mode === 'channel' ? 'channel' : 'bridge';
+    const confirmed = await confirmAction(`Switch preferred transport to ${label} and request a managed restart?`);
+    if (!confirmed) {
+      setStatus(`Transport switch to ${label} cancelled.`, 'warn');
+      latestState = redraw();
+      return;
+    }
+    try {
+      const result = switchTransportPreference(mode, {
+        updated_by: 'tui',
+      });
+      const store = openStore(identityPath);
+      try {
+        new CollaborationEventManager(store).record({
+          event_type: 'transport_switched',
+          severity: result.restarted ? 'notice' : 'warning',
+          summary: result.restarted
+            ? `Preferred transport switched to ${label}. A managed restart was attempted.`
+            : `Preferred transport switched to ${label}. Restart is still required.`,
+          detail: {
+            preferred_mode: result.preferred_mode,
+            restart_required: result.restart_required,
+            restart_method: result.restart_method ?? null,
+            restart_error: result.restart_error ?? null,
+            preference_path: result.preference_path,
+          },
+        });
+      } finally {
+        store.close();
+      }
+      setStatus(
+        result.restarted
+          ? `Preferred transport is now ${label}; managed restart attempted via ${result.restart_method || 'unknown method'}.`
+          : `Preferred transport saved as ${label}; restart still required.`,
+        result.restarted ? 'ok' : 'warn',
+        result.restarted ? 7000 : 9000,
+      );
+    } catch (error) {
+      setStatus(`Transport switch failed: ${error?.message || 'unknown error'}`, 'err', 9000);
+    }
+    latestState = redraw();
+  };
+
   const applySessionRecommendation = (selected) => {
     if (!selected?.remote_did) return { ok: false, message: 'No remote DID for selected session.' };
     const store = openStore(identityPath);
@@ -985,6 +1158,10 @@ async function runHostTui(identityPath, opts) {
       uiState.historySearchQuery = '';
     }
     latestState = redraw();
+    latestState = rerenderAfterSeenUpdate(latestState, {
+      forceGlobal: uiState.view === 'overview' || uiState.view === 'decisions',
+      forceSession: ['detail', 'history', 'tasks', 'task-detail'].includes(uiState.view),
+    });
   };
 
   const jumpSelection = (target) => {
@@ -1007,6 +1184,10 @@ async function runHostTui(identityPath, opts) {
       uiState.historySearchQuery = '';
     }
     latestState = redraw();
+    latestState = rerenderAfterSeenUpdate(latestState, {
+      forceGlobal: uiState.view === 'overview' || uiState.view === 'decisions',
+      forceSession: ['detail', 'history', 'tasks', 'task-detail'].includes(uiState.view),
+    });
   };
 
   const stopInterval = () => {
@@ -1060,6 +1241,7 @@ async function runHostTui(identityPath, opts) {
         uiState.view = 'detail';
       }
       latestState = redraw();
+      latestState = rerenderAfterSeenUpdate(latestState, { forceSession: uiState.view !== 'decisions' && uiState.view !== 'overview' });
       return;
     }
     if (key?.name === 'escape' || key?.name === 'h') {
@@ -1068,6 +1250,7 @@ async function runHostTui(identityPath, opts) {
       else if (uiState.view === 'decisions') uiState.view = 'overview';
       else uiState.view = 'overview';
       latestState = redraw();
+      latestState = rerenderAfterSeenUpdate(latestState, { forceGlobal: uiState.view === 'overview' || uiState.view === 'decisions' });
       return;
     }
     if (_str === '?') {
@@ -1104,6 +1287,7 @@ async function runHostTui(identityPath, opts) {
       uiState.selectedHistoryPageIndex = 0;
       setStatus('Opened task list view.', 'info');
       latestState = redraw();
+      latestState = rerenderAfterSeenUpdate(latestState, { forceSession: true });
       return;
     }
     if (key?.name === 'i') {
@@ -1111,6 +1295,7 @@ async function runHostTui(identityPath, opts) {
       uiState.selectedDecisionIndex = 0;
       setStatus('Opened decision inbox.', 'info');
       latestState = redraw();
+      latestState = rerenderAfterSeenUpdate(latestState, { forceGlobal: true });
       return;
     }
     if (key?.name === 'r') {
@@ -1293,6 +1478,7 @@ async function runHostTui(identityPath, opts) {
       uiState.historySearchQuery = '';
       setStatus('Opened local history view.', 'info');
       latestState = redraw();
+      latestState = rerenderAfterSeenUpdate(latestState, { forceSession: true });
       return;
     }
     if ((_str === '/' || key?.name === 's') && uiState.view === 'history') {
@@ -1305,6 +1491,14 @@ async function runHostTui(identityPath, opts) {
       return;
     }
     if (key?.name === 'b') {
+      await switchTransport('bridge');
+      return;
+    }
+    if (key?.name === 'c') {
+      await switchTransport('channel');
+      return;
+    }
+    if (_str === 'B') {
       const selected = (latestState.sessions || []).find((session) => session.session_key === uiState.selectedSessionKey);
       if (!selected?.conversation_id) return;
       const current = latestState.activeChatSession || '(none)';
@@ -1324,7 +1518,7 @@ async function runHostTui(identityPath, opts) {
       latestState = redraw();
       return;
     }
-    if (key?.name === 'c') {
+    if (_str === 'C') {
       const selected = (latestState.sessions || []).find((session) => session.session_key === uiState.selectedSessionKey);
       if (!selected?.conversation_id) return;
       removeSessionBinding(selected.conversation_id);