@proteos/sdk 0.49.0 → 0.50.1

package/dist/index.d.ts

@@ -2684,6 +2684,14 @@ interface Connection {
     supports_reactions: boolean;
     /** The capability descriptor; absent when unsupported. */
     reactions?: ReactionCapability;
+    /**
+     * Computed on read like reactions: the channel actions the connector
+     * performs through this connection (invitation, profile_visit, inmail, …).
+     * A separate list from reactions — a reaction toggles an edge on a
+     * message, an action is a performed act with its own lifecycle. Absent
+     * when the connector performs none.
+     */
+    actions?: ChannelActionCapability[];
     /**
      * Computed on read like supports_reactions: who operates the integration
      * (native | unipile). Absent when the connector is not registered in this
@@ -3522,6 +3530,14 @@ interface Contact {
     /** Merge tombstone redirect (set when status is 'merged'). */
     merged_into_contact_id?: string;
     source: ContactSource;
+    /** IANA zone name (Europe/Berlin); absent = unknown. Filled from directory sweeps while empty. */
+    timezone?: string;
+    /**
+     * BCP-47 language tag with optional region (de, de-CH, pt-BR); absent =
+     * unknown. Named locale, not language: the region carries formatting
+     * conventions on top of the language.
+     */
+    locale?: string;
     /** ContactGroup membership (one group per contact); absent = unassigned. */
     group_key?: string;
     /**
@@ -3628,6 +3644,10 @@ interface UpdateContactRequest {
     name?: string;
     status?: 'active' | 'archived';
     has_legal_hold?: boolean;
+    /** IANA zone name; normalized server-side, 400 contact_timezone_invalid when unparseable; '' clears. */
+    timezone?: string;
+    /** BCP-47 language tag; normalized server-side, 400 contact_locale_invalid when unparseable; '' clears. */
+    locale?: string;
     /**
      * Assigns the contact to a contact group ('' clears). A PATCH assignment is
      * stamped group_source='manual' — tone synthesis never overrides it.
@@ -3642,6 +3662,10 @@ interface UpdateContactRequest {
 interface CreateContactRequest {
     name: string;
     addresses: AttachContactAddressRequest[];
+    /** IANA zone name; optional, validated as on update. */
+    timezone?: string;
+    /** BCP-47 language tag; optional, validated as on update. */
+    locale?: string;
 }
 interface AttachContactAddressRequest {
     kind: ContactAddressKind;
@@ -3851,6 +3875,239 @@ interface DispatchMeetingBotRequest {
      */
     language?: string;
 }
+/**
+ * Discriminates a sending rule: window (WHEN sending is allowed, recipient-
+ * local weekday ranges), limit (HOW MUCH one connection may send per rolling
+ * period), frequency_cap (HOW OFTEN one contact may be contacted per rolling
+ * period).
+ */
+type SendingRuleType = 'window' | 'limit' | 'frequency_cap';
+/** Rolling lookback ("last 24 hours from now") — never a calendar day. */
+type SendingPeriod = 'rolling_24h' | 'rolling_7d' | 'rolling_30d';
+/**
+ * ONE kind of act performed through a channel connection — shared by a
+ * limit's `action` (what it counts), a channel action's `action_type` (what
+ * was performed) and the eligibility check. `message` is the plain send
+ * (valid on a limit, never on a channel action row).
+ */
+type ChannelActionType = 'message' | 'invitation' | 'inmail' | 'profile_visit';
+type Weekday = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+/** One open range on one weekday, "HH:MM" wall-clock, from < until, same day. */
+interface WindowDay {
+    day: Weekday;
+    from: string;
+    until: string;
+}
+interface WindowRuleConfig {
+    days: WindowDay[];
+    /** IANA zone used for contacts without a timezone. */
+    fallback_timezone: string;
+}
+interface LimitRuleConfig {
+    action: ChannelActionType;
+    max_count: number;
+    period: SendingPeriod;
+    /** Minimum spacing between consecutive sends; 0/absent = none. */
+    min_gap_seconds?: number;
+}
+interface FrequencyCapRuleConfig {
+    max_count: number;
+    period: SendingPeriod;
+}
+type SendingRuleConfig = WindowRuleConfig | LimitRuleConfig | FrequencyCapRuleConfig;
+/**
+ * One outbound send constraint, defined once and LINKED to any number of
+ * connections and/or channels (both empty = org-wide). Per rule type the most
+ * specific tier wins at send time: names the connection > names the channel >
+ * org-wide. Replies skip the rule when `is_reply_exempt`.
+ */
+interface SendingRule {
+    id: string;
+    org_id: string;
+    name: string;
+    connection_ids: string[];
+    channels: Channel[];
+    rule_type: SendingRuleType;
+    rule_config?: SendingRuleConfig;
+    is_enabled: boolean;
+    is_reply_exempt: boolean;
+    created_at: string;
+    created_by: UserRef;
+    updated_at: string;
+    updated_by: UserRef;
+}
+interface CreateSendingRuleRequest {
+    name?: string;
+    connection_ids?: string[];
+    channels?: Channel[];
+    rule_type: SendingRuleType;
+    rule_config: Record<string, unknown>;
+    /** Defaults to true. */
+    is_enabled?: boolean;
+    /** Defaults per type: window + frequency_cap true, limit false. */
+    is_reply_exempt?: boolean;
+}
+interface UpdateSendingRuleRequest {
+    name?: string;
+    /** Replaces the stored links wholesale when present. */
+    connection_ids?: string[];
+    channels?: Channel[];
+    /** rule_type and rule_config must be sent together. */
+    rule_type?: SendingRuleType;
+    rule_config?: Record<string, unknown>;
+    is_enabled?: boolean;
+    is_reply_exempt?: boolean;
+}
+interface ListSendingRulesQuery extends PaginationQuery {
+    /** Rules LINKED to this connection. */
+    connection_id?: string;
+    channel?: Channel;
+    rule_type?: SendingRuleType;
+    is_enabled?: boolean;
+}
+/** A recommended limit bundle for one class of sender account (static catalog). */
+interface SendingLimitPreset {
+    key: string;
+    name: string;
+    description: string;
+    connector_keys: ConnectorKey[];
+    is_recommended: boolean;
+    rules: {
+        rule_type: 'limit';
+        rule_config: LimitRuleConfig;
+    }[];
+}
+interface ListSendingLimitPresetsQuery {
+    connector_key?: ConnectorKey;
+}
+interface ApplySendingLimitPresetRequest {
+    connection_ids: string[];
+    preset_key: string;
+}
+/** Dry-run twin of SendMessageRequest: addressing only, nothing minted. */
+interface SendEligibilityRequest {
+    conversation_id?: string;
+    reply_to_message_id?: string;
+    connection_id?: string;
+    to?: SendRecipient[];
+    cc?: SendRecipient[];
+    bcc?: SendRecipient[];
+    /**
+     * Widens the check to a channel action (invitation, profile_visit, inmail):
+     * originate mode only, the first `to` recipient is the target. Absent =
+     * message.
+     */
+    action_type?: ChannelActionType;
+}
+/**
+ * "May this send go out now?" — `reason` is the error code a real send would
+ * fail with (sending_window_closed | sending_limit_reached |
+ * frequency_cap_reached | contact_blocked | contact_opted_out);
+ * `earliest_allowed_at` is set for the temporal three.
+ */
+interface SendEligibility {
+    is_allowed: boolean;
+    reason?: string;
+    rule_id?: string;
+    rule_type?: SendingRuleType;
+    earliest_allowed_at?: string;
+    contact_id?: string;
+    contact_address_id?: string;
+}
+/**
+ * Lifecycle of a channel action. Execution: pending → performed | failed.
+ * Outcome (invitations): performed → accepted | declined | withdrawn |
+ * expired; an inbound received invitation starts pending and ends
+ * accepted | declined | expired.
+ */
+type ChannelActionStatus = 'pending' | 'performed' | 'failed' | 'accepted' | 'declined' | 'withdrawn' | 'expired';
+/** Our answer to an inbound channel action (a received invitation). */
+type ChannelActionResponse = 'accept' | 'decline';
+/** What an action type acts on: a person on the channel, or an external object. */
+type ChannelActionTargetKind = 'contact-address' | 'external';
+/**
+ * One action type a connector performs, projected onto `connection.actions`.
+ */
+interface ChannelActionCapability {
+    action_type: ChannelActionType;
+    target_kind: ChannelActionTargetKind;
+    /** The act can be withdrawn after performing (an invitation). */
+    is_cancelable: boolean;
+    /** An inbound act of this type can be answered (accept / decline). */
+    is_respondable: boolean;
+    /** Performing also sends a message that lands as a Message + Conversation (InMail). */
+    is_message_minting: boolean;
+    /** Bound of the free-text note the act carries (LinkedIn invitation: 300). */
+    max_note_length?: number;
+}
+interface InvitationParams {
+    note?: string;
+    email?: string;
+}
+type ProfileVisitParams = Record<string, never>;
+interface InmailParams {
+    subject?: string;
+    content: ContentBlock[];
+}
+type ChannelActionParams = InvitationParams | ProfileVisitParams | InmailParams;
+/**
+ * One act performed through a channel connection that is neither a message
+ * nor a reaction — a LinkedIn invitation, a profile visit, an InMail (which
+ * ALSO mints a message, see message_id). A LEDGER row: appended, transitioned
+ * along its lifecycle, never toggled. `direction` outbound = we acted;
+ * inbound = someone acted on us (a received invitation you may answer).
+ * `created_by` is the performer on outbound rows (user or agent), the system
+ * on ingested inbound rows; `updated_by` who accepted / declined / withdrew.
+ */
+interface ChannelAction {
+    id: string;
+    org_id: string;
+    connection_id: string;
+    connector_key: ConnectorKey;
+    channel: Channel;
+    action_type: ChannelActionType;
+    direction: MessageDirection;
+    status: ChannelActionStatus;
+    contact_id?: string;
+    contact_address_id?: string;
+    /** The provider-side identity acted on (a LinkedIn member id). */
+    target_external_id: string;
+    contact: ContactRef;
+    /** An InMail's minted message; an invitation's note-chat once accepted. */
+    message_id?: string;
+    conversation_id?: string;
+    params?: ChannelActionParams;
+    /** The provider handle (Unipile invitation id) — cancel / respond key. */
+    external_action_id?: string;
+    error?: string;
+    occurred_at: string;
+    resolved_at?: string;
+    /** Provider enrichment: invitation usage %, network_distance, … */
+    metadata: Record<string, unknown>;
+    created_at: string;
+    created_by: UserRef;
+    updated_at: string;
+    updated_by: UserRef;
+}
+/** Performs one act. `target` is the person acted on (kind contact-address + the connector-side external id). */
+interface PerformChannelActionRequest {
+    connection_id: string;
+    action_type: ChannelActionType;
+    target: SendRecipient;
+    /** Per-type input: invitation {note?, email?}; profile_visit {}; inmail {subject?, content}. */
+    params?: Record<string, unknown>;
+}
+interface RespondChannelActionRequest {
+    response: ChannelActionResponse;
+}
+interface ListChannelActionsQuery extends PaginationQuery {
+    channel?: Channel;
+    connection_id?: string;
+    action_type?: ChannelActionType;
+    direction?: MessageDirection;
+    status?: ChannelActionStatus;
+    contact_id?: string;
+}
 
 /** One normalized transcription update streamed back from the server. */
 interface TranscriptResult {
@@ -3941,6 +4198,13 @@ declare class ConversationClient {
     readonly agentListeners: AgentListenerService;
     /** Ingest-time filter rules (drop-with-audit) + their event trail. */
     readonly conversationFilters: ConversationFilterService;
+    /** Outbound send constraints: windows, connection limits, frequency caps + presets. */
+    readonly sendingRules: SendingRuleService;
+    /**
+     * Channel actions: acts performed through a connection that are neither a
+     * message nor a reaction — LinkedIn invitations, profile visits, InMail.
+     */
+    readonly channelActions: ChannelActionService;
     /** Per-org glossary: custom vocabulary that boosts transcription accuracy. */
     readonly glossaryTerms: GlossaryTermService;
     /** Conversation taxonomy: the types the pre-summary classifier assigns. */
@@ -4070,6 +4334,12 @@ interface MessageService {
     /** One message with its read-time projections (reactions, attachments). */
     get(messageId: string): Promise<Message>;
     send(request: SendMessageRequest): Promise<Message>;
+    /**
+     * Dry-run of the sending gate: same addressing as send, no content, nothing
+     * minted. Answers whether the send may go out now and, when held, the
+     * earliest instant it may (`earliest_allowed_at`).
+     */
+    checkSendEligibility(request: SendEligibilityRequest): Promise<SendEligibility>;
     /**
      * Store an outbound message for human review (status=draft) — same request
      * shape as send, nothing reaches the connector until sendDraft. Originate
@@ -4245,6 +4515,52 @@ interface CallService {
     }>;
 }
 
+/**
+ * Sending rules — outbound send constraints (windows, connection limits,
+ * frequency caps), the static limit-preset catalog and its apply expansion.
+ * A denied send/reply/sendDraft fails with a ProteosError whose `details`
+ * carry `earliest_allowed_at` (429) or the blocked contact (403).
+ */
+interface SendingRuleService {
+    list(query?: ListSendingRulesQuery): Promise<ListResponse<SendingRule>>;
+    get(id: string): Promise<SendingRule>;
+    create(request: CreateSendingRuleRequest): Promise<SendingRule>;
+    update(id: string, request: UpdateSendingRuleRequest): Promise<SendingRule>;
+    delete(id: string): Promise<void>;
+    /** The static preset catalog, optionally narrowed to one connector. */
+    listPresets(query?: ListSendingLimitPresetsQuery): Promise<{
+        data: SendingLimitPreset[];
+    }>;
+    /**
+     * Expand a preset into limit rules linked to the given connections,
+     * replacing the limit rules they were linked to before.
+     */
+    applyPreset(request: ApplySendingLimitPresetRequest): Promise<{
+        data: SendingRule[];
+    }>;
+}
+/**
+ * Channel actions — the ledger of acts performed through a connection that
+ * are neither a message nor a reaction (LinkedIn invitations, profile visits,
+ * InMail). A denied perform fails like a denied send (ProteosError with
+ * `details.earliest_allowed_at`); a provider refusal carries its own code
+ * (already_connected, already_invited_recently, invitation_already_received,
+ * connection_limit_reached, insufficient_inmail_credits, inmail_not_allowed,
+ * not_connected_with_recipient). An invitation is pre-flighted with one silent
+ * profile read before anything is sent, so those refusals never mint a
+ * phantom act.
+ */
+interface ChannelActionService {
+    list(query?: ListChannelActionsQuery): Promise<ListResponse<ChannelAction>>;
+    get(id: string): Promise<ChannelAction>;
+    /** Performs one act; resolves to the row in its post-perform status. */
+    perform(request: PerformChannelActionRequest): Promise<ChannelAction>;
+    /** Withdraws a performed outbound act (an invitation). */
+    cancel(id: string): Promise<ChannelAction>;
+    /** Answers an inbound act (a received invitation). */
+    respond(id: string, request: RespondChannelActionRequest): Promise<ChannelAction>;
+}
+
 /**
  * A single row from a query result. Keys match the result-set columns
  * (camelCase, with `id`/`created_at`/`updated_at` reserved). The data-service
@@ -4556,7 +4872,13 @@ declare class ProteosError extends Error {
     readonly httpStatus: number;
     /** API error code (e.g., 'not_found', 'unauthorized') */
     readonly code: ErrorCodeType | string;
-    constructor(message: string, httpStatus: number, code: ErrorCodeType | string);
+    /**
+     * Optional machine-readable payload beside the message — e.g. a denied send's
+     * `earliest_allowed_at` / `rule_id`, the offending `contact_id`. Absent on
+     * most errors.
+     */
+    readonly details: Record<string, unknown> | undefined;
+    constructor(message: string, httpStatus: number, code: ErrorCodeType | string, details?: Record<string, unknown>);
     /**
      * Returns a formatted string representation of the error.
      */
@@ -4596,6 +4918,7 @@ declare function getDefaultErrorCode(httpStatus: number): ErrorCodeType | string
 interface ApiErrorResponse {
     code?: string;
     message?: string;
+    details?: Record<string, unknown>;
 }
 /**
  * Parses an error response from the API and creates a ProteosError.
@@ -7091,6 +7414,8 @@ interface ExecutionTriggerContext {
 interface ExecutionError {
     code: string;
     message: string;
+    /** Machine-readable payload of the node error (a held send's earliest_allowed_at / rule_id, http_status …). */
+    details?: Record<string, unknown>;
     /** Marks business failures the user can fix, vs infrastructure faults. */
     is_user_error?: boolean;
 }
@@ -7291,4 +7616,4 @@ declare class WorkflowClient {
     constructor(client: ProteosClient);
 }
 
-export { type AcceptMistranscribedTermRequest, AccountClient, type Action, type ActionBinding, ActionSchema, type ActionScope, ActionScopeSchema, type ActionService, type AddTeamMemberRequest, type AddressFilterConfig, type Agent, type AgentActionParams, type AgentArtifactsPayload, AgentClient, type AgentListener, type AgentListenerAcknowledgementConfig, type AgentListenerAcknowledgementType, type AgentListenerActingUserMode, type AgentListenerService, type AgentListenerTriggerType, type AgentMessagePayload, type AgentResourceListOptions, type AgentService, type AllFilterConfig, type ApiErrorResponse, type ApiKey, type AppendEventRequest, type AssignPermissionRequest, type AssignRoleRequest, type AttachContactAddressRequest, type Attachment, Attribute, AuditFields, type AuthListOptions, type AutomatedFilterConfig, type AutomatedSignal, type BatchTransactionError, BatchTransactionErrorSchema, type BatchTransactionStatus, type BatchUpsertRecordsResponse, BatchUpsertRecordsResponseSchema, type BatchUpsertTransaction, type BatchUpsertTransactionResult, BatchUpsertTransactionResultSchema, BatchUpsertTransactionSchema, type BinaryRef, type BlockContactRequest, type CallStatus, type CallTokenResponse, type Channel, type ClientEventType, type ClientToolSchema, type Connection, type ConnectionCredentials, type ConnectionEndpoint, type ConnectionScope, type ConnectionService, type ConnectionStatus, type ConnectionSyncRange, type ConnectionSyncStatus, type Connector, ConnectorClient, type ConnectorConnection, type ConnectionScope$1 as ConnectorConnectionScope, type ConnectionStatus$1 as ConnectorConnectionStatus, type ConnectionTokenResponse as ConnectorConnectionTokenResponse, type CredentialKind as ConnectorCredentialKind, type ConnectorKey, type ConnectorMethod, type ConnectorProvider, type ConsentStatus, type ConsumerGroup, type Contact, type ContactAddress, type ContactAddressKind, type ContactAddressSource, type ContactErasureRequest, type ContactGroup, type ContactGroupService, type ContactGroupSource, type ContactMergeProposal, type ContactRef, type ContactService, type ContactSource, type ContactStatus, type ContentBlock$1 as ContentBlock, type ContentMatch, type ContentResponse, type ContextCompactedPayload, type Conversation, ConversationClient, type ConversationFilter, type ConversationFilterAction, type ConversationFilterConfig, type ConversationFilterEvent, type ConversationFilterService, type ConversationFilterType, type ConversationParticipant, type ConversationService, type ConversationStatus, type ConversationSummaryStatus, type ConversationType, type ConversationTypeConfig, type ConversationTypeService, type CreateAgentListenerRequest, type CreateAgentRequest, type CreateApiKeyRequest, type CreateConnectionRequest, type CreateConnectorConnectionRequest, type CreateContactGroupRequest, type CreateConversationFilterRequest, type CreateConversationTypeRequest, type CreateFileMetadata, type CreateGlossaryTermRequest, type CreateLabelRequest, type CreateLinkRequest, type CreateMcpServerRequest, type CreateNodeRequest, type CreateOrganizationRequest, type CreatePromptRequest, type CreateRecordLinkRequest, type CreateRoleRequest, type CreateSessionRequest, type CreateSpaceRequest, type CreateTeamRequest, type CreateToneProfileSetupRequest, type CreateToolRequest, type CreateToolsetRequest, type CreateUserRequest, type CreateWorkflowRequest, type CreatedApiKey, type CredentialSpec, type CronTriggerParams, DEFAULT_PORT, DataClient, type DependentAgent, type DependentSyncResult, type DispatchMeetingBotRequest, type DisplayOptions, type DomainFilterConfig, ERROR_PORT, type EditContentRequest, type EditContentResponse, type EmptyPayload, type ErasureRequestStatus, ErrorCode, type ErrorCodeType, type ErrorPayload, type EventTriggerParams, type EventType, type EventVerb, EventsClient, type ExecutionError, type ExecutionStatus, type ExecutionTriggerContext, type FileBlock, FileRef, type FileService, type FileVersionContent, type FilterMatchOn, FunctionsClient, type GetExecutionDetailResponse, type GetGraphOptions, type GetNodeExecutionItemsOptions, type GetNodeExecutionItemsResponse, type GetNodeTypesResponse, type GlossaryTerm, type GlossaryTermService, type GraphService, type InlineLinkRequest, type InstallConnectionResponse, type InstallConnectorConnectionResponse, type InternalConversationsFilterConfig, type InvokeActionResponse, type InvokeNodeMethodRequest, type InvokeNodeMethodResponse, type Item, type KickoffSource, type KickoffType, KnowledgeClient, type KnowledgeGraph, type KnowledgeGraphLink, type KnowledgeGraphNode, type KnowledgeLabel, KnowledgeLabelSchema, type KnowledgeLink, KnowledgeLinkSchema, type KnowledgeNode, type KnowledgeNodeLabel, KnowledgeNodeLabelSchema, type KnowledgeNodeMetadata, KnowledgeNodeMetadataSchema, KnowledgeNodeSchema, type KnowledgeNodeSearchResult, KnowledgeNodeSearchResultSchema, type KnowledgeRecordLink, KnowledgeRecordLinkSchema, type KnowledgeSpace, type LabelService, type LinkService, type LinkType, type ListActionsOptions, type ListAgentListenersQuery, type ListAgentsOptions, type ListConnectionsQuery, type ListConnectorConnectionsQuery, type ListConnectorsQuery, type ListContactAddressesQuery, type ListContactGroupsQuery, type ListContactMergeProposalsQuery, type ListContactsQuery, type ListConversationFilterEventsQuery, type ListConversationFiltersQuery, type ListConversationTypesQuery, type ListConversationsQuery, type ListEventsOptions, type ListExecutionsOptions, type ListGlossaryTermsQuery, type ListLabelsOptions, type ListLinksOptions, type ListMcpServersOptions, type ListMessagesQuery, type ListMistranscribedTermsQuery, type ListNodesOptions, ListOptions, type ListOrgUserRoleAssignmentsOptions, type ListOrganizationsOptions, type ListPromptsOptions, type ListRecordLinksOptions, type ListRecordsOptions, type ListResponse, ListResult, type ListRolePermissionsOptions, type ListRolesOptions, type ListRoomsQuery, type ListSessionsOptions, type ListSkillsOptions, type ListSpacesOptions, type ListTeamMembersOptions, type ListTeamsOptions, type ListToneProfileSetupsQuery, type ListToneProfilesQuery, type ListToolsOptions, type ListToolsetsOptions, type ListUserRoleAssignmentsOptions, type ListUsersOptions, type ListWorkflowsOptions, type ManualTriggerParams, type MatchMode, type McpBinding, type McpConnectionState, type McpConnectionStatus, type McpServer, type McpServerAuth, type McpServerOAuth, type McpServerService, type McpToolSummary, type MeService, type MeetingService, type MergeContactsRequest, type MergeProposalStatus, type Message, type ContentBlock as MessageContentBlock, type MessageDirection, type MessagePreview, type MessageRecipient, type MessageService, type MessageStatus, type MessageTriggerParams, type MintCallTokenRequest, type MistranscribedTerm, type MistranscribedTermService, type MistranscribedTermStatus, type MistranscriptionSuggestionSource, type ModelCallParams, type ModelConfig, type ModelRequestEndPayload, type ModelRequestStartPayload, type ModelUsage, type NeighborDirection, type NeighborEdge, type NeighborNode, type NeighborsOptions, type NodeContentMatches, type NodeDescriptor, type NodeExecution, type NodeGroup, type NodeMethodOption, type NodeNeighborhood, NodeNeighborhoodSchema, type NodeOutline, type NodePosition, type NodeProperty, type NodeRetryPolicy, type NodeRuntime, type NodeService, type NodeStatus, type NodeType, type NodeTypeKey, type NodeTypeService, type NodeTypeStatus, type OnErrorPolicy, type Organization, OrganizationSchema, type OrganizationService, type OutlineHeading, type OutlineRequest, type OutlineResponse, PLATFORM_ENTITIES, PLATFORM_ENTITY_SLUGS, PageIterator, type PairedItem, type ParseStatus, type Permission, type PermissionEventSource, type PermissionEventType, type PhoneNumber, type PhoneNumberRouting, type PhoneNumberStatus, type PlatformBinding, type PlatformEntity, type PlatformEvent, type PortSpec, type Prompt, type PromptService, type PromptVersion, type PropertyOption, type PropertyType, ProteosClient, ProteosError, PublicAccessOperation, type PublishEventRequest, type QueryBinding, type QueryExecuteMeta, type QueryExecuteResponse, type QueryObject, type QueryRow, type QueryService, type QueryValidateMeta, type QueryValidateResponse, type QueryValue, type Reaction, type ReactionCapability, type ReactionOption, type ReactionSetKind, type ReasoningPayload, type RecipientKind, type RecipientRole, type RecordData, type RecordLinkService, type RecordPermissionEventRequest, type RecordService, type RedriveResult, type ResolveToneProfileQuery, type ResultBlock, type Role, type RoleBasedFilterConfig, type RoleEntityPermission, RoleEntityPermissionSchema, RoleSchema, type RoleService, type Room, type RoutingTarget, type RunWorkflowRequest, SCOPED_PLATFORM_ENTITY_SLUGS, type SearchContentRequest, type SearchContentResponse, type SearchNodesRequest, type SendMessageRequest, type SendRecipient, type Session, type SessionEvent, type SessionEventEnvelope, type SessionEventsOptions, type SessionIdlePayload, type SessionService, type SessionStatus, type SessionStreamOptions, type SessionUpdatedPayload, type SharePermission, type ShareRow, type ShareService, type Skill, type SkillBundle, type SkillService, type SkillVersion, type SpaceService, type StartMcpOAuthResponse, type StopReason, StorageClient, type StorageFile, type StorageFileVersion, type SyncConnectionRequest, type SystemSource, type TailOptions, type Team, type TeamMember, type TeamService, type TestNodeCandidate, type TestNodeInputSource, type TestNodeRequest, type TestNodeResponse, type TextBlock, type ToneProfile, type ToneProfileScope, type ToneProfileService, type ToneProfileSetup, type ToneProfileSetupStatus, type Tool, type ToolBinding, type ToolConfirmationPayload, type ToolKind, type ToolResultPayload, type ToolService, type ToolUsePayload, type Toolset, type ToolsetKind, type ToolsetService, type ToolsetToolSummary, type Topic, type TopicKind, type TopicService, type TranscribeStreamOptions, type TranscriptResult, type TranscriptTurn, type Transcription, type TranscriptionReviewStatus, type TranscriptionStatus, type TriggerKind, type Turn, UNASSIGNED_SPACE_SLUG, type UnreadCounts, type UpdateAgentListenerRequest, type UpdateAgentRequest, type UpdateConnectionRequest, type UpdateConnectorConnectionRequest, type UpdateContactGroupRequest, type UpdateContactRequest, type UpdateConversationFilterRequest, type UpdateConversationTypeRequest, type UpdateDraftRequest, type UpdateFileMetadata, type UpdateGlossaryTermRequest, type UpdateLabelRequest, type UpdateLinkRequest, type UpdateMcpServerRequest, type UpdateMeRequest, type UpdateNodeRequest, type UpdateOrganizationRequest, type UpdatePhoneNumberRequest, type UpdatePromptRequest, type UpdateRoleRequest, type UpdateSpaceRequest, type UpdateTeamRequest, type UpdateToolRequest, type UpdateToolsetRequest, type UpdateUserRequest, type UpdateWorkflowRequest, type User, type UserMessagePayload, UserRef$2 as UserRef, type UserRoleAssignment, UserRoleAssignmentSchema, type UserRoleAssignmentService, UserSchema, type UserService, type VoiceService, type VoiceTranscriptionStream, type WebhookTriggerParams, type Workflow, WorkflowClient, type WorkflowConnection, type WorkflowExecution, type WorkflowGraph, type WorkflowNode, type WorkflowNodeType, type WorkflowStatus, type WorkflowVersion, type WorkflowVersionAuthor, type WorkflowVersionSummary, type WriteContentResponse, type WriteCredentialsRequest, buildUrl, getDefaultErrorCode, isBadRequest, isConflict, isForbidden, isNotFound, isPlatformEntity, isProteosError, isShareable, isUnauthorized, parseErrorResponse, shareRouteFor, toQueryParams, toQueryString };
+export { type AcceptMistranscribedTermRequest, AccountClient, type Action, type ActionBinding, ActionSchema, type ActionScope, ActionScopeSchema, type ActionService, type AddTeamMemberRequest, type AddressFilterConfig, type Agent, type AgentActionParams, type AgentArtifactsPayload, AgentClient, type AgentListener, type AgentListenerAcknowledgementConfig, type AgentListenerAcknowledgementType, type AgentListenerActingUserMode, type AgentListenerService, type AgentListenerTriggerType, type AgentMessagePayload, type AgentResourceListOptions, type AgentService, type AllFilterConfig, type ApiErrorResponse, type ApiKey, type AppendEventRequest, type ApplySendingLimitPresetRequest, type AssignPermissionRequest, type AssignRoleRequest, type AttachContactAddressRequest, type Attachment, Attribute, AuditFields, type AuthListOptions, type AutomatedFilterConfig, type AutomatedSignal, type BatchTransactionError, BatchTransactionErrorSchema, type BatchTransactionStatus, type BatchUpsertRecordsResponse, BatchUpsertRecordsResponseSchema, type BatchUpsertTransaction, type BatchUpsertTransactionResult, BatchUpsertTransactionResultSchema, BatchUpsertTransactionSchema, type BinaryRef, type BlockContactRequest, type CallStatus, type CallTokenResponse, type Channel, type ChannelAction, type ChannelActionCapability, type ChannelActionParams, type ChannelActionResponse, type ChannelActionService, type ChannelActionStatus, type ChannelActionTargetKind, type ChannelActionType, type ClientEventType, type ClientToolSchema, type Connection, type ConnectionCredentials, type ConnectionEndpoint, type ConnectionScope, type ConnectionService, type ConnectionStatus, type ConnectionSyncRange, type ConnectionSyncStatus, type Connector, ConnectorClient, type ConnectorConnection, type ConnectionScope$1 as ConnectorConnectionScope, type ConnectionStatus$1 as ConnectorConnectionStatus, type ConnectionTokenResponse as ConnectorConnectionTokenResponse, type CredentialKind as ConnectorCredentialKind, type ConnectorKey, type ConnectorMethod, type ConnectorProvider, type ConsentStatus, type ConsumerGroup, type Contact, type ContactAddress, type ContactAddressKind, type ContactAddressSource, type ContactErasureRequest, type ContactGroup, type ContactGroupService, type ContactGroupSource, type ContactMergeProposal, type ContactRef, type ContactService, type ContactSource, type ContactStatus, type ContentBlock$1 as ContentBlock, type ContentMatch, type ContentResponse, type ContextCompactedPayload, type Conversation, ConversationClient, type ConversationFilter, type ConversationFilterAction, type ConversationFilterConfig, type ConversationFilterEvent, type ConversationFilterService, type ConversationFilterType, type ConversationParticipant, type ConversationService, type ConversationStatus, type ConversationSummaryStatus, type ConversationType, type ConversationTypeConfig, type ConversationTypeService, type CreateAgentListenerRequest, type CreateAgentRequest, type CreateApiKeyRequest, type CreateConnectionRequest, type CreateConnectorConnectionRequest, type CreateContactGroupRequest, type CreateConversationFilterRequest, type CreateConversationTypeRequest, type CreateFileMetadata, type CreateGlossaryTermRequest, type CreateLabelRequest, type CreateLinkRequest, type CreateMcpServerRequest, type CreateNodeRequest, type CreateOrganizationRequest, type CreatePromptRequest, type CreateRecordLinkRequest, type CreateRoleRequest, type CreateSendingRuleRequest, type CreateSessionRequest, type CreateSpaceRequest, type CreateTeamRequest, type CreateToneProfileSetupRequest, type CreateToolRequest, type CreateToolsetRequest, type CreateUserRequest, type CreateWorkflowRequest, type CreatedApiKey, type CredentialSpec, type CronTriggerParams, DEFAULT_PORT, DataClient, type DependentAgent, type DependentSyncResult, type DispatchMeetingBotRequest, type DisplayOptions, type DomainFilterConfig, ERROR_PORT, type EditContentRequest, type EditContentResponse, type EmptyPayload, type ErasureRequestStatus, ErrorCode, type ErrorCodeType, type ErrorPayload, type EventTriggerParams, type EventType, type EventVerb, EventsClient, type ExecutionError, type ExecutionStatus, type ExecutionTriggerContext, type FileBlock, FileRef, type FileService, type FileVersionContent, type FilterMatchOn, type FrequencyCapRuleConfig, FunctionsClient, type GetExecutionDetailResponse, type GetGraphOptions, type GetNodeExecutionItemsOptions, type GetNodeExecutionItemsResponse, type GetNodeTypesResponse, type GlossaryTerm, type GlossaryTermService, type GraphService, type InlineLinkRequest, type InmailParams, type InstallConnectionResponse, type InstallConnectorConnectionResponse, type InternalConversationsFilterConfig, type InvitationParams, type InvokeActionResponse, type InvokeNodeMethodRequest, type InvokeNodeMethodResponse, type Item, type KickoffSource, type KickoffType, KnowledgeClient, type KnowledgeGraph, type KnowledgeGraphLink, type KnowledgeGraphNode, type KnowledgeLabel, KnowledgeLabelSchema, type KnowledgeLink, KnowledgeLinkSchema, type KnowledgeNode, type KnowledgeNodeLabel, KnowledgeNodeLabelSchema, type KnowledgeNodeMetadata, KnowledgeNodeMetadataSchema, KnowledgeNodeSchema, type KnowledgeNodeSearchResult, KnowledgeNodeSearchResultSchema, type KnowledgeRecordLink, KnowledgeRecordLinkSchema, type KnowledgeSpace, type LabelService, type LimitRuleConfig, type LinkService, type LinkType, type ListActionsOptions, type ListAgentListenersQuery, type ListAgentsOptions, type ListChannelActionsQuery, type ListConnectionsQuery, type ListConnectorConnectionsQuery, type ListConnectorsQuery, type ListContactAddressesQuery, type ListContactGroupsQuery, type ListContactMergeProposalsQuery, type ListContactsQuery, type ListConversationFilterEventsQuery, type ListConversationFiltersQuery, type ListConversationTypesQuery, type ListConversationsQuery, type ListEventsOptions, type ListExecutionsOptions, type ListGlossaryTermsQuery, type ListLabelsOptions, type ListLinksOptions, type ListMcpServersOptions, type ListMessagesQuery, type ListMistranscribedTermsQuery, type ListNodesOptions, ListOptions, type ListOrgUserRoleAssignmentsOptions, type ListOrganizationsOptions, type ListPromptsOptions, type ListRecordLinksOptions, type ListRecordsOptions, type ListResponse, ListResult, type ListRolePermissionsOptions, type ListRolesOptions, type ListRoomsQuery, type ListSendingLimitPresetsQuery, type ListSendingRulesQuery, type ListSessionsOptions, type ListSkillsOptions, type ListSpacesOptions, type ListTeamMembersOptions, type ListTeamsOptions, type ListToneProfileSetupsQuery, type ListToneProfilesQuery, type ListToolsOptions, type ListToolsetsOptions, type ListUserRoleAssignmentsOptions, type ListUsersOptions, type ListWorkflowsOptions, type ManualTriggerParams, type MatchMode, type McpBinding, type McpConnectionState, type McpConnectionStatus, type McpServer, type McpServerAuth, type McpServerOAuth, type McpServerService, type McpToolSummary, type MeService, type MeetingService, type MergeContactsRequest, type MergeProposalStatus, type Message, type ContentBlock as MessageContentBlock, type MessageDirection, type MessagePreview, type MessageRecipient, type MessageService, type MessageStatus, type MessageTriggerParams, type MintCallTokenRequest, type MistranscribedTerm, type MistranscribedTermService, type MistranscribedTermStatus, type MistranscriptionSuggestionSource, type ModelCallParams, type ModelConfig, type ModelRequestEndPayload, type ModelRequestStartPayload, type ModelUsage, type NeighborDirection, type NeighborEdge, type NeighborNode, type NeighborsOptions, type NodeContentMatches, type NodeDescriptor, type NodeExecution, type NodeGroup, type NodeMethodOption, type NodeNeighborhood, NodeNeighborhoodSchema, type NodeOutline, type NodePosition, type NodeProperty, type NodeRetryPolicy, type NodeRuntime, type NodeService, type NodeStatus, type NodeType, type NodeTypeKey, type NodeTypeService, type NodeTypeStatus, type OnErrorPolicy, type Organization, OrganizationSchema, type OrganizationService, type OutlineHeading, type OutlineRequest, type OutlineResponse, PLATFORM_ENTITIES, PLATFORM_ENTITY_SLUGS, PageIterator, type PairedItem, type ParseStatus, type PerformChannelActionRequest, type Permission, type PermissionEventSource, type PermissionEventType, type PhoneNumber, type PhoneNumberRouting, type PhoneNumberStatus, type PlatformBinding, type PlatformEntity, type PlatformEvent, type PortSpec, type ProfileVisitParams, type Prompt, type PromptService, type PromptVersion, type PropertyOption, type PropertyType, ProteosClient, ProteosError, PublicAccessOperation, type PublishEventRequest, type QueryBinding, type QueryExecuteMeta, type QueryExecuteResponse, type QueryObject, type QueryRow, type QueryService, type QueryValidateMeta, type QueryValidateResponse, type QueryValue, type Reaction, type ReactionCapability, type ReactionOption, type ReactionSetKind, type ReasoningPayload, type RecipientKind, type RecipientRole, type RecordData, type RecordLinkService, type RecordPermissionEventRequest, type RecordService, type RedriveResult, type ResolveToneProfileQuery, type RespondChannelActionRequest, type ResultBlock, type Role, type RoleBasedFilterConfig, type RoleEntityPermission, RoleEntityPermissionSchema, RoleSchema, type RoleService, type Room, type RoutingTarget, type RunWorkflowRequest, SCOPED_PLATFORM_ENTITY_SLUGS, type SearchContentRequest, type SearchContentResponse, type SearchNodesRequest, type SendEligibility, type SendEligibilityRequest, type SendMessageRequest, type SendRecipient, type SendingLimitPreset, type SendingPeriod, type SendingRule, type SendingRuleConfig, type SendingRuleService, type SendingRuleType, type Session, type SessionEvent, type SessionEventEnvelope, type SessionEventsOptions, type SessionIdlePayload, type SessionService, type SessionStatus, type SessionStreamOptions, type SessionUpdatedPayload, type SharePermission, type ShareRow, type ShareService, type Skill, type SkillBundle, type SkillService, type SkillVersion, type SpaceService, type StartMcpOAuthResponse, type StopReason, StorageClient, type StorageFile, type StorageFileVersion, type SyncConnectionRequest, type SystemSource, type TailOptions, type Team, type TeamMember, type TeamService, type TestNodeCandidate, type TestNodeInputSource, type TestNodeRequest, type TestNodeResponse, type TextBlock, type ToneProfile, type ToneProfileScope, type ToneProfileService, type ToneProfileSetup, type ToneProfileSetupStatus, type Tool, type ToolBinding, type ToolConfirmationPayload, type ToolKind, type ToolResultPayload, type ToolService, type ToolUsePayload, type Toolset, type ToolsetKind, type ToolsetService, type ToolsetToolSummary, type Topic, type TopicKind, type TopicService, type TranscribeStreamOptions, type TranscriptResult, type TranscriptTurn, type Transcription, type TranscriptionReviewStatus, type TranscriptionStatus, type TriggerKind, type Turn, UNASSIGNED_SPACE_SLUG, type UnreadCounts, type UpdateAgentListenerRequest, type UpdateAgentRequest, type UpdateConnectionRequest, type UpdateConnectorConnectionRequest, type UpdateContactGroupRequest, type UpdateContactRequest, type UpdateConversationFilterRequest, type UpdateConversationTypeRequest, type UpdateDraftRequest, type UpdateFileMetadata, type UpdateGlossaryTermRequest, type UpdateLabelRequest, type UpdateLinkRequest, type UpdateMcpServerRequest, type UpdateMeRequest, type UpdateNodeRequest, type UpdateOrganizationRequest, type UpdatePhoneNumberRequest, type UpdatePromptRequest, type UpdateRoleRequest, type UpdateSendingRuleRequest, type UpdateSpaceRequest, type UpdateTeamRequest, type UpdateToolRequest, type UpdateToolsetRequest, type UpdateUserRequest, type UpdateWorkflowRequest, type User, type UserMessagePayload, UserRef$2 as UserRef, type UserRoleAssignment, UserRoleAssignmentSchema, type UserRoleAssignmentService, UserSchema, type UserService, type VoiceService, type VoiceTranscriptionStream, type WebhookTriggerParams, type Weekday, type WindowDay, type WindowRuleConfig, type Workflow, WorkflowClient, type WorkflowConnection, type WorkflowExecution, type WorkflowGraph, type WorkflowNode, type WorkflowNodeType, type WorkflowStatus, type WorkflowVersion, type WorkflowVersionAuthor, type WorkflowVersionSummary, type WriteContentResponse, type WriteCredentialsRequest, buildUrl, getDefaultErrorCode, isBadRequest, isConflict, isForbidden, isNotFound, isPlatformEntity, isProteosError, isShareable, isUnauthorized, parseErrorResponse, shareRouteFor, toQueryParams, toQueryString };

package/dist/index.js

@@ -531,11 +531,18 @@ var ProteosError = class extends Error {
   httpStatus;
   /** API error code (e.g., 'not_found', 'unauthorized') */
   code;
-  constructor(message, httpStatus, code) {
+  /**
+   * Optional machine-readable payload beside the message — e.g. a denied send's
+   * `earliest_allowed_at` / `rule_id`, the offending `contact_id`. Absent on
+   * most errors.
+   */
+  details;
+  constructor(message, httpStatus, code, details) {
     super(message);
     this.name = "ProteosError";
     this.httpStatus = httpStatus;
     this.code = code;
+    this.details = details;
     const v8Capture = Error.captureStackTrace;
     if (v8Capture) v8Capture(this, this.constructor);
   }
@@ -584,6 +591,7 @@ async function parseErrorResponse(response) {
   const httpStatus = response.status;
   let code = getDefaultErrorCode(httpStatus);
   let message = "Unknown error";
+  let details;
   try {
     const body = await response.text();
     try {
@@ -596,13 +604,16 @@ async function parseErrorResponse(response) {
       } else {
         message = body || `HTTP ${httpStatus}`;
       }
+      if (json.details && typeof json.details === "object") {
+        details = json.details;
+      }
     } catch {
       message = body.trim() || `HTTP ${httpStatus}`;
     }
   } catch {
     message = `HTTP ${httpStatus}`;
   }
-  return new ProteosError(message, httpStatus, code);
+  return new ProteosError(message, httpStatus, code, details);
 }
 
 // src/auth/shares.ts
@@ -866,6 +877,12 @@ var PLATFORM_ENTITIES = [
   { slug: "contact-groups", name: "Contact Groups" },
   // Tone-of-voice synthesis: per-user setups + generated instruction profiles.
   { slug: "tone-profiles", name: "Tone Profiles" },
+  // Outbound send constraints (windows, connection limits, frequency caps) +
+  // their preset catalog.
+  { slug: "sending-rules", name: "Sending Rules" },
+  // The channel_action ledger: acts through a connection that are neither a
+  // message nor a reaction (LinkedIn invitations, profile visits, InMail).
+  { slug: "channel-actions", name: "Channel Actions" },
   // Connectors (connector-service). `connections` above is shared; this is the
   // manifest catalog.
   { slug: "connectors", name: "Connectors" }
@@ -1500,6 +1517,13 @@ var ConversationClient = class {
   agentListeners;
   /** Ingest-time filter rules (drop-with-audit) + their event trail. */
   conversationFilters;
+  /** Outbound send constraints: windows, connection limits, frequency caps + presets. */
+  sendingRules;
+  /**
+   * Channel actions: acts performed through a connection that are neither a
+   * message nor a reaction — LinkedIn invitations, profile visits, InMail.
+   */
+  channelActions;
   /** Per-org glossary: custom vocabulary that boosts transcription accuracy. */
   glossaryTerms;
   /** Conversation taxonomy: the types the pre-summary classifier assigns. */
@@ -1523,6 +1547,8 @@ var ConversationClient = class {
     this.messages = new MessageServiceImpl(client);
     this.agentListeners = new AgentListenerServiceImpl(client);
     this.conversationFilters = new ConversationFilterServiceImpl(client);
+    this.sendingRules = new SendingRuleServiceImpl(client);
+    this.channelActions = new ChannelActionServiceImpl(client);
     this.glossaryTerms = new GlossaryTermServiceImpl(client);
     this.conversationTypes = new ConversationTypeServiceImpl(client);
     this.contactGroups = new ContactGroupServiceImpl(client);
@@ -1804,6 +1830,13 @@ var MessageServiceImpl = class {
   send(request) {
     return this.client.request("POST", `${CONVERSATION_BASE_PATH}/messages/send`, request);
   }
+  checkSendEligibility(request) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/messages/send-eligibility`,
+      request
+    );
+  }
   draft(request) {
     return this.client.request("POST", `${CONVERSATION_BASE_PATH}/messages/draft`, request);
   }
@@ -2183,6 +2216,82 @@ var CallServiceImpl = class {
     );
   }
 };
+var SendingRuleServiceImpl = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  list(query = {}) {
+    return this.client.requestWithQuery("GET", `${CONVERSATION_BASE_PATH}/sending-rules`, query);
+  }
+  get(id) {
+    return this.client.request(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/sending-rules/${encodeURIComponent(id)}`
+    );
+  }
+  create(request) {
+    return this.client.request("POST", `${CONVERSATION_BASE_PATH}/sending-rules`, request);
+  }
+  update(id, request) {
+    return this.client.request(
+      "PATCH",
+      `${CONVERSATION_BASE_PATH}/sending-rules/${encodeURIComponent(id)}`,
+      request
+    );
+  }
+  async delete(id) {
+    await this.client.request(
+      "DELETE",
+      `${CONVERSATION_BASE_PATH}/sending-rules/${encodeURIComponent(id)}`
+    );
+  }
+  listPresets(query = {}) {
+    return this.client.requestWithQuery(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/sending-rules/presets`,
+      query
+    );
+  }
+  applyPreset(request) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/sending-rules/apply-preset`,
+      request
+    );
+  }
+};
+var ChannelActionServiceImpl = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  list(query = {}) {
+    return this.client.requestWithQuery("GET", `${CONVERSATION_BASE_PATH}/channel-actions`, query);
+  }
+  get(id) {
+    return this.client.request(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/channel-actions/${encodeURIComponent(id)}`
+    );
+  }
+  perform(request) {
+    return this.client.request("POST", `${CONVERSATION_BASE_PATH}/channel-actions`, request);
+  }
+  cancel(id) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/channel-actions/${encodeURIComponent(id)}/cancel`
+    );
+  }
+  respond(id, request) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/channel-actions/${encodeURIComponent(id)}/respond`,
+      request
+    );
+  }
+};
 
 // src/data/queries.ts
 var QUERY_BASE_PATH = "/data/v1/query";