@pingagent/sdk 0.1.13 → 0.1.15

package/bin/pingagent.js

@@ -24,12 +24,22 @@ import {
   TaskThreadManager,
   TaskHandoffManager,
   TrustPolicyAuditManager,
+  CollaborationEventManager,
+  CollaborationProjectionOutboxManager,
+  OperatorSeenStateManager,
   TrustRecommendationManager,
   getTrustRecommendationActionLabel,
   formatCapabilityCardSummary,
   defaultTrustPolicyDoc,
   normalizeTrustPolicyDoc,
   upsertTrustPolicyRecommendation,
+  summarizeSinceLastSeen,
+  buildDeliveryTimeline,
+  buildProjectionPreview,
+  listPendingDecisionViews,
+  deriveTransportHealth,
+  readTransportPreference,
+  switchTransportPreference,
   getActiveSessionFilePath,
   getSessionMapFilePath,
   getSessionBindingAlertsFilePath,
@@ -242,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) {
@@ -337,6 +356,7 @@ function buildHostState(identityPath, selectedSessionKey = null, historyPageInde
     const taskHandoffManager = new TaskHandoffManager(store);
     const historyManager = new HistoryManager(store);
     const auditManager = new TrustPolicyAuditManager(store);
+    const collaborationEventManager = new CollaborationEventManager(store);
     const sessions = sessionManager.listRecentSessions(50);
     const bindings = readSessionBindings();
     const alerts = readSessionBindingAlerts();
@@ -344,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 ??
@@ -370,6 +405,13 @@ function buildHostState(identityPath, selectedSessionKey = null, historyPageInde
     const selectedAuditEvents = selectedSession
       ? auditManager.listBySession(selectedSession.session_key, 12)
       : [];
+    const selectedCollaborationEvents = selectedSession
+      ? collaborationEventManager.listBySession(selectedSession.session_key, 12)
+      : [];
+    const selectedPendingCollaborationEvents = selectedSession
+      ? listPendingDecisionViews(store, 100).filter((event) => event.session_key === selectedSession.session_key).slice(0, 12)
+      : [];
+    const pendingCollaborationEventsGlobal = listPendingDecisionViews(store, 50);
     const selectedMessages = selectedSession?.conversation_id
       ? historyManager.listRecent(selectedSession.conversation_id, 12)
       : [];
@@ -393,26 +435,54 @@ 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,
-      sessions: sessionsWithMeta,
+      projectionPreset: policy.doc.collaboration_projection?.preset || 'balanced',
+      sinceLastSeenGlobal,
+      sessions: sessionsWithSeen,
       tasks: taskManager.listRecent(30).map((task) => ({
         ...task,
         handoff: taskHandoffManager.get(task.task_id),
       })),
       auditEvents: auditManager.listRecent(40),
+      collaborationEvents: collaborationEventManager.listRecent(40),
       selectedSession,
       selectedSessionSummary,
       selectedTasks,
       selectedAuditEvents,
+      selectedCollaborationEvents,
+      selectedPendingCollaborationEvents,
+      selectedDeliveryTimeline,
+      selectedProjectionPreview,
+      pendingCollaborationEventsGlobal,
       selectedMessages,
       selectedHistoryPage,
       selectedHistorySearchQuery: historySearchQuery.trim(),
@@ -432,7 +502,12 @@ function renderHostTuiScreen(hostState, uiState) {
   const selectedSummary = hostState.selectedSessionSummary || null;
   const tasks = hostState.selectedTasks || [];
   const auditEvents = hostState.selectedAuditEvents || [];
+  const collaborationEvents = hostState.selectedCollaborationEvents || [];
+  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;
@@ -442,6 +517,8 @@ function renderHostTuiScreen(hostState, uiState) {
   const view = uiState?.view || 'overview';
   const selectedTaskIndex = Math.max(0, Math.min(uiState?.selectedTaskIndex || 0, Math.max(0, tasks.length - 1)));
   const selectedTask = tasks[selectedTaskIndex] || null;
+  const selectedDecisionIndex = Math.max(0, Math.min(uiState?.selectedDecisionIndex || 0, Math.max(0, pendingCollaborationEventsGlobal.length - 1)));
+  const selectedDecision = pendingCollaborationEventsGlobal[selectedDecisionIndex] || null;
   const statusCountdown = uiState?.statusExpiresAt
     ? ` (${Math.max(0, Math.ceil((uiState.statusExpiresAt - Date.now()) / 1000))}s)`
     : '';
@@ -450,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}`,
+    `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}`,
@@ -475,6 +556,7 @@ function renderHostTuiScreen(hostState, uiState) {
     lines.push('- a: approve selected pending contact');
     lines.push('- m: mark selected session as read');
     lines.push('- t: open task list view for selected session');
+    lines.push('- i: open global decision inbox');
     lines.push('- x: cancel selected task (in task views)');
     lines.push('- p: multiline reply prompt (detail view)');
     lines.push('- S: edit carry-forward summary (detail view)');
@@ -483,12 +565,16 @@ function renderHostTuiScreen(hostState, uiState) {
     lines.push('- n / p: older / newer history page (history view)');
     lines.push('- s or /: search local history (history view)');
     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');
@@ -546,6 +632,17 @@ function renderHostTuiScreen(hostState, uiState) {
       lines.push('Tasks In Session');
       lines.push(...tasks.map((task, idx) => `${idx === selectedTaskIndex ? '>' : ' '} ${task.task_id} [${task.status}] ${truncateLine(task.title || task.result_summary || '', 70)}`));
     }
+  } else if (view === 'decisions') {
+    lines.push('Decision Inbox');
+    lines.push(`pending=${pendingCollaborationEventsGlobal.length}`);
+    lines.push('actions=[u] approve  [U] reject  [Enter/l] open-session  [j/k] select  [h/Esc] back');
+    lines.push('');
+    lines.push(...(pendingCollaborationEventsGlobal.length
+      ? pendingCollaborationEventsGlobal.map((event, idx) => {
+          const marker = idx === selectedDecisionIndex ? '>' : ' ';
+          return `${marker} ${event.id} [${event.severity}${event.overdue ? ':overdue' : ''}] ${truncateLine(event.summary || '(none)', 88)} session=${event.session_key || '(none)'}`;
+        })
+      : ['- none']));
   } else if (view === 'tasks') {
     lines.push('Task Detail');
     if (!selected) {
@@ -606,6 +703,15 @@ function renderHostTuiScreen(hostState, uiState) {
       } else {
         lines.push('summary_objective=(none)');
       }
+      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',
@@ -615,10 +721,12 @@ function renderHostTuiScreen(hostState, uiState) {
         '[d] demo',
         '[p] reply',
         '[S] summary',
+        pendingCollaborationEvents.length ? '[u] approve-decision' : null,
+        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('');
@@ -645,6 +753,25 @@ function renderHostTuiScreen(hostState, uiState) {
         lines.push(...(messages.length ? messages.map((message) => formatMessageRow(message)) : ['- none']));
       }
       lines.push('');
+      lines.push('Collaboration Feed');
+      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
         ? auditEvents.map((event) => `- ${event.event_type} ${event.action || event.outcome || ''} ${truncateLine(event.explanation || '', 80)}`)
@@ -655,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  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');
 }
 
@@ -667,6 +794,7 @@ async function runHostTui(identityPath, opts) {
     selectedSessionKey: null,
     view: 'overview',
     selectedTaskIndex: 0,
+    selectedDecisionIndex: 0,
     statusMessage: '(ready)',
     statusLevel: 'info',
     statusExpiresAt: 0,
@@ -675,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) {
@@ -717,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);
 
@@ -734,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);
@@ -922,6 +1140,10 @@ async function runHostTui(identityPath, opts) {
       const tasks = latestState.selectedTasks || [];
       if (!tasks.length) return;
       uiState.selectedTaskIndex = Math.min(tasks.length - 1, Math.max(0, uiState.selectedTaskIndex + delta));
+    } else if (uiState.view === 'decisions') {
+      const decisions = latestState.pendingCollaborationEventsGlobal || [];
+      if (!decisions.length) return;
+      uiState.selectedDecisionIndex = Math.min(decisions.length - 1, Math.max(0, uiState.selectedDecisionIndex + delta));
     } else if (uiState.view === 'history' && !uiState.historySearchQuery) {
       if (delta > 0 && latestState.selectedHistoryPage?.hasOlder) uiState.selectedHistoryPageIndex += 1;
       if (delta < 0 && latestState.selectedHistoryPage?.hasNewer) uiState.selectedHistoryPageIndex = Math.max(0, uiState.selectedHistoryPageIndex - 1);
@@ -936,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) => {
@@ -943,6 +1169,10 @@ async function runHostTui(identityPath, opts) {
       const tasks = latestState.selectedTasks || [];
       if (!tasks.length) return;
       uiState.selectedTaskIndex = target;
+    } else if (uiState.view === 'decisions') {
+      const decisions = latestState.pendingCollaborationEventsGlobal || [];
+      if (!decisions.length) return;
+      uiState.selectedDecisionIndex = target;
     } else if (uiState.view === 'history') {
       uiState.selectedHistoryPageIndex = 0;
     } else {
@@ -954,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 = () => {
@@ -989,23 +1223,34 @@ async function runHostTui(identityPath, opts) {
     if (_str === 'G') {
       const max = uiState.view === 'tasks' || uiState.view === 'task-detail'
         ? Math.max(0, (latestState.selectedTasks || []).length - 1)
-        : Math.max(0, (latestState.sessions || []).length - 1);
+        : uiState.view === 'decisions'
+          ? Math.max(0, (latestState.pendingCollaborationEventsGlobal || []).length - 1)
+          : Math.max(0, (latestState.sessions || []).length - 1);
       return jumpSelection(max);
     }
     if (key?.name === 'return' || key?.name === 'enter' || key?.name === 'l') {
       if (uiState.view === 'tasks') {
         uiState.view = 'task-detail';
+      } else if (uiState.view === 'decisions') {
+        const decision = (latestState.pendingCollaborationEventsGlobal || [])[Math.max(0, Math.min(uiState.selectedDecisionIndex || 0, Math.max(0, (latestState.pendingCollaborationEventsGlobal || []).length - 1)))] || null;
+        if (decision?.session_key) {
+          uiState.selectedSessionKey = decision.session_key;
+          uiState.view = 'detail';
+        }
       } else {
         uiState.view = 'detail';
       }
       latestState = redraw();
+      latestState = rerenderAfterSeenUpdate(latestState, { forceSession: uiState.view !== 'decisions' && uiState.view !== 'overview' });
       return;
     }
     if (key?.name === 'escape' || key?.name === 'h') {
       if (uiState.view === 'task-detail') uiState.view = 'tasks';
       else if (uiState.view === 'history') uiState.view = 'detail';
+      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 === '?') {
@@ -1042,6 +1287,15 @@ 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') {
+      uiState.view = 'decisions';
+      uiState.selectedDecisionIndex = 0;
+      setStatus('Opened decision inbox.', 'info');
+      latestState = redraw();
+      latestState = rerenderAfterSeenUpdate(latestState, { forceGlobal: true });
       return;
     }
     if (key?.name === 'r') {
@@ -1083,6 +1337,45 @@ async function runHostTui(identityPath, opts) {
       latestState = redraw();
       return;
     }
+    if (key?.name === 'u' || _str === 'U') {
+      const approvalStatus = _str === 'U' ? 'rejected' : 'approved';
+      const pendingEvent = uiState.view === 'decisions'
+        ? (latestState.pendingCollaborationEventsGlobal || [])[Math.max(0, Math.min(uiState.selectedDecisionIndex || 0, Math.max(0, (latestState.pendingCollaborationEventsGlobal || []).length - 1)))] || null
+        : (latestState.selectedPendingCollaborationEvents || [])[0];
+      const selected = pendingEvent?.session_key
+        ? (latestState.sessions || []).find((session) => session.session_key === pendingEvent.session_key) || latestState.selectedSession
+        : latestState.selectedSession;
+      if (!pendingEvent || !selected) return;
+      const confirmed = await confirmAction(`${approvalStatus === 'approved' ? 'Approve' : 'Reject'} collaboration decision ${pendingEvent.id}\nSession: ${selected.session_key}\nSummary: ${pendingEvent.summary}\nProceed?`);
+      if (!confirmed) {
+        setStatus('Collaboration decision cancelled.', 'warn');
+        latestState = redraw();
+        return;
+      }
+      const store = openStore(identityPath);
+      try {
+        const manager = new CollaborationEventManager(store);
+        const result = manager.resolveApproval(pendingEvent.id, approvalStatus, {
+          resolved_by: 'tui',
+        });
+        if (!result) {
+          setStatus(`Decision ${pendingEvent.id} no longer exists.`, 'err');
+        } else {
+          setStatus(
+            approvalStatus === 'approved'
+              ? `Approved collaboration decision ${pendingEvent.id}${result.projection_outbox ? ` · human-thread projection=${result.projection_outbox.status}` : ''}`
+              : `Rejected collaboration decision ${pendingEvent.id}${result.projection_outbox ? ` · human-thread projection=${result.projection_outbox.status}` : ''}`,
+            'ok',
+          );
+        }
+      } catch (error) {
+        setStatus(`Collaboration decision failed: ${error?.message || 'unknown error'}`, 'err', 9000);
+      } finally {
+        store.close();
+      }
+      latestState = redraw();
+      return;
+    }
     if (_str === 'A') {
       const selected = latestState.selectedSession;
       if (!selected) return;
@@ -1185,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') {
@@ -1197,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)';
@@ -1216,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);