@pingagent/sdk 0.1.17 → 0.1.19

package/dist/index.d.ts

@@ -1157,6 +1157,7 @@ declare class OperatorSeenStateManager {
 }
 
 type HumanDeliveryBindingStatus = 'active' | 'stale';
+type ExternalTargetBindingStatus = HumanDeliveryBindingStatus;
 interface HumanDeliveryBinding {
     id: number;
     created_at: number;
@@ -1174,6 +1175,7 @@ interface HumanDeliveryBinding {
     last_outbound_at?: number;
     detail?: Record<string, unknown>;
 }
+type ExternalTargetBinding = HumanDeliveryBinding;
 interface HumanDeliveryBindingInput {
     created_at?: number;
     updated_at?: number;
@@ -1190,6 +1192,7 @@ interface HumanDeliveryBindingInput {
     last_outbound_at?: number;
     detail?: Record<string, unknown>;
 }
+type ExternalTargetBindingInput = HumanDeliveryBindingInput;
 declare class HumanDeliveryBindingManager {
     private store;
     constructor(store: LocalStore);
@@ -1207,8 +1210,11 @@ declare class HumanDeliveryBindingManager {
 }
 
 type NotificationIntentType = 'decision_required' | 'approval_result' | 'task_completed' | 'risk_alert' | 'handoff' | 'runtime_alert' | 'collaboration_update';
+type ActionCallbackIntentType = NotificationIntentType;
 type NotificationIntentStatus = 'pending' | 'bound' | 'sent' | 'acknowledged' | 'failed' | 'unresolved' | 'canceled';
+type ActionCallbackIntentStatus = NotificationIntentStatus;
 type NotificationIntentBindingScope = 'same_conversation' | 'same_session' | 'owner_last_active';
+type ActionCallbackIntentBindingScope = NotificationIntentBindingScope;
 interface NotificationIntent {
     id: number;
     created_at: number;
@@ -1218,6 +1224,7 @@ interface NotificationIntent {
     owner_ref?: string;
     source_event_id?: number;
     source_projection_outbox_id?: number;
+    source_external_escalation_id?: number;
     intent_type: NotificationIntentType;
     title: string;
     summary: string;
@@ -1233,6 +1240,7 @@ interface NotificationIntent {
     acknowledged_by_binding_id?: number;
     acknowledged_by_message_ref?: string;
 }
+type ActionCallbackIntent = NotificationIntent;
 interface NotificationIntentInput {
     created_at?: number;
     updated_at?: number;
@@ -1241,6 +1249,7 @@ interface NotificationIntentInput {
     owner_ref?: string;
     source_event_id?: number;
     source_projection_outbox_id?: number;
+    source_external_escalation_id?: number;
     intent_type: NotificationIntentType;
     title: string;
     summary: string;
@@ -1256,12 +1265,14 @@ interface NotificationIntentInput {
     acknowledged_by_binding_id?: number;
     acknowledged_by_message_ref?: string;
 }
+type ActionCallbackIntentInput = NotificationIntentInput;
 declare class NotificationIntentManager {
     private store;
     constructor(store: LocalStore);
     enqueue(input: NotificationIntentInput): NotificationIntent;
     get(id: number): NotificationIntent | null;
     findBySourceProjectionOutboxId(sourceProjectionOutboxId: number): NotificationIntent | null;
+    findBySourceExternalEscalationId(sourceExternalEscalationId: number): NotificationIntent | null;
     listRecent(limit?: number): NotificationIntent[];
     listPending(limit?: number): NotificationIntent[];
     listUnacknowledgedSent(limit?: number): NotificationIntent[];
@@ -1282,6 +1293,7 @@ declare class NotificationIntentManager {
         message_ref?: string | null;
         ts?: number;
     }): NotificationIntent | null;
+    linkExternalEscalation(id: number, externalEscalationId: number, ts?: number): NotificationIntent | null;
     acknowledgeLatestSentForBinding(input: {
         binding_id?: number | null;
         conversation_id?: string | null;
@@ -1291,6 +1303,52 @@ declare class NotificationIntentManager {
     }): NotificationIntent | null;
 }
 
+type RuntimeRunStatus = 'active' | 'completed' | 'blocked' | 'failed' | 'canceled';
+interface RuntimeRun {
+    id: number;
+    adapter: string;
+    run_id: string;
+    workflow_id: string;
+    session_key: string;
+    conversation_id?: string;
+    source_agent?: string;
+    source_model?: string;
+    status: RuntimeRunStatus;
+    created_at: number;
+    updated_at: number;
+    last_resume_at?: number;
+    detail?: Record<string, unknown>;
+}
+interface RuntimeRunInput {
+    adapter: string;
+    run_id?: string;
+    workflow_id?: string;
+    session_key: string;
+    conversation_id?: string;
+    source_agent?: string;
+    source_model?: string;
+    status?: RuntimeRunStatus;
+    created_at?: number;
+    updated_at?: number;
+    last_resume_at?: number;
+    source_ref?: string;
+    detail?: Record<string, unknown>;
+}
+declare function synthesizeOpenClawRunId(input: Pick<RuntimeRunInput, 'session_key' | 'source_ref'>): string;
+declare function synthesizeOpenClawWorkflowId(input: Pick<RuntimeRunInput, 'conversation_id' | 'session_key'>): string;
+declare class RuntimeRunManager {
+    private store;
+    constructor(store: LocalStore);
+    private getRowByRun;
+    private resolveRunFields;
+    upsert(input: RuntimeRunInput): RuntimeRun;
+    get(id: number): RuntimeRun | null;
+    findByRun(adapter: string, runId: string): RuntimeRun | null;
+    listRecent(limit?: number): RuntimeRun[];
+    markStatus(id: number, status: RuntimeRunStatus, ts?: number): RuntimeRun | null;
+    markResumed(id: number, ts?: number): RuntimeRun | null;
+}
+
 type ProjectionDisposition = 'project' | 'detail_only' | 'decision_gate';
 interface ProjectionDispositionInput {
     preset: CollaborationProjectionPreset;
@@ -1359,6 +1417,299 @@ declare function buildProjectionPreview(store: LocalStore, sessionKey: string, p
 declare function buildDecisionReminderOutboxMessage(event: CollaborationEvent): string;
 declare function hasDecisionPromptOutbox(outboxManager: CollaborationProjectionOutboxManager, sourceEventId: number): boolean;
 
+type ActionMessageType = 'inform' | 'escalate' | 'approval_request' | 'callback_result' | 'delegate' | 'handoff' | 'interrupt' | 'status_update';
+type ActionResponseState = 'pending' | 'delivered' | 'seen' | 'acknowledged' | 'approved' | 'rejected' | 'delegated' | 'expired' | 'completed' | 'failed' | 'unresolved';
+type ActionRiskLevel = 'low' | 'moderate' | 'high' | 'critical';
+type ActionSensitivity = 'routine' | 'internal' | 'sensitive' | 'restricted';
+type ActionTargetClass = 'human_operator' | 'human_approver' | 'agent_runtime' | 'agent_delegate' | 'callback_endpoint' | 'mixed';
+interface ActionArtifact {
+    label: string;
+    ref?: string;
+    url?: string;
+    kind?: string;
+}
+interface ActionPolicyScope {
+    kind?: string;
+    grants?: string[];
+    constraints?: string[];
+    designated_target?: string;
+    expires_at?: number;
+    capability_token_id?: string;
+    requires_designated_approver?: boolean;
+}
+interface ActionContract {
+    run_id?: string;
+    workflow_id?: string;
+    source_agent?: string;
+    source_runtime?: string;
+    source_model?: string;
+    message_type: ActionMessageType;
+    response_state?: ActionResponseState;
+    risk_level: ActionRiskLevel;
+    required_action: string;
+    task_summary: string;
+    deadline?: number;
+    sensitivity: ActionSensitivity;
+    target_class: ActionTargetClass;
+    callback_target?: string;
+    artifacts: ActionArtifact[];
+    expected_callback?: string;
+    policy_scope?: ActionPolicyScope;
+    consequence?: string;
+}
+interface BuildActionContractInput {
+    intent_type?: NotificationIntentType | null;
+    source_event_type?: CollaborationEventType | null;
+    projection_kind?: CollaborationProjectionKind | null;
+    severity?: CollaborationEventSeverity | null;
+    summary?: string | null;
+    deep_link?: string | null;
+    body?: Record<string, unknown> | null;
+}
+declare function buildActionContract(input: BuildActionContractInput): ActionContract;
+declare function buildActionContractForDecisionView(event: CollaborationDecisionView): ActionContract;
+declare function buildActionContractForNotificationIntent(intent: NotificationIntent): ActionContract;
+declare function actionRiskRank(level: ActionRiskLevel): number;
+declare function actionDeadlineStatus(contract: Pick<ActionContract, 'deadline'>, now?: number): 'none' | 'timed_out' | 'upcoming';
+
+type ExternalEscalationStatus = 'pending' | 'dispatched' | 'waiting_callback' | 'blocked' | 'failed' | 'completed' | 'canceled' | 'expired';
+interface ExternalEscalationDetail {
+    action_contract: ActionContract;
+    metadata?: Record<string, unknown>;
+    source_event_id?: number;
+    source_intent_id?: number;
+    callback_target?: string;
+}
+interface ExternalEscalation {
+    id: number;
+    adapter: string;
+    run_id: string;
+    workflow_id: string;
+    session_key: string;
+    conversation_id?: string;
+    source_event_id?: number;
+    source_intent_id?: number;
+    message_type: ActionMessageType;
+    risk_level: ActionRiskLevel;
+    required_action: string;
+    callback_target?: string;
+    target_class: ActionTargetClass;
+    status: ExternalEscalationStatus;
+    deadline?: number;
+    token_required: boolean;
+    linked_notification_intent_id?: number;
+    created_at: number;
+    updated_at: number;
+    detail: ExternalEscalationDetail;
+}
+interface ExternalEscalationInput {
+    adapter: string;
+    run_id: string;
+    workflow_id: string;
+    session_key: string;
+    conversation_id?: string;
+    source_event_id?: number;
+    source_intent_id?: number;
+    callback_target?: string;
+    linked_notification_intent_id?: number;
+    status?: ExternalEscalationStatus;
+    deadline?: number;
+    token_required?: boolean;
+    created_at?: number;
+    updated_at?: number;
+    action_contract: ActionContract;
+    metadata?: Record<string, unknown>;
+}
+declare class ExternalEscalationManager {
+    private store;
+    constructor(store: LocalStore);
+    enqueue(input: ExternalEscalationInput): ExternalEscalation;
+    get(id: number): ExternalEscalation | null;
+    findByLinkedNotificationIntentId(intentId: number): ExternalEscalation | null;
+    findByRun(adapter: string, runId: string, workflowId?: string): ExternalEscalation | null;
+    listRecent(limit?: number): ExternalEscalation[];
+    listByStatus(status: ExternalEscalationStatus, limit?: number): ExternalEscalation[];
+    listPendingWork(limit?: number): ExternalEscalation[];
+    private updateStatus;
+    markDispatched(id: number, linkedIntentId?: number | null, ts?: number): ExternalEscalation | null;
+    markWaitingCallback(id: number, linkedIntentId?: number | null, ts?: number): ExternalEscalation | null;
+    markBlocked(id: number, error?: string, ts?: number): ExternalEscalation | null;
+    markFailed(id: number, error?: string, ts?: number): ExternalEscalation | null;
+    markCompleted(id: number, ts?: number): ExternalEscalation | null;
+    markCanceled(id: number, reason?: string, ts?: number): ExternalEscalation | null;
+    markExpired(id: number, ts?: number): ExternalEscalation | null;
+    linkNotificationIntent(id: number, intentId: number, ts?: number): ExternalEscalation | null;
+    markPending(id: number, ts?: number): ExternalEscalation | null;
+    updateDetail(id: number, detail: ExternalEscalationDetail, ts?: number): ExternalEscalation | null;
+}
+
+type CallbackResumeDeliveryStatus = 'pending' | 'delivered' | 'failed';
+interface StoredCallbackResume {
+    id: number;
+    adapter: string;
+    external_escalation_id: number;
+    run_id: string;
+    workflow_id: string;
+    response_state: ActionResponseState;
+    callback_target?: string;
+    message_ref?: string;
+    binding_id?: number;
+    accepted: boolean;
+    rejection_reason?: string;
+    resume_delivery_status: CallbackResumeDeliveryStatus;
+    received_at: number;
+    delivered_at?: number;
+    detail?: Record<string, unknown>;
+}
+interface StoredCallbackResumeInput {
+    adapter: string;
+    external_escalation_id: number;
+    run_id: string;
+    workflow_id: string;
+    response_state: ActionResponseState;
+    callback_target?: string;
+    message_ref?: string;
+    binding_id?: number;
+    accepted: boolean;
+    rejection_reason?: string;
+    resume_delivery_status?: CallbackResumeDeliveryStatus;
+    received_at?: number;
+    delivered_at?: number;
+    detail?: Record<string, unknown>;
+}
+declare class CallbackResumeManager {
+    private store;
+    constructor(store: LocalStore);
+    record(input: StoredCallbackResumeInput): StoredCallbackResume;
+    get(id: number): StoredCallbackResume | null;
+    findDuplicate(externalEscalationId: number, messageRef?: string | null): StoredCallbackResume | null;
+    listRecent(limit?: number): StoredCallbackResume[];
+    listByEscalation(externalEscalationId: number, limit?: number): StoredCallbackResume[];
+    markDelivered(id: number, ts?: number): StoredCallbackResume | null;
+    markFailed(id: number, error?: string, ts?: number): StoredCallbackResume | null;
+}
+
+type CapabilityTokenStatus = 'active' | 'used' | 'revoked' | 'expired';
+interface CapabilityToken {
+    token_id: string;
+    token_hash: string;
+    external_escalation_id: number;
+    run_id: string;
+    workflow_id: string;
+    target_ref?: string;
+    grants: string[];
+    constraints: string[];
+    expires_at: number;
+    status: CapabilityTokenStatus;
+    issued_at: number;
+    used_at?: number;
+    revoked_at?: number;
+}
+interface CapabilityTokenIssueInput {
+    external_escalation_id: number;
+    run_id: string;
+    workflow_id: string;
+    target_ref?: string;
+    grants?: string[];
+    constraints?: string[];
+    expires_at: number;
+}
+interface CapabilityTokenConsumeInput {
+    token: string;
+    external_escalation_id?: number;
+    run_id?: string;
+    workflow_id?: string;
+    now?: number;
+}
+declare class CapabilityTokenManager {
+    private store;
+    constructor(store: LocalStore);
+    get(tokenId: string): CapabilityToken | null;
+    issue(input: CapabilityTokenIssueInput): {
+        token: string;
+        record: CapabilityToken;
+    };
+    listRecent(limit?: number): CapabilityToken[];
+    consume(input: CapabilityTokenConsumeInput): {
+        accepted: boolean;
+        record?: CapabilityToken;
+        reason?: string;
+    };
+    revoke(tokenId: string, ts?: number): CapabilityToken | null;
+    expireStale(now?: number): number;
+}
+
+interface OpenClawHookClientOptions {
+    hooks_base_url?: string;
+    hooks_path?: string;
+    hooks_token?: string;
+    agent_id?: string;
+    timeout_seconds?: number;
+}
+interface OpenClawHookSendInput {
+    sessionKey: string;
+    message: string;
+    timeoutSeconds?: number;
+    agentId?: string;
+}
+interface OpenClawHookHealth {
+    ok: boolean;
+    hooks_base_url?: string;
+    hooks_path?: string;
+    token_source: 'env' | 'config' | 'missing';
+    config_path: string;
+    error?: string;
+}
+declare class OpenClawHooksClient {
+    readonly config_path: string;
+    readonly hooks_base_url: string;
+    readonly hooks_path: string;
+    readonly hooks_token: string;
+    readonly token_source: 'env' | 'config' | 'missing';
+    readonly agent_id: string;
+    readonly timeout_seconds: number;
+    constructor(options?: OpenClawHookClientOptions);
+    healthcheck(): OpenClawHookHealth;
+    private postToPath;
+    sendToSession(input: OpenClawHookSendInput): Promise<void>;
+}
+
+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;
+
 declare const HUMAN_DELIVERY_CHANNELS: readonly ["feishu", "discord", "telegram", "slack", "whatsapp"];
 type HumanDeliveryChannel = typeof HUMAN_DELIVERY_CHANNELS[number];
 interface HumanDeliveryChannelCapability {
@@ -1415,42 +1766,6 @@ declare function parseNotificationOverride(text: string | null | undefined): Not
 declare function buildNotificationIntentInputFromProjectionOutbox(store: LocalStore, projectionOutboxId: number, override?: NotificationOverride | null): NotificationIntentInput | null;
 declare function listRecentBindingsForSession(store: LocalStore, sessionKey: string, conversationId?: string | null, limit?: number): HumanDeliveryBinding[];
 
-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';
     human_delivery_mode?: 'projection_outbox' | 'bound_channel_reply' | null;
@@ -1489,6 +1804,88 @@ interface OpenClawIngressRuntimeStatus {
 declare function getIngressRuntimeStatusFilePath(): string;
 declare function readIngressRuntimeStatus(filePath?: string): OpenClawIngressRuntimeStatus | null;
 
+interface OpenClawExecutionAdapterHealth {
+    ok: boolean;
+    runtime_status?: OpenClawIngressRuntimeStatus | null;
+    hooks: ReturnType<OpenClawHooksClient['healthcheck']>;
+    error?: string;
+}
+interface EnqueueOpenClawEscalationInput {
+    run_id?: string;
+    workflow_id?: string;
+    session_key: string;
+    conversation_id?: string;
+    source_event_id?: number;
+    source_intent_id?: number;
+    action_contract: ActionContract;
+    callback_target?: string;
+    metadata?: Record<string, unknown>;
+}
+interface ResumeOpenClawCallbackInput {
+    external_escalation_id?: number;
+    run_id?: string;
+    workflow_id?: string;
+    response_state: ActionResponseState;
+    response_payload?: Record<string, unknown>;
+    message_ref?: string;
+    callback_target?: string;
+    capability_token?: string;
+    binding_id?: number;
+    trusted_local?: boolean;
+}
+interface OpenClawAdapterOverview {
+    health: OpenClawExecutionAdapterHealth;
+    recent_runtime_runs: RuntimeRun[];
+    recent_escalations: ExternalEscalation[];
+    recent_callback_resumes: StoredCallbackResume[];
+    token_required_pending: number;
+    blocked_count: number;
+    failed_count: number;
+    expired_count: number;
+}
+declare class OpenClawExecutionAdapter {
+    private store;
+    private runtimeRuns;
+    private escalations;
+    private callbackResumes;
+    private capabilityTokens;
+    private intents;
+    private hooksClient;
+    constructor(store: LocalStore);
+    enqueueEscalation(input: EnqueueOpenClawEscalationInput): {
+        runtime_run: RuntimeRun;
+        escalation: ExternalEscalation;
+        notification_intent: NotificationIntent;
+        token_required: boolean;
+        capability_token?: {
+            token_id: string;
+            token: string;
+        };
+    };
+    dispatchEscalation(escalationId: number): {
+        escalation: ExternalEscalation;
+        intent?: NotificationIntent | null;
+        resolved_binding_id?: number;
+    };
+    ensureEscalationForIntent(intent: NotificationIntent): ExternalEscalation | null;
+    resumeCallback(input: ResumeOpenClawCallbackInput): Promise<{
+        accepted: boolean;
+        escalation: ExternalEscalation;
+        callback_resume: StoredCallbackResume;
+        delivered: boolean;
+        reason?: string;
+    }>;
+    healthcheck(): OpenClawExecutionAdapterHealth;
+    buildOverview(limit?: number): OpenClawAdapterOverview;
+    syncFromNotificationIntent(intent: NotificationIntent): ExternalEscalation | null;
+    cancelEscalation(escalationId: number, reason?: string): ExternalEscalation | null;
+    retryEscalation(escalationId: number): {
+        escalation: ExternalEscalation;
+        intent?: NotificationIntent | null;
+    };
+    private mapActionContractToIntentType;
+}
+
 type TransportHealthState = 'Ready' | 'Degraded' | 'Switching Recommended';
 interface TransportHealth {
     transport_mode: OpenClawTransportMode;
@@ -1511,6 +1908,137 @@ declare function deriveTransportHealth(input: {
     projection_outbox_failed?: CollaborationProjectionOutboxEntry[];
 }): TransportHealth;
 
+type OpenClawAgentLifecycleState = 'activating' | 'ready_waiting_inbound' | 'active_session' | 'decision_pending' | 'human_delivery_pending' | 'human_delivery_acknowledged' | 'degraded' | 'blocked';
+interface OpenClawAgentState {
+    state: OpenClawAgentLifecycleState;
+    summary: string;
+    reason?: string | null;
+    next_action: string;
+    active_session_key?: string | null;
+    pending_decisions: number;
+    human_delivery_pending: number;
+    human_delivery_unresolved: number;
+    human_delivery_failed: number;
+    human_delivery_acknowledged: number;
+    blocked: boolean;
+    degraded: boolean;
+}
+interface DeriveOpenClawAgentStateInput {
+    runtime_status?: OpenClawIngressRuntimeStatus | null;
+    sessions?: Array<Pick<SessionState, 'session_key' | 'active' | 'unread_count'>>;
+    pending_decisions?: number;
+    human_delivery?: Pick<HumanDeliverySummary, 'pending_intents' | 'unresolved_intents' | 'failed_intents' | 'acknowledged_intents'> | null;
+    transport_health?: Pick<TransportHealth, 'state' | 'last_error'> | null;
+    blocked_reason?: string | null;
+}
+declare function describeOpenClawAgentState(state: OpenClawAgentLifecycleState): string;
+declare function nextActionForOpenClawAgentState(state: OpenClawAgentLifecycleState): string;
+declare function deriveOpenClawAgentState(input: DeriveOpenClawAgentStateInput): OpenClawAgentState;
+
+type ActionInboxStatus = 'pending_approval' | 'pending_callback' | 'pending_escalation' | 'blocked' | 'degraded' | 'timed_out';
+type ActionInboxSource = 'decision' | 'notification_intent' | 'external_escalation' | 'runtime';
+interface ActionInboxItem {
+    key: string;
+    source: ActionInboxSource;
+    status: ActionInboxStatus;
+    risk_level: ActionRiskLevel;
+    title: string;
+    summary: string;
+    required_action: string;
+    consequence?: string;
+    deadline?: number;
+    overdue: boolean;
+    session_key?: string;
+    conversation_id?: string;
+    owner_ref?: string;
+    event_id?: number;
+    intent_id?: number;
+    escalation_id?: number;
+    source_ref?: string;
+    action_contract: ActionContract;
+}
+interface ActionInboxSummary {
+    total: number;
+    pending_approval: number;
+    pending_callback: number;
+    pending_escalation: number;
+    blocked: number;
+    degraded: number;
+    timed_out: number;
+    high_risk: number;
+    critical_risk: number;
+    by_status: Record<ActionInboxStatus, number>;
+    by_risk: Record<ActionRiskLevel, number>;
+    items: ActionInboxItem[];
+}
+interface BuildActionInboxSummaryInput {
+    pending_decisions?: CollaborationDecisionView[];
+    notification_intents?: NotificationIntent[];
+    external_escalations?: ExternalEscalation[];
+    agent_state?: OpenClawAgentState | null;
+    include_runtime?: boolean;
+    limit?: number;
+}
+declare function buildActionInboxSummary(input?: BuildActionInboxSummaryInput): ActionInboxSummary;
+
+type RuntimeAdapterKind = 'openclaw' | 'managed_agents' | 'claude_code' | 'agent_sdk' | 'custom';
+type RuntimeAdapterStatus = 'available' | 'planned';
+interface RuntimeAdapterCapabilities {
+    external_escalation: boolean;
+    callback_resume: boolean;
+    designated_routing: boolean;
+    action_contracts: boolean;
+    operator_callback_loop: boolean;
+}
+interface RuntimeAdapterDescriptor {
+    id: RuntimeAdapterKind | string;
+    label: string;
+    status: RuntimeAdapterStatus;
+    managed: boolean;
+    description: string;
+    capabilities: RuntimeAdapterCapabilities;
+}
+interface ExternalEscalationRequest {
+    adapter: RuntimeAdapterKind | string;
+    run_id?: string;
+    workflow_id?: string;
+    action_contract: ActionContract;
+    callback_target?: string;
+    callback_expires_at?: number;
+    designated_targets?: string[];
+    metadata?: Record<string, unknown>;
+}
+interface CallbackResumeRequest {
+    adapter: RuntimeAdapterKind | string;
+    run_id?: string;
+    workflow_id?: string;
+    response_state: ActionResponseState;
+    action_contract?: ActionContract;
+    callback_target?: string;
+    response_payload?: Record<string, unknown>;
+    message_ref?: string;
+    responded_at?: number;
+    approver_ref?: string;
+}
+interface CallbackResumeResult {
+    accepted: boolean;
+    adapter: RuntimeAdapterKind | string;
+    run_id?: string;
+    workflow_id?: string;
+    response_state: ActionResponseState;
+    reason?: string;
+    resume_key?: string;
+}
+interface RuntimeAdapter {
+    descriptor: RuntimeAdapterDescriptor;
+    buildExternalEscalationRequest(input: Omit<ExternalEscalationRequest, 'adapter'>): ExternalEscalationRequest;
+    buildCallbackResumeRequest(input: Omit<CallbackResumeRequest, 'adapter'>): CallbackResumeRequest;
+}
+declare function listRuntimeAdapterDescriptors(): RuntimeAdapterDescriptor[];
+declare function getRuntimeAdapterDescriptor(id: RuntimeAdapterKind | string): RuntimeAdapterDescriptor | undefined;
+declare function buildExternalEscalationRequest(input: ExternalEscalationRequest): ExternalEscalationRequest;
+declare function buildCallbackResumeRequest(input: CallbackResumeRequest): CallbackResumeRequest;
+
 /**
  * A2A adapter for PingAgentClient.
  * Allows PingAgent to call external agents that speak the A2A protocol,
@@ -1726,33 +2254,6 @@ declare function clearSessionBindingAlert(conversationId: string, filePath?: str
     removed: boolean;
 };
 
-type OpenClawAgentLifecycleState = 'activating' | 'ready_waiting_inbound' | 'active_session' | 'decision_pending' | 'human_delivery_pending' | 'human_delivery_acknowledged' | 'degraded' | 'blocked';
-interface OpenClawAgentState {
-    state: OpenClawAgentLifecycleState;
-    summary: string;
-    reason?: string | null;
-    next_action: string;
-    active_session_key?: string | null;
-    pending_decisions: number;
-    human_delivery_pending: number;
-    human_delivery_unresolved: number;
-    human_delivery_failed: number;
-    human_delivery_acknowledged: number;
-    blocked: boolean;
-    degraded: boolean;
-}
-interface DeriveOpenClawAgentStateInput {
-    runtime_status?: OpenClawIngressRuntimeStatus | null;
-    sessions?: Array<Pick<SessionState, 'session_key' | 'active' | 'unread_count'>>;
-    pending_decisions?: number;
-    human_delivery?: Pick<HumanDeliverySummary, 'pending_intents' | 'unresolved_intents' | 'failed_intents' | 'acknowledged_intents'> | null;
-    transport_health?: Pick<TransportHealth, 'state' | 'last_error'> | null;
-    blocked_reason?: string | null;
-}
-declare function describeOpenClawAgentState(state: OpenClawAgentLifecycleState): string;
-declare function nextActionForOpenClawAgentState(state: OpenClawAgentLifecycleState): string;
-declare function deriveOpenClawAgentState(input: DeriveOpenClawAgentStateInput): OpenClawAgentState;
-
 interface OpenClawDeliveryContext {
     channel?: string;
     to?: string;
@@ -1788,4 +2289,4 @@ declare function getOpenClawSessionEntry(sessionKey: string, filePath?: string):
 declare function deriveOwnerRefFromOpenClawSessionEntry(entry: OpenClawSessionEntryRecord): string | undefined;
 declare function buildHumanDeliveryBindingCandidate(sessionKey: string, filePath?: string): OpenClawHumanDeliveryBindingCandidate | null;
 
-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 DeriveOpenClawAgentStateInput, 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 OpenClawAgentLifecycleState, type OpenClawAgentState, 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, deriveOpenClawAgentState, deriveOwnerRefFromOpenClawSessionEntry, deriveTransportHealth, describeOpenClawAgentState, 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, nextActionForOpenClawAgentState, 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 };
+export { A2AAdapter, type A2AAdapterOptions, type A2ATaskResult, type ActionArtifact, type ActionCallbackIntent, type ActionCallbackIntentBindingScope, type ActionCallbackIntentInput, NotificationIntentManager as ActionCallbackIntentManager, type ActionCallbackIntentStatus, type ActionCallbackIntentType, type ActionContract, type ActionInboxItem, type ActionInboxSource, type ActionInboxStatus, type ActionInboxSummary, type ActionMessageType, type ActionPolicyScope, type ActionResponseState, type ActionRiskLevel, type ActionSensitivity, type ActionTargetClass, type AgentEncryptionCard, type AgentProfile, type BuildActionContractInput, type BuildActionInboxSummaryInput, type CallbackResumeDeliveryStatus, CallbackResumeManager, type CallbackResumeRequest, type CallbackResumeResult, type CapabilityCard, type CapabilityCardItem, type CapabilityContactMode, type CapabilityToken, type CapabilityTokenConsumeInput, type CapabilityTokenIssueInput, CapabilityTokenManager, type CapabilityTokenStatus, 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 DeriveOpenClawAgentStateInput, type DirectoryBrowseResponse, type DirectorySelfResponse, type EncryptedPayloadWrapper, type EncryptionIdentityFields, type EncryptionPrivateKeyJwk, type EncryptionPublicKeyJwk, type EnqueueOpenClawEscalationInput, type ExternalEscalation, type ExternalEscalationDetail, type ExternalEscalationInput, ExternalEscalationManager, type ExternalEscalationRequest, type ExternalEscalationStatus, type ExternalTargetBinding, type ExternalTargetBindingInput, HumanDeliveryBindingManager as ExternalTargetBindingManager, type ExternalTargetBindingStatus, 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 OpenClawAdapterOverview, type OpenClawAgentLifecycleState, type OpenClawAgentState, type OpenClawDeliveryContext, OpenClawExecutionAdapter, type OpenClawExecutionAdapterHealth, type OpenClawHookClientOptions, type OpenClawHookHealth, type OpenClawHookSendInput, OpenClawHooksClient, 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 ResumeOpenClawCallbackInput, type RuntimeAdapter, type RuntimeAdapterCapabilities, type RuntimeAdapterDescriptor, type RuntimeAdapterKind, type RuntimeAdapterStatus, type RuntimeMode, type RuntimeRun, type RuntimeRunInput, RuntimeRunManager, type RuntimeRunStatus, SESSION_SUMMARY_FIELDS, type SendResponse, type SessionBindingAlert, type SessionBindingEntry, SessionManager, type SessionMessageInput, type SessionState, type SessionSummary, type SessionSummaryFieldKey, SessionSummaryManager, type SessionSummaryUpsert, type SinceLastSeenSummary, type StoredCallbackResume, type StoredCallbackResumeInput, 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, actionDeadlineStatus, actionRiskRank, buildActionContract, buildActionContractForDecisionView, buildActionContractForNotificationIntent, buildActionInboxSummary, buildCallbackResumeRequest, buildDecisionReminderOutboxMessage, buildDeliveryTimeline, buildExternalEscalationRequest, buildHumanDeliveryBindingCandidate, buildHumanDeliveryPayload, buildNotificationIntentInputFromProjectionOutbox, buildProjectionPreview, buildSessionKey, buildSessionSummaryHandoffText, buildTrustPolicyRecommendations, capabilityCardToLegacyCapabilities, clearSessionBindingAlert, decideContactPolicy, decideTaskPolicy, decryptPayloadForIdentity, defaultTrustPolicyDoc, deriveOpenClawAgentState, deriveOwnerRefFromOpenClawSessionEntry, deriveTransportHealth, describeOpenClawAgentState, describeProjectionPreset, encryptPayloadForRecipients, ensureIdentityEncryptionKeys, ensureTokenValid, formatCapabilityCardSummary, generateIdentity, getActiveSessionFilePath, getIdentityPath, getIngressRuntimeStatusFilePath, getOpenClawConfigFilePath, getOpenClawSessionEntry, getOpenClawSessionStorePath, getProfile, getProjectedEventTypes, getProjectionDisposition, getRootDir, getRuntimeAdapterDescriptor, getSessionBindingAlertsFilePath, getSessionMapFilePath, getStorePath, getTransportPreferenceFilePath, getTrustRecommendationActionLabel, hasDecisionPromptOutbox, identityExists, isEncryptedPayload, listOpenClawSessionEntries, listPendingDecisionViews, listRecentBindingsForSession, listRuntimeAdapterDescriptors, loadIdentity, matchesTrustPolicyRule, nextActionForOpenClawAgentState, normalizeCapabilityCard, normalizeTransportMode, normalizeTrustPolicyDoc, parseNotificationOverride, previewFromPayload, readCurrentActiveSessionKey, readIngressRuntimeStatus, readSessionBindingAlerts, readSessionBindings, readTransportPreference, removeSessionBinding, resolveHumanDeliveryBinding, saveIdentity, setSessionBinding, shouldEncryptConversationPayload, summarizeHumanDelivery, summarizeSinceLastSeen, summarizeTrustPolicyAudit, switchTransportPreference, synthesizeOpenClawRunId, synthesizeOpenClawWorkflowId, updateStoredToken, upsertSessionBindingAlert, upsertTrustPolicyRecommendation, writeSessionBindingAlerts, writeSessionBindings, writeTransportPreference };