@elevasis/sdk 1.52.1 → 1.54.0

package/reference/scaffold/reference/contracts.md

@@ -1780,7 +1780,9 @@ export const ListDealsQuerySchema = z
     batch: z.string().trim().min(1).max(255).optional(),
     staleSince: z.string().datetime().optional(),
     search: z.string().optional(),
-    limit: z.coerce.number().int().positive().default(50),
+    // Was unbounded (`.positive()`, no ceiling) — the one schema in this audit with no cap at all,
+    // worse than the hand-invented-max sites. Now shares the standard ceiling.
+    limit: PageLimitSchema.default(50),
     offset: z.coerce.number().int().min(0).default(0)
   })
   .strict()
@@ -2604,7 +2606,7 @@ export const ListCompaniesQuerySchema = z
     batchId: z.string().trim().min(1).max(255).optional(),
     status: AcqCompanyStatusSchema.optional(),
     includeAll: QueryBooleanSchema.optional(),
-    limit: z.coerce.number().int().min(1).max(5000).default(50),
+    limit: z.coerce.number().int().min(1).max(5000).default(DEFAULT_PAGE_LIMIT),
     offset: z.coerce.number().int().min(0).default(0)
   })
   .strict()
@@ -2620,7 +2622,10 @@ export const ListContactsQuerySchema = z
     openingLineIsNull: QueryBooleanSchema.optional(),
     batchId: z.string().trim().min(1).max(255).optional(),
     contactStatus: AcqContactStatusSchema.optional(),
-    limit: z.coerce.number().int().min(1).max(5000).default(5000),
+    // Defect: default equaled the max (5000), so every unqualified "list contacts" call fetched
+    // up to 5000 rows by default. The 5000 ceiling stays for callers that deliberately ask for a
+    // large page (mirrors ListCompaniesQuerySchema above); the default now matches it too.
+    limit: z.coerce.number().int().min(1).max(5000).default(DEFAULT_PAGE_LIMIT),
     offset: z.coerce.number().int().min(0).default(0)
   })
   .strict()
@@ -3223,102 +3228,102 @@ export interface StatefulPipelineDefinition {
 ### `PaginationParams`
 
 ```typescript
-export interface PaginationParams {
-  limit: number
-  offset: number
+export interface PaginationParams {
+  limit: number
+  offset: number
 }
 ```
 
 ### `PaginatedResult`
 
 ```typescript
-export interface PaginatedResult<T> {
-  data: T[]
-  total: number
-  limit: number
-  offset: number
+export interface PaginatedResult<T> {
+  data: T[]
+  total: number
+  limit: number
+  offset: number
 }
 ```
 
 ### `CreateListParams`
 
 ```typescript
-export interface CreateListParams {
-  organizationId: string
-  name: string
-  description?: string
-  type?: string
-  batchIds?: string[]
-  instantlyCampaignId?: string
-  status?: ListStatus
-  buildTemplateId?: string
-  metadata?: Record<string, unknown>
-  scrapingConfig?: ScrapingConfig
-  icp?: IcpRubric
-  pipelineConfig?: PipelineConfig
+export interface CreateListParams {
+  organizationId: string
+  name: string
+  description?: string
+  type?: string
+  batchIds?: string[]
+  instantlyCampaignId?: string
+  status?: ListStatus
+  buildTemplateId?: string
+  metadata?: Record<string, unknown>
+  scrapingConfig?: ScrapingConfig
+  icp?: IcpRubric
+  pipelineConfig?: PipelineConfig
 }
 ```
 
 ### `UpdateListParams`
 
 ```typescript
-export interface UpdateListParams {
-  name?: string
-  description?: string
-  batchIds?: string[]
+export interface UpdateListParams {
+  name?: string
+  description?: string
+  batchIds?: string[]
 }
 ```
 
 ### `CreateCompanyParams`
 
 ```typescript
-export interface CreateCompanyParams {
-  organizationId: string
-  name: string
-  domain?: string
-  linkedinUrl?: string
-  website?: string
-  numEmployees?: number
-  foundedYear?: number
-  locationCity?: string
-  locationState?: string
-  category?: string
-  source?: string
-  batchId?: string
-  verticalResearch?: string
-  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
-  pipelineStatus?: unknown
+export interface CreateCompanyParams {
+  organizationId: string
+  name: string
+  domain?: string
+  linkedinUrl?: string
+  website?: string
+  numEmployees?: number
+  foundedYear?: number
+  locationCity?: string
+  locationState?: string
+  category?: string
+  source?: string
+  batchId?: string
+  verticalResearch?: string
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
 }
 ```
 
 ### `UpdateCompanyParams`
 
 ```typescript
-export interface UpdateCompanyParams {
-  name?: string
-  domain?: string
-  linkedinUrl?: string
-  website?: string
-  numEmployees?: number
-  foundedYear?: number
-  locationCity?: string
-  locationState?: string
-  category?: string
-  segment?: string
-  processingState?: ProcessingState
-  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
-  pipelineStatus?: unknown
-  enrichmentData?: Record<string, unknown>
-  source?: string
-  batchId?: string
-  status?: 'active' | 'invalid'
-  verticalResearch?: string | null
-  /** Track A: flat qualification score column (null until a scoring rubric is defined) */
-  qualificationScore?: number | null
-  /** Track A: flat qualification signals jsonb */
-  qualificationSignals?: Record<string, unknown> | null
-  /** Track A: key identifying the rubric used for qualification */
-  qualificationRubricKey?: string | null
+export interface UpdateCompanyParams {
+  name?: string
+  domain?: string
+  linkedinUrl?: string
+  website?: string
+  numEmployees?: number
+  foundedYear?: number
+  locationCity?: string
+  locationState?: string
+  category?: string
+  segment?: string
+  processingState?: ProcessingState
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
+  enrichmentData?: Record<string, unknown>
+  source?: string
+  batchId?: string
+  status?: 'active' | 'invalid'
+  verticalResearch?: string | null
+  /** Track A: flat qualification score column (null until a scoring rubric is defined) */
+  qualificationScore?: number | null
+  /** Track A: flat qualification signals jsonb */
+  qualificationSignals?: Record<string, unknown> | null
+  /** Track A: key identifying the rubric used for qualification */
+  qualificationRubricKey?: string | null
 }
 ```
 
@@ -3331,63 +3336,63 @@ export type UpsertCompanyParams = CreateCompanyParams
 ### `CompanyFilters`
 
 ```typescript
-export interface CompanyFilters {
-  listId?: string // Filter to companies in a specific list (via acq_list_companies)
-  search?: string
-  domain?: string
-  website?: string
-  segment?: string
-  category?: string
-  processingState?: ProcessingState
-  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
-  pipelineStatus?: unknown
-  /** Exclude companies whose processing state contains this value (PostgREST NOT contains) */
-  processingStateNot?: ProcessingState
-  batchId?: string
-  status?: 'active' | 'invalid'
-  includeAll?: boolean
-  excludeColumns?: Array<'enrichmentData' | 'processingState'>
-  limit?: number
+export interface CompanyFilters {
+  listId?: string // Filter to companies in a specific list (via acq_list_companies)
+  search?: string
+  domain?: string
+  website?: string
+  segment?: string
+  category?: string
+  processingState?: ProcessingState
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
+  /** Exclude companies whose processing state contains this value (PostgREST NOT contains) */
+  processingStateNot?: ProcessingState
+  batchId?: string
+  status?: 'active' | 'invalid'
+  includeAll?: boolean
+  excludeColumns?: Array<'enrichmentData' | 'processingState'>
+  limit?: number
 }
 ```
 
 ### `CreateContactParams`
 
 ```typescript
-export interface CreateContactParams {
-  organizationId: string
-  email: string
-  companyId?: string
-  firstName?: string
-  lastName?: string
-  linkedinUrl?: string
-  title?: string
-  source?: string
-  sourceId?: string
-  batchId?: string
-  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
-  pipelineStatus?: unknown
+export interface CreateContactParams {
+  organizationId: string
+  email: string
+  companyId?: string
+  firstName?: string
+  lastName?: string
+  linkedinUrl?: string
+  title?: string
+  source?: string
+  sourceId?: string
+  batchId?: string
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
 }
 ```
 
 ### `UpdateContactParams`
 
 ```typescript
-export interface UpdateContactParams {
-  companyId?: string
-  emailValid?: 'VALID' | 'INVALID' | 'RISKY' | 'UNKNOWN'
-  firstName?: string
-  lastName?: string
-  linkedinUrl?: string
-  title?: string
-  headline?: string
-  filterReason?: string
-  openingLine?: string
-  processingState?: ProcessingState
-  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
-  pipelineStatus?: unknown
-  enrichmentData?: Record<string, unknown>
-  status?: 'active' | 'invalid'
+export interface UpdateContactParams {
+  companyId?: string
+  emailValid?: 'VALID' | 'INVALID' | 'RISKY' | 'UNKNOWN'
+  firstName?: string
+  lastName?: string
+  linkedinUrl?: string
+  title?: string
+  headline?: string
+  filterReason?: string
+  openingLine?: string
+  processingState?: ProcessingState
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
+  enrichmentData?: Record<string, unknown>
+  status?: 'active' | 'invalid'
 }
 ```
 
@@ -3400,89 +3405,89 @@ export type UpsertContactParams = CreateContactParams
 ### `ContactFilters`
 
 ```typescript
-export interface ContactFilters {
-  listId?: string // Filter to contacts in a specific list (via acq_list_members)
-  search?: string
-  openingLineIsNull?: boolean // Filter to contacts without personalization
-  processingState?: ProcessingState
-  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
-  pipelineStatus?: unknown
-  batchId?: string
-  contactStatus?: 'active' | 'invalid' // Filter by contact status (soft-delete flag)
+export interface ContactFilters {
+  listId?: string // Filter to contacts in a specific list (via acq_list_members)
+  search?: string
+  openingLineIsNull?: boolean // Filter to contacts without personalization
+  processingState?: ProcessingState
+  /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+  pipelineStatus?: unknown
+  batchId?: string
+  contactStatus?: 'active' | 'invalid' // Filter by contact status (soft-delete flag)
 }
 ```
 
 ### `UpsertSocialPostParams`
 
 ```typescript
-export interface UpsertSocialPostParams {
-  organizationId: string
-  platform: string
-  platformPostId: string
-  authorName: string
-  authorUrl?: string | null
-  postTitle: string
-  postText: string
-  postUrl: string
-  engagementCount?: number
-  commentsCount?: number
-  postedAt: string
-  metadata?: Record<string, unknown>
-  relevanceScore?: number
-  matchedKeywords?: string[]
-  matchedQuery?: string | null
-  initialDraft?: string | null
-  finalResponse?: string | null
-  sourceCategory?: string | null
+export interface UpsertSocialPostParams {
+  organizationId: string
+  platform: string
+  platformPostId: string
+  authorName: string
+  authorUrl?: string | null
+  postTitle: string
+  postText: string
+  postUrl: string
+  engagementCount?: number
+  commentsCount?: number
+  postedAt: string
+  metadata?: Record<string, unknown>
+  relevanceScore?: number
+  matchedKeywords?: string[]
+  matchedQuery?: string | null
+  initialDraft?: string | null
+  finalResponse?: string | null
+  sourceCategory?: string | null
 }
 ```
 
 ### `UpsertSocialPostsParams`
 
 ```typescript
-export interface UpsertSocialPostsParams {
-  organizationId: string
-  posts: Omit<UpsertSocialPostParams, 'organizationId'>[]
+export interface UpsertSocialPostsParams {
+  organizationId: string
+  posts: Omit<UpsertSocialPostParams, 'organizationId'>[]
 }
 ```
 
 ### `UpsertSocialPostsResult`
 
 ```typescript
-export interface UpsertSocialPostsResult {
-  inserted: number
-  duplicatesSkipped: number
+export interface UpsertSocialPostsResult {
+  inserted: number
+  duplicatesSkipped: number
 }
 ```
 
 ### `AddContactsToListParams`
 
 ```typescript
-export interface AddContactsToListParams {
-  organizationId: string
-  listId: string
-  contactIds: string[]
+export interface AddContactsToListParams {
+  organizationId: string
+  listId: string
+  contactIds: string[]
 }
 ```
 
 ### `AddContactsToListResult`
 
 ```typescript
-export interface AddContactsToListResult {
-  added: number
-  alreadyExisted: number
+export interface AddContactsToListResult {
+  added: number
+  alreadyExisted: number
 }
 ```
 
 ### `UpdateListConfigParams`
 
 ```typescript
-export interface UpdateListConfigParams {
-  organizationId: string
-  listId: string
-  scrapingConfig?: ScrapingConfig
-  icp?: IcpRubric
-  pipelineConfig?: PipelineConfig
+export interface UpdateListConfigParams {
+  organizationId: string
+  listId: string
+  scrapingConfig?: ScrapingConfig
+  icp?: IcpRubric
+  pipelineConfig?: PipelineConfig
 }
 ```
 
@@ -3517,48 +3522,48 @@ export interface UpdateContactStageParams {
 ### `AddCompaniesToListParams`
 
 ```typescript
-export interface AddCompaniesToListParams {
-  organizationId: string
-  listId: string
-  companyIds: string[]
+export interface AddCompaniesToListParams {
+  organizationId: string
+  listId: string
+  companyIds: string[]
 }
 ```
 
 ### `AddCompaniesToListResult`
 
 ```typescript
-export interface AddCompaniesToListResult {
-  added: number
-  alreadyExisted: number
+export interface AddCompaniesToListResult {
+  added: number
+  alreadyExisted: number
 }
 ```
 
 ### `RemoveCompaniesFromListParams`
 
 ```typescript
-export interface RemoveCompaniesFromListParams {
-  organizationId: string
-  listId: string
-  companyIds: string[]
+export interface RemoveCompaniesFromListParams {
+  organizationId: string
+  listId: string
+  companyIds: string[]
 }
 ```
 
 ### `RemoveCompaniesFromListResult`
 
 ```typescript
-export interface RemoveCompaniesFromListResult {
-  removed: number
+export interface RemoveCompaniesFromListResult {
+  removed: number
 }
 ```
 
 ### `RecordListExecutionParams`
 
 ```typescript
-export interface RecordListExecutionParams {
-  organizationId: string
-  listId: string
-  executionId: string
-  configSnapshot?: Record<string, unknown>
+export interface RecordListExecutionParams {
+  organizationId: string
+  listId: string
+  executionId: string
+  configSnapshot?: Record<string, unknown>
 }
 ```
 
@@ -3579,56 +3584,56 @@ export interface ListExecutionSummary {
 ### `BulkImportParams`
 
 ```typescript
-export interface BulkImportParams {
-  organizationId: string
-  contacts: CreateContactParams[]
-  listId?: string
+export interface BulkImportParams {
+  organizationId: string
+  contacts: CreateContactParams[]
+  listId?: string
 }
 ```
 
 ### `BulkImportResult`
 
 ```typescript
-export interface BulkImportResult {
-  created: number
-  updated: number
-  errors: Array<{ email: string; error: string }>
+export interface BulkImportResult {
+  created: number
+  updated: number
+  errors: Array<{ email: string; error: string }>
 }
 ```
 
 ### `BulkImportCompanyEntry`
 
 ```typescript
-export interface BulkImportCompanyEntry {
-  name: string
-  domain: string
-  website?: string
-  locationCity?: string
-  locationState?: string
-  category?: string
-  source?: string
-  enrichmentData?: Record<string, unknown>
-  processingState?: ProcessingState
+export interface BulkImportCompanyEntry {
+  name: string
+  domain: string
+  website?: string
+  locationCity?: string
+  locationState?: string
+  category?: string
+  source?: string
+  enrichmentData?: Record<string, unknown>
+  processingState?: ProcessingState
 }
 ```
 
 ### `BulkImportCompaniesParams`
 
 ```typescript
-export interface BulkImportCompaniesParams {
-  organizationId: string
-  batchId: string
-  companies: BulkImportCompanyEntry[]
+export interface BulkImportCompaniesParams {
+  organizationId: string
+  batchId: string
+  companies: BulkImportCompanyEntry[]
 }
 ```
 
 ### `BulkImportCompaniesResult`
 
 ```typescript
-export interface BulkImportCompaniesResult {
-  created: number
-  skipped: number
-  errors: Array<{ companyName: string; error: string }>
+export interface BulkImportCompaniesResult {
+  created: number
+  skipped: number
+  errors: Array<{ companyName: string; error: string }>
 }
 ```
 
@@ -3801,6 +3806,14 @@ export type ListToolMap = {
     params: Omit<UpdateContactStageParams, 'organizationId'>
     result: void
   }
+  bulkUpdateCompanyStage: {
+    params: Omit<BulkUpdateCompanyStageParams, 'organizationId'>
+    result: BulkUpdateCompanyStageResult
+  }
+  bulkUpdateContactStage: {
+    params: Omit<BulkUpdateContactStageParams, 'organizationId'>
+    result: BulkUpdateContactStageResult
+  }
   clearCompanyStages: {
     params: Omit<ClearCompanyStagesParams, 'organizationId'>
     result: void

package/reference/sdk/cli-management.mdx

@@ -1008,6 +1008,8 @@ elevasis-sdk content:source-asset <sourceAssetId>
 
 **API routes:** `GET /api/external/content/items`, `/api/external/content/items/:itemId`, `/api/external/content/queue`, `/api/external/content/pipelines`, `/api/external/content/pipelines/:id`, `/api/external/content/distributions`, `/api/external/content/source-assets`, `/api/external/content/source-assets/:sourceAssetId`.
 
+One more read is reachable over HTTP with no CLI command wrapping it: `GET /api/external/content/distributions/:distributionId/metrics` returns a distribution's metrics capture history, filterable by `source` and paged with `limit` / `offset`. `content:distributions` returns only the newest reading mirrored onto each distribution row, so an integration charting a series calls the route directly.
+
 ### content:review
 
 One of two write commands in this namespace. Everything else that writes to an item -- creating it, recording an attempt, opening a distribution -- is producer work through the `content` worker adapter, not a CLI command.