export type RuntimeKind = "claude-code" | "openclaw" | "codex" | "passport" | "custom" | (string & {}); export type RuntimeEndpointCapability = string; export declare const RUNTIME_ASSIGNMENT_FAILURE_CATEGORIES: readonly ["assignment_in_progress", "target_unavailable_before_acceptance", "acceptance_rejected", "processing_failed_or_expired", "reply_handle_stale"]; export type RuntimeAssignmentFailureCategory = (typeof RUNTIME_ASSIGNMENT_FAILURE_CATEGORIES)[number]; export type EndpointExecutionSurface = "owner_attached" | "headless" | (string & {}); export type EndpointBackgroundExchangeMode = "resident_endpoint" | "adapter_managed_turn" | "session_attached_pull" | (string & {}); export type RuntimeWorkTargetRef = { kind: "projection_endpoint"; projection_endpoint_id: string; background_exchange_mode: "resident_endpoint"; } | { kind: "projection_endpoint"; projection_endpoint_id: string; runtime_session_id: string; background_exchange_mode: "adapter_managed_turn"; } | { kind: "projection_endpoint"; projection_endpoint_id: string; runtime_session_id: string; background_exchange_mode: "session_attached_pull"; }; export interface WorkspaceMetadata { root: string; cwd: string; remote?: string; branch?: string; } export type ShareWithPeerField = "workspace" | "tracking_ref" | "fingerprint" | (string & {}); export interface RuntimeEndpointClientReport { host_version?: string; plugin_version?: string; } export interface RegisterRuntimeEndpointParams { as?: string; runtime_kind: RuntimeKind; runtime_session_id?: string; endpoint_nonce: string; display_label: string; session_name?: string; task_hint?: string; workspace?: WorkspaceMetadata; tracking_ref?: string; runtime_capabilities?: RuntimeEndpointCapability[]; execution_surface?: EndpointExecutionSurface; background_exchange_mode?: EndpointBackgroundExchangeMode; natural_boundary_presentation_contract_id?: string; node_recipient_admission_contract_id?: string; share_with_peer?: ShareWithPeerField[]; client?: RuntimeEndpointClientReport; } export interface RegisterRuntimeEndpointResponse { endpoint_id: string; node_id: string; display_label: string; session_naming?: RuntimeSessionNaming; runtime_capabilities?: RuntimeEndpointCapability[]; execution_surface?: EndpointExecutionSurface; background_exchange_mode?: EndpointBackgroundExchangeMode; natural_boundary_presentation_contract_id?: string; node_recipient_admission_contract_id?: string; heartbeat_after_seconds: number; lease_ttl_seconds: number; soft_retention_seconds: number; registered_at: string; } export interface OwnedRuntimeEndpointView { endpoint_id: string; node_id: string; node_handle?: string; runtime_kind: RuntimeKind; runtime_session_id?: string; runtime_session_identity_key?: string; display_label: string; session_name?: string; task_hint?: string; session_naming?: RuntimeSessionNaming; runtime_session_display?: RuntimeSessionDisplayMetadata; workspace?: WorkspaceMetadata; tracking_ref?: string; fingerprint?: { workspace_hash_per_peer?: Record; }; runtime_capabilities?: RuntimeEndpointCapability[]; execution_surface?: EndpointExecutionSurface; background_exchange_mode?: EndpointBackgroundExchangeMode; natural_boundary_presentation_contract_id?: string; node_recipient_admission_contract_id?: string; runtime_work_target_ref?: RuntimeWorkTargetRef; registered_at: string; retired_at?: string; alive: boolean; client?: RuntimeEndpointClientReport; is_self: boolean; } export type RuntimeSessionDisplayTitleSource = "session_name" | "task_hint" | "workspace" | "tracking_ref" | "fallback"; export interface RuntimeSessionDisplayMetadata { title: string; title_source: RuntimeSessionDisplayTitleSource; context?: { display_label?: string; workspace_label?: string; branch?: string; tracking_ref?: string; runtime_kind?: RuntimeKind; }; } export interface RuntimeSessionNaming { nickname: string; owner_edited_name?: string | null; } export interface ListOwnedRuntimeEndpointsResponse { total: number; items: OwnedRuntimeEndpointView[]; } export type HeartbeatRuntimeEndpointResponse = Record; export type UnregisterRuntimeEndpointResponse = Record; export interface TransitionRuntimeEndpointStateParams { state: "active" | "reconnecting" | "closed"; reason: string; ts: string; } export type TransitionRuntimeEndpointStateResponse = Record; export interface UpdateRuntimeEndpointDisplayMetadataParams { session_name?: string; task_hint?: string; } export interface RuntimeClaimCandidatesParams { endpoint_id: string; endpoint_nonce: string; limit?: number; } export interface RuntimeConversationRef { kind: "session_conversation"; id: string; } export interface RuntimeClaimCandidate { undispatched_id: string; source_message_id: string; sender_address: string; content_preview: string; reason: "no_target_endpoint" | "closed_session_continuation" | "correlated_continuation" | string; claim_policy: "owner_select_required" | "bound_session_pull_only" | "continuation_session_unavailable" | "assigned_in_progress" | "unavailable" | string; target_endpoint_id_hint?: string; in_reply_to?: string; origin_scid?: string; origin_ncid?: string; conversation_ref?: RuntimeConversationRef; active_assignment_id?: string; active_target_endpoint_id?: string; arrived_at: number; } export interface RuntimeClaimCandidatesResponse { items: RuntimeClaimCandidate[]; } export interface RuntimeNodeRef { kind: "agent" | "user" | (string & {}); mstpAddress: string; handle?: string; displayName?: string; avatarUrl?: string; } export type RuntimeServicesDisclosedParticipant = { kind: "node"; participant_ref: string; nickname?: string; avatar_url: string | null; handle?: string; node?: RuntimeNodeRef; parent_node?: never; host_label?: never; } | { kind: "session"; participant_ref: string; nickname?: string; avatar_url?: never; host_label?: string; node?: never; parent_node?: RuntimeNodeRef; }; export type RuntimeParticipantConversationSubject = { kind: "waiting"; message_ref: string; self_participant_ref: string; participants: [RuntimeServicesDisclosedParticipant]; } | { kind: "conversation"; conversation_ref: string; conversation_kind: "node_conversation" | "session_conversation"; self_participant_ref: string; participants: [ RuntimeServicesDisclosedParticipant, RuntimeServicesDisclosedParticipant ]; }; export type RuntimeTargetMessageDeliveryFacts = { placement: "placed"; custody: "held"; outcome_at: string; } | { placement: "placed"; custody: "taken"; custody_decided_at: string; outcome_at: string; } | { placement: "placed"; custody: "taken"; remote_custody_decided_at: string; local_outcome_recorded_at: string; outcome_at: string; }; export type RuntimeDeliveredConversationSubject = Extract; export interface RuntimeDispatchUndispatchedParams { undispatched_id: string; target_endpoint_id: string; target_ref?: RuntimeWorkTargetRef; idempotency_key?: string; } export interface RuntimeDispatchUndispatchedResponse { idempotency_key: string; emitted_at: string; accepted: boolean; delivery_mode?: "runtime_pull" | "adapter_managed_turn" | (string & {}); } export interface RuntimeOwnerActionHandoffInitParams { undispatched_id: string; target_endpoint_id: string; endpoint_nonce: string; target_ref: RuntimeWorkTargetRef; selection_hint?: { kind?: "ordinal" | "sender" | "unique" | (string & {}); ordinal?: number; sender_address?: string; }; } export interface RuntimeOwnerActionHandoffInitResponse { handoff_session_id: string; approve_url: string; expires_at: string; } export interface RuntimeOwnerActionHandoffPollParams { handoff_session_id: string; target_endpoint_id: string; endpoint_nonce: string; } export type RuntimeOwnerActionHandoffPollResponse = { status: "pending"; } | { status: "completed"; dispatch: RuntimeDispatchUndispatchedResponse; } | { status: "failed"; error: string; message?: string; retryable?: boolean; dispatch_status_code?: number; }; export interface RuntimeSelfClaimParams { undispatched_id: string; target_endpoint_id: string; endpoint_nonce: string; recover_existing?: boolean; expected_target_ref?: RuntimeWorkTargetRef; } export interface RuntimeSelfClaimResponse { assignment_id: string; undispatched_id: string; source_message_id: string; target_ref: RuntimeWorkTargetRef; broker_projection_token: string; assigned_at: number; claimed: boolean; recovered?: boolean; message: { from: string; content: string; contentType: string; metadata?: Record; sourceMessageId: string; }; } export interface RuntimeSelfClaimReleaseParams { undispatched_id: string; source_message_id: string; assignment_id: string; target_ref: RuntimeWorkTargetRef; endpoint_nonce: string; broker_projection_token: string; } export interface RuntimeSelfSettleParams { undispatched_id: string; endpoint_id: string; endpoint_nonce: string; } export interface RuntimeSelfSettleResponse { settled: true; undispatched_id: string; remove_reason: "handled_no_reply"; } export type RuntimeSelfSettleOutcome = { ok: true; settle: RuntimeSelfSettleResponse; } | { ok: false; terminal: boolean; status?: number; detail?: string; }; export interface RuntimeUndispatchedDismissParams { agent_id: string; undispatched_id: string; reason?: "owner_dismissed" | "handled_no_reply"; } export interface RuntimeUndispatchedDismissResponse { dismissed: true; undispatched_id: string; remove_reason: "owner_dismissed" | "handled_no_reply"; ttl_ms?: number; } export type RuntimeSelfClaimOutcome = { ok: true; claim: RuntimeSelfClaimResponse; } | { ok: false; terminal: boolean; status?: number; detail?: string; postCasInvalidClaim?: PartialRuntimeSelfClaimResponse; }; export type PartialRuntimeSelfClaimResponse = Omit, "target_ref"> & { target_ref?: RuntimeWorkTargetRef; }; interface RuntimeAssignmentReplyIntentBaseParams { endpoint_id: string; endpoint_nonce: string; source_message_id: string; assignment_id: string; reply_request_id: string; content: string; content_type?: string; metadata?: Record; } export type RuntimeAssignmentReplyPresentationAuthority = { presentation_confirmation_token: string; presentation_evidence: RuntimeExactTargetPresentationEvidenceV1 & { disposition: "full"; }; } | { presentation_confirmation_token?: never; presentation_evidence?: never; }; export type RuntimeAssignmentReplyIntentParams = RuntimeAssignmentReplyIntentBaseParams & RuntimeAssignmentReplyPresentationAuthority; export interface RuntimeAssignmentReplyGatewayMessage { event: "SEND_MESSAGE"; messageId: string; to: string; content: string; contentType: string; metadata: Record; assignmentReplyReceiptToken: string; } export type RuntimeAssignmentReplyIntentResponse = { ok: true; status: "committed"; assignment_id: string; source_message_id: string; reply_request_id: string; outbound_message_id: string; } | { ok: true; status: "pending"; assignment_id: string; source_message_id: string; reply_request_id: string; outbound_message_id: string; gateway_receipt_token: string; gateway_message: RuntimeAssignmentReplyGatewayMessage; } | { ok: true; status: "already_emitted"; assignment_id: string; source_message_id: string; reply_request_id: string; outbound_message_id: string; ack_status?: "delivered" | "stored"; }; export interface RuntimeOutboundMessageIntentParams { endpoint_id: string; endpoint_nonce: string; send_request_id: string; to: string; content: string; content_type?: string; metadata?: Record; } export interface RuntimeOutboundGatewayMessage { event: "SEND_MESSAGE"; messageId: string; to: string; content: string; contentType: string; metadata: Record; runtimeOutboundReceiptToken: string; } export type RuntimeOutboundMessageIntentResponse = { ok: true; status: "pending"; send_request_id: string; outbound_message_id: string; correlation_id: string; gateway_receipt_token: string; gateway_message: RuntimeOutboundGatewayMessage; } | { ok: true; status: "already_emitted"; send_request_id: string; outbound_message_id: string; correlation_id: string; ack_status?: "delivered" | "stored"; }; export declare const RUNTIME_PROCESSING_STATES: readonly ["assigned_to_runtime_target", "adapter_accepted", "processing_started", "reply_requested", "reply_emitted", "processing_failed", "waiting_for_runtime_capability", "target_lost_before_acceptance", "processing_interrupted", "expired"]; export type RuntimeProcessingState = (typeof RUNTIME_PROCESSING_STATES)[number]; export declare const ADAPTER_RUNTIME_PROCESSING_STATES: readonly ["adapter_accepted", "processing_started", "processing_failed", "waiting_for_runtime_capability", "target_lost_before_acceptance", "processing_interrupted", "expired"]; export type AdapterRuntimeProcessingState = (typeof ADAPTER_RUNTIME_PROCESSING_STATES)[number]; export declare const SYSTEM_RUNTIME_PROCESSING_STATES: readonly ["assigned_to_runtime_target", "reply_requested", "reply_emitted"]; export type SystemRuntimeProcessingState = (typeof SYSTEM_RUNTIME_PROCESSING_STATES)[number]; export interface RuntimeAdapterProcessingStateEvent { type?: "runtime_processing_state"; version?: 1; agent_id?: string; undispatched_id?: string; source_message_id: string; assignment_id: string; state_event_id: string; state_sequence: number; target_ref: RuntimeWorkTargetRef; state: AdapterRuntimeProcessingState; occurred_at: number; retryable?: boolean; reason_code?: string; detail?: string; } export interface RuntimeExactTargetPresentationAcquireParams { endpoint_id: string; endpoint_nonce: string; selection_after?: { source_message_id: string; assignment_id: string; confirmation_token: string; }; eligible_grains?: readonly ("exact_session" | "node")[]; } export declare const RUNTIME_EXACT_TARGET_PRESENTATION_SELECTION_FRONTIER_CONFLICT: "selection_frontier_conflict"; export interface RuntimeExactTargetPresentationEnvelopeV1 { type: "masons.remote_message.v1"; sender: { address?: string; display_name?: string; handle?: string; }; message_ref: string; content: string; sent_at?: string; } export interface RuntimeExactTargetPresentationEvidenceV1 { version: 1; disposition: "full" | "partial" | "pointer_only"; evidence_contract_id: string; evidence_contract_generation: number; envelope_digest: string; role: string; boundary_kind: string; boundary_ref: string; boundary_position: number; authority_incarnation: string; authority_sequence: number; observed_at: number; } export interface RuntimeExactTargetRecipientAdmissionEvidenceV1 { version: 1; evidence_contract_id: string; evidence_contract_generation: number; envelope_digest: string; authority_incarnation: string; authority_sequence: 1; } export interface RuntimeExactTargetRecipientAdmissionEvidenceEvent { type: "runtime_exact_target_recipient_admission_evidence"; version: 1; endpoint_id: string; endpoint_nonce: string; source_message_id: string; assignment_id: string; target_ref: RuntimeWorkTargetRef; presentation_confirmation_token: string; recipient_admission_evidence: RuntimeExactTargetRecipientAdmissionEvidenceV1; } export type RuntimeExactTargetRecipientAdmissionFailureStatus = "retryable" | "attempt_superseded" | "message_terminal" | "rejected"; export type RuntimeExactTargetRecipientAdmissionFailureReason = "endpoint_unavailable" | "processing_conflict" | "attempt_missing" | "attempt_expired" | "message_terminal" | "invalid_input" | "source_missing" | "attempt_conflict" | "target_mismatch" | "evidence_conflict"; export type RuntimeExactTargetRecipientAdmissionEvidenceOutcome = { ok: true; status: "admitted" | "standing"; admittedAt: number; } | { ok: false; providerStatus: RuntimeExactTargetRecipientAdmissionFailureStatus; reason: RuntimeExactTargetRecipientAdmissionFailureReason; terminal: boolean; status: number; } | (Extract & { providerStatus?: never; reason?: never; }); export interface RuntimeExactTargetPresentationEvidenceEvent { type: "runtime_exact_target_presentation_evidence"; version: 1; endpoint_id: string; endpoint_nonce: string; source_message_id: string; assignment_id: string; target_ref: RuntimeWorkTargetRef; presentation_confirmation_token: string; presentation_evidence: RuntimeExactTargetPresentationEvidenceV1; } export declare const RUNTIME_EXACT_TARGET_PRESENTATION_EVIDENCE_FAILURE_REASONS: readonly ["invalid_input", "source_missing", "commitment_invalid", "attempt_missing", "attempt_conflict", "attempt_expired", "target_mismatch", "endpoint_unavailable", "capability_missing", "evidence_conflict", "processing_conflict"]; export type RuntimeExactTargetPresentationEvidenceFailureReason = (typeof RUNTIME_EXACT_TARGET_PRESENTATION_EVIDENCE_FAILURE_REASONS)[number]; export type RuntimeExactTargetPresentationEvidenceOutcome = { ok: true; } | { ok: false; providerStatus: "rejected"; reason: RuntimeExactTargetPresentationEvidenceFailureReason; terminal: true; status: 409 | 422; } | (Extract & { providerStatus?: never; reason?: never; }); export interface RuntimeExactTargetPresentationReleaseEvent { type: "runtime_exact_target_presentation_release"; version: 1; source_message_id: string; assignment_id: string; presentation_confirmation_token: string; evidence_authority_incarnation: string; } export type RuntimeExactTargetPresentationReleaseOutcome = { ok: true; released: boolean; } | { ok: false; providerStatus: "attempt_retained"; reason: "recipient_admission_committed"; terminal: true; status: 409; } | (Extract & { providerStatus?: never; reason?: never; }); interface RuntimeExactTargetPresentationAcquireAssignedBase { type: "runtime_exact_target_presentation_acquire"; status: "bound" | "standing"; source_message_id: string; assignment_id: string; target_ref: RuntimeWorkTargetRef; confirmation_token: string; evidence_contract: { id: string; generation: number; role: string; boundary_kind: string; }; evidence_authority_incarnation: string; content_type: string; envelope_digest: string; assigned_at: string; expires_at: string; envelope: RuntimeExactTargetPresentationEnvelopeV1; subject: RuntimeDeliveredConversationSubject; speaker: RuntimeServicesDisclosedParticipant; } export type RuntimeExactTargetPresentationAcquireResponse = { type: "runtime_exact_target_presentation_acquire"; version: 3; status: "empty"; } | { type: "runtime_exact_target_presentation_acquire"; version: 3; status: "progressed"; } | (RuntimeExactTargetPresentationAcquireAssignedBase & { version: 3; recipient_admission_contract: { id: string; generation: number; }; }); export interface RuntimeExactSessionCustodySourceParams { endpoint_id: string; endpoint_nonce: string; last_event_id?: string; signal?: AbortSignal; } export interface RuntimeExactSessionCustodyControl { type: "runtime_exact_session_custody_control"; version: 1; event_id: string; control_ref: string; issued_at: string; } export interface RuntimeExactSessionCustodyResolveParams { endpoint_id: string; endpoint_nonce: string; control_ref: string; } export interface RuntimeExactSessionCustodyResolvedPresentation { source_message_id: string; assignment_id: string; target_ref: RuntimeWorkTargetRef; confirmation_token: string; evidence_contract: { id: string; generation: number; role: string; boundary_kind: string; }; recipient_admission_contract: { id: string; generation: number; }; evidence_authority_incarnation: string; content_type: string; envelope_digest: string; assigned_at: string; expires_at: string; envelope: RuntimeExactTargetPresentationEnvelopeV1; subject: RuntimeDeliveredConversationSubject; speaker: RuntimeServicesDisclosedParticipant; } export interface RuntimeExactSessionCustodyResolveResponse { type: "runtime_exact_session_custody_resolve"; version: 2; control_ref: string; presentation: RuntimeExactSessionCustodyResolvedPresentation; } export interface RuntimeExactSessionCustodyAppliedParams { endpoint_id: string; endpoint_nonce: string; control_ref: string; } export interface RuntimeExactSessionCustodyAppliedResponse { type: "runtime_exact_session_custody_applied"; version: 1; status: "applied" | "standing"; applied_at: number; } export interface RuntimeServicesRetainedNodeRecipientAcquireParams { endpoint_id: string; endpoint_nonce: string; } export type RuntimeServicesRetainedNodeRecipientAcquireResponse = { type: "runtime_node_recipient_message_acquire"; version: 3; status: "empty" | "progressed"; } | { type: "runtime_node_recipient_message_acquire"; version: 3; status: "retained"; message_ref: string; reply_handle: string; recipient_admission_contract: { id: "target-node-recipient-services-retained-v2"; generation: 1; }; content_type: string; envelope_digest: string; retained_at: string; envelope: RuntimeExactTargetPresentationEnvelopeV1; subject: RuntimeDeliveredConversationSubject; speaker: RuntimeServicesDisclosedParticipant; } | { type: "runtime_node_recipient_message_acquire"; version: 3; status: "rejected"; reason: "node_addressing_class_unavailable" | "endpoint_unavailable" | "capability_missing"; retryable: boolean; }; export interface RuntimeServicesRetainedNodeRecipientConsumptionEvent { type: "runtime_node_recipient_message_consumption"; version: 2; endpoint_id: string; endpoint_nonce: string; message_ref: string; reply_handle: string; presented_at: string; } export type RuntimeServicesRetainedNodeRecipientConsumptionFailureReason = "invalid_input" | "node_addressing_class_unavailable" | "endpoint_unavailable" | "capability_missing" | "attempt_missing" | "attempt_conflict" | "target_mismatch" | "message_terminal" | "processing_conflict"; export type RuntimeServicesRetainedNodeRecipientConsumptionOutcome = { ok: true; status: "consumed" | "standing"; consumedAt: number; } | { ok: false; providerStatus: "retryable" | "rejected" | "message_terminal"; reason: RuntimeServicesRetainedNodeRecipientConsumptionFailureReason; terminal: boolean; status: number; } | (Extract & { providerStatus?: never; reason?: never; }); export interface RuntimeServicesRetainedNodeRecipientReplyEvent { type: "runtime_node_recipient_message_reply"; version: 1; endpoint_id: string; endpoint_nonce: string; reply_handle: string; reply_request_id: string; content: string; content_type?: string; } export type RuntimeServicesRetainedNodeRecipientReplyFailureReason = "invalid_input" | "reply_handle_stale" | "reply_handle_conflict" | "reply_unavailable" | "processing_conflict"; export type RuntimeServicesRetainedNodeRecipientReplyOutcome = { ok: true; status: "committed" | "already_emitted"; messageRef: string; } | { ok: false; providerStatus: "retryable" | "rejected" | "reply_handle_stale"; reason: RuntimeServicesRetainedNodeRecipientReplyFailureReason; terminal: boolean; status: number; } | (Extract & { providerStatus?: never; reason?: never; }); export interface RuntimeNodeRecipientMessageAdmissionEvidenceEvent { type: "runtime_node_recipient_message_admission_evidence"; version: 1; message_ref: string; offer_ref: string; confirmation_token: string; recipient_admission_evidence: RuntimeExactTargetRecipientAdmissionEvidenceV1; } export type RuntimeNodeRecipientMessageAdmissionFailureReason = "processing_conflict" | "attempt_missing" | "attempt_expired" | "message_terminal" | "invalid_input" | "attempt_conflict" | "target_mismatch" | "evidence_conflict"; export type RuntimeNodeRecipientMessageAdmissionOutcome = { ok: true; status: "admitted" | "standing"; admittedAt: number; } | { ok: false; providerStatus: RuntimeExactTargetRecipientAdmissionFailureStatus; reason: RuntimeNodeRecipientMessageAdmissionFailureReason; terminal: boolean; status: number; } | (Extract & { providerStatus?: never; reason?: never; }); export type RuntimeAdapterEventOutcome = { ok: true; } | { ok: false; terminal: boolean; status?: number; detail?: string; assignmentFailureCategory?: RuntimeAssignmentFailureCategory; }; export {}; //# sourceMappingURL=types.d.ts.map