@elevasis/sdk 1.25.0 → 1.26.0

package/reference/scaffold/reference/contracts.md

@@ -1371,77 +1371,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
 }
 ```
 
@@ -1460,23 +1460,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
 }
 ```
 
@@ -1489,49 +1489,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
 }
 ```
 
@@ -1544,31 +1544,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
 }
 ```
 
@@ -1982,222 +1982,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[]
 }
 ```
 
@@ -2921,6 +2921,7 @@ export const AcqListSchemas = {
   ScrapingConfig: ScrapingConfigSchema,
   IcpRubric: IcpRubricSchema,
   PipelineConfig: PipelineConfigSchema,
+  DataMode: DataModeSchema,
   PipelineStage: PipelineStageSchema,
   BuildPlanSnapshot: BuildPlanSnapshotSchema,
   BuildPlanSnapshotStep: BuildPlanSnapshotStepSchema,
@@ -3074,100 +3075,6 @@ export interface StatefulPipelineDefinition {
 }
 ```
 
-### `ACQ_LIST_MEMBERS_LEAD_GEN_PIPELINE`
-
-```typescript
-/**
- * Lead-gen pipeline definition for acq_list_members (contacts).
- * Three stages matching the post-restructure sales subdomain tree.
- *
- * Note: members visit outreach and prospecting states depending on which
- * workflow last processed them. stage_key is set per-transition by the workflow.
- */
-export const ACQ_LIST_MEMBERS_LEAD_GEN_PIPELINE: StatefulPipelineDefinition = {
-  pipelineKey: 'lead-gen',
-  label: 'Lead Generation',
-  entityKey: 'acq.list-member',
-  stages: [
-    {
-      stageKey: 'outreach',
-      label: 'Outreach',
-      states: [
-        PENDING_STATE,
-        { stateKey: 'personalized', label: 'Personalized' },
-        { stateKey: 'uploaded', label: 'Uploaded' },
-        { stateKey: 'interested', label: 'Interested' }
-      ]
-    },
-    {
-      stageKey: 'prospecting',
-      label: 'Prospecting',
-      states: [
-        PENDING_STATE,
-        { stateKey: 'discovered', label: 'Discovered' },
-        { stateKey: 'verified', label: 'Verified' }
-      ]
-    },
-    {
-      stageKey: 'qualification',
-      label: 'Qualification',
-      states: [PENDING_STATE]
-    }
-  ]
-}
-```
-
-### `ACQ_LIST_COMPANIES_LEAD_GEN_PIPELINE`
-
-```typescript
-/**
- * Lead-gen pipeline definition for acq_list_companies.
- * Three stages matching the post-restructure sales subdomain tree.
- *
- * Note: companies visit prospecting and qualification states depending on which
- * workflow last processed them. stage_key is set per-transition by the workflow.
- */
-export const ACQ_LIST_COMPANIES_LEAD_GEN_PIPELINE: StatefulPipelineDefinition = {
-  pipelineKey: 'lead-gen',
-  label: 'Lead Generation',
-  entityKey: 'acq.list-company',
-  stages: [
-    {
-      stageKey: 'outreach',
-      label: 'Outreach',
-      states: [PENDING_STATE, { stateKey: 'uploaded', label: 'Uploaded' }]
-    },
-    {
-      stageKey: 'prospecting',
-      label: 'Prospecting',
-      states: [
-        PENDING_STATE,
-        { stateKey: 'populated', label: 'Populated' },
-        { stateKey: 'extracted', label: 'Extracted' }
-      ]
-    },
-    {
-      stageKey: 'qualification',
-      label: 'Qualification',
-      states: [PENDING_STATE, { stateKey: 'qualified', label: 'Qualified' }]
-    }
-  ]
-}
-```
-
-### `LEAD_GEN_PIPELINE_DEFINITIONS`
-
-```typescript
-/**
- * All lead-gen pipeline definitions indexed by entity key.
- * Use findPipeline() to locate a definition by pipeline_key within any array.
- */
-export const LEAD_GEN_PIPELINE_DEFINITIONS: Record<string, StatefulPipelineDefinition[]> = {
-  'acq.list-member': [ACQ_LIST_MEMBERS_LEAD_GEN_PIPELINE],
-  'acq.list-company': [ACQ_LIST_COMPANIES_LEAD_GEN_PIPELINE]
-}
-```
-
 ### `PaginationParams`
 
 ```typescript
@@ -3437,26 +3344,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
 }
 ```
 
@@ -3511,13 +3420,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
 }
 ```
 
@@ -3596,6 +3506,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 }
@@ -3720,7 +3638,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'>
@@ -3734,6 +3656,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[]
@@ -3750,33 +3680,33 @@ export type ListToolMap = {
 ### `KnowledgeLinkSchema`
 
 ```typescript
-export const KnowledgeLinkSchema = z
-  .union([CanonicalKnowledgeLinkSchema, LegacyKnowledgeLinkSchema])
-  .transform((link) => {
-    const target = 'target' in link ? link.target : targetFromNodeId(link.nodeId)
-    return {
-      target,
-      nodeId: nodeIdFromTarget(target)
-    }
+export const KnowledgeLinkSchema = z
+  .union([CanonicalKnowledgeLinkSchema, LegacyKnowledgeLinkSchema])
+  .transform((link) => {
+    const target = 'target' in link ? link.target : targetFromNodeId(link.nodeId)
+    return {
+      target,
+      nodeId: nodeIdFromTarget(target)
+    }
   })
 ```
 
 ### `OrgKnowledgeKindSchema`
 
 ```typescript
-export const OrgKnowledgeKindSchema = z
-  .enum(['playbook', 'strategy', 'reference'])
+export const OrgKnowledgeKindSchema = z
+  .enum(['playbook', 'strategy', 'reference'])
   .meta({ label: 'Knowledge kind', color: 'grape' })
 ```
 
 ### `OrgKnowledgeNodeSchema`
 
 ```typescript
-export const OrgKnowledgeNodeSchema = z.object({
-  id: ModelIdSchema,
-  kind: OrgKnowledgeKindSchema,
-  title: z.string().trim().min(1).max(200),
-  summary: z.string().trim().min(1).max(1000),
+export const OrgKnowledgeNodeSchema = z.object({
+  id: ModelIdSchema,
+  kind: OrgKnowledgeKindSchema,
+  title: z.string().trim().min(1).max(200),
+  summary: z.string().trim().min(1).max(1000),
   icon: IconNameSchema.optional(),
   /** Canonical documentation URL when body content is a local summary. */
   externalUrl: z.string().trim().url().max(500).optional(),
@@ -3784,15 +3714,15 @@ export const OrgKnowledgeNodeSchema = z.object({
   sourceFilePath: z.string().trim().min(1).max(500).optional(),
   /** Raw MDX string. Phase 2 will introduce a structured block format. */
   body: z.string().trim().min(1),
-  /**
-   * Graph links to other OM nodes this knowledge node governs.
-   * Each link emits a `governs` edge: knowledge-node -> target node.
-   */
-  links: z.array(KnowledgeLinkSchema).default([]),
-  /** Role identifiers that own this knowledge node. */
-  ownerIds: z.array(RoleIdSchema.meta({ ref: 'role' })).default([]),
-  /** ISO date string (YYYY-MM-DD or full ISO 8601) of last meaningful update. */
-  updatedAt: z.string().trim().min(1).max(50)
+  /**
+   * Graph links to other OM nodes this knowledge node governs.
+   * Each link emits a `governs` edge: knowledge-node -> target node.
+   */
+  links: z.array(KnowledgeLinkSchema).default([]),
+  /** Role identifiers that own this knowledge node. */
+  ownerIds: z.array(RoleIdSchema.meta({ ref: 'role' })).default([]),
+  /** ISO date string (YYYY-MM-DD or full ISO 8601) of last meaningful update. */
+  updatedAt: z.string().trim().min(1).max(50)
 })
 ```