@pingagent/sdk 0.1.14 → 0.1.15

package/dist/index.d.ts

@@ -302,11 +302,12 @@ declare class CollaborationProjectionOutboxManager {
     listDispatchable(limit?: number): CollaborationProjectionOutboxEntry[];
     listBySession(sessionKey: string, limit?: number): CollaborationProjectionOutboxEntry[];
     listByStatus(status: CollaborationProjectionOutboxStatus, limit?: number): CollaborationProjectionOutboxEntry[];
+    findBySourceEventId(sourceEventId: number, projectionKind?: CollaborationProjectionKind): CollaborationProjectionOutboxEntry[];
     markSent(id: number, deliveredAt?: number): CollaborationProjectionOutboxEntry | null;
     markFailed(id: number, error: string): CollaborationProjectionOutboxEntry | null;
 }
 
-type CollaborationEventType = 'external_message_received' | 'agent_progress' | 'agent_conclusion' | 'handoff_started' | 'handoff_completed' | 'risk_detected' | 'decision_required' | 'task_completed' | 'runtime_degraded' | 'runtime_repaired';
+type CollaborationEventType = 'external_message_received' | 'agent_progress' | 'agent_conclusion' | 'handoff_started' | 'handoff_completed' | 'risk_detected' | 'decision_required' | 'task_completed' | 'runtime_degraded' | 'runtime_repaired' | 'transport_switch_recommended' | 'transport_switched';
 type CollaborationEventSeverity = 'info' | 'notice' | 'warning' | 'critical';
 type CollaborationApprovalStatus = 'not_required' | 'pending' | 'approved' | 'rejected';
 interface CollaborationEvent {
@@ -362,6 +363,7 @@ declare class CollaborationEventManager {
     get(id: number): CollaborationEvent | null;
     listPending(limit?: number): CollaborationEvent[];
     listPendingBySession(sessionKey: string, limit?: number): CollaborationEvent[];
+    listPendingOlderThan(cutoffTs: number, limit?: number): CollaborationEvent[];
     resolveApproval(id: number, approvalStatus: Extract<CollaborationApprovalStatus, 'approved' | 'rejected'>, input?: ResolveCollaborationApprovalInput): ResolveCollaborationApprovalResult | null;
     summarize(limit?: number): CollaborationEventSummary;
 }
@@ -1131,6 +1133,186 @@ declare class TrustRecommendationManager {
     summarize(): RecommendationSummary;
 }
 
+type OperatorSeenStateOperatorId = 'host_panel' | 'tui' | 'mcp';
+type OperatorSeenStateScopeType = 'global' | 'session';
+interface OperatorSeenState {
+    operator_id: OperatorSeenStateOperatorId;
+    scope_type: OperatorSeenStateScopeType;
+    scope_key?: string | null;
+    last_seen_ts: number;
+    updated_at: number;
+}
+interface MarkOperatorSeenInput {
+    operator_id: OperatorSeenStateOperatorId;
+    scope_type: OperatorSeenStateScopeType;
+    scope_key?: string | null;
+    last_seen_ts?: number;
+}
+declare class OperatorSeenStateManager {
+    private store;
+    constructor(store: LocalStore);
+    get(operatorId: OperatorSeenStateOperatorId, scopeType: OperatorSeenStateScopeType, scopeKey?: string | null): OperatorSeenState | null;
+    markSeen(input: MarkOperatorSeenInput): OperatorSeenState;
+    listByOperator(operatorId: OperatorSeenStateOperatorId): OperatorSeenState[];
+}
+
+type ProjectionDisposition = 'project' | 'detail_only' | 'decision_gate';
+interface ProjectionDispositionInput {
+    preset: CollaborationProjectionPreset;
+    event_type?: CollaborationEventType | null;
+    has_pending_decision?: boolean;
+    projection_mode?: 'update' | 'decision' | 'runtime';
+}
+interface ProjectionDispositionResult {
+    disposition: ProjectionDisposition;
+    reason: string;
+}
+declare function getProjectedEventTypes(preset: CollaborationProjectionPreset): CollaborationEventType[];
+declare function describeProjectionPreset(preset: CollaborationProjectionPreset): {
+    immediate_event_types: CollaborationEventType[];
+    detail_only_event_types: CollaborationEventType[];
+};
+declare function getProjectionDisposition(input: ProjectionDispositionInput): ProjectionDispositionResult;
+
+interface SinceLastSeenSummary {
+    operator_id: OperatorSeenStateOperatorId;
+    scope_type: OperatorSeenStateScopeType;
+    scope_key?: string | null;
+    last_seen_ts?: number;
+    new_external_messages: number;
+    new_conclusions: number;
+    new_handoffs: number;
+    new_decisions: number;
+    new_failures: number;
+    new_repairs: number;
+    new_projection_failures: number;
+    latest_ts?: number;
+}
+interface DeliveryTimelineEntry {
+    ts_ms: number;
+    kind: string;
+    summary: string;
+    session_key?: string | null;
+    conversation_id?: string | null;
+    status?: string | null;
+    detail?: Record<string, unknown> | null;
+}
+interface ProjectionPreviewEntry {
+    event_id: number;
+    ts_ms: number;
+    event_type: CollaborationEventType;
+    summary: string;
+    disposition: ProjectionDisposition;
+    reason: string;
+}
+interface CollaborationDecisionView extends CollaborationEvent {
+    overdue: boolean;
+    overdue_by_ms?: number;
+}
+declare function listPendingDecisionViews(store: LocalStore, limit?: number, overdueThresholdMs?: number): CollaborationDecisionView[];
+declare function summarizeSinceLastSeen(store: LocalStore, input: {
+    operator_id: OperatorSeenStateOperatorId;
+    scope_type: OperatorSeenStateScopeType;
+    scope_key?: string | null;
+}): SinceLastSeenSummary;
+declare function buildDeliveryTimeline(store: LocalStore, sessionKey: string, limit?: number): DeliveryTimelineEntry[];
+declare function buildProjectionPreview(store: LocalStore, sessionKey: string, preset: CollaborationProjectionPreset, limit?: number): {
+    preset: CollaborationProjectionPreset;
+    rules: ReturnType<typeof describeProjectionPreset>;
+    recent: ProjectionPreviewEntry[];
+};
+declare function buildDecisionReminderOutboxMessage(event: CollaborationEvent): string;
+declare function hasDecisionPromptOutbox(outboxManager: CollaborationProjectionOutboxManager, sourceEventId: number): boolean;
+
+type OpenClawTransportMode = 'bridge' | 'channel';
+interface TransportPreferenceState {
+    preferred_mode: OpenClawTransportMode;
+    updated_at: string;
+    updated_by: string;
+    last_auto_switch_at?: string | null;
+    last_auto_switch_reason?: string | null;
+}
+interface ManagedTransportSwitchResult {
+    preferred_mode: OpenClawTransportMode;
+    preference_path: string;
+    updated_at: string;
+    updated_by: string;
+    last_auto_switch_at?: string | null;
+    last_auto_switch_reason?: string | null;
+    restarted: boolean;
+    restart_required: boolean;
+    restart_method?: string | null;
+    restart_error?: string | null;
+}
+declare function normalizeTransportMode(value: unknown, fallback?: OpenClawTransportMode): OpenClawTransportMode;
+declare function getTransportPreferenceFilePath(): string;
+declare function readTransportPreference(filePath?: string): TransportPreferenceState | null;
+declare function writeTransportPreference(input: {
+    preferred_mode: OpenClawTransportMode;
+    updated_by: string;
+    last_auto_switch_at?: string | null;
+    last_auto_switch_reason?: string | null;
+}, filePath?: string): TransportPreferenceState;
+declare function switchTransportPreference(preferredMode: OpenClawTransportMode, opts: {
+    updated_by: string;
+    auto_switch_reason?: string | null;
+    attempt_restart?: boolean;
+    filePath?: string;
+}): ManagedTransportSwitchResult;
+
+interface OpenClawIngressRuntimeStatus {
+    receive_mode: 'webhook' | 'polling_degraded';
+    reason?: string | null;
+    hooks_url?: string | null;
+    hooks_base_url?: string | null;
+    hooks_last_error?: string | null;
+    hooks_last_error_at?: string | null;
+    hooks_last_probe_ok_at?: string | null;
+    hooks_message_mode?: string | null;
+    fallback_last_injected_at?: string | null;
+    fallback_last_injected_conversation_id?: string | null;
+    active_work_session?: string | null;
+    sessions_send_available?: boolean;
+    hooks_fix_hint?: string | null;
+    gateway_base_url?: string | null;
+    transport_mode?: OpenClawTransportMode;
+    preferred_transport_mode?: OpenClawTransportMode;
+    transport_switch_recommended?: boolean;
+    transport_switch_reason?: string | null;
+    channel_retry_queue_length?: number;
+    channel_last_inbound_at?: string | null;
+    channel_last_outbound_at?: string | null;
+    channel_last_degraded_at?: string | null;
+    channel_last_repaired_at?: string | null;
+    channel_last_error?: string | null;
+    channel_consecutive_failures?: number;
+    status_updated_at?: string | null;
+}
+declare function getIngressRuntimeStatusFilePath(): string;
+declare function readIngressRuntimeStatus(filePath?: string): OpenClawIngressRuntimeStatus | null;
+
+type TransportHealthState = 'Ready' | 'Degraded' | 'Switching Recommended';
+interface TransportHealth {
+    transport_mode: OpenClawTransportMode;
+    preferred_transport_mode: OpenClawTransportMode;
+    state: TransportHealthState;
+    transport_switch_recommended: boolean;
+    transport_switch_reason?: string | null;
+    retry_queue_length: number;
+    last_inbound_at?: string | null;
+    last_outbound_at?: string | null;
+    last_degraded_at?: string | null;
+    last_repaired_at?: string | null;
+    last_error?: string | null;
+    consecutive_failures: number;
+    receive_mode?: string | null;
+}
+declare function deriveTransportHealth(input: {
+    runtime_status?: OpenClawIngressRuntimeStatus | null;
+    recent_events?: CollaborationEvent[];
+    projection_outbox_failed?: CollaborationProjectionOutboxEntry[];
+}): TransportHealth;
+
 /**
  * A2A adapter for PingAgentClient.
  * Allows PingAgent to call external agents that speak the A2A protocol,
@@ -1346,21 +1528,4 @@ declare function clearSessionBindingAlert(conversationId: string, filePath?: str
     removed: boolean;
 };
 
-interface OpenClawIngressRuntimeStatus {
-    receive_mode: 'webhook' | 'polling_degraded';
-    reason?: string | null;
-    hooks_url?: string | null;
-    hooks_last_error?: string | null;
-    hooks_last_error_at?: string | null;
-    hooks_last_probe_ok_at?: string | null;
-    fallback_last_injected_at?: string | null;
-    fallback_last_injected_conversation_id?: string | null;
-    active_work_session?: string | null;
-    sessions_send_available?: boolean;
-    hooks_fix_hint?: string | null;
-    status_updated_at?: string | null;
-}
-declare function getIngressRuntimeStatusFilePath(): string;
-declare function readIngressRuntimeStatus(filePath?: string): OpenClawIngressRuntimeStatus | null;
-
-export { A2AAdapter, type A2AAdapterOptions, type A2ATaskResult, type AgentEncryptionCard, type AgentProfile, type CapabilityCard, type CapabilityCardItem, type CapabilityContactMode, type ClientOptions, type CollaborationApprovalStatus, 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 DirectoryBrowseResponse, type DirectorySelfResponse, type EncryptedPayloadWrapper, type EncryptionIdentityFields, type EncryptionPrivateKeyJwk, type EncryptionPublicKeyJwk, type FeedByDidResponse, type FeedPost, type FeedPublicResponse, type FetchResponse, HistoryManager, HttpTransport, LocalStore, type OpenClawIngressRuntimeStatus, PingAgentClient, type PublicAgentProfile, type PublicLinkState, type RecommendationSummary, type ReplyTarget, type ResolveCollaborationApprovalInput, type ResolveCollaborationApprovalResult, type RuntimeMode, SESSION_SUMMARY_FIELDS, type SendResponse, type SessionBindingAlert, type SessionBindingEntry, SessionManager, type SessionMessageInput, type SessionState, type SessionSummary, type SessionSummaryFieldKey, SessionSummaryManager, type SessionSummaryUpsert, 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 TransportOptions, 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, buildSessionKey, buildSessionSummaryHandoffText, buildTrustPolicyRecommendations, capabilityCardToLegacyCapabilities, clearSessionBindingAlert, decideContactPolicy, decideTaskPolicy, decryptPayloadForIdentity, defaultTrustPolicyDoc, encryptPayloadForRecipients, ensureIdentityEncryptionKeys, ensureTokenValid, formatCapabilityCardSummary, generateIdentity, getActiveSessionFilePath, getIdentityPath, getIngressRuntimeStatusFilePath, getProfile, getRootDir, getSessionBindingAlertsFilePath, getSessionMapFilePath, getStorePath, getTrustRecommendationActionLabel, identityExists, isEncryptedPayload, loadIdentity, matchesTrustPolicyRule, normalizeCapabilityCard, normalizeTrustPolicyDoc, previewFromPayload, readCurrentActiveSessionKey, readIngressRuntimeStatus, readSessionBindingAlerts, readSessionBindings, removeSessionBinding, saveIdentity, setSessionBinding, shouldEncryptConversationPayload, summarizeTrustPolicyAudit, updateStoredToken, upsertSessionBindingAlert, upsertTrustPolicyRecommendation, writeSessionBindingAlerts, writeSessionBindings };
+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, HistoryManager, HttpTransport, LocalStore, type ManagedTransportSwitchResult, type MarkOperatorSeenInput, type OpenClawIngressRuntimeStatus, 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 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, buildProjectionPreview, buildSessionKey, buildSessionSummaryHandoffText, buildTrustPolicyRecommendations, capabilityCardToLegacyCapabilities, clearSessionBindingAlert, decideContactPolicy, decideTaskPolicy, decryptPayloadForIdentity, defaultTrustPolicyDoc, deriveTransportHealth, describeProjectionPreset, encryptPayloadForRecipients, ensureIdentityEncryptionKeys, ensureTokenValid, formatCapabilityCardSummary, generateIdentity, getActiveSessionFilePath, getIdentityPath, getIngressRuntimeStatusFilePath, getProfile, getProjectedEventTypes, getProjectionDisposition, getRootDir, getSessionBindingAlertsFilePath, getSessionMapFilePath, getStorePath, getTransportPreferenceFilePath, getTrustRecommendationActionLabel, hasDecisionPromptOutbox, identityExists, isEncryptedPayload, listPendingDecisionViews, loadIdentity, matchesTrustPolicyRule, normalizeCapabilityCard, normalizeTransportMode, normalizeTrustPolicyDoc, previewFromPayload, readCurrentActiveSessionKey, readIngressRuntimeStatus, readSessionBindingAlerts, readSessionBindings, readTransportPreference, removeSessionBinding, saveIdentity, setSessionBinding, shouldEncryptConversationPayload, summarizeSinceLastSeen, summarizeTrustPolicyAudit, switchTransportPreference, updateStoredToken, upsertSessionBindingAlert, upsertTrustPolicyRecommendation, writeSessionBindingAlerts, writeSessionBindings, writeTransportPreference };

package/dist/index.js

@@ -6,6 +6,7 @@ import {
   HistoryManager,
   HttpTransport,
   LocalStore,
+  OperatorSeenStateManager,
   PingAgentClient,
   SESSION_SUMMARY_FIELDS,
   SessionManager,
@@ -16,6 +17,9 @@ import {
   TrustRecommendationManager,
   UserWakeSubscription,
   WsSubscription,
+  buildDecisionReminderOutboxMessage,
+  buildDeliveryTimeline,
+  buildProjectionPreview,
   buildSessionKey,
   buildSessionSummaryHandoffText,
   buildTrustPolicyRecommendations,
@@ -25,6 +29,8 @@ import {
   decideTaskPolicy,
   decryptPayloadForIdentity,
   defaultTrustPolicyDoc,
+  deriveTransportHealth,
+  describeProjectionPreset,
   encryptPayloadForRecipients,
   ensureIdentityEncryptionKeys,
   ensureTokenValid,
@@ -34,33 +40,43 @@ import {
   getIdentityPath,
   getIngressRuntimeStatusFilePath,
   getProfile,
+  getProjectedEventTypes,
+  getProjectionDisposition,
   getRootDir,
   getSessionBindingAlertsFilePath,
   getSessionMapFilePath,
   getStorePath,
+  getTransportPreferenceFilePath,
   getTrustRecommendationActionLabel,
+  hasDecisionPromptOutbox,
   identityExists,
   isEncryptedPayload,
+  listPendingDecisionViews,
   loadIdentity,
   matchesTrustPolicyRule,
   normalizeCapabilityCard,
+  normalizeTransportMode,
   normalizeTrustPolicyDoc,
   previewFromPayload,
   readCurrentActiveSessionKey,
   readIngressRuntimeStatus,
   readSessionBindingAlerts,
   readSessionBindings,
+  readTransportPreference,
   removeSessionBinding,
   saveIdentity,
   setSessionBinding,
   shouldEncryptConversationPayload,
+  summarizeSinceLastSeen,
   summarizeTrustPolicyAudit,
+  switchTransportPreference,
   updateStoredToken,
   upsertSessionBindingAlert,
   upsertTrustPolicyRecommendation,
   writeSessionBindingAlerts,
-  writeSessionBindings
-} from "./chunk-MFKDD5X3.js";
+  writeSessionBindings,
+  writeTransportPreference
+} from "./chunk-BCYHGKQE.js";
 export {
   A2AAdapter,
   CollaborationEventManager,
@@ -69,6 +85,7 @@ export {
   HistoryManager,
   HttpTransport,
   LocalStore,
+  OperatorSeenStateManager,
   PingAgentClient,
   SESSION_SUMMARY_FIELDS,
   SessionManager,
@@ -79,6 +96,9 @@ export {
   TrustRecommendationManager,
   UserWakeSubscription,
   WsSubscription,
+  buildDecisionReminderOutboxMessage,
+  buildDeliveryTimeline,
+  buildProjectionPreview,
   buildSessionKey,
   buildSessionSummaryHandoffText,
   buildTrustPolicyRecommendations,
@@ -88,6 +108,8 @@ export {
   decideTaskPolicy,
   decryptPayloadForIdentity,
   defaultTrustPolicyDoc,
+  deriveTransportHealth,
+  describeProjectionPreset,
   encryptPayloadForRecipients,
   ensureIdentityEncryptionKeys,
   ensureTokenValid,
@@ -97,30 +119,40 @@ export {
   getIdentityPath,
   getIngressRuntimeStatusFilePath,
   getProfile,
+  getProjectedEventTypes,
+  getProjectionDisposition,
   getRootDir,
   getSessionBindingAlertsFilePath,
   getSessionMapFilePath,
   getStorePath,
+  getTransportPreferenceFilePath,
   getTrustRecommendationActionLabel,
+  hasDecisionPromptOutbox,
   identityExists,
   isEncryptedPayload,
+  listPendingDecisionViews,
   loadIdentity,
   matchesTrustPolicyRule,
   normalizeCapabilityCard,
+  normalizeTransportMode,
   normalizeTrustPolicyDoc,
   previewFromPayload,
   readCurrentActiveSessionKey,
   readIngressRuntimeStatus,
   readSessionBindingAlerts,
   readSessionBindings,
+  readTransportPreference,
   removeSessionBinding,
   saveIdentity,
   setSessionBinding,
   shouldEncryptConversationPayload,
+  summarizeSinceLastSeen,
   summarizeTrustPolicyAudit,
+  switchTransportPreference,
   updateStoredToken,
   upsertSessionBindingAlert,
   upsertTrustPolicyRecommendation,
   writeSessionBindingAlerts,
-  writeSessionBindings
+  writeSessionBindings,
+  writeTransportPreference
 };