@pingagent/sdk 0.1.9 → 0.1.11

package/dist/index.d.ts

@@ -160,6 +160,40 @@ declare class SessionManager {
     resolveReplyTarget(sessionKey?: string): ReplyTarget | null;
 }
 
+interface SessionSummary {
+    session_key: string;
+    objective?: string;
+    context?: string;
+    constraints?: string;
+    decisions?: string;
+    open_questions?: string;
+    next_action?: string;
+    handoff_ready_text?: string;
+    updated_at: number;
+}
+interface SessionSummaryUpsert {
+    session_key: string;
+    objective?: string | null;
+    context?: string | null;
+    constraints?: string | null;
+    decisions?: string | null;
+    open_questions?: string | null;
+    next_action?: string | null;
+    handoff_ready_text?: string | null;
+    updated_at?: number;
+}
+type SessionSummaryFieldKey = 'objective' | 'context' | 'constraints' | 'decisions' | 'open_questions' | 'next_action' | 'handoff_ready_text';
+declare const SESSION_SUMMARY_FIELDS: SessionSummaryFieldKey[];
+declare function buildSessionSummaryHandoffText(summary?: SessionSummary | null): string;
+declare class SessionSummaryManager {
+    private store;
+    constructor(store: LocalStore);
+    upsert(input: SessionSummaryUpsert): SessionSummary;
+    get(sessionKey: string): SessionSummary | null;
+    listRecent(limit?: number): SessionSummary[];
+    clearFields(sessionKey: string, fields: SessionSummaryFieldKey[], updatedAt?: number): SessionSummary;
+}
+
 type TaskThreadStatus = 'queued' | 'running' | 'processed' | 'failed' | 'cancelled';
 interface TaskThread {
     task_id: string;
@@ -195,6 +229,64 @@ declare class TaskThreadManager {
     listRecent(limit?: number): TaskThread[];
 }
 
+interface TaskHandoff {
+    task_id: string;
+    session_key: string;
+    conversation_id: string;
+    objective?: string;
+    carry_forward_summary?: string;
+    success_criteria?: string;
+    callback_session_key?: string;
+    priority?: string;
+    delegated_by?: string;
+    delegated_to?: string;
+    updated_at: number;
+}
+interface TaskHandoffPayload {
+    objective?: string;
+    carry_forward_summary?: string;
+    success_criteria?: string;
+    callback_session_key?: string;
+    priority?: string;
+    delegated_by?: string;
+    delegated_to?: string;
+}
+interface TaskHandoffUpsert extends TaskHandoffPayload {
+    task_id: string;
+    session_key: string;
+    conversation_id: string;
+    updated_at?: number;
+}
+declare class TaskHandoffManager {
+    private store;
+    constructor(store: LocalStore);
+    upsert(input: TaskHandoffUpsert): TaskHandoff;
+    get(taskId: string): TaskHandoff | null;
+    listBySession(sessionKey: string, limit?: number): TaskHandoff[];
+}
+
+type CapabilityContactMode = 'dm' | 'task' | 'either';
+interface CapabilityCardItem {
+    id: string;
+    label?: string;
+    description?: string;
+    accepts_tasks?: boolean;
+    accepts_messages?: boolean;
+    input_modes?: string[];
+    output_modes?: string[];
+    examples?: string[];
+}
+interface CapabilityCard {
+    version: string;
+    summary?: string;
+    accepts_new_work?: boolean;
+    preferred_contact_mode?: CapabilityContactMode;
+    capabilities: CapabilityCardItem[];
+}
+declare function normalizeCapabilityCard(value: unknown): CapabilityCard | undefined;
+declare function capabilityCardToLegacyCapabilities(card?: CapabilityCard | null): string[];
+declare function formatCapabilityCardSummary(card?: CapabilityCard | null): string;
+
 interface EncryptionPublicKeyJwk {
     kty: 'EC';
     crv: 'P-256';
@@ -331,9 +423,13 @@ interface ConversationListResponse {
 interface AgentProfile {
     did: string;
     alias?: string;
+    public_slug?: string | null;
+    public_share_enabled?: boolean;
+    public_updated_at?: number | null;
     display_name?: string;
     bio?: string;
     capabilities?: string[];
+    capability_card?: CapabilityCard | null;
     tags?: string[];
     verification_status?: string;
     discoverable?: boolean;
@@ -369,6 +465,9 @@ interface AgentDirectoryCard {
 interface DirectorySelfResponse {
     did: string;
     alias?: string | null;
+    public_slug?: string | null;
+    public_share_enabled?: boolean;
+    public_updated_at?: number | null;
     verification_status?: string;
     encryption_public_key?: EncryptionPublicKeyJwk | null;
     mode?: string;
@@ -376,6 +475,66 @@ interface DirectorySelfResponse {
     billing_primary_did?: string | null;
     is_billing_primary?: boolean;
 }
+interface PublicAgentProfile extends AgentProfile {
+    public_slug?: string | null;
+    public_share_enabled?: boolean;
+    public_updated_at?: number | null;
+    canonical_slug?: string | null;
+    public_url?: string | null;
+    noindex?: boolean;
+    accepts_new_contacts?: boolean;
+    quick_connect?: {
+        openclaw: string;
+        cli: string;
+        web_dm_url: string;
+    };
+    route_slug?: string | null;
+    source?: 'public_slug' | 'alias' | 'demo';
+}
+interface UpdateProfileInput {
+    display_name?: string;
+    bio?: string;
+    capabilities?: string[] | string;
+    capability_card?: CapabilityCard | null;
+    tags?: string[] | string;
+    discoverable?: boolean;
+}
+interface PublicLinkState {
+    did: string;
+    alias?: string | null;
+    public_slug?: string | null;
+    public_share_enabled?: boolean;
+    public_updated_at?: number | null;
+    discoverable?: boolean;
+    canonical_slug?: string | null;
+    public_url?: string | null;
+}
+interface ContactCardShare {
+    id: string;
+    target_did: string;
+    referrer_did?: string | null;
+    intro_note?: string;
+    message_template?: string;
+    created_by_did: string;
+    created_at: number;
+    revoked_at?: number | null;
+    share_url?: string;
+    target?: PublicAgentProfile;
+}
+interface TaskShareEntry {
+    id: string;
+    owner_did: string;
+    task_id?: string | null;
+    title?: string | null;
+    status: string;
+    generated_summary: string;
+    redacted_metadata?: Record<string, unknown> | null;
+    created_at: number;
+    revoked_at?: number | null;
+    share_url?: string;
+    owner?: PublicAgentProfile;
+    noindex?: boolean;
+}
 declare class PingAgentClient {
     private opts;
     private transport;
@@ -383,13 +542,17 @@ declare class PingAgentClient {
     private contactManager?;
     private historyManager?;
     private sessionManager?;
+    private sessionSummaryManager?;
     private taskThreadManager?;
+    private taskHandoffManager?;
     private agentCardCache;
     constructor(opts: ClientOptions);
     getContactManager(): ContactManager | undefined;
     getHistoryManager(): HistoryManager | undefined;
     getSessionManager(): SessionManager | undefined;
+    getSessionSummaryManager(): SessionSummaryManager | undefined;
     getTaskThreadManager(): TaskThreadManager | undefined;
+    getTaskHandoffManager(): TaskHandoffManager | undefined;
     /** Update the in-memory access token (e.g. after proactive refresh from disk). */
     setAccessToken(token: string): void;
     register(developerToken?: string): Promise<ApiResponse>;
@@ -411,6 +574,7 @@ declare class PingAgentClient {
         description?: string;
         input?: any;
         timeout_ms?: number;
+        handoff?: TaskHandoffPayload;
     }): Promise<ApiResponse<SendResponse>>;
     sendContactRequest(conversationId: string, message?: string): Promise<ApiResponse<SendResponse>>;
     fetchInbox(conversationId: string, opts?: {
@@ -458,13 +622,33 @@ declare class PingAgentClient {
     }>>;
     getProfile(): Promise<ApiResponse<AgentProfile>>;
     getDirectorySelf(): Promise<ApiResponse<DirectorySelfResponse>>;
-    updateProfile(profile: {
-        display_name?: string;
-        bio?: string;
-        capabilities?: string[];
-        tags?: string[];
-        discoverable?: boolean;
-    }): Promise<ApiResponse<AgentProfile>>;
+    updateProfile(profile: UpdateProfileInput): Promise<ApiResponse<AgentProfile>>;
+    createPublicLink(opts?: {
+        slug?: string;
+        enabled?: boolean;
+    }): Promise<ApiResponse<PublicLinkState>>;
+    getPublicSelf(): Promise<ApiResponse<PublicLinkState>>;
+    getPublicAgent(slug: string): Promise<ApiResponse<PublicAgentProfile>>;
+    createContactCard(opts?: {
+        target_did?: string;
+        referrer_did?: string;
+        intro_note?: string;
+        message_template?: string;
+    }): Promise<ApiResponse<ContactCardShare>>;
+    getContactCard(id: string): Promise<ApiResponse<ContactCardShare>>;
+    createTaskShare(opts: {
+        task_id?: string;
+        title?: string;
+        status?: string;
+        summary: string;
+        conversation_id?: string;
+        redacted_metadata?: Record<string, unknown>;
+    }): Promise<ApiResponse<TaskShareEntry>>;
+    getTaskShare(id: string): Promise<ApiResponse<TaskShareEntry>>;
+    revokeTaskShare(id: string): Promise<ApiResponse<{
+        id: string;
+        revoked_at: number;
+    }>>;
     ensureEncryptionKeyPublished(): Promise<ApiResponse<{
         published: boolean;
         status: 'already_registered' | 'updated';
@@ -566,6 +750,25 @@ declare class PingAgentClient {
         timeoutMs?: number;
         pollIntervalMs?: number;
     }): Promise<TaskResult>;
+    sendHandoff(targetDid: string, handoff: {
+        title: string;
+        description?: string;
+        input?: any;
+        objective?: string;
+        carry_forward_summary?: string;
+        success_criteria?: string;
+        callback_session_key?: string;
+        priority?: string;
+    }, opts?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+        sessionKey?: string;
+        conversationId?: string;
+    }): Promise<ApiResponse<{
+        task_id: string;
+        conversation_id: string;
+        handoff: TaskHandoffPayload;
+    }>>;
 }
 
 declare function ensureIdentityEncryptionKeys(identity: Partial<EncryptionIdentityFields>): EncryptionIdentityFields;
@@ -803,6 +1006,7 @@ interface RecommendationSummary {
     total: number;
     by_status: Record<string, number>;
 }
+declare function getTrustRecommendationActionLabel(recommendation: Pick<StoredTrustRecommendation, 'policy' | 'action' | 'status'>): string;
 declare class TrustRecommendationManager {
     private store;
     constructor(store: RecommendationStore);
@@ -947,4 +1151,57 @@ 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;
+};
+
+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 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 };

package/dist/index.js

@@ -5,13 +5,19 @@ import {
   HttpTransport,
   LocalStore,
   PingAgentClient,
+  SESSION_SUMMARY_FIELDS,
   SessionManager,
+  SessionSummaryManager,
+  TaskHandoffManager,
   TaskThreadManager,
   TrustPolicyAuditManager,
   TrustRecommendationManager,
   WsSubscription,
   buildSessionKey,
+  buildSessionSummaryHandoffText,
   buildTrustPolicyRecommendations,
+  capabilityCardToLegacyCapabilities,
+  clearSessionBindingAlert,
   decideContactPolicy,
   decideTaskPolicy,
   decryptPayloadForIdentity,
@@ -19,23 +25,39 @@ import {
   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,
-  upsertTrustPolicyRecommendation
-} from "./chunk-PFABO4C7.js";
+  upsertSessionBindingAlert,
+  upsertTrustPolicyRecommendation,
+  writeSessionBindingAlerts,
+  writeSessionBindings
+} from "./chunk-BLHMTUID.js";
 export {
   A2AAdapter,
   ContactManager,
@@ -43,13 +65,19 @@ export {
   HttpTransport,
   LocalStore,
   PingAgentClient,
+  SESSION_SUMMARY_FIELDS,
   SessionManager,
+  SessionSummaryManager,
+  TaskHandoffManager,
   TaskThreadManager,
   TrustPolicyAuditManager,
   TrustRecommendationManager,
   WsSubscription,
   buildSessionKey,
+  buildSessionSummaryHandoffText,
   buildTrustPolicyRecommendations,
+  capabilityCardToLegacyCapabilities,
+  clearSessionBindingAlert,
   decideContactPolicy,
   decideTaskPolicy,
   decryptPayloadForIdentity,
@@ -57,20 +85,36 @@ export {
   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,
-  upsertTrustPolicyRecommendation
+  upsertSessionBindingAlert,
+  upsertTrustPolicyRecommendation,
+  writeSessionBindingAlerts,
+  writeSessionBindings
 };