@elevasis/core 0.20.0 → 0.22.0

package/src/business/acquisition/api-schemas.ts

@@ -1,7 +1,11 @@
 import { z } from 'zod'
 import { UuidSchema, NonEmptyStringSchema } from '../../platform/utils/validation'
 import { CRM_PIPELINE_DEFINITION, LEAD_GEN_STAGE_CATALOG } from '../../organization-model/domains/sales'
-import { CAPABILITY_REGISTRY } from '../../organization-model/domains/prospecting'
+import {
+  CAPABILITY_REGISTRY,
+  CredentialRequirementSchema,
+  RecordColumnConfigSchema
+} from '../../organization-model/domains/prospecting'
 import { isProspectingBuildTemplateId } from './build-templates'
 export { CrmPriorityBucketKeySchema, CrmPriorityBucketOverrideSchema, CrmPriorityOverrideSchema } from './crm-priority'
 export type { CrmPriorityBucketOverride, CrmPriorityOverride, ResolvedCrmPriorityRuleConfig } from './crm-priority'
@@ -80,6 +84,9 @@ export const DealTaskIdParamsSchema = z.object({
 export const ListDealsQuerySchema = z
   .object({
     stage: DealStageSchema.optional(),
+    list: UuidSchema.optional(),
+    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),
     offset: z.coerce.number().int().min(0).default(0)
@@ -211,6 +218,7 @@ export const DealListItemSchema = z.object({
   // acq_deals columns
   id: z.string(),
   organization_id: z.string(),
+  client_id: z.string().nullable().optional(),
   contact_id: z.string().nullable(),
   contact_email: z.string(),
   pipeline_key: z.string(),
@@ -300,12 +308,39 @@ export const DealConversationSchema = z.object({
   messages: z.array(ConversationMessageSchema)
 })
 
+export const DealLineageListRefSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  status: z.string()
+})
+
+export const DealLineageProjectRefSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  kind: z.string(),
+  status: z.string(),
+  updatedAt: z.string()
+})
+
+export const DealLineageClientRefSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  status: z.string()
+})
+
+export const DealLineageSchema = z.object({
+  list: DealLineageListRefSchema.nullable(),
+  projects: z.array(DealLineageProjectRefSchema),
+  client: DealLineageClientRefSchema.nullable()
+})
+
 /**
  * Deal detail shape — currently the same as a list item (full joined record).
  * Additive fields keep existing DealListItem callers compatible.
  */
 export const DealDetailResponseSchema = DealListItemSchema.extend({
-  conversation: DealConversationSchema
+  conversation: DealConversationSchema,
+  lineage: DealLineageSchema.optional()
 })
 
 /**
@@ -378,6 +413,10 @@ export const DealSchemas = {
   DealSummaryResponse: DealSummaryResponseSchema,
   DealLookupResponse: DealLookupResponseSchema,
   ConversationMessage: ConversationMessageSchema,
+  DealLineageListRef: DealLineageListRefSchema,
+  DealLineageProjectRef: DealLineageProjectRefSchema,
+  DealLineageClientRef: DealLineageClientRefSchema,
+  DealLineage: DealLineageSchema,
   DealDetailResponse: DealDetailResponseSchema,
   DealNoteResponse: DealNoteResponseSchema,
   DealNoteListResponse: DealNoteListResponseSchema,
@@ -411,6 +450,10 @@ export type DealSummaryResponse = z.infer<typeof DealSummaryResponseSchema>
 export type DealLookupItem = z.infer<typeof DealLookupItemSchema>
 export type DealLookupResponse = z.infer<typeof DealLookupResponseSchema>
 export type ConversationMessage = z.infer<typeof ConversationMessageSchema>
+export type DealLineageListRef = z.infer<typeof DealLineageListRefSchema>
+export type DealLineageProjectRef = z.infer<typeof DealLineageProjectRefSchema>
+export type DealLineageClientRef = z.infer<typeof DealLineageClientRefSchema>
+export type DealLineage = z.infer<typeof DealLineageSchema>
 export type DealDetailResponse = z.infer<typeof DealDetailResponseSchema>
 export type DealNoteResponse = z.infer<typeof DealNoteResponseSchema>
 export type DealNoteListResponse = z.infer<typeof DealNoteListResponseSchema>
@@ -496,11 +539,21 @@ export const BuildPlanSnapshotStepSchema = z
     primaryEntity: z.enum(['company', 'contact']),
     outputs: z.array(z.enum(['company', 'contact', 'export'])).min(1),
     stageKey: LeadGenStageKeySchema,
+    recordEntity: z.enum(['company', 'contact']).optional(),
+    recordsStageKey: LeadGenStageKeySchema.optional(),
+    recordSourceStageKey: LeadGenStageKeySchema.optional(),
     dependsOn: z.array(z.string().trim().min(1).max(100)).optional(),
     dependencyMode: z.literal('per-record-eligibility'),
     capabilityKey: LeadGenCapabilityKeySchema,
     defaultBatchSize: z.number().int().positive(),
-    maxBatchSize: z.number().int().positive()
+    maxBatchSize: z.number().int().positive(),
+    recordColumns: z
+      .object({
+        company: z.array(RecordColumnConfigSchema).optional(),
+        contact: z.array(RecordColumnConfigSchema).optional()
+      })
+      .optional(),
+    credentialRequirements: z.array(CredentialRequirementSchema).optional()
   })
   .refine((step) => step.defaultBatchSize <= step.maxBatchSize, {
     message: 'defaultBatchSize must be less than or equal to maxBatchSize',
@@ -718,6 +771,30 @@ export const ListTelemetryResponseSchema = ListTelemetrySchema
 
 export const ListTelemetryListResponseSchema = z.array(ListTelemetrySchema)
 
+const QueryBooleanSchema = z.preprocess((value) => {
+  if (value === 'true' || value === '1' || value === true) return true
+  if (value === 'false' || value === '0' || value === false) return false
+  return value
+}, z.boolean())
+
+export const ListReadQuerySchema = z
+  .object({
+    status: ListStatusSchema.optional(),
+    batch: z.string().trim().min(1).max(255).optional(),
+    vertical: z.string().trim().min(1).max(255).optional(),
+    limit: z.coerce.number().int().min(1).max(500).optional(),
+    offset: z.coerce.number().int().min(0).optional()
+  })
+  .strict()
+
+export const GetListQuerySchema = z
+  .object({
+    includeDeals: QueryBooleanSchema.default(true),
+    includeProgress: QueryBooleanSchema.default(false),
+    dealLimit: z.coerce.number().int().min(0).max(100).default(25)
+  })
+  .strict()
+
 /**
  * Per-stage progress aggregate for a single pipeline stage.
  * `attempted` counts terminal statuses, including success, no-result, skipped,
@@ -747,6 +824,47 @@ export const ListProgressResponseSchema = z.object({
   byContactStage: z.record(z.string(), ListStageProgressSchema)
 })
 
+export const AcqListDealRefSchema = z.object({
+  id: z.string(),
+  contactEmail: z.string(),
+  stageKey: z.string().nullable(),
+  stateKey: z.string().nullable(),
+  sourceType: z.string().nullable(),
+  lastActivityAt: z.string()
+})
+
+export const AcqListLineageSchema = z.object({
+  deals: z.object({
+    total: z.number().int().min(0),
+    refs: z.array(AcqListDealRefSchema),
+    truncated: z.boolean()
+  })
+})
+
+export const AcqListDetailResponseSchema = AcqListResponseSchema.extend({
+  lineage: AcqListLineageSchema.optional(),
+  progress: ListProgressResponseSchema.optional()
+})
+
+export const AcqListStatusListItemSchema = z.object({
+  listId: z.string(),
+  name: z.string(),
+  status: ListStatusSchema,
+  totalCompanies: z.number().int().min(0),
+  totalContacts: z.number().int().min(0),
+  totalDeals: z.number().int().min(0),
+  createdAt: z.string()
+})
+
+export const AcqListStatusResponseSchema = z.object({
+  totalLists: z.number().int().min(0),
+  totalCompanies: z.number().int().min(0),
+  totalContacts: z.number().int().min(0),
+  totalDeals: z.number().int().min(0),
+  byStatus: z.record(z.string(), z.number().int().min(0)),
+  lists: z.array(AcqListStatusListItemSchema)
+})
+
 /**
  * Row from acq_list_executions joined with the execution summary,
  * shaped for the /lists/:id/executions response.
@@ -767,12 +885,6 @@ export const ListExecutionsResponseSchema = z.array(ListExecutionSummarySchema)
 // Company / Contact API Schemas
 // ---------------------------------------------------------------------------
 
-const QueryBooleanSchema = z.preprocess((value) => {
-  if (value === 'true' || value === '1' || value === true) return true
-  if (value === 'false' || value === '0' || value === false) return false
-  return value
-}, z.boolean())
-
 export const AcqCompanyStatusSchema = z.enum(['active', 'invalid'])
 export const AcqContactStatusSchema = z.enum(['active', 'invalid'])
 export const AcqEmailValidSchema = z.enum(['VALID', 'INVALID', 'RISKY', 'UNKNOWN'])
@@ -817,6 +929,7 @@ export const ListContactsQuerySchema = z
 export const CreateCompanyRequestSchema = z
   .object({
     name: z.string().trim().min(1).max(255),
+    clientId: UuidSchema.nullable().optional(),
     domain: z.string().trim().min(1).max(255).optional(),
     linkedinUrl: z.string().trim().url().optional(),
     website: z.string().trim().url().optional(),
@@ -835,6 +948,7 @@ export const CreateCompanyRequestSchema = z
 export const UpdateCompanyRequestSchema = z
   .object({
     name: z.string().trim().min(1).max(255).optional(),
+    clientId: UuidSchema.nullable().optional(),
     domain: z.string().trim().min(1).max(255).optional(),
     linkedinUrl: z.string().trim().url().optional(),
     website: z.string().trim().url().optional(),
@@ -856,6 +970,7 @@ export const UpdateCompanyRequestSchema = z
   .refine(
     (data) =>
       data.name !== undefined ||
+      data.clientId !== undefined ||
       data.domain !== undefined ||
       data.linkedinUrl !== undefined ||
       data.website !== undefined ||
@@ -880,6 +995,7 @@ export const UpdateCompanyRequestSchema = z
 export const CreateContactRequestSchema = z
   .object({
     email: z.string().trim().email(),
+    clientId: UuidSchema.nullable().optional(),
     companyId: UuidSchema.optional(),
     firstName: z.string().trim().min(1).max(255).optional(),
     lastName: z.string().trim().min(1).max(255).optional(),
@@ -895,6 +1011,7 @@ export const CreateContactRequestSchema = z
 export const UpdateContactRequestSchema = z
   .object({
     companyId: UuidSchema.optional(),
+    clientId: UuidSchema.nullable().optional(),
     emailValid: AcqEmailValidSchema.optional(),
     firstName: z.string().trim().min(1).max(255).optional(),
     lastName: z.string().trim().min(1).max(255).optional(),
@@ -912,6 +1029,7 @@ export const UpdateContactRequestSchema = z
   .refine(
     (data) =>
       data.companyId !== undefined ||
+      data.clientId !== undefined ||
       data.emailValid !== undefined ||
       data.firstName !== undefined ||
       data.lastName !== undefined ||
@@ -932,6 +1050,7 @@ export const UpdateContactRequestSchema = z
 export const AcqCompanyResponseSchema = z.object({
   id: z.string(),
   organizationId: z.string(),
+  clientId: z.string().nullable().optional(),
   name: z.string(),
   domain: z.string().nullable(),
   linkedinUrl: z.string().nullable(),
@@ -982,6 +1101,7 @@ export const AcqContactCompanySummarySchema = z.object({
 export const AcqContactResponseSchema = z.object({
   id: z.string(),
   organizationId: z.string(),
+  clientId: z.string().nullable().optional(),
   companyId: z.string().nullable(),
   email: z.string(),
   emailValid: AcqEmailValidSchema.nullable(),
@@ -1063,6 +1183,33 @@ export const ListMembersQuerySchema = z
   })
   .strict()
 
+export const ListRecordEntitySchema = z.enum(['company', 'contact'])
+
+export const ListRecordsQuerySchema = z
+  .object({
+    entity: ListRecordEntitySchema,
+    stage: LeadGenStageKeySchema.optional(),
+    limit: z.coerce.number().int().min(1).max(500).default(50),
+    offset: z.coerce.number().int().min(0).default(0)
+  })
+  .strict()
+  .superRefine((query, ctx) => {
+    if (!query.stage) return
+
+    const stage = LEAD_GEN_STAGE_CATALOG[query.stage]
+    const validEntity =
+      stage?.entity === query.entity ||
+      stage?.additionalEntities?.includes(query.entity) ||
+      stage?.recordEntity === query.entity
+    if (!validEntity) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: `stage "${query.stage}" is not valid for ${query.entity} records`,
+        path: ['stage']
+      })
+    }
+  })
+
 export const MemberIdParamsSchema = z.object({
   memberId: UuidSchema
 })
@@ -1095,6 +1242,77 @@ export const AcqListMembersResponseSchema = z.object({
   members: z.array(AcqListMemberResponseSchema)
 })
 
+export const AcqListRecordCompanySummarySchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  domain: z.string().nullable(),
+  website: z.string().nullable(),
+  linkedinUrl: z.string().nullable(),
+  numEmployees: z.number().nullable(),
+  foundedYear: z.number().nullable(),
+  locationCity: z.string().nullable(),
+  locationState: z.string().nullable(),
+  category: z.string().nullable(),
+  segment: z.string().nullable(),
+  status: AcqCompanyStatusSchema,
+  qualificationScore: z.number().nullable(),
+  qualificationSignals: z.record(z.string(), z.unknown()).nullable(),
+  qualificationRubricKey: z.string().nullable()
+})
+
+export const AcqListRecordContactSummarySchema = z.object({
+  id: z.string(),
+  email: z.string(),
+  firstName: z.string().nullable(),
+  lastName: z.string().nullable(),
+  title: z.string().nullable(),
+  headline: z.string().nullable(),
+  linkedinUrl: z.string().nullable(),
+  companyId: z.string().nullable(),
+  status: AcqContactStatusSchema,
+  qualificationScore: z.number().nullable(),
+  qualificationSignals: z.record(z.string(), z.unknown()).nullable(),
+  qualificationRubricKey: z.string().nullable()
+})
+
+const ListRecordBaseSchema = z.object({
+  id: z.string(),
+  listId: z.string(),
+  pipelineKey: z.string(),
+  stageKey: z.string(),
+  stateKey: z.string(),
+  activityLog: z.unknown(),
+  addedAt: z.string(),
+  addedBy: z.string().nullable(),
+  sourceExecutionId: z.string().nullable(),
+  processingState: z.record(z.string(), z.unknown()).nullable(),
+  enrichmentData: z.record(z.string(), z.unknown()).nullable()
+})
+
+export const AcqListCompanyRecordRowSchema = ListRecordBaseSchema.extend({
+  entity: z.literal('company'),
+  companyId: z.string(),
+  company: AcqListRecordCompanySummarySchema.nullable()
+})
+
+export const AcqListContactRecordRowSchema = ListRecordBaseSchema.extend({
+  entity: z.literal('contact'),
+  contactId: z.string(),
+  contact: AcqListRecordContactSummarySchema.nullable()
+})
+
+export const ListRecordRowSchema = z.discriminatedUnion('entity', [
+  AcqListCompanyRecordRowSchema,
+  AcqListContactRecordRowSchema
+])
+
+export const ListRecordsResponseSchema = z.object({
+  data: z.array(ListRecordRowSchema),
+  total: z.number().int().min(0),
+  limit: z.number().int().min(1),
+  offset: z.number().int().min(0)
+})
+
 // ---------------------------------------------------------------------------
 // Track B: List Companies API Schemas
 // ---------------------------------------------------------------------------
@@ -1185,6 +1403,8 @@ export const AcqListSchemas = {
   ListTelemetry: ListTelemetrySchema,
 
   // Requests
+  ListReadQuery: ListReadQuerySchema,
+  GetListQuery: GetListQuerySchema,
   CreateListRequest: CreateListRequestSchema,
   UpdateListRequest: UpdateListRequestSchema,
   UpdateListStatusRequest: UpdateListStatusRequestSchema,
@@ -1196,7 +1416,11 @@ export const AcqListSchemas = {
 
   // Responses
   AcqListResponse: AcqListResponseSchema,
+  AcqListDetailResponse: AcqListDetailResponseSchema,
   AcqListListResponse: AcqListListResponseSchema,
+  AcqListDealRef: AcqListDealRefSchema,
+  AcqListLineage: AcqListLineageSchema,
+  AcqListStatusResponse: AcqListStatusResponseSchema,
   ListTelemetryResponse: ListTelemetryResponseSchema,
   ListTelemetryListResponse: ListTelemetryListResponseSchema,
   ListExecutionsResponse: ListExecutionsResponseSchema,
@@ -1216,9 +1440,14 @@ export const AcqSubstrateSchemas = {
 
   // List members
   ListMembersQuery: ListMembersQuerySchema,
+  ListRecordsQuery: ListRecordsQuerySchema,
   MemberIdParams: MemberIdParamsSchema,
   AcqListMemberResponse: AcqListMemberResponseSchema,
   AcqListMembersResponse: AcqListMembersResponseSchema,
+  AcqListCompanyRecordRow: AcqListCompanyRecordRowSchema,
+  AcqListContactRecordRow: AcqListContactRecordRowSchema,
+  ListRecordRow: ListRecordRowSchema,
+  ListRecordsResponse: ListRecordsResponseSchema,
 
   // List companies
   ListCompanyIdParams: ListCompanyIdParamsSchema,
@@ -1242,10 +1471,16 @@ export type CreateArtifactRequest = z.infer<typeof CreateArtifactRequestSchema>
 export type AcqArtifactResponse = z.infer<typeof AcqArtifactResponseSchema>
 export type AcqArtifactListResponse = z.infer<typeof AcqArtifactListResponseSchema>
 export type ListMembersQuery = z.infer<typeof ListMembersQuerySchema>
+export type ListRecordEntity = z.infer<typeof ListRecordEntitySchema>
+export type ListRecordsQuery = z.infer<typeof ListRecordsQuerySchema>
 export type MemberIdParams = z.infer<typeof MemberIdParamsSchema>
 export type AcqListMemberContactSummary = z.infer<typeof AcqListMemberContactSummarySchema>
 export type AcqListMemberResponse = z.infer<typeof AcqListMemberResponseSchema>
 export type AcqListMembersResponse = z.infer<typeof AcqListMembersResponseSchema>
+export type AcqListCompanyRecordRow = z.infer<typeof AcqListCompanyRecordRowSchema>
+export type AcqListContactRecordRow = z.infer<typeof AcqListContactRecordRowSchema>
+export type ListRecordRow = z.infer<typeof ListRecordRowSchema>
+export type ListRecordsResponse = z.infer<typeof ListRecordsResponseSchema>
 export type ListCompanyIdParams = z.infer<typeof ListCompanyIdParamsSchema>
 export type AcqListCompanyResponse = z.infer<typeof AcqListCompanyResponseSchema>
 
@@ -1264,6 +1499,8 @@ export type ProcessingStageStatus = z.infer<typeof ProcessingStageStatusSchema>
 export type ListStageCountsInput = z.infer<typeof ListStageCountsSchema>['stageCounts']
 export type ListTelemetryInput = z.infer<typeof ListTelemetrySchema>
 export type ListIdParams = z.infer<typeof ListIdParamsSchema>
+export type ListReadQuery = z.infer<typeof ListReadQuerySchema>
+export type GetListQuery = z.infer<typeof GetListQuerySchema>
 export type CreateListRequest = z.infer<typeof CreateListRequestSchema>
 export type UpdateListRequest = z.infer<typeof UpdateListRequestSchema>
 export type UpdateListStatusRequest = z.infer<typeof UpdateListStatusRequestSchema>
@@ -1273,7 +1510,11 @@ export type RemoveCompaniesFromListRequest = z.infer<typeof RemoveCompaniesFromL
 export type AddContactsToListRequest = z.infer<typeof AddContactsToListRequestSchema>
 export type RecordListExecutionRequest = z.infer<typeof RecordListExecutionRequestSchema>
 export type AcqListResponse = z.infer<typeof AcqListResponseSchema>
+export type AcqListDetailResponse = z.infer<typeof AcqListDetailResponseSchema>
 export type AcqListListResponse = z.infer<typeof AcqListListResponseSchema>
+export type AcqListDealRef = z.infer<typeof AcqListDealRefSchema>
+export type AcqListLineage = z.infer<typeof AcqListLineageSchema>
+export type AcqListStatusResponse = z.infer<typeof AcqListStatusResponseSchema>
 export type ListTelemetryResponse = z.infer<typeof ListTelemetryResponseSchema>
 export type ListTelemetryListResponse = z.infer<typeof ListTelemetryListResponseSchema>
 export type ListExecutionSummaryInput = z.infer<typeof ListExecutionSummarySchema>

package/src/business/acquisition/build-templates.test.ts

@@ -180,12 +180,40 @@ describe('createBuildPlanSnapshotFromTemplateId — "dtc-subscription-apollo-cli
     expect(first?.outputs).toContain('contact')
   })
 
+  it('preserves Apollo credential requirements for source import and decision-maker enrichment', () => {
+    const importApolloSearch = snapshot?.steps.find((step) => step.id === 'import-apollo-search')
+    const enrichDecisionMakers = snapshot?.steps.find((step) => step.id === 'enrich-decision-makers')
+
+    const expectedRequirement = {
+      key: 'apollo',
+      provider: 'apollo',
+      credentialType: 'api-key-secret',
+      label: 'Apollo API key',
+      required: true,
+      selectionMode: 'single',
+      inputPath: 'credential'
+    }
+
+    expect(importApolloSearch?.credentialRequirements).toEqual([expectedRequirement])
+    expect(enrichDecisionMakers?.credentialRequirements).toEqual([expectedRequirement])
+  })
+
   it('the final step (review-and-export) outputs export', () => {
     const last = snapshot?.steps[snapshot.steps.length - 1]
     expect(last?.id).toBe('review-and-export')
     expect(last?.outputs).toContain('export')
   })
 
+  it('preserves contact records metadata for the company-owned decision-maker step', () => {
+    const decisionMakers = snapshot?.steps.find((step) => step.id === 'enrich-decision-makers')
+    expect(decisionMakers).toMatchObject({
+      primaryEntity: 'company',
+      recordEntity: 'contact',
+      stageKey: 'decision-makers-enriched'
+    })
+    expect(decisionMakers?.recordColumns?.contact?.length).toBeGreaterThan(0)
+  })
+
   it('steps with descriptions in the catalog include description in the snapshot', () => {
     const withDesc = snapshot?.steps.filter((step) => step.description !== undefined) ?? []
     expect(withDesc.length).toBeGreaterThan(0)

package/src/business/acquisition/build-templates.ts

@@ -29,16 +29,28 @@ export function createBuildPlanSnapshotFromTemplateId(templateId: string): Build
         primaryEntity: step.primaryEntity,
         outputs: [...step.outputs],
         stageKey: step.stageKey,
+        recordsStageKey: step.recordsStageKey ?? step.stageKey,
+        recordSourceStageKey: step.recordSourceStageKey ?? step.recordsStageKey ?? step.stageKey,
         dependencyMode: step.dependencyMode,
         capabilityKey: step.capabilityKey,
         defaultBatchSize: step.defaultBatchSize,
         maxBatchSize: step.maxBatchSize
-      }
-
-      if (step.description) snapshotStep.description = step.description
-      if (step.dependsOn?.length) snapshotStep.dependsOn = [...step.dependsOn]
-
-      return snapshotStep
-    })
-  }
+      }
+
+      if (step.description) snapshotStep.description = step.description
+      if (step.recordEntity) snapshotStep.recordEntity = step.recordEntity
+      if (step.dependsOn?.length) snapshotStep.dependsOn = [...step.dependsOn]
+      if (step.credentialRequirements?.length) {
+        snapshotStep.credentialRequirements = step.credentialRequirements.map((requirement) => ({ ...requirement }))
+      }
+      if (step.recordColumns) {
+        snapshotStep.recordColumns = {
+          ...(step.recordColumns.company ? { company: step.recordColumns.company.map((column) => ({ ...column })) } : {}),
+          ...(step.recordColumns.contact ? { contact: step.recordColumns.contact.map((column) => ({ ...column })) } : {})
+        }
+      }
+
+      return snapshotStep
+    })
+  }
 }

package/src/business/acquisition/index.ts

@@ -61,6 +61,8 @@ export {
   ListStageCountsSchema,
   ListTelemetrySchema,
   ListIdParamsSchema,
+  ListReadQuerySchema,
+  GetListQuerySchema,
   CreateListRequestSchema,
   UpdateListRequestSchema,
   UpdateListStatusRequestSchema,
@@ -70,7 +72,11 @@ export {
   AddContactsToListRequestSchema,
   RecordListExecutionRequestSchema,
   AcqListResponseSchema,
+  AcqListDetailResponseSchema,
   AcqListListResponseSchema,
+  AcqListDealRefSchema,
+  AcqListLineageSchema,
+  AcqListStatusResponseSchema,
   ListTelemetryResponseSchema,
   ListTelemetryListResponseSchema,
   ListExecutionSummarySchema,
@@ -144,6 +150,8 @@ export {
   type ListStageCountsInput,
   type ListTelemetryInput,
   type ListIdParams,
+  type ListReadQuery,
+  type GetListQuery,
   type CreateListRequest,
   type UpdateListRequest,
   type UpdateListStatusRequest,
@@ -153,7 +161,11 @@ export {
   type AddContactsToListRequest,
   type RecordListExecutionRequest,
   type AcqListResponse,
+  type AcqListDetailResponse,
   type AcqListListResponse,
+  type AcqListDealRef,
+  type AcqListLineage,
+  type AcqListStatusResponse,
   type ListTelemetryResponse,
   type ListTelemetryListResponse,
   type ListExecutionSummaryInput,

package/src/business/acquisition/types.ts

@@ -1,5 +1,5 @@
 import type { Database } from '../../supabase/database.types'
-import type { Capability } from '../../organization-model/domains/prospecting'
+import type { Capability, CredentialRequirement, RecordColumnConfig } from '../../organization-model/domains/prospecting'
 import type { LEAD_GEN_STAGE_CATALOG } from '../../organization-model/domains/sales'
 import type { PipelineStage, ProcessingStageStatus } from './api-schemas'
 
@@ -167,11 +167,16 @@ export interface BuildPlanSnapshotStep {
   primaryEntity: BuildPlanSnapshotPrimaryEntity
   outputs: BuildPlanSnapshotOutput[]
   stageKey: string
+  recordEntity?: BuildPlanSnapshotPrimaryEntity
+  recordsStageKey?: string
+  recordSourceStageKey?: string
   dependsOn?: string[]
   dependencyMode: BuildPlanSnapshotDependencyMode
   capabilityKey: string
   defaultBatchSize: number
   maxBatchSize: number
+  recordColumns?: Partial<Record<BuildPlanSnapshotPrimaryEntity, RecordColumnConfig[]>>
+  credentialRequirements?: CredentialRequirement[]
 }
 
 export interface BuildPlanSnapshot {