@pingagent/sdk 0.1.12 → 0.1.14

package/dist/index.d.ts

@@ -265,6 +265,107 @@ declare class TaskHandoffManager {
     listBySession(sessionKey: string, limit?: number): TaskHandoff[];
 }
 
+type CollaborationProjectionOutboxStatus = 'pending' | 'sent' | 'failed';
+type CollaborationProjectionKind = 'approval_resolution' | 'decision_prompt' | 'runtime_update' | 'collaboration_update';
+interface CollaborationProjectionOutboxEntry {
+    id: number;
+    created_at: number;
+    session_key?: string;
+    conversation_id?: string;
+    target_human_session?: string;
+    projection_kind: CollaborationProjectionKind;
+    summary: string;
+    body: Record<string, unknown>;
+    status: CollaborationProjectionOutboxStatus;
+    attempt_count: number;
+    last_error?: string;
+    delivered_at?: number;
+    source_event_id?: number;
+}
+interface CollaborationProjectionOutboxInput {
+    created_at?: number;
+    session_key?: string;
+    conversation_id?: string;
+    target_human_session?: string;
+    projection_kind: CollaborationProjectionKind;
+    summary: string;
+    body: Record<string, unknown>;
+    source_event_id?: number;
+}
+declare class CollaborationProjectionOutboxManager {
+    private store;
+    constructor(store: LocalStore);
+    enqueue(input: CollaborationProjectionOutboxInput): CollaborationProjectionOutboxEntry;
+    get(id: number): CollaborationProjectionOutboxEntry | null;
+    listRecent(limit?: number): CollaborationProjectionOutboxEntry[];
+    listPending(limit?: number): CollaborationProjectionOutboxEntry[];
+    listDispatchable(limit?: number): CollaborationProjectionOutboxEntry[];
+    listBySession(sessionKey: string, limit?: number): CollaborationProjectionOutboxEntry[];
+    listByStatus(status: CollaborationProjectionOutboxStatus, limit?: number): 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 CollaborationEventSeverity = 'info' | 'notice' | 'warning' | 'critical';
+type CollaborationApprovalStatus = 'not_required' | 'pending' | 'approved' | 'rejected';
+interface CollaborationEvent {
+    id: number;
+    ts_ms: number;
+    event_type: CollaborationEventType;
+    severity: CollaborationEventSeverity;
+    session_key?: string;
+    conversation_id?: string;
+    target_human_session?: string;
+    summary: string;
+    approval_required: boolean;
+    approval_status: CollaborationApprovalStatus;
+    detail?: Record<string, unknown>;
+}
+interface CollaborationEventInput {
+    ts_ms?: number;
+    event_type: CollaborationEventType;
+    severity?: CollaborationEventSeverity;
+    session_key?: string;
+    conversation_id?: string;
+    target_human_session?: string;
+    summary: string;
+    approval_required?: boolean;
+    approval_status?: CollaborationApprovalStatus;
+    detail?: Record<string, unknown>;
+}
+interface CollaborationEventSummary {
+    total_events: number;
+    latest_ts_ms?: number;
+    by_type: Record<string, number>;
+    by_severity: Record<string, number>;
+    pending_approvals: number;
+}
+interface ResolveCollaborationApprovalInput {
+    resolved_by?: string;
+    note?: string;
+    ts_ms?: number;
+}
+interface ResolveCollaborationApprovalResult {
+    updated: CollaborationEvent;
+    resolution_event: CollaborationEvent;
+    projection_outbox: CollaborationProjectionOutboxEntry | null;
+}
+declare class CollaborationEventManager {
+    private store;
+    constructor(store: LocalStore);
+    record(input: CollaborationEventInput): CollaborationEvent;
+    listRecent(limit?: number): CollaborationEvent[];
+    listBySession(sessionKey: string, limit?: number): CollaborationEvent[];
+    listByConversation(conversationId: string, limit?: number): CollaborationEvent[];
+    listByTargetHumanSession(targetHumanSession: string, limit?: number): CollaborationEvent[];
+    get(id: number): CollaborationEvent | null;
+    listPending(limit?: number): CollaborationEvent[];
+    listPendingBySession(sessionKey: string, limit?: number): CollaborationEvent[];
+    resolveApproval(id: number, approvalStatus: Extract<CollaborationApprovalStatus, 'approved' | 'rejected'>, input?: ResolveCollaborationApprovalInput): ResolveCollaborationApprovalResult | null;
+    summarize(limit?: number): CollaborationEventSummary;
+}
+
 type CapabilityContactMode = 'dm' | 'task' | 'either';
 interface CapabilityCardItem {
     id: string;
@@ -545,6 +646,7 @@ declare class PingAgentClient {
     private sessionSummaryManager?;
     private taskThreadManager?;
     private taskHandoffManager?;
+    private collaborationEventManager?;
     private agentCardCache;
     constructor(opts: ClientOptions);
     getContactManager(): ContactManager | undefined;
@@ -553,6 +655,7 @@ declare class PingAgentClient {
     getSessionSummaryManager(): SessionSummaryManager | undefined;
     getTaskThreadManager(): TaskThreadManager | undefined;
     getTaskHandoffManager(): TaskHandoffManager | undefined;
+    getCollaborationEventManager(): CollaborationEventManager | undefined;
     /** Update the in-memory access token (e.g. after proactive refresh from disk). */
     setAccessToken(token: string): void;
     register(developerToken?: string): Promise<ApiResponse>;
@@ -832,6 +935,7 @@ declare class HttpTransport {
 type ContactPolicyAction = 'approve' | 'manual' | 'reject';
 type TaskPolicyAction = 'bridge' | 'execute' | 'deny';
 type RuntimeMode = 'bridge' | 'executor';
+type CollaborationProjectionPreset = 'quiet' | 'balanced' | 'strict';
 interface TrustPolicyRule<A extends string> {
     match: string;
     action: A;
@@ -848,6 +952,9 @@ interface TrustPolicyDoc {
         default_action: TaskPolicyAction;
         rules: Array<TrustPolicyRule<TaskPolicyAction>>;
     };
+    collaboration_projection: {
+        preset: CollaborationProjectionPreset;
+    };
 }
 interface TrustPolicyContext {
     sender_did?: string;
@@ -1085,6 +1192,7 @@ interface WsSubscriptionOptions {
     getAccessToken: () => string | Promise<string>;
     myDid: string;
     listConversations: () => Promise<ConversationEntry[]>;
+    listIntervalMs?: number;
     onMessage: (envelope: any, conversationId: string) => void | Promise<void>;
     onControl?: (control: WsControlPayload, conversationId: string) => void;
     onError?: (err: Error) => void;
@@ -1137,6 +1245,7 @@ declare class WsSubscription {
     constructor(opts: WsSubscriptionOptions);
     start(): void;
     stop(): void;
+    syncNow(): Promise<void>;
     /**
      * Stop a single conversation's WebSocket and do not reconnect.
      * Used when the conversation is revoked or the client no longer wants to subscribe.
@@ -1151,6 +1260,56 @@ declare class WsSubscription {
     private syncConnections;
 }
 
+interface UserWakeEvent {
+    type: 'wake';
+    reason: 'message' | 'control';
+    conversation_id: string;
+    seq?: number;
+    action?: string;
+    task_id?: string;
+    ts_ms: number;
+}
+interface UserWakeSubscriptionOptions {
+    serverUrl: string;
+    getAccessToken: () => string | Promise<string>;
+    onWake: (event: UserWakeEvent) => void | Promise<void>;
+    onOpen?: () => void;
+    onError?: (err: Error) => void;
+    onDebug?: (info: {
+        event: string;
+        detail?: Record<string, unknown>;
+    }) => void;
+    heartbeat?: {
+        enable?: boolean;
+        idleThresholdMs?: number;
+        pingIntervalMs?: number;
+        pongTimeoutMs?: number;
+        maxMissedPongs?: number;
+        tickMs?: number;
+        jitter?: number;
+    };
+}
+declare class UserWakeSubscription {
+    private readonly opts;
+    private ws;
+    private reconnectTimer;
+    private reconnectAttempt;
+    private heartbeatTimer;
+    private stopped;
+    private lastRxAt;
+    private lastPingAt;
+    private nextPingAt;
+    private missedPongs;
+    private pongTimeout;
+    constructor(opts: UserWakeSubscriptionOptions);
+    start(): void;
+    stop(): void;
+    private wakeUrl;
+    private connectAsync;
+    private scheduleReconnect;
+    private heartbeatTick;
+}
+
 declare function getActiveSessionFilePath(): string;
 declare function getSessionMapFilePath(): string;
 declare function getSessionBindingAlertsFilePath(): string;
@@ -1204,4 +1363,4 @@ interface OpenClawIngressRuntimeStatus {
 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 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 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, 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 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 };

package/dist/index.js

@@ -1,5 +1,7 @@
 import {
   A2AAdapter,
+  CollaborationEventManager,
+  CollaborationProjectionOutboxManager,
   ContactManager,
   HistoryManager,
   HttpTransport,
@@ -12,6 +14,7 @@ import {
   TaskThreadManager,
   TrustPolicyAuditManager,
   TrustRecommendationManager,
+  UserWakeSubscription,
   WsSubscription,
   buildSessionKey,
   buildSessionSummaryHandoffText,
@@ -57,9 +60,11 @@ import {
   upsertTrustPolicyRecommendation,
   writeSessionBindingAlerts,
   writeSessionBindings
-} from "./chunk-BLHMTUID.js";
+} from "./chunk-MFKDD5X3.js";
 export {
   A2AAdapter,
+  CollaborationEventManager,
+  CollaborationProjectionOutboxManager,
   ContactManager,
   HistoryManager,
   HttpTransport,
@@ -72,6 +77,7 @@ export {
   TaskThreadManager,
   TrustPolicyAuditManager,
   TrustRecommendationManager,
+  UserWakeSubscription,
   WsSubscription,
   buildSessionKey,
   buildSessionSummaryHandoffText,