@pingagent/sdk 0.1.16 → 0.1.17

package/dist/index.d.ts

@@ -1726,6 +1726,33 @@ declare function clearSessionBindingAlert(conversationId: string, filePath?: str
     removed: boolean;
 };
 
+type OpenClawAgentLifecycleState = 'activating' | 'ready_waiting_inbound' | 'active_session' | 'decision_pending' | 'human_delivery_pending' | 'human_delivery_acknowledged' | 'degraded' | 'blocked';
+interface OpenClawAgentState {
+    state: OpenClawAgentLifecycleState;
+    summary: string;
+    reason?: string | null;
+    next_action: string;
+    active_session_key?: string | null;
+    pending_decisions: number;
+    human_delivery_pending: number;
+    human_delivery_unresolved: number;
+    human_delivery_failed: number;
+    human_delivery_acknowledged: number;
+    blocked: boolean;
+    degraded: boolean;
+}
+interface DeriveOpenClawAgentStateInput {
+    runtime_status?: OpenClawIngressRuntimeStatus | null;
+    sessions?: Array<Pick<SessionState, 'session_key' | 'active' | 'unread_count'>>;
+    pending_decisions?: number;
+    human_delivery?: Pick<HumanDeliverySummary, 'pending_intents' | 'unresolved_intents' | 'failed_intents' | 'acknowledged_intents'> | null;
+    transport_health?: Pick<TransportHealth, 'state' | 'last_error'> | null;
+    blocked_reason?: string | null;
+}
+declare function describeOpenClawAgentState(state: OpenClawAgentLifecycleState): string;
+declare function nextActionForOpenClawAgentState(state: OpenClawAgentLifecycleState): string;
+declare function deriveOpenClawAgentState(input: DeriveOpenClawAgentStateInput): OpenClawAgentState;
+
 interface OpenClawDeliveryContext {
     channel?: string;
     to?: string;
@@ -1761,4 +1788,4 @@ declare function getOpenClawSessionEntry(sessionKey: string, filePath?: string):
 declare function deriveOwnerRefFromOpenClawSessionEntry(entry: OpenClawSessionEntryRecord): string | undefined;
 declare function buildHumanDeliveryBindingCandidate(sessionKey: string, filePath?: string): OpenClawHumanDeliveryBindingCandidate | null;
 
-export { A2AAdapter, type A2AAdapterOptions, type A2ATaskResult, type AgentEncryptionCard, type AgentProfile, type CapabilityCard, type CapabilityCardItem, type CapabilityContactMode, type ClientOptions, type CollaborationApprovalStatus, type CollaborationDecisionView, type CollaborationEvent, type CollaborationEventInput, CollaborationEventManager, type CollaborationEventSeverity, type CollaborationEventSummary, type CollaborationEventType, type CollaborationProjectionKind, type CollaborationProjectionOutboxEntry, type CollaborationProjectionOutboxInput, CollaborationProjectionOutboxManager, type CollaborationProjectionOutboxStatus, type CollaborationProjectionPreset, type Contact, type ContactCardShare, ContactManager, type ContactPolicyAction, type ContactPolicyDecision, type ConversationEntry, type ConversationListResponse, type DeliveryTimelineEntry, type DirectoryBrowseResponse, type DirectorySelfResponse, type EncryptedPayloadWrapper, type EncryptionIdentityFields, type EncryptionPrivateKeyJwk, type EncryptionPublicKeyJwk, type FeedByDidResponse, type FeedPost, type FeedPublicResponse, type FetchResponse, HUMAN_DELIVERY_CHANNELS, HistoryManager, HttpTransport, type HumanDeliveryBinding, type HumanDeliveryBindingInput, HumanDeliveryBindingManager, type HumanDeliveryBindingStatus, type HumanDeliveryChannel, type HumanDeliveryChannelCapability, type HumanDeliverySummary, LocalStore, type ManagedTransportSwitchResult, type MarkOperatorSeenInput, type NotificationIntent, type NotificationIntentBindingScope, type NotificationIntentInput, NotificationIntentManager, type NotificationIntentStatus, type NotificationIntentType, type NotificationOverride, type OpenClawDeliveryContext, type OpenClawHumanDeliveryBindingCandidate, type OpenClawIngressRuntimeStatus, type OpenClawSessionEntryRecord, type OpenClawTransportMode, type OperatorSeenState, OperatorSeenStateManager, type OperatorSeenStateOperatorId, type OperatorSeenStateScopeType, PingAgentClient, type ProjectionDisposition, type ProjectionDispositionInput, type ProjectionDispositionResult, type ProjectionPreviewEntry, type PublicAgentProfile, type PublicLinkState, type RecommendationSummary, type ReplyTarget, type ResolveCollaborationApprovalInput, type ResolveCollaborationApprovalResult, type ResolveHumanDeliveryBindingInput, type ResolveHumanDeliveryBindingResult, type RuntimeMode, SESSION_SUMMARY_FIELDS, type SendResponse, type SessionBindingAlert, type SessionBindingEntry, SessionManager, type SessionMessageInput, type SessionState, type SessionSummary, type SessionSummaryFieldKey, SessionSummaryManager, type SessionSummaryUpsert, type SinceLastSeenSummary, type StoredMessage, type StoredTrustRecommendation, type SubscriptionResponse, type SubscriptionUsage, type SyncTrustRecommendationsInput, type TaskHandoff, TaskHandoffManager, type TaskHandoffPayload, type TaskHandoffUpsert, type TaskPolicyAction, type TaskPolicyDecision, type TaskResult, type TaskShareEntry, type TaskThread, TaskThreadManager, type TaskThreadStatus, type TaskThreadUpsert, type TransportHealth, type TransportHealthState, type TransportOptions, type TransportPreferenceState, type TrustPolicyAuditEvent, type TrustPolicyAuditEventType, type TrustPolicyAuditInput, TrustPolicyAuditManager, type TrustPolicyAuditSummary, type TrustPolicyContext, type TrustPolicyDoc, type TrustPolicyLearningSummary, type TrustPolicyRecommendation, TrustRecommendationManager, type TrustRecommendationStatus, type TrustState, type UpdateProfileInput, type UserWakeEvent, UserWakeSubscription, type UserWakeSubscriptionOptions, WsSubscription, type WsSubscriptionOptions, buildDecisionReminderOutboxMessage, buildDeliveryTimeline, buildHumanDeliveryBindingCandidate, buildHumanDeliveryPayload, buildNotificationIntentInputFromProjectionOutbox, buildProjectionPreview, buildSessionKey, buildSessionSummaryHandoffText, buildTrustPolicyRecommendations, capabilityCardToLegacyCapabilities, clearSessionBindingAlert, decideContactPolicy, decideTaskPolicy, decryptPayloadForIdentity, defaultTrustPolicyDoc, deriveOwnerRefFromOpenClawSessionEntry, deriveTransportHealth, describeProjectionPreset, encryptPayloadForRecipients, ensureIdentityEncryptionKeys, ensureTokenValid, formatCapabilityCardSummary, generateIdentity, getActiveSessionFilePath, getIdentityPath, getIngressRuntimeStatusFilePath, getOpenClawConfigFilePath, getOpenClawSessionEntry, getOpenClawSessionStorePath, getProfile, getProjectedEventTypes, getProjectionDisposition, getRootDir, getSessionBindingAlertsFilePath, getSessionMapFilePath, getStorePath, getTransportPreferenceFilePath, getTrustRecommendationActionLabel, hasDecisionPromptOutbox, identityExists, isEncryptedPayload, listOpenClawSessionEntries, listPendingDecisionViews, listRecentBindingsForSession, loadIdentity, matchesTrustPolicyRule, normalizeCapabilityCard, normalizeTransportMode, normalizeTrustPolicyDoc, parseNotificationOverride, previewFromPayload, readCurrentActiveSessionKey, readIngressRuntimeStatus, readSessionBindingAlerts, readSessionBindings, readTransportPreference, removeSessionBinding, resolveHumanDeliveryBinding, saveIdentity, setSessionBinding, shouldEncryptConversationPayload, summarizeHumanDelivery, summarizeSinceLastSeen, summarizeTrustPolicyAudit, switchTransportPreference, updateStoredToken, upsertSessionBindingAlert, upsertTrustPolicyRecommendation, writeSessionBindingAlerts, writeSessionBindings, writeTransportPreference };
+export { A2AAdapter, type A2AAdapterOptions, type A2ATaskResult, type AgentEncryptionCard, type AgentProfile, type CapabilityCard, type CapabilityCardItem, type CapabilityContactMode, type ClientOptions, type CollaborationApprovalStatus, type CollaborationDecisionView, type CollaborationEvent, type CollaborationEventInput, CollaborationEventManager, type CollaborationEventSeverity, type CollaborationEventSummary, type CollaborationEventType, type CollaborationProjectionKind, type CollaborationProjectionOutboxEntry, type CollaborationProjectionOutboxInput, CollaborationProjectionOutboxManager, type CollaborationProjectionOutboxStatus, type CollaborationProjectionPreset, type Contact, type ContactCardShare, ContactManager, type ContactPolicyAction, type ContactPolicyDecision, type ConversationEntry, type ConversationListResponse, type DeliveryTimelineEntry, type DeriveOpenClawAgentStateInput, type DirectoryBrowseResponse, type DirectorySelfResponse, type EncryptedPayloadWrapper, type EncryptionIdentityFields, type EncryptionPrivateKeyJwk, type EncryptionPublicKeyJwk, type FeedByDidResponse, type FeedPost, type FeedPublicResponse, type FetchResponse, HUMAN_DELIVERY_CHANNELS, HistoryManager, HttpTransport, type HumanDeliveryBinding, type HumanDeliveryBindingInput, HumanDeliveryBindingManager, type HumanDeliveryBindingStatus, type HumanDeliveryChannel, type HumanDeliveryChannelCapability, type HumanDeliverySummary, LocalStore, type ManagedTransportSwitchResult, type MarkOperatorSeenInput, type NotificationIntent, type NotificationIntentBindingScope, type NotificationIntentInput, NotificationIntentManager, type NotificationIntentStatus, type NotificationIntentType, type NotificationOverride, type OpenClawAgentLifecycleState, type OpenClawAgentState, type OpenClawDeliveryContext, type OpenClawHumanDeliveryBindingCandidate, type OpenClawIngressRuntimeStatus, type OpenClawSessionEntryRecord, type OpenClawTransportMode, type OperatorSeenState, OperatorSeenStateManager, type OperatorSeenStateOperatorId, type OperatorSeenStateScopeType, PingAgentClient, type ProjectionDisposition, type ProjectionDispositionInput, type ProjectionDispositionResult, type ProjectionPreviewEntry, type PublicAgentProfile, type PublicLinkState, type RecommendationSummary, type ReplyTarget, type ResolveCollaborationApprovalInput, type ResolveCollaborationApprovalResult, type ResolveHumanDeliveryBindingInput, type ResolveHumanDeliveryBindingResult, type RuntimeMode, SESSION_SUMMARY_FIELDS, type SendResponse, type SessionBindingAlert, type SessionBindingEntry, SessionManager, type SessionMessageInput, type SessionState, type SessionSummary, type SessionSummaryFieldKey, SessionSummaryManager, type SessionSummaryUpsert, type SinceLastSeenSummary, type StoredMessage, type StoredTrustRecommendation, type SubscriptionResponse, type SubscriptionUsage, type SyncTrustRecommendationsInput, type TaskHandoff, TaskHandoffManager, type TaskHandoffPayload, type TaskHandoffUpsert, type TaskPolicyAction, type TaskPolicyDecision, type TaskResult, type TaskShareEntry, type TaskThread, TaskThreadManager, type TaskThreadStatus, type TaskThreadUpsert, type TransportHealth, type TransportHealthState, type TransportOptions, type TransportPreferenceState, type TrustPolicyAuditEvent, type TrustPolicyAuditEventType, type TrustPolicyAuditInput, TrustPolicyAuditManager, type TrustPolicyAuditSummary, type TrustPolicyContext, type TrustPolicyDoc, type TrustPolicyLearningSummary, type TrustPolicyRecommendation, TrustRecommendationManager, type TrustRecommendationStatus, type TrustState, type UpdateProfileInput, type UserWakeEvent, UserWakeSubscription, type UserWakeSubscriptionOptions, WsSubscription, type WsSubscriptionOptions, buildDecisionReminderOutboxMessage, buildDeliveryTimeline, buildHumanDeliveryBindingCandidate, buildHumanDeliveryPayload, buildNotificationIntentInputFromProjectionOutbox, buildProjectionPreview, buildSessionKey, buildSessionSummaryHandoffText, buildTrustPolicyRecommendations, capabilityCardToLegacyCapabilities, clearSessionBindingAlert, decideContactPolicy, decideTaskPolicy, decryptPayloadForIdentity, defaultTrustPolicyDoc, deriveOpenClawAgentState, deriveOwnerRefFromOpenClawSessionEntry, deriveTransportHealth, describeOpenClawAgentState, describeProjectionPreset, encryptPayloadForRecipients, ensureIdentityEncryptionKeys, ensureTokenValid, formatCapabilityCardSummary, generateIdentity, getActiveSessionFilePath, getIdentityPath, getIngressRuntimeStatusFilePath, getOpenClawConfigFilePath, getOpenClawSessionEntry, getOpenClawSessionStorePath, getProfile, getProjectedEventTypes, getProjectionDisposition, getRootDir, getSessionBindingAlertsFilePath, getSessionMapFilePath, getStorePath, getTransportPreferenceFilePath, getTrustRecommendationActionLabel, hasDecisionPromptOutbox, identityExists, isEncryptedPayload, listOpenClawSessionEntries, listPendingDecisionViews, listRecentBindingsForSession, loadIdentity, matchesTrustPolicyRule, nextActionForOpenClawAgentState, normalizeCapabilityCard, normalizeTransportMode, normalizeTrustPolicyDoc, parseNotificationOverride, previewFromPayload, readCurrentActiveSessionKey, readIngressRuntimeStatus, readSessionBindingAlerts, readSessionBindings, readTransportPreference, removeSessionBinding, resolveHumanDeliveryBinding, saveIdentity, setSessionBinding, shouldEncryptConversationPayload, summarizeHumanDelivery, summarizeSinceLastSeen, summarizeTrustPolicyAudit, switchTransportPreference, updateStoredToken, upsertSessionBindingAlert, upsertTrustPolicyRecommendation, writeSessionBindingAlerts, writeSessionBindings, writeTransportPreference };

package/dist/index.js

@@ -35,8 +35,10 @@ import {
   decideTaskPolicy,
   decryptPayloadForIdentity,
   defaultTrustPolicyDoc,
+  deriveOpenClawAgentState,
   deriveOwnerRefFromOpenClawSessionEntry,
   deriveTransportHealth,
+  describeOpenClawAgentState,
   describeProjectionPreset,
   encryptPayloadForRecipients,
   ensureIdentityEncryptionKeys,
@@ -66,6 +68,7 @@ import {
   listRecentBindingsForSession,
   loadIdentity,
   matchesTrustPolicyRule,
+  nextActionForOpenClawAgentState,
   normalizeCapabilityCard,
   normalizeTransportMode,
   normalizeTrustPolicyDoc,
@@ -91,7 +94,7 @@ import {
   writeSessionBindingAlerts,
   writeSessionBindings,
   writeTransportPreference
-} from "./chunk-GU5W4KRD.js";
+} from "./chunk-IB7OSFZS.js";
 export {
   A2AAdapter,
   CollaborationEventManager,
@@ -129,8 +132,10 @@ export {
   decideTaskPolicy,
   decryptPayloadForIdentity,
   defaultTrustPolicyDoc,
+  deriveOpenClawAgentState,
   deriveOwnerRefFromOpenClawSessionEntry,
   deriveTransportHealth,
+  describeOpenClawAgentState,
   describeProjectionPreset,
   encryptPayloadForRecipients,
   ensureIdentityEncryptionKeys,
@@ -160,6 +165,7 @@ export {
   listRecentBindingsForSession,
   loadIdentity,
   matchesTrustPolicyRule,
+  nextActionForOpenClawAgentState,
   normalizeCapabilityCard,
   normalizeTransportMode,
   normalizeTrustPolicyDoc,

package/dist/web-server.js

@@ -14,6 +14,7 @@ import {
   decideContactPolicy,
   decideTaskPolicy,
   defaultTrustPolicyDoc,
+  deriveOpenClawAgentState,
   deriveTransportHealth,
   ensureTokenValid,
   getActiveSessionFilePath,
@@ -37,7 +38,7 @@ import {
   switchTransportPreference,
   updateStoredToken,
   upsertTrustPolicyRecommendation
-} from "./chunk-GU5W4KRD.js";
+} from "./chunk-IB7OSFZS.js";
 
 // src/web-server.ts
 import * as fs from "fs";
@@ -263,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>
@@ -281,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>
@@ -866,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">' +
@@ -927,8 +928,8 @@ function getHostPanelHtml() {
       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.');
+          ? '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),
@@ -943,7 +944,7 @@ function getHostPanelHtml() {
                 (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>');
+          : '<div class="empty">No pending or failed legacy projection deliveries.</div>');
 
       document.querySelectorAll('.inbox-decision-btn').forEach(function (btn) {
         btn.addEventListener('click', async function () {
@@ -1008,24 +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">' +
@@ -1069,7 +1087,13 @@ function getHostPanelHtml() {
       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' : '';
@@ -1079,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) + '">' +
@@ -1087,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>';
@@ -1252,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>' +
@@ -1271,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
@@ -1280,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'
@@ -1299,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>' +
@@ -1391,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">' +
@@ -1586,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 +
@@ -1594,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', {
@@ -2292,6 +2321,16 @@ function readHumanDeliveryState(storePath, limit = 12) {
     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();
@@ -2423,6 +2462,13 @@ async function buildRuntimeOverviewPayload(ctx) {
   } finally {
     decisionStore.close();
   }
+  const agentState = buildOpenClawAgentStatePayload({
+    runtimeStatus: ingressRuntime,
+    sessions,
+    pendingDecisions: decisionViews,
+    humanDelivery,
+    transportHealth
+  });
   return {
     did: ctx.myDid,
     serverUrl: ctx.serverUrl,
@@ -2461,6 +2507,7 @@ async function buildRuntimeOverviewPayload(ctx) {
     collaborationSummary,
     projectionOutbox,
     transportHealth,
+    agentState,
     sinceLastSeen,
     humanDelivery,
     humanDeliveryDetails,
@@ -2559,6 +2606,13 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
   } 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),
@@ -2567,6 +2621,7 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
     collaborationSummary: collaborationEventManager.summarize(200),
     ingressRuntime: readIngressRuntimeStatus(),
     transportHealth: readTransportHealthState(ctx.storePath),
+    agentState,
     binding,
     bindingAlert,
     activeWorkSession,

package/package.json

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