@pingagent/sdk 0.1.15 → 0.1.17

package/dist/web-server.js

@@ -2,7 +2,9 @@ import {
   CollaborationEventManager,
   CollaborationProjectionOutboxManager,
   ContactManager,
+  HumanDeliveryBindingManager,
   LocalStore,
+  NotificationIntentManager,
   OperatorSeenStateManager,
   PingAgentClient,
   TrustPolicyAuditManager,
@@ -12,6 +14,7 @@ import {
   decideContactPolicy,
   decideTaskPolicy,
   defaultTrustPolicyDoc,
+  deriveOpenClawAgentState,
   deriveTransportHealth,
   ensureTokenValid,
   getActiveSessionFilePath,
@@ -19,6 +22,7 @@ import {
   getSessionMapFilePath,
   getTrustRecommendationActionLabel,
   listPendingDecisionViews,
+  listRecentBindingsForSession,
   loadIdentity,
   normalizeTrustPolicyDoc,
   readCurrentActiveSessionKey,
@@ -28,12 +32,13 @@ import {
   readTransportPreference,
   removeSessionBinding,
   setSessionBinding,
+  summarizeHumanDelivery,
   summarizeSinceLastSeen,
   summarizeTrustPolicyAudit,
   switchTransportPreference,
   updateStoredToken,
   upsertTrustPolicyRecommendation
-} from "./chunk-BCYHGKQE.js";
+} from "./chunk-IB7OSFZS.js";
 
 // src/web-server.ts
 import * as fs from "fs";
@@ -259,8 +264,8 @@ function getHostPanelHtml() {
             <div class="audit-list" id="decisionInboxList"></div>
           </div>
           <div class="card">
-            <h2>Projection Delivery</h2>
-            <div id="projectionOutboxSummary" class="muted small" style="margin-bottom:12px">Loading projection delivery state\u2026</div>
+            <h2>Human Delivery</h2>
+            <div id="projectionOutboxSummary" class="muted small" style="margin-bottom:12px">Loading human-delivery state\u2026</div>
             <div class="audit-list" id="projectionOutboxList"></div>
           </div>
         </div>
@@ -277,7 +282,7 @@ function getHostPanelHtml() {
                 <option value="balanced">balanced</option>
                 <option value="strict">strict</option>
               </select>
-              <div class="muted small">Balanced is the default: key conclusions, handoffs, repairs, and required decisions are pushed to the human thread; ordinary progress stays summary-first.</div>
+              <div class="muted small">Balanced is the default: key conclusions, handoffs, repairs, and required decisions become notification intents and are sent through bound-channel reply; ordinary progress stays summary-first.</div>
               <div class="row-actions">
                 <button class="action-btn" id="saveProjectionPresetBtn">Save projection preset</button>
               </div>
@@ -540,6 +545,96 @@ function getHostPanelHtml() {
       }).join('');
     }
 
+    function renderHumanDeliveryIntents(intents, emptyLabel) {
+      if (!Array.isArray(intents) || !intents.length) {
+        return '<div class="empty">' + esc(emptyLabel || 'No notification intents yet.') + '</div>';
+      }
+      return intents.map(function (intent) {
+        const bindingLabel = intent.resolved_binding_id ? ('binding=' + intent.resolved_binding_id) : 'binding=(unresolved)';
+        const ackLabel = intent.acknowledged_at
+          ? (' \xB7 ack=' + fmtTs(intent.acknowledged_at))
+          : '';
+        const actions = [];
+        if (intent.status === 'failed' || intent.status === 'unresolved') {
+          actions.push('<button class="secondary-btn human-delivery-action-btn" data-action="retry_intent" data-intent-id="' + esc(intent.id) + '">Retry</button>');
+          actions.push('<button class="secondary-btn human-delivery-action-btn" data-action="re_resolve_intent_binding" data-intent-id="' + esc(intent.id) + '">Re-resolve</button>');
+        } else if (intent.status === 'pending' || intent.status === 'bound' || intent.status === 'sent') {
+          actions.push('<button class="secondary-btn human-delivery-action-btn" data-action="re_resolve_intent_binding" data-intent-id="' + esc(intent.id) + '">Re-resolve</button>');
+        }
+        if (intent.status !== 'canceled' && intent.status !== 'acknowledged') {
+          actions.push('<button class="danger-btn human-delivery-action-btn" data-action="cancel_intent" data-intent-id="' + esc(intent.id) + '">Cancel</button>');
+        }
+        return '<div class="audit-row"><div class="top"><strong>' + esc(intent.title || intent.summary || '(no title)') + '</strong>' +
+          '<span class="badge">' + esc(intent.status || 'pending') + '</span></div>' +
+          '<div class="muted small">' + esc(fmtTs(intent.created_at || intent.updated_at)) + ' \xB7 type=' + esc(intent.intent_type || 'collaboration_update') + ' \xB7 ' + esc(bindingLabel) + esc(ackLabel) + '</div>' +
+          '<div style="margin-top:8px">' + esc(intent.summary || '(no summary)') + '</div>' +
+          (intent.last_error ? '<div class="muted small" style="margin-top:8px;color:#fecaca">' + esc(intent.last_error) + '</div>' : '') +
+          (actions.length ? '<div class="row-actions" style="margin-top:10px">' + actions.join('') + '</div>' : '') +
+        '</div>';
+      }).join('');
+    }
+
+    function renderRecentBindings(bindings) {
+      if (!Array.isArray(bindings) || !bindings.length) {
+        return '<div class="empty">No human reply targets recorded yet. Once a person talks to OpenClaw from any channel, the explicit reply target will appear here.</div>';
+      }
+      return bindings.map(function (binding) {
+        const actions = binding.status === 'active'
+          ? '<div class="row-actions" style="margin-top:10px"><button class="secondary-btn human-delivery-action-btn" data-action="mark_binding_stale" data-binding-id="' + esc(binding.id) + '">Mark stale</button></div>'
+          : '';
+        return '<div class="audit-row"><div class="top"><strong>' + esc(binding.channel + ' -> ' + binding.to) + '</strong>' +
+          '<span class="badge">' + esc(binding.status || 'active') + '</span></div>' +
+          '<div class="muted small">' + esc(fmtTs(binding.last_inbound_at || binding.updated_at)) + ' \xB7 owner=' + esc(binding.owner_ref || '(none)') + '</div>' +
+          '<div class="muted small" style="margin-top:8px">session=' + esc(binding.source_session_key || '(none)') + ' \xB7 conversation=' + esc(binding.source_conversation_id || '(none)') + '</div>' +
+          actions +
+        '</div>';
+      }).join('');
+    }
+
+    function renderHumanDeliveryCapabilities(humanDelivery) {
+      const capabilities = Array.isArray(humanDelivery && humanDelivery.channel_capabilities) ? humanDelivery.channel_capabilities : [];
+      if (!capabilities.length) {
+        return '<div class="empty">No channel capability data yet.</div>';
+      }
+      return capabilities.map(function (cap) {
+        const supportLabel = cap.supports_explicit_send ? 'explicit-send' : 'unsupported';
+        const canary = cap.last_canary_at
+          ? (' \xB7 canary=' + (cap.last_canary_ok ? 'ok' : 'failed') + ' @ ' + fmtTs(cap.last_canary_at))
+          : ' \xB7 canary=pending';
+        return '<div class="audit-row"><div class="top"><strong>' + esc(cap.channel) + '</strong><span class="badge">' + esc(supportLabel) + '</span></div>' +
+          '<div class="muted small">configured=' + esc(cap.configured ? 'true' : 'false') + ' \xB7 thread=' + esc(cap.supports_thread_id ? 'yes' : 'no') + ' \xB7 account=' + esc(cap.supports_account_id ? 'yes' : 'no') + ' \xB7 dry_run=' + esc(cap.supports_dry_run ? 'yes' : 'no') + esc(canary) + '</div>' +
+          (cap.last_canary_error ? '<div class="muted small" style="margin-top:8px;color:#fecaca">' + esc(cap.last_canary_error) + '</div>' : '') +
+        '</div>';
+      }).join('');
+    }
+
+    async function runHumanDeliveryAction(action, payload) {
+      return api('/api/runtime/human-delivery/action', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(Object.assign({ action: action }, payload || {})),
+      });
+    }
+
+    function wireHumanDeliveryActionButtons(root) {
+      if (!root || !root.querySelectorAll) return;
+      root.querySelectorAll('.human-delivery-action-btn').forEach(function (btn) {
+        btn.addEventListener('click', async function () {
+          const action = btn.getAttribute('data-action');
+          if (!action) return;
+          const intentId = btn.getAttribute('data-intent-id');
+          const bindingId = btn.getAttribute('data-binding-id');
+          await runHumanDeliveryAction(action, {
+            intent_id: intentId ? Number(intentId) : undefined,
+            binding_id: bindingId ? Number(bindingId) : undefined,
+          });
+          await refreshAll();
+          if (state.selectedSessionKey) await loadSession(state.selectedSessionKey);
+          setTab(state.tab || 'runtime');
+        });
+      });
+    }
+
     async function markSeen(scopeType, scopeKey) {
       return api('/api/runtime/seen', {
         method: 'POST',
@@ -772,7 +867,7 @@ function getHostPanelHtml() {
           event.approval_required
             ? '<span class="badge">' + esc(event.approval_status === 'pending' ? 'review' : event.approval_status) + '</span>'
             : '',
-          event.target_human_session ? '<span class="badge">human thread</span>' : '',
+          event.target_human_session ? '<span class="badge">human delivery</span>' : '',
         ].filter(Boolean).join('');
         const actions = event.approval_required && event.approval_status === 'pending'
           ? '<div class="row-actions" style="margin-top:10px">' +
@@ -804,8 +899,14 @@ function getHostPanelHtml() {
       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 overdue=' + overdueDecisions.length + ' \xB7 projection_pending=' + pendingOutbox.length + ' \xB7 projection_failed=' + failedOutbox.length;
+      const pendingIntents = data && Array.isArray(data.notificationIntentsPending) ? data.notificationIntentsPending : [];
+      const unresolvedIntents = data && Array.isArray(data.notificationIntentsUnresolved) ? data.notificationIntentsUnresolved : [];
+      const failedIntents = data && Array.isArray(data.notificationIntentsFailed) ? data.notificationIntentsFailed : [];
+      const humanDelivery = data && data.humanDelivery ? data.humanDelivery : null;
+      const boundChannelReply = !!(humanDelivery && humanDelivery.mode === 'bound_channel_reply');
+      document.getElementById('decisionInboxSummary').textContent = boundChannelReply
+        ? ('pending=' + pendingDecisions.length + ' \xB7 overdue=' + overdueDecisions.length + ' \xB7 notify_pending=' + pendingIntents.length + ' \xB7 unresolved=' + unresolvedIntents.length + ' \xB7 notify_failed=' + failedIntents.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>' +
@@ -824,20 +925,26 @@ function getHostPanelHtml() {
         : '<div class="empty">No pending collaboration decisions.</div>';
 
       const combinedOutbox = pendingOutbox.concat(failedOutbox);
-      document.getElementById('projectionOutboxSummary').textContent =
-        combinedOutbox.length
-          ? 'Human-thread projection uses a stable outbox. Failed rows stay visible until delivery recovers.'
-          : 'No undelivered human-thread projections.';
-      document.getElementById('projectionOutboxList').innerHTML = combinedOutbox.length
-        ? combinedOutbox.map(function (entry) {
-            return '<div class="audit-row"><div class="top"><strong>' + esc(entry.summary || '(no summary)') + '</strong>' +
-              '<span class="badge">' + esc(entry.status || 'pending') + '</span></div>' +
-              '<div class="muted small">' + esc(fmtTs(entry.created_at)) + ' \xB7 kind=' + esc(entry.projection_kind || 'collaboration_update') + ' \xB7 attempts=' + esc(entry.attempt_count || 0) + '</div>' +
-              '<div class="muted small" style="margin-top:8px">target=' + esc(entry.target_human_session || '(missing)') + ' \xB7 session=' + esc(entry.session_key || '(none)') + '</div>' +
-              (entry.last_error ? '<div style="margin-top:8px">' + esc(entry.last_error) + '</div>' : '') +
-            '</div>';
-          }).join('')
-        : '<div class="empty">No pending or failed projection deliveries.</div>';
+      document.getElementById('projectionOutboxSummary').textContent = boundChannelReply
+        ? ('bound reply mode \xB7 pending=' + pendingIntents.length + ' \xB7 unresolved=' + unresolvedIntents.length + ' \xB7 failed=' + failedIntents.length)
+        : (combinedOutbox.length
+          ? 'Legacy projection outbox remains visible for audit and compatibility. Failed rows stay visible until delivery recovers.'
+          : 'No legacy projection-outbox rows need attention.');
+      document.getElementById('projectionOutboxList').innerHTML = boundChannelReply
+        ? renderHumanDeliveryIntents(
+            pendingIntents.concat(unresolvedIntents).concat(failedIntents),
+            'No pending, unresolved, or failed human-delivery intents.',
+          )
+        : (combinedOutbox.length
+          ? combinedOutbox.map(function (entry) {
+              return '<div class="audit-row"><div class="top"><strong>' + esc(entry.summary || '(no summary)') + '</strong>' +
+                '<span class="badge">' + esc(entry.status || 'pending') + '</span></div>' +
+                '<div class="muted small">' + esc(fmtTs(entry.created_at)) + ' \xB7 kind=' + esc(entry.projection_kind || 'collaboration_update') + ' \xB7 attempts=' + esc(entry.attempt_count || 0) + '</div>' +
+                '<div class="muted small" style="margin-top:8px">target=' + esc(entry.target_human_session || '(missing)') + ' \xB7 session=' + esc(entry.session_key || '(none)') + '</div>' +
+                (entry.last_error ? '<div style="margin-top:8px">' + esc(entry.last_error) + '</div>' : '') +
+              '</div>';
+            }).join('')
+          : '<div class="empty">No pending or failed legacy projection deliveries.</div>');
 
       document.querySelectorAll('.inbox-decision-btn').forEach(function (btn) {
         btn.addEventListener('click', async function () {
@@ -864,6 +971,7 @@ function getHostPanelHtml() {
           setTab('runtime');
         });
       });
+      wireHumanDeliveryActionButtons(document.getElementById('projectionOutboxList'));
     }
 
     function getOverviewSessions() {
@@ -901,22 +1009,41 @@ function getHostPanelHtml() {
       if (!overview) return;
       syncSelectedSessionFromOverview();
       const ingressState = ingressStatusModel(overview);
+      const agentState = overview.agentState || null;
       const transportHealth = overview.transportHealth || null;
       const sinceLastSeen = overview.sinceLastSeen || null;
+      const humanDelivery = overview.humanDelivery || null;
       const overdueDecisions = Array.isArray(overview.pendingDecisions)
         ? overview.pendingDecisions.filter(function (event) { return !!event.overdue; })
         : [];
+      const statusClass = agentState && (agentState.blocked || agentState.degraded)
+        ? 'degraded'
+        : ingressState.className;
+      const statusLabel = agentState && agentState.state
+        ? agentState.state
+        : ingressState.label;
+      const statusDetail = agentState && agentState.summary
+        ? agentState.summary
+        : ingressState.detail;
       document.getElementById('activationCard').innerHTML =
         '<div class="status-strip">' +
           '<div class="status-main">' +
-            '<h2>Activation</h2>' +
-            '<div class="status-state ' + ingressState.className + '">' + esc(ingressState.label) + '</div>' +
-            '<div class="muted small">' + esc(ingressState.detail) + '</div>' +
+            '<h2>Agent Runtime</h2>' +
+            '<div class="status-state ' + statusClass + '">' + esc(statusLabel) + '</div>' +
+            '<div class="muted small">' + esc(statusDetail) + '</div>' +
+            (agentState && agentState.next_action
+              ? '<div class="muted small">next_action=' + esc(agentState.next_action) + '</div>'
+              : '') +
+            (agentState && agentState.reason
+              ? '<div class="muted small">reason=' + esc(agentState.reason) + '</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>' +
+              '<span class="pill">projection_policy=' + esc(overview.collaborationProjection && overview.collaborationProjection.preset ? overview.collaborationProjection.preset : 'balanced') + '</span>' +
+              (humanDelivery ? '<span class="pill">human_delivery=' + esc(humanDelivery.mode || 'projection_outbox') + '</span>' : '') +
+              (agentState && agentState.active_session_key ? '<span class="pill">active_session=ready</span>' : '') +
             '</div>' +
           '</div>' +
           '<div style="min-width:320px">' +
@@ -945,18 +1072,28 @@ function getHostPanelHtml() {
         { label: 'Tasks', value: overview.tasksTotal, sub: 'recent local task threads' },
         { label: 'Audit', value: overview.auditSummary.total_events, sub: 'policy / runtime audit events' },
         { label: 'Collaboration', value: overview.collaborationSummary ? overview.collaborationSummary.total_events : 0, sub: overview.collaborationSummary ? ('pending_review=' + overview.collaborationSummary.pending_approvals) : 'projected external collaboration events' },
+        { label: 'Human Delivery', value: humanDelivery ? ((humanDelivery.pending_intents || 0) + '/' + (humanDelivery.active_bindings || 0)) : '-', sub: humanDelivery ? ('mode=' + (humanDelivery.mode || 'projection_outbox') + ' unresolved=' + (humanDelivery.unresolved_intents || 0) + ' failed=' + (humanDelivery.failed_intents || 0)) : 'binding-based human notification state' },
         { label: 'Recommendations', value: overview.recommendationSummary ? overview.recommendationSummary.total : overview.recommendations.length, sub: overview.recommendationSummary ? JSON.stringify(overview.recommendationSummary.by_status || {}) : 'learned policy suggestions' },
         { label: 'Public Link', value: overview.publicSelf && overview.publicSelf.public_url ? 'ready' : 'disabled', sub: overview.publicSelf && overview.publicSelf.public_url ? overview.publicSelf.public_url : 'create a hosted shareable profile link' },
       ];
       document.getElementById('statsGrid').innerHTML = stats.map(function (item) {
         return '<div class="card"><div class="label">' + esc(item.label) + '</div><div class="value">' + esc(item.value) + '</div><div class="muted small">' + esc(item.sub) + '</div></div>';
       }).join('');
+      document.getElementById('taskList').innerHTML = '<div class="task-row"><div class="top"><strong>Human Delivery Channels</strong><span class="badge">' + esc((humanDelivery && humanDelivery.supported_channels ? humanDelivery.supported_channels.length : 0) + '/' + (humanDelivery && humanDelivery.channel_capabilities ? humanDelivery.channel_capabilities.length : 0)) + '</span></div>' +
+        '<div class="muted small">Capabilities and canary state for explicit human-delivery replies.</div>' +
+        '<div class="audit-list" style="margin-top:8px">' + renderHumanDeliveryCapabilities(humanDelivery) + '</div></div>';
 
       const toggleUnreadBtn = document.getElementById('toggleUnreadBtn');
       if (toggleUnreadBtn) toggleUnreadBtn.textContent = 'Unread only: ' + (state.showUnreadOnly ? 'on' : 'off');
       const sessions = getVisibleSessions();
       if (!sessions.length) {
-        document.getElementById('sessionList').innerHTML = '<div class="empty">' + (state.showUnreadOnly ? 'No unread sessions.' : 'No sessions yet.') + '</div>';
+        document.getElementById('sessionList').innerHTML = '<div class="empty">' + (
+          state.showUnreadOnly
+            ? 'No unread sessions.'
+            : (agentState && agentState.summary
+              ? agentState.summary + ' Wait for inbound work or review pending decisions.'
+              : 'No sessions yet.')
+        ) + '</div>';
       } else {
         document.getElementById('sessionList').innerHTML = sessions.map(function (session) {
           const active = session.session_key === state.selectedSessionKey ? ' active' : '';
@@ -966,7 +1103,7 @@ function getHostPanelHtml() {
               ? '<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>'
+              ? '<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="Legacy compatibility route needs attention">Compatibility repair</button>'
               : '',
           ].filter(Boolean).join('');
           return '<div class="session-row' + active + '" data-session="' + esc(session.session_key) + '">' +
@@ -974,7 +1111,7 @@ function getHostPanelHtml() {
             '<div class="muted small">unread=' + esc(session.unread_count) + ' \xB7 last=' + esc(fmtTs(session.last_remote_activity_at || session.updated_at)) + '</div>' +
             (state.detailMode === 'advanced'
               ? '<div class="muted small" style="margin-top:6px">conversation=' + esc(session.conversation_id || '(none)') + '</div>' +
-                '<div class="muted small">work_session=' + esc(session.mapped_work_session || '(unbound)') + (session.is_active_work_session ? ' \xB7 active_chat=true' : '') + '</div>'
+                '<div class="muted small">compatibility_route=' + esc(session.mapped_work_session || '(unbound)') + (session.is_active_work_session ? ' \xB7 active_route=true' : '') + '</div>'
               : '') +
             '<div class="muted small" style="margin-top:6px">' + esc(session.last_message_preview || '(no preview)') + '</div>' +
           '</div>';
@@ -1022,7 +1159,7 @@ function getHostPanelHtml() {
       });
 
       const tasks = Array.isArray(overview.tasks) ? overview.tasks : [];
-      document.getElementById('taskList').innerHTML = tasks.length
+      document.getElementById('taskList').innerHTML += tasks.length
         ? tasks.map(function (task) {
             return '<div class="task-row"><div class="top"><strong>' + esc(task.title || task.task_id) + '</strong><span class="badge">' + esc(task.status) + '</span></div>' +
               '<div class="muted small">task_id=' + esc(task.task_id) + ' \xB7 session=' + esc(task.session_key) + '</div>' +
@@ -1031,7 +1168,7 @@ function getHostPanelHtml() {
               (task.error_message ? '<div style="margin-top:8px;color:#fca5a5">' + esc(task.error_message) + '</div>' : '') +
               renderHandoffBlock(task.handoff) +
             '</div>';
-          }).join('')
+        }).join('')
         : '<div class="empty">No recent task threads.</div>';
 
       if (subscription) {
@@ -1125,10 +1262,13 @@ conversation=' + result.conversation_id));
         ? detail.collaborationProjection.preset
         : 'balanced';
       const projectionOutbox = Array.isArray(detail.projectionOutbox) ? detail.projectionOutbox : [];
+      const recentBindings = Array.isArray(detail.recentBindings) ? detail.recentBindings : [];
+      const recentNotificationIntents = Array.isArray(detail.recentNotificationIntents) ? detail.recentNotificationIntents : [];
       const sinceLastSeen = detail.sinceLastSeen || null;
       const deliveryTimeline = Array.isArray(detail.deliveryTimeline) ? detail.deliveryTimeline : [];
       const projectionPreview = detail.projectionPreview || null;
       const transportHealth = detail.transportHealth || null;
+      const humanDelivery = detail.humanDelivery || null;
       const isAdvanced = state.detailMode === 'advanced';
       const sessionLink = buildSessionLink(session.session_key);
       const summaryPills = [];
@@ -1136,8 +1276,8 @@ conversation=' + result.conversation_id));
       if (task && task.action) summaryPills.push('<span class="pill">task=' + esc(task.action) + '</span>');
       if (session.trust_state) summaryPills.push('<span class="pill">trust=' + esc(session.trust_state) + '</span>');
       if (Number(session.unread_count || 0) > 0) summaryPills.push('<span class="pill">unread=' + esc(session.unread_count) + '</span>');
-      if (binding && binding.session_key) summaryPills.push('<span class="pill">chat link attached</span>');
-      else if (activeWorkSession) summaryPills.push('<span class="pill">current OpenClaw chat available</span>');
+      if (binding && binding.target_key) summaryPills.push('<span class="pill">human reply target ready</span>');
+      if (isAdvanced && activeWorkSession) summaryPills.push('<span class="pill">compatibility route available</span>');
       const policyBlock = isAdvanced
         ? '<pre style="margin-top:8px">[Contact]\\naction=' + esc(contact.action) + '\\nsource=' + esc(contact.source) + (contact.matched_rule ? '\\nmatched_rule=' + esc(contact.matched_rule) : '') + '\\n' + esc(contact.explanation) + '\\n\\n[Task]\\naction=' + esc(task.action) + '\\nsource=' + esc(task.source) + (task.matched_rule ? '\\nmatched_rule=' + esc(task.matched_rule) : '') + '\\n' + esc(task.explanation) + '</pre>'
         : '<div class="summary-pills" style="margin-top:8px">' + summaryPills.join('') + '</div>' +
@@ -1155,8 +1295,8 @@ conversation=' + result.conversation_id));
               ? '<div style="margin-top:8px">' +
                   '<div class="muted small">session=' + esc(session.session_key) + '</div>' +
                   '<div class="muted small">conversation=' + esc(session.conversation_id || '(none)') + '</div>' +
-                  '<div class="muted small">active_chat_session=' + esc(activeWorkSession || '(none)') + '</div>' +
-                  '<div class="muted small">binding=' + esc(binding ? binding.session_key : '(unbound)') + '</div>' +
+                  '<div class="muted small">compatibility_active_session=' + esc(activeWorkSession || '(none)') + '</div>' +
+                  '<div class="muted small">reply_binding=' + esc(binding ? (binding.target_key || binding.session_key || '(bound)') : '(unbound)') + '</div>' +
                 '</div>'
               : '') +
             (openRecommendation
@@ -1164,11 +1304,11 @@ 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 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 this session is treated as settled. 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>'
+              ? '<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>Compatibility route stale</strong><div class="small" style="margin-top:6px">' + esc(isAdvanced ? (bindingAlert.message || 'Legacy current-thread compatibility routing is missing. Repair it only if you intentionally depend on the compatibility path.') : 'Legacy current-thread compatibility routing is stale. Default human delivery continues to use bindings + notification intents.') + '</div></div>'
               : '') +
             '<div class="row-actions">' +
               (session.trust_state === 'pending'
@@ -1183,11 +1323,16 @@ conversation=' + result.conversation_id));
               (!openRecommendation && reopenRecommendation
                 ? '<button class="secondary-btn reopen-session-recommendation-btn" data-session="' + esc(session.session_key) + '">Reopen</button>'
                 : '') +
-              '<button class="action-btn bind-current-btn" data-conversation="' + esc(session.conversation_id || '') + '">Attach to Current Chat</button>' +
               '<button class="secondary-btn mark-read-btn" data-session="' + esc(session.session_key) + '">Mark read</button>' +
               '<button class="secondary-btn copy-session-link-btn" data-session="' + esc(session.session_key) + '">Copy Session Link</button>' +
-              '<button class="danger-btn clear-binding-btn" data-conversation="' + esc(session.conversation_id || '') + '">Detach Chat Link</button>' +
+              (isAdvanced
+                ? '<button class="action-btn bind-current-btn" data-conversation="' + esc(session.conversation_id || '') + '">Repair Compatibility Route</button>' +
+                  '<button class="danger-btn clear-binding-btn" data-conversation="' + esc(session.conversation_id || '') + '">Clear Compatibility Route</button>'
+                : '') +
             '</div>' +
+            (isAdvanced
+              ? '<div class="muted small" style="margin-top:8px">Compatibility routing is repair-only. The default human-delivery path uses Human Delivery Binding plus Notification Intent.</div>'
+              : '') +
             '<div class="form-grid" style="margin-top:16px">' +
               '<label class="label">Reply in this session</label>' +
               '<textarea id="sessionReplyInput" placeholder="Send a text reply in this session"></textarea>' +
@@ -1275,9 +1420,9 @@ conversation=' + result.conversation_id));
               '</div>';
             }).join('') : '<div class="empty">No audit events for this session.</div>') +
           '</div></div>' +
-          '<div><div class="label">Human Thread Posture</div><div class="audit-list" style="margin-top:8px">' +
+          '<div><div class="label">Human Delivery 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 class="muted small">The collaboration session keeps the raw transcript. Human-visible updates now flow through Human Delivery Binding plus Notification Intent. Projection outbox remains visible for audit and compatibility.</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">' +
@@ -1289,6 +1434,9 @@ conversation=' + result.conversation_id));
               (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>'
                 : '') +
+              (humanDelivery
+                ? '<div class="muted small" style="margin-top:8px">human_delivery=' + esc(humanDelivery.mode || 'projection_outbox') + ' \xB7 unresolved=' + esc(humanDelivery.unresolved_intents || 0) + ' \xB7 failed=' + esc(humanDelivery.failed_intents || 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>') +
@@ -1307,6 +1455,16 @@ conversation=' + result.conversation_id));
           '</div></div>' +
         '</div>';
 
+      el.innerHTML +=
+        '<div class="grid two-col" style="margin-top:16px">' +
+          '<div><div class="label">Human Reply Targets</div><div class="audit-list" style="margin-top:8px">' +
+            renderRecentBindings(recentBindings) +
+          '</div></div>' +
+          '<div><div class="label">Notification Intents</div><div class="audit-list" style="margin-top:8px">' +
+            renderHumanDeliveryIntents(recentNotificationIntents, 'No notification intents for this session yet.') +
+          '</div></div>' +
+        '</div>';
+
       el.querySelectorAll('.approve-session-btn').forEach(function (btn) {
         btn.addEventListener('click', async function () {
           const sessionKey = btn.getAttribute('data-session');
@@ -1447,6 +1605,7 @@ conversation=' + result.conversation_id));
           setTab('runtime');
         });
       }
+      wireHumanDeliveryActionButtons(el);
     }
 
     async function promptBindCurrentChat(conversationId, previousBinding, remoteDid) {
@@ -1456,7 +1615,7 @@ conversation=' + result.conversation_id));
       const previous = previousBinding || (state.session && state.session.binding ? state.session.binding.session_key : null) || '(unbound)';
       const targetRemoteDid = remoteDid || (state.session && state.session.session ? state.session.session.remote_did : null) || '(unknown)';
       const confirmed = window.confirm(
-        'Attach this PingAgent session to the current OpenClaw chat?' +
+        'Repair the legacy current-thread compatibility route for this PingAgent session?' +
         '
 
 Conversation: ' + conversationId +
@@ -1464,9 +1623,9 @@ Conversation: ' + conversationId +
 Remote DID: ' + targetRemoteDid +
         '
 
-Current OpenClaw chat: ' + (current || '(none)') +
+Current OpenClaw compatibility target: ' + (current || '(none)') +
         '
-Previous chat link: ' + previous
+Previous compatibility route: ' + previous
       );
       if (!confirmed) return;
       await api('/api/runtime/session-bindings/bind-current', {
@@ -2154,6 +2313,24 @@ function readSinceLastSeenState(storePath, operatorId, scopeType, scopeKey) {
     store.close();
   }
 }
+function readHumanDeliveryState(storePath, limit = 12) {
+  const store = new LocalStore(storePath);
+  try {
+    return summarizeHumanDelivery(store, limit);
+  } finally {
+    store.close();
+  }
+}
+function buildOpenClawAgentStatePayload(input) {
+  return deriveOpenClawAgentState({
+    runtime_status: input.runtimeStatus ?? null,
+    sessions: input.sessions ?? [],
+    pending_decisions: Array.isArray(input.pendingDecisions) ? input.pendingDecisions.length : 0,
+    human_delivery: input.humanDelivery ?? null,
+    transport_health: input.transportHealth ?? null,
+    blocked_reason: input.blockedReason ?? null
+  });
+}
 function buildPolicyDecisionShape(identityPath, remoteDid, opts) {
   const policy = readTrustPolicyDoc(identityPath);
   const runtimeMode = opts?.runtimeMode ?? getRuntimeMode();
@@ -2268,13 +2445,30 @@ async function buildRuntimeOverviewPayload(ctx) {
   const projectionOutbox = readProjectionOutboxState(ctx.storePath, 20);
   const transportHealth = readTransportHealthState(ctx.storePath);
   const sinceLastSeen = readSinceLastSeenState(ctx.storePath, "host_panel", "global");
+  const humanDelivery = readHumanDeliveryState(ctx.storePath, 20);
   const decisionStore = new LocalStore(ctx.storePath);
   let decisionViews = [];
+  let humanDeliveryDetails = null;
   try {
     decisionViews = listPendingDecisionViews(decisionStore, 100);
+    const bindingManager = new HumanDeliveryBindingManager(decisionStore);
+    const intentManager = new NotificationIntentManager(decisionStore);
+    humanDeliveryDetails = {
+      unresolved_intents: intentManager.listByStatus("unresolved", 20),
+      failed_intents: intentManager.listByStatus("failed", 20),
+      acknowledged_intents: intentManager.listByStatus("acknowledged", 20),
+      recent_bindings: bindingManager.listRecent(20)
+    };
   } finally {
     decisionStore.close();
   }
+  const agentState = buildOpenClawAgentStatePayload({
+    runtimeStatus: ingressRuntime,
+    sessions,
+    pendingDecisions: decisionViews,
+    humanDelivery,
+    transportHealth
+  });
   return {
     did: ctx.myDid,
     serverUrl: ctx.serverUrl,
@@ -2313,7 +2507,10 @@ async function buildRuntimeOverviewPayload(ctx) {
     collaborationSummary,
     projectionOutbox,
     transportHealth,
+    agentState,
     sinceLastSeen,
+    humanDelivery,
+    humanDeliveryDetails,
     pendingDecisions: decisionViews,
     recentCollaborationEvents: collaborationEventManager.listRecent(20),
     sessions: sessions.map((session) => ({
@@ -2381,12 +2578,17 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
   });
   const outboxStore = new LocalStore(ctx.storePath);
   let projectionOutbox = [];
+  let notificationIntents = [];
+  let recentBindings = [];
   let sinceLastSeen = null;
   let deliveryTimeline = [];
   let projectionPreview = null;
   let pendingDecisionViews = [];
+  let humanDelivery = null;
   try {
     projectionOutbox = new CollaborationProjectionOutboxManager(outboxStore).listBySession(session.session_key, 20);
+    notificationIntents = new NotificationIntentManager(outboxStore).listBySession(session.session_key, 20);
+    recentBindings = listRecentBindingsForSession(outboxStore, session.session_key, session.conversation_id, 20);
     sinceLastSeen = summarizeSinceLastSeen(outboxStore, {
       operator_id: "host_panel",
       scope_type: "session",
@@ -2400,9 +2602,17 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
       5
     );
     pendingDecisionViews = listPendingDecisionViews(outboxStore, 100).filter((event) => event.session_key === session.session_key).slice(0, 20);
+    humanDelivery = summarizeHumanDelivery(outboxStore, 20);
   } finally {
     outboxStore.close();
   }
+  const agentState = buildOpenClawAgentStatePayload({
+    runtimeStatus: readIngressRuntimeStatus(),
+    sessions: sessionManager.listRecentSessions(50),
+    pendingDecisions: pendingDecisionViews,
+    humanDelivery,
+    transportHealth: readTransportHealthState(ctx.storePath)
+  });
   return {
     session,
     sessionSummary: sessionSummaryManager.get(session.session_key),
@@ -2411,6 +2621,7 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
     collaborationSummary: collaborationEventManager.summarize(200),
     ingressRuntime: readIngressRuntimeStatus(),
     transportHealth: readTransportHealthState(ctx.storePath),
+    agentState,
     binding,
     bindingAlert,
     activeWorkSession,
@@ -2419,9 +2630,12 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
     sessionBindingAlertsPath: getSessionBindingAlertsFilePath(),
     collaborationProjection: policy.collaboration_projection,
     projectionOutbox,
+    recentBindings,
+    recentNotificationIntents: notificationIntents,
     sinceLastSeen,
     deliveryTimeline,
     projectionPreview,
+    humanDelivery,
     policyExplain: buildPolicyDecisionShape(ctx.identityPath, session.remote_did, { runtimeMode: getRuntimeMode() }),
     tasks: tasks.map((task) => ({
       ...task,
@@ -2504,6 +2718,57 @@ async function handleApi(pathname, req, ctx) {
         transportPreference: readTransportPreference()
       };
     }
+    if (parts[1] === "human-delivery") {
+      const store = new LocalStore(ctx.storePath);
+      try {
+        const bindingManager = new HumanDeliveryBindingManager(store);
+        const intentManager = new NotificationIntentManager(store);
+        if (req.method === "GET") {
+          return {
+            humanDelivery: summarizeHumanDelivery(store, 20),
+            recentBindings: bindingManager.listRecent(50),
+            unresolvedIntents: intentManager.listByStatus("unresolved", 50),
+            failedIntents: intentManager.listByStatus("failed", 50),
+            acknowledgedIntents: intentManager.listByStatus("acknowledged", 50)
+          };
+        }
+        if (req.method === "POST" && parts[2] === "action") {
+          const body = await readBody(req);
+          const action = String(body?.action ?? "").trim();
+          const intentId = Number(body?.intent_id);
+          const bindingId = Number(body?.binding_id);
+          let intent = null;
+          let binding = null;
+          if (action === "retry_intent") {
+            if (!Number.isInteger(intentId) || intentId <= 0) throw new Error("intent_id is required");
+            intent = intentManager.markPending(intentId, { clear_error: true, clear_ack: false, clear_binding: false });
+          } else if (action === "re_resolve_intent_binding") {
+            if (!Number.isInteger(intentId) || intentId <= 0) throw new Error("intent_id is required");
+            intent = intentManager.markPending(intentId, { clear_error: true, clear_ack: false, clear_binding: true });
+          } else if (action === "cancel_intent") {
+            if (!Number.isInteger(intentId) || intentId <= 0) throw new Error("intent_id is required");
+            intent = intentManager.markCanceled(intentId, "manual_cancel");
+          } else if (action === "mark_binding_stale") {
+            if (!Number.isInteger(bindingId) || bindingId <= 0) throw new Error("binding_id is required");
+            binding = bindingManager.markStale(bindingId);
+          } else {
+            throw new Error("action must be retry_intent, re_resolve_intent_binding, cancel_intent, or mark_binding_stale");
+          }
+          return {
+            ok: true,
+            action,
+            intent,
+            binding,
+            humanDelivery: summarizeHumanDelivery(store, 20),
+            unresolvedIntents: intentManager.listByStatus("unresolved", 50),
+            failedIntents: intentManager.listByStatus("failed", 50),
+            acknowledgedIntents: intentManager.listByStatus("acknowledged", 50)
+          };
+        }
+      } finally {
+        store.close();
+      }
+    }
     if (parts[1] === "transport-switch" && req.method === "POST") {
       const body = await readBody(req);
       const mode = String(body?.mode ?? "").trim().toLowerCase();
@@ -2618,10 +2883,15 @@ async function handleApi(pathname, req, ctx) {
         const outboxManager = new CollaborationProjectionOutboxManager(store);
         if (req.method === "GET") {
           const pendingDecisions = listPendingDecisionViews(store, 100);
+          const intentManager = new NotificationIntentManager(store);
           return {
             pendingDecisions,
             projectionOutboxPending: outboxManager.listByStatus("pending", 50),
-            projectionOutboxFailed: outboxManager.listByStatus("failed", 50)
+            projectionOutboxFailed: outboxManager.listByStatus("failed", 50),
+            notificationIntentsPending: intentManager.listByStatus("pending", 50).concat(intentManager.listByStatus("bound", 50)),
+            notificationIntentsUnresolved: intentManager.listByStatus("unresolved", 50),
+            notificationIntentsFailed: intentManager.listByStatus("failed", 50),
+            humanDelivery: summarizeHumanDelivery(store, 20)
           };
         }
         if (parts[2] === "resolve" && req.method === "POST") {