@pingagent/sdk 0.1.15 → 0.1.16

package/dist/web-server.js

@@ -2,7 +2,9 @@ import {
   CollaborationEventManager,
   CollaborationProjectionOutboxManager,
   ContactManager,
+  HumanDeliveryBindingManager,
   LocalStore,
+  NotificationIntentManager,
   OperatorSeenStateManager,
   PingAgentClient,
   TrustPolicyAuditManager,
@@ -19,6 +21,7 @@ import {
   getSessionMapFilePath,
   getTrustRecommendationActionLabel,
   listPendingDecisionViews,
+  listRecentBindingsForSession,
   loadIdentity,
   normalizeTrustPolicyDoc,
   readCurrentActiveSessionKey,
@@ -28,12 +31,13 @@ import {
   readTransportPreference,
   removeSessionBinding,
   setSessionBinding,
+  summarizeHumanDelivery,
   summarizeSinceLastSeen,
   summarizeTrustPolicyAudit,
   switchTransportPreference,
   updateStoredToken,
   upsertTrustPolicyRecommendation
-} from "./chunk-BCYHGKQE.js";
+} from "./chunk-GU5W4KRD.js";
 
 // src/web-server.ts
 import * as fs from "fs";
@@ -540,6 +544,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',
@@ -804,8 +898,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 +924,26 @@ function getHostPanelHtml() {
         : '<div class="empty">No pending collaboration decisions.</div>';
 
       const combinedOutbox = pendingOutbox.concat(failedOutbox);
-      document.getElementById('projectionOutboxSummary').textContent =
-        combinedOutbox.length
+      document.getElementById('projectionOutboxSummary').textContent = boundChannelReply
+        ? ('bound reply mode \xB7 pending=' + pendingIntents.length + ' \xB7 unresolved=' + unresolvedIntents.length + ' \xB7 failed=' + failedIntents.length)
+        : (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>';
+          : 'No undelivered human-thread projections.');
+      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 projection deliveries.</div>');
 
       document.querySelectorAll('.inbox-decision-btn').forEach(function (btn) {
         btn.addEventListener('click', async function () {
@@ -864,6 +970,7 @@ function getHostPanelHtml() {
           setTab('runtime');
         });
       });
+      wireHumanDeliveryActionButtons(document.getElementById('projectionOutboxList'));
     }
 
     function getOverviewSessions() {
@@ -903,6 +1010,7 @@ function getHostPanelHtml() {
       const ingressState = ingressStatusModel(overview);
       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; })
         : [];
@@ -917,6 +1025,7 @@ function getHostPanelHtml() {
               '<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>' +
+              (humanDelivery ? '<span class="pill">human_delivery=' + esc(humanDelivery.mode || 'projection_outbox') + '</span>' : '') +
             '</div>' +
           '</div>' +
           '<div style="min-width:320px">' +
@@ -945,12 +1054,16 @@ 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');
@@ -1022,7 +1135,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 +1144,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 +1238,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 = [];
@@ -1289,6 +1405,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 +1426,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 +1576,7 @@ conversation=' + result.conversation_id));
           setTab('runtime');
         });
       }
+      wireHumanDeliveryActionButtons(el);
     }
 
     async function promptBindCurrentChat(conversationId, previousBinding, remoteDid) {
@@ -2154,6 +2284,14 @@ 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 buildPolicyDecisionShape(identityPath, remoteDid, opts) {
   const policy = readTrustPolicyDoc(identityPath);
   const runtimeMode = opts?.runtimeMode ?? getRuntimeMode();
@@ -2268,10 +2406,20 @@ 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();
   }
@@ -2314,6 +2462,8 @@ async function buildRuntimeOverviewPayload(ctx) {
     projectionOutbox,
     transportHealth,
     sinceLastSeen,
+    humanDelivery,
+    humanDeliveryDetails,
     pendingDecisions: decisionViews,
     recentCollaborationEvents: collaborationEventManager.listRecent(20),
     sessions: sessions.map((session) => ({
@@ -2381,12 +2531,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,6 +2555,7 @@ 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();
   }
@@ -2419,9 +2575,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 +2663,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 +2828,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") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pingagent/sdk",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "license": "MIT",
   "publishConfig": {
     "access": "public"