@pingagent/sdk 0.1.12 → 0.1.14

package/dist/web-server.js

@@ -1,4 +1,6 @@
 import {
+  CollaborationEventManager,
+  CollaborationProjectionOutboxManager,
   ContactManager,
   LocalStore,
   PingAgentClient,
@@ -23,7 +25,7 @@ import {
   summarizeTrustPolicyAudit,
   updateStoredToken,
   upsertTrustPolicyRecommendation
-} from "./chunk-BLHMTUID.js";
+} from "./chunk-MFKDD5X3.js";
 
 // src/web-server.ts
 import * as fs from "fs";
@@ -182,6 +184,7 @@ function getHostPanelHtml() {
       <div class="profile-list" id="profileList"></div>
       <div class="nav">
         <button id="navRuntime" class="active">Runtime</button>
+        <button id="navDecisions">Decisions</button>
         <button id="navPolicy">Policy</button>
       </div>
       <div class="link-row">
@@ -236,8 +239,39 @@ function getHostPanelHtml() {
         </div>
       </section>
 
+      <section id="decisionsPanel" class="panel">
+        <div class="grid two-col">
+          <div class="card">
+            <h2>Decision Inbox</h2>
+            <div id="decisionInboxSummary" class="muted small" style="margin-bottom:12px">Loading pending decisions\u2026</div>
+            <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>
+            <div class="audit-list" id="projectionOutboxList"></div>
+          </div>
+        </div>
+      </section>
+
       <section id="policyPanel" class="panel">
         <div class="grid policy-grid">
+          <div class="card">
+            <h2>Projection Policy</h2>
+            <div class="form-grid">
+              <label class="label">Preset</label>
+              <select id="projectionPreset">
+                <option value="quiet">quiet</option>
+                <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="row-actions">
+                <button class="action-btn" id="saveProjectionPresetBtn">Save projection preset</button>
+              </div>
+            </div>
+          </div>
+
           <div class="card">
             <h2>Policy Defaults</h2>
             <div class="form-grid">
@@ -357,7 +391,7 @@ function getHostPanelHtml() {
       return {
         profile: profile && profile.trim() ? profile.trim() : null,
         sessionKey: sessionKey && sessionKey.trim() ? sessionKey.trim() : null,
-        view: view === 'policy' ? 'policy' : 'runtime',
+        view: view === 'policy' ? 'policy' : (view === 'decisions' ? 'decisions' : 'runtime'),
       };
     })();
 
@@ -367,6 +401,7 @@ function getHostPanelHtml() {
       profiles: [],
       overview: null,
       session: null,
+      decisions: null,
       policy: null,
       selectedSessionKey: initialQuery.sessionKey || null,
       detailMode: sessionStorage.getItem('pingagent_host_panel_detail_mode') || 'basic',
@@ -400,7 +435,7 @@ function getHostPanelHtml() {
       else url.searchParams.delete('profile');
       if (state.selectedSessionKey) url.searchParams.set('session_key', state.selectedSessionKey);
       else url.searchParams.delete('session_key');
-      url.searchParams.set('view', state.currentTab === 'policy' ? 'policy' : 'runtime');
+      url.searchParams.set('view', state.currentTab === 'policy' ? 'policy' : (state.currentTab === 'decisions' ? 'decisions' : 'runtime'));
       history.replaceState(null, '', url.pathname + (url.search ? url.search : ''));
     }
 
@@ -479,8 +514,10 @@ function getHostPanelHtml() {
     function setTab(tab) {
       state.currentTab = tab;
       document.getElementById('navRuntime').classList.toggle('active', tab === 'runtime');
+      document.getElementById('navDecisions').classList.toggle('active', tab === 'decisions');
       document.getElementById('navPolicy').classList.toggle('active', tab === 'policy');
       document.getElementById('runtimePanel').classList.toggle('active', tab === 'runtime');
+      document.getElementById('decisionsPanel').classList.toggle('active', tab === 'decisions');
       document.getElementById('policyPanel').classList.toggle('active', tab === 'policy');
       syncUrlState();
     }
@@ -572,6 +609,109 @@ function getHostPanelHtml() {
         '</div>';
     }
 
+    function renderCollaborationEventsBlock(events, isAdvanced) {
+      if (!events || !events.length) {
+        return '<div class="empty">No collaboration events recorded yet. New external updates, runtime shifts, and decision points will appear here.</div>';
+      }
+      return events.map(function (event) {
+        const detail = event && event.detail ? event.detail : null;
+        const resolution = detail && detail.approval_resolution ? detail.approval_resolution : null;
+        const badges = [
+          '<span class="badge">' + esc(event.severity || 'info') + '</span>',
+          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>' : '',
+        ].filter(Boolean).join('');
+        const actions = event.approval_required && event.approval_status === 'pending'
+          ? '<div class="row-actions" style="margin-top:10px">' +
+              '<button class="action-btn collaboration-decision-btn" data-event-id="' + esc(event.id) + '" data-decision="approved">Approve</button>' +
+              '<button class="danger-btn collaboration-decision-btn" data-event-id="' + esc(event.id) + '" data-decision="rejected">Reject</button>' +
+            '</div>'
+          : '';
+        const resolutionLine = resolution
+          ? '<div class="muted small" style="margin-top:8px">resolution=' + esc(resolution.approval_status || event.approval_status || '(unknown)') +
+              ' \xB7 resolved_at=' + esc(fmtTs(resolution.resolved_at)) +
+              (resolution.resolved_by ? ' \xB7 resolved_by=' + esc(resolution.resolved_by) : '') +
+              (resolution.note ? ' \xB7 note=' + esc(resolution.note) : '') +
+            '</div>'
+          : '';
+        return '<div class="audit-row"><div class="top"><strong>' + esc(event.event_type) + '</strong>' + badges + '</div>' +
+          '<div class="muted small">' + esc(fmtTs(event.ts_ms)) + '</div>' +
+          '<div style="margin-top:8px">' + esc(event.summary || '(no summary)') + '</div>' +
+          '<div class="muted small" style="margin-top:8px">detail_ref=' + esc(detail && detail.detail_ref && detail.detail_ref.session_key ? detail.detail_ref.session_key : (event.session_key || '(none)')) + ' \xB7 conversation=' + esc(event.conversation_id || '(none)') + '</div>' +
+          resolutionLine +
+          actions +
+          (isAdvanced && detail ? '<pre style="margin-top:8px">' + esc(JSON.stringify(detail, null, 2)) + '</pre>' : '') +
+        '</div>';
+      }).join('');
+    }
+
+    function renderDecisionInbox() {
+      const data = state.decisions;
+      const pendingDecisions = data && Array.isArray(data.pendingDecisions) ? data.pendingDecisions : [];
+      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;
+      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 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>' +
+                '<button class="danger-btn inbox-decision-btn" data-event-id="' + esc(event.id) + '" data-decision="rejected">Reject</button>' +
+                '<button class="secondary-btn inbox-open-detail-btn" data-session-key="' + esc(event.session_key || '') + '">Open Detail</button>' +
+              '</div>' +
+            '</div>';
+          }).join('')
+        : '<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.querySelectorAll('.inbox-decision-btn').forEach(function (btn) {
+        btn.addEventListener('click', async function () {
+          const eventId = Number(btn.getAttribute('data-event-id'));
+          const decision = btn.getAttribute('data-decision');
+          if (!Number.isInteger(eventId) || !decision) return;
+          await api('/api/runtime/collaboration-decisions/resolve', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ event_id: eventId, decision: decision }),
+          });
+          await refreshAll();
+          setTab('decisions');
+        });
+      });
+
+      document.querySelectorAll('.inbox-open-detail-btn').forEach(function (btn) {
+        btn.addEventListener('click', async function () {
+          const sessionKey = btn.getAttribute('data-session-key');
+          if (!sessionKey) return;
+          state.selectedSessionKey = sessionKey;
+          await loadSession(sessionKey);
+          renderOverview();
+          setTab('runtime');
+        });
+      });
+    }
+
     function getOverviewSessions() {
       return state.overview && Array.isArray(state.overview.sessions) ? state.overview.sessions : [];
     }
@@ -638,6 +778,7 @@ function getHostPanelHtml() {
         { label: 'Unread', value: overview.unreadTotal, sub: 'session-first inbox state' },
         { 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: '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' },
       ];
@@ -783,6 +924,8 @@ conversation=' + result.conversation_id));
       const tasks = Array.isArray(detail.tasks) ? detail.tasks : [];
       const messages = Array.isArray(detail.messages) ? detail.messages : [];
       const auditEvents = Array.isArray(detail.auditEvents) ? detail.auditEvents : [];
+      const collaborationEvents = Array.isArray(detail.collaborationEvents) ? detail.collaborationEvents : [];
+      const pendingCollaborationEvents = Array.isArray(detail.pendingCollaborationEvents) ? detail.pendingCollaborationEvents : [];
       const recommendations = Array.isArray(detail.recommendations) ? detail.recommendations : [];
       const openRecommendation = recommendations.find(function (item) { return item.status === 'open'; }) || null;
       const reopenRecommendation = recommendations.find(function (item) { return item.status === 'dismissed' || item.status === 'superseded'; }) || null;
@@ -790,6 +933,10 @@ conversation=' + result.conversation_id));
       const bindingAlert = detail.bindingAlert || null;
       const activeWorkSession = detail.activeWorkSession || null;
       const summary = detail.sessionSummary || null;
+      const projectionPreset = detail.collaborationProjection && detail.collaborationProjection.preset
+        ? detail.collaborationProjection.preset
+        : 'balanced';
+      const projectionOutbox = Array.isArray(detail.projectionOutbox) ? detail.projectionOutbox : [];
       const isAdvanced = state.detailMode === 'advanced';
       const sessionLink = buildSessionLink(session.session_key);
       const summaryPills = [];
@@ -824,6 +971,9 @@ conversation=' + result.conversation_id));
               ? '<div class="muted small" style="margin-top:8px">trust_action=' + esc(recommendationActionLabel(openRecommendation)) + '</div>'
               : (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>'
+              : '') +
             (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>'
               : '') +
@@ -919,6 +1069,11 @@ conversation=' + result.conversation_id));
               return '<div class="message-row"><div class="muted small">' + esc(fmtTs(msg.ts_ms)) + ' \xB7 ' + esc(msg.direction) + ' \xB7 ' + esc(msg.schema) + '</div><div style="margin-top:8px">' + esc(messageSummary) + '</div></div>';
             }).join('') : '<div class="empty">No local message history yet.</div>') +
           '</div></div>' +
+          '<div><div class="label">Collaboration Feed</div><div class="audit-list" style="margin-top:8px">' +
+            renderCollaborationEventsBlock(collaborationEvents, isAdvanced) +
+          '</div></div>' +
+        '</div>' +
+        '<div class="grid two-col" style="margin-top:16px">' +
           '<div><div class="label">Policy Audit</div><div class="audit-list" style="margin-top:8px">' +
             (auditEvents.length ? auditEvents.map(function (event) {
               return '<div class="audit-row"><div class="top"><strong>' + esc(event.event_type) + '</strong><span class="badge">' + esc(event.action || event.outcome || '-') + '</span></div>' +
@@ -927,6 +1082,15 @@ 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 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>' +
+              (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>' +
+          '</div></div>' +
         '</div>';
 
       el.querySelectorAll('.approve-session-btn').forEach(function (btn) {
@@ -1014,6 +1178,21 @@ conversation=' + result.conversation_id));
           setTab('runtime');
         });
       });
+      el.querySelectorAll('.collaboration-decision-btn').forEach(function (btn) {
+        btn.addEventListener('click', async function () {
+          const eventId = Number(btn.getAttribute('data-event-id'));
+          const decision = btn.getAttribute('data-decision');
+          if (!Number.isInteger(eventId) || !decision) return;
+          await api('/api/runtime/session/collaboration-decision', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ event_id: eventId, decision: decision }),
+          });
+          await refreshAll();
+          if (state.selectedSessionKey) await loadSession(state.selectedSessionKey);
+          setTab('runtime');
+        });
+      });
       const sendSessionReplyBtn = document.getElementById('sendSessionReplyBtn');
       if (sendSessionReplyBtn) {
         sendSessionReplyBtn.addEventListener('click', async function () {
@@ -1089,6 +1268,10 @@ Previous chat link: ' + previous
       const policy = state.policy;
       if (!policy) return;
       const profile = state.overview && state.overview.profile ? state.overview.profile : null;
+      document.getElementById('projectionPreset').value =
+        policy.doc && policy.doc.collaboration_projection && policy.doc.collaboration_projection.preset
+          ? policy.doc.collaboration_projection.preset
+          : 'balanced';
       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 : '';
@@ -1282,17 +1465,24 @@ Previous chat link: ' + previous
       renderPolicy();
     }
 
+    async function loadDecisions() {
+      state.decisions = await api('/api/runtime/collaboration-decisions');
+      renderDecisionInbox();
+    }
+
     async function refreshAll() {
       if (!state.selectedProfile && state.profiles.length > 1) {
         renderHeader();
         return;
       }
       await loadOverview();
+      await loadDecisions();
       await loadPolicy();
       renderHeader();
     }
 
     document.getElementById('navRuntime').addEventListener('click', function () { setTab('runtime'); });
+    document.getElementById('navDecisions').addEventListener('click', function () { setTab('decisions'); });
     document.getElementById('navPolicy').addEventListener('click', function () { setTab('policy'); });
     document.getElementById('toggleUnreadBtn').addEventListener('click', async function () {
       state.showUnreadOnly = !state.showUnreadOnly;
@@ -1331,6 +1521,15 @@ Previous chat link: ' + previous
       await refreshAll();
       setTab('policy');
     });
+    document.getElementById('saveProjectionPresetBtn').addEventListener('click', async function () {
+      await api('/api/runtime/policy/projection', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ preset: document.getElementById('projectionPreset').value }),
+      });
+      await refreshAll();
+      setTab('policy');
+    });
     document.getElementById('addRuleBtn').addEventListener('click', async function () {
       await api('/api/runtime/policy/rules', {
         method: 'POST',
@@ -1678,6 +1877,26 @@ function writeTrustPolicyDoc(identityPath, doc) {
   fs.writeFileSync(policyPath, JSON.stringify(normalizeTrustPolicyDoc(doc), null, 2), "utf-8");
   return policyPath;
 }
+function normalizeProjectionPreset(value) {
+  if (value === "quiet" || value === "strict") return value;
+  return "balanced";
+}
+function readProjectionOutboxState(storePath, limit = 20) {
+  const store = new LocalStore(storePath);
+  try {
+    const manager = new CollaborationProjectionOutboxManager(store);
+    const pending = manager.listByStatus("pending", limit);
+    const failed = manager.listByStatus("failed", limit);
+    return {
+      pending,
+      failed,
+      total_pending: pending.length,
+      total_failed: failed.length
+    };
+  } finally {
+    store.close();
+  }
+}
 function buildPolicyDecisionShape(identityPath, remoteDid, opts) {
   const policy = readTrustPolicyDoc(identityPath);
   const runtimeMode = opts?.runtimeMode ?? getRuntimeMode();
@@ -1741,7 +1960,8 @@ async function buildRuntimeOverviewPayload(ctx) {
   const taskManager = client.getTaskThreadManager();
   const taskHandoffManager = client.getTaskHandoffManager();
   const historyManager = client.getHistoryManager();
-  if (!sessionManager || !sessionSummaryManager || !taskManager || !taskHandoffManager || !historyManager) {
+  const collaborationEventManager = client.getCollaborationEventManager();
+  if (!sessionManager || !sessionSummaryManager || !taskManager || !taskHandoffManager || !historyManager || !collaborationEventManager) {
     throw new Error("Runtime overview requires a writable local store");
   }
   const sessions = sessionManager.listRecentSessions(24);
@@ -1787,6 +2007,8 @@ async function buildRuntimeOverviewPayload(ctx) {
     acc[session.trust_state] = (acc[session.trust_state] ?? 0) + 1;
     return acc;
   }, {});
+  const collaborationSummary = collaborationEventManager.summarize(200);
+  const projectionOutbox = readProjectionOutboxState(ctx.storePath, 20);
   return {
     did: ctx.myDid,
     serverUrl: ctx.serverUrl,
@@ -1816,18 +2038,23 @@ async function buildRuntimeOverviewPayload(ctx) {
       contact: policy.contact_policy.enabled ? policy.contact_policy.default_action : "disabled",
       task: policy.task_policy.enabled ? policy.task_policy.default_action : "disabled"
     },
+    collaborationProjection: policy.collaboration_projection,
     sessionsTotal: sessions.length,
     tasksTotal: refreshedTasks.length,
     unreadTotal,
     trustCounts,
     recommendationSummary: recommendationState.summary,
+    collaborationSummary,
+    projectionOutbox,
+    recentCollaborationEvents: collaborationEventManager.listRecent(20),
     sessions: sessions.map((session) => ({
       ...session,
       session_summary: sessionSummaryManager.get(session.session_key),
       mapped_work_session: session.conversation_id ? bindingByConversation.get(session.conversation_id) ?? null : null,
       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) : []
+      latest_messages: session.conversation_id ? historyManager.listRecent(session.conversation_id, 3) : [],
+      collaboration_events: collaborationEventManager.listBySession(session.session_key, 3)
     })),
     tasks: refreshedTasks.map((task) => ({
       ...task,
@@ -1847,7 +2074,8 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
   const taskManager = client.getTaskThreadManager();
   const taskHandoffManager = client.getTaskHandoffManager();
   const historyManager = client.getHistoryManager();
-  if (!sessionManager || !sessionSummaryManager || !taskManager || !taskHandoffManager || !historyManager) {
+  const collaborationEventManager = client.getCollaborationEventManager();
+  if (!sessionManager || !sessionSummaryManager || !taskManager || !taskHandoffManager || !historyManager || !collaborationEventManager) {
     throw new Error("Session overview requires a writable local store");
   }
   const session = sessionKey ? sessionManager.get(sessionKey) : sessionManager.getActiveSession() ?? sessionManager.listRecentSessions(1)[0] ?? null;
@@ -1881,9 +2109,19 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
     runtimeMode: getRuntimeMode(),
     limit: 20
   });
+  const outboxStore = new LocalStore(ctx.storePath);
+  let projectionOutbox = [];
+  try {
+    projectionOutbox = new CollaborationProjectionOutboxManager(outboxStore).listBySession(session.session_key, 20);
+  } finally {
+    outboxStore.close();
+  }
   return {
     session,
     sessionSummary: sessionSummaryManager.get(session.session_key),
+    collaborationEvents: collaborationEventManager.listBySession(session.session_key, 40),
+    pendingCollaborationEvents: collaborationEventManager.listPendingBySession(session.session_key, 20),
+    collaborationSummary: collaborationEventManager.summarize(200),
     ingressRuntime: readIngressRuntimeStatus(),
     binding,
     bindingAlert,
@@ -1891,6 +2129,8 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
     activeWorkSessionFile: getActiveSessionFilePath(),
     sessionMapPath: getSessionMapFilePath(),
     sessionBindingAlertsPath: getSessionBindingAlertsFilePath(),
+    collaborationProjection: policy.collaboration_projection,
+    projectionOutbox,
     policyExplain: buildPolicyDecisionShape(ctx.identityPath, session.remote_did, { runtimeMode: getRuntimeMode() }),
     tasks: tasks.map((task) => ({
       ...task,
@@ -2016,9 +2256,48 @@ async function handleApi(pathname, req, ctx) {
         receiveMode: readIngressRuntimeStatus()
       };
     }
+    if (parts[1] === "collaboration-decisions") {
+      const store = new LocalStore(ctx.storePath);
+      try {
+        const manager = new CollaborationEventManager(store);
+        const outboxManager = new CollaborationProjectionOutboxManager(store);
+        if (req.method === "GET") {
+          const pendingDecisions = manager.listPending(100);
+          return {
+            pendingDecisions,
+            projectionOutboxPending: outboxManager.listByStatus("pending", 50),
+            projectionOutboxFailed: outboxManager.listByStatus("failed", 50)
+          };
+        }
+        if (parts[2] === "resolve" && req.method === "POST") {
+          const body = await readBody(req);
+          const eventId = Number(body?.event_id);
+          const decision = String(body?.decision ?? "").trim().toLowerCase();
+          if (!Number.isInteger(eventId) || eventId <= 0) throw new Error("event_id is required");
+          if (decision !== "approved" && decision !== "rejected") {
+            throw new Error("decision must be approved or rejected");
+          }
+          const result = manager.resolveApproval(eventId, decision, {
+            resolved_by: "host_panel",
+            note: typeof body?.note === "string" ? body.note.trim() || void 0 : void 0
+          });
+          if (!result) throw new Error(`Collaboration event ${eventId} not found`);
+          return {
+            ok: true,
+            event: result.updated,
+            resolutionEvent: result.resolution_event,
+            projectionOutbox: result.projection_outbox
+          };
+        }
+      } finally {
+        store.close();
+      }
+    }
     if (parts[1] === "session") {
       const sessionManager = ctx.client.getSessionManager();
+      const collaborationEventManager = ctx.client.getCollaborationEventManager();
       if (!sessionManager) throw new Error("Session actions require a writable local store");
+      if (!collaborationEventManager) throw new Error("Collaboration actions require a writable local store");
       if (parts[2] === "reply" && req.method === "POST") {
         const body = await readBody(req);
         const session = resolveSessionForInput(sessionManager, body);
@@ -2059,6 +2338,28 @@ async function handleApi(pathname, req, ctx) {
           session: updated
         };
       }
+      if (parts[2] === "collaboration-decision" && req.method === "POST") {
+        const body = await readBody(req);
+        const eventId = Number(body?.event_id);
+        const decision = String(body?.decision ?? "").trim().toLowerCase();
+        if (!Number.isInteger(eventId) || eventId <= 0) throw new Error("event_id is required");
+        if (decision !== "approved" && decision !== "rejected") {
+          throw new Error("decision must be approved or rejected");
+        }
+        const result = collaborationEventManager.resolveApproval(eventId, decision, {
+          resolved_by: "host_panel",
+          note: typeof body?.note === "string" ? body.note.trim() || void 0 : void 0
+        });
+        if (!result) throw new Error(`Collaboration event ${eventId} not found`);
+        const session = result.updated.session_key ? sessionManager.get(result.updated.session_key) : null;
+        return {
+          ok: true,
+          event: result.updated,
+          resolutionEvent: result.resolution_event,
+          projectionOutbox: result.projection_outbox,
+          session
+        };
+      }
       const url = new URL(req.url || "", "http://x");
       const sessionKey = url.searchParams.get("session_key");
       return buildSessionOverviewPayload(ctx, sessionKey);
@@ -2186,6 +2487,39 @@ async function handleApi(pathname, req, ctx) {
         }
         return { ok: true, path: savedPath, doc };
       }
+      if (parts[2] === "projection") {
+        if (req.method === "GET") {
+          const doc = readTrustPolicyDoc(ctx.identityPath);
+          return {
+            path: policyPath,
+            projection: doc.collaboration_projection
+          };
+        }
+        if (req.method === "POST") {
+          const body = await readBody(req);
+          const doc = readTrustPolicyDoc(ctx.identityPath);
+          doc.collaboration_projection = {
+            preset: normalizeProjectionPreset(body?.preset)
+          };
+          const savedPath = writeTrustPolicyDoc(ctx.identityPath, doc);
+          const auditStore = new LocalStore(ctx.storePath);
+          try {
+            new TrustPolicyAuditManager(auditStore).record({
+              event_type: "policy_default_updated",
+              policy_scope: "session",
+              action: "collaboration_projection_updated",
+              outcome: "saved",
+              explanation: `Updated projection preset=${doc.collaboration_projection.preset}`,
+              detail: {
+                preset: doc.collaboration_projection.preset
+              }
+            });
+          } finally {
+            auditStore.close();
+          }
+          return { ok: true, path: savedPath, projection: doc.collaboration_projection, doc };
+        }
+      }
       if (parts[2] === "rules" && req.method === "POST") {
         const body = await readBody(req);
         const doc = readTrustPolicyDoc(ctx.identityPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pingagent/sdk",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -36,7 +36,7 @@
     "ws": "^8.0.0",
     "@pingagent/protocol": "0.1.1",
     "@pingagent/a2a": "0.1.1",
-    "@pingagent/schemas": "0.1.2"
+    "@pingagent/schemas": "0.1.4"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",