@pingagent/sdk 0.1.14 → 0.1.15

package/dist/web-server.js

@@ -3,29 +3,37 @@ import {
   CollaborationProjectionOutboxManager,
   ContactManager,
   LocalStore,
+  OperatorSeenStateManager,
   PingAgentClient,
   TrustPolicyAuditManager,
   TrustRecommendationManager,
+  buildDeliveryTimeline,
+  buildProjectionPreview,
   decideContactPolicy,
   decideTaskPolicy,
   defaultTrustPolicyDoc,
+  deriveTransportHealth,
   ensureTokenValid,
   getActiveSessionFilePath,
   getSessionBindingAlertsFilePath,
   getSessionMapFilePath,
   getTrustRecommendationActionLabel,
+  listPendingDecisionViews,
   loadIdentity,
   normalizeTrustPolicyDoc,
   readCurrentActiveSessionKey,
   readIngressRuntimeStatus,
   readSessionBindingAlerts,
   readSessionBindings,
+  readTransportPreference,
   removeSessionBinding,
   setSessionBinding,
+  summarizeSinceLastSeen,
   summarizeTrustPolicyAudit,
+  switchTransportPreference,
   updateStoredToken,
   upsertTrustPolicyRecommendation
-} from "./chunk-MFKDD5X3.js";
+} from "./chunk-BCYHGKQE.js";
 
 // src/web-server.ts
 import * as fs from "fs";
@@ -210,6 +218,10 @@ function getHostPanelHtml() {
 
       <section id="runtimePanel" class="panel active">
         <div class="card" id="activationCard" style="margin-bottom:16px"></div>
+        <div class="grid two-col" style="margin-bottom:16px">
+          <div class="card" id="transportHealthCard"></div>
+          <div class="card" id="sinceLastSeenCard"></div>
+        </div>
         <div class="grid stats" id="statsGrid"></div>
         <div class="grid runtime-layout" style="margin-top:16px">
           <div class="card">
@@ -269,6 +281,7 @@ function getHostPanelHtml() {
               <div class="row-actions">
                 <button class="action-btn" id="saveProjectionPresetBtn">Save projection preset</button>
               </div>
+              <div id="projectionPolicyPreview" class="muted small" style="margin-top:12px"></div>
             </div>
           </div>
 
@@ -407,6 +420,10 @@ function getHostPanelHtml() {
       detailMode: sessionStorage.getItem('pingagent_host_panel_detail_mode') || 'basic',
       showUnreadOnly: false,
     };
+    const seenMarkers = {
+      globalTab: null,
+      sessionKey: null,
+    };
 
     function esc(value) {
       return String(value == null ? '' : value)
@@ -429,6 +446,130 @@ function getHostPanelHtml() {
       try { return new Date(value).toLocaleString(); } catch { return String(value); }
     }
 
+    function countSinceLastSeen(summary) {
+      if (!summary) return 0;
+      return Number(summary.new_external_messages || 0)
+        + Number(summary.new_conclusions || 0)
+        + Number(summary.new_handoffs || 0)
+        + Number(summary.new_decisions || 0)
+        + Number(summary.new_failures || 0)
+        + Number(summary.new_repairs || 0)
+        + Number(summary.new_projection_failures || 0);
+    }
+
+    function renderSinceLastSeenSummary(summary) {
+      if (!summary) return '<div class="empty">No seen-state yet.</div>';
+      const count = countSinceLastSeen(summary);
+      return '' +
+        '<div class="status-main">' +
+          '<h2>Since Last Seen</h2>' +
+          '<div class="muted small">Per operator view. Opening runtime, detail, or decisions resets the matching anchor instead of forcing every refresh to zero out the feed.</div>' +
+          '<div class="summary-pills">' +
+            '<span class="pill">new=' + esc(count) + '</span>' +
+            '<span class="pill">external=' + esc(summary.new_external_messages || 0) + '</span>' +
+            '<span class="pill">conclusions=' + esc(summary.new_conclusions || 0) + '</span>' +
+            '<span class="pill">handoffs=' + esc(summary.new_handoffs || 0) + '</span>' +
+            '<span class="pill">decisions=' + esc(summary.new_decisions || 0) + '</span>' +
+            '<span class="pill">failures=' + esc(summary.new_failures || 0) + '</span>' +
+            '<span class="pill">repairs=' + esc(summary.new_repairs || 0) + '</span>' +
+            '<span class="pill">projection=' + esc(summary.new_projection_failures || 0) + '</span>' +
+          '</div>' +
+          '<div class="muted small" style="margin-top:8px">latest=' + esc(fmtTs(summary.latest_ts)) + '</div>' +
+        '</div>';
+    }
+
+    function renderTransportHealthCard(transportHealth) {
+      const health = transportHealth || {};
+      const stateLabel = health.state || 'Ready';
+      const stateClass = stateLabel === 'Degraded' || stateLabel === 'Switching Recommended' ? 'degraded' : 'ready';
+      const current = health.transport_mode || 'bridge';
+      const preferred = health.preferred_transport_mode || current;
+      return '' +
+        '<div class="status-strip">' +
+          '<div class="status-main">' +
+            '<h2>Transport Health</h2>' +
+            '<div class="status-state ' + esc(stateClass) + '">' + esc(stateLabel) + '</div>' +
+            '<div class="summary-pills">' +
+              '<span class="pill">current=' + esc(current) + '</span>' +
+              '<span class="pill">preferred=' + esc(preferred) + '</span>' +
+              '<span class="pill">retry_queue=' + esc(health.retry_queue_length || 0) + '</span>' +
+              '<span class="pill">failures=' + esc(health.consecutive_failures || 0) + '</span>' +
+            '</div>' +
+            '<div class="muted small" style="margin-top:8px">last inbound=' + esc(fmtTs(health.last_inbound_at)) + ' \xB7 last outbound=' + esc(fmtTs(health.last_outbound_at)) + '</div>' +
+            '<div class="muted small">last degraded=' + esc(fmtTs(health.last_degraded_at)) + ' \xB7 last repaired=' + esc(fmtTs(health.last_repaired_at)) + '</div>' +
+            (health.last_error ? '<div style="margin-top:8px;color:#fecaca">' + esc(health.last_error) + '</div>' : '<div class="muted small" style="margin-top:8px">No recent transport errors.</div>') +
+          '</div>' +
+          '<div style="min-width:240px">' +
+            '<div class="label">Actions</div>' +
+            '<div class="row-actions" style="margin-top:8px">' +
+              '<button class="secondary-btn transport-switch-btn" data-mode="bridge" style="width:auto">Switch to bridge</button>' +
+              '<button class="secondary-btn transport-switch-btn" data-mode="channel" style="width:auto">Switch to channel</button>' +
+            '</div>' +
+            (health.state === 'Switching Recommended'
+              ? '<div class="muted small" style="margin-top:10px">Assist Then Switch is recommending a move back to bridge. The preference file already captures the desired fallback path.</div>'
+              : '<div class="muted small" style="margin-top:10px">Managed restart keeps the transport layer swappable without changing the human-facing model.</div>') +
+          '</div>' +
+        '</div>';
+    }
+
+    function renderProjectionPreviewBlock(preview) {
+      if (!preview) return '<div class="empty">No projection preview available for the selected session yet.</div>';
+      const detailOnly = Array.isArray(preview.description && preview.description.detail_only) ? preview.description.detail_only : [];
+      const immediate = Array.isArray(preview.description && preview.description.immediate) ? preview.description.immediate : [];
+      return '' +
+        '<div class="muted small">Preset <strong>' + esc(preview.preset) + '</strong> projects <code>' + esc(immediate.join(', ') || 'none') + '</code> immediately and keeps <code>' + esc(detailOnly.join(', ') || 'none') + '</code> in detail-only mode.</div>' +
+        '<div class="audit-list" style="margin-top:10px">' +
+          (Array.isArray(preview.recent) && preview.recent.length
+            ? preview.recent.map(function (entry) {
+                return '<div class="audit-row"><div class="top"><strong>' + esc(entry.event_type) + '</strong><span class="badge">' + esc(entry.disposition) + '</span></div>' +
+                  '<div class="muted small">' + esc(entry.reason || '(no reason)') + '</div>' +
+                '</div>';
+              }).join('')
+            : '<div class="empty">No recent collaboration events to preview.</div>') +
+        '</div>';
+    }
+
+    function renderDeliveryTimeline(timeline) {
+      if (!Array.isArray(timeline) || !timeline.length) {
+        return '<div class="empty">No delivery timeline yet.</div>';
+      }
+      return timeline.map(function (entry) {
+        return '<div class="audit-row"><div class="top"><strong>' + esc(entry.kind || 'event') + '</strong><span class="badge">' + esc(fmtTs(entry.ts_ms)) + '</span></div>' +
+          '<div style="margin-top:8px">' + esc(entry.summary || '(no summary)') + '</div>' +
+        '</div>';
+      }).join('');
+    }
+
+    async function markSeen(scopeType, scopeKey) {
+      return api('/api/runtime/seen', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          operator_id: 'host_panel',
+          scope_type: scopeType,
+          scope_key: scopeType === 'session' ? scopeKey : null,
+        }),
+      });
+    }
+
+    async function maybeMarkGlobalSeen(tab, force) {
+      if (tab !== 'runtime' && tab !== 'decisions') return;
+      if (!force && seenMarkers.globalTab === tab) return;
+      try {
+        await markSeen('global', null);
+        seenMarkers.globalTab = tab;
+      } catch {}
+    }
+
+    async function maybeMarkSessionSeen(sessionKey, force) {
+      if (!sessionKey) return;
+      if (!force && seenMarkers.sessionKey === sessionKey) return;
+      try {
+        await markSeen('session', sessionKey);
+        seenMarkers.sessionKey = sessionKey;
+      } catch {}
+    }
+
     function syncUrlState() {
       const url = new URL(window.location.href);
       if (state.selectedProfile) url.searchParams.set('profile', state.selectedProfile);
@@ -512,6 +653,7 @@ function getHostPanelHtml() {
     }
 
     function setTab(tab) {
+      const previous = state.currentTab;
       state.currentTab = tab;
       document.getElementById('navRuntime').classList.toggle('active', tab === 'runtime');
       document.getElementById('navDecisions').classList.toggle('active', tab === 'decisions');
@@ -519,7 +661,16 @@ function getHostPanelHtml() {
       document.getElementById('runtimePanel').classList.toggle('active', tab === 'runtime');
       document.getElementById('decisionsPanel').classList.toggle('active', tab === 'decisions');
       document.getElementById('policyPanel').classList.toggle('active', tab === 'policy');
+      if (previous !== tab && tab !== 'runtime') {
+        seenMarkers.sessionKey = null;
+      }
       syncUrlState();
+      if (previous !== tab) {
+        void maybeMarkGlobalSeen(tab, true);
+        if (tab === 'runtime' && state.selectedSessionKey) {
+          void maybeMarkSessionSeen(state.selectedSessionKey, true);
+        }
+      }
     }
 
     function renderHeader() {
@@ -650,15 +801,18 @@ function getHostPanelHtml() {
     function renderDecisionInbox() {
       const data = state.decisions;
       const pendingDecisions = data && Array.isArray(data.pendingDecisions) ? data.pendingDecisions : [];
+      const overdueDecisions = pendingDecisions.filter(function (event) { return !!event.overdue; });
       const pendingOutbox = data && Array.isArray(data.projectionOutboxPending) ? data.projectionOutboxPending : [];
       const failedOutbox = data && Array.isArray(data.projectionOutboxFailed) ? data.projectionOutboxFailed : [];
       document.getElementById('decisionInboxSummary').textContent =
-        'pending=' + pendingDecisions.length + ' \xB7 projection_pending=' + pendingOutbox.length + ' \xB7 projection_failed=' + failedOutbox.length;
+        'pending=' + pendingDecisions.length + ' \xB7 overdue=' + overdueDecisions.length + ' \xB7 projection_pending=' + pendingOutbox.length + ' \xB7 projection_failed=' + failedOutbox.length;
       document.getElementById('decisionInboxList').innerHTML = pendingDecisions.length
         ? pendingDecisions.map(function (event) {
             return '<div class="audit-row"><div class="top"><strong>' + esc(event.summary || '(no summary)') + '</strong>' +
-              '<span class="badge">' + esc(event.severity || 'warning') + '</span></div>' +
-              '<div class="muted small">' + esc(fmtTs(event.ts_ms)) + ' \xB7 session=' + esc(event.session_key || '(none)') + ' \xB7 target=' + esc(event.target_human_session || '(none)') + '</div>' +
+              '<div style="display:flex;gap:6px;flex-wrap:wrap;justify-content:flex-end"><span class="badge">' + esc(event.severity || 'warning') + '</span>' +
+              (event.overdue ? '<span class="badge alert">overdue</span>' : '') + '</div></div>' +
+              '<div class="muted small">' + esc(fmtTs(event.ts_ms)) + ' \xB7 session=' + esc(event.session_key || '(none)') + ' \xB7 target=' + esc(event.target_human_session || '(none)') +
+              (event.overdue ? ' \xB7 overdue_by=' + esc(Math.ceil((event.overdue_by_ms || 0) / 60000)) + 'm' : '') + '</div>' +
               '<div class="muted small" style="margin-top:8px">detail_ref=' + esc(event.conversation_id || '(none)') + '</div>' +
               '<div class="row-actions">' +
                 '<button class="action-btn inbox-decision-btn" data-event-id="' + esc(event.id) + '" data-decision="approved">Approve</button>' +
@@ -747,6 +901,11 @@ function getHostPanelHtml() {
       if (!overview) return;
       syncSelectedSessionFromOverview();
       const ingressState = ingressStatusModel(overview);
+      const transportHealth = overview.transportHealth || null;
+      const sinceLastSeen = overview.sinceLastSeen || null;
+      const overdueDecisions = Array.isArray(overview.pendingDecisions)
+        ? overview.pendingDecisions.filter(function (event) { return !!event.overdue; })
+        : [];
       document.getElementById('activationCard').innerHTML =
         '<div class="status-strip">' +
           '<div class="status-main">' +
@@ -754,6 +913,11 @@ function getHostPanelHtml() {
             '<div class="status-state ' + ingressState.className + '">' + esc(ingressState.label) + '</div>' +
             '<div class="muted small">' + esc(ingressState.detail) + '</div>' +
             '<div class="muted small">Public link: ' + esc(overview.publicSelf && overview.publicSelf.public_url ? overview.publicSelf.public_url : '(not ready yet)') + '</div>' +
+            '<div class="summary-pills">' +
+              '<span class="pill">pending_decisions=' + esc((overview.pendingDecisions || []).length) + '</span>' +
+              '<span class="pill">overdue=' + esc(overdueDecisions.length) + '</span>' +
+              '<span class="pill">projection=' + esc(overview.collaborationProjection && overview.collaborationProjection.preset ? overview.collaborationProjection.preset : 'balanced') + '</span>' +
+            '</div>' +
           '</div>' +
           '<div style="min-width:320px">' +
             '<div class="label">Quick Start</div>' +
@@ -768,6 +932,8 @@ function getHostPanelHtml() {
             '</div>' +
           '</div>' +
         '</div>';
+      document.getElementById('transportHealthCard').innerHTML = renderTransportHealthCard(transportHealth);
+      document.getElementById('sinceLastSeenCard').innerHTML = renderSinceLastSeenSummary(sinceLastSeen);
       const subscription = overview.subscription || null;
       const stats = [
         { label: 'Plan', value: subscription ? subscription.tier : 'ghost', sub: subscription ? subscription.summary : 'subscription unavailable' },
@@ -796,6 +962,9 @@ function getHostPanelHtml() {
           const active = session.session_key === state.selectedSessionKey ? ' active' : '';
           const badges = [
             '<span class="badge ' + esc(session.trust_state) + '">' + esc(session.trust_state) + '</span>',
+            (countSinceLastSeen(session.since_last_seen) > 0
+              ? '<span class="badge alert">new ' + esc(countSinceLastSeen(session.since_last_seen)) + '</span>'
+              : ''),
             session.binding_alert
               ? '<button type="button" class="badge alert rebind-badge-btn" data-session="' + esc(session.session_key) + '" data-conversation="' + esc(session.conversation_id || '') + '" data-bound-session="' + esc(session.mapped_work_session || '') + '" data-remote-did="' + esc(session.remote_did || '') + '" title="OpenClaw chat link needs attention">Needs reconnect</button>'
               : '',
@@ -833,6 +1002,25 @@ function getHostPanelHtml() {
         });
       }
 
+      document.querySelectorAll('.transport-switch-btn').forEach(function (btn) {
+        btn.addEventListener('click', async function () {
+          const mode = btn.getAttribute('data-mode');
+          if (mode !== 'bridge' && mode !== 'channel') return;
+          const confirmed = window.confirm('Switch preferred transport to ' + mode + ' and request a managed restart?');
+          if (!confirmed) return;
+          const result = await api('/api/runtime/transport-switch', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ mode: mode }),
+          });
+          window.alert(result && result.result && result.result.restarted
+            ? ('Preferred transport switched to ' + mode + '. Managed restart was attempted.')
+            : ('Preferred transport switched to ' + mode + '. Restart is still required.'));
+          await refreshAll();
+          setTab('runtime');
+        });
+      });
+
       const tasks = Array.isArray(overview.tasks) ? overview.tasks : [];
       document.getElementById('taskList').innerHTML = tasks.length
         ? tasks.map(function (task) {
@@ -937,6 +1125,10 @@ conversation=' + result.conversation_id));
         ? detail.collaborationProjection.preset
         : 'balanced';
       const projectionOutbox = Array.isArray(detail.projectionOutbox) ? detail.projectionOutbox : [];
+      const sinceLastSeen = detail.sinceLastSeen || null;
+      const deliveryTimeline = Array.isArray(detail.deliveryTimeline) ? detail.deliveryTimeline : [];
+      const projectionPreview = detail.projectionPreview || null;
+      const transportHealth = detail.transportHealth || null;
       const isAdvanced = state.detailMode === 'advanced';
       const sessionLink = buildSessionLink(session.session_key);
       const summaryPills = [];
@@ -972,7 +1164,8 @@ conversation=' + result.conversation_id));
               : (reopenRecommendation ? '<div class="muted small" style="margin-top:8px">trust_action=' + esc(recommendationActionLabel(reopenRecommendation)) + '</div>' : '')) +
             (summaryPills.length ? '<div class="summary-pills">' + summaryPills.join('') + '</div>' : '') +
             (pendingCollaborationEvents.length
-              ? '<div style="margin-top:10px;padding:10px 12px;border:1px solid #f59e0b;border-radius:10px;background:rgba(120,53,15,0.25);color:#fde68a"><strong>Decision pending</strong><div class="small" style="margin-top:6px">A collaboration update needs review before the human thread can be treated as fully current. Resolve it in the Collaboration Feed below.</div></div>'
+              ? '<div style="margin-top:10px;padding:10px 12px;border:1px solid #f59e0b;border-radius:10px;background:rgba(120,53,15,0.25);color:#fde68a"><strong>Decision pending</strong><div class="small" style="margin-top:6px">A collaboration update needs review before the human thread can be treated as fully current. Resolve it in the Collaboration Feed below.' +
+                (pendingCollaborationEvents[0].overdue ? ' This item is overdue.' : '') + '</div></div>'
               : '') +
             (bindingAlert
               ? '<div style="margin-top:10px;padding:10px 12px;border:1px solid #ef4444;border-radius:10px;background:rgba(127,29,29,0.25);color:#fecaca"><strong>Needs reconnect</strong><div class="small" style="margin-top:6px">' + esc(isAdvanced ? (bindingAlert.message || 'Bound work session is missing. Rebind this PingAgent conversation to the current chat session.') : 'OpenClaw chat link is stale. Attach this PingAgent session to the current OpenClaw chat.') + '</div></div>'
@@ -1084,15 +1277,36 @@ conversation=' + result.conversation_id));
           '</div></div>' +
           '<div><div class="label">Human Thread Posture</div><div class="audit-list" style="margin-top:8px">' +
             '<div class="audit-row"><div class="top"><strong>Projection policy</strong><span class="badge">' + esc(projectionPreset) + '</span></div>' +
-              '<div class="muted small">The collaboration session keeps the raw transcript. The human thread receives concise updates, risk signals, decisions, and approval results through the projection outbox.</div>' +
-              '<div style="margin-top:8px">Use this detail view to inspect every raw message, task, handoff, audit event, and runtime change before taking action.</div>' +
+            '<div class="muted small">The collaboration session keeps the raw transcript. The human thread receives concise updates, risk signals, decisions, and approval results through the projection outbox.</div>' +
+            '<div style="margin-top:8px">Use this detail view to inspect every raw message, task, handoff, audit event, and runtime change before taking action.</div>' +
+              (sinceLastSeen
+                ? '<div class="summary-pills" style="margin-top:8px">' +
+                    '<span class="pill">new=' + esc(countSinceLastSeen(sinceLastSeen)) + '</span>' +
+                    '<span class="pill">decisions=' + esc(sinceLastSeen.new_decisions || 0) + '</span>' +
+                    '<span class="pill">failures=' + esc(sinceLastSeen.new_failures || 0) + '</span>' +
+                  '</div>'
+                : '') +
+              (transportHealth
+                ? '<div class="muted small" style="margin-top:8px">transport=' + esc(transportHealth.transport_mode || 'bridge') + ' \xB7 state=' + esc(transportHealth.state || 'Ready') + ' \xB7 retry_queue=' + esc(transportHealth.retry_queue_length || 0) + '</div>'
+                : '') +
               (projectionOutbox.length
                 ? '<div class="muted small" style="margin-top:8px">outbox=' + esc(projectionOutbox[0].status || 'pending') + ' \xB7 target=' + esc(projectionOutbox[0].target_human_session || '(missing)') + '</div>'
                 : '<div class="muted small" style="margin-top:8px">outbox=clear</div>') +
+              '<div style="margin-top:12px"><div class="label">Projection Preview</div><div style="margin-top:8px">' + renderProjectionPreviewBlock(projectionPreview) + '</div></div>' +
             '</div>' +
           '</div></div>' +
         '</div>';
 
+      el.innerHTML +=
+        '<div class="grid two-col" style="margin-top:16px">' +
+          '<div><div class="label">Since Last Seen</div><div class="audit-list" style="margin-top:8px">' +
+            '<div class="audit-row">' + renderSinceLastSeenSummary(sinceLastSeen) + '</div>' +
+          '</div></div>' +
+          '<div><div class="label">Delivery Timeline</div><div class="audit-list" style="margin-top:8px">' +
+            renderDeliveryTimeline(deliveryTimeline) +
+          '</div></div>' +
+        '</div>';
+
       el.querySelectorAll('.approve-session-btn').forEach(function (btn) {
         btn.addEventListener('click', async function () {
           const sessionKey = btn.getAttribute('data-session');
@@ -1272,6 +1486,7 @@ Previous chat link: ' + previous
         policy.doc && policy.doc.collaboration_projection && policy.doc.collaboration_projection.preset
           ? policy.doc.collaboration_projection.preset
           : 'balanced';
+      document.getElementById('projectionPolicyPreview').innerHTML = renderProjectionPreviewBlock(state.session && state.session.projectionPreview ? state.session.projectionPreview : null);
       document.getElementById('contactDefault').value = policy.doc.contact_policy.default_action;
       document.getElementById('taskDefault').value = policy.doc.task_policy.default_action;
       document.getElementById('profileDisplayName').value = profile && profile.display_name ? profile.display_name : '';
@@ -1443,6 +1658,7 @@ Previous chat link: ' + previous
       syncSelectedSessionFromOverview();
       renderHeader();
       renderOverview();
+      if (state.currentTab === 'runtime') await maybeMarkGlobalSeen('runtime');
       if (state.selectedSessionKey) {
         await loadSession(state.selectedSessionKey);
       } else {
@@ -1454,10 +1670,14 @@ Previous chat link: ' + previous
 
     async function loadSession(sessionKey) {
       if (!sessionKey) return;
+      const previousSessionKey = state.selectedSessionKey;
       state.selectedSessionKey = sessionKey;
       state.session = await api('/api/runtime/session?session_key=' + encodeURIComponent(sessionKey));
       syncUrlState();
       renderSession();
+      if (state.currentTab === 'runtime') {
+        await maybeMarkSessionSeen(sessionKey, previousSessionKey !== sessionKey);
+      }
     }
 
     async function loadPolicy() {
@@ -1468,6 +1688,7 @@ Previous chat link: ' + previous
     async function loadDecisions() {
       state.decisions = await api('/api/runtime/collaboration-decisions');
       renderDecisionInbox();
+      if (state.currentTab === 'decisions') await maybeMarkGlobalSeen('decisions');
     }
 
     async function refreshAll() {
@@ -1897,6 +2118,42 @@ function readProjectionOutboxState(storePath, limit = 20) {
     store.close();
   }
 }
+function readTransportHealthState(storePath) {
+  const store = new LocalStore(storePath);
+  try {
+    const eventManager = new CollaborationEventManager(store);
+    const outboxManager = new CollaborationProjectionOutboxManager(store);
+    const runtimeStatus = readIngressRuntimeStatus();
+    const preference = readTransportPreference();
+    const normalizedStatus = runtimeStatus ? {
+      ...runtimeStatus,
+      preferred_transport_mode: preference?.preferred_mode ?? runtimeStatus.preferred_transport_mode ?? "bridge"
+    } : {
+      receive_mode: "webhook",
+      transport_mode: preference?.preferred_mode ?? "bridge",
+      preferred_transport_mode: preference?.preferred_mode ?? "bridge"
+    };
+    return deriveTransportHealth({
+      runtime_status: normalizedStatus,
+      recent_events: eventManager.listRecent(30),
+      projection_outbox_failed: outboxManager.listByStatus("failed", 20)
+    });
+  } finally {
+    store.close();
+  }
+}
+function readSinceLastSeenState(storePath, operatorId, scopeType, scopeKey) {
+  const store = new LocalStore(storePath);
+  try {
+    return summarizeSinceLastSeen(store, {
+      operator_id: operatorId,
+      scope_type: scopeType,
+      scope_key: scopeKey
+    });
+  } finally {
+    store.close();
+  }
+}
 function buildPolicyDecisionShape(identityPath, remoteDid, opts) {
   const policy = readTrustPolicyDoc(identityPath);
   const runtimeMode = opts?.runtimeMode ?? getRuntimeMode();
@@ -2009,6 +2266,15 @@ async function buildRuntimeOverviewPayload(ctx) {
   }, {});
   const collaborationSummary = collaborationEventManager.summarize(200);
   const projectionOutbox = readProjectionOutboxState(ctx.storePath, 20);
+  const transportHealth = readTransportHealthState(ctx.storePath);
+  const sinceLastSeen = readSinceLastSeenState(ctx.storePath, "host_panel", "global");
+  const decisionStore = new LocalStore(ctx.storePath);
+  let decisionViews = [];
+  try {
+    decisionViews = listPendingDecisionViews(decisionStore, 100);
+  } finally {
+    decisionStore.close();
+  }
   return {
     did: ctx.myDid,
     serverUrl: ctx.serverUrl,
@@ -2046,6 +2312,9 @@ async function buildRuntimeOverviewPayload(ctx) {
     recommendationSummary: recommendationState.summary,
     collaborationSummary,
     projectionOutbox,
+    transportHealth,
+    sinceLastSeen,
+    pendingDecisions: decisionViews,
     recentCollaborationEvents: collaborationEventManager.listRecent(20),
     sessions: sessions.map((session) => ({
       ...session,
@@ -2054,7 +2323,8 @@ async function buildRuntimeOverviewPayload(ctx) {
       binding_alert: session.conversation_id ? bindingAlertByConversation.get(session.conversation_id) ?? null : null,
       is_active_work_session: session.session_key === activeWorkSession,
       latest_messages: session.conversation_id ? historyManager.listRecent(session.conversation_id, 3) : [],
-      collaboration_events: collaborationEventManager.listBySession(session.session_key, 3)
+      collaboration_events: collaborationEventManager.listBySession(session.session_key, 3),
+      since_last_seen: readSinceLastSeenState(ctx.storePath, "host_panel", "session", session.session_key)
     })),
     tasks: refreshedTasks.map((task) => ({
       ...task,
@@ -2111,8 +2381,25 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
   });
   const outboxStore = new LocalStore(ctx.storePath);
   let projectionOutbox = [];
+  let sinceLastSeen = null;
+  let deliveryTimeline = [];
+  let projectionPreview = null;
+  let pendingDecisionViews = [];
   try {
     projectionOutbox = new CollaborationProjectionOutboxManager(outboxStore).listBySession(session.session_key, 20);
+    sinceLastSeen = summarizeSinceLastSeen(outboxStore, {
+      operator_id: "host_panel",
+      scope_type: "session",
+      scope_key: session.session_key
+    });
+    deliveryTimeline = buildDeliveryTimeline(outboxStore, session.session_key, 40);
+    projectionPreview = buildProjectionPreview(
+      outboxStore,
+      session.session_key,
+      policy.collaboration_projection.preset,
+      5
+    );
+    pendingDecisionViews = listPendingDecisionViews(outboxStore, 100).filter((event) => event.session_key === session.session_key).slice(0, 20);
   } finally {
     outboxStore.close();
   }
@@ -2120,9 +2407,10 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
     session,
     sessionSummary: sessionSummaryManager.get(session.session_key),
     collaborationEvents: collaborationEventManager.listBySession(session.session_key, 40),
-    pendingCollaborationEvents: collaborationEventManager.listPendingBySession(session.session_key, 20),
+    pendingCollaborationEvents: pendingDecisionViews,
     collaborationSummary: collaborationEventManager.summarize(200),
     ingressRuntime: readIngressRuntimeStatus(),
+    transportHealth: readTransportHealthState(ctx.storePath),
     binding,
     bindingAlert,
     activeWorkSession,
@@ -2131,6 +2419,9 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
     sessionBindingAlertsPath: getSessionBindingAlertsFilePath(),
     collaborationProjection: policy.collaboration_projection,
     projectionOutbox,
+    sinceLastSeen,
+    deliveryTimeline,
+    projectionPreview,
     policyExplain: buildPolicyDecisionShape(ctx.identityPath, session.remote_did, { runtimeMode: getRuntimeMode() }),
     tasks: tasks.map((task) => ({
       ...task,
@@ -2207,6 +2498,70 @@ async function handleApi(pathname, req, ctx) {
         status: readIngressRuntimeStatus()
       };
     }
+    if (parts[1] === "transport-health" && req.method === "GET") {
+      return {
+        transportHealth: readTransportHealthState(ctx.storePath),
+        transportPreference: readTransportPreference()
+      };
+    }
+    if (parts[1] === "transport-switch" && req.method === "POST") {
+      const body = await readBody(req);
+      const mode = String(body?.mode ?? "").trim().toLowerCase();
+      if (mode !== "bridge" && mode !== "channel") throw new Error("mode must be bridge or channel");
+      const result = switchTransportPreference(mode, {
+        updated_by: "host_panel"
+      });
+      const store = new LocalStore(ctx.storePath);
+      try {
+        new CollaborationEventManager(store).record({
+          event_type: "transport_switched",
+          severity: result.restarted ? "notice" : "warning",
+          summary: result.restarted ? `Preferred transport switched to ${mode}. A managed restart was attempted.` : `Preferred transport switched to ${mode}. 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();
+      }
+      return {
+        ok: true,
+        result,
+        transportHealth: readTransportHealthState(ctx.storePath)
+      };
+    }
+    if (parts[1] === "seen" && req.method === "POST") {
+      const body = await readBody(req);
+      const operatorId = String(body?.operator_id ?? "host_panel").trim();
+      const scopeType = String(body?.scope_type ?? "global").trim();
+      const scopeKey = typeof body?.scope_key === "string" ? body.scope_key.trim() : void 0;
+      if (!["host_panel", "tui", "mcp"].includes(operatorId)) throw new Error("operator_id must be host_panel, tui, or mcp");
+      if (scopeType !== "global" && scopeType !== "session") throw new Error("scope_type must be global or session");
+      const store = new LocalStore(ctx.storePath);
+      try {
+        const seen = new OperatorSeenStateManager(store).markSeen({
+          operator_id: operatorId,
+          scope_type: scopeType,
+          scope_key: scopeType === "session" ? scopeKey : null,
+          last_seen_ts: Date.now()
+        });
+        return {
+          ok: true,
+          seen,
+          summary: summarizeSinceLastSeen(store, {
+            operator_id: operatorId,
+            scope_type: scopeType,
+            scope_key: scopeType === "session" ? scopeKey : null
+          })
+        };
+      } finally {
+        store.close();
+      }
+    }
     if (parts[1] === "demo" && req.method === "POST") {
       const body = await readBody(req);
       const preset = typeof body?.preset === "string" ? body.preset.trim().toLowerCase() : "";
@@ -2262,7 +2617,7 @@ async function handleApi(pathname, req, ctx) {
         const manager = new CollaborationEventManager(store);
         const outboxManager = new CollaborationProjectionOutboxManager(store);
         if (req.method === "GET") {
-          const pendingDecisions = manager.listPending(100);
+          const pendingDecisions = listPendingDecisionViews(store, 100);
           return {
             pendingDecisions,
             projectionOutboxPending: outboxManager.listByStatus("pending", 50),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pingagent/sdk",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -35,8 +35,8 @@
     "uuid": "^11.0.0",
     "ws": "^8.0.0",
     "@pingagent/protocol": "0.1.1",
-    "@pingagent/a2a": "0.1.1",
-    "@pingagent/schemas": "0.1.4"
+    "@pingagent/schemas": "0.1.4",
+    "@pingagent/a2a": "0.1.1"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",