@pingagent/sdk 0.1.9 → 0.1.10

package/dist/index.d.ts

@@ -947,4 +947,40 @@ declare class WsSubscription {
     private syncConnections;
 }
 
-export { A2AAdapter, type A2AAdapterOptions, type A2ATaskResult, type AgentEncryptionCard, type AgentProfile, type ClientOptions, type Contact, ContactManager, type ContactPolicyAction, type ContactPolicyDecision, type ConversationEntry, type ConversationListResponse, type DirectoryBrowseResponse, type DirectorySelfResponse, type EncryptedPayloadWrapper, type EncryptionIdentityFields, type EncryptionPrivateKeyJwk, type EncryptionPublicKeyJwk, type FeedByDidResponse, type FeedPost, type FeedPublicResponse, type FetchResponse, HistoryManager, HttpTransport, LocalStore, PingAgentClient, type RecommendationSummary, type ReplyTarget, type RuntimeMode, type SendResponse, SessionManager, type SessionMessageInput, type SessionState, type StoredMessage, type StoredTrustRecommendation, type SubscriptionResponse, type SubscriptionUsage, type SyncTrustRecommendationsInput, type TaskPolicyAction, type TaskPolicyDecision, type TaskResult, type TaskThread, TaskThreadManager, type TaskThreadStatus, type TaskThreadUpsert, type TransportOptions, type TrustPolicyAuditEvent, type TrustPolicyAuditEventType, type TrustPolicyAuditInput, TrustPolicyAuditManager, type TrustPolicyAuditSummary, type TrustPolicyContext, type TrustPolicyDoc, type TrustPolicyLearningSummary, type TrustPolicyRecommendation, TrustRecommendationManager, type TrustRecommendationStatus, type TrustState, WsSubscription, type WsSubscriptionOptions, buildSessionKey, buildTrustPolicyRecommendations, decideContactPolicy, decideTaskPolicy, decryptPayloadForIdentity, defaultTrustPolicyDoc, encryptPayloadForRecipients, ensureIdentityEncryptionKeys, ensureTokenValid, generateIdentity, getIdentityPath, getProfile, getRootDir, getStorePath, identityExists, isEncryptedPayload, loadIdentity, matchesTrustPolicyRule, normalizeTrustPolicyDoc, previewFromPayload, saveIdentity, shouldEncryptConversationPayload, summarizeTrustPolicyAudit, updateStoredToken, upsertTrustPolicyRecommendation };
+declare function getActiveSessionFilePath(): string;
+declare function getSessionMapFilePath(): string;
+declare function getSessionBindingAlertsFilePath(): string;
+declare function readCurrentActiveSessionKey(filePath?: string): string | null;
+interface SessionBindingEntry {
+    conversation_id: string;
+    session_key: string;
+}
+interface SessionBindingAlert {
+    conversation_id: string;
+    session_key: string;
+    status: 'missing_session';
+    message: string;
+    detected_at: string;
+}
+declare function readSessionBindings(filePath?: string): SessionBindingEntry[];
+declare function writeSessionBindings(entries: SessionBindingEntry[], filePath?: string): string;
+declare function setSessionBinding(conversationId: string, sessionKey: string, filePath?: string): {
+    path: string;
+    binding: SessionBindingEntry;
+};
+declare function removeSessionBinding(conversationId: string, filePath?: string): {
+    path: string;
+    removed: boolean;
+};
+declare function readSessionBindingAlerts(filePath?: string): SessionBindingAlert[];
+declare function writeSessionBindingAlerts(entries: SessionBindingAlert[], filePath?: string): string;
+declare function upsertSessionBindingAlert(alert: SessionBindingAlert, filePath?: string): {
+    path: string;
+    alert: SessionBindingAlert;
+};
+declare function clearSessionBindingAlert(conversationId: string, filePath?: string): {
+    path: string;
+    removed: boolean;
+};
+
+export { A2AAdapter, type A2AAdapterOptions, type A2ATaskResult, type AgentEncryptionCard, type AgentProfile, type ClientOptions, type Contact, ContactManager, type ContactPolicyAction, type ContactPolicyDecision, type ConversationEntry, type ConversationListResponse, type DirectoryBrowseResponse, type DirectorySelfResponse, type EncryptedPayloadWrapper, type EncryptionIdentityFields, type EncryptionPrivateKeyJwk, type EncryptionPublicKeyJwk, type FeedByDidResponse, type FeedPost, type FeedPublicResponse, type FetchResponse, HistoryManager, HttpTransport, LocalStore, PingAgentClient, type RecommendationSummary, type ReplyTarget, type RuntimeMode, type SendResponse, type SessionBindingAlert, type SessionBindingEntry, SessionManager, type SessionMessageInput, type SessionState, type StoredMessage, type StoredTrustRecommendation, type SubscriptionResponse, type SubscriptionUsage, type SyncTrustRecommendationsInput, type TaskPolicyAction, type TaskPolicyDecision, type TaskResult, type TaskThread, TaskThreadManager, type TaskThreadStatus, type TaskThreadUpsert, type TransportOptions, type TrustPolicyAuditEvent, type TrustPolicyAuditEventType, type TrustPolicyAuditInput, TrustPolicyAuditManager, type TrustPolicyAuditSummary, type TrustPolicyContext, type TrustPolicyDoc, type TrustPolicyLearningSummary, type TrustPolicyRecommendation, TrustRecommendationManager, type TrustRecommendationStatus, type TrustState, WsSubscription, type WsSubscriptionOptions, buildSessionKey, buildTrustPolicyRecommendations, clearSessionBindingAlert, decideContactPolicy, decideTaskPolicy, decryptPayloadForIdentity, defaultTrustPolicyDoc, encryptPayloadForRecipients, ensureIdentityEncryptionKeys, ensureTokenValid, generateIdentity, getActiveSessionFilePath, getIdentityPath, getProfile, getRootDir, getSessionBindingAlertsFilePath, getSessionMapFilePath, getStorePath, identityExists, isEncryptedPayload, loadIdentity, matchesTrustPolicyRule, normalizeTrustPolicyDoc, previewFromPayload, readCurrentActiveSessionKey, readSessionBindingAlerts, readSessionBindings, removeSessionBinding, saveIdentity, setSessionBinding, shouldEncryptConversationPayload, summarizeTrustPolicyAudit, updateStoredToken, upsertSessionBindingAlert, upsertTrustPolicyRecommendation, writeSessionBindingAlerts, writeSessionBindings };

package/dist/index.js

@@ -12,6 +12,7 @@ import {
   WsSubscription,
   buildSessionKey,
   buildTrustPolicyRecommendations,
+  clearSessionBindingAlert,
   decideContactPolicy,
   decideTaskPolicy,
   decryptPayloadForIdentity,
@@ -20,9 +21,12 @@ import {
   ensureIdentityEncryptionKeys,
   ensureTokenValid,
   generateIdentity,
+  getActiveSessionFilePath,
   getIdentityPath,
   getProfile,
   getRootDir,
+  getSessionBindingAlertsFilePath,
+  getSessionMapFilePath,
   getStorePath,
   identityExists,
   isEncryptedPayload,
@@ -30,12 +34,20 @@ import {
   matchesTrustPolicyRule,
   normalizeTrustPolicyDoc,
   previewFromPayload,
+  readCurrentActiveSessionKey,
+  readSessionBindingAlerts,
+  readSessionBindings,
+  removeSessionBinding,
   saveIdentity,
+  setSessionBinding,
   shouldEncryptConversationPayload,
   summarizeTrustPolicyAudit,
   updateStoredToken,
-  upsertTrustPolicyRecommendation
-} from "./chunk-PFABO4C7.js";
+  upsertSessionBindingAlert,
+  upsertTrustPolicyRecommendation,
+  writeSessionBindingAlerts,
+  writeSessionBindings
+} from "./chunk-2Y6YRKTO.js";
 export {
   A2AAdapter,
   ContactManager,
@@ -50,6 +62,7 @@ export {
   WsSubscription,
   buildSessionKey,
   buildTrustPolicyRecommendations,
+  clearSessionBindingAlert,
   decideContactPolicy,
   decideTaskPolicy,
   decryptPayloadForIdentity,
@@ -58,9 +71,12 @@ export {
   ensureIdentityEncryptionKeys,
   ensureTokenValid,
   generateIdentity,
+  getActiveSessionFilePath,
   getIdentityPath,
   getProfile,
   getRootDir,
+  getSessionBindingAlertsFilePath,
+  getSessionMapFilePath,
   getStorePath,
   identityExists,
   isEncryptedPayload,
@@ -68,9 +84,17 @@ export {
   matchesTrustPolicyRule,
   normalizeTrustPolicyDoc,
   previewFromPayload,
+  readCurrentActiveSessionKey,
+  readSessionBindingAlerts,
+  readSessionBindings,
+  removeSessionBinding,
   saveIdentity,
+  setSessionBinding,
   shouldEncryptConversationPayload,
   summarizeTrustPolicyAudit,
   updateStoredToken,
-  upsertTrustPolicyRecommendation
+  upsertSessionBindingAlert,
+  upsertTrustPolicyRecommendation,
+  writeSessionBindingAlerts,
+  writeSessionBindings
 };

package/dist/web-server.js

@@ -8,12 +8,20 @@ import {
   decideTaskPolicy,
   defaultTrustPolicyDoc,
   ensureTokenValid,
+  getActiveSessionFilePath,
+  getSessionBindingAlertsFilePath,
+  getSessionMapFilePath,
   loadIdentity,
   normalizeTrustPolicyDoc,
+  readCurrentActiveSessionKey,
+  readSessionBindingAlerts,
+  readSessionBindings,
+  removeSessionBinding,
+  setSessionBinding,
   summarizeTrustPolicyAudit,
   updateStoredToken,
   upsertTrustPolicyRecommendation
-} from "./chunk-PFABO4C7.js";
+} from "./chunk-2Y6YRKTO.js";
 
 // src/web-server.ts
 import * as fs from "fs";
@@ -81,10 +89,12 @@ function getHostPanelHtml() {
     .session-row .top, .task-row .top, .recommendation-row .top { display: flex; justify-content: space-between; gap: 12px; align-items: center; }
     .label { font-size: 11px; text-transform: uppercase; letter-spacing: 0.06em; color: #94a3b8; }
     .badge { display: inline-flex; align-items: center; padding: 2px 8px; border-radius: 999px; font-size: 11px; border: 1px solid #334155; }
+    button.badge { cursor: pointer; font: inherit; }
     .badge.trusted { background: rgba(34, 197, 94, 0.12); color: #86efac; border-color: rgba(34, 197, 94, 0.35); }
     .badge.pending { background: rgba(250, 204, 21, 0.12); color: #fde68a; border-color: rgba(250, 204, 21, 0.35); }
     .badge.blocked, .badge.revoked { background: rgba(248, 113, 113, 0.12); color: #fca5a5; border-color: rgba(248, 113, 113, 0.35); }
     .badge.stranger { background: rgba(148, 163, 184, 0.12); color: #cbd5e1; border-color: rgba(148, 163, 184, 0.35); }
+    .badge.alert { background: rgba(248, 113, 113, 0.14); color: #fecaca; border-color: rgba(248, 113, 113, 0.45); }
     .policy-grid { grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); align-items: start; }
     .two-col { display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 16px; }
     .panel { display: none; }
@@ -361,11 +371,17 @@ function getHostPanelHtml() {
         if (!state.selectedSessionKey) state.selectedSessionKey = sessions[0].session_key;
         document.getElementById('sessionList').innerHTML = sessions.map(function (session) {
           const active = session.session_key === state.selectedSessionKey ? ' active' : '';
-          const badge = '<span class="badge ' + esc(session.trust_state) + '">' + esc(session.trust_state) + '</span>';
+          const badges = [
+            '<span class="badge ' + esc(session.trust_state) + '">' + esc(session.trust_state) + '</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="' + esc(session.binding_alert.message || 'Rebind this conversation to the current chat session') + '">Needs rebind</button>'
+              : '',
+          ].filter(Boolean).join('');
           return '<div class="session-row' + active + '" data-session="' + esc(session.session_key) + '">' +
-            '<div class="top"><strong>' + esc(session.remote_did || session.conversation_id || 'unknown') + '</strong>' + badge + '</div>' +
+            '<div class="top"><strong>' + esc(session.remote_did || session.conversation_id || 'unknown') + '</strong><div style="display:flex;gap:6px;flex-wrap:wrap;justify-content:flex-end">' + badges + '</div></div>' +
             '<div class="muted small" style="margin-top:6px">conversation=' + esc(session.conversation_id || '(none)') + '</div>' +
             '<div class="muted small">unread=' + esc(session.unread_count) + ' \xB7 last=' + esc(fmtTs(session.last_remote_activity_at || session.updated_at)) + '</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" style="margin-top:6px">' + esc(session.last_message_preview || '(no preview)') + '</div>' +
           '</div>';
         }).join('');
@@ -376,6 +392,20 @@ function getHostPanelHtml() {
             loadSession(state.selectedSessionKey);
           });
         });
+        document.getElementById('sessionList').querySelectorAll('.rebind-badge-btn').forEach(function (btn) {
+          btn.addEventListener('click', async function (event) {
+            event.stopPropagation();
+            const sessionKey = btn.getAttribute('data-session');
+            const conversationId = btn.getAttribute('data-conversation');
+            const previousBinding = btn.getAttribute('data-bound-session');
+            const remoteDid = btn.getAttribute('data-remote-did');
+            if (!sessionKey || !conversationId) return;
+            state.selectedSessionKey = sessionKey;
+            renderOverview();
+            await loadSession(sessionKey);
+            await promptBindCurrentChat(conversationId, previousBinding, remoteDid);
+          });
+        });
       }
 
       const tasks = Array.isArray(overview.tasks) ? overview.tasks : [];
@@ -419,6 +449,9 @@ function getHostPanelHtml() {
       const messages = Array.isArray(detail.messages) ? detail.messages : [];
       const auditEvents = Array.isArray(detail.auditEvents) ? detail.auditEvents : [];
       const recommendations = Array.isArray(detail.recommendations) ? detail.recommendations : [];
+      const binding = detail.binding || null;
+      const bindingAlert = detail.bindingAlert || null;
+      const activeWorkSession = detail.activeWorkSession || null;
 
       el.innerHTML = '' +
         '<div class="two-col">' +
@@ -429,6 +462,15 @@ function getHostPanelHtml() {
             '<div class="muted small">conversation=' + esc(session.conversation_id || '(none)') + '</div>' +
             '<div class="muted small">trust=' + esc(session.trust_state) + ' \xB7 unread=' + esc(session.unread_count) + '</div>' +
             '<div class="muted small">last activity=' + esc(fmtTs(session.last_remote_activity_at || session.updated_at)) + '</div>' +
+            '<div class="muted small" style="margin-top:8px">active_chat_session=' + esc(activeWorkSession || '(none)') + '</div>' +
+            '<div class="muted small">binding=' + esc(binding ? binding.session_key : '(unbound)') + '</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 rebind</strong><div class="small" style="margin-top:6px">' + esc(bindingAlert.message || 'Bound work session is missing. Rebind this PingAgent conversation to the current chat session.') + '</div></div>'
+              : '') +
+            '<div class="row-actions">' +
+              '<button class="action-btn bind-current-btn" data-conversation="' + esc(session.conversation_id || '') + '">Bind Current Chat</button>' +
+              '<button class="danger-btn clear-binding-btn" data-conversation="' + esc(session.conversation_id || '') + '">Clear Binding</button>' +
+            '</div>' +
           '</div>' +
           '<div>' +
             '<div class="label">Policy Decisions</div>' +
@@ -473,6 +515,54 @@ function getHostPanelHtml() {
             }).join('') : '<div class="empty">No audit events for this session.</div>') +
           '</div></div>' +
         '</div>';
+
+      el.querySelectorAll('.bind-current-btn').forEach(function (btn) {
+        btn.addEventListener('click', async function () {
+          const conversationId = btn.getAttribute('data-conversation');
+          if (!conversationId) return;
+          await promptBindCurrentChat(conversationId);
+        });
+      });
+      el.querySelectorAll('.clear-binding-btn').forEach(function (btn) {
+        btn.addEventListener('click', async function () {
+          await api('/api/runtime/session-bindings/clear', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ conversation_id: btn.getAttribute('data-conversation') }),
+          });
+          await refreshAll();
+          setTab('runtime');
+        });
+      });
+    }
+
+    async function promptBindCurrentChat(conversationId, previousBinding, remoteDid) {
+      const current = state.session && state.session.activeWorkSession
+        ? state.session.activeWorkSession
+        : (state.overview && state.overview.activeWorkSession ? state.overview.activeWorkSession : null);
+      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(
+        'Rebind this PingAgent conversation to the current chat session?' +
+        '
+
+Conversation: ' + conversationId +
+        '
+Remote DID: ' + targetRemoteDid +
+        '
+
+Current chat: ' + (current || '(none)') +
+        '
+Previous binding: ' + previous
+      );
+      if (!confirmed) return;
+      await api('/api/runtime/session-bindings/bind-current', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ conversation_id: conversationId }),
+      });
+      await refreshAll();
+      setTab('runtime');
     }
 
     function renderPolicy() {
@@ -990,6 +1080,11 @@ async function buildRuntimeOverviewPayload(ctx) {
     limit: 12
   });
   const unreadTotal = sessions.reduce((sum, session) => sum + session.unread_count, 0);
+  const sessionBindings = readSessionBindings();
+  const sessionBindingAlerts = readSessionBindingAlerts();
+  const activeWorkSession = readCurrentActiveSessionKey();
+  const bindingByConversation = new Map(sessionBindings.map((row) => [row.conversation_id, row.session_key]));
+  const bindingAlertByConversation = new Map(sessionBindingAlerts.map((row) => [row.conversation_id, row]));
   const trustCounts = sessions.reduce((acc, session) => {
     acc[session.trust_state] = (acc[session.trust_state] ?? 0) + 1;
     return acc;
@@ -999,6 +1094,12 @@ async function buildRuntimeOverviewPayload(ctx) {
     serverUrl: ctx.serverUrl,
     runtimeMode,
     trustPolicyPath: getTrustPolicyPath(ctx.identityPath),
+    activeWorkSessionFile: getActiveSessionFilePath(),
+    activeWorkSession,
+    sessionMapPath: getSessionMapFilePath(),
+    sessionBindingAlertsPath: getSessionBindingAlertsFilePath(),
+    sessionBindings,
+    sessionBindingAlerts,
     subscription: subscription ? {
       tier: subscription.tier,
       summary: describeHostedTier(subscription.tier),
@@ -1021,6 +1122,9 @@ async function buildRuntimeOverviewPayload(ctx) {
     recommendationSummary: recommendationState.summary,
     sessions: sessions.map((session) => ({
       ...session,
+      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) : []
     })),
     tasks: refreshedTasks,
@@ -1054,6 +1158,11 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
     auditStore.close();
   }
   const policy = readTrustPolicyDoc(ctx.identityPath);
+  const bindings = readSessionBindings();
+  const bindingAlerts = readSessionBindingAlerts();
+  const binding = session.conversation_id ? bindings.find((row) => row.conversation_id === session.conversation_id) ?? null : null;
+  const bindingAlert = session.conversation_id ? bindingAlerts.find((row) => row.conversation_id === session.conversation_id) ?? null : null;
+  const activeWorkSession = readCurrentActiveSessionKey();
   const recommendationState = syncTrustRecommendations(ctx.storePath, {
     policyDoc: policy,
     sessions: sessionManager.listRecentSessions(50),
@@ -1064,6 +1173,12 @@ async function buildSessionOverviewPayload(ctx, sessionKey) {
   });
   return {
     session,
+    binding,
+    bindingAlert,
+    activeWorkSession,
+    activeWorkSessionFile: getActiveSessionFilePath(),
+    sessionMapPath: getSessionMapFilePath(),
+    sessionBindingAlertsPath: getSessionBindingAlertsFilePath(),
     policyExplain: buildPolicyDecisionShape(ctx.identityPath, session.remote_did, { runtimeMode: getRuntimeMode() }),
     tasks,
     messages,
@@ -1089,6 +1204,63 @@ async function handleApi(pathname, req, ctx) {
       const sessionKey = url.searchParams.get("session_key");
       return buildSessionOverviewPayload(ctx, sessionKey);
     }
+    if (parts[1] === "session-bindings") {
+      if ((!parts[2] || parts[2] === "list") && req.method === "GET") {
+        const url = new URL(req.url || "", "http://x");
+        const conversationId = url.searchParams.get("conversation_id");
+        const rows = conversationId ? readSessionBindings().filter((row) => row.conversation_id === conversationId) : readSessionBindings();
+        return {
+          activeWorkSessionFile: getActiveSessionFilePath(),
+          activeWorkSession: readCurrentActiveSessionKey(),
+          sessionMapPath: getSessionMapFilePath(),
+          sessionBindingAlertsPath: getSessionBindingAlertsFilePath(),
+          alerts: conversationId ? readSessionBindingAlerts().filter((row) => row.conversation_id === conversationId) : readSessionBindingAlerts(),
+          bindings: rows
+        };
+      }
+      if (parts[2] === "bind-current" && req.method === "POST") {
+        const body = await readBody(req);
+        const conversationId = String(body?.conversation_id ?? "").trim();
+        if (!conversationId) throw new Error("conversation_id is required");
+        const current = readCurrentActiveSessionKey();
+        if (!current) {
+          throw new Error(`No active OpenClaw chat session found in ${getActiveSessionFilePath()}`);
+        }
+        const result = setSessionBinding(conversationId, current);
+        return {
+          ok: true,
+          activeWorkSessionFile: getActiveSessionFilePath(),
+          activeWorkSession: current,
+          sessionMapPath: result.path,
+          binding: result.binding
+        };
+      }
+      if (parts[2] === "set" && req.method === "POST") {
+        const body = await readBody(req);
+        const conversationId = String(body?.conversation_id ?? "").trim();
+        const sessionKey = String(body?.session_key ?? "").trim();
+        if (!conversationId || !sessionKey) throw new Error("conversation_id and session_key are required");
+        const result = setSessionBinding(conversationId, sessionKey);
+        return {
+          ok: true,
+          activeWorkSessionFile: getActiveSessionFilePath(),
+          activeWorkSession: readCurrentActiveSessionKey(),
+          sessionMapPath: result.path,
+          binding: result.binding
+        };
+      }
+      if (parts[2] === "clear" && req.method === "POST") {
+        const body = await readBody(req);
+        const conversationId = String(body?.conversation_id ?? "").trim();
+        if (!conversationId) throw new Error("conversation_id is required");
+        const result = removeSessionBinding(conversationId);
+        return {
+          ok: true,
+          removed: result.removed,
+          sessionMapPath: result.path
+        };
+      }
+    }
     if (parts[1] === "policy") {
       const policyPath = getTrustPolicyPath(ctx.identityPath);
       const runtimeMode = getRuntimeMode();

package/package.json

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