@elevasis/core 0.28.0 → 0.30.0

package/src/reference/_generated/contracts.md

@@ -1368,77 +1368,77 @@ export interface DeploymentSpec {
 ### `AcqCompany`
 
 ```typescript
-/**
- * Company record in the acquisition database.
- * Contains enriched company data from various sources.
- * Transformed from AcqCompanyRow with camelCase properties.
- */
-export interface AcqCompany {
-  id: string
-  organizationId: string
-  name: string
-  domain: string | null
-  linkedinUrl: string | null
-  website: string | null
-  numEmployees: number | null
-  foundedYear: number | null
-  locationCity: string | null
-  locationState: string | null
-  category: string | null
-  categoryPain: string | null
-  segment: string | null
-  processingState: CompanyProcessingState | null
-  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
-  pipelineStatus?: LegacyPipelineStatus | null
-  enrichmentData: CompanyEnrichmentData | null
-  source: string | null
-  batchId: string | null
-  status: 'active' | 'invalid'
-  verticalResearch: string | null
-  /** Track A: flat qualification score (null until a scoring rubric is defined). Added by W1 migration. */
-  qualificationScore: number | null
-  /** Track A: flat qualification signals jsonb preserving the result payload shape. Added by W1 migration. */
-  qualificationSignals: Record<string, unknown> | null
-  /** Track A: key identifying the rubric used for qualification. Added by W1 migration. */
-  qualificationRubricKey: string | null
-  createdAt: Date
-  updatedAt: Date
+/**
+ * Company record in the acquisition database.
+ * Contains enriched company data from various sources.
+ * Transformed from AcqCompanyRow with camelCase properties.
+ */
+export interface AcqCompany {
+  id: string
+  organizationId: string
+  name: string
+  domain: string | null
+  linkedinUrl: string | null
+  website: string | null
+  numEmployees: number | null
+  foundedYear: number | null
+  locationCity: string | null
+  locationState: string | null
+  category: string | null
+  categoryPain: string | null
+  segment: string | null
+  processingState: CompanyProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
+  enrichmentData: CompanyEnrichmentData | null
+  source: string | null
+  batchId: string | null
+  status: 'active' | 'invalid'
+  verticalResearch: string | null
+  /** Track A: flat qualification score (null until a scoring rubric is defined). Added by W1 migration. */
+  qualificationScore: number | null
+  /** Track A: flat qualification signals jsonb preserving the result payload shape. Added by W1 migration. */
+  qualificationSignals: Record<string, unknown> | null
+  /** Track A: key identifying the rubric used for qualification. Added by W1 migration. */
+  qualificationRubricKey: string | null
+  createdAt: Date
+  updatedAt: Date
 }
 ```
 
 ### `AcqContact`
 
 ```typescript
-/**
- * Contact record in the acquisition database.
- * Contains enriched contact data and personalization content.
- * Transformed from AcqContactRow with camelCase properties.
- */
-export interface AcqContact {
-  id: string
-  organizationId: string
-  companyId: string | null
-  email: string
-  emailValid: 'VALID' | 'INVALID' | 'RISKY' | 'UNKNOWN' | null
-  firstName: string | null
-  lastName: string | null
-  linkedinUrl: string | null
-  title: string | null
-  headline: string | null
-  filterReason: string | null
-  openingLine: string | null
-  source: string | null
-  sourceId: string | null
-  processingState: ContactProcessingState | null
-  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
-  pipelineStatus?: LegacyPipelineStatus | null
-  enrichmentData: ContactEnrichmentData | null
-  /** Attio Person record ID - set when contact responds and is added to CRM */
-  attioPersonId: string | null
-  batchId: string | null
-  status: 'active' | 'invalid'
-  createdAt: Date
-  updatedAt: Date
+/**
+ * Contact record in the acquisition database.
+ * Contains enriched contact data and personalization content.
+ * Transformed from AcqContactRow with camelCase properties.
+ */
+export interface AcqContact {
+  id: string
+  organizationId: string
+  companyId: string | null
+  email: string
+  emailValid: 'VALID' | 'INVALID' | 'RISKY' | 'UNKNOWN' | null
+  firstName: string | null
+  lastName: string | null
+  linkedinUrl: string | null
+  title: string | null
+  headline: string | null
+  filterReason: string | null
+  openingLine: string | null
+  source: string | null
+  sourceId: string | null
+  processingState: ContactProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
+  enrichmentData: ContactEnrichmentData | null
+  /** Attio Person record ID - set when contact responds and is added to CRM */
+  attioPersonId: string | null
+  batchId: string | null
+  status: 'active' | 'invalid'
+  createdAt: Date
+  updatedAt: Date
 }
 ```
 
@@ -1457,23 +1457,23 @@ export type DealPriorityBucketKey = 'needs_response' | 'follow_up_due' | 'waitin
 ### `DealPriority`
 
 ```typescript
-export interface DealPriority {
-  bucketKey: DealPriorityBucketKey
-  rank: number
-  label: string
-  color: string
-  reason: string
-  latestActivityAt: string | null
-  nextActionAt: string | null
+export interface DealPriority {
+  bucketKey: DealPriorityBucketKey
+  rank: number
+  label: string
+  color: string
+  reason: string
+  latestActivityAt: string | null
+  nextActionAt: string | null
 }
 ```
 
 ### `KanbanStageConfig`
 
 ```typescript
-export interface KanbanStageConfig {
-  color: string // Mantine color token (e.g. 'blue', 'teal')
-  label?: string // Optional display label override
+export interface KanbanStageConfig {
+  color: string // Mantine color token (e.g. 'blue', 'teal')
+  label?: string // Optional display label override
 }
 ```
 
@@ -1486,49 +1486,49 @@ export type KanbanBoardConfig = Partial<Record<DealStage, KanbanStageConfig>>
 ### `DealContact`
 
 ```typescript
-export interface DealContact {
-  id: string
-  first_name: string | null
-  last_name: string | null
-  email: string
-  title: string | null
-  headline: string | null
-  linkedin_url: string | null
-  processing_state: Record<string, unknown> | null
-  enrichment_data: Record<string, unknown> | null
-  company: {
-    id: string
-    name: string
-    domain: string | null
-    website: string | null
-    linkedin_url: string | null
-    segment: string | null
-    category: string | null
-    num_employees: number | null
-  } | null
+export interface DealContact {
+  id: string
+  first_name: string | null
+  last_name: string | null
+  email: string
+  title: string | null
+  headline: string | null
+  linkedin_url: string | null
+  processing_state: Record<string, unknown> | null
+  enrichment_data: Record<string, unknown> | null
+  company: {
+    id: string
+    name: string
+    domain: string | null
+    website: string | null
+    linkedin_url: string | null
+    segment: string | null
+    category: string | null
+    num_employees: number | null
+  } | null
 }
 ```
 
 ### `DealFilters`
 
 ```typescript
-export interface DealFilters {
-  stage?: DealStage
-  search?: string
-  limit?: number
-  offset?: number
+export interface DealFilters {
+  stage?: DealStage
+  search?: string
+  limit?: number
+  offset?: number
 }
 ```
 
 ### `DealListItem`
 
 ```typescript
-/** Deal list item with joined contact and company data */
-export interface DealListItem extends AcqDealRow {
-  priority: DealPriority
-  ownership: 'us' | 'them' | null
-  nextAction: string | null
-  contact: DealContact | null
+/** Deal list item with joined contact and company data */
+export interface DealListItem extends AcqDealRow {
+  priority: DealPriority
+  ownership: 'us' | 'them' | null
+  nextAction: string | null
+  contact: DealContact | null
 }
 ```
 
@@ -1541,31 +1541,31 @@ export type DealDetail = DealListItem
 ### `AcqDealTaskKind`
 
 ```typescript
-/** Task kind options for a deal task (human follow-up action type) */
+/** Task kind options for a deal task (human follow-up action type) */
 export type AcqDealTaskKind = 'call' | 'email' | 'meeting' | 'other'
 ```
 
 ### `AcqDealTask`
 
 ```typescript
-/**
- * A CRM to-do item attached to a deal representing a human follow-up action.
- * Transformed from AcqDealTaskRow with camelCase properties.
- */
-export interface AcqDealTask {
-  id: string
-  organizationId: string
-  dealId: string
-  title: string
-  description: string | null
-  kind: AcqDealTaskKind
-  dueAt: string | null
-  assigneeUserId: string | null
-  completedAt: string | null
-  completedByUserId: string | null
-  createdAt: string
-  updatedAt: string
-  createdByUserId: string | null
+/**
+ * A CRM to-do item attached to a deal representing a human follow-up action.
+ * Transformed from AcqDealTaskRow with camelCase properties.
+ */
+export interface AcqDealTask {
+  id: string
+  organizationId: string
+  dealId: string
+  title: string
+  description: string | null
+  kind: AcqDealTaskKind
+  dueAt: string | null
+  assigneeUserId: string | null
+  completedAt: string | null
+  completedByUserId: string | null
+  createdAt: string
+  updatedAt: string
+  createdByUserId: string | null
 }
 ```
 
@@ -1979,222 +1979,222 @@ export type CrmToolMap = {
 ### `WebPost`
 
 ```typescript
-/**
- * Represents a web post from company website scraping.
- * Used for recent blog posts, news, or announcements.
- */
-export interface WebPost {
-  /** ISO date string of when the post was published */
-  date: string
-  /** Title of the web post */
-  title: string
-  /** Brief summary of the post content */
-  summary: string
-  /** AI-generated insight about the post's relevance */
-  aiInsight?: string
+/**
+ * Represents a web post from company website scraping.
+ * Used for recent blog posts, news, or announcements.
+ */
+export interface WebPost {
+  /** ISO date string of when the post was published */
+  date: string
+  /** Title of the web post */
+  title: string
+  /** Brief summary of the post content */
+  summary: string
+  /** AI-generated insight about the post's relevance */
+  aiInsight?: string
 }
 ```
 
 ### `CompanyEnrichmentData`
 
 ```typescript
-/**
- * Enrichment data collected for a company from various sources.
- */
-export interface CompanyEnrichmentData {
-  googleMaps?: {
-    placeId?: string
-    totalScore?: number
-    reviewsCount?: number
-    address?: string
-    phone?: string
-    categoryName?: string
-    googleMapsUrl?: string
-    scrapedAt?: string
-  }
-  websiteCrawl?: {
-    companyDescription?: string
-    services?: string[]
-    specialties?: string[]
-    staff?: Array<{ name: string; title?: string; email?: string }>
-    automationGaps?: string[]
-    targetAudience?: string
-    category?: string
-    segment?: string
-    recentWin?: string
-    emailCount?: number
-    pageCount?: number
-    totalChars?: number
-    crawledAt?: string
-    extractedAt?: string
-  }
-  website?: {
-    missionVision?: string
-    uniqueAttributes?: string
-    coreOfferings?: string
-    targetAudience?: string
-    companyValues?: string
-    businessDescription?: string
-    recentPosts?: Array<{ date?: string; title?: string; summary?: string; aiInsight?: string }>
-  }
-  tomba?: {
-    waterfallEmail?: {
-      email: string
-      name?: string
-      title?: string
-      department?: string
-    } | null
-    genericEmail?: string | null
-    totalFound?: number
-    searchedAt?: string
-  }
+/**
+ * Enrichment data collected for a company from various sources.
+ */
+export interface CompanyEnrichmentData {
+  googleMaps?: {
+    placeId?: string
+    totalScore?: number
+    reviewsCount?: number
+    address?: string
+    phone?: string
+    categoryName?: string
+    googleMapsUrl?: string
+    scrapedAt?: string
+  }
+  websiteCrawl?: {
+    companyDescription?: string
+    services?: string[]
+    specialties?: string[]
+    staff?: Array<{ name: string; title?: string; email?: string }>
+    automationGaps?: string[]
+    targetAudience?: string
+    category?: string
+    segment?: string
+    recentWin?: string
+    emailCount?: number
+    pageCount?: number
+    totalChars?: number
+    crawledAt?: string
+    extractedAt?: string
+  }
+  website?: {
+    missionVision?: string
+    uniqueAttributes?: string
+    coreOfferings?: string
+    targetAudience?: string
+    companyValues?: string
+    businessDescription?: string
+    recentPosts?: Array<{ date?: string; title?: string; summary?: string; aiInsight?: string }>
+  }
+  tomba?: {
+    waterfallEmail?: {
+      email: string
+      name?: string
+      title?: string
+      department?: string
+    } | null
+    genericEmail?: string | null
+    totalFound?: number
+    searchedAt?: string
+  }
 }
 ```
 
 ### `ContactEnrichmentData`
 
 ```typescript
-/**
- * Enrichment data collected for a contact from various sources.
- */
-export interface ContactEnrichmentData {
-  linkedin?: {
-    summary?: string
-    pastExperience?: string
-    education?: string
-    activity?: Array<{ date?: string; content?: string }>
-  }
+/**
+ * Enrichment data collected for a contact from various sources.
+ */
+export interface ContactEnrichmentData {
+  linkedin?: {
+    summary?: string
+    pastExperience?: string
+    education?: string
+    activity?: Array<{ date?: string; content?: string }>
+  }
 }
 ```
 
 ### `AcqList`
 
 ```typescript
-export interface AcqList {
-  id: string
-  organizationId: string
-  name: string
-  description: string | null
-  batchIds: string[]
-  instantlyCampaignId: string | null
-  status: ListStatus
-  scrapingConfig: ScrapingConfig
-  icp: IcpRubric
-  pipelineConfig: PipelineConfig
-  metadata: AcqListMetadata
-  launchedAt: Date | null
-  completedAt: Date | null
-  createdAt: Date
+export interface AcqList {
+  id: string
+  organizationId: string
+  name: string
+  description: string | null
+  batchIds: string[]
+  instantlyCampaignId: string | null
+  status: ListStatus
+  scrapingConfig: ScrapingConfig
+  icp: IcpRubric
+  pipelineConfig: PipelineConfig
+  metadata: AcqListMetadata
+  launchedAt: Date | null
+  completedAt: Date | null
+  createdAt: Date
 }
 ```
 
 ### `AcqCompany`
 
 ```typescript
-/**
- * Company record in the acquisition database.
- * Contains enriched company data from various sources.
- * Transformed from AcqCompanyRow with camelCase properties.
- */
-export interface AcqCompany {
-  id: string
-  organizationId: string
-  name: string
-  domain: string | null
-  linkedinUrl: string | null
-  website: string | null
-  numEmployees: number | null
-  foundedYear: number | null
-  locationCity: string | null
-  locationState: string | null
-  category: string | null
-  categoryPain: string | null
-  segment: string | null
-  processingState: CompanyProcessingState | null
-  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
-  pipelineStatus?: LegacyPipelineStatus | null
-  enrichmentData: CompanyEnrichmentData | null
-  source: string | null
-  batchId: string | null
-  status: 'active' | 'invalid'
-  verticalResearch: string | null
-  /** Track A: flat qualification score (null until a scoring rubric is defined). Added by W1 migration. */
-  qualificationScore: number | null
-  /** Track A: flat qualification signals jsonb preserving the result payload shape. Added by W1 migration. */
-  qualificationSignals: Record<string, unknown> | null
-  /** Track A: key identifying the rubric used for qualification. Added by W1 migration. */
-  qualificationRubricKey: string | null
-  createdAt: Date
-  updatedAt: Date
+/**
+ * Company record in the acquisition database.
+ * Contains enriched company data from various sources.
+ * Transformed from AcqCompanyRow with camelCase properties.
+ */
+export interface AcqCompany {
+  id: string
+  organizationId: string
+  name: string
+  domain: string | null
+  linkedinUrl: string | null
+  website: string | null
+  numEmployees: number | null
+  foundedYear: number | null
+  locationCity: string | null
+  locationState: string | null
+  category: string | null
+  categoryPain: string | null
+  segment: string | null
+  processingState: CompanyProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
+  enrichmentData: CompanyEnrichmentData | null
+  source: string | null
+  batchId: string | null
+  status: 'active' | 'invalid'
+  verticalResearch: string | null
+  /** Track A: flat qualification score (null until a scoring rubric is defined). Added by W1 migration. */
+  qualificationScore: number | null
+  /** Track A: flat qualification signals jsonb preserving the result payload shape. Added by W1 migration. */
+  qualificationSignals: Record<string, unknown> | null
+  /** Track A: key identifying the rubric used for qualification. Added by W1 migration. */
+  qualificationRubricKey: string | null
+  createdAt: Date
+  updatedAt: Date
 }
 ```
 
 ### `AcqContact`
 
 ```typescript
-/**
- * Contact record in the acquisition database.
- * Contains enriched contact data and personalization content.
- * Transformed from AcqContactRow with camelCase properties.
- */
-export interface AcqContact {
-  id: string
-  organizationId: string
-  companyId: string | null
-  email: string
-  emailValid: 'VALID' | 'INVALID' | 'RISKY' | 'UNKNOWN' | null
-  firstName: string | null
-  lastName: string | null
-  linkedinUrl: string | null
-  title: string | null
-  headline: string | null
-  filterReason: string | null
-  openingLine: string | null
-  source: string | null
-  sourceId: string | null
-  processingState: ContactProcessingState | null
-  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
-  pipelineStatus?: LegacyPipelineStatus | null
-  enrichmentData: ContactEnrichmentData | null
-  /** Attio Person record ID - set when contact responds and is added to CRM */
-  attioPersonId: string | null
-  batchId: string | null
-  status: 'active' | 'invalid'
-  createdAt: Date
-  updatedAt: Date
+/**
+ * Contact record in the acquisition database.
+ * Contains enriched contact data and personalization content.
+ * Transformed from AcqContactRow with camelCase properties.
+ */
+export interface AcqContact {
+  id: string
+  organizationId: string
+  companyId: string | null
+  email: string
+  emailValid: 'VALID' | 'INVALID' | 'RISKY' | 'UNKNOWN' | null
+  firstName: string | null
+  lastName: string | null
+  linkedinUrl: string | null
+  title: string | null
+  headline: string | null
+  filterReason: string | null
+  openingLine: string | null
+  source: string | null
+  sourceId: string | null
+  processingState: ContactProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
+  enrichmentData: ContactEnrichmentData | null
+  /** Attio Person record ID - set when contact responds and is added to CRM */
+  attioPersonId: string | null
+  batchId: string | null
+  status: 'active' | 'invalid'
+  createdAt: Date
+  updatedAt: Date
 }
 ```
 
 ### `ListTelemetry`
 
 ```typescript
-/**
- * Live-scan aggregate telemetry for a single list, computed on demand from
- * the list junction tables and current contact deliverability state.
- * `stageCounts` are attempted counts from list-row processing_state.
- */
-export interface ListTelemetry {
-  listId: string
-  totalCompanies: number
-  totalContacts: number
-  stageCounts: {
-    populated: number
-    extracted: number
-    qualified: number
-    discovered: number
-    verified: number
-    personalized: number
-    uploaded: number
-  }
-  deliverability: {
-    valid: number
-    risky: number
-    invalid: number
-    unknown: number
-    bounced: number
-  }
-  /** Reserved -- active workflow IDs associated with this list. */
-  activeWorkflows?: string[]
+/**
+ * Live-scan aggregate telemetry for a single list, computed on demand from
+ * the list junction tables and current contact deliverability state.
+ * `stageCounts` are attempted counts from list-row processing_state.
+ */
+export interface ListTelemetry {
+  listId: string
+  totalCompanies: number
+  totalContacts: number
+  stageCounts: {
+    populated: number
+    extracted: number
+    qualified: number
+    discovered: number
+    verified: number
+    personalized: number
+    uploaded: number
+  }
+  deliverability: {
+    valid: number
+    risky: number
+    invalid: number
+    unknown: number
+    bounced: number
+  }
+  /** Reserved -- active workflow IDs associated with this list. */
+  activeWorkflows?: string[]
 }
 ```
 
@@ -2918,6 +2918,7 @@ export const AcqListSchemas = {
   ScrapingConfig: ScrapingConfigSchema,
   IcpRubric: IcpRubricSchema,
   PipelineConfig: PipelineConfigSchema,
+  DataMode: DataModeSchema,
   PipelineStage: PipelineStageSchema,
   BuildPlanSnapshot: BuildPlanSnapshotSchema,
   BuildPlanSnapshotStep: BuildPlanSnapshotStepSchema,
@@ -3434,26 +3435,28 @@ export interface UpdateListConfigParams {
 ### `UpdateCompanyStageParams`
 
 ```typescript
-export interface UpdateCompanyStageParams {
-  organizationId: string
-  listId: string
-  companyId: string
-  stage: string
-  status?: ProcessingStageStatus
-  executionId?: string
+export interface UpdateCompanyStageParams {
+  organizationId: string
+  listId: string
+  companyId: string
+  stage: string
+  status?: ProcessingStageStatus
+  data?: unknown
+  executionId?: string
 }
 ```
 
 ### `UpdateContactStageParams`
 
 ```typescript
-export interface UpdateContactStageParams {
-  organizationId: string
-  listId: string
-  contactId: string
-  stage: string
-  status?: ProcessingStageStatus
-  executionId?: string
+export interface UpdateContactStageParams {
+  organizationId: string
+  listId: string
+  contactId: string
+  stage: string
+  status?: ProcessingStageStatus
+  data?: unknown
+  executionId?: string
 }
 ```
 
@@ -3508,13 +3511,14 @@ export interface RecordListExecutionParams {
 ### `ListExecutionSummary`
 
 ```typescript
-export interface ListExecutionSummary {
-  executionId: string
-  resourceId: string
-  status: string
-  createdAt: string
-  completedAt: string | null
-  durationMs: number | null
+export interface ListExecutionSummary {
+  executionId: string
+  resourceId: string
+  status: string
+  createdAt: string
+  completedAt: string | null
+  durationMs: number | null
+  input?: unknown
 }
 ```
 
@@ -3593,6 +3597,14 @@ export type LeadToolMap = {
     params: Omit<UpdateContactStageParams, 'organizationId'>
     result: void
   }
+  clearCompanyStages: {
+    params: Omit<ClearCompanyStagesParams, 'organizationId'>
+    result: void
+  }
+  clearContactStages: {
+    params: Omit<ClearContactStagesParams, 'organizationId'>
+    result: void
+  }
   // Company operations
   createCompany: { params: Omit<CreateCompanyParams, 'organizationId'>; result: AcqCompany }
   upsertCompany: { params: Omit<UpsertCompanyParams, 'organizationId'>; result: AcqCompany }
@@ -3717,7 +3729,11 @@ export type LeadToolMap = {
 export type ListToolMap = {
   getConfig: {
     params: { listId: string }
-    result: { scrapingConfig: ScrapingConfig; icp: IcpRubric; pipelineConfig: PipelineConfig }
+    result: {
+      scrapingConfig: ScrapingConfig
+      icp: IcpRubric
+      pipelineConfig: PipelineConfig & { dataMode: 'mock' | 'live' }
+    }
   }
   recordExecution: {
     params: Omit<RecordListExecutionParams, 'organizationId'>
@@ -3731,6 +3747,14 @@ export type ListToolMap = {
     params: Omit<UpdateContactStageParams, 'organizationId'>
     result: void
   }
+  clearCompanyStages: {
+    params: Omit<ClearCompanyStagesParams, 'organizationId'>
+    result: void
+  }
+  clearContactStages: {
+    params: Omit<ClearContactStagesParams, 'organizationId'>
+    result: void
+  }
   listPendingCompanyIds: {
     params: Omit<ListPendingCompanyIdsParams, 'organizationId'>
     result: string[]