lumnisai 0.5.26 → 0.5.28

package/dist/index.cjs

@@ -949,6 +949,9 @@ class CrmResource {
    * `crmRecordId`. Stale links (record deleted in the CRM) are detected
    * and re-created automatically.
    *
+   * Works with or without a `campaign_prospects` row — search-sourced
+   * prospects are enriched from profile cache when needed.
+   *
    * @example
    * ```typescript
    * const result = await client.crm.syncProspect({
@@ -968,16 +971,13 @@ class CrmResource {
    * render a "linked" indicator for the ones that come back true.
    *
    * Layered cache on the server side: persistent positive matches are
-   * served from the `campaign_prospects.crm_record_id` column, negative
-   * results are served from a Redis cache (TTL configured by
-   * `CRM_MATCH_NEGATIVE_CACHE_TTL_SECONDS`). Only the leftover unknowns
-   * fan out to the live CRM, bounded by
+   * served from the `campaign_prospects.crm_record_id` column and the
+   * local `crm_contacts` ledger; negative results are served from a Redis
+   * cache (TTL configured by `CRM_MATCH_NEGATIVE_CACHE_TTL_SECONDS`).
+   * Only the leftover unknowns fan out to the live CRM, bounded by
    * `CRM_MATCH_LIVE_SEARCH_PARALLELISM`.
    *
-   * Note: HubSpot does not expose a LinkedIn-URL search field through
-   * Composio, so for `provider: 'hubspot'` URLs that aren't already in
-   * the persistent cache will always come back `linked: false`. The
-   * sync endpoint still reconciles via email when available.
+   * Provider-id/URN inputs are resolved to vanity before matching.
    *
    * @example
    * ```typescript
@@ -994,6 +994,51 @@ class CrmResource {
   async matchBatch(data) {
     return this.http.post("/crm/prospects/match-batch", data);
   }
+  /**
+   * Trigger a full mirror of the owner's CRM contact book into the local
+   * `crm_contacts` ledger. Returns immediately (`202`); poll
+   * {@link getContactsSyncStatus} for progress.
+   */
+  async syncContacts(data) {
+    return this.http.post("/crm/contacts/sync", data);
+  }
+  /**
+   * Ledger sync freshness for an owner+provider: connection state, whether a
+   * sync is in progress, last reconcile time, and row count in the ledger.
+   */
+  async getContactsSyncStatus(userId, provider) {
+    return this.http.get("/crm/contacts/sync-status", {
+      // Backend requires snake_case query params (FastAPI `user_id`). Query
+      // keys are sent verbatim by the http layer (only bodies are snake-cased),
+      // so pass snake_case here like every other resource — a camelCase
+      // `userId` 422s with "field required: user_id".
+      params: { user_id: userId, provider }
+    });
+  }
+  /**
+   * Grant a member the right to exclude against an owner's synced CRM ledger
+   * (all providers for that owner). Typically called by the FE on org join.
+   */
+  async grantExclusionGrant(data) {
+    return this.http.post("/crm/exclusion-grants", data);
+  }
+  /**
+   * Revoke a member's access to an owner's CRM exclusion ledger.
+   */
+  async revokeExclusionGrant(data) {
+    return this.http.delete("/crm/exclusion-grants", {
+      body: data
+    });
+  }
+  /**
+   * List CRM owners whose exclusion ledger a member may read (via grants).
+   */
+  async listExclusionGrants(memberUserId) {
+    return this.http.get("/crm/exclusion-grants", {
+      // Backend requires snake_case `member_user_id` (see getContactsSyncStatus).
+      params: { member_user_id: memberUserId }
+    });
+  }
 }
 
 class EmailResource {
@@ -3512,6 +3557,9 @@ class ResponsesResource {
    * @param options - Optional search parameters
    * @param options.limit - Maximum number of results (1-100, default: 20)
    * @param options.dataSources - Specific data sources to use: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+   * @param options.excludeCrmContacts - Exclude people in the acting user's synced CRM ledger; @default true (via request `options`)
+   * @param options.crmExclusionOwners - Granted owner ledgers to exclude against (user id or email)
+   * @param options.crmNameCompanyMatch - Also exclude by exact name+company; @default true
    * @returns Response with structured_response containing:
    *   - candidates: List of person results
    *   - totalFound: Total unique candidates found
@@ -3532,6 +3580,15 @@ class ResponsesResource {
         params.dataSources = options.dataSources;
       if (Object.keys(params).length > 0)
         request.specializedAgentParams = params;
+      const crmOptions = {};
+      if (options.excludeCrmContacts !== void 0)
+        crmOptions.excludeCrmContacts = options.excludeCrmContacts;
+      if (options.crmExclusionOwners)
+        crmOptions.crmExclusionOwners = options.crmExclusionOwners;
+      if (options.crmNameCompanyMatch !== void 0)
+        crmOptions.crmNameCompanyMatch = options.crmNameCompanyMatch;
+      if (Object.keys(crmOptions).length > 0)
+        request.options = crmOptions;
     }
     return this.create(request);
   }
@@ -3553,6 +3610,9 @@ class ResponsesResource {
    * @param options.excludeProfiles - LinkedIn URLs to exclude from results
    * @param options.excludePreviouslyContacted - Exclude previously contacted people
    * @param options.excludeNames - Names to exclude from results
+   * @param options.excludeCrmContacts - Exclude people in the acting user's synced CRM ledger; @default true
+   * @param options.crmExclusionOwners - Granted owner ledgers to exclude against (user id or email)
+   * @param options.crmNameCompanyMatch - Also exclude by exact name+company; @default true
    * @param options.searchJobSignal - CrustData job-listing signal search (decision makers at hiring companies); true | false | 'auto'
    * @param options.deepVerify - Web verification for org/location/third-party criteria: 'auto' (default), 'always', or 'off'
    * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
@@ -3595,6 +3655,12 @@ class ResponsesResource {
         params.excludePreviouslyContacted = options.excludePreviouslyContacted;
       if (options.excludeNames)
         params.excludeNames = options.excludeNames;
+      if (options.excludeCrmContacts !== void 0)
+        params.excludeCrmContacts = options.excludeCrmContacts;
+      if (options.crmExclusionOwners)
+        params.crmExclusionOwners = options.crmExclusionOwners;
+      if (options.crmNameCompanyMatch !== void 0)
+        params.crmNameCompanyMatch = options.crmNameCompanyMatch;
       if (options.searchProfiles !== void 0)
         params.searchProfiles = options.searchProfiles;
       if (options.searchPosts !== void 0)

package/dist/index.d.cts

@@ -1742,6 +1742,26 @@ interface SpecializedAgentParams {
      * Names to exclude from results (passed through to CrustData post-processing when supported).
      */
     excludeNames?: string[];
+    /**
+     * Exclude people already in the acting user's synced CRM (`crm_contacts` ledger;
+     * local lookup only, never a live CRM call). Matches on exact LinkedIn URL and
+     * email; optionally name+company when `crmNameCompanyMatch` is true.
+     * @default true
+     * Used by deep_people_search (via `specializedAgentParams`) and quick_people_search
+     * (via top-level `options` on the create request).
+     */
+    excludeCrmContacts?: boolean;
+    /**
+     * Narrow CRM exclusion to specific granted owners' ledgers (user id or email).
+     * Omitted = the acting user's own CRM only. Ungranted entries are ignored.
+     */
+    crmExclusionOwners?: string[];
+    /**
+     * Within CRM exclusion, also drop candidates matching by exact name + company
+     * (catches CRM contacts with no LinkedIn URL, especially HubSpot).
+     * @default true
+     */
+    crmNameCompanyMatch?: boolean;
     /**
      * Response ID to reuse criteria from.
      */
@@ -2487,6 +2507,12 @@ interface CampaignGuardrails {
      * as a kill-switch.
      */
     customerEditsEnabled?: boolean;
+    /**
+     * When true (default), prospects already in the campaign owner's synced CRM
+     * are skipped at add-time (exact LinkedIn/email) and flagged on name+company.
+     * Set false to disable for this campaign.
+     */
+    excludeCrmContacts?: boolean;
 }
 type ApprovalMode = 'auto' | 'require';
 interface ApprovalSettings {
@@ -2622,6 +2648,8 @@ interface AddProspectsResponse {
     added: number;
     skipped: number;
     warnings: ProspectWarning[];
+    /** Prospects hard-skipped because they exactly matched the owner's CRM ledger. */
+    skippedInCrm?: number;
 }
 interface TransferProspectsRequest {
     /** Campaign to move the prospects into. Must belong to the same user and not be stopped/completed. */
@@ -3172,16 +3200,61 @@ declare class ContactRelationshipsResource {
  *
  * Capability notes:
  * - `attio` supports both email and LinkedIn-URL person search.
- * - `hubspot` only supports email search; LinkedIn URLs are stored as a
- *   custom property on create but are not searchable through the
- *   reconciliation flow.
+ * - `hubspot` reconciles via email and name+company; LinkedIn URLs are
+ *   stored on create but are not directly searchable in live CRM calls.
+ *   The local `crm_contacts` ledger (see contacts sync) improves match-batch
+ *   and search/campaign exclusion without live HubSpot lookups.
  */
 type CrmProvider = 'attio' | 'hubspot';
+/**
+ * Trigger a full mirror of the owner's CRM contact book into the local
+ * `crm_contacts` ledger (used for fast exclusion/matching; not a live CRM call).
+ */
+interface CrmContactsSyncRequest {
+    /** UUID or email of the CRM owner whose connection is synced. */
+    userId: string;
+    provider: CrmProvider;
+}
+interface CrmContactsSyncResponse {
+    /** `started` — sync claimed; `already_in_progress` — another run holds the lock. */
+    status: 'started' | 'already_in_progress';
+    provider: CrmProvider;
+}
+/** Sync freshness for an owner+provider ledger mirror. */
+interface CrmContactsSyncStatusResponse {
+    provider: CrmProvider;
+    connected: boolean;
+    syncInProgress: boolean;
+    lastReconciledAt?: string | null;
+    syncedCount: number;
+    /** Null in v1 — LIST APIs do not return a reliable total. */
+    totalInCrm?: number | null;
+}
+/**
+ * Grant or revoke a member's right to exclude against an owner's CRM ledger.
+ * Per-owner (all of that owner's synced CRMs inherit). Self-grant is a no-op.
+ */
+interface CrmExclusionGrantRequest {
+    /** Member (UUID or email) who reads the owner's exclusion ledger. */
+    memberUserId: string;
+    /** CRM owner (UUID or email) whose ledger is shared. */
+    ownerUserId: string;
+}
+interface CrmExclusionGrantResponse {
+    memberUserId: string;
+    ownerUserId: string;
+    status: 'granted' | 'revoked';
+}
+interface CrmExclusionGrantListResponse {
+    memberUserId: string;
+    ownerUserIds: string[];
+}
 /**
  * Push one Lumnis prospect to the connected CRM.
  *
- * The prospect must already exist in a `campaign_prospects` row owned
- * by `userId`; the linkedin URL is the lookup key.
+ * Prefer a `campaign_prospects` row owned by `userId` when present; otherwise
+ * the server enriches from profile cache / Fiber and creates the CRM record.
+ * Provider-id/URN LinkedIn URLs are resolved to vanity before reconcile.
  */
 interface CrmSyncProspectRequest {
     /** UUID or email of the user whose CRM connection executes the call. */
@@ -3230,7 +3303,8 @@ interface CrmMatchBatchResponse {
 /**
  * Resource for the user-triggered CRM Sync API.
  *
- * Wraps `POST /v1/crm/prospects/sync` and `POST /v1/crm/prospects/match-batch`.
+ * Wraps prospect sync/match, contacts-ledger sync, and exclusion-grant routes
+ * under `/v1/crm`.
  *
  * The user identified by `userId` must already have an active CRM
  * connection (see `client.integrations.initiateConnection`). When the
@@ -3240,8 +3314,9 @@ interface CrmMatchBatchResponse {
  *
  * Failure modes worth handling:
  * - `409 crm_not_connected` — user hasn't connected the provider.
- * - `404 prospect_not_found` (sync only) — no `campaign_prospects` row
- *   matches `linkedinUrl` for this user.
+ * - `404 prospect_not_found` (sync) — profile could not be identified.
+ * - `422 linkedin_url_unresolved` (sync) — internal member-id URL could not
+ *   be resolved to a public vanity URL.
  * - `502 crm_upstream_error` — Attio/HubSpot returned an error.
  * - `503 crm_upstream_rate_limited` — upstream rate-limit; the response
  *   includes a `Retry-After` header.
@@ -3257,6 +3332,9 @@ declare class CrmResource {
      * `crmRecordId`. Stale links (record deleted in the CRM) are detected
      * and re-created automatically.
      *
+     * Works with or without a `campaign_prospects` row — search-sourced
+     * prospects are enriched from profile cache when needed.
+     *
      * @example
      * ```typescript
      * const result = await client.crm.syncProspect({
@@ -3274,16 +3352,13 @@ declare class CrmResource {
      * render a "linked" indicator for the ones that come back true.
      *
      * Layered cache on the server side: persistent positive matches are
-     * served from the `campaign_prospects.crm_record_id` column, negative
-     * results are served from a Redis cache (TTL configured by
-     * `CRM_MATCH_NEGATIVE_CACHE_TTL_SECONDS`). Only the leftover unknowns
-     * fan out to the live CRM, bounded by
+     * served from the `campaign_prospects.crm_record_id` column and the
+     * local `crm_contacts` ledger; negative results are served from a Redis
+     * cache (TTL configured by `CRM_MATCH_NEGATIVE_CACHE_TTL_SECONDS`).
+     * Only the leftover unknowns fan out to the live CRM, bounded by
      * `CRM_MATCH_LIVE_SEARCH_PARALLELISM`.
      *
-     * Note: HubSpot does not expose a LinkedIn-URL search field through
-     * Composio, so for `provider: 'hubspot'` URLs that aren't already in
-     * the persistent cache will always come back `linked: false`. The
-     * sync endpoint still reconciles via email when available.
+     * Provider-id/URN inputs are resolved to vanity before matching.
      *
      * @example
      * ```typescript
@@ -3298,6 +3373,30 @@ declare class CrmResource {
      * ```
      */
     matchBatch(data: CrmMatchBatchRequest): Promise<CrmMatchBatchResponse>;
+    /**
+     * Trigger a full mirror of the owner's CRM contact book into the local
+     * `crm_contacts` ledger. Returns immediately (`202`); poll
+     * {@link getContactsSyncStatus} for progress.
+     */
+    syncContacts(data: CrmContactsSyncRequest): Promise<CrmContactsSyncResponse>;
+    /**
+     * Ledger sync freshness for an owner+provider: connection state, whether a
+     * sync is in progress, last reconcile time, and row count in the ledger.
+     */
+    getContactsSyncStatus(userId: string, provider: CrmProvider): Promise<CrmContactsSyncStatusResponse>;
+    /**
+     * Grant a member the right to exclude against an owner's synced CRM ledger
+     * (all providers for that owner). Typically called by the FE on org join.
+     */
+    grantExclusionGrant(data: CrmExclusionGrantRequest): Promise<CrmExclusionGrantResponse>;
+    /**
+     * Revoke a member's access to an owner's CRM exclusion ledger.
+     */
+    revokeExclusionGrant(data: CrmExclusionGrantRequest): Promise<CrmExclusionGrantResponse>;
+    /**
+     * List CRM owners whose exclusion ledger a member may read (via grants).
+     */
+    listExclusionGrants(memberUserId: string): Promise<CrmExclusionGrantListResponse>;
 }
 
 /**
@@ -5881,6 +5980,9 @@ declare class ResponsesResource {
      * @param options - Optional search parameters
      * @param options.limit - Maximum number of results (1-100, default: 20)
      * @param options.dataSources - Specific data sources to use: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+     * @param options.excludeCrmContacts - Exclude people in the acting user's synced CRM ledger; @default true (via request `options`)
+     * @param options.crmExclusionOwners - Granted owner ledgers to exclude against (user id or email)
+     * @param options.crmNameCompanyMatch - Also exclude by exact name+company; @default true
      * @returns Response with structured_response containing:
      *   - candidates: List of person results
      *   - totalFound: Total unique candidates found
@@ -5891,6 +5993,9 @@ declare class ResponsesResource {
     quickPeopleSearch(query: string, options?: {
         limit?: number;
         dataSources?: string[];
+        excludeCrmContacts?: boolean;
+        crmExclusionOwners?: string[];
+        crmNameCompanyMatch?: boolean;
     }): Promise<CreateResponseResponse>;
     /**
      * Perform a deep people search with AI-generated criteria and validation
@@ -5910,6 +6015,9 @@ declare class ResponsesResource {
      * @param options.excludeProfiles - LinkedIn URLs to exclude from results
      * @param options.excludePreviouslyContacted - Exclude previously contacted people
      * @param options.excludeNames - Names to exclude from results
+     * @param options.excludeCrmContacts - Exclude people in the acting user's synced CRM ledger; @default true
+     * @param options.crmExclusionOwners - Granted owner ledgers to exclude against (user id or email)
+     * @param options.crmNameCompanyMatch - Also exclude by exact name+company; @default true
      * @param options.searchJobSignal - CrustData job-listing signal search (decision makers at hiring companies); true | false | 'auto'
      * @param options.deepVerify - Web verification for org/location/third-party criteria: 'auto' (default), 'always', or 'off'
      * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
@@ -5937,6 +6045,9 @@ declare class ResponsesResource {
         excludeProfiles?: string[];
         excludePreviouslyContacted?: boolean;
         excludeNames?: string[];
+        excludeCrmContacts?: boolean;
+        crmExclusionOwners?: string[];
+        crmNameCompanyMatch?: boolean;
         searchProfiles?: boolean | 'auto';
         searchPosts?: boolean | 'auto';
         includeEngagementInScore?: boolean | 'auto';
@@ -7645,4 +7756,4 @@ declare class ProgressTracker {
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
-export { ACTION_DELAYS, type ActionLimit, type ActiveHours, type AddAndRunCriterionRequest, type AddCriterionRequest, type AddOrgMemberRequest, type AddOrgMemberResponse, type AddPersonaRequest, type AddPersonaResponse, type AddProspectsRequest, type AddProspectsResponse, type AgentConfig, type AgentCostStats, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type ApprovalActionRequest, type ApprovalItem, type ApprovalListResponse, type ApprovalMode, type ApprovalResponse, type ApprovalSettings, type ApprovalStatus, type ApprovalsParams, type ApprovalsRequestItem, type ApprovalsResponseItem, type ApproveStepRequest, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftJobProgress, type BatchDraftJobResponse, type BatchDraftJobStartedData, type BatchDraftJobStatusResponse, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, type BatchExecutionInclude, type BatchExecutionRequest, type BatchExecutionResponse, BatchJobStatus, type BatchPollRequest, type BatchPollResponse, type BatchProspectIdentifier, type BatchRequestItem, type BatchRequestType, type BatchResponseItem, type BatchSendRequest, type BatchSendResponse, type BatchStepMetric, type BillingStatus, type BulkApprovalAction, type BulkApprovalFailure, type BulkApprovalRequest, type BulkApprovalResponse, type BulkCompleteFailure, type BulkCompleteRequest, type BulkCompleteResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkOperationRequest, type BulkOperationResponse, type BulkUploadResponse, CONTENT_LIMITS, CONTENT_LIMITS_MAP, type CampaignActionListResponse, type CampaignActionResponse, type CampaignActionStatus, type CampaignActionType, type CampaignBulkApprovalAction, type CampaignBulkApprovalItem, type CampaignBulkApprovalRequest, type CampaignBulkApprovalResponse, type CampaignBulkApprovalResult, type CampaignCreate, type CampaignGuardrails, type CampaignListResponse, type CampaignMetricsResponse, type CampaignOutcomeType, type CampaignProspectDetailResponse, type CampaignProspectInput, type CampaignProspectResponse, type CampaignProspectState, type CampaignResponse, type CampaignStatus, type CampaignUpdate, CampaignsResource, type CancelDraftResponse, type CancelQueuedRequest, type CancelResponseResponse, type Channel, type ChannelContactHistory, type ChannelFunnel, type ChannelRatios, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type CompetitorPostEngagementOutput, type CompetitorRepEngagementOutput, type CompleteExecutionRequest, type CompleteExecutionResponse, type ConnectInboxRequest, type ConnectInboxResponse, type Connection, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ConnectionsResponse, type ConnectionsSyncStatus, type ContactDetailsInput, type ContactEnrichPersonInput, type ContactEnrichPersonResult, type ContactEnrichRequest, type ContactEnrichResponse, type ContactFinding, type ContactHistorySyncStatus, type ContactRelationshipProvider, type ContactRelationshipResponse, type ContactRelationshipStatus, ContactRelationshipsResource, type ContactScore, type ContentLimit, type ContentSource, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type CriteriaClassification, type CriteriaMetadata, type CriterionDefinition, type CriterionResult, type CriterionType, type CrmMatchBatchRequest, type CrmMatchBatchResponse, type CrmMatchedProspect, type CrmProvider, CrmResource, type CrmSyncProspectRequest, type CrmSyncProspectResponse, DAILY_INMAIL_LIMITS, DEFAULT_SUBSCRIPTION_TYPE, type DatabaseStatus, type DeepPeopleSearchOutput, type DeepSearchPreview, type DeepSearchStats, type DeleteApiKeyResponse, type DeleteConnectionsResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DiscoveryTrace, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type DuplicateTemplateRequest, type EditQueuedRequest, type Email, type EmailAction, type EmailInboxItem, type EmailInboxListResponse, type EmailInboxPersona, type EmailOnboardRequest, type EmailOnboardResponse, type EmailOnboardStatusResponse, type EmailOrgHealthResponse, type EmailOrgListResponse, type EmailOrgSettingsResponse, type EmailOrgSettingsUpdate, type EmailOrgSummary, EmailResource, type EmailSenderPersona, type EmailThreadSummary, type EngagementStatus, type EngagementStatusData, type EngagementStatusRequest, type EngagementStatusResponse, EnrichmentResource, type ErrorDetail, type ErrorResponse, type ErrorResponseItem, type EvidenceSource, type ExecutionDetailResponse, type ExecutionEvent, type ExecutionEventData, type ExecutionListResponse, type ExecutionMetricsOptions, type ExecutionMetricsResponse, type ExecutionStatus, type ExecutionSummary, type ExecutionSummaryExtended, type ExecutionsParams, type ExecutionsRequestItem, type ExecutionsResponseItem, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type FilterLogic, type FilterValue, type FunnelStage, type GetConnectionStatusParams, type GetContactRelationshipsOptions, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InboxKind, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, type IntentSignal, InternalServerError, LINKEDIN_LIMITS, type LifecycleOperationRequest, type LifecycleOperationResponse, type LinkAssetsRequest, type LinkedAssetsResponse, type LinkedInAccountInfoResponse, type LinkedInAccountRateLimits, type LinkedInAccountRateLimitsResponse, type LinkedInAccountRateLimitsUpdate, type LinkedInAction, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type LinkedInSyncStatusResponse, type ListAcceptedConnectionsParams, type ListApprovalsOptions, type ListAssetsOptions, type ListCampaignActionsOptions, type ListCampaignProspectsOptions, type ListCampaignsOptions, type ListConnectionsParams, type ListExecutionsOptions, type ListInboxesParams, type ListPendingApprovalsOptions, type ListPlaybooksOptions, type ListProvidersResponse, type ListStepExecutionsOptions, type ListTemplatesOptions, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type MailboxUpdateRequest, type MailboxUpdateResponse, type Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type MetricsParams, type MetricsRequestItem, type MetricsResponseItem, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, type OnFailure, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PlaybookCreate, type PlaybookGenerateJobResponse, type PlaybookGenerateJobStatusResponse, type PlaybookGenerateRequest, type PlaybookResponse, type PlaybookUpdate, type PlaybookVersionResponse, type PostEngagementData, type PostEngagementProvenance, type PostEngagementType, type PostPreviewRequest, type PostPreviewResponse, type PostPreviewResult, type PostsDateRange, type PostsSearchStats, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProjectApprovalsData, type ProjectExecutionsData, type ProjectMetricsData, type ProspectConnectionCheck, type ProspectInfo, type ProspectInput, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, type ProspectWarning, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, type RateLimitData, RateLimitError, type RateLimitErrorOptions, type RateLimitInfo$1 as RateLimitInfo, type RateLimitStatusResponse, type RateLimitsParams, type RateLimitsRequestItem, type RateLimitsResponseItem, type RecordOutcomeRequest, type RejectActionRequest, type RejectStepRequest, type RelevanceTier, type RemoveOrgMemberResponse, type RepEngagementData, type RepEngagementStats, type ReplySentiment, type ResolvedCompetitorTarget, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, SEQUENCE_RATE_LIMITS, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, type SenderPersonaInput, type SequenceAction, type SequenceApprovalNeededData, type SequenceChannel, type SequenceEventType, type SequenceExecutionCompletedData, type SequenceExecutionFailedData, type SequenceRateLimitAction, type SequenceStepCompletedData, type SequenceTemplateCreate, type SequenceTemplateResponse, type SequenceTemplateUpdate, SequencesResource, SharePermission, type SkillAnalyticsRequest, type SkillEffectivenessMetrics, type SkillGuidelineBase, type SkillGuidelineCreate, type SkillGuidelineListResponse, type SkillGuidelineResponse, type SkillGuidelineUpdate, type SkillRetrievalMetadata, type SkillUsageBase, type SkillUsageCreate, type SkillUsageListResponse, type SkillUsageResponse, type SkillUsageUpdate, SkillsResource, type SkipActionRequest, type SkipStepRequest, type SkipStepResponse, type SkippedProspect, type SkippedTransferProspect, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type Stage, type StageFilter, type StartExecutionRequest, type StartExecutionResponse, type StepConfig, type StepExecutionItem, type StepExecutionListResponse, type StepExecutionStatus, type StepHistoryEntry, type StepMetric, type StoppedBreakdown, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, SyncPhaseStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TransferProspectsRequest, type TransferProspectsResponse, type TransferSkipReason, type TransitionCondition, type TransitionConditionOperator, type TransitionConditionType, type TransitionConfig, type TransitionEventParams, type TriggerSyncResponse, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdatePersonaRequest, type UpdatePersonaResponse, type UpdateStepExecutionRequest, type UpdateStepExecutionResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, VALID_EVENT_TYPES, type ValidatedCandidate, ValidationError, type ValidationIssue, type ValidationResponse, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getContentLimit, getDailyInmailLimit, getDefaultDailyLimits, getInmailAllowance, getLimits, getMessageLimit, getRateLimit, hasOpenProfileMessages, isRecruiterSubscription, normalizeAction, verifyWebhookSignature };
+export { ACTION_DELAYS, type ActionLimit, type ActiveHours, type AddAndRunCriterionRequest, type AddCriterionRequest, type AddOrgMemberRequest, type AddOrgMemberResponse, type AddPersonaRequest, type AddPersonaResponse, type AddProspectsRequest, type AddProspectsResponse, type AgentConfig, type AgentCostStats, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type ApprovalActionRequest, type ApprovalItem, type ApprovalListResponse, type ApprovalMode, type ApprovalResponse, type ApprovalSettings, type ApprovalStatus, type ApprovalsParams, type ApprovalsRequestItem, type ApprovalsResponseItem, type ApproveStepRequest, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftJobProgress, type BatchDraftJobResponse, type BatchDraftJobStartedData, type BatchDraftJobStatusResponse, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, type BatchExecutionInclude, type BatchExecutionRequest, type BatchExecutionResponse, BatchJobStatus, type BatchPollRequest, type BatchPollResponse, type BatchProspectIdentifier, type BatchRequestItem, type BatchRequestType, type BatchResponseItem, type BatchSendRequest, type BatchSendResponse, type BatchStepMetric, type BillingStatus, type BulkApprovalAction, type BulkApprovalFailure, type BulkApprovalRequest, type BulkApprovalResponse, type BulkCompleteFailure, type BulkCompleteRequest, type BulkCompleteResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkOperationRequest, type BulkOperationResponse, type BulkUploadResponse, CONTENT_LIMITS, CONTENT_LIMITS_MAP, type CampaignActionListResponse, type CampaignActionResponse, type CampaignActionStatus, type CampaignActionType, type CampaignBulkApprovalAction, type CampaignBulkApprovalItem, type CampaignBulkApprovalRequest, type CampaignBulkApprovalResponse, type CampaignBulkApprovalResult, type CampaignCreate, type CampaignGuardrails, type CampaignListResponse, type CampaignMetricsResponse, type CampaignOutcomeType, type CampaignProspectDetailResponse, type CampaignProspectInput, type CampaignProspectResponse, type CampaignProspectState, type CampaignResponse, type CampaignStatus, type CampaignUpdate, CampaignsResource, type CancelDraftResponse, type CancelQueuedRequest, type CancelResponseResponse, type Channel, type ChannelContactHistory, type ChannelFunnel, type ChannelRatios, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type CompetitorPostEngagementOutput, type CompetitorRepEngagementOutput, type CompleteExecutionRequest, type CompleteExecutionResponse, type ConnectInboxRequest, type ConnectInboxResponse, type Connection, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ConnectionsResponse, type ConnectionsSyncStatus, type ContactDetailsInput, type ContactEnrichPersonInput, type ContactEnrichPersonResult, type ContactEnrichRequest, type ContactEnrichResponse, type ContactFinding, type ContactHistorySyncStatus, type ContactRelationshipProvider, type ContactRelationshipResponse, type ContactRelationshipStatus, ContactRelationshipsResource, type ContactScore, type ContentLimit, type ContentSource, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type CriteriaClassification, type CriteriaMetadata, type CriterionDefinition, type CriterionResult, type CriterionType, type CrmContactsSyncRequest, type CrmContactsSyncResponse, type CrmContactsSyncStatusResponse, type CrmExclusionGrantListResponse, type CrmExclusionGrantRequest, type CrmExclusionGrantResponse, type CrmMatchBatchRequest, type CrmMatchBatchResponse, type CrmMatchedProspect, type CrmProvider, CrmResource, type CrmSyncProspectRequest, type CrmSyncProspectResponse, DAILY_INMAIL_LIMITS, DEFAULT_SUBSCRIPTION_TYPE, type DatabaseStatus, type DeepPeopleSearchOutput, type DeepSearchPreview, type DeepSearchStats, type DeleteApiKeyResponse, type DeleteConnectionsResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DiscoveryTrace, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type DuplicateTemplateRequest, type EditQueuedRequest, type Email, type EmailAction, type EmailInboxItem, type EmailInboxListResponse, type EmailInboxPersona, type EmailOnboardRequest, type EmailOnboardResponse, type EmailOnboardStatusResponse, type EmailOrgHealthResponse, type EmailOrgListResponse, type EmailOrgSettingsResponse, type EmailOrgSettingsUpdate, type EmailOrgSummary, EmailResource, type EmailSenderPersona, type EmailThreadSummary, type EngagementStatus, type EngagementStatusData, type EngagementStatusRequest, type EngagementStatusResponse, EnrichmentResource, type ErrorDetail, type ErrorResponse, type ErrorResponseItem, type EvidenceSource, type ExecutionDetailResponse, type ExecutionEvent, type ExecutionEventData, type ExecutionListResponse, type ExecutionMetricsOptions, type ExecutionMetricsResponse, type ExecutionStatus, type ExecutionSummary, type ExecutionSummaryExtended, type ExecutionsParams, type ExecutionsRequestItem, type ExecutionsResponseItem, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type FilterLogic, type FilterValue, type FunnelStage, type GetConnectionStatusParams, type GetContactRelationshipsOptions, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InboxKind, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, type IntentSignal, InternalServerError, LINKEDIN_LIMITS, type LifecycleOperationRequest, type LifecycleOperationResponse, type LinkAssetsRequest, type LinkedAssetsResponse, type LinkedInAccountInfoResponse, type LinkedInAccountRateLimits, type LinkedInAccountRateLimitsResponse, type LinkedInAccountRateLimitsUpdate, type LinkedInAction, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type LinkedInSyncStatusResponse, type ListAcceptedConnectionsParams, type ListApprovalsOptions, type ListAssetsOptions, type ListCampaignActionsOptions, type ListCampaignProspectsOptions, type ListCampaignsOptions, type ListConnectionsParams, type ListExecutionsOptions, type ListInboxesParams, type ListPendingApprovalsOptions, type ListPlaybooksOptions, type ListProvidersResponse, type ListStepExecutionsOptions, type ListTemplatesOptions, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type MailboxUpdateRequest, type MailboxUpdateResponse, type Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type MetricsParams, type MetricsRequestItem, type MetricsResponseItem, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, type OnFailure, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PlaybookCreate, type PlaybookGenerateJobResponse, type PlaybookGenerateJobStatusResponse, type PlaybookGenerateRequest, type PlaybookResponse, type PlaybookUpdate, type PlaybookVersionResponse, type PostEngagementData, type PostEngagementProvenance, type PostEngagementType, type PostPreviewRequest, type PostPreviewResponse, type PostPreviewResult, type PostsDateRange, type PostsSearchStats, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProjectApprovalsData, type ProjectExecutionsData, type ProjectMetricsData, type ProspectConnectionCheck, type ProspectInfo, type ProspectInput, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, type ProspectWarning, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, type RateLimitData, RateLimitError, type RateLimitErrorOptions, type RateLimitInfo$1 as RateLimitInfo, type RateLimitStatusResponse, type RateLimitsParams, type RateLimitsRequestItem, type RateLimitsResponseItem, type RecordOutcomeRequest, type RejectActionRequest, type RejectStepRequest, type RelevanceTier, type RemoveOrgMemberResponse, type RepEngagementData, type RepEngagementStats, type ReplySentiment, type ResolvedCompetitorTarget, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, SEQUENCE_RATE_LIMITS, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, type SenderPersonaInput, type SequenceAction, type SequenceApprovalNeededData, type SequenceChannel, type SequenceEventType, type SequenceExecutionCompletedData, type SequenceExecutionFailedData, type SequenceRateLimitAction, type SequenceStepCompletedData, type SequenceTemplateCreate, type SequenceTemplateResponse, type SequenceTemplateUpdate, SequencesResource, SharePermission, type SkillAnalyticsRequest, type SkillEffectivenessMetrics, type SkillGuidelineBase, type SkillGuidelineCreate, type SkillGuidelineListResponse, type SkillGuidelineResponse, type SkillGuidelineUpdate, type SkillRetrievalMetadata, type SkillUsageBase, type SkillUsageCreate, type SkillUsageListResponse, type SkillUsageResponse, type SkillUsageUpdate, SkillsResource, type SkipActionRequest, type SkipStepRequest, type SkipStepResponse, type SkippedProspect, type SkippedTransferProspect, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type Stage, type StageFilter, type StartExecutionRequest, type StartExecutionResponse, type StepConfig, type StepExecutionItem, type StepExecutionListResponse, type StepExecutionStatus, type StepHistoryEntry, type StepMetric, type StoppedBreakdown, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, SyncPhaseStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TransferProspectsRequest, type TransferProspectsResponse, type TransferSkipReason, type TransitionCondition, type TransitionConditionOperator, type TransitionConditionType, type TransitionConfig, type TransitionEventParams, type TriggerSyncResponse, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdatePersonaRequest, type UpdatePersonaResponse, type UpdateStepExecutionRequest, type UpdateStepExecutionResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, VALID_EVENT_TYPES, type ValidatedCandidate, ValidationError, type ValidationIssue, type ValidationResponse, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getContentLimit, getDailyInmailLimit, getDefaultDailyLimits, getInmailAllowance, getLimits, getMessageLimit, getRateLimit, hasOpenProfileMessages, isRecruiterSubscription, normalizeAction, verifyWebhookSignature };

package/dist/index.d.mts

@@ -1742,6 +1742,26 @@ interface SpecializedAgentParams {
      * Names to exclude from results (passed through to CrustData post-processing when supported).
      */
     excludeNames?: string[];
+    /**
+     * Exclude people already in the acting user's synced CRM (`crm_contacts` ledger;
+     * local lookup only, never a live CRM call). Matches on exact LinkedIn URL and
+     * email; optionally name+company when `crmNameCompanyMatch` is true.
+     * @default true
+     * Used by deep_people_search (via `specializedAgentParams`) and quick_people_search
+     * (via top-level `options` on the create request).
+     */
+    excludeCrmContacts?: boolean;
+    /**
+     * Narrow CRM exclusion to specific granted owners' ledgers (user id or email).
+     * Omitted = the acting user's own CRM only. Ungranted entries are ignored.
+     */
+    crmExclusionOwners?: string[];
+    /**
+     * Within CRM exclusion, also drop candidates matching by exact name + company
+     * (catches CRM contacts with no LinkedIn URL, especially HubSpot).
+     * @default true
+     */
+    crmNameCompanyMatch?: boolean;
     /**
      * Response ID to reuse criteria from.
      */
@@ -2487,6 +2507,12 @@ interface CampaignGuardrails {
      * as a kill-switch.
      */
     customerEditsEnabled?: boolean;
+    /**
+     * When true (default), prospects already in the campaign owner's synced CRM
+     * are skipped at add-time (exact LinkedIn/email) and flagged on name+company.
+     * Set false to disable for this campaign.
+     */
+    excludeCrmContacts?: boolean;
 }
 type ApprovalMode = 'auto' | 'require';
 interface ApprovalSettings {
@@ -2622,6 +2648,8 @@ interface AddProspectsResponse {
     added: number;
     skipped: number;
     warnings: ProspectWarning[];
+    /** Prospects hard-skipped because they exactly matched the owner's CRM ledger. */
+    skippedInCrm?: number;
 }
 interface TransferProspectsRequest {
     /** Campaign to move the prospects into. Must belong to the same user and not be stopped/completed. */
@@ -3172,16 +3200,61 @@ declare class ContactRelationshipsResource {
  *
  * Capability notes:
  * - `attio` supports both email and LinkedIn-URL person search.
- * - `hubspot` only supports email search; LinkedIn URLs are stored as a
- *   custom property on create but are not searchable through the
- *   reconciliation flow.
+ * - `hubspot` reconciles via email and name+company; LinkedIn URLs are
+ *   stored on create but are not directly searchable in live CRM calls.
+ *   The local `crm_contacts` ledger (see contacts sync) improves match-batch
+ *   and search/campaign exclusion without live HubSpot lookups.
  */
 type CrmProvider = 'attio' | 'hubspot';
+/**
+ * Trigger a full mirror of the owner's CRM contact book into the local
+ * `crm_contacts` ledger (used for fast exclusion/matching; not a live CRM call).
+ */
+interface CrmContactsSyncRequest {
+    /** UUID or email of the CRM owner whose connection is synced. */
+    userId: string;
+    provider: CrmProvider;
+}
+interface CrmContactsSyncResponse {
+    /** `started` — sync claimed; `already_in_progress` — another run holds the lock. */
+    status: 'started' | 'already_in_progress';
+    provider: CrmProvider;
+}
+/** Sync freshness for an owner+provider ledger mirror. */
+interface CrmContactsSyncStatusResponse {
+    provider: CrmProvider;
+    connected: boolean;
+    syncInProgress: boolean;
+    lastReconciledAt?: string | null;
+    syncedCount: number;
+    /** Null in v1 — LIST APIs do not return a reliable total. */
+    totalInCrm?: number | null;
+}
+/**
+ * Grant or revoke a member's right to exclude against an owner's CRM ledger.
+ * Per-owner (all of that owner's synced CRMs inherit). Self-grant is a no-op.
+ */
+interface CrmExclusionGrantRequest {
+    /** Member (UUID or email) who reads the owner's exclusion ledger. */
+    memberUserId: string;
+    /** CRM owner (UUID or email) whose ledger is shared. */
+    ownerUserId: string;
+}
+interface CrmExclusionGrantResponse {
+    memberUserId: string;
+    ownerUserId: string;
+    status: 'granted' | 'revoked';
+}
+interface CrmExclusionGrantListResponse {
+    memberUserId: string;
+    ownerUserIds: string[];
+}
 /**
  * Push one Lumnis prospect to the connected CRM.
  *
- * The prospect must already exist in a `campaign_prospects` row owned
- * by `userId`; the linkedin URL is the lookup key.
+ * Prefer a `campaign_prospects` row owned by `userId` when present; otherwise
+ * the server enriches from profile cache / Fiber and creates the CRM record.
+ * Provider-id/URN LinkedIn URLs are resolved to vanity before reconcile.
  */
 interface CrmSyncProspectRequest {
     /** UUID or email of the user whose CRM connection executes the call. */
@@ -3230,7 +3303,8 @@ interface CrmMatchBatchResponse {
 /**
  * Resource for the user-triggered CRM Sync API.
  *
- * Wraps `POST /v1/crm/prospects/sync` and `POST /v1/crm/prospects/match-batch`.
+ * Wraps prospect sync/match, contacts-ledger sync, and exclusion-grant routes
+ * under `/v1/crm`.
  *
  * The user identified by `userId` must already have an active CRM
  * connection (see `client.integrations.initiateConnection`). When the
@@ -3240,8 +3314,9 @@ interface CrmMatchBatchResponse {
  *
  * Failure modes worth handling:
  * - `409 crm_not_connected` — user hasn't connected the provider.
- * - `404 prospect_not_found` (sync only) — no `campaign_prospects` row
- *   matches `linkedinUrl` for this user.
+ * - `404 prospect_not_found` (sync) — profile could not be identified.
+ * - `422 linkedin_url_unresolved` (sync) — internal member-id URL could not
+ *   be resolved to a public vanity URL.
  * - `502 crm_upstream_error` — Attio/HubSpot returned an error.
  * - `503 crm_upstream_rate_limited` — upstream rate-limit; the response
  *   includes a `Retry-After` header.
@@ -3257,6 +3332,9 @@ declare class CrmResource {
      * `crmRecordId`. Stale links (record deleted in the CRM) are detected
      * and re-created automatically.
      *
+     * Works with or without a `campaign_prospects` row — search-sourced
+     * prospects are enriched from profile cache when needed.
+     *
      * @example
      * ```typescript
      * const result = await client.crm.syncProspect({
@@ -3274,16 +3352,13 @@ declare class CrmResource {
      * render a "linked" indicator for the ones that come back true.
      *
      * Layered cache on the server side: persistent positive matches are
-     * served from the `campaign_prospects.crm_record_id` column, negative
-     * results are served from a Redis cache (TTL configured by
-     * `CRM_MATCH_NEGATIVE_CACHE_TTL_SECONDS`). Only the leftover unknowns
-     * fan out to the live CRM, bounded by
+     * served from the `campaign_prospects.crm_record_id` column and the
+     * local `crm_contacts` ledger; negative results are served from a Redis
+     * cache (TTL configured by `CRM_MATCH_NEGATIVE_CACHE_TTL_SECONDS`).
+     * Only the leftover unknowns fan out to the live CRM, bounded by
      * `CRM_MATCH_LIVE_SEARCH_PARALLELISM`.
      *
-     * Note: HubSpot does not expose a LinkedIn-URL search field through
-     * Composio, so for `provider: 'hubspot'` URLs that aren't already in
-     * the persistent cache will always come back `linked: false`. The
-     * sync endpoint still reconciles via email when available.
+     * Provider-id/URN inputs are resolved to vanity before matching.
      *
      * @example
      * ```typescript
@@ -3298,6 +3373,30 @@ declare class CrmResource {
      * ```
      */
     matchBatch(data: CrmMatchBatchRequest): Promise<CrmMatchBatchResponse>;
+    /**
+     * Trigger a full mirror of the owner's CRM contact book into the local
+     * `crm_contacts` ledger. Returns immediately (`202`); poll
+     * {@link getContactsSyncStatus} for progress.
+     */
+    syncContacts(data: CrmContactsSyncRequest): Promise<CrmContactsSyncResponse>;
+    /**
+     * Ledger sync freshness for an owner+provider: connection state, whether a
+     * sync is in progress, last reconcile time, and row count in the ledger.
+     */
+    getContactsSyncStatus(userId: string, provider: CrmProvider): Promise<CrmContactsSyncStatusResponse>;
+    /**
+     * Grant a member the right to exclude against an owner's synced CRM ledger
+     * (all providers for that owner). Typically called by the FE on org join.
+     */
+    grantExclusionGrant(data: CrmExclusionGrantRequest): Promise<CrmExclusionGrantResponse>;
+    /**
+     * Revoke a member's access to an owner's CRM exclusion ledger.
+     */
+    revokeExclusionGrant(data: CrmExclusionGrantRequest): Promise<CrmExclusionGrantResponse>;
+    /**
+     * List CRM owners whose exclusion ledger a member may read (via grants).
+     */
+    listExclusionGrants(memberUserId: string): Promise<CrmExclusionGrantListResponse>;
 }
 
 /**
@@ -5881,6 +5980,9 @@ declare class ResponsesResource {
      * @param options - Optional search parameters
      * @param options.limit - Maximum number of results (1-100, default: 20)
      * @param options.dataSources - Specific data sources to use: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+     * @param options.excludeCrmContacts - Exclude people in the acting user's synced CRM ledger; @default true (via request `options`)
+     * @param options.crmExclusionOwners - Granted owner ledgers to exclude against (user id or email)
+     * @param options.crmNameCompanyMatch - Also exclude by exact name+company; @default true
      * @returns Response with structured_response containing:
      *   - candidates: List of person results
      *   - totalFound: Total unique candidates found
@@ -5891,6 +5993,9 @@ declare class ResponsesResource {
     quickPeopleSearch(query: string, options?: {
         limit?: number;
         dataSources?: string[];
+        excludeCrmContacts?: boolean;
+        crmExclusionOwners?: string[];
+        crmNameCompanyMatch?: boolean;
     }): Promise<CreateResponseResponse>;
     /**
      * Perform a deep people search with AI-generated criteria and validation
@@ -5910,6 +6015,9 @@ declare class ResponsesResource {
      * @param options.excludeProfiles - LinkedIn URLs to exclude from results
      * @param options.excludePreviouslyContacted - Exclude previously contacted people
      * @param options.excludeNames - Names to exclude from results
+     * @param options.excludeCrmContacts - Exclude people in the acting user's synced CRM ledger; @default true
+     * @param options.crmExclusionOwners - Granted owner ledgers to exclude against (user id or email)
+     * @param options.crmNameCompanyMatch - Also exclude by exact name+company; @default true
      * @param options.searchJobSignal - CrustData job-listing signal search (decision makers at hiring companies); true | false | 'auto'
      * @param options.deepVerify - Web verification for org/location/third-party criteria: 'auto' (default), 'always', or 'off'
      * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
@@ -5937,6 +6045,9 @@ declare class ResponsesResource {
         excludeProfiles?: string[];
         excludePreviouslyContacted?: boolean;
         excludeNames?: string[];
+        excludeCrmContacts?: boolean;
+        crmExclusionOwners?: string[];
+        crmNameCompanyMatch?: boolean;
         searchProfiles?: boolean | 'auto';
         searchPosts?: boolean | 'auto';
         includeEngagementInScore?: boolean | 'auto';
@@ -7645,4 +7756,4 @@ declare class ProgressTracker {
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
-export { ACTION_DELAYS, type ActionLimit, type ActiveHours, type AddAndRunCriterionRequest, type AddCriterionRequest, type AddOrgMemberRequest, type AddOrgMemberResponse, type AddPersonaRequest, type AddPersonaResponse, type AddProspectsRequest, type AddProspectsResponse, type AgentConfig, type AgentCostStats, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type ApprovalActionRequest, type ApprovalItem, type ApprovalListResponse, type ApprovalMode, type ApprovalResponse, type ApprovalSettings, type ApprovalStatus, type ApprovalsParams, type ApprovalsRequestItem, type ApprovalsResponseItem, type ApproveStepRequest, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftJobProgress, type BatchDraftJobResponse, type BatchDraftJobStartedData, type BatchDraftJobStatusResponse, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, type BatchExecutionInclude, type BatchExecutionRequest, type BatchExecutionResponse, BatchJobStatus, type BatchPollRequest, type BatchPollResponse, type BatchProspectIdentifier, type BatchRequestItem, type BatchRequestType, type BatchResponseItem, type BatchSendRequest, type BatchSendResponse, type BatchStepMetric, type BillingStatus, type BulkApprovalAction, type BulkApprovalFailure, type BulkApprovalRequest, type BulkApprovalResponse, type BulkCompleteFailure, type BulkCompleteRequest, type BulkCompleteResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkOperationRequest, type BulkOperationResponse, type BulkUploadResponse, CONTENT_LIMITS, CONTENT_LIMITS_MAP, type CampaignActionListResponse, type CampaignActionResponse, type CampaignActionStatus, type CampaignActionType, type CampaignBulkApprovalAction, type CampaignBulkApprovalItem, type CampaignBulkApprovalRequest, type CampaignBulkApprovalResponse, type CampaignBulkApprovalResult, type CampaignCreate, type CampaignGuardrails, type CampaignListResponse, type CampaignMetricsResponse, type CampaignOutcomeType, type CampaignProspectDetailResponse, type CampaignProspectInput, type CampaignProspectResponse, type CampaignProspectState, type CampaignResponse, type CampaignStatus, type CampaignUpdate, CampaignsResource, type CancelDraftResponse, type CancelQueuedRequest, type CancelResponseResponse, type Channel, type ChannelContactHistory, type ChannelFunnel, type ChannelRatios, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type CompetitorPostEngagementOutput, type CompetitorRepEngagementOutput, type CompleteExecutionRequest, type CompleteExecutionResponse, type ConnectInboxRequest, type ConnectInboxResponse, type Connection, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ConnectionsResponse, type ConnectionsSyncStatus, type ContactDetailsInput, type ContactEnrichPersonInput, type ContactEnrichPersonResult, type ContactEnrichRequest, type ContactEnrichResponse, type ContactFinding, type ContactHistorySyncStatus, type ContactRelationshipProvider, type ContactRelationshipResponse, type ContactRelationshipStatus, ContactRelationshipsResource, type ContactScore, type ContentLimit, type ContentSource, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type CriteriaClassification, type CriteriaMetadata, type CriterionDefinition, type CriterionResult, type CriterionType, type CrmMatchBatchRequest, type CrmMatchBatchResponse, type CrmMatchedProspect, type CrmProvider, CrmResource, type CrmSyncProspectRequest, type CrmSyncProspectResponse, DAILY_INMAIL_LIMITS, DEFAULT_SUBSCRIPTION_TYPE, type DatabaseStatus, type DeepPeopleSearchOutput, type DeepSearchPreview, type DeepSearchStats, type DeleteApiKeyResponse, type DeleteConnectionsResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DiscoveryTrace, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type DuplicateTemplateRequest, type EditQueuedRequest, type Email, type EmailAction, type EmailInboxItem, type EmailInboxListResponse, type EmailInboxPersona, type EmailOnboardRequest, type EmailOnboardResponse, type EmailOnboardStatusResponse, type EmailOrgHealthResponse, type EmailOrgListResponse, type EmailOrgSettingsResponse, type EmailOrgSettingsUpdate, type EmailOrgSummary, EmailResource, type EmailSenderPersona, type EmailThreadSummary, type EngagementStatus, type EngagementStatusData, type EngagementStatusRequest, type EngagementStatusResponse, EnrichmentResource, type ErrorDetail, type ErrorResponse, type ErrorResponseItem, type EvidenceSource, type ExecutionDetailResponse, type ExecutionEvent, type ExecutionEventData, type ExecutionListResponse, type ExecutionMetricsOptions, type ExecutionMetricsResponse, type ExecutionStatus, type ExecutionSummary, type ExecutionSummaryExtended, type ExecutionsParams, type ExecutionsRequestItem, type ExecutionsResponseItem, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type FilterLogic, type FilterValue, type FunnelStage, type GetConnectionStatusParams, type GetContactRelationshipsOptions, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InboxKind, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, type IntentSignal, InternalServerError, LINKEDIN_LIMITS, type LifecycleOperationRequest, type LifecycleOperationResponse, type LinkAssetsRequest, type LinkedAssetsResponse, type LinkedInAccountInfoResponse, type LinkedInAccountRateLimits, type LinkedInAccountRateLimitsResponse, type LinkedInAccountRateLimitsUpdate, type LinkedInAction, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type LinkedInSyncStatusResponse, type ListAcceptedConnectionsParams, type ListApprovalsOptions, type ListAssetsOptions, type ListCampaignActionsOptions, type ListCampaignProspectsOptions, type ListCampaignsOptions, type ListConnectionsParams, type ListExecutionsOptions, type ListInboxesParams, type ListPendingApprovalsOptions, type ListPlaybooksOptions, type ListProvidersResponse, type ListStepExecutionsOptions, type ListTemplatesOptions, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type MailboxUpdateRequest, type MailboxUpdateResponse, type Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type MetricsParams, type MetricsRequestItem, type MetricsResponseItem, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, type OnFailure, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PlaybookCreate, type PlaybookGenerateJobResponse, type PlaybookGenerateJobStatusResponse, type PlaybookGenerateRequest, type PlaybookResponse, type PlaybookUpdate, type PlaybookVersionResponse, type PostEngagementData, type PostEngagementProvenance, type PostEngagementType, type PostPreviewRequest, type PostPreviewResponse, type PostPreviewResult, type PostsDateRange, type PostsSearchStats, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProjectApprovalsData, type ProjectExecutionsData, type ProjectMetricsData, type ProspectConnectionCheck, type ProspectInfo, type ProspectInput, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, type ProspectWarning, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, type RateLimitData, RateLimitError, type RateLimitErrorOptions, type RateLimitInfo$1 as RateLimitInfo, type RateLimitStatusResponse, type RateLimitsParams, type RateLimitsRequestItem, type RateLimitsResponseItem, type RecordOutcomeRequest, type RejectActionRequest, type RejectStepRequest, type RelevanceTier, type RemoveOrgMemberResponse, type RepEngagementData, type RepEngagementStats, type ReplySentiment, type ResolvedCompetitorTarget, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, SEQUENCE_RATE_LIMITS, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, type SenderPersonaInput, type SequenceAction, type SequenceApprovalNeededData, type SequenceChannel, type SequenceEventType, type SequenceExecutionCompletedData, type SequenceExecutionFailedData, type SequenceRateLimitAction, type SequenceStepCompletedData, type SequenceTemplateCreate, type SequenceTemplateResponse, type SequenceTemplateUpdate, SequencesResource, SharePermission, type SkillAnalyticsRequest, type SkillEffectivenessMetrics, type SkillGuidelineBase, type SkillGuidelineCreate, type SkillGuidelineListResponse, type SkillGuidelineResponse, type SkillGuidelineUpdate, type SkillRetrievalMetadata, type SkillUsageBase, type SkillUsageCreate, type SkillUsageListResponse, type SkillUsageResponse, type SkillUsageUpdate, SkillsResource, type SkipActionRequest, type SkipStepRequest, type SkipStepResponse, type SkippedProspect, type SkippedTransferProspect, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type Stage, type StageFilter, type StartExecutionRequest, type StartExecutionResponse, type StepConfig, type StepExecutionItem, type StepExecutionListResponse, type StepExecutionStatus, type StepHistoryEntry, type StepMetric, type StoppedBreakdown, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, SyncPhaseStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TransferProspectsRequest, type TransferProspectsResponse, type TransferSkipReason, type TransitionCondition, type TransitionConditionOperator, type TransitionConditionType, type TransitionConfig, type TransitionEventParams, type TriggerSyncResponse, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdatePersonaRequest, type UpdatePersonaResponse, type UpdateStepExecutionRequest, type UpdateStepExecutionResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, VALID_EVENT_TYPES, type ValidatedCandidate, ValidationError, type ValidationIssue, type ValidationResponse, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getContentLimit, getDailyInmailLimit, getDefaultDailyLimits, getInmailAllowance, getLimits, getMessageLimit, getRateLimit, hasOpenProfileMessages, isRecruiterSubscription, normalizeAction, verifyWebhookSignature };
+export { ACTION_DELAYS, type ActionLimit, type ActiveHours, type AddAndRunCriterionRequest, type AddCriterionRequest, type AddOrgMemberRequest, type AddOrgMemberResponse, type AddPersonaRequest, type AddPersonaResponse, type AddProspectsRequest, type AddProspectsResponse, type AgentConfig, type AgentCostStats, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type ApprovalActionRequest, type ApprovalItem, type ApprovalListResponse, type ApprovalMode, type ApprovalResponse, type ApprovalSettings, type ApprovalStatus, type ApprovalsParams, type ApprovalsRequestItem, type ApprovalsResponseItem, type ApproveStepRequest, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftJobProgress, type BatchDraftJobResponse, type BatchDraftJobStartedData, type BatchDraftJobStatusResponse, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, type BatchExecutionInclude, type BatchExecutionRequest, type BatchExecutionResponse, BatchJobStatus, type BatchPollRequest, type BatchPollResponse, type BatchProspectIdentifier, type BatchRequestItem, type BatchRequestType, type BatchResponseItem, type BatchSendRequest, type BatchSendResponse, type BatchStepMetric, type BillingStatus, type BulkApprovalAction, type BulkApprovalFailure, type BulkApprovalRequest, type BulkApprovalResponse, type BulkCompleteFailure, type BulkCompleteRequest, type BulkCompleteResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkOperationRequest, type BulkOperationResponse, type BulkUploadResponse, CONTENT_LIMITS, CONTENT_LIMITS_MAP, type CampaignActionListResponse, type CampaignActionResponse, type CampaignActionStatus, type CampaignActionType, type CampaignBulkApprovalAction, type CampaignBulkApprovalItem, type CampaignBulkApprovalRequest, type CampaignBulkApprovalResponse, type CampaignBulkApprovalResult, type CampaignCreate, type CampaignGuardrails, type CampaignListResponse, type CampaignMetricsResponse, type CampaignOutcomeType, type CampaignProspectDetailResponse, type CampaignProspectInput, type CampaignProspectResponse, type CampaignProspectState, type CampaignResponse, type CampaignStatus, type CampaignUpdate, CampaignsResource, type CancelDraftResponse, type CancelQueuedRequest, type CancelResponseResponse, type Channel, type ChannelContactHistory, type ChannelFunnel, type ChannelRatios, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type CompetitorPostEngagementOutput, type CompetitorRepEngagementOutput, type CompleteExecutionRequest, type CompleteExecutionResponse, type ConnectInboxRequest, type ConnectInboxResponse, type Connection, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ConnectionsResponse, type ConnectionsSyncStatus, type ContactDetailsInput, type ContactEnrichPersonInput, type ContactEnrichPersonResult, type ContactEnrichRequest, type ContactEnrichResponse, type ContactFinding, type ContactHistorySyncStatus, type ContactRelationshipProvider, type ContactRelationshipResponse, type ContactRelationshipStatus, ContactRelationshipsResource, type ContactScore, type ContentLimit, type ContentSource, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type CriteriaClassification, type CriteriaMetadata, type CriterionDefinition, type CriterionResult, type CriterionType, type CrmContactsSyncRequest, type CrmContactsSyncResponse, type CrmContactsSyncStatusResponse, type CrmExclusionGrantListResponse, type CrmExclusionGrantRequest, type CrmExclusionGrantResponse, type CrmMatchBatchRequest, type CrmMatchBatchResponse, type CrmMatchedProspect, type CrmProvider, CrmResource, type CrmSyncProspectRequest, type CrmSyncProspectResponse, DAILY_INMAIL_LIMITS, DEFAULT_SUBSCRIPTION_TYPE, type DatabaseStatus, type DeepPeopleSearchOutput, type DeepSearchPreview, type DeepSearchStats, type DeleteApiKeyResponse, type DeleteConnectionsResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DiscoveryTrace, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type DuplicateTemplateRequest, type EditQueuedRequest, type Email, type EmailAction, type EmailInboxItem, type EmailInboxListResponse, type EmailInboxPersona, type EmailOnboardRequest, type EmailOnboardResponse, type EmailOnboardStatusResponse, type EmailOrgHealthResponse, type EmailOrgListResponse, type EmailOrgSettingsResponse, type EmailOrgSettingsUpdate, type EmailOrgSummary, EmailResource, type EmailSenderPersona, type EmailThreadSummary, type EngagementStatus, type EngagementStatusData, type EngagementStatusRequest, type EngagementStatusResponse, EnrichmentResource, type ErrorDetail, type ErrorResponse, type ErrorResponseItem, type EvidenceSource, type ExecutionDetailResponse, type ExecutionEvent, type ExecutionEventData, type ExecutionListResponse, type ExecutionMetricsOptions, type ExecutionMetricsResponse, type ExecutionStatus, type ExecutionSummary, type ExecutionSummaryExtended, type ExecutionsParams, type ExecutionsRequestItem, type ExecutionsResponseItem, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type FilterLogic, type FilterValue, type FunnelStage, type GetConnectionStatusParams, type GetContactRelationshipsOptions, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InboxKind, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, type IntentSignal, InternalServerError, LINKEDIN_LIMITS, type LifecycleOperationRequest, type LifecycleOperationResponse, type LinkAssetsRequest, type LinkedAssetsResponse, type LinkedInAccountInfoResponse, type LinkedInAccountRateLimits, type LinkedInAccountRateLimitsResponse, type LinkedInAccountRateLimitsUpdate, type LinkedInAction, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type LinkedInSyncStatusResponse, type ListAcceptedConnectionsParams, type ListApprovalsOptions, type ListAssetsOptions, type ListCampaignActionsOptions, type ListCampaignProspectsOptions, type ListCampaignsOptions, type ListConnectionsParams, type ListExecutionsOptions, type ListInboxesParams, type ListPendingApprovalsOptions, type ListPlaybooksOptions, type ListProvidersResponse, type ListStepExecutionsOptions, type ListTemplatesOptions, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type MailboxUpdateRequest, type MailboxUpdateResponse, type Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type MetricsParams, type MetricsRequestItem, type MetricsResponseItem, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, type OnFailure, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PlaybookCreate, type PlaybookGenerateJobResponse, type PlaybookGenerateJobStatusResponse, type PlaybookGenerateRequest, type PlaybookResponse, type PlaybookUpdate, type PlaybookVersionResponse, type PostEngagementData, type PostEngagementProvenance, type PostEngagementType, type PostPreviewRequest, type PostPreviewResponse, type PostPreviewResult, type PostsDateRange, type PostsSearchStats, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProjectApprovalsData, type ProjectExecutionsData, type ProjectMetricsData, type ProspectConnectionCheck, type ProspectInfo, type ProspectInput, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, type ProspectWarning, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, type RateLimitData, RateLimitError, type RateLimitErrorOptions, type RateLimitInfo$1 as RateLimitInfo, type RateLimitStatusResponse, type RateLimitsParams, type RateLimitsRequestItem, type RateLimitsResponseItem, type RecordOutcomeRequest, type RejectActionRequest, type RejectStepRequest, type RelevanceTier, type RemoveOrgMemberResponse, type RepEngagementData, type RepEngagementStats, type ReplySentiment, type ResolvedCompetitorTarget, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, SEQUENCE_RATE_LIMITS, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, type SenderPersonaInput, type SequenceAction, type SequenceApprovalNeededData, type SequenceChannel, type SequenceEventType, type SequenceExecutionCompletedData, type SequenceExecutionFailedData, type SequenceRateLimitAction, type SequenceStepCompletedData, type SequenceTemplateCreate, type SequenceTemplateResponse, type SequenceTemplateUpdate, SequencesResource, SharePermission, type SkillAnalyticsRequest, type SkillEffectivenessMetrics, type SkillGuidelineBase, type SkillGuidelineCreate, type SkillGuidelineListResponse, type SkillGuidelineResponse, type SkillGuidelineUpdate, type SkillRetrievalMetadata, type SkillUsageBase, type SkillUsageCreate, type SkillUsageListResponse, type SkillUsageResponse, type SkillUsageUpdate, SkillsResource, type SkipActionRequest, type SkipStepRequest, type SkipStepResponse, type SkippedProspect, type SkippedTransferProspect, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type Stage, type StageFilter, type StartExecutionRequest, type StartExecutionResponse, type StepConfig, type StepExecutionItem, type StepExecutionListResponse, type StepExecutionStatus, type StepHistoryEntry, type StepMetric, type StoppedBreakdown, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, SyncPhaseStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TransferProspectsRequest, type TransferProspectsResponse, type TransferSkipReason, type TransitionCondition, type TransitionConditionOperator, type TransitionConditionType, type TransitionConfig, type TransitionEventParams, type TriggerSyncResponse, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdatePersonaRequest, type UpdatePersonaResponse, type UpdateStepExecutionRequest, type UpdateStepExecutionResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, VALID_EVENT_TYPES, type ValidatedCandidate, ValidationError, type ValidationIssue, type ValidationResponse, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getContentLimit, getDailyInmailLimit, getDefaultDailyLimits, getInmailAllowance, getLimits, getMessageLimit, getRateLimit, hasOpenProfileMessages, isRecruiterSubscription, normalizeAction, verifyWebhookSignature };

package/dist/index.d.ts

@@ -1742,6 +1742,26 @@ interface SpecializedAgentParams {
      * Names to exclude from results (passed through to CrustData post-processing when supported).
      */
     excludeNames?: string[];
+    /**
+     * Exclude people already in the acting user's synced CRM (`crm_contacts` ledger;
+     * local lookup only, never a live CRM call). Matches on exact LinkedIn URL and
+     * email; optionally name+company when `crmNameCompanyMatch` is true.
+     * @default true
+     * Used by deep_people_search (via `specializedAgentParams`) and quick_people_search
+     * (via top-level `options` on the create request).
+     */
+    excludeCrmContacts?: boolean;
+    /**
+     * Narrow CRM exclusion to specific granted owners' ledgers (user id or email).
+     * Omitted = the acting user's own CRM only. Ungranted entries are ignored.
+     */
+    crmExclusionOwners?: string[];
+    /**
+     * Within CRM exclusion, also drop candidates matching by exact name + company
+     * (catches CRM contacts with no LinkedIn URL, especially HubSpot).
+     * @default true
+     */
+    crmNameCompanyMatch?: boolean;
     /**
      * Response ID to reuse criteria from.
      */
@@ -2487,6 +2507,12 @@ interface CampaignGuardrails {
      * as a kill-switch.
      */
     customerEditsEnabled?: boolean;
+    /**
+     * When true (default), prospects already in the campaign owner's synced CRM
+     * are skipped at add-time (exact LinkedIn/email) and flagged on name+company.
+     * Set false to disable for this campaign.
+     */
+    excludeCrmContacts?: boolean;
 }
 type ApprovalMode = 'auto' | 'require';
 interface ApprovalSettings {
@@ -2622,6 +2648,8 @@ interface AddProspectsResponse {
     added: number;
     skipped: number;
     warnings: ProspectWarning[];
+    /** Prospects hard-skipped because they exactly matched the owner's CRM ledger. */
+    skippedInCrm?: number;
 }
 interface TransferProspectsRequest {
     /** Campaign to move the prospects into. Must belong to the same user and not be stopped/completed. */
@@ -3172,16 +3200,61 @@ declare class ContactRelationshipsResource {
  *
  * Capability notes:
  * - `attio` supports both email and LinkedIn-URL person search.
- * - `hubspot` only supports email search; LinkedIn URLs are stored as a
- *   custom property on create but are not searchable through the
- *   reconciliation flow.
+ * - `hubspot` reconciles via email and name+company; LinkedIn URLs are
+ *   stored on create but are not directly searchable in live CRM calls.
+ *   The local `crm_contacts` ledger (see contacts sync) improves match-batch
+ *   and search/campaign exclusion without live HubSpot lookups.
  */
 type CrmProvider = 'attio' | 'hubspot';
+/**
+ * Trigger a full mirror of the owner's CRM contact book into the local
+ * `crm_contacts` ledger (used for fast exclusion/matching; not a live CRM call).
+ */
+interface CrmContactsSyncRequest {
+    /** UUID or email of the CRM owner whose connection is synced. */
+    userId: string;
+    provider: CrmProvider;
+}
+interface CrmContactsSyncResponse {
+    /** `started` — sync claimed; `already_in_progress` — another run holds the lock. */
+    status: 'started' | 'already_in_progress';
+    provider: CrmProvider;
+}
+/** Sync freshness for an owner+provider ledger mirror. */
+interface CrmContactsSyncStatusResponse {
+    provider: CrmProvider;
+    connected: boolean;
+    syncInProgress: boolean;
+    lastReconciledAt?: string | null;
+    syncedCount: number;
+    /** Null in v1 — LIST APIs do not return a reliable total. */
+    totalInCrm?: number | null;
+}
+/**
+ * Grant or revoke a member's right to exclude against an owner's CRM ledger.
+ * Per-owner (all of that owner's synced CRMs inherit). Self-grant is a no-op.
+ */
+interface CrmExclusionGrantRequest {
+    /** Member (UUID or email) who reads the owner's exclusion ledger. */
+    memberUserId: string;
+    /** CRM owner (UUID or email) whose ledger is shared. */
+    ownerUserId: string;
+}
+interface CrmExclusionGrantResponse {
+    memberUserId: string;
+    ownerUserId: string;
+    status: 'granted' | 'revoked';
+}
+interface CrmExclusionGrantListResponse {
+    memberUserId: string;
+    ownerUserIds: string[];
+}
 /**
  * Push one Lumnis prospect to the connected CRM.
  *
- * The prospect must already exist in a `campaign_prospects` row owned
- * by `userId`; the linkedin URL is the lookup key.
+ * Prefer a `campaign_prospects` row owned by `userId` when present; otherwise
+ * the server enriches from profile cache / Fiber and creates the CRM record.
+ * Provider-id/URN LinkedIn URLs are resolved to vanity before reconcile.
  */
 interface CrmSyncProspectRequest {
     /** UUID or email of the user whose CRM connection executes the call. */
@@ -3230,7 +3303,8 @@ interface CrmMatchBatchResponse {
 /**
  * Resource for the user-triggered CRM Sync API.
  *
- * Wraps `POST /v1/crm/prospects/sync` and `POST /v1/crm/prospects/match-batch`.
+ * Wraps prospect sync/match, contacts-ledger sync, and exclusion-grant routes
+ * under `/v1/crm`.
  *
  * The user identified by `userId` must already have an active CRM
  * connection (see `client.integrations.initiateConnection`). When the
@@ -3240,8 +3314,9 @@ interface CrmMatchBatchResponse {
  *
  * Failure modes worth handling:
  * - `409 crm_not_connected` — user hasn't connected the provider.
- * - `404 prospect_not_found` (sync only) — no `campaign_prospects` row
- *   matches `linkedinUrl` for this user.
+ * - `404 prospect_not_found` (sync) — profile could not be identified.
+ * - `422 linkedin_url_unresolved` (sync) — internal member-id URL could not
+ *   be resolved to a public vanity URL.
  * - `502 crm_upstream_error` — Attio/HubSpot returned an error.
  * - `503 crm_upstream_rate_limited` — upstream rate-limit; the response
  *   includes a `Retry-After` header.
@@ -3257,6 +3332,9 @@ declare class CrmResource {
      * `crmRecordId`. Stale links (record deleted in the CRM) are detected
      * and re-created automatically.
      *
+     * Works with or without a `campaign_prospects` row — search-sourced
+     * prospects are enriched from profile cache when needed.
+     *
      * @example
      * ```typescript
      * const result = await client.crm.syncProspect({
@@ -3274,16 +3352,13 @@ declare class CrmResource {
      * render a "linked" indicator for the ones that come back true.
      *
      * Layered cache on the server side: persistent positive matches are
-     * served from the `campaign_prospects.crm_record_id` column, negative
-     * results are served from a Redis cache (TTL configured by
-     * `CRM_MATCH_NEGATIVE_CACHE_TTL_SECONDS`). Only the leftover unknowns
-     * fan out to the live CRM, bounded by
+     * served from the `campaign_prospects.crm_record_id` column and the
+     * local `crm_contacts` ledger; negative results are served from a Redis
+     * cache (TTL configured by `CRM_MATCH_NEGATIVE_CACHE_TTL_SECONDS`).
+     * Only the leftover unknowns fan out to the live CRM, bounded by
      * `CRM_MATCH_LIVE_SEARCH_PARALLELISM`.
      *
-     * Note: HubSpot does not expose a LinkedIn-URL search field through
-     * Composio, so for `provider: 'hubspot'` URLs that aren't already in
-     * the persistent cache will always come back `linked: false`. The
-     * sync endpoint still reconciles via email when available.
+     * Provider-id/URN inputs are resolved to vanity before matching.
      *
      * @example
      * ```typescript
@@ -3298,6 +3373,30 @@ declare class CrmResource {
      * ```
      */
     matchBatch(data: CrmMatchBatchRequest): Promise<CrmMatchBatchResponse>;
+    /**
+     * Trigger a full mirror of the owner's CRM contact book into the local
+     * `crm_contacts` ledger. Returns immediately (`202`); poll
+     * {@link getContactsSyncStatus} for progress.
+     */
+    syncContacts(data: CrmContactsSyncRequest): Promise<CrmContactsSyncResponse>;
+    /**
+     * Ledger sync freshness for an owner+provider: connection state, whether a
+     * sync is in progress, last reconcile time, and row count in the ledger.
+     */
+    getContactsSyncStatus(userId: string, provider: CrmProvider): Promise<CrmContactsSyncStatusResponse>;
+    /**
+     * Grant a member the right to exclude against an owner's synced CRM ledger
+     * (all providers for that owner). Typically called by the FE on org join.
+     */
+    grantExclusionGrant(data: CrmExclusionGrantRequest): Promise<CrmExclusionGrantResponse>;
+    /**
+     * Revoke a member's access to an owner's CRM exclusion ledger.
+     */
+    revokeExclusionGrant(data: CrmExclusionGrantRequest): Promise<CrmExclusionGrantResponse>;
+    /**
+     * List CRM owners whose exclusion ledger a member may read (via grants).
+     */
+    listExclusionGrants(memberUserId: string): Promise<CrmExclusionGrantListResponse>;
 }
 
 /**
@@ -5881,6 +5980,9 @@ declare class ResponsesResource {
      * @param options - Optional search parameters
      * @param options.limit - Maximum number of results (1-100, default: 20)
      * @param options.dataSources - Specific data sources to use: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+     * @param options.excludeCrmContacts - Exclude people in the acting user's synced CRM ledger; @default true (via request `options`)
+     * @param options.crmExclusionOwners - Granted owner ledgers to exclude against (user id or email)
+     * @param options.crmNameCompanyMatch - Also exclude by exact name+company; @default true
      * @returns Response with structured_response containing:
      *   - candidates: List of person results
      *   - totalFound: Total unique candidates found
@@ -5891,6 +5993,9 @@ declare class ResponsesResource {
     quickPeopleSearch(query: string, options?: {
         limit?: number;
         dataSources?: string[];
+        excludeCrmContacts?: boolean;
+        crmExclusionOwners?: string[];
+        crmNameCompanyMatch?: boolean;
     }): Promise<CreateResponseResponse>;
     /**
      * Perform a deep people search with AI-generated criteria and validation
@@ -5910,6 +6015,9 @@ declare class ResponsesResource {
      * @param options.excludeProfiles - LinkedIn URLs to exclude from results
      * @param options.excludePreviouslyContacted - Exclude previously contacted people
      * @param options.excludeNames - Names to exclude from results
+     * @param options.excludeCrmContacts - Exclude people in the acting user's synced CRM ledger; @default true
+     * @param options.crmExclusionOwners - Granted owner ledgers to exclude against (user id or email)
+     * @param options.crmNameCompanyMatch - Also exclude by exact name+company; @default true
      * @param options.searchJobSignal - CrustData job-listing signal search (decision makers at hiring companies); true | false | 'auto'
      * @param options.deepVerify - Web verification for org/location/third-party criteria: 'auto' (default), 'always', or 'off'
      * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
@@ -5937,6 +6045,9 @@ declare class ResponsesResource {
         excludeProfiles?: string[];
         excludePreviouslyContacted?: boolean;
         excludeNames?: string[];
+        excludeCrmContacts?: boolean;
+        crmExclusionOwners?: string[];
+        crmNameCompanyMatch?: boolean;
         searchProfiles?: boolean | 'auto';
         searchPosts?: boolean | 'auto';
         includeEngagementInScore?: boolean | 'auto';
@@ -7645,4 +7756,4 @@ declare class ProgressTracker {
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
-export { ACTION_DELAYS, type ActionLimit, type ActiveHours, type AddAndRunCriterionRequest, type AddCriterionRequest, type AddOrgMemberRequest, type AddOrgMemberResponse, type AddPersonaRequest, type AddPersonaResponse, type AddProspectsRequest, type AddProspectsResponse, type AgentConfig, type AgentCostStats, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type ApprovalActionRequest, type ApprovalItem, type ApprovalListResponse, type ApprovalMode, type ApprovalResponse, type ApprovalSettings, type ApprovalStatus, type ApprovalsParams, type ApprovalsRequestItem, type ApprovalsResponseItem, type ApproveStepRequest, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftJobProgress, type BatchDraftJobResponse, type BatchDraftJobStartedData, type BatchDraftJobStatusResponse, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, type BatchExecutionInclude, type BatchExecutionRequest, type BatchExecutionResponse, BatchJobStatus, type BatchPollRequest, type BatchPollResponse, type BatchProspectIdentifier, type BatchRequestItem, type BatchRequestType, type BatchResponseItem, type BatchSendRequest, type BatchSendResponse, type BatchStepMetric, type BillingStatus, type BulkApprovalAction, type BulkApprovalFailure, type BulkApprovalRequest, type BulkApprovalResponse, type BulkCompleteFailure, type BulkCompleteRequest, type BulkCompleteResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkOperationRequest, type BulkOperationResponse, type BulkUploadResponse, CONTENT_LIMITS, CONTENT_LIMITS_MAP, type CampaignActionListResponse, type CampaignActionResponse, type CampaignActionStatus, type CampaignActionType, type CampaignBulkApprovalAction, type CampaignBulkApprovalItem, type CampaignBulkApprovalRequest, type CampaignBulkApprovalResponse, type CampaignBulkApprovalResult, type CampaignCreate, type CampaignGuardrails, type CampaignListResponse, type CampaignMetricsResponse, type CampaignOutcomeType, type CampaignProspectDetailResponse, type CampaignProspectInput, type CampaignProspectResponse, type CampaignProspectState, type CampaignResponse, type CampaignStatus, type CampaignUpdate, CampaignsResource, type CancelDraftResponse, type CancelQueuedRequest, type CancelResponseResponse, type Channel, type ChannelContactHistory, type ChannelFunnel, type ChannelRatios, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type CompetitorPostEngagementOutput, type CompetitorRepEngagementOutput, type CompleteExecutionRequest, type CompleteExecutionResponse, type ConnectInboxRequest, type ConnectInboxResponse, type Connection, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ConnectionsResponse, type ConnectionsSyncStatus, type ContactDetailsInput, type ContactEnrichPersonInput, type ContactEnrichPersonResult, type ContactEnrichRequest, type ContactEnrichResponse, type ContactFinding, type ContactHistorySyncStatus, type ContactRelationshipProvider, type ContactRelationshipResponse, type ContactRelationshipStatus, ContactRelationshipsResource, type ContactScore, type ContentLimit, type ContentSource, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type CriteriaClassification, type CriteriaMetadata, type CriterionDefinition, type CriterionResult, type CriterionType, type CrmMatchBatchRequest, type CrmMatchBatchResponse, type CrmMatchedProspect, type CrmProvider, CrmResource, type CrmSyncProspectRequest, type CrmSyncProspectResponse, DAILY_INMAIL_LIMITS, DEFAULT_SUBSCRIPTION_TYPE, type DatabaseStatus, type DeepPeopleSearchOutput, type DeepSearchPreview, type DeepSearchStats, type DeleteApiKeyResponse, type DeleteConnectionsResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DiscoveryTrace, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type DuplicateTemplateRequest, type EditQueuedRequest, type Email, type EmailAction, type EmailInboxItem, type EmailInboxListResponse, type EmailInboxPersona, type EmailOnboardRequest, type EmailOnboardResponse, type EmailOnboardStatusResponse, type EmailOrgHealthResponse, type EmailOrgListResponse, type EmailOrgSettingsResponse, type EmailOrgSettingsUpdate, type EmailOrgSummary, EmailResource, type EmailSenderPersona, type EmailThreadSummary, type EngagementStatus, type EngagementStatusData, type EngagementStatusRequest, type EngagementStatusResponse, EnrichmentResource, type ErrorDetail, type ErrorResponse, type ErrorResponseItem, type EvidenceSource, type ExecutionDetailResponse, type ExecutionEvent, type ExecutionEventData, type ExecutionListResponse, type ExecutionMetricsOptions, type ExecutionMetricsResponse, type ExecutionStatus, type ExecutionSummary, type ExecutionSummaryExtended, type ExecutionsParams, type ExecutionsRequestItem, type ExecutionsResponseItem, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type FilterLogic, type FilterValue, type FunnelStage, type GetConnectionStatusParams, type GetContactRelationshipsOptions, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InboxKind, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, type IntentSignal, InternalServerError, LINKEDIN_LIMITS, type LifecycleOperationRequest, type LifecycleOperationResponse, type LinkAssetsRequest, type LinkedAssetsResponse, type LinkedInAccountInfoResponse, type LinkedInAccountRateLimits, type LinkedInAccountRateLimitsResponse, type LinkedInAccountRateLimitsUpdate, type LinkedInAction, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type LinkedInSyncStatusResponse, type ListAcceptedConnectionsParams, type ListApprovalsOptions, type ListAssetsOptions, type ListCampaignActionsOptions, type ListCampaignProspectsOptions, type ListCampaignsOptions, type ListConnectionsParams, type ListExecutionsOptions, type ListInboxesParams, type ListPendingApprovalsOptions, type ListPlaybooksOptions, type ListProvidersResponse, type ListStepExecutionsOptions, type ListTemplatesOptions, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type MailboxUpdateRequest, type MailboxUpdateResponse, type Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type MetricsParams, type MetricsRequestItem, type MetricsResponseItem, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, type OnFailure, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PlaybookCreate, type PlaybookGenerateJobResponse, type PlaybookGenerateJobStatusResponse, type PlaybookGenerateRequest, type PlaybookResponse, type PlaybookUpdate, type PlaybookVersionResponse, type PostEngagementData, type PostEngagementProvenance, type PostEngagementType, type PostPreviewRequest, type PostPreviewResponse, type PostPreviewResult, type PostsDateRange, type PostsSearchStats, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProjectApprovalsData, type ProjectExecutionsData, type ProjectMetricsData, type ProspectConnectionCheck, type ProspectInfo, type ProspectInput, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, type ProspectWarning, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, type RateLimitData, RateLimitError, type RateLimitErrorOptions, type RateLimitInfo$1 as RateLimitInfo, type RateLimitStatusResponse, type RateLimitsParams, type RateLimitsRequestItem, type RateLimitsResponseItem, type RecordOutcomeRequest, type RejectActionRequest, type RejectStepRequest, type RelevanceTier, type RemoveOrgMemberResponse, type RepEngagementData, type RepEngagementStats, type ReplySentiment, type ResolvedCompetitorTarget, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, SEQUENCE_RATE_LIMITS, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, type SenderPersonaInput, type SequenceAction, type SequenceApprovalNeededData, type SequenceChannel, type SequenceEventType, type SequenceExecutionCompletedData, type SequenceExecutionFailedData, type SequenceRateLimitAction, type SequenceStepCompletedData, type SequenceTemplateCreate, type SequenceTemplateResponse, type SequenceTemplateUpdate, SequencesResource, SharePermission, type SkillAnalyticsRequest, type SkillEffectivenessMetrics, type SkillGuidelineBase, type SkillGuidelineCreate, type SkillGuidelineListResponse, type SkillGuidelineResponse, type SkillGuidelineUpdate, type SkillRetrievalMetadata, type SkillUsageBase, type SkillUsageCreate, type SkillUsageListResponse, type SkillUsageResponse, type SkillUsageUpdate, SkillsResource, type SkipActionRequest, type SkipStepRequest, type SkipStepResponse, type SkippedProspect, type SkippedTransferProspect, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type Stage, type StageFilter, type StartExecutionRequest, type StartExecutionResponse, type StepConfig, type StepExecutionItem, type StepExecutionListResponse, type StepExecutionStatus, type StepHistoryEntry, type StepMetric, type StoppedBreakdown, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, SyncPhaseStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TransferProspectsRequest, type TransferProspectsResponse, type TransferSkipReason, type TransitionCondition, type TransitionConditionOperator, type TransitionConditionType, type TransitionConfig, type TransitionEventParams, type TriggerSyncResponse, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdatePersonaRequest, type UpdatePersonaResponse, type UpdateStepExecutionRequest, type UpdateStepExecutionResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, VALID_EVENT_TYPES, type ValidatedCandidate, ValidationError, type ValidationIssue, type ValidationResponse, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getContentLimit, getDailyInmailLimit, getDefaultDailyLimits, getInmailAllowance, getLimits, getMessageLimit, getRateLimit, hasOpenProfileMessages, isRecruiterSubscription, normalizeAction, verifyWebhookSignature };
+export { ACTION_DELAYS, type ActionLimit, type ActiveHours, type AddAndRunCriterionRequest, type AddCriterionRequest, type AddOrgMemberRequest, type AddOrgMemberResponse, type AddPersonaRequest, type AddPersonaResponse, type AddProspectsRequest, type AddProspectsResponse, type AgentConfig, type AgentCostStats, type ApiKeyMode, type ApiKeyModeRequest, type ApiKeyModeResponse, type ApiProvider, type AppEnabledResponse, type AppliedFilters, type ApprovalActionRequest, type ApprovalItem, type ApprovalListResponse, type ApprovalMode, type ApprovalResponse, type ApprovalSettings, type ApprovalStatus, type ApprovalsParams, type ApprovalsRequestItem, type ApprovalsResponseItem, type ApproveStepRequest, type AppsListResponse, type ArtifactObject, type ArtifactsListResponse, AuthenticationError, type BaseResource, type BatchCheckConnectionRequest, type BatchCheckPriorContactRequest, type BatchCheckPriorContactResponse, type BatchConnectionRequest, type BatchConnectionResponse, type BatchConnectionStatus, type BatchConnectionStatusResponse, type BatchDraftCompleteData, type BatchDraftCreatedData, type BatchDraftErrorData, type BatchDraftJobProgress, type BatchDraftJobResponse, type BatchDraftJobStartedData, type BatchDraftJobStatusResponse, type BatchDraftProgressData, type BatchDraftRequest, type BatchDraftResponse, type BatchDraftStreamCallbacks, type BatchDraftStreamEvent, type BatchDraftStreamEventType, type BatchExecutionInclude, type BatchExecutionRequest, type BatchExecutionResponse, BatchJobStatus, type BatchPollRequest, type BatchPollResponse, type BatchProspectIdentifier, type BatchRequestItem, type BatchRequestType, type BatchResponseItem, type BatchSendRequest, type BatchSendResponse, type BatchStepMetric, type BillingStatus, type BulkApprovalAction, type BulkApprovalFailure, type BulkApprovalRequest, type BulkApprovalResponse, type BulkCompleteFailure, type BulkCompleteRequest, type BulkCompleteResponse, type BulkDeleteRequest, type BulkDeleteResponse, type BulkOperationRequest, type BulkOperationResponse, type BulkUploadResponse, CONTENT_LIMITS, CONTENT_LIMITS_MAP, type CampaignActionListResponse, type CampaignActionResponse, type CampaignActionStatus, type CampaignActionType, type CampaignBulkApprovalAction, type CampaignBulkApprovalItem, type CampaignBulkApprovalRequest, type CampaignBulkApprovalResponse, type CampaignBulkApprovalResult, type CampaignCreate, type CampaignGuardrails, type CampaignListResponse, type CampaignMetricsResponse, type CampaignOutcomeType, type CampaignProspectDetailResponse, type CampaignProspectInput, type CampaignProspectResponse, type CampaignProspectState, type CampaignResponse, type CampaignStatus, type CampaignUpdate, CampaignsResource, type CancelDraftResponse, type CancelQueuedRequest, type CancelResponseResponse, type Channel, type ChannelContactHistory, type ChannelFunnel, type ChannelRatios, ChannelType, type CheckAppEnabledParams, type CheckLinkedInConnectionRequest, type CheckPriorContactRequest, type CheckPriorContactResponse, type ChunkingStrategy, type CompetitorPostEngagementOutput, type CompetitorRepEngagementOutput, type CompleteExecutionRequest, type CompleteExecutionResponse, type ConnectInboxRequest, type ConnectInboxResponse, type Connection, type ConnectionAcceptedData, type ConnectionCallbackRequest, type ConnectionCallbackResponse, type ConnectionInfo, type ConnectionStatus, type ConnectionStatusResponse, type ConnectionSummary, type ConnectionsResponse, type ConnectionsSyncStatus, type ContactDetailsInput, type ContactEnrichPersonInput, type ContactEnrichPersonResult, type ContactEnrichRequest, type ContactEnrichResponse, type ContactFinding, type ContactHistorySyncStatus, type ContactRelationshipProvider, type ContactRelationshipResponse, type ContactRelationshipStatus, ContactRelationshipsResource, type ContactScore, type ContentLimit, type ContentSource, type ContentType, type ConversationDetail, ConversationStatus, type ConversationSummary, type CreateDraftRequest, type CreateFeedbackRequest, type CreateFeedbackResponse, type CreateResponseRequest, type CreateResponseResponse, type CreateThreadRequest, type CriteriaClassification, type CriteriaMetadata, type CriterionDefinition, type CriterionResult, type CriterionType, type CrmContactsSyncRequest, type CrmContactsSyncResponse, type CrmContactsSyncStatusResponse, type CrmExclusionGrantListResponse, type CrmExclusionGrantRequest, type CrmExclusionGrantResponse, type CrmMatchBatchRequest, type CrmMatchBatchResponse, type CrmMatchedProspect, type CrmProvider, CrmResource, type CrmSyncProspectRequest, type CrmSyncProspectResponse, DAILY_INMAIL_LIMITS, DEFAULT_SUBSCRIPTION_TYPE, type DatabaseStatus, type DeepPeopleSearchOutput, type DeepSearchPreview, type DeepSearchStats, type DeleteApiKeyResponse, type DeleteConnectionsResponse, type DeleteConversationResponse, type DeleteConversationsByProjectResponse, type DisconnectRequest, type DisconnectResponse, type DiscoveryTrace, type DraftResponse, type DraftSendOverride, DraftStatus, type DuplicateHandling, type DuplicateTemplateRequest, type EditQueuedRequest, type Email, type EmailAction, type EmailInboxItem, type EmailInboxListResponse, type EmailInboxPersona, type EmailOnboardRequest, type EmailOnboardResponse, type EmailOnboardStatusResponse, type EmailOrgHealthResponse, type EmailOrgListResponse, type EmailOrgSettingsResponse, type EmailOrgSettingsUpdate, type EmailOrgSummary, EmailResource, type EmailSenderPersona, type EmailThreadSummary, type EngagementStatus, type EngagementStatusData, type EngagementStatusRequest, type EngagementStatusResponse, EnrichmentResource, type ErrorDetail, type ErrorResponse, type ErrorResponseItem, type EvidenceSource, type ExecutionDetailResponse, type ExecutionEvent, type ExecutionEventData, type ExecutionListResponse, type ExecutionMetricsOptions, type ExecutionMetricsResponse, type ExecutionStatus, type ExecutionSummary, type ExecutionSummaryExtended, type ExecutionsParams, type ExecutionsRequestItem, type ExecutionsResponseItem, ExternalAPIKeysResource, type ExternalApiKeyResponse, type FeedbackListResponse, type FeedbackObject, type FeedbackType, type FileAttachment, type FileChunk, type FileContentResponse, type FileListResponse, type FileMetadata, type FileScope, type FileScopeUpdateRequest, type FileSearchRequest, type FileSearchResponse, type FileSearchResult, type FileStatisticsResponse, type FileUploadResponse, FilesResource, type FilterLogic, type FilterValue, type FunnelStage, type GetConnectionStatusParams, type GetContactRelationshipsOptions, type GetToolsRequest, type GetToolsResponse, type GetUserConnectionsParams, type InboxKind, type InitiateConnectionRequest, type InitiateConnectionResponse, type InmailSubscription, IntegrationsResource, type IntentSignal, InternalServerError, LINKEDIN_LIMITS, type LifecycleOperationRequest, type LifecycleOperationResponse, type LinkAssetsRequest, type LinkedAssetsResponse, type LinkedInAccountInfoResponse, type LinkedInAccountRateLimits, type LinkedInAccountRateLimitsResponse, type LinkedInAccountRateLimitsUpdate, type LinkedInAction, type LinkedInConnectionStatus, type LinkedInCreditsResponse, type LinkedInLimitSubscriptionType, type LinkedInLimits, type LinkedInSendRequest, type LinkedInSubscriptionInfo, LinkedInSubscriptionType, type LinkedInSyncStatusResponse, type ListAcceptedConnectionsParams, type ListApprovalsOptions, type ListAssetsOptions, type ListCampaignActionsOptions, type ListCampaignProspectsOptions, type ListCampaignsOptions, type ListConnectionsParams, type ListExecutionsOptions, type ListInboxesParams, type ListPendingApprovalsOptions, type ListPlaybooksOptions, type ListProvidersResponse, type ListStepExecutionsOptions, type ListTemplatesOptions, LocalFileNotSupportedError, LumnisClient, type LumnisClientOptions, LumnisError, type LumnisErrorOptions, type MCPScope, type MCPServerCreateRequest, type MCPServerListResponse, type MCPServerResponse, type MCPServerUpdateRequest, MCPServersResource, type MCPToolListResponse, type MCPToolResponse, type MCPTransport, type MailboxUpdateRequest, type MailboxUpdateResponse, type Message, type MessageReceivedData, type MessageResponse, type MessageSentData, MessageType, MessagingAPIError, MessagingConnectionError, MessagingNotFoundError, MessagingResource, MessagingSendError, MessagingValidationError, type MetricsParams, type MetricsRequestItem, type MetricsResponseItem, type ModelAvailability, type ModelOverrides, type ModelPreferenceCreate, type ModelPreferencesBulkUpdate, ModelPreferencesResource, type ModelProvider, type ModelType, NetworkDistance, NoDataSourcesError, NotFoundError, type OnFailure, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PersonResult, type Plan, type PlaybookCreate, type PlaybookGenerateJobResponse, type PlaybookGenerateJobStatusResponse, type PlaybookGenerateRequest, type PlaybookResponse, type PlaybookUpdate, type PlaybookVersionResponse, type PostEngagementData, type PostEngagementProvenance, type PostEngagementType, type PostPreviewRequest, type PostPreviewResponse, type PostPreviewResult, type PostsDateRange, type PostsSearchStats, type PriorContactMessage, type ProcessingStatus, type ProcessingStatusResponse, type ProgressEntry, ProgressTracker, type ProjectApprovalsData, type ProjectExecutionsData, type ProjectMetricsData, type ProspectConnectionCheck, type ProspectInfo, type ProspectInput, type ProspectPriorContactResult, type ProspectSyncIdentifier, type ProspectSyncResult, type ProspectWarning, ProviderType, QueueItemStatus, type QuickPeopleSearchOutput, RATE_LIMIT_COOLDOWNS, type RateLimitData, RateLimitError, type RateLimitErrorOptions, type RateLimitInfo$1 as RateLimitInfo, type RateLimitStatusResponse, type RateLimitsParams, type RateLimitsRequestItem, type RateLimitsResponseItem, type RecordOutcomeRequest, type RejectActionRequest, type RejectStepRequest, type RelevanceTier, type RemoveOrgMemberResponse, type RepEngagementData, type RepEngagementStats, type ReplySentiment, type ResolvedCompetitorTarget, type ResponseArtifact, type ResponseListResponse, type ResponseObject, type ResponseStatus, ResponsesResource, SEQUENCE_RATE_LIMITS, type SalaryRange, type Scope, type SelectedSkill, type SendMessageRequest, type SendMessageResponse, type SendReplyRequest, type SendResult, type SenderPersonaInput, type SequenceAction, type SequenceApprovalNeededData, type SequenceChannel, type SequenceEventType, type SequenceExecutionCompletedData, type SequenceExecutionFailedData, type SequenceRateLimitAction, type SequenceStepCompletedData, type SequenceTemplateCreate, type SequenceTemplateResponse, type SequenceTemplateUpdate, SequencesResource, SharePermission, type SkillAnalyticsRequest, type SkillEffectivenessMetrics, type SkillGuidelineBase, type SkillGuidelineCreate, type SkillGuidelineListResponse, type SkillGuidelineResponse, type SkillGuidelineUpdate, type SkillRetrievalMetadata, type SkillUsageBase, type SkillUsageCreate, type SkillUsageListResponse, type SkillUsageResponse, type SkillUsageUpdate, SkillsResource, type SkipActionRequest, type SkipStepRequest, type SkipStepResponse, type SkippedProspect, type SkippedTransferProspect, SourcesNotAvailableError, type SpecializedAgentParams, type SpecializedAgentType, type Stage, type StageFilter, type StartExecutionRequest, type StartExecutionResponse, type StepConfig, type StepExecutionItem, type StepExecutionListResponse, type StepExecutionStatus, type StepHistoryEntry, type StepMetric, type StoppedBreakdown, type StoreApiKeyRequest, type StructuredResponse, type SyncJobResponse, SyncJobStatus, SyncPhaseStatus, type SyncProspectRequest, type SyncProspectResponse, type SyncRequest, type SyncStats, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TransferProspectsRequest, type TransferProspectsResponse, type TransferSkipReason, type TransitionCondition, type TransitionConditionOperator, type TransitionConditionType, type TransitionConfig, type TransitionEventParams, type TriggerSyncResponse, UNIPILE_RATE_LIMIT_ERRORS, UNIPILE_SAFE_LIMITS, type UUID, type UnlinkConversationsResponse, type UpdateAppStatusParams, type UpdateAppStatusResponse, type UpdateDraftRequest, type UpdateLinkedInSubscriptionRequest, type UpdatePersonaRequest, type UpdatePersonaResponse, type UpdateStepExecutionRequest, type UpdateStepExecutionResponse, type UpdateThreadRequest, type UserConnectionsResponse, type UserCreateRequest, type UserDeleteResponse, type UserIdentifier, type UserListResponse, type UserResponse, type UserUpdateRequest, UsersResource, VALID_EVENT_TYPES, type ValidatedCandidate, ValidationError, type ValidationIssue, type ValidationResponse, type WebhookEvent, type WebhookPayload, canSendInmail, displayProgress, formatProgressEntry, getBestSubscriptionForAction, getConnectionRequestLimit, getContentLimit, getDailyInmailLimit, getDefaultDailyLimits, getInmailAllowance, getLimits, getMessageLimit, getRateLimit, hasOpenProfileMessages, isRecruiterSubscription, normalizeAction, verifyWebhookSignature };

package/dist/index.mjs

@@ -943,6 +943,9 @@ class CrmResource {
    * `crmRecordId`. Stale links (record deleted in the CRM) are detected
    * and re-created automatically.
    *
+   * Works with or without a `campaign_prospects` row — search-sourced
+   * prospects are enriched from profile cache when needed.
+   *
    * @example
    * ```typescript
    * const result = await client.crm.syncProspect({
@@ -962,16 +965,13 @@ class CrmResource {
    * render a "linked" indicator for the ones that come back true.
    *
    * Layered cache on the server side: persistent positive matches are
-   * served from the `campaign_prospects.crm_record_id` column, negative
-   * results are served from a Redis cache (TTL configured by
-   * `CRM_MATCH_NEGATIVE_CACHE_TTL_SECONDS`). Only the leftover unknowns
-   * fan out to the live CRM, bounded by
+   * served from the `campaign_prospects.crm_record_id` column and the
+   * local `crm_contacts` ledger; negative results are served from a Redis
+   * cache (TTL configured by `CRM_MATCH_NEGATIVE_CACHE_TTL_SECONDS`).
+   * Only the leftover unknowns fan out to the live CRM, bounded by
    * `CRM_MATCH_LIVE_SEARCH_PARALLELISM`.
    *
-   * Note: HubSpot does not expose a LinkedIn-URL search field through
-   * Composio, so for `provider: 'hubspot'` URLs that aren't already in
-   * the persistent cache will always come back `linked: false`. The
-   * sync endpoint still reconciles via email when available.
+   * Provider-id/URN inputs are resolved to vanity before matching.
    *
    * @example
    * ```typescript
@@ -988,6 +988,51 @@ class CrmResource {
   async matchBatch(data) {
     return this.http.post("/crm/prospects/match-batch", data);
   }
+  /**
+   * Trigger a full mirror of the owner's CRM contact book into the local
+   * `crm_contacts` ledger. Returns immediately (`202`); poll
+   * {@link getContactsSyncStatus} for progress.
+   */
+  async syncContacts(data) {
+    return this.http.post("/crm/contacts/sync", data);
+  }
+  /**
+   * Ledger sync freshness for an owner+provider: connection state, whether a
+   * sync is in progress, last reconcile time, and row count in the ledger.
+   */
+  async getContactsSyncStatus(userId, provider) {
+    return this.http.get("/crm/contacts/sync-status", {
+      // Backend requires snake_case query params (FastAPI `user_id`). Query
+      // keys are sent verbatim by the http layer (only bodies are snake-cased),
+      // so pass snake_case here like every other resource — a camelCase
+      // `userId` 422s with "field required: user_id".
+      params: { user_id: userId, provider }
+    });
+  }
+  /**
+   * Grant a member the right to exclude against an owner's synced CRM ledger
+   * (all providers for that owner). Typically called by the FE on org join.
+   */
+  async grantExclusionGrant(data) {
+    return this.http.post("/crm/exclusion-grants", data);
+  }
+  /**
+   * Revoke a member's access to an owner's CRM exclusion ledger.
+   */
+  async revokeExclusionGrant(data) {
+    return this.http.delete("/crm/exclusion-grants", {
+      body: data
+    });
+  }
+  /**
+   * List CRM owners whose exclusion ledger a member may read (via grants).
+   */
+  async listExclusionGrants(memberUserId) {
+    return this.http.get("/crm/exclusion-grants", {
+      // Backend requires snake_case `member_user_id` (see getContactsSyncStatus).
+      params: { member_user_id: memberUserId }
+    });
+  }
 }
 
 class EmailResource {
@@ -3506,6 +3551,9 @@ class ResponsesResource {
    * @param options - Optional search parameters
    * @param options.limit - Maximum number of results (1-100, default: 20)
    * @param options.dataSources - Specific data sources to use: ["PDL", "CORESIGNAL", "CRUST_DATA"]
+   * @param options.excludeCrmContacts - Exclude people in the acting user's synced CRM ledger; @default true (via request `options`)
+   * @param options.crmExclusionOwners - Granted owner ledgers to exclude against (user id or email)
+   * @param options.crmNameCompanyMatch - Also exclude by exact name+company; @default true
    * @returns Response with structured_response containing:
    *   - candidates: List of person results
    *   - totalFound: Total unique candidates found
@@ -3526,6 +3574,15 @@ class ResponsesResource {
         params.dataSources = options.dataSources;
       if (Object.keys(params).length > 0)
         request.specializedAgentParams = params;
+      const crmOptions = {};
+      if (options.excludeCrmContacts !== void 0)
+        crmOptions.excludeCrmContacts = options.excludeCrmContacts;
+      if (options.crmExclusionOwners)
+        crmOptions.crmExclusionOwners = options.crmExclusionOwners;
+      if (options.crmNameCompanyMatch !== void 0)
+        crmOptions.crmNameCompanyMatch = options.crmNameCompanyMatch;
+      if (Object.keys(crmOptions).length > 0)
+        request.options = crmOptions;
     }
     return this.create(request);
   }
@@ -3547,6 +3604,9 @@ class ResponsesResource {
    * @param options.excludeProfiles - LinkedIn URLs to exclude from results
    * @param options.excludePreviouslyContacted - Exclude previously contacted people
    * @param options.excludeNames - Names to exclude from results
+   * @param options.excludeCrmContacts - Exclude people in the acting user's synced CRM ledger; @default true
+   * @param options.crmExclusionOwners - Granted owner ledgers to exclude against (user id or email)
+   * @param options.crmNameCompanyMatch - Also exclude by exact name+company; @default true
    * @param options.searchJobSignal - CrustData job-listing signal search (decision makers at hiring companies); true | false | 'auto'
    * @param options.deepVerify - Web verification for org/location/third-party criteria: 'auto' (default), 'always', or 'off'
    * @param options.deepValidationUseRelevanceReranker - SLM relevance reranker for surfaced candidates (ranking-only); @default true
@@ -3589,6 +3649,12 @@ class ResponsesResource {
         params.excludePreviouslyContacted = options.excludePreviouslyContacted;
       if (options.excludeNames)
         params.excludeNames = options.excludeNames;
+      if (options.excludeCrmContacts !== void 0)
+        params.excludeCrmContacts = options.excludeCrmContacts;
+      if (options.crmExclusionOwners)
+        params.crmExclusionOwners = options.crmExclusionOwners;
+      if (options.crmNameCompanyMatch !== void 0)
+        params.crmNameCompanyMatch = options.crmNameCompanyMatch;
       if (options.searchProfiles !== void 0)
         params.searchProfiles = options.searchProfiles;
       if (options.searchPosts !== void 0)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lumnisai",
   "type": "module",
-  "version": "0.5.26",
+  "version": "0.5.28",
   "description": "Official Node.js SDK for the Lumnis AI API",
   "author": "Lumnis AI",
   "license": "MIT",