lumnisai 0.5.32 → 0.5.33

package/dist/index.cjs

@@ -3396,6 +3396,32 @@ class ResponsesResource {
       }
     }
   }
+  _validateEngagementExpansionParams(params) {
+    const expandFromResponse = this._getParamValue(
+      params,
+      "expandFromResponse",
+      "expand_from_response"
+    );
+    if (typeof expandFromResponse !== "string" || !expandFromResponse.trim()) {
+      throw new ValidationError(
+        "expandFromResponse is required for engagement_expansion and must be a non-empty string"
+      );
+    }
+    for (const [camel, snake] of [
+      ["hops", "hops"],
+      ["postsPerHop", "posts_per_hop"],
+      ["peoplePerNextHop", "people_per_next_hop"],
+      ["limit", "limit"]
+    ]) {
+      const value = this._getParamValue(params, camel, snake);
+      if (value !== void 0 && (!Number.isInteger(value) || value < 1))
+        throw new ValidationError(`${camel} must be a positive integer for engagement_expansion`);
+    }
+    const excludeUrls = this._getParamValue(params, "excludeUrls", "exclude_urls");
+    if (excludeUrls !== void 0 && (!Array.isArray(excludeUrls) || excludeUrls.some((url) => typeof url !== "string"))) {
+      throw new ValidationError("excludeUrls must be an array of strings for engagement_expansion");
+    }
+  }
   _validateCriteriaParams(params, specializedAgent) {
     if (!params)
       return;
@@ -3509,6 +3535,8 @@ class ResponsesResource {
       this._validateCompetitorRepEngagementParams(rawParams);
     if (specializedAgent === "content_intelligence")
       this._validateContentIntelligenceParams(rawParams);
+    if (specializedAgent === "engagement_expansion")
+      this._validateEngagementExpansionParams(rawParams);
   }
   _validateFileReference(uri) {
     if (uri.startsWith("artifact_"))
@@ -3857,6 +3885,46 @@ class ResponsesResource {
       specializedAgentParams: params
     });
   }
+  /**
+   * Find new people by walking outward from a saved content-intelligence package.
+   *
+   * Hop 1 pulls the other engagers of the package's best posts. Additional hops
+   * select the highest-fit new people, rank posts from their feeds, and pull the
+   * engagers of those posts. Collection breadth is derived from `limit` unless
+   * `postsPerHop` is set explicitly. At the default limit, collection is about
+   * 300 credits for one hop and 1,060 for three hops; enrichment and validation
+   * use the standard deep-search economics on top.
+   *
+   * @param query - Persona prompt used to rank and validate discovered people.
+   * @param options - Source response plus hop, breadth, limit, and exclusion controls.
+   * @returns Response; poll with `get()` and read `structuredResponse` as
+   *   {@link EngagementExpansionOutput}.
+   */
+  async engagementExpansion(query, options) {
+    if (!query.trim())
+      throw new ValidationError("engagementExpansion requires a non-empty persona query");
+    const params = {
+      expandFromResponse: options?.expandFromResponse
+    };
+    if (options?.hops !== void 0)
+      params.hops = options.hops;
+    if (options?.postsPerHop !== void 0)
+      params.postsPerHop = options.postsPerHop;
+    if (options?.peoplePerNextHop !== void 0)
+      params.peoplePerNextHop = options.peoplePerNextHop;
+    if (options?.limit !== void 0)
+      params.limit = options.limit;
+    if (options?.excludeUrls !== void 0)
+      params.excludeUrls = options.excludeUrls;
+    if (options?.deepValidationUseRelevanceReranker !== void 0) {
+      params.deepValidationUseRelevanceReranker = options.deepValidationUseRelevanceReranker;
+    }
+    return this.create({
+      messages: [{ role: "user", content: query }],
+      specializedAgent: "engagement_expansion",
+      specializedAgentParams: params
+    });
+  }
   /**
    * Score people who reacted to or commented on competitor LinkedIn posts.
    *

package/dist/index.d.cts

@@ -836,8 +836,17 @@ interface ResolvedCompetitorTarget {
  * provenance (competitor, author, date). Multiple posts → multiple entries.
  */
 interface PostEngagementData {
+    /** Stable package key for the source post (engagement expansion). */
+    postKey?: string;
     /** LinkedIn post URL the person engaged with */
     postUrl: string;
+    /** Full source-post text when retained by the lane. */
+    postText?: string | null;
+    /** Source-post publication date; reaction payloads do not provide per-person timestamps. */
+    postPublished?: string | {
+        kind?: string;
+        value?: string;
+    } | null;
     /** How the person engaged */
     role: 'reactor' | 'commenter';
     /** Reaction type for reactors (e.g. LIKE, PRAISE, EMPATHY) */
@@ -850,12 +859,22 @@ interface PostEngagementData {
     postAuthorType?: 'company' | 'exec';
     /** Name of the post author (company or exec) */
     postAuthorName?: string;
+    /** Source-post author name used by engagement expansion. */
+    postAuthor?: string;
     /** LinkedIn URL of the post author */
     postAuthorUrl?: string;
     /** ISO timestamp of the post */
     postDate?: string;
     /** Total engagement on the post (reactions + comments) at selection time */
     engagementScore?: number;
+    /** One-based expansion hop that discovered this edge. */
+    hop?: number;
+    /** Expansion walk strategy that produced the edge. */
+    walk?: 'post_coengagement' | string;
+    /** Relevance assigned to the source post during curation. */
+    postRelevance?: number | null;
+    /** Source-package audience members who also engaged with this post. */
+    audienceEngagers?: string[];
     [key: string]: any;
 }
 /** @deprecated Use {@link PostEngagementData} */
@@ -1165,6 +1184,8 @@ interface ContentIntelligencePost {
     relevance?: number | null;
     totalReactions?: number | null;
     totalComments?: number | null;
+    /** Whether the source post includes video. The backend does not expose the media URL. */
+    hasVideo?: boolean;
     hybridScore?: number;
 }
 interface ContentIntelligencePackage {
@@ -1193,6 +1214,12 @@ interface PostIdea {
     idea: string;
     angle: string;
     citedPostKeys: string[];
+    /** Clickable source posts that inspired the idea. */
+    citedPosts: Array<{
+        key: string;
+        url?: string | null;
+        author?: string | null;
+    }>;
     draft: string;
     probability: number;
     keysExist: number;
@@ -1387,6 +1414,84 @@ interface ContentIntelligenceOutput {
     agentParams: ContentIntelligenceResolvedParams;
 }
 
+/** Options accepted by {@link ResponsesResource.engagementExpansion}. */
+interface EngagementExpansionOptions {
+    /** Finished content_intelligence response whose saved package seeds the walk. */
+    expandFromResponse: string;
+    /**
+     * Number of outward rounds to run. At the default limit, collection is
+     * approximately 300 credits for one hop and 1,060 for three hops.
+     * Enrichment and validation are additional. @default 1
+     */
+    hops?: number;
+    /**
+     * Answering posts to collect per hop at 5 credits each. Omit to derive
+     * breadth from `limit`: limits 25 or 50 derive 60 posts (300 credits),
+     * while limit 200 derives 240 posts (1,200 credits).
+     */
+    postsPerHop?: number;
+    /** Highest-fit people whose feeds seed the next hop. Ignored for one hop. @default 20 */
+    peoplePerNextHop?: number;
+    /** Maximum validated people returned. @default 50 */
+    limit?: number;
+    /** LinkedIn profile URLs excluded in addition to the source package's audience. */
+    excludeUrls?: string[];
+    /** SLM relevance reranker for surfaced candidates. @default true */
+    deepValidationUseRelevanceReranker?: boolean;
+}
+/** Resolved parameters echoed in `structuredResponse.agentParams`. */
+interface EngagementExpansionResolvedParams {
+    expandFromResponse: string;
+    hops: number;
+    postsPerHop?: number | null;
+    peoplePerNextHop: number;
+    limit: number;
+    excludeUrls?: string[] | null;
+}
+/** Collection statistics for one expansion hop. */
+interface EngagementExpansionHopStats {
+    hop: number;
+    postsPulled: number;
+    newPeople: number;
+    refinds: number;
+    refindsMergedAsNewEdges: number;
+    authorColleaguesExcluded: number;
+    credits: number;
+    stopReason: string;
+}
+/** Collection and finalist-history accounting for an expansion run. */
+interface EngagementExpansionStats {
+    hopsRun: number;
+    hopsRequested: number;
+    postsPerHop: number;
+    postsPerHopSource: 'requested' | 'derived';
+    /** Hop collection only; enrichment and validation use standard deep-search economics. */
+    collectionCreditsSpent: number;
+    collectionCreditCeiling: number;
+    stopReason: string;
+    perHop: EngagementExpansionHopStats[];
+    /** Credits spent loading broader engagement history for finalists. */
+    finalistHistoryCredits?: number;
+    /** Finalists for whom broader engagement history was available. */
+    finalistsWithHistory?: number;
+}
+/** A recent LinkedIn reaction used to give validation broader behavioral context. */
+interface EngagementHistoryEntry {
+    when?: string | null;
+    reactionType?: string | null;
+    postAuthor?: string | null;
+    postUrl?: string | null;
+    postText?: string | null;
+}
+/** Full structured output from a succeeded `engagement_expansion` run. */
+interface EngagementExpansionOutput {
+    /** Validated candidates, preserving the backend's scoring order and capped to `limit`. */
+    candidates: ValidatedCandidate[];
+    criteria?: CriteriaMetadata;
+    expansionStats?: EngagementExpansionStats;
+    agentParams: EngagementExpansionResolvedParams;
+}
+
 /**
  * Available people search data sources
  */
@@ -1815,6 +1920,12 @@ interface ValidatedCandidate {
     currentCompany?: string;
     /** Location */
     location?: string;
+    /** Location resolved by validation, including an evidence-based inference when needed. */
+    primaryLocation?: string | null;
+    /** Evidence and reasoning used to resolve `primaryLocation`. */
+    locationReasoning?: string | null;
+    /** Provenance for an inferred `location`, such as `inferred:validation`. */
+    locationSource?: string | null;
     /** Profile picture URL */
     profilePictureUrl?: string;
     /** Overall match score (0-10) */
@@ -1827,6 +1938,8 @@ interface ValidatedCandidate {
     criterionResults?: CriterionResult[];
     /** Criterion results emitted by deep_people_search and people_scoring. */
     deepCriteria?: CriterionResult[];
+    /** Number of criteria actually judged by an LLM; zero means the candidate was unjudged. */
+    criteriaJudged?: number;
     /** Warnings about criteria that couldn't be fully verified */
     criteriaQualityWarnings?: string[];
     /** Explanation of LinkedIn engagement relevance (if applicable) */
@@ -1858,6 +1971,17 @@ interface ValidatedCandidate {
     relevanceTier?: RelevanceTier;
     /** One-line reranker justification grounded in candidate data. */
     relevanceReason?: string;
+    /**
+     * Backend-authored delivery tier. Current runs use 3 for judged/in-region,
+     * 2 for judged/out-of-region, and 0 for unjudged. Tier 1 may exist on older responses.
+     */
+    rankTier?: 0 | 1 | 2 | 3;
+    /** Whether the candidate satisfies the search's location requirement. */
+    geoOk?: boolean;
+    /** Model's direct answer to the location requirement, when one exists. */
+    llmRegionMatch?: boolean | null;
+    /** Reasoning behind `llmRegionMatch`. */
+    llmRegionMatchReasoning?: string | null;
     /**
      * Primary current operating role from the reranker (main full-time job, not side/advisory).
      * Also written to `currentTitle` when present.
@@ -1873,13 +1997,12 @@ interface ValidatedCandidate {
     enrichedCurrentCompany?: string;
     /**
      * True when the candidate failed at least one universal or post_hard (must-have) criterion.
-     * Demoted candidates (`anyUniversalFailed` or `backfilled`) sort after passing ones regardless
-     * of relevance score.
+     * This affects scoring and routing but no longer forces a lower delivery tier.
      */
     anyUniversalFailed?: boolean;
     /**
      * True when promoted from excluded to meet the requested count despite failing hard
-     * criteria. Such candidates sort after passing ones; use to segregate or badge them.
+     * criteria. This is useful for display and auditing but no longer forces a lower rank tier.
      */
     backfilled?: boolean;
     /**
@@ -1890,6 +2013,12 @@ interface ValidatedCandidate {
      * competitor_post_engagement (with competitor provenance joined in).
      */
     engagementData?: PostEngagementData[];
+    /** Broader recent reaction history loaded for engagement-expansion finalists. */
+    engagementHistory?: EngagementHistoryEntry[];
+    /** Number of history records found while preparing a later expansion hop. */
+    engagementHistoryCount?: number;
+    /** True when a later hop found this person through an additional independent post. */
+    refoundOnNewPost?: boolean;
     /** Source of candidate data */
     source?: string;
     /** When source is job_signal: hiring-company context from CrustData job listings */
@@ -2000,12 +2129,14 @@ interface StructuredResponse extends Record<string, any> {
     outputs?: ContentIntelligenceOutputs;
     coverage?: ContentIntelligenceCoverage;
     audienceStats?: ContentIntelligenceAudienceStats | Record<string, never>;
+    /** Engagement expansion output (when using engagement_expansion agent). */
+    expansionStats?: EngagementExpansionStats;
 }
 /**
  * Available specialized agents
  * Using a union type that can be extended with any string to support future agents
  */
-type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | 'people_scoring' | 'competitor_post_engagement' | 'competitor_rep_engagement' | 'content_intelligence' | (string & {});
+type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | 'people_scoring' | 'competitor_post_engagement' | 'competitor_rep_engagement' | 'content_intelligence' | 'engagement_expansion' | (string & {});
 /**
  * Shared posts date-range enum (deep_people_search, competitor_post_engagement,
  * competitor_rep_engagement).
@@ -2119,6 +2250,16 @@ interface SpecializedAgentParams {
      * Used by content_intelligence.
      */
     outputs?: ContentIntelligenceOutputName[];
+    /** Saved content-intelligence response whose package seeds the expansion. */
+    expandFromResponse?: string;
+    /** Outward rounds to walk. Minimum 1; defaults to 1. */
+    hops?: number;
+    /** Answering posts per hop. Minimum 1; omitted derives breadth from `limit`. */
+    postsPerHop?: number;
+    /** Highest-fit people carried into the next hop. Minimum 1; defaults to 20. */
+    peoplePerNextHop?: number;
+    /** LinkedIn profile URLs excluded in addition to the source package audience. */
+    excludeUrls?: string[];
     /**
      * Results requested from each Exa query in the people-search research lane.
      * Minimum 1; omitted uses the lane default of 100.
@@ -2517,7 +2658,7 @@ interface CreateResponseRequest {
      * Route to a specialized agent instead of the main Lumnis agent
      * Known agents: 'quick_people_search', 'deep_people_search', 'people_scoring',
      * 'competitor_post_engagement', 'competitor_rep_engagement',
-     * 'content_intelligence'
+     * 'content_intelligence', 'engagement_expansion'
      * Accepts any string to support future agents without SDK updates
      */
     specializedAgent?: SpecializedAgentType;
@@ -6325,6 +6466,7 @@ declare class ResponsesResource {
     private _validateCompetitorPostEngagementParams;
     private _validateCompetitorRepEngagementParams;
     private _validateContentIntelligenceParams;
+    private _validateEngagementExpansionParams;
     private _validateCriteriaParams;
     private _validateFileReference;
     /**
@@ -6529,6 +6671,22 @@ declare class ResponsesResource {
      *   Omit `outputs` to use the backend's default set.
      */
     contentIntelligence(query: string, options?: ContentIntelligenceOptions): Promise<CreateResponseResponse>;
+    /**
+     * Find new people by walking outward from a saved content-intelligence package.
+     *
+     * Hop 1 pulls the other engagers of the package's best posts. Additional hops
+     * select the highest-fit new people, rank posts from their feeds, and pull the
+     * engagers of those posts. Collection breadth is derived from `limit` unless
+     * `postsPerHop` is set explicitly. At the default limit, collection is about
+     * 300 credits for one hop and 1,060 for three hops; enrichment and validation
+     * use the standard deep-search economics on top.
+     *
+     * @param query - Persona prompt used to rank and validate discovered people.
+     * @param options - Source response plus hop, breadth, limit, and exclusion controls.
+     * @returns Response; poll with `get()` and read `structuredResponse` as
+     *   {@link EngagementExpansionOutput}.
+     */
+    engagementExpansion(query: string, options: EngagementExpansionOptions): Promise<CreateResponseResponse>;
     /**
      * Score people who reacted to or commented on competitor LinkedIn posts.
      *
@@ -8181,4 +8339,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 ColumnKind, 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 ContentIntelligenceAudienceStats, type ContentIntelligenceAuthor, type ContentIntelligenceCoverage, type ContentIntelligenceCoveragePerson, type ContentIntelligenceCurationStats, type ContentIntelligenceDateValue, type ContentIntelligenceEngager, type ContentIntelligenceOptions, type ContentIntelligenceOutput, type ContentIntelligenceOutputName, type ContentIntelligenceOutputs, type ContentIntelligencePackage, type ContentIntelligencePost, type ContentIntelligenceResolvedParams, type ContentIntelligenceSummary, 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 CrmContactInput, 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 EngagementAnalysisOutput, type EngagementAnalysisScope, 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 Opportunity, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PainPoint, type PauseProspectsRequest, type PauseProspectsResponse, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PeriodInsight, 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 PostIdea, type PostIdeasOutput, 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, type ResumeProspectsRequest, 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 StandoutPost, 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 Takeaway, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThemeAssignment, type ThemePeriodStats, type ThemeStats, type ThemeTrend, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TopPost, type TopPostsOutput, type TopVoice, 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 ColumnKind, 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 ContentIntelligenceAudienceStats, type ContentIntelligenceAuthor, type ContentIntelligenceCoverage, type ContentIntelligenceCoveragePerson, type ContentIntelligenceCurationStats, type ContentIntelligenceDateValue, type ContentIntelligenceEngager, type ContentIntelligenceOptions, type ContentIntelligenceOutput, type ContentIntelligenceOutputName, type ContentIntelligenceOutputs, type ContentIntelligencePackage, type ContentIntelligencePost, type ContentIntelligenceResolvedParams, type ContentIntelligenceSummary, 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 CrmContactInput, 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 EngagementAnalysisOutput, type EngagementAnalysisScope, type EngagementExpansionHopStats, type EngagementExpansionOptions, type EngagementExpansionOutput, type EngagementExpansionResolvedParams, type EngagementExpansionStats, type EngagementHistoryEntry, 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 Opportunity, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PainPoint, type PauseProspectsRequest, type PauseProspectsResponse, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PeriodInsight, 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 PostIdea, type PostIdeasOutput, 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, type ResumeProspectsRequest, 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 StandoutPost, 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 Takeaway, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThemeAssignment, type ThemePeriodStats, type ThemeStats, type ThemeTrend, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TopPost, type TopPostsOutput, type TopVoice, 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

@@ -836,8 +836,17 @@ interface ResolvedCompetitorTarget {
  * provenance (competitor, author, date). Multiple posts → multiple entries.
  */
 interface PostEngagementData {
+    /** Stable package key for the source post (engagement expansion). */
+    postKey?: string;
     /** LinkedIn post URL the person engaged with */
     postUrl: string;
+    /** Full source-post text when retained by the lane. */
+    postText?: string | null;
+    /** Source-post publication date; reaction payloads do not provide per-person timestamps. */
+    postPublished?: string | {
+        kind?: string;
+        value?: string;
+    } | null;
     /** How the person engaged */
     role: 'reactor' | 'commenter';
     /** Reaction type for reactors (e.g. LIKE, PRAISE, EMPATHY) */
@@ -850,12 +859,22 @@ interface PostEngagementData {
     postAuthorType?: 'company' | 'exec';
     /** Name of the post author (company or exec) */
     postAuthorName?: string;
+    /** Source-post author name used by engagement expansion. */
+    postAuthor?: string;
     /** LinkedIn URL of the post author */
     postAuthorUrl?: string;
     /** ISO timestamp of the post */
     postDate?: string;
     /** Total engagement on the post (reactions + comments) at selection time */
     engagementScore?: number;
+    /** One-based expansion hop that discovered this edge. */
+    hop?: number;
+    /** Expansion walk strategy that produced the edge. */
+    walk?: 'post_coengagement' | string;
+    /** Relevance assigned to the source post during curation. */
+    postRelevance?: number | null;
+    /** Source-package audience members who also engaged with this post. */
+    audienceEngagers?: string[];
     [key: string]: any;
 }
 /** @deprecated Use {@link PostEngagementData} */
@@ -1165,6 +1184,8 @@ interface ContentIntelligencePost {
     relevance?: number | null;
     totalReactions?: number | null;
     totalComments?: number | null;
+    /** Whether the source post includes video. The backend does not expose the media URL. */
+    hasVideo?: boolean;
     hybridScore?: number;
 }
 interface ContentIntelligencePackage {
@@ -1193,6 +1214,12 @@ interface PostIdea {
     idea: string;
     angle: string;
     citedPostKeys: string[];
+    /** Clickable source posts that inspired the idea. */
+    citedPosts: Array<{
+        key: string;
+        url?: string | null;
+        author?: string | null;
+    }>;
     draft: string;
     probability: number;
     keysExist: number;
@@ -1387,6 +1414,84 @@ interface ContentIntelligenceOutput {
     agentParams: ContentIntelligenceResolvedParams;
 }
 
+/** Options accepted by {@link ResponsesResource.engagementExpansion}. */
+interface EngagementExpansionOptions {
+    /** Finished content_intelligence response whose saved package seeds the walk. */
+    expandFromResponse: string;
+    /**
+     * Number of outward rounds to run. At the default limit, collection is
+     * approximately 300 credits for one hop and 1,060 for three hops.
+     * Enrichment and validation are additional. @default 1
+     */
+    hops?: number;
+    /**
+     * Answering posts to collect per hop at 5 credits each. Omit to derive
+     * breadth from `limit`: limits 25 or 50 derive 60 posts (300 credits),
+     * while limit 200 derives 240 posts (1,200 credits).
+     */
+    postsPerHop?: number;
+    /** Highest-fit people whose feeds seed the next hop. Ignored for one hop. @default 20 */
+    peoplePerNextHop?: number;
+    /** Maximum validated people returned. @default 50 */
+    limit?: number;
+    /** LinkedIn profile URLs excluded in addition to the source package's audience. */
+    excludeUrls?: string[];
+    /** SLM relevance reranker for surfaced candidates. @default true */
+    deepValidationUseRelevanceReranker?: boolean;
+}
+/** Resolved parameters echoed in `structuredResponse.agentParams`. */
+interface EngagementExpansionResolvedParams {
+    expandFromResponse: string;
+    hops: number;
+    postsPerHop?: number | null;
+    peoplePerNextHop: number;
+    limit: number;
+    excludeUrls?: string[] | null;
+}
+/** Collection statistics for one expansion hop. */
+interface EngagementExpansionHopStats {
+    hop: number;
+    postsPulled: number;
+    newPeople: number;
+    refinds: number;
+    refindsMergedAsNewEdges: number;
+    authorColleaguesExcluded: number;
+    credits: number;
+    stopReason: string;
+}
+/** Collection and finalist-history accounting for an expansion run. */
+interface EngagementExpansionStats {
+    hopsRun: number;
+    hopsRequested: number;
+    postsPerHop: number;
+    postsPerHopSource: 'requested' | 'derived';
+    /** Hop collection only; enrichment and validation use standard deep-search economics. */
+    collectionCreditsSpent: number;
+    collectionCreditCeiling: number;
+    stopReason: string;
+    perHop: EngagementExpansionHopStats[];
+    /** Credits spent loading broader engagement history for finalists. */
+    finalistHistoryCredits?: number;
+    /** Finalists for whom broader engagement history was available. */
+    finalistsWithHistory?: number;
+}
+/** A recent LinkedIn reaction used to give validation broader behavioral context. */
+interface EngagementHistoryEntry {
+    when?: string | null;
+    reactionType?: string | null;
+    postAuthor?: string | null;
+    postUrl?: string | null;
+    postText?: string | null;
+}
+/** Full structured output from a succeeded `engagement_expansion` run. */
+interface EngagementExpansionOutput {
+    /** Validated candidates, preserving the backend's scoring order and capped to `limit`. */
+    candidates: ValidatedCandidate[];
+    criteria?: CriteriaMetadata;
+    expansionStats?: EngagementExpansionStats;
+    agentParams: EngagementExpansionResolvedParams;
+}
+
 /**
  * Available people search data sources
  */
@@ -1815,6 +1920,12 @@ interface ValidatedCandidate {
     currentCompany?: string;
     /** Location */
     location?: string;
+    /** Location resolved by validation, including an evidence-based inference when needed. */
+    primaryLocation?: string | null;
+    /** Evidence and reasoning used to resolve `primaryLocation`. */
+    locationReasoning?: string | null;
+    /** Provenance for an inferred `location`, such as `inferred:validation`. */
+    locationSource?: string | null;
     /** Profile picture URL */
     profilePictureUrl?: string;
     /** Overall match score (0-10) */
@@ -1827,6 +1938,8 @@ interface ValidatedCandidate {
     criterionResults?: CriterionResult[];
     /** Criterion results emitted by deep_people_search and people_scoring. */
     deepCriteria?: CriterionResult[];
+    /** Number of criteria actually judged by an LLM; zero means the candidate was unjudged. */
+    criteriaJudged?: number;
     /** Warnings about criteria that couldn't be fully verified */
     criteriaQualityWarnings?: string[];
     /** Explanation of LinkedIn engagement relevance (if applicable) */
@@ -1858,6 +1971,17 @@ interface ValidatedCandidate {
     relevanceTier?: RelevanceTier;
     /** One-line reranker justification grounded in candidate data. */
     relevanceReason?: string;
+    /**
+     * Backend-authored delivery tier. Current runs use 3 for judged/in-region,
+     * 2 for judged/out-of-region, and 0 for unjudged. Tier 1 may exist on older responses.
+     */
+    rankTier?: 0 | 1 | 2 | 3;
+    /** Whether the candidate satisfies the search's location requirement. */
+    geoOk?: boolean;
+    /** Model's direct answer to the location requirement, when one exists. */
+    llmRegionMatch?: boolean | null;
+    /** Reasoning behind `llmRegionMatch`. */
+    llmRegionMatchReasoning?: string | null;
     /**
      * Primary current operating role from the reranker (main full-time job, not side/advisory).
      * Also written to `currentTitle` when present.
@@ -1873,13 +1997,12 @@ interface ValidatedCandidate {
     enrichedCurrentCompany?: string;
     /**
      * True when the candidate failed at least one universal or post_hard (must-have) criterion.
-     * Demoted candidates (`anyUniversalFailed` or `backfilled`) sort after passing ones regardless
-     * of relevance score.
+     * This affects scoring and routing but no longer forces a lower delivery tier.
      */
     anyUniversalFailed?: boolean;
     /**
      * True when promoted from excluded to meet the requested count despite failing hard
-     * criteria. Such candidates sort after passing ones; use to segregate or badge them.
+     * criteria. This is useful for display and auditing but no longer forces a lower rank tier.
      */
     backfilled?: boolean;
     /**
@@ -1890,6 +2013,12 @@ interface ValidatedCandidate {
      * competitor_post_engagement (with competitor provenance joined in).
      */
     engagementData?: PostEngagementData[];
+    /** Broader recent reaction history loaded for engagement-expansion finalists. */
+    engagementHistory?: EngagementHistoryEntry[];
+    /** Number of history records found while preparing a later expansion hop. */
+    engagementHistoryCount?: number;
+    /** True when a later hop found this person through an additional independent post. */
+    refoundOnNewPost?: boolean;
     /** Source of candidate data */
     source?: string;
     /** When source is job_signal: hiring-company context from CrustData job listings */
@@ -2000,12 +2129,14 @@ interface StructuredResponse extends Record<string, any> {
     outputs?: ContentIntelligenceOutputs;
     coverage?: ContentIntelligenceCoverage;
     audienceStats?: ContentIntelligenceAudienceStats | Record<string, never>;
+    /** Engagement expansion output (when using engagement_expansion agent). */
+    expansionStats?: EngagementExpansionStats;
 }
 /**
  * Available specialized agents
  * Using a union type that can be extended with any string to support future agents
  */
-type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | 'people_scoring' | 'competitor_post_engagement' | 'competitor_rep_engagement' | 'content_intelligence' | (string & {});
+type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | 'people_scoring' | 'competitor_post_engagement' | 'competitor_rep_engagement' | 'content_intelligence' | 'engagement_expansion' | (string & {});
 /**
  * Shared posts date-range enum (deep_people_search, competitor_post_engagement,
  * competitor_rep_engagement).
@@ -2119,6 +2250,16 @@ interface SpecializedAgentParams {
      * Used by content_intelligence.
      */
     outputs?: ContentIntelligenceOutputName[];
+    /** Saved content-intelligence response whose package seeds the expansion. */
+    expandFromResponse?: string;
+    /** Outward rounds to walk. Minimum 1; defaults to 1. */
+    hops?: number;
+    /** Answering posts per hop. Minimum 1; omitted derives breadth from `limit`. */
+    postsPerHop?: number;
+    /** Highest-fit people carried into the next hop. Minimum 1; defaults to 20. */
+    peoplePerNextHop?: number;
+    /** LinkedIn profile URLs excluded in addition to the source package audience. */
+    excludeUrls?: string[];
     /**
      * Results requested from each Exa query in the people-search research lane.
      * Minimum 1; omitted uses the lane default of 100.
@@ -2517,7 +2658,7 @@ interface CreateResponseRequest {
      * Route to a specialized agent instead of the main Lumnis agent
      * Known agents: 'quick_people_search', 'deep_people_search', 'people_scoring',
      * 'competitor_post_engagement', 'competitor_rep_engagement',
-     * 'content_intelligence'
+     * 'content_intelligence', 'engagement_expansion'
      * Accepts any string to support future agents without SDK updates
      */
     specializedAgent?: SpecializedAgentType;
@@ -6325,6 +6466,7 @@ declare class ResponsesResource {
     private _validateCompetitorPostEngagementParams;
     private _validateCompetitorRepEngagementParams;
     private _validateContentIntelligenceParams;
+    private _validateEngagementExpansionParams;
     private _validateCriteriaParams;
     private _validateFileReference;
     /**
@@ -6529,6 +6671,22 @@ declare class ResponsesResource {
      *   Omit `outputs` to use the backend's default set.
      */
     contentIntelligence(query: string, options?: ContentIntelligenceOptions): Promise<CreateResponseResponse>;
+    /**
+     * Find new people by walking outward from a saved content-intelligence package.
+     *
+     * Hop 1 pulls the other engagers of the package's best posts. Additional hops
+     * select the highest-fit new people, rank posts from their feeds, and pull the
+     * engagers of those posts. Collection breadth is derived from `limit` unless
+     * `postsPerHop` is set explicitly. At the default limit, collection is about
+     * 300 credits for one hop and 1,060 for three hops; enrichment and validation
+     * use the standard deep-search economics on top.
+     *
+     * @param query - Persona prompt used to rank and validate discovered people.
+     * @param options - Source response plus hop, breadth, limit, and exclusion controls.
+     * @returns Response; poll with `get()` and read `structuredResponse` as
+     *   {@link EngagementExpansionOutput}.
+     */
+    engagementExpansion(query: string, options: EngagementExpansionOptions): Promise<CreateResponseResponse>;
     /**
      * Score people who reacted to or commented on competitor LinkedIn posts.
      *
@@ -8181,4 +8339,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 ColumnKind, 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 ContentIntelligenceAudienceStats, type ContentIntelligenceAuthor, type ContentIntelligenceCoverage, type ContentIntelligenceCoveragePerson, type ContentIntelligenceCurationStats, type ContentIntelligenceDateValue, type ContentIntelligenceEngager, type ContentIntelligenceOptions, type ContentIntelligenceOutput, type ContentIntelligenceOutputName, type ContentIntelligenceOutputs, type ContentIntelligencePackage, type ContentIntelligencePost, type ContentIntelligenceResolvedParams, type ContentIntelligenceSummary, 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 CrmContactInput, 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 EngagementAnalysisOutput, type EngagementAnalysisScope, 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 Opportunity, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PainPoint, type PauseProspectsRequest, type PauseProspectsResponse, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PeriodInsight, 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 PostIdea, type PostIdeasOutput, 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, type ResumeProspectsRequest, 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 StandoutPost, 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 Takeaway, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThemeAssignment, type ThemePeriodStats, type ThemeStats, type ThemeTrend, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TopPost, type TopPostsOutput, type TopVoice, 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 ColumnKind, 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 ContentIntelligenceAudienceStats, type ContentIntelligenceAuthor, type ContentIntelligenceCoverage, type ContentIntelligenceCoveragePerson, type ContentIntelligenceCurationStats, type ContentIntelligenceDateValue, type ContentIntelligenceEngager, type ContentIntelligenceOptions, type ContentIntelligenceOutput, type ContentIntelligenceOutputName, type ContentIntelligenceOutputs, type ContentIntelligencePackage, type ContentIntelligencePost, type ContentIntelligenceResolvedParams, type ContentIntelligenceSummary, 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 CrmContactInput, 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 EngagementAnalysisOutput, type EngagementAnalysisScope, type EngagementExpansionHopStats, type EngagementExpansionOptions, type EngagementExpansionOutput, type EngagementExpansionResolvedParams, type EngagementExpansionStats, type EngagementHistoryEntry, 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 Opportunity, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PainPoint, type PauseProspectsRequest, type PauseProspectsResponse, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PeriodInsight, 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 PostIdea, type PostIdeasOutput, 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, type ResumeProspectsRequest, 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 StandoutPost, 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 Takeaway, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThemeAssignment, type ThemePeriodStats, type ThemeStats, type ThemeTrend, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TopPost, type TopPostsOutput, type TopVoice, 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

@@ -836,8 +836,17 @@ interface ResolvedCompetitorTarget {
  * provenance (competitor, author, date). Multiple posts → multiple entries.
  */
 interface PostEngagementData {
+    /** Stable package key for the source post (engagement expansion). */
+    postKey?: string;
     /** LinkedIn post URL the person engaged with */
     postUrl: string;
+    /** Full source-post text when retained by the lane. */
+    postText?: string | null;
+    /** Source-post publication date; reaction payloads do not provide per-person timestamps. */
+    postPublished?: string | {
+        kind?: string;
+        value?: string;
+    } | null;
     /** How the person engaged */
     role: 'reactor' | 'commenter';
     /** Reaction type for reactors (e.g. LIKE, PRAISE, EMPATHY) */
@@ -850,12 +859,22 @@ interface PostEngagementData {
     postAuthorType?: 'company' | 'exec';
     /** Name of the post author (company or exec) */
     postAuthorName?: string;
+    /** Source-post author name used by engagement expansion. */
+    postAuthor?: string;
     /** LinkedIn URL of the post author */
     postAuthorUrl?: string;
     /** ISO timestamp of the post */
     postDate?: string;
     /** Total engagement on the post (reactions + comments) at selection time */
     engagementScore?: number;
+    /** One-based expansion hop that discovered this edge. */
+    hop?: number;
+    /** Expansion walk strategy that produced the edge. */
+    walk?: 'post_coengagement' | string;
+    /** Relevance assigned to the source post during curation. */
+    postRelevance?: number | null;
+    /** Source-package audience members who also engaged with this post. */
+    audienceEngagers?: string[];
     [key: string]: any;
 }
 /** @deprecated Use {@link PostEngagementData} */
@@ -1165,6 +1184,8 @@ interface ContentIntelligencePost {
     relevance?: number | null;
     totalReactions?: number | null;
     totalComments?: number | null;
+    /** Whether the source post includes video. The backend does not expose the media URL. */
+    hasVideo?: boolean;
     hybridScore?: number;
 }
 interface ContentIntelligencePackage {
@@ -1193,6 +1214,12 @@ interface PostIdea {
     idea: string;
     angle: string;
     citedPostKeys: string[];
+    /** Clickable source posts that inspired the idea. */
+    citedPosts: Array<{
+        key: string;
+        url?: string | null;
+        author?: string | null;
+    }>;
     draft: string;
     probability: number;
     keysExist: number;
@@ -1387,6 +1414,84 @@ interface ContentIntelligenceOutput {
     agentParams: ContentIntelligenceResolvedParams;
 }
 
+/** Options accepted by {@link ResponsesResource.engagementExpansion}. */
+interface EngagementExpansionOptions {
+    /** Finished content_intelligence response whose saved package seeds the walk. */
+    expandFromResponse: string;
+    /**
+     * Number of outward rounds to run. At the default limit, collection is
+     * approximately 300 credits for one hop and 1,060 for three hops.
+     * Enrichment and validation are additional. @default 1
+     */
+    hops?: number;
+    /**
+     * Answering posts to collect per hop at 5 credits each. Omit to derive
+     * breadth from `limit`: limits 25 or 50 derive 60 posts (300 credits),
+     * while limit 200 derives 240 posts (1,200 credits).
+     */
+    postsPerHop?: number;
+    /** Highest-fit people whose feeds seed the next hop. Ignored for one hop. @default 20 */
+    peoplePerNextHop?: number;
+    /** Maximum validated people returned. @default 50 */
+    limit?: number;
+    /** LinkedIn profile URLs excluded in addition to the source package's audience. */
+    excludeUrls?: string[];
+    /** SLM relevance reranker for surfaced candidates. @default true */
+    deepValidationUseRelevanceReranker?: boolean;
+}
+/** Resolved parameters echoed in `structuredResponse.agentParams`. */
+interface EngagementExpansionResolvedParams {
+    expandFromResponse: string;
+    hops: number;
+    postsPerHop?: number | null;
+    peoplePerNextHop: number;
+    limit: number;
+    excludeUrls?: string[] | null;
+}
+/** Collection statistics for one expansion hop. */
+interface EngagementExpansionHopStats {
+    hop: number;
+    postsPulled: number;
+    newPeople: number;
+    refinds: number;
+    refindsMergedAsNewEdges: number;
+    authorColleaguesExcluded: number;
+    credits: number;
+    stopReason: string;
+}
+/** Collection and finalist-history accounting for an expansion run. */
+interface EngagementExpansionStats {
+    hopsRun: number;
+    hopsRequested: number;
+    postsPerHop: number;
+    postsPerHopSource: 'requested' | 'derived';
+    /** Hop collection only; enrichment and validation use standard deep-search economics. */
+    collectionCreditsSpent: number;
+    collectionCreditCeiling: number;
+    stopReason: string;
+    perHop: EngagementExpansionHopStats[];
+    /** Credits spent loading broader engagement history for finalists. */
+    finalistHistoryCredits?: number;
+    /** Finalists for whom broader engagement history was available. */
+    finalistsWithHistory?: number;
+}
+/** A recent LinkedIn reaction used to give validation broader behavioral context. */
+interface EngagementHistoryEntry {
+    when?: string | null;
+    reactionType?: string | null;
+    postAuthor?: string | null;
+    postUrl?: string | null;
+    postText?: string | null;
+}
+/** Full structured output from a succeeded `engagement_expansion` run. */
+interface EngagementExpansionOutput {
+    /** Validated candidates, preserving the backend's scoring order and capped to `limit`. */
+    candidates: ValidatedCandidate[];
+    criteria?: CriteriaMetadata;
+    expansionStats?: EngagementExpansionStats;
+    agentParams: EngagementExpansionResolvedParams;
+}
+
 /**
  * Available people search data sources
  */
@@ -1815,6 +1920,12 @@ interface ValidatedCandidate {
     currentCompany?: string;
     /** Location */
     location?: string;
+    /** Location resolved by validation, including an evidence-based inference when needed. */
+    primaryLocation?: string | null;
+    /** Evidence and reasoning used to resolve `primaryLocation`. */
+    locationReasoning?: string | null;
+    /** Provenance for an inferred `location`, such as `inferred:validation`. */
+    locationSource?: string | null;
     /** Profile picture URL */
     profilePictureUrl?: string;
     /** Overall match score (0-10) */
@@ -1827,6 +1938,8 @@ interface ValidatedCandidate {
     criterionResults?: CriterionResult[];
     /** Criterion results emitted by deep_people_search and people_scoring. */
     deepCriteria?: CriterionResult[];
+    /** Number of criteria actually judged by an LLM; zero means the candidate was unjudged. */
+    criteriaJudged?: number;
     /** Warnings about criteria that couldn't be fully verified */
     criteriaQualityWarnings?: string[];
     /** Explanation of LinkedIn engagement relevance (if applicable) */
@@ -1858,6 +1971,17 @@ interface ValidatedCandidate {
     relevanceTier?: RelevanceTier;
     /** One-line reranker justification grounded in candidate data. */
     relevanceReason?: string;
+    /**
+     * Backend-authored delivery tier. Current runs use 3 for judged/in-region,
+     * 2 for judged/out-of-region, and 0 for unjudged. Tier 1 may exist on older responses.
+     */
+    rankTier?: 0 | 1 | 2 | 3;
+    /** Whether the candidate satisfies the search's location requirement. */
+    geoOk?: boolean;
+    /** Model's direct answer to the location requirement, when one exists. */
+    llmRegionMatch?: boolean | null;
+    /** Reasoning behind `llmRegionMatch`. */
+    llmRegionMatchReasoning?: string | null;
     /**
      * Primary current operating role from the reranker (main full-time job, not side/advisory).
      * Also written to `currentTitle` when present.
@@ -1873,13 +1997,12 @@ interface ValidatedCandidate {
     enrichedCurrentCompany?: string;
     /**
      * True when the candidate failed at least one universal or post_hard (must-have) criterion.
-     * Demoted candidates (`anyUniversalFailed` or `backfilled`) sort after passing ones regardless
-     * of relevance score.
+     * This affects scoring and routing but no longer forces a lower delivery tier.
      */
     anyUniversalFailed?: boolean;
     /**
      * True when promoted from excluded to meet the requested count despite failing hard
-     * criteria. Such candidates sort after passing ones; use to segregate or badge them.
+     * criteria. This is useful for display and auditing but no longer forces a lower rank tier.
      */
     backfilled?: boolean;
     /**
@@ -1890,6 +2013,12 @@ interface ValidatedCandidate {
      * competitor_post_engagement (with competitor provenance joined in).
      */
     engagementData?: PostEngagementData[];
+    /** Broader recent reaction history loaded for engagement-expansion finalists. */
+    engagementHistory?: EngagementHistoryEntry[];
+    /** Number of history records found while preparing a later expansion hop. */
+    engagementHistoryCount?: number;
+    /** True when a later hop found this person through an additional independent post. */
+    refoundOnNewPost?: boolean;
     /** Source of candidate data */
     source?: string;
     /** When source is job_signal: hiring-company context from CrustData job listings */
@@ -2000,12 +2129,14 @@ interface StructuredResponse extends Record<string, any> {
     outputs?: ContentIntelligenceOutputs;
     coverage?: ContentIntelligenceCoverage;
     audienceStats?: ContentIntelligenceAudienceStats | Record<string, never>;
+    /** Engagement expansion output (when using engagement_expansion agent). */
+    expansionStats?: EngagementExpansionStats;
 }
 /**
  * Available specialized agents
  * Using a union type that can be extended with any string to support future agents
  */
-type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | 'people_scoring' | 'competitor_post_engagement' | 'competitor_rep_engagement' | 'content_intelligence' | (string & {});
+type SpecializedAgentType = 'quick_people_search' | 'deep_people_search' | 'people_scoring' | 'competitor_post_engagement' | 'competitor_rep_engagement' | 'content_intelligence' | 'engagement_expansion' | (string & {});
 /**
  * Shared posts date-range enum (deep_people_search, competitor_post_engagement,
  * competitor_rep_engagement).
@@ -2119,6 +2250,16 @@ interface SpecializedAgentParams {
      * Used by content_intelligence.
      */
     outputs?: ContentIntelligenceOutputName[];
+    /** Saved content-intelligence response whose package seeds the expansion. */
+    expandFromResponse?: string;
+    /** Outward rounds to walk. Minimum 1; defaults to 1. */
+    hops?: number;
+    /** Answering posts per hop. Minimum 1; omitted derives breadth from `limit`. */
+    postsPerHop?: number;
+    /** Highest-fit people carried into the next hop. Minimum 1; defaults to 20. */
+    peoplePerNextHop?: number;
+    /** LinkedIn profile URLs excluded in addition to the source package audience. */
+    excludeUrls?: string[];
     /**
      * Results requested from each Exa query in the people-search research lane.
      * Minimum 1; omitted uses the lane default of 100.
@@ -2517,7 +2658,7 @@ interface CreateResponseRequest {
      * Route to a specialized agent instead of the main Lumnis agent
      * Known agents: 'quick_people_search', 'deep_people_search', 'people_scoring',
      * 'competitor_post_engagement', 'competitor_rep_engagement',
-     * 'content_intelligence'
+     * 'content_intelligence', 'engagement_expansion'
      * Accepts any string to support future agents without SDK updates
      */
     specializedAgent?: SpecializedAgentType;
@@ -6325,6 +6466,7 @@ declare class ResponsesResource {
     private _validateCompetitorPostEngagementParams;
     private _validateCompetitorRepEngagementParams;
     private _validateContentIntelligenceParams;
+    private _validateEngagementExpansionParams;
     private _validateCriteriaParams;
     private _validateFileReference;
     /**
@@ -6529,6 +6671,22 @@ declare class ResponsesResource {
      *   Omit `outputs` to use the backend's default set.
      */
     contentIntelligence(query: string, options?: ContentIntelligenceOptions): Promise<CreateResponseResponse>;
+    /**
+     * Find new people by walking outward from a saved content-intelligence package.
+     *
+     * Hop 1 pulls the other engagers of the package's best posts. Additional hops
+     * select the highest-fit new people, rank posts from their feeds, and pull the
+     * engagers of those posts. Collection breadth is derived from `limit` unless
+     * `postsPerHop` is set explicitly. At the default limit, collection is about
+     * 300 credits for one hop and 1,060 for three hops; enrichment and validation
+     * use the standard deep-search economics on top.
+     *
+     * @param query - Persona prompt used to rank and validate discovered people.
+     * @param options - Source response plus hop, breadth, limit, and exclusion controls.
+     * @returns Response; poll with `get()` and read `structuredResponse` as
+     *   {@link EngagementExpansionOutput}.
+     */
+    engagementExpansion(query: string, options: EngagementExpansionOptions): Promise<CreateResponseResponse>;
     /**
      * Score people who reacted to or commented on competitor LinkedIn posts.
      *
@@ -8181,4 +8339,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 ColumnKind, 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 ContentIntelligenceAudienceStats, type ContentIntelligenceAuthor, type ContentIntelligenceCoverage, type ContentIntelligenceCoveragePerson, type ContentIntelligenceCurationStats, type ContentIntelligenceDateValue, type ContentIntelligenceEngager, type ContentIntelligenceOptions, type ContentIntelligenceOutput, type ContentIntelligenceOutputName, type ContentIntelligenceOutputs, type ContentIntelligencePackage, type ContentIntelligencePost, type ContentIntelligenceResolvedParams, type ContentIntelligenceSummary, 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 CrmContactInput, 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 EngagementAnalysisOutput, type EngagementAnalysisScope, 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 Opportunity, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PainPoint, type PauseProspectsRequest, type PauseProspectsResponse, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PeriodInsight, 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 PostIdea, type PostIdeasOutput, 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, type ResumeProspectsRequest, 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 StandoutPost, 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 Takeaway, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThemeAssignment, type ThemePeriodStats, type ThemeStats, type ThemeTrend, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TopPost, type TopPostsOutput, type TopVoice, 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 ColumnKind, 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 ContentIntelligenceAudienceStats, type ContentIntelligenceAuthor, type ContentIntelligenceCoverage, type ContentIntelligenceCoveragePerson, type ContentIntelligenceCurationStats, type ContentIntelligenceDateValue, type ContentIntelligenceEngager, type ContentIntelligenceOptions, type ContentIntelligenceOutput, type ContentIntelligenceOutputName, type ContentIntelligenceOutputs, type ContentIntelligencePackage, type ContentIntelligencePost, type ContentIntelligenceResolvedParams, type ContentIntelligenceSummary, 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 CrmContactInput, 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 EngagementAnalysisOutput, type EngagementAnalysisScope, type EngagementExpansionHopStats, type EngagementExpansionOptions, type EngagementExpansionOutput, type EngagementExpansionResolvedParams, type EngagementExpansionStats, type EngagementHistoryEntry, 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 Opportunity, type OutcomeType, type OutreachAssetCreate, type OutreachAssetResponse, type OutreachAssetType, type OutreachAssetUpdate, OutreachMethod, OutreachResource, type OutreachSource, type OutreachStats, type PaginationInfo, type PaginationParams, type PainPoint, type PauseProspectsRequest, type PauseProspectsResponse, type PauseResumeQueuedRequest, type PendingApprovalExtended, PeopleDataSource, PeopleResource, type PeopleSearchRequest, type PeopleSearchResponse, type PeriodInsight, 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 PostIdea, type PostIdeasOutput, 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, type ResumeProspectsRequest, 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 StandoutPost, 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 Takeaway, type TeardownOrgResponse, type TemplateShareConfig, type TemplateShareInfo, type TemplateShareRequest, type TemplateSharesResponse, type TenantDetailsResponse, TenantInfoResource, type TenantModelPreference, type TenantModelPreferencesResponse, type TestConnectionResponse, type ThemeAssignment, type ThemePeriodStats, type ThemeStats, type ThemeTrend, type ThreadListResponse, type ThreadObject, type ThreadResponsesParams, ThreadsResource, type ToolInfo, type TopPost, type TopPostsOutput, type TopVoice, 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

@@ -3390,6 +3390,32 @@ class ResponsesResource {
       }
     }
   }
+  _validateEngagementExpansionParams(params) {
+    const expandFromResponse = this._getParamValue(
+      params,
+      "expandFromResponse",
+      "expand_from_response"
+    );
+    if (typeof expandFromResponse !== "string" || !expandFromResponse.trim()) {
+      throw new ValidationError(
+        "expandFromResponse is required for engagement_expansion and must be a non-empty string"
+      );
+    }
+    for (const [camel, snake] of [
+      ["hops", "hops"],
+      ["postsPerHop", "posts_per_hop"],
+      ["peoplePerNextHop", "people_per_next_hop"],
+      ["limit", "limit"]
+    ]) {
+      const value = this._getParamValue(params, camel, snake);
+      if (value !== void 0 && (!Number.isInteger(value) || value < 1))
+        throw new ValidationError(`${camel} must be a positive integer for engagement_expansion`);
+    }
+    const excludeUrls = this._getParamValue(params, "excludeUrls", "exclude_urls");
+    if (excludeUrls !== void 0 && (!Array.isArray(excludeUrls) || excludeUrls.some((url) => typeof url !== "string"))) {
+      throw new ValidationError("excludeUrls must be an array of strings for engagement_expansion");
+    }
+  }
   _validateCriteriaParams(params, specializedAgent) {
     if (!params)
       return;
@@ -3503,6 +3529,8 @@ class ResponsesResource {
       this._validateCompetitorRepEngagementParams(rawParams);
     if (specializedAgent === "content_intelligence")
       this._validateContentIntelligenceParams(rawParams);
+    if (specializedAgent === "engagement_expansion")
+      this._validateEngagementExpansionParams(rawParams);
   }
   _validateFileReference(uri) {
     if (uri.startsWith("artifact_"))
@@ -3851,6 +3879,46 @@ class ResponsesResource {
       specializedAgentParams: params
     });
   }
+  /**
+   * Find new people by walking outward from a saved content-intelligence package.
+   *
+   * Hop 1 pulls the other engagers of the package's best posts. Additional hops
+   * select the highest-fit new people, rank posts from their feeds, and pull the
+   * engagers of those posts. Collection breadth is derived from `limit` unless
+   * `postsPerHop` is set explicitly. At the default limit, collection is about
+   * 300 credits for one hop and 1,060 for three hops; enrichment and validation
+   * use the standard deep-search economics on top.
+   *
+   * @param query - Persona prompt used to rank and validate discovered people.
+   * @param options - Source response plus hop, breadth, limit, and exclusion controls.
+   * @returns Response; poll with `get()` and read `structuredResponse` as
+   *   {@link EngagementExpansionOutput}.
+   */
+  async engagementExpansion(query, options) {
+    if (!query.trim())
+      throw new ValidationError("engagementExpansion requires a non-empty persona query");
+    const params = {
+      expandFromResponse: options?.expandFromResponse
+    };
+    if (options?.hops !== void 0)
+      params.hops = options.hops;
+    if (options?.postsPerHop !== void 0)
+      params.postsPerHop = options.postsPerHop;
+    if (options?.peoplePerNextHop !== void 0)
+      params.peoplePerNextHop = options.peoplePerNextHop;
+    if (options?.limit !== void 0)
+      params.limit = options.limit;
+    if (options?.excludeUrls !== void 0)
+      params.excludeUrls = options.excludeUrls;
+    if (options?.deepValidationUseRelevanceReranker !== void 0) {
+      params.deepValidationUseRelevanceReranker = options.deepValidationUseRelevanceReranker;
+    }
+    return this.create({
+      messages: [{ role: "user", content: query }],
+      specializedAgent: "engagement_expansion",
+      specializedAgentParams: params
+    });
+  }
   /**
    * Score people who reacted to or commented on competitor LinkedIn posts.
    *

package/package.json

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