@pingagent/sdk 0.1.14 → 0.1.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -302,11 +302,12 @@ declare class CollaborationProjectionOutboxManager {
302
302
  listDispatchable(limit?: number): CollaborationProjectionOutboxEntry[];
303
303
  listBySession(sessionKey: string, limit?: number): CollaborationProjectionOutboxEntry[];
304
304
  listByStatus(status: CollaborationProjectionOutboxStatus, limit?: number): CollaborationProjectionOutboxEntry[];
305
+ findBySourceEventId(sourceEventId: number, projectionKind?: CollaborationProjectionKind): CollaborationProjectionOutboxEntry[];
305
306
  markSent(id: number, deliveredAt?: number): CollaborationProjectionOutboxEntry | null;
306
307
  markFailed(id: number, error: string): CollaborationProjectionOutboxEntry | null;
307
308
  }
308
309
 
309
- type CollaborationEventType = 'external_message_received' | 'agent_progress' | 'agent_conclusion' | 'handoff_started' | 'handoff_completed' | 'risk_detected' | 'decision_required' | 'task_completed' | 'runtime_degraded' | 'runtime_repaired';
310
+ 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';
310
311
  type CollaborationEventSeverity = 'info' | 'notice' | 'warning' | 'critical';
311
312
  type CollaborationApprovalStatus = 'not_required' | 'pending' | 'approved' | 'rejected';
312
313
  interface CollaborationEvent {
@@ -362,6 +363,7 @@ declare class CollaborationEventManager {
362
363
  get(id: number): CollaborationEvent | null;
363
364
  listPending(limit?: number): CollaborationEvent[];
364
365
  listPendingBySession(sessionKey: string, limit?: number): CollaborationEvent[];
366
+ listPendingOlderThan(cutoffTs: number, limit?: number): CollaborationEvent[];
365
367
  resolveApproval(id: number, approvalStatus: Extract<CollaborationApprovalStatus, 'approved' | 'rejected'>, input?: ResolveCollaborationApprovalInput): ResolveCollaborationApprovalResult | null;
366
368
  summarize(limit?: number): CollaborationEventSummary;
367
369
  }
@@ -1131,6 +1133,384 @@ declare class TrustRecommendationManager {
1131
1133
  summarize(): RecommendationSummary;
1132
1134
  }
1133
1135
 
1136
+ type OperatorSeenStateOperatorId = 'host_panel' | 'tui' | 'mcp';
1137
+ type OperatorSeenStateScopeType = 'global' | 'session';
1138
+ interface OperatorSeenState {
1139
+ operator_id: OperatorSeenStateOperatorId;
1140
+ scope_type: OperatorSeenStateScopeType;
1141
+ scope_key?: string | null;
1142
+ last_seen_ts: number;
1143
+ updated_at: number;
1144
+ }
1145
+ interface MarkOperatorSeenInput {
1146
+ operator_id: OperatorSeenStateOperatorId;
1147
+ scope_type: OperatorSeenStateScopeType;
1148
+ scope_key?: string | null;
1149
+ last_seen_ts?: number;
1150
+ }
1151
+ declare class OperatorSeenStateManager {
1152
+ private store;
1153
+ constructor(store: LocalStore);
1154
+ get(operatorId: OperatorSeenStateOperatorId, scopeType: OperatorSeenStateScopeType, scopeKey?: string | null): OperatorSeenState | null;
1155
+ markSeen(input: MarkOperatorSeenInput): OperatorSeenState;
1156
+ listByOperator(operatorId: OperatorSeenStateOperatorId): OperatorSeenState[];
1157
+ }
1158
+
1159
+ type HumanDeliveryBindingStatus = 'active' | 'stale';
1160
+ interface HumanDeliveryBinding {
1161
+ id: number;
1162
+ created_at: number;
1163
+ updated_at: number;
1164
+ owner_ref?: string;
1165
+ source_session_key?: string;
1166
+ source_conversation_id?: string;
1167
+ channel: string;
1168
+ to: string;
1169
+ account_id?: string;
1170
+ thread_id?: string | number;
1171
+ target_key: string;
1172
+ status: HumanDeliveryBindingStatus;
1173
+ last_inbound_at?: number;
1174
+ last_outbound_at?: number;
1175
+ detail?: Record<string, unknown>;
1176
+ }
1177
+ interface HumanDeliveryBindingInput {
1178
+ created_at?: number;
1179
+ updated_at?: number;
1180
+ owner_ref?: string;
1181
+ source_session_key?: string;
1182
+ source_conversation_id?: string;
1183
+ channel: string;
1184
+ to: string;
1185
+ account_id?: string;
1186
+ thread_id?: string | number;
1187
+ target_key: string;
1188
+ status?: HumanDeliveryBindingStatus;
1189
+ last_inbound_at?: number;
1190
+ last_outbound_at?: number;
1191
+ detail?: Record<string, unknown>;
1192
+ }
1193
+ declare class HumanDeliveryBindingManager {
1194
+ private store;
1195
+ constructor(store: LocalStore);
1196
+ private findExisting;
1197
+ findMatching(input: Pick<HumanDeliveryBindingInput, 'target_key' | 'source_session_key' | 'source_conversation_id'>): HumanDeliveryBinding | null;
1198
+ upsert(input: HumanDeliveryBindingInput): HumanDeliveryBinding;
1199
+ get(id: number): HumanDeliveryBinding | null;
1200
+ listRecent(limit?: number): HumanDeliveryBinding[];
1201
+ listBySession(sessionKey: string, limit?: number): HumanDeliveryBinding[];
1202
+ listByConversation(conversationId: string, limit?: number): HumanDeliveryBinding[];
1203
+ listByOwner(ownerRef: string, limit?: number): HumanDeliveryBinding[];
1204
+ markOutbound(id: number, ts?: number): HumanDeliveryBinding | null;
1205
+ markActive(id: number, ts?: number): HumanDeliveryBinding | null;
1206
+ markStale(id: number, ts?: number): HumanDeliveryBinding | null;
1207
+ }
1208
+
1209
+ type NotificationIntentType = 'decision_required' | 'approval_result' | 'task_completed' | 'risk_alert' | 'handoff' | 'runtime_alert' | 'collaboration_update';
1210
+ type NotificationIntentStatus = 'pending' | 'bound' | 'sent' | 'acknowledged' | 'failed' | 'unresolved' | 'canceled';
1211
+ type NotificationIntentBindingScope = 'same_conversation' | 'same_session' | 'owner_last_active';
1212
+ interface NotificationIntent {
1213
+ id: number;
1214
+ created_at: number;
1215
+ updated_at: number;
1216
+ session_key?: string;
1217
+ conversation_id?: string;
1218
+ owner_ref?: string;
1219
+ source_event_id?: number;
1220
+ source_projection_outbox_id?: number;
1221
+ intent_type: NotificationIntentType;
1222
+ title: string;
1223
+ summary: string;
1224
+ deep_link?: string;
1225
+ body: Record<string, unknown>;
1226
+ preferred_binding_scope: NotificationIntentBindingScope;
1227
+ status: NotificationIntentStatus;
1228
+ attempt_count: number;
1229
+ last_error?: string;
1230
+ delivered_at?: number;
1231
+ resolved_binding_id?: number;
1232
+ acknowledged_at?: number;
1233
+ acknowledged_by_binding_id?: number;
1234
+ acknowledged_by_message_ref?: string;
1235
+ }
1236
+ interface NotificationIntentInput {
1237
+ created_at?: number;
1238
+ updated_at?: number;
1239
+ session_key?: string;
1240
+ conversation_id?: string;
1241
+ owner_ref?: string;
1242
+ source_event_id?: number;
1243
+ source_projection_outbox_id?: number;
1244
+ intent_type: NotificationIntentType;
1245
+ title: string;
1246
+ summary: string;
1247
+ deep_link?: string;
1248
+ body?: Record<string, unknown>;
1249
+ preferred_binding_scope?: NotificationIntentBindingScope;
1250
+ status?: NotificationIntentStatus;
1251
+ attempt_count?: number;
1252
+ last_error?: string;
1253
+ delivered_at?: number;
1254
+ resolved_binding_id?: number;
1255
+ acknowledged_at?: number;
1256
+ acknowledged_by_binding_id?: number;
1257
+ acknowledged_by_message_ref?: string;
1258
+ }
1259
+ declare class NotificationIntentManager {
1260
+ private store;
1261
+ constructor(store: LocalStore);
1262
+ enqueue(input: NotificationIntentInput): NotificationIntent;
1263
+ get(id: number): NotificationIntent | null;
1264
+ findBySourceProjectionOutboxId(sourceProjectionOutboxId: number): NotificationIntent | null;
1265
+ listRecent(limit?: number): NotificationIntent[];
1266
+ listPending(limit?: number): NotificationIntent[];
1267
+ listUnacknowledgedSent(limit?: number): NotificationIntent[];
1268
+ listBySession(sessionKey: string, limit?: number): NotificationIntent[];
1269
+ listByStatus(status: NotificationIntentStatus, limit?: number): NotificationIntent[];
1270
+ markBound(id: number, bindingId: number, ts?: number): NotificationIntent | null;
1271
+ markSent(id: number, bindingId?: number | null, ts?: number): NotificationIntent | null;
1272
+ markPending(id: number, options?: {
1273
+ clear_binding?: boolean;
1274
+ clear_ack?: boolean;
1275
+ clear_error?: boolean;
1276
+ }, ts?: number): NotificationIntent | null;
1277
+ markFailed(id: number, error: string, bindingId?: number | null, ts?: number): NotificationIntent | null;
1278
+ markUnresolved(id: number, error?: string, ts?: number): NotificationIntent | null;
1279
+ markCanceled(id: number, error?: string, ts?: number): NotificationIntent | null;
1280
+ markAcknowledged(id: number, input?: {
1281
+ binding_id?: number | null;
1282
+ message_ref?: string | null;
1283
+ ts?: number;
1284
+ }): NotificationIntent | null;
1285
+ acknowledgeLatestSentForBinding(input: {
1286
+ binding_id?: number | null;
1287
+ conversation_id?: string | null;
1288
+ session_key?: string | null;
1289
+ message_ref?: string | null;
1290
+ ts?: number;
1291
+ }): NotificationIntent | null;
1292
+ }
1293
+
1294
+ type ProjectionDisposition = 'project' | 'detail_only' | 'decision_gate';
1295
+ interface ProjectionDispositionInput {
1296
+ preset: CollaborationProjectionPreset;
1297
+ event_type?: CollaborationEventType | null;
1298
+ has_pending_decision?: boolean;
1299
+ projection_mode?: 'update' | 'decision' | 'runtime';
1300
+ }
1301
+ interface ProjectionDispositionResult {
1302
+ disposition: ProjectionDisposition;
1303
+ reason: string;
1304
+ }
1305
+ declare function getProjectedEventTypes(preset: CollaborationProjectionPreset): CollaborationEventType[];
1306
+ declare function describeProjectionPreset(preset: CollaborationProjectionPreset): {
1307
+ immediate_event_types: CollaborationEventType[];
1308
+ detail_only_event_types: CollaborationEventType[];
1309
+ };
1310
+ declare function getProjectionDisposition(input: ProjectionDispositionInput): ProjectionDispositionResult;
1311
+
1312
+ interface SinceLastSeenSummary {
1313
+ operator_id: OperatorSeenStateOperatorId;
1314
+ scope_type: OperatorSeenStateScopeType;
1315
+ scope_key?: string | null;
1316
+ last_seen_ts?: number;
1317
+ new_external_messages: number;
1318
+ new_conclusions: number;
1319
+ new_handoffs: number;
1320
+ new_decisions: number;
1321
+ new_failures: number;
1322
+ new_repairs: number;
1323
+ new_projection_failures: number;
1324
+ latest_ts?: number;
1325
+ }
1326
+ interface DeliveryTimelineEntry {
1327
+ ts_ms: number;
1328
+ kind: string;
1329
+ summary: string;
1330
+ session_key?: string | null;
1331
+ conversation_id?: string | null;
1332
+ status?: string | null;
1333
+ detail?: Record<string, unknown> | null;
1334
+ }
1335
+ interface ProjectionPreviewEntry {
1336
+ event_id: number;
1337
+ ts_ms: number;
1338
+ event_type: CollaborationEventType;
1339
+ summary: string;
1340
+ disposition: ProjectionDisposition;
1341
+ reason: string;
1342
+ }
1343
+ interface CollaborationDecisionView extends CollaborationEvent {
1344
+ overdue: boolean;
1345
+ overdue_by_ms?: number;
1346
+ }
1347
+ declare function listPendingDecisionViews(store: LocalStore, limit?: number, overdueThresholdMs?: number): CollaborationDecisionView[];
1348
+ declare function summarizeSinceLastSeen(store: LocalStore, input: {
1349
+ operator_id: OperatorSeenStateOperatorId;
1350
+ scope_type: OperatorSeenStateScopeType;
1351
+ scope_key?: string | null;
1352
+ }): SinceLastSeenSummary;
1353
+ declare function buildDeliveryTimeline(store: LocalStore, sessionKey: string, limit?: number): DeliveryTimelineEntry[];
1354
+ declare function buildProjectionPreview(store: LocalStore, sessionKey: string, preset: CollaborationProjectionPreset, limit?: number): {
1355
+ preset: CollaborationProjectionPreset;
1356
+ rules: ReturnType<typeof describeProjectionPreset>;
1357
+ recent: ProjectionPreviewEntry[];
1358
+ };
1359
+ declare function buildDecisionReminderOutboxMessage(event: CollaborationEvent): string;
1360
+ declare function hasDecisionPromptOutbox(outboxManager: CollaborationProjectionOutboxManager, sourceEventId: number): boolean;
1361
+
1362
+ declare const HUMAN_DELIVERY_CHANNELS: readonly ["feishu", "discord", "telegram", "slack", "whatsapp"];
1363
+ type HumanDeliveryChannel = typeof HUMAN_DELIVERY_CHANNELS[number];
1364
+ interface HumanDeliveryChannelCapability {
1365
+ channel: string;
1366
+ configured: boolean;
1367
+ supports_explicit_send: boolean;
1368
+ supports_thread_id: boolean;
1369
+ supports_account_id: boolean;
1370
+ supports_plain_text_send: boolean;
1371
+ supports_dry_run: boolean;
1372
+ last_canary_at?: string | null;
1373
+ last_canary_ok?: boolean | null;
1374
+ last_canary_error?: string | null;
1375
+ }
1376
+ interface HumanDeliverySummary {
1377
+ mode: 'projection_outbox' | 'bound_channel_reply';
1378
+ total_bindings: number;
1379
+ active_bindings: number;
1380
+ stale_bindings: number;
1381
+ pending_intents: number;
1382
+ unresolved_intents: number;
1383
+ failed_intents: number;
1384
+ acknowledged_intents: number;
1385
+ supported_channels: string[];
1386
+ unsupported_channels: string[];
1387
+ last_canary_at?: string | null;
1388
+ last_canary_ok?: boolean | null;
1389
+ last_canary_error?: string | null;
1390
+ channel_capabilities: HumanDeliveryChannelCapability[];
1391
+ recent_bindings: HumanDeliveryBinding[];
1392
+ recent_notification_intents: NotificationIntent[];
1393
+ }
1394
+ interface ResolveHumanDeliveryBindingInput {
1395
+ conversation_id?: string | null;
1396
+ session_key?: string | null;
1397
+ owner_ref?: string | null;
1398
+ preferred_binding_scope?: NotificationIntentBindingScope | null;
1399
+ }
1400
+ interface ResolveHumanDeliveryBindingResult {
1401
+ binding: HumanDeliveryBinding | null;
1402
+ resolution_scope?: NotificationIntentBindingScope;
1403
+ }
1404
+ interface NotificationOverride {
1405
+ notify?: boolean;
1406
+ intent_type?: NotificationIntentType;
1407
+ title?: string;
1408
+ summary?: string;
1409
+ deep_link?: string;
1410
+ }
1411
+ declare function resolveHumanDeliveryBinding(store: LocalStore, input: ResolveHumanDeliveryBindingInput): ResolveHumanDeliveryBindingResult;
1412
+ declare function buildHumanDeliveryPayload(intent: NotificationIntent): string;
1413
+ declare function summarizeHumanDelivery(store: LocalStore, limit?: number): HumanDeliverySummary;
1414
+ declare function parseNotificationOverride(text: string | null | undefined): NotificationOverride | null;
1415
+ declare function buildNotificationIntentInputFromProjectionOutbox(store: LocalStore, projectionOutboxId: number, override?: NotificationOverride | null): NotificationIntentInput | null;
1416
+ declare function listRecentBindingsForSession(store: LocalStore, sessionKey: string, conversationId?: string | null, limit?: number): HumanDeliveryBinding[];
1417
+
1418
+ type OpenClawTransportMode = 'bridge' | 'channel';
1419
+ interface TransportPreferenceState {
1420
+ preferred_mode: OpenClawTransportMode;
1421
+ updated_at: string;
1422
+ updated_by: string;
1423
+ last_auto_switch_at?: string | null;
1424
+ last_auto_switch_reason?: string | null;
1425
+ }
1426
+ interface ManagedTransportSwitchResult {
1427
+ preferred_mode: OpenClawTransportMode;
1428
+ preference_path: string;
1429
+ updated_at: string;
1430
+ updated_by: string;
1431
+ last_auto_switch_at?: string | null;
1432
+ last_auto_switch_reason?: string | null;
1433
+ restarted: boolean;
1434
+ restart_required: boolean;
1435
+ restart_method?: string | null;
1436
+ restart_error?: string | null;
1437
+ }
1438
+ declare function normalizeTransportMode(value: unknown, fallback?: OpenClawTransportMode): OpenClawTransportMode;
1439
+ declare function getTransportPreferenceFilePath(): string;
1440
+ declare function readTransportPreference(filePath?: string): TransportPreferenceState | null;
1441
+ declare function writeTransportPreference(input: {
1442
+ preferred_mode: OpenClawTransportMode;
1443
+ updated_by: string;
1444
+ last_auto_switch_at?: string | null;
1445
+ last_auto_switch_reason?: string | null;
1446
+ }, filePath?: string): TransportPreferenceState;
1447
+ declare function switchTransportPreference(preferredMode: OpenClawTransportMode, opts: {
1448
+ updated_by: string;
1449
+ auto_switch_reason?: string | null;
1450
+ attempt_restart?: boolean;
1451
+ filePath?: string;
1452
+ }): ManagedTransportSwitchResult;
1453
+
1454
+ interface OpenClawIngressRuntimeStatus {
1455
+ receive_mode: 'webhook' | 'polling_degraded';
1456
+ human_delivery_mode?: 'projection_outbox' | 'bound_channel_reply' | null;
1457
+ reason?: string | null;
1458
+ hooks_url?: string | null;
1459
+ hooks_base_url?: string | null;
1460
+ hooks_last_error?: string | null;
1461
+ hooks_last_error_at?: string | null;
1462
+ hooks_last_probe_ok_at?: string | null;
1463
+ hooks_message_mode?: string | null;
1464
+ fallback_last_injected_at?: string | null;
1465
+ fallback_last_injected_conversation_id?: string | null;
1466
+ active_work_session?: string | null;
1467
+ sessions_send_available?: boolean;
1468
+ hooks_fix_hint?: string | null;
1469
+ gateway_base_url?: string | null;
1470
+ transport_mode?: OpenClawTransportMode;
1471
+ preferred_transport_mode?: OpenClawTransportMode;
1472
+ transport_switch_recommended?: boolean;
1473
+ transport_switch_reason?: string | null;
1474
+ channel_retry_queue_length?: number;
1475
+ channel_last_inbound_at?: string | null;
1476
+ channel_last_outbound_at?: string | null;
1477
+ channel_last_degraded_at?: string | null;
1478
+ channel_last_repaired_at?: string | null;
1479
+ channel_last_error?: string | null;
1480
+ channel_consecutive_failures?: number;
1481
+ human_delivery_supported_channels?: string[];
1482
+ human_delivery_unsupported_channels?: string[];
1483
+ human_delivery_last_canary_at?: string | null;
1484
+ human_delivery_last_canary_ok?: boolean | null;
1485
+ human_delivery_last_canary_error?: string | null;
1486
+ human_delivery_channel_capabilities?: Record<string, Partial<HumanDeliveryChannelCapability>> | null;
1487
+ status_updated_at?: string | null;
1488
+ }
1489
+ declare function getIngressRuntimeStatusFilePath(): string;
1490
+ declare function readIngressRuntimeStatus(filePath?: string): OpenClawIngressRuntimeStatus | null;
1491
+
1492
+ type TransportHealthState = 'Ready' | 'Degraded' | 'Switching Recommended';
1493
+ interface TransportHealth {
1494
+ transport_mode: OpenClawTransportMode;
1495
+ preferred_transport_mode: OpenClawTransportMode;
1496
+ state: TransportHealthState;
1497
+ transport_switch_recommended: boolean;
1498
+ transport_switch_reason?: string | null;
1499
+ retry_queue_length: number;
1500
+ last_inbound_at?: string | null;
1501
+ last_outbound_at?: string | null;
1502
+ last_degraded_at?: string | null;
1503
+ last_repaired_at?: string | null;
1504
+ last_error?: string | null;
1505
+ consecutive_failures: number;
1506
+ receive_mode?: string | null;
1507
+ }
1508
+ declare function deriveTransportHealth(input: {
1509
+ runtime_status?: OpenClawIngressRuntimeStatus | null;
1510
+ recent_events?: CollaborationEvent[];
1511
+ projection_outbox_failed?: CollaborationProjectionOutboxEntry[];
1512
+ }): TransportHealth;
1513
+
1134
1514
  /**
1135
1515
  * A2A adapter for PingAgentClient.
1136
1516
  * Allows PingAgent to call external agents that speak the A2A protocol,
@@ -1346,21 +1726,39 @@ declare function clearSessionBindingAlert(conversationId: string, filePath?: str
1346
1726
  removed: boolean;
1347
1727
  };
1348
1728
 
1349
- interface OpenClawIngressRuntimeStatus {
1350
- receive_mode: 'webhook' | 'polling_degraded';
1351
- reason?: string | null;
1352
- hooks_url?: string | null;
1353
- hooks_last_error?: string | null;
1354
- hooks_last_error_at?: string | null;
1355
- hooks_last_probe_ok_at?: string | null;
1356
- fallback_last_injected_at?: string | null;
1357
- fallback_last_injected_conversation_id?: string | null;
1358
- active_work_session?: string | null;
1359
- sessions_send_available?: boolean;
1360
- hooks_fix_hint?: string | null;
1361
- status_updated_at?: string | null;
1729
+ interface OpenClawDeliveryContext {
1730
+ channel?: string;
1731
+ to?: string;
1732
+ account_id?: string;
1733
+ thread_id?: string | number;
1362
1734
  }
1363
- declare function getIngressRuntimeStatusFilePath(): string;
1364
- declare function readIngressRuntimeStatus(filePath?: string): OpenClawIngressRuntimeStatus | null;
1735
+ interface OpenClawSessionEntryRecord {
1736
+ session_key: string;
1737
+ updated_at?: number;
1738
+ origin?: Record<string, unknown> | null;
1739
+ channel?: string | null;
1740
+ delivery_context?: OpenClawDeliveryContext;
1741
+ last_channel?: string | null;
1742
+ last_to?: string | null;
1743
+ last_account_id?: string | null;
1744
+ last_thread_id?: string | number | null;
1745
+ raw: Record<string, unknown>;
1746
+ }
1747
+ interface OpenClawHumanDeliveryBindingCandidate {
1748
+ owner_ref?: string;
1749
+ channel: string;
1750
+ to: string;
1751
+ account_id?: string;
1752
+ thread_id?: string | number;
1753
+ target_key: string;
1754
+ last_inbound_at?: number;
1755
+ raw_session_key: string;
1756
+ }
1757
+ declare function getOpenClawConfigFilePath(): string;
1758
+ declare function getOpenClawSessionStorePath(agentId?: string): string;
1759
+ declare function listOpenClawSessionEntries(filePath?: string): OpenClawSessionEntryRecord[];
1760
+ declare function getOpenClawSessionEntry(sessionKey: string, filePath?: string): OpenClawSessionEntryRecord | null;
1761
+ declare function deriveOwnerRefFromOpenClawSessionEntry(entry: OpenClawSessionEntryRecord): string | undefined;
1762
+ declare function buildHumanDeliveryBindingCandidate(sessionKey: string, filePath?: string): OpenClawHumanDeliveryBindingCandidate | null;
1365
1763
 
1366
- 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 };
1764
+ 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 };
package/dist/index.js CHANGED
@@ -3,9 +3,13 @@ import {
3
3
  CollaborationEventManager,
4
4
  CollaborationProjectionOutboxManager,
5
5
  ContactManager,
6
+ HUMAN_DELIVERY_CHANNELS,
6
7
  HistoryManager,
7
8
  HttpTransport,
9
+ HumanDeliveryBindingManager,
8
10
  LocalStore,
11
+ NotificationIntentManager,
12
+ OperatorSeenStateManager,
9
13
  PingAgentClient,
10
14
  SESSION_SUMMARY_FIELDS,
11
15
  SessionManager,
@@ -16,6 +20,12 @@ import {
16
20
  TrustRecommendationManager,
17
21
  UserWakeSubscription,
18
22
  WsSubscription,
23
+ buildDecisionReminderOutboxMessage,
24
+ buildDeliveryTimeline,
25
+ buildHumanDeliveryBindingCandidate,
26
+ buildHumanDeliveryPayload,
27
+ buildNotificationIntentInputFromProjectionOutbox,
28
+ buildProjectionPreview,
19
29
  buildSessionKey,
20
30
  buildSessionSummaryHandoffText,
21
31
  buildTrustPolicyRecommendations,
@@ -25,6 +35,9 @@ import {
25
35
  decideTaskPolicy,
26
36
  decryptPayloadForIdentity,
27
37
  defaultTrustPolicyDoc,
38
+ deriveOwnerRefFromOpenClawSessionEntry,
39
+ deriveTransportHealth,
40
+ describeProjectionPreset,
28
41
  encryptPayloadForRecipients,
29
42
  ensureIdentityEncryptionKeys,
30
43
  ensureTokenValid,
@@ -33,42 +46,64 @@ import {
33
46
  getActiveSessionFilePath,
34
47
  getIdentityPath,
35
48
  getIngressRuntimeStatusFilePath,
49
+ getOpenClawConfigFilePath,
50
+ getOpenClawSessionEntry,
51
+ getOpenClawSessionStorePath,
36
52
  getProfile,
53
+ getProjectedEventTypes,
54
+ getProjectionDisposition,
37
55
  getRootDir,
38
56
  getSessionBindingAlertsFilePath,
39
57
  getSessionMapFilePath,
40
58
  getStorePath,
59
+ getTransportPreferenceFilePath,
41
60
  getTrustRecommendationActionLabel,
61
+ hasDecisionPromptOutbox,
42
62
  identityExists,
43
63
  isEncryptedPayload,
64
+ listOpenClawSessionEntries,
65
+ listPendingDecisionViews,
66
+ listRecentBindingsForSession,
44
67
  loadIdentity,
45
68
  matchesTrustPolicyRule,
46
69
  normalizeCapabilityCard,
70
+ normalizeTransportMode,
47
71
  normalizeTrustPolicyDoc,
72
+ parseNotificationOverride,
48
73
  previewFromPayload,
49
74
  readCurrentActiveSessionKey,
50
75
  readIngressRuntimeStatus,
51
76
  readSessionBindingAlerts,
52
77
  readSessionBindings,
78
+ readTransportPreference,
53
79
  removeSessionBinding,
80
+ resolveHumanDeliveryBinding,
54
81
  saveIdentity,
55
82
  setSessionBinding,
56
83
  shouldEncryptConversationPayload,
84
+ summarizeHumanDelivery,
85
+ summarizeSinceLastSeen,
57
86
  summarizeTrustPolicyAudit,
87
+ switchTransportPreference,
58
88
  updateStoredToken,
59
89
  upsertSessionBindingAlert,
60
90
  upsertTrustPolicyRecommendation,
61
91
  writeSessionBindingAlerts,
62
- writeSessionBindings
63
- } from "./chunk-MFKDD5X3.js";
92
+ writeSessionBindings,
93
+ writeTransportPreference
94
+ } from "./chunk-GU5W4KRD.js";
64
95
  export {
65
96
  A2AAdapter,
66
97
  CollaborationEventManager,
67
98
  CollaborationProjectionOutboxManager,
68
99
  ContactManager,
100
+ HUMAN_DELIVERY_CHANNELS,
69
101
  HistoryManager,
70
102
  HttpTransport,
103
+ HumanDeliveryBindingManager,
71
104
  LocalStore,
105
+ NotificationIntentManager,
106
+ OperatorSeenStateManager,
72
107
  PingAgentClient,
73
108
  SESSION_SUMMARY_FIELDS,
74
109
  SessionManager,
@@ -79,6 +114,12 @@ export {
79
114
  TrustRecommendationManager,
80
115
  UserWakeSubscription,
81
116
  WsSubscription,
117
+ buildDecisionReminderOutboxMessage,
118
+ buildDeliveryTimeline,
119
+ buildHumanDeliveryBindingCandidate,
120
+ buildHumanDeliveryPayload,
121
+ buildNotificationIntentInputFromProjectionOutbox,
122
+ buildProjectionPreview,
82
123
  buildSessionKey,
83
124
  buildSessionSummaryHandoffText,
84
125
  buildTrustPolicyRecommendations,
@@ -88,6 +129,9 @@ export {
88
129
  decideTaskPolicy,
89
130
  decryptPayloadForIdentity,
90
131
  defaultTrustPolicyDoc,
132
+ deriveOwnerRefFromOpenClawSessionEntry,
133
+ deriveTransportHealth,
134
+ describeProjectionPreset,
91
135
  encryptPayloadForRecipients,
92
136
  ensureIdentityEncryptionKeys,
93
137
  ensureTokenValid,
@@ -96,31 +140,49 @@ export {
96
140
  getActiveSessionFilePath,
97
141
  getIdentityPath,
98
142
  getIngressRuntimeStatusFilePath,
143
+ getOpenClawConfigFilePath,
144
+ getOpenClawSessionEntry,
145
+ getOpenClawSessionStorePath,
99
146
  getProfile,
147
+ getProjectedEventTypes,
148
+ getProjectionDisposition,
100
149
  getRootDir,
101
150
  getSessionBindingAlertsFilePath,
102
151
  getSessionMapFilePath,
103
152
  getStorePath,
153
+ getTransportPreferenceFilePath,
104
154
  getTrustRecommendationActionLabel,
155
+ hasDecisionPromptOutbox,
105
156
  identityExists,
106
157
  isEncryptedPayload,
158
+ listOpenClawSessionEntries,
159
+ listPendingDecisionViews,
160
+ listRecentBindingsForSession,
107
161
  loadIdentity,
108
162
  matchesTrustPolicyRule,
109
163
  normalizeCapabilityCard,
164
+ normalizeTransportMode,
110
165
  normalizeTrustPolicyDoc,
166
+ parseNotificationOverride,
111
167
  previewFromPayload,
112
168
  readCurrentActiveSessionKey,
113
169
  readIngressRuntimeStatus,
114
170
  readSessionBindingAlerts,
115
171
  readSessionBindings,
172
+ readTransportPreference,
116
173
  removeSessionBinding,
174
+ resolveHumanDeliveryBinding,
117
175
  saveIdentity,
118
176
  setSessionBinding,
119
177
  shouldEncryptConversationPayload,
178
+ summarizeHumanDelivery,
179
+ summarizeSinceLastSeen,
120
180
  summarizeTrustPolicyAudit,
181
+ switchTransportPreference,
121
182
  updateStoredToken,
122
183
  upsertSessionBindingAlert,
123
184
  upsertTrustPolicyRecommendation,
124
185
  writeSessionBindingAlerts,
125
- writeSessionBindings
186
+ writeSessionBindings,
187
+ writeTransportPreference
126
188
  };