@pingagent/sdk 0.1.12 → 0.1.14

package/bin/pingagent.js

@@ -24,6 +24,7 @@ import {
   TaskThreadManager,
   TaskHandoffManager,
   TrustPolicyAuditManager,
+  CollaborationEventManager,
   TrustRecommendationManager,
   getTrustRecommendationActionLabel,
   formatCapabilityCardSummary,
@@ -337,6 +338,7 @@ function buildHostState(identityPath, selectedSessionKey = null, historyPageInde
     const taskHandoffManager = new TaskHandoffManager(store);
     const historyManager = new HistoryManager(store);
     const auditManager = new TrustPolicyAuditManager(store);
+    const collaborationEventManager = new CollaborationEventManager(store);
     const sessions = sessionManager.listRecentSessions(50);
     const bindings = readSessionBindings();
     const alerts = readSessionBindingAlerts();
@@ -370,6 +372,13 @@ function buildHostState(identityPath, selectedSessionKey = null, historyPageInde
     const selectedAuditEvents = selectedSession
       ? auditManager.listBySession(selectedSession.session_key, 12)
       : [];
+    const selectedCollaborationEvents = selectedSession
+      ? collaborationEventManager.listBySession(selectedSession.session_key, 12)
+      : [];
+    const selectedPendingCollaborationEvents = selectedSession
+      ? collaborationEventManager.listPendingBySession(selectedSession.session_key, 12)
+      : [];
+    const pendingCollaborationEventsGlobal = collaborationEventManager.listPending(50);
     const selectedMessages = selectedSession?.conversation_id
       ? historyManager.listRecent(selectedSession.conversation_id, 12)
       : [];
@@ -403,16 +412,21 @@ function buildHostState(identityPath, selectedSessionKey = null, historyPageInde
       sessionBindingAlertsPath: getSessionBindingAlertsFilePath(),
       policyPath: policy.path,
       policyDoc: policy.doc,
+      projectionPreset: policy.doc.collaboration_projection?.preset || 'balanced',
       sessions: sessionsWithMeta,
       tasks: taskManager.listRecent(30).map((task) => ({
         ...task,
         handoff: taskHandoffManager.get(task.task_id),
       })),
       auditEvents: auditManager.listRecent(40),
+      collaborationEvents: collaborationEventManager.listRecent(40),
       selectedSession,
       selectedSessionSummary,
       selectedTasks,
       selectedAuditEvents,
+      selectedCollaborationEvents,
+      selectedPendingCollaborationEvents,
+      pendingCollaborationEventsGlobal,
       selectedMessages,
       selectedHistoryPage,
       selectedHistorySearchQuery: historySearchQuery.trim(),
@@ -432,6 +446,9 @@ function renderHostTuiScreen(hostState, uiState) {
   const selectedSummary = hostState.selectedSessionSummary || null;
   const tasks = hostState.selectedTasks || [];
   const auditEvents = hostState.selectedAuditEvents || [];
+  const collaborationEvents = hostState.selectedCollaborationEvents || [];
+  const pendingCollaborationEvents = hostState.selectedPendingCollaborationEvents || [];
+  const pendingCollaborationEventsGlobal = hostState.pendingCollaborationEventsGlobal || [];
   const messages = hostState.selectedMessages || [];
   const recommendations = hostState.selectedRecommendations || [];
   const openRecommendation = recommendations.find((item) => item.status === 'open') || null;
@@ -442,6 +459,8 @@ function renderHostTuiScreen(hostState, uiState) {
   const view = uiState?.view || 'overview';
   const selectedTaskIndex = Math.max(0, Math.min(uiState?.selectedTaskIndex || 0, Math.max(0, tasks.length - 1)));
   const selectedTask = tasks[selectedTaskIndex] || null;
+  const selectedDecisionIndex = Math.max(0, Math.min(uiState?.selectedDecisionIndex || 0, Math.max(0, pendingCollaborationEventsGlobal.length - 1)));
+  const selectedDecision = pendingCollaborationEventsGlobal[selectedDecisionIndex] || null;
   const statusCountdown = uiState?.statusExpiresAt
     ? ` (${Math.max(0, Math.ceil((uiState.statusExpiresAt - Date.now()) / 1000))}s)`
     : '';
@@ -457,7 +476,7 @@ function renderHostTuiScreen(hostState, uiState) {
     `runtime_mode=${hostState.runtimeMode}  receive_mode=${hostState.ingressRuntime?.receive_mode || 'webhook'}  current_openclaw_chat=${hostState.activeChatSession || '(none)'}`,
     `ingress=${ingressLabel}${degraded ? '  action=[f] fix-now' : ''}`,
     uiState?.publicLinkUrl ? `public_link=${uiState.publicLinkUrl}` : null,
-    `sessions=${sessions.length}  unread_total=${hostState.unreadTotal ?? 0}  alert_sessions=${hostState.alertSessions ?? 0}  view=${view}`,
+    `sessions=${sessions.length}  unread_total=${hostState.unreadTotal ?? 0}  alert_sessions=${hostState.alertSessions ?? 0}  view=${view}  projection=${hostState.projectionPreset || 'balanced'}`,
     `policy=${hostState.policyPath}`,
     `chat_link_map=${hostState.sessionMapPath}`,
     `chat_link_alerts=${hostState.sessionBindingAlertsPath}`,
@@ -475,6 +494,7 @@ function renderHostTuiScreen(hostState, uiState) {
     lines.push('- a: approve selected pending contact');
     lines.push('- m: mark selected session as read');
     lines.push('- t: open task list view for selected session');
+    lines.push('- i: open global decision inbox');
     lines.push('- x: cancel selected task (in task views)');
     lines.push('- p: multiline reply prompt (detail view)');
     lines.push('- S: edit carry-forward summary (detail view)');
@@ -483,6 +503,8 @@ function renderHostTuiScreen(hostState, uiState) {
     lines.push('- n / p: older / newer history page (history view)');
     lines.push('- s or /: search local history (history view)');
     lines.push('- y: dump task detail to stdout (task-detail view, choose json/plain)');
+    lines.push('- u: approve the selected collaboration decision');
+    lines.push('- U: reject the selected collaboration decision');
     lines.push('- f: repair OpenClaw hooks config');
     lines.push('- A: apply first open trust recommendation for selected session');
     lines.push('- D: dismiss current open recommendation');
@@ -546,6 +568,17 @@ function renderHostTuiScreen(hostState, uiState) {
       lines.push('Tasks In Session');
       lines.push(...tasks.map((task, idx) => `${idx === selectedTaskIndex ? '>' : ' '} ${task.task_id} [${task.status}] ${truncateLine(task.title || task.result_summary || '', 70)}`));
     }
+  } else if (view === 'decisions') {
+    lines.push('Decision Inbox');
+    lines.push(`pending=${pendingCollaborationEventsGlobal.length}`);
+    lines.push('actions=[u] approve  [U] reject  [Enter/l] open-session  [j/k] select  [h/Esc] back');
+    lines.push('');
+    lines.push(...(pendingCollaborationEventsGlobal.length
+      ? pendingCollaborationEventsGlobal.map((event, idx) => {
+          const marker = idx === selectedDecisionIndex ? '>' : ' ';
+          return `${marker} ${event.id} [${event.severity}] ${truncateLine(event.summary || '(none)', 88)} session=${event.session_key || '(none)'}`;
+        })
+      : ['- none']));
   } else if (view === 'tasks') {
     lines.push('Task Detail');
     if (!selected) {
@@ -606,6 +639,10 @@ function renderHostTuiScreen(hostState, uiState) {
       } else {
         lines.push('summary_objective=(none)');
       }
+      if (pendingCollaborationEvents.length > 0) {
+        lines.push(`pending_collaboration_decisions=${pendingCollaborationEvents.length}`);
+        lines.push(`next_decision=${truncateLine(pendingCollaborationEvents[0].summary || '(none)', 100)}`);
+      }
       const actionBar = [
         selected.trust_state === 'pending' ? '[a] approve' : null,
         '[A] apply-rec',
@@ -615,6 +652,8 @@ function renderHostTuiScreen(hostState, uiState) {
         '[d] demo',
         '[p] reply',
         '[S] summary',
+        pendingCollaborationEvents.length ? '[u] approve-decision' : null,
+        pendingCollaborationEvents.length ? '[U] reject-decision' : null,
         '[o] history',
         '[t] tasks',
         '[b] attach-chat',
@@ -645,6 +684,11 @@ function renderHostTuiScreen(hostState, uiState) {
         lines.push(...(messages.length ? messages.map((message) => formatMessageRow(message)) : ['- none']));
       }
       lines.push('');
+      lines.push('Collaboration Feed');
+      lines.push(...(collaborationEvents.length
+        ? collaborationEvents.map((event) => `- ${event.event_type} [${event.severity}${event.approval_required ? `:${event.approval_status}` : ''}] ${truncateLine(event.summary || '', 90)}`)
+        : ['- none']));
+      lines.push('');
       lines.push('Audit');
       lines.push(...(auditEvents.length
         ? auditEvents.map((event) => `- ${event.event_type} ${event.action || event.outcome || ''} ${truncateLine(event.explanation || '', 80)}`)
@@ -655,7 +699,7 @@ function renderHostTuiScreen(hostState, uiState) {
   }
 
   lines.push('');
-  lines.push('Keys: ↑/↓ or j/k select  Enter/l open  Esc/h back  g/G jump  r refresh  a approve  A apply-rec  D dismiss-rec  R reopen-rec  d demo  m read  p reply  o history  s search  t tasks  x cancel-task  y dump  f fix-hooks  b attach-chat  c detach-chat  ? help  q quit');
+  lines.push('Keys: ↑/↓ or j/k select  Enter/l open  Esc/h back  g/G jump  r refresh  a approve  u/U decide  A apply-rec  D dismiss-rec  R reopen-rec  d demo  m read  p reply  o history  s search  t tasks  x cancel-task  y dump  f fix-hooks  b attach-chat  c detach-chat  ? help  q quit');
   return lines.join('\n');
 }
 
@@ -667,6 +711,7 @@ async function runHostTui(identityPath, opts) {
     selectedSessionKey: null,
     view: 'overview',
     selectedTaskIndex: 0,
+    selectedDecisionIndex: 0,
     statusMessage: '(ready)',
     statusLevel: 'info',
     statusExpiresAt: 0,
@@ -922,6 +967,10 @@ async function runHostTui(identityPath, opts) {
       const tasks = latestState.selectedTasks || [];
       if (!tasks.length) return;
       uiState.selectedTaskIndex = Math.min(tasks.length - 1, Math.max(0, uiState.selectedTaskIndex + delta));
+    } else if (uiState.view === 'decisions') {
+      const decisions = latestState.pendingCollaborationEventsGlobal || [];
+      if (!decisions.length) return;
+      uiState.selectedDecisionIndex = Math.min(decisions.length - 1, Math.max(0, uiState.selectedDecisionIndex + delta));
     } else if (uiState.view === 'history' && !uiState.historySearchQuery) {
       if (delta > 0 && latestState.selectedHistoryPage?.hasOlder) uiState.selectedHistoryPageIndex += 1;
       if (delta < 0 && latestState.selectedHistoryPage?.hasNewer) uiState.selectedHistoryPageIndex = Math.max(0, uiState.selectedHistoryPageIndex - 1);
@@ -943,6 +992,10 @@ async function runHostTui(identityPath, opts) {
       const tasks = latestState.selectedTasks || [];
       if (!tasks.length) return;
       uiState.selectedTaskIndex = target;
+    } else if (uiState.view === 'decisions') {
+      const decisions = latestState.pendingCollaborationEventsGlobal || [];
+      if (!decisions.length) return;
+      uiState.selectedDecisionIndex = target;
     } else if (uiState.view === 'history') {
       uiState.selectedHistoryPageIndex = 0;
     } else {
@@ -989,12 +1042,20 @@ async function runHostTui(identityPath, opts) {
     if (_str === 'G') {
       const max = uiState.view === 'tasks' || uiState.view === 'task-detail'
         ? Math.max(0, (latestState.selectedTasks || []).length - 1)
-        : Math.max(0, (latestState.sessions || []).length - 1);
+        : uiState.view === 'decisions'
+          ? Math.max(0, (latestState.pendingCollaborationEventsGlobal || []).length - 1)
+          : Math.max(0, (latestState.sessions || []).length - 1);
       return jumpSelection(max);
     }
     if (key?.name === 'return' || key?.name === 'enter' || key?.name === 'l') {
       if (uiState.view === 'tasks') {
         uiState.view = 'task-detail';
+      } else if (uiState.view === 'decisions') {
+        const decision = (latestState.pendingCollaborationEventsGlobal || [])[Math.max(0, Math.min(uiState.selectedDecisionIndex || 0, Math.max(0, (latestState.pendingCollaborationEventsGlobal || []).length - 1)))] || null;
+        if (decision?.session_key) {
+          uiState.selectedSessionKey = decision.session_key;
+          uiState.view = 'detail';
+        }
       } else {
         uiState.view = 'detail';
       }
@@ -1004,6 +1065,7 @@ async function runHostTui(identityPath, opts) {
     if (key?.name === 'escape' || key?.name === 'h') {
       if (uiState.view === 'task-detail') uiState.view = 'tasks';
       else if (uiState.view === 'history') uiState.view = 'detail';
+      else if (uiState.view === 'decisions') uiState.view = 'overview';
       else uiState.view = 'overview';
       latestState = redraw();
       return;
@@ -1044,6 +1106,13 @@ async function runHostTui(identityPath, opts) {
       latestState = redraw();
       return;
     }
+    if (key?.name === 'i') {
+      uiState.view = 'decisions';
+      uiState.selectedDecisionIndex = 0;
+      setStatus('Opened decision inbox.', 'info');
+      latestState = redraw();
+      return;
+    }
     if (key?.name === 'r') {
       setStatus('Refreshed.', 'info');
       latestState = redraw();
@@ -1083,6 +1152,45 @@ async function runHostTui(identityPath, opts) {
       latestState = redraw();
       return;
     }
+    if (key?.name === 'u' || _str === 'U') {
+      const approvalStatus = _str === 'U' ? 'rejected' : 'approved';
+      const pendingEvent = uiState.view === 'decisions'
+        ? (latestState.pendingCollaborationEventsGlobal || [])[Math.max(0, Math.min(uiState.selectedDecisionIndex || 0, Math.max(0, (latestState.pendingCollaborationEventsGlobal || []).length - 1)))] || null
+        : (latestState.selectedPendingCollaborationEvents || [])[0];
+      const selected = pendingEvent?.session_key
+        ? (latestState.sessions || []).find((session) => session.session_key === pendingEvent.session_key) || latestState.selectedSession
+        : latestState.selectedSession;
+      if (!pendingEvent || !selected) return;
+      const confirmed = await confirmAction(`${approvalStatus === 'approved' ? 'Approve' : 'Reject'} collaboration decision ${pendingEvent.id}\nSession: ${selected.session_key}\nSummary: ${pendingEvent.summary}\nProceed?`);
+      if (!confirmed) {
+        setStatus('Collaboration decision cancelled.', 'warn');
+        latestState = redraw();
+        return;
+      }
+      const store = openStore(identityPath);
+      try {
+        const manager = new CollaborationEventManager(store);
+        const result = manager.resolveApproval(pendingEvent.id, approvalStatus, {
+          resolved_by: 'tui',
+        });
+        if (!result) {
+          setStatus(`Decision ${pendingEvent.id} no longer exists.`, 'err');
+        } else {
+          setStatus(
+            approvalStatus === 'approved'
+              ? `Approved collaboration decision ${pendingEvent.id}${result.projection_outbox ? ` · human-thread projection=${result.projection_outbox.status}` : ''}`
+              : `Rejected collaboration decision ${pendingEvent.id}${result.projection_outbox ? ` · human-thread projection=${result.projection_outbox.status}` : ''}`,
+            'ok',
+          );
+        }
+      } catch (error) {
+        setStatus(`Collaboration decision failed: ${error?.message || 'unknown error'}`, 'err', 9000);
+      } finally {
+        store.close();
+      }
+      latestState = redraw();
+      return;
+    }
     if (_str === 'A') {
       const selected = latestState.selectedSession;
       if (!selected) return;