@elevasis/sdk 1.15.1 → 1.17.0

package/dist/test-utils/index.d.ts

@@ -237,56 +237,6 @@ interface IExecutionLogger {
     error(message: string, context?: LogContext): void;
 }
 
-/**
- * Shared form field types for dynamic form generation
- * Used by: Command Queue, Execution Runner UI, future form-based features
- */
-/**
- * Supported form field types for action payloads
- * Maps to Mantine form components
- */
-type FormFieldType = 'text' | 'textarea' | 'number' | 'select' | 'checkbox' | 'radio' | 'richtext';
-/**
- * Form field definition
- */
-interface FormField {
-    /** Field key in payload object */
-    name: string;
-    /** Field label for UI */
-    label: string;
-    /** Field type (determines UI component) */
-    type: FormFieldType;
-    /** Default value */
-    defaultValue?: unknown;
-    /** Required field */
-    required?: boolean;
-    /** Placeholder text */
-    placeholder?: string;
-    /** Help text */
-    description?: string;
-    /** Options for select/radio */
-    options?: Array<{
-        label: string;
-        value: string | number;
-    }>;
-    /** Min/max for number */
-    min?: number;
-    max?: number;
-    /** Path to context value for pre-filling (dot notation, e.g., 'proposal.summary') */
-    defaultValueFromContext?: string;
-}
-/**
- * Form schema for action payload collection
- */
-interface FormSchema {
-    /** Form title */
-    title?: string;
-    /** Form description */
-    description?: string;
-    /** Form fields */
-    fields: FormField[];
-}
-
 /**
  * Model Configuration
  * Centralized model information, configuration, options, constraints, and validation
@@ -385,6 +335,56 @@ interface ModelConfig {
     modelOptions?: ModelSpecificOptions;
 }
 
+/**
+ * Shared form field types for dynamic form generation
+ * Used by: Command Queue, Execution Runner UI, future form-based features
+ */
+/**
+ * Supported form field types for action payloads
+ * Maps to Mantine form components
+ */
+type FormFieldType = 'text' | 'textarea' | 'number' | 'select' | 'checkbox' | 'radio' | 'richtext';
+/**
+ * Form field definition
+ */
+interface FormField {
+    /** Field key in payload object */
+    name: string;
+    /** Field label for UI */
+    label: string;
+    /** Field type (determines UI component) */
+    type: FormFieldType;
+    /** Default value */
+    defaultValue?: unknown;
+    /** Required field */
+    required?: boolean;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Help text */
+    description?: string;
+    /** Options for select/radio */
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    /** Min/max for number */
+    min?: number;
+    max?: number;
+    /** Path to context value for pre-filling (dot notation, e.g., 'proposal.summary') */
+    defaultValueFromContext?: string;
+}
+/**
+ * Form schema for action payload collection
+ */
+interface FormSchema {
+    /** Form title */
+    title?: string;
+    /** Form description */
+    description?: string;
+    /** Form fields */
+    fields: FormField[];
+}
+
 /**
  * Execution interface configuration
  * Defines how a resource is executed via the UI (forms, scheduling, webhooks)
@@ -442,6 +442,8 @@ interface WebhookConfig {
 
 interface WorkflowConfig extends ResourceDefinition {
     type: 'workflow';
+    /** Lead-gen capability key for registry derivation (e.g. 'lead-gen.company.apollo-import') */
+    capabilityKey?: string;
 }
 interface WorkflowStepDefinition {
     id: string;
@@ -3797,384 +3799,81 @@ type Database = {
     };
 };
 
-/** Raw database row type for acq_deals table */
-type AcqDealRow = Database['public']['Tables']['acq_deals']['Row'];
-/**
- * Tracks pipeline status for a company across all processing stages.
- */
-interface CompanyPipelineStatus {
-    acquired: boolean;
-    enrichment: {
-        [source: string]: {
-            status: 'pending' | 'complete' | 'failed' | 'skipped';
-            completedAt?: string;
-            error?: string;
-        };
-    };
-}
-/**
- * Tracks pipeline status for a contact across all processing stages.
- */
-interface ContactPipelineStatus {
-    enrichment: {
-        [source: string]: {
-            status: 'pending' | 'complete' | 'failed' | 'skipped';
-            completedAt?: string;
-            error?: string;
-        };
-    };
-    personalization: {
-        status: 'pending' | 'complete' | 'failed' | 'skipped';
-        completedAt?: string;
-    };
-    outreach: {
-        status: 'pending' | 'sent' | 'replied' | 'bounced' | 'opted-out';
-        sentAt?: string;
-        channel?: string;
-        campaignId?: string;
-    };
-}
-/**
- * Enrichment data collected for a company from various sources.
- */
-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 contact from various sources.
- */
-interface ContactEnrichmentData {
-    linkedin?: {
-        summary?: string;
-        pastExperience?: string;
-        education?: string;
-        activity?: Array<{
-            date?: string;
-            content?: string;
-        }>;
-    };
-}
-type ListStatus = 'draft' | 'enriching' | 'launched' | 'closing' | 'archived';
-interface ScrapingConfig {
-    source?: string;
-    query?: string;
-    filters?: Record<string, unknown>;
-    [key: string]: unknown;
-}
-interface IcpRubric {
-    targetDescription?: string;
-    minReviewCount?: number;
-    minRating?: number;
-    excludeFranchises?: boolean;
-    customRules?: string;
-    qualificationRubricKey?: string | null;
-    [key: string]: unknown;
-}
-interface PipelineStage {
-    key: string;
-    label?: string;
-    description?: string;
-    resourceId?: string;
-    inputTemplate?: Record<string, unknown>;
-    enabled?: boolean;
-    order?: number;
-}
-interface PipelineConfig {
-    stages: PipelineStage[];
-}
-type BuildPlanSnapshotPrimaryEntity = 'company' | 'contact';
-type BuildPlanSnapshotOutput = 'company' | 'contact' | 'export';
-type BuildPlanSnapshotDependencyMode = 'per-record-eligibility';
-interface BuildPlanSnapshotStep {
-    id: string;
-    label: string;
-    description?: string;
-    primaryEntity: BuildPlanSnapshotPrimaryEntity;
-    outputs: BuildPlanSnapshotOutput[];
-    stageKey: string;
-    dependsOn?: string[];
-    dependencyMode: BuildPlanSnapshotDependencyMode;
-    capabilityKey: string;
-    defaultBatchSize: number;
-    maxBatchSize: number;
-}
-interface BuildPlanSnapshot {
-    templateId: string;
-    templateLabel: string;
-    steps: BuildPlanSnapshotStep[];
-}
-interface AcqListMetadata extends Record<string, unknown> {
-    buildPlanSnapshot?: BuildPlanSnapshot;
-}
-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;
-}
-/**
- * Company record in the acquisition database.
- * Contains enriched company data from various sources.
- * Transformed from AcqCompanyRow with camelCase properties.
- */
-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;
-    pipelineStatus: CompanyPipelineStatus | 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;
-}
-/**
- * Contact record in the acquisition database.
- * Contains enriched contact data and personalization content.
- * Transformed from AcqContactRow with camelCase properties.
- */
-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;
-    pipelineStatus: ContactPipelineStatus | 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;
-}
-type DealPriorityBucketKey = 'needs_response' | 'follow_up_due' | 'waiting' | 'stale' | 'closed_low';
-interface DealPriority {
-    bucketKey: DealPriorityBucketKey;
-    rank: number;
-    label: string;
-    color: string;
-    reason: string;
-    latestActivityAt: string | null;
-    nextActionAt: string | null;
-}
-interface DealContact {
-    id: string;
-    first_name: string | null;
-    last_name: string | null;
-    email: string;
-    title: string | null;
-    headline: string | null;
-    linkedin_url: string | null;
-    pipeline_status: 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;
-}
-/** Deal list item with joined contact and company data */
-interface DealListItem extends AcqDealRow {
-    priority: DealPriority;
-    ownership: 'us' | 'them' | null;
-    nextAction: string | null;
-    contact: DealContact | null;
-}
-type DealDetail = DealListItem;
-/** Task kind options for a deal task (human follow-up action type) */
-type AcqDealTaskKind = 'call' | 'email' | 'meeting' | 'other';
-/**
- * A CRM to-do item attached to a deal representing a human follow-up action.
- * Transformed from AcqDealTaskRow with camelCase properties.
- */
-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;
-}
-
-declare const DealSchemas: {
-    DealIdParams: z.ZodObject<{
-        dealId: z.ZodString;
-    }, z.core.$strip>;
-    DealTaskIdParams: z.ZodObject<{
-        dealId: z.ZodString;
-        taskId: z.ZodString;
-    }, z.core.$strip>;
-    ListDealsQuery: z.ZodObject<{
-        stage: z.ZodOptional<z.ZodEnum<{
-            nurturing: "nurturing";
-            closed_won: "closed_won";
-            closed_lost: "closed_lost";
-            interested: "interested";
-            proposal: "proposal";
-            closing: "closing";
-        }>>;
-        search: z.ZodOptional<z.ZodString>;
-        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-        offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-    }, z.core.$strict>;
-    DealLookupQuery: z.ZodObject<{
-        search: z.ZodOptional<z.ZodString>;
-        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-    }, z.core.$strict>;
-    ListDealTasksDueQuery: z.ZodObject<{
-        window: z.ZodOptional<z.ZodEnum<{
-            upcoming: "upcoming";
-            overdue: "overdue";
-            today: "today";
-            today_and_overdue: "today_and_overdue";
-        }>>;
-        assigneeUserId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>;
-    CreateDealNoteRequest: z.ZodObject<{
-        body: z.ZodString;
-    }, z.core.$strict>;
-    CreateDealTaskRequest: z.ZodObject<{
-        title: z.ZodString;
-        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        kind: z.ZodOptional<z.ZodEnum<{
-            other: "other";
-            email: "email";
-            call: "call";
-            meeting: "meeting";
-        }>>;
-        dueAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        assigneeUserId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strict>;
-    TransitionItemRequest: z.ZodObject<{
-        pipelineKey: z.ZodString;
-        stageKey: z.ZodString;
-        stateKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        reason: z.ZodOptional<z.ZodString>;
-        expectedUpdatedAt: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>;
-    TransitionDealStateRequest: z.ZodObject<{
-        stateKey: z.ZodString;
-        reason: z.ZodOptional<z.ZodString>;
-        expectedUpdatedAt: z.ZodOptional<z.ZodString>;
-    }, z.core.$strict>;
-    ExecuteActionParams: z.ZodObject<{
-        dealId: z.ZodString;
-        actionKey: z.ZodString;
-    }, z.core.$strict>;
-    ExecuteActionRequest: z.ZodObject<{
-        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strict>;
-    DealPriority: z.ZodObject<{
-        bucketKey: z.ZodEnum<{
-            needs_response: "needs_response";
-            follow_up_due: "follow_up_due";
-            waiting: "waiting";
-            stale: "stale";
-            closed_low: "closed_low";
+declare const DealSchemas: {
+    DealIdParams: z.ZodObject<{
+        dealId: z.ZodString;
+    }, z.core.$strip>;
+    DealTaskIdParams: z.ZodObject<{
+        dealId: z.ZodString;
+        taskId: z.ZodString;
+    }, z.core.$strip>;
+    ListDealsQuery: z.ZodObject<{
+        stage: z.ZodOptional<z.ZodEnum<{
+            nurturing: "nurturing";
+            closed_won: "closed_won";
+            closed_lost: "closed_lost";
+            interested: "interested";
+            proposal: "proposal";
+            closing: "closing";
+        }>>;
+        search: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strict>;
+    DealLookupQuery: z.ZodObject<{
+        search: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strict>;
+    ListDealTasksDueQuery: z.ZodObject<{
+        window: z.ZodOptional<z.ZodEnum<{
+            upcoming: "upcoming";
+            overdue: "overdue";
+            today: "today";
+            today_and_overdue: "today_and_overdue";
+        }>>;
+        assigneeUserId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    CreateDealNoteRequest: z.ZodObject<{
+        body: z.ZodString;
+    }, z.core.$strict>;
+    CreateDealTaskRequest: z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            other: "other";
+            email: "email";
+            call: "call";
+            meeting: "meeting";
+        }>>;
+        dueAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        assigneeUserId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    TransitionItemRequest: z.ZodObject<{
+        pipelineKey: z.ZodString;
+        stageKey: z.ZodString;
+        stateKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reason: z.ZodOptional<z.ZodString>;
+        expectedUpdatedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    TransitionDealStateRequest: z.ZodObject<{
+        stateKey: z.ZodString;
+        reason: z.ZodOptional<z.ZodString>;
+        expectedUpdatedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    ExecuteActionParams: z.ZodObject<{
+        dealId: z.ZodString;
+        actionKey: z.ZodString;
+    }, z.core.$strict>;
+    ExecuteActionRequest: z.ZodObject<{
+        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>;
+    DealPriority: z.ZodObject<{
+        bucketKey: z.ZodEnum<{
+            needs_response: "needs_response";
+            follow_up_due: "follow_up_due";
+            waiting: "waiting";
+            stale: "stale";
+            closed_low: "closed_low";
         }>;
         rank: z.ZodNumber;
         label: z.ZodString;
@@ -4408,47 +4107,353 @@ declare const DealSchemas: {
             call: "call";
             meeting: "meeting";
         }>;
-        dueAt: z.ZodNullable<z.ZodString>;
-        assigneeUserId: z.ZodNullable<z.ZodString>;
-        completedAt: z.ZodNullable<z.ZodString>;
-        completedByUserId: z.ZodNullable<z.ZodString>;
-        createdAt: z.ZodString;
-        updatedAt: z.ZodString;
-        createdByUserId: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>;
-    DealTaskListResponse: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        organizationId: z.ZodString;
-        dealId: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodNullable<z.ZodString>;
-        kind: z.ZodEnum<{
-            other: "other";
-            email: "email";
-            call: "call";
-            meeting: "meeting";
+        dueAt: z.ZodNullable<z.ZodString>;
+        assigneeUserId: z.ZodNullable<z.ZodString>;
+        completedAt: z.ZodNullable<z.ZodString>;
+        completedByUserId: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        createdByUserId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    DealTaskListResponse: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        organizationId: z.ZodString;
+        dealId: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        kind: z.ZodEnum<{
+            other: "other";
+            email: "email";
+            call: "call";
+            meeting: "meeting";
+        }>;
+        dueAt: z.ZodNullable<z.ZodString>;
+        assigneeUserId: z.ZodNullable<z.ZodString>;
+        completedAt: z.ZodNullable<z.ZodString>;
+        completedByUserId: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        createdByUserId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+};
+/**
+ * One stage entry in a list's `pipeline_config.stages[]`. The `key` is
+ * validated against `LEAD_GEN_STAGE_CATALOG` so list pipeline definitions
+ * stay aligned with the org-os semantic layer.
+ */
+declare const PipelineStageSchema: z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    order: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Terminal row-level status for one lead-gen processing stage.
+ * Missing key still means not attempted; legacy boolean `true` is normalized
+ * to `success` by the API reader during rollout.
+ */
+declare const ProcessingStageStatusSchema: z.ZodEnum<{
+    error: "error";
+    success: "success";
+    no_result: "no_result";
+    skipped: "skipped";
+}>;
+type PipelineStage = z.infer<typeof PipelineStageSchema>;
+type ProcessingStageStatus = z.infer<typeof ProcessingStageStatusSchema>;
+
+/** Raw database row type for acq_deals table */
+type AcqDealRow = Database['public']['Tables']['acq_deals']['Row'];
+/**
+ * Tracks pipeline status for a company across all processing stages.
+ */
+interface CompanyPipelineStatus {
+    acquired: boolean;
+    enrichment: {
+        [source: string]: {
+            status: 'pending' | 'complete' | 'failed' | 'skipped';
+            completedAt?: string;
+            error?: string;
+        };
+    };
+}
+/**
+ * Tracks pipeline status for a contact across all processing stages.
+ */
+interface ContactPipelineStatus {
+    enrichment: {
+        [source: string]: {
+            status: 'pending' | 'complete' | 'failed' | 'skipped';
+            completedAt?: string;
+            error?: string;
+        };
+    };
+    personalization: {
+        status: 'pending' | 'complete' | 'failed' | 'skipped';
+        completedAt?: string;
+    };
+    outreach: {
+        status: 'pending' | 'sent' | 'replied' | 'bounced' | 'opted-out';
+        sentAt?: string;
+        channel?: string;
+        campaignId?: string;
+    };
+}
+/**
+ * Enrichment data collected for a company from various sources.
+ */
+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 contact from various sources.
+ */
+interface ContactEnrichmentData {
+    linkedin?: {
+        summary?: string;
+        pastExperience?: string;
+        education?: string;
+        activity?: Array<{
+            date?: string;
+            content?: string;
         }>;
-        dueAt: z.ZodNullable<z.ZodString>;
-        assigneeUserId: z.ZodNullable<z.ZodString>;
-        completedAt: z.ZodNullable<z.ZodString>;
-        completedByUserId: z.ZodNullable<z.ZodString>;
-        createdAt: z.ZodString;
-        updatedAt: z.ZodString;
-        createdByUserId: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>>;
-};
+    };
+}
+type ListStatus = 'draft' | 'enriching' | 'launched' | 'closing' | 'archived';
+interface ScrapingConfig {
+    source?: string;
+    query?: string;
+    filters?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface IcpRubric {
+    targetDescription?: string;
+    minReviewCount?: number;
+    minRating?: number;
+    excludeFranchises?: boolean;
+    customRules?: string;
+    qualificationRubricKey?: string | null;
+    [key: string]: unknown;
+}
+interface PipelineConfig {
+    stages: PipelineStage[];
+}
+type BuildPlanSnapshotPrimaryEntity = 'company' | 'contact';
+type BuildPlanSnapshotOutput = 'company' | 'contact' | 'export';
+type BuildPlanSnapshotDependencyMode = 'per-record-eligibility';
+interface BuildPlanSnapshotStep {
+    id: string;
+    label: string;
+    description?: string;
+    primaryEntity: BuildPlanSnapshotPrimaryEntity;
+    outputs: BuildPlanSnapshotOutput[];
+    stageKey: string;
+    dependsOn?: string[];
+    dependencyMode: BuildPlanSnapshotDependencyMode;
+    capabilityKey: string;
+    defaultBatchSize: number;
+    maxBatchSize: number;
+}
+interface BuildPlanSnapshot {
+    templateId: string;
+    templateLabel: string;
+    steps: BuildPlanSnapshotStep[];
+}
+interface AcqListMetadata extends Record<string, unknown> {
+    buildPlanSnapshot?: BuildPlanSnapshot;
+}
+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;
+}
 /**
- * Terminal row-level status for one lead-gen processing stage.
- * Missing key still means not attempted; legacy boolean `true` is normalized
- * to `success` by the API reader during rollout.
+ * Company record in the acquisition database.
+ * Contains enriched company data from various sources.
+ * Transformed from AcqCompanyRow with camelCase properties.
  */
-declare const ProcessingStageStatusSchema: z.ZodEnum<{
-    error: "error";
-    success: "success";
-    skipped: "skipped";
-    no_result: "no_result";
-}>;
-type ProcessingStageStatus = z.infer<typeof ProcessingStageStatusSchema>;
+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;
+    pipelineStatus: CompanyPipelineStatus | 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;
+}
+/**
+ * Contact record in the acquisition database.
+ * Contains enriched contact data and personalization content.
+ * Transformed from AcqContactRow with camelCase properties.
+ */
+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;
+    pipelineStatus: ContactPipelineStatus | 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;
+}
+type DealPriorityBucketKey = 'needs_response' | 'follow_up_due' | 'waiting' | 'stale' | 'closed_low';
+interface DealPriority {
+    bucketKey: DealPriorityBucketKey;
+    rank: number;
+    label: string;
+    color: string;
+    reason: string;
+    latestActivityAt: string | null;
+    nextActionAt: string | null;
+}
+interface DealContact {
+    id: string;
+    first_name: string | null;
+    last_name: string | null;
+    email: string;
+    title: string | null;
+    headline: string | null;
+    linkedin_url: string | null;
+    pipeline_status: 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;
+}
+/** Deal list item with joined contact and company data */
+interface DealListItem extends AcqDealRow {
+    priority: DealPriority;
+    ownership: 'us' | 'them' | null;
+    nextAction: string | null;
+    contact: DealContact | null;
+}
+type DealDetail = DealListItem;
+/** Task kind options for a deal task (human follow-up action type) */
+type AcqDealTaskKind = 'call' | 'email' | 'meeting' | 'other';
+/**
+ * A CRM to-do item attached to a deal representing a human follow-up action.
+ * Transformed from AcqDealTaskRow with camelCase properties.
+ */
+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;
+}
 
 /**
  * Lead Service Types
@@ -4536,6 +4541,7 @@ interface CompanyFilters {
     status?: 'active' | 'invalid';
     includeAll?: boolean;
     excludeColumns?: Array<'enrichmentData' | 'pipelineStatus'>;
+    limit?: number;
 }
 interface CreateContactParams {
     organizationId: string;
@@ -8514,6 +8520,7 @@ declare const LinkSchema: z.ZodObject<{
         maps_to: "maps_to";
         "operates-on": "operates-on";
         uses: "uses";
+        governs: "governs";
     }>;
 }, z.core.$strip>;
 type Link = z.infer<typeof LinkSchema>;