@elevasis/sdk 1.17.0 → 1.19.0

package/dist/index.d.ts

@@ -1131,7 +1131,7 @@ type Database = {
                     name: string;
                     num_employees: number | null;
                     organization_id: string;
-                    pipeline_status: Json;
+                    processing_state: Json;
                     qualification_rubric_key: string | null;
                     qualification_score: number | null;
                     qualification_signals: Json | null;
@@ -1157,7 +1157,7 @@ type Database = {
                     name: string;
                     num_employees?: number | null;
                     organization_id: string;
-                    pipeline_status?: Json;
+                    processing_state?: Json;
                     qualification_rubric_key?: string | null;
                     qualification_score?: number | null;
                     qualification_signals?: Json | null;
@@ -1183,7 +1183,7 @@ type Database = {
                     name?: string;
                     num_employees?: number | null;
                     organization_id?: string;
-                    pipeline_status?: Json;
+                    processing_state?: Json;
                     qualification_rubric_key?: string | null;
                     qualification_score?: number | null;
                     qualification_signals?: Json | null;
@@ -1222,7 +1222,7 @@ type Database = {
                     nurture: boolean;
                     opening_line: string | null;
                     organization_id: string;
-                    pipeline_status: Json;
+                    processing_state: Json;
                     qualification_rubric_key: string | null;
                     qualification_score: number | null;
                     qualification_signals: Json | null;
@@ -1250,7 +1250,7 @@ type Database = {
                     nurture?: boolean;
                     opening_line?: string | null;
                     organization_id: string;
-                    pipeline_status?: Json;
+                    processing_state?: Json;
                     qualification_rubric_key?: string | null;
                     qualification_score?: number | null;
                     qualification_signals?: Json | null;
@@ -1278,7 +1278,7 @@ type Database = {
                     nurture?: boolean;
                     opening_line?: string | null;
                     organization_id?: string;
-                    pipeline_status?: Json;
+                    processing_state?: Json;
                     qualification_rubric_key?: string | null;
                     qualification_score?: number | null;
                     qualification_signals?: Json | null;
@@ -1674,7 +1674,6 @@ type Database = {
                     id: string;
                     list_id: string;
                     pipeline_key: string;
-                    processing_state: Json;
                     source_execution_id: string | null;
                     source_input_hash: string | null;
                     source_resource_id: string | null;
@@ -1689,7 +1688,6 @@ type Database = {
                     id?: string;
                     list_id: string;
                     pipeline_key?: string;
-                    processing_state?: Json;
                     source_execution_id?: string | null;
                     source_input_hash?: string | null;
                     source_resource_id?: string | null;
@@ -1704,7 +1702,6 @@ type Database = {
                     id?: string;
                     list_id?: string;
                     pipeline_key?: string;
-                    processing_state?: Json;
                     source_execution_id?: string | null;
                     source_input_hash?: string | null;
                     source_resource_id?: string | null;
@@ -1783,7 +1780,6 @@ type Database = {
                     id: string;
                     list_id: string;
                     pipeline_key: string;
-                    processing_state: Json;
                     source_execution_id: string | null;
                     source_input_hash: string | null;
                     source_resource_id: string | null;
@@ -1798,7 +1794,6 @@ type Database = {
                     id?: string;
                     list_id: string;
                     pipeline_key?: string;
-                    processing_state?: Json;
                     source_execution_id?: string | null;
                     source_input_hash?: string | null;
                     source_resource_id?: string | null;
@@ -1813,7 +1808,6 @@ type Database = {
                     id?: string;
                     list_id?: string;
                     pipeline_key?: string;
-                    processing_state?: Json;
                     source_execution_id?: string | null;
                     source_input_hash?: string | null;
                     source_resource_id?: string | null;
@@ -3965,7 +3959,291 @@ type Database = {
     };
 };
 
+declare const ProspectingBuildTemplateStepSchema: z.ZodObject<{
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    color: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        "nav.dashboard": "nav.dashboard";
+        "nav.calendar": "nav.calendar";
+        "nav.sales": "nav.sales";
+        "nav.crm": "nav.crm";
+        "nav.lead-gen": "nav.lead-gen";
+        "nav.projects": "nav.projects";
+        "nav.operations": "nav.operations";
+        "nav.monitoring": "nav.monitoring";
+        "nav.knowledge": "nav.knowledge";
+        "nav.settings": "nav.settings";
+        "nav.admin": "nav.admin";
+        "nav.archive": "nav.archive";
+        "knowledge.playbook": "knowledge.playbook";
+        "knowledge.strategy": "knowledge.strategy";
+        "knowledge.reference": "knowledge.reference";
+        "feature.dashboard": "feature.dashboard";
+        "feature.calendar": "feature.calendar";
+        "feature.sales": "feature.sales";
+        "feature.crm": "feature.crm";
+        "feature.finance": "feature.finance";
+        "feature.lead-gen": "feature.lead-gen";
+        "feature.platform": "feature.platform";
+        "feature.projects": "feature.projects";
+        "feature.operations": "feature.operations";
+        "feature.knowledge": "feature.knowledge";
+        "feature.monitoring": "feature.monitoring";
+        "feature.settings": "feature.settings";
+        "feature.admin": "feature.admin";
+        "feature.archive": "feature.archive";
+        "feature.seo": "feature.seo";
+        "resource.agent": "resource.agent";
+        "resource.workflow": "resource.workflow";
+        "resource.integration": "resource.integration";
+        "resource.database": "resource.database";
+        "resource.user": "resource.user";
+        "resource.team": "resource.team";
+        "integration.gmail": "integration.gmail";
+        "integration.google-sheets": "integration.google-sheets";
+        "integration.attio": "integration.attio";
+        "surface.dashboard": "surface.dashboard";
+        "surface.calendar": "surface.calendar";
+        "surface.overview": "surface.overview";
+        "surface.command-view": "surface.command-view";
+        "surface.command-queue": "surface.command-queue";
+        "surface.pipeline": "surface.pipeline";
+        "surface.lists": "surface.lists";
+        "surface.resources": "surface.resources";
+        "surface.settings": "surface.settings";
+        "status.success": "status.success";
+        "status.error": "status.error";
+        "status.warning": "status.warning";
+        "status.info": "status.info";
+        "status.pending": "status.pending";
+        "action.approve": "action.approve";
+        "action.reject": "action.reject";
+        "action.retry": "action.retry";
+        "action.edit": "action.edit";
+        "action.view": "action.view";
+        "action.launch": "action.launch";
+        "action.message": "action.message";
+        "action.escalate": "action.escalate";
+        "action.promote": "action.promote";
+        "action.submit": "action.submit";
+        "action.email": "action.email";
+    }>, z.ZodString]>>;
+    id: z.ZodString;
+    primaryEntity: z.ZodEnum<{
+        company: "company";
+        contact: "contact";
+    }>;
+    outputs: z.ZodArray<z.ZodEnum<{
+        company: "company";
+        contact: "contact";
+        export: "export";
+    }>>;
+    stageKey: z.ZodString;
+    dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dependencyMode: z.ZodLiteral<"per-record-eligibility">;
+    capabilityKey: z.ZodString;
+    defaultBatchSize: z.ZodNumber;
+    maxBatchSize: z.ZodNumber;
+}, z.core.$strip>;
+declare const ProspectingBuildTemplateSchema: z.ZodObject<{
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    color: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        "nav.dashboard": "nav.dashboard";
+        "nav.calendar": "nav.calendar";
+        "nav.sales": "nav.sales";
+        "nav.crm": "nav.crm";
+        "nav.lead-gen": "nav.lead-gen";
+        "nav.projects": "nav.projects";
+        "nav.operations": "nav.operations";
+        "nav.monitoring": "nav.monitoring";
+        "nav.knowledge": "nav.knowledge";
+        "nav.settings": "nav.settings";
+        "nav.admin": "nav.admin";
+        "nav.archive": "nav.archive";
+        "knowledge.playbook": "knowledge.playbook";
+        "knowledge.strategy": "knowledge.strategy";
+        "knowledge.reference": "knowledge.reference";
+        "feature.dashboard": "feature.dashboard";
+        "feature.calendar": "feature.calendar";
+        "feature.sales": "feature.sales";
+        "feature.crm": "feature.crm";
+        "feature.finance": "feature.finance";
+        "feature.lead-gen": "feature.lead-gen";
+        "feature.platform": "feature.platform";
+        "feature.projects": "feature.projects";
+        "feature.operations": "feature.operations";
+        "feature.knowledge": "feature.knowledge";
+        "feature.monitoring": "feature.monitoring";
+        "feature.settings": "feature.settings";
+        "feature.admin": "feature.admin";
+        "feature.archive": "feature.archive";
+        "feature.seo": "feature.seo";
+        "resource.agent": "resource.agent";
+        "resource.workflow": "resource.workflow";
+        "resource.integration": "resource.integration";
+        "resource.database": "resource.database";
+        "resource.user": "resource.user";
+        "resource.team": "resource.team";
+        "integration.gmail": "integration.gmail";
+        "integration.google-sheets": "integration.google-sheets";
+        "integration.attio": "integration.attio";
+        "surface.dashboard": "surface.dashboard";
+        "surface.calendar": "surface.calendar";
+        "surface.overview": "surface.overview";
+        "surface.command-view": "surface.command-view";
+        "surface.command-queue": "surface.command-queue";
+        "surface.pipeline": "surface.pipeline";
+        "surface.lists": "surface.lists";
+        "surface.resources": "surface.resources";
+        "surface.settings": "surface.settings";
+        "status.success": "status.success";
+        "status.error": "status.error";
+        "status.warning": "status.warning";
+        "status.info": "status.info";
+        "status.pending": "status.pending";
+        "action.approve": "action.approve";
+        "action.reject": "action.reject";
+        "action.retry": "action.retry";
+        "action.edit": "action.edit";
+        "action.view": "action.view";
+        "action.launch": "action.launch";
+        "action.message": "action.message";
+        "action.escalate": "action.escalate";
+        "action.promote": "action.promote";
+        "action.submit": "action.submit";
+        "action.email": "action.email";
+    }>, z.ZodString]>>;
+    id: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            "nav.dashboard": "nav.dashboard";
+            "nav.calendar": "nav.calendar";
+            "nav.sales": "nav.sales";
+            "nav.crm": "nav.crm";
+            "nav.lead-gen": "nav.lead-gen";
+            "nav.projects": "nav.projects";
+            "nav.operations": "nav.operations";
+            "nav.monitoring": "nav.monitoring";
+            "nav.knowledge": "nav.knowledge";
+            "nav.settings": "nav.settings";
+            "nav.admin": "nav.admin";
+            "nav.archive": "nav.archive";
+            "knowledge.playbook": "knowledge.playbook";
+            "knowledge.strategy": "knowledge.strategy";
+            "knowledge.reference": "knowledge.reference";
+            "feature.dashboard": "feature.dashboard";
+            "feature.calendar": "feature.calendar";
+            "feature.sales": "feature.sales";
+            "feature.crm": "feature.crm";
+            "feature.finance": "feature.finance";
+            "feature.lead-gen": "feature.lead-gen";
+            "feature.platform": "feature.platform";
+            "feature.projects": "feature.projects";
+            "feature.operations": "feature.operations";
+            "feature.knowledge": "feature.knowledge";
+            "feature.monitoring": "feature.monitoring";
+            "feature.settings": "feature.settings";
+            "feature.admin": "feature.admin";
+            "feature.archive": "feature.archive";
+            "feature.seo": "feature.seo";
+            "resource.agent": "resource.agent";
+            "resource.workflow": "resource.workflow";
+            "resource.integration": "resource.integration";
+            "resource.database": "resource.database";
+            "resource.user": "resource.user";
+            "resource.team": "resource.team";
+            "integration.gmail": "integration.gmail";
+            "integration.google-sheets": "integration.google-sheets";
+            "integration.attio": "integration.attio";
+            "surface.dashboard": "surface.dashboard";
+            "surface.calendar": "surface.calendar";
+            "surface.overview": "surface.overview";
+            "surface.command-view": "surface.command-view";
+            "surface.command-queue": "surface.command-queue";
+            "surface.pipeline": "surface.pipeline";
+            "surface.lists": "surface.lists";
+            "surface.resources": "surface.resources";
+            "surface.settings": "surface.settings";
+            "status.success": "status.success";
+            "status.error": "status.error";
+            "status.warning": "status.warning";
+            "status.info": "status.info";
+            "status.pending": "status.pending";
+            "action.approve": "action.approve";
+            "action.reject": "action.reject";
+            "action.retry": "action.retry";
+            "action.edit": "action.edit";
+            "action.view": "action.view";
+            "action.launch": "action.launch";
+            "action.message": "action.message";
+            "action.escalate": "action.escalate";
+            "action.promote": "action.promote";
+            "action.submit": "action.submit";
+            "action.email": "action.email";
+        }>, z.ZodString]>>;
+        id: z.ZodString;
+        primaryEntity: z.ZodEnum<{
+            company: "company";
+            contact: "contact";
+        }>;
+        outputs: z.ZodArray<z.ZodEnum<{
+            company: "company";
+            contact: "contact";
+            export: "export";
+        }>>;
+        stageKey: z.ZodString;
+        dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        dependencyMode: z.ZodLiteral<"per-record-eligibility">;
+        capabilityKey: z.ZodString;
+        defaultBatchSize: z.ZodNumber;
+        maxBatchSize: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type ListBuilderStep = z.infer<typeof ProspectingBuildTemplateStepSchema>;
+
+/** One entry in the lead-gen stage catalog. */
+interface LeadGenStageCatalogEntry {
+    /** Matches the status key written into processing_state jsonb (e.g. 'scraped'). */
+    key: string;
+    /** Human-readable label for UI display. */
+    label: string;
+    /** Short description of what this stage represents. */
+    description: string;
+    /** Canonical pipeline order for UI sorting. Lower = earlier in the funnel. */
+    order: number;
+    /** Which entity's processing_state jsonb carries this stage status. */
+    entity: 'company' | 'contact';
+}
+/**
+ * Canonical lead-gen processing stage catalog.
+ * Keys are the stage names written by workflow steps into processing_state jsonb.
+ *
+ * Ordered roughly by pipeline progression (prospecting → outreach → qualification).
+ */
+declare const LEAD_GEN_STAGE_CATALOG: Record<string, LeadGenStageCatalogEntry>;
+
+declare const ProcessingStageStatusSchema: z.ZodEnum<{
+    error: "error";
+    success: "success";
+    no_result: "no_result";
+    skipped: "skipped";
+}>;
 declare const DealSchemas: {
+    CrmStageKey: z.ZodEnum<{
+        [x: string]: string;
+    }>;
+    CrmStateKey: z.ZodEnum<{
+        [x: string]: string;
+    }>;
+    DealStage: z.ZodEnum<{
+        [x: string]: string;
+    }>;
     DealIdParams: z.ZodObject<{
         dealId: z.ZodString;
     }, z.core.$strip>;
@@ -3975,12 +4253,7 @@ declare const DealSchemas: {
     }, 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";
+            [x: string]: string;
         }>>;
         search: z.ZodOptional<z.ZodString>;
         limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -4015,14 +4288,20 @@ declare const DealSchemas: {
         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>>;
+        pipelineKey: z.ZodLiteral<string>;
+        stageKey: z.ZodEnum<{
+            [x: string]: string;
+        }>;
+        stateKey: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            [x: string]: string;
+        }>>>;
         reason: z.ZodOptional<z.ZodString>;
         expectedUpdatedAt: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
     TransitionDealStateRequest: z.ZodObject<{
-        stateKey: z.ZodString;
+        stateKey: z.ZodEnum<{
+            [x: string]: string;
+        }>;
         reason: z.ZodOptional<z.ZodString>;
         expectedUpdatedAt: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
@@ -4101,7 +4380,15 @@ declare const DealSchemas: {
                 title: z.ZodNullable<z.ZodString>;
                 headline: z.ZodNullable<z.ZodString>;
                 linkedin_url: z.ZodNullable<z.ZodString>;
-                pipeline_status: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                processing_state: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    status: z.ZodEnum<{
+                        error: "error";
+                        success: "success";
+                        no_result: "no_result";
+                        skipped: "skipped";
+                    }>;
+                    data: z.ZodOptional<z.ZodUnknown>;
+                }, z.core.$loose>>>;
                 enrichment_data: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                 company: z.ZodNullable<z.ZodObject<{
                     id: z.ZodString;
@@ -4215,7 +4502,15 @@ declare const DealSchemas: {
             title: z.ZodNullable<z.ZodString>;
             headline: z.ZodNullable<z.ZodString>;
             linkedin_url: z.ZodNullable<z.ZodString>;
-            pipeline_status: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            processing_state: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
+                status: z.ZodEnum<{
+                    error: "error";
+                    success: "success";
+                    no_result: "no_result";
+                    skipped: "skipped";
+                }>;
+                data: z.ZodOptional<z.ZodUnknown>;
+            }, z.core.$loose>>>;
             enrichment_data: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             company: z.ZodNullable<z.ZodObject<{
                 id: z.ZodString;
@@ -4313,57 +4608,41 @@ declare const PipelineStageSchema: z.ZodObject<{
     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";
-}>;
+declare const BuildPlanSnapshotStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    primaryEntity: z.ZodEnum<{
+        company: "company";
+        contact: "contact";
+    }>;
+    outputs: z.ZodArray<z.ZodEnum<{
+        company: "company";
+        contact: "contact";
+        export: "export";
+    }>>;
+    stageKey: z.ZodString;
+    dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    dependencyMode: z.ZodLiteral<"per-record-eligibility">;
+    capabilityKey: z.ZodString;
+    defaultBatchSize: z.ZodNumber;
+    maxBatchSize: z.ZodNumber;
+}, z.core.$strip>;
 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;
-    };
+type LeadGenStageKey = (typeof LEAD_GEN_STAGE_CATALOG)[keyof typeof LEAD_GEN_STAGE_CATALOG]['key'];
+interface ProcessingStateEntry {
+    status: ProcessingStageStatus;
+    data?: unknown;
 }
+type ProcessingState = Partial<Record<LeadGenStageKey, ProcessingStateEntry>>;
+type CompanyProcessingState = ProcessingState;
+type ContactProcessingState = ProcessingState;
+/** @deprecated Use `processingState`. Retained only as a compile-time/read-shape bridge for external tenants. */
+type LegacyPipelineStatus = unknown;
 /**
  * Enrichment data collected for a company from various sources.
  */
@@ -4516,7 +4795,9 @@ interface AcqCompany {
     category: string | null;
     categoryPain: string | null;
     segment: string | null;
-    pipelineStatus: CompanyPipelineStatus | 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;
@@ -4551,7 +4832,9 @@ interface AcqContact {
     openingLine: string | null;
     source: string | null;
     sourceId: string | null;
-    pipelineStatus: ContactPipelineStatus | 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;
@@ -4578,7 +4861,7 @@ interface DealContact {
     title: string | null;
     headline: string | null;
     linkedin_url: string | null;
-    pipeline_status: Record<string, unknown> | null;
+    processing_state: Record<string, unknown> | null;
     enrichment_data: Record<string, unknown> | null;
     company: {
         id: string;
@@ -4667,6 +4950,8 @@ interface CreateCompanyParams {
     source?: string;
     batchId?: string;
     verticalResearch?: string;
+    /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+    pipelineStatus?: unknown;
 }
 interface UpdateCompanyParams {
     name?: string;
@@ -4679,7 +4964,9 @@ interface UpdateCompanyParams {
     locationState?: string;
     category?: string;
     segment?: string;
-    pipelineStatus?: Record<string, unknown>;
+    processingState?: ProcessingState;
+    /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+    pipelineStatus?: unknown;
     enrichmentData?: Record<string, unknown>;
     source?: string;
     batchId?: string;
@@ -4687,7 +4974,7 @@ interface UpdateCompanyParams {
     verticalResearch?: string | null;
     /** Track A: flat qualification score column (null until a scoring rubric is defined) */
     qualificationScore?: number | null;
-    /** Track A: flat qualification signals jsonb — mirrors the former pipeline_status.qualification shape */
+    /** Track A: flat qualification signals jsonb */
     qualificationSignals?: Record<string, unknown> | null;
     /** Track A: key identifying the rubric used for qualification */
     qualificationRubricKey?: string | null;
@@ -4700,13 +4987,15 @@ interface CompanyFilters {
     website?: string;
     segment?: string;
     category?: string;
-    pipelineStatus?: Record<string, unknown>;
-    /** Exclude companies whose pipeline_status contains this value (PostgREST NOT contains) */
-    pipelineStatusNot?: Record<string, unknown>;
+    processingState?: ProcessingState;
+    /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+    pipelineStatus?: unknown;
+    /** Exclude companies whose processing state contains this value (PostgREST NOT contains) */
+    processingStateNot?: ProcessingState;
     batchId?: string;
     status?: 'active' | 'invalid';
     includeAll?: boolean;
-    excludeColumns?: Array<'enrichmentData' | 'pipelineStatus'>;
+    excludeColumns?: Array<'enrichmentData' | 'processingState'>;
     limit?: number;
 }
 interface CreateContactParams {
@@ -4720,6 +5009,8 @@ interface CreateContactParams {
     source?: string;
     sourceId?: string;
     batchId?: string;
+    /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+    pipelineStatus?: unknown;
 }
 interface UpdateContactParams {
     companyId?: string;
@@ -4731,7 +5022,9 @@ interface UpdateContactParams {
     headline?: string;
     filterReason?: string;
     openingLine?: string;
-    pipelineStatus?: Record<string, unknown>;
+    processingState?: ProcessingState;
+    /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+    pipelineStatus?: unknown;
     enrichmentData?: Record<string, unknown>;
     status?: 'active' | 'invalid';
 }
@@ -4740,7 +5033,9 @@ interface ContactFilters {
     listId?: string;
     search?: string;
     openingLineIsNull?: boolean;
-    pipelineStatus?: Record<string, unknown>;
+    processingState?: ProcessingState;
+    /** @deprecated Use processingState. Accepted as a no-op compatibility bridge for external tenants. */
+    pipelineStatus?: unknown;
     batchId?: string;
     contactStatus?: 'active' | 'invalid';
 }
@@ -4998,6 +5293,18 @@ interface UpdateContactStageParams {
     status?: ProcessingStageStatus;
     executionId?: string;
 }
+interface ListPendingCompanyIdsParams {
+    organizationId: string;
+    listId: string;
+    stageKey: string;
+    limit?: number;
+}
+interface ListPendingContactIdsParams {
+    organizationId: string;
+    listId: string;
+    stageKey: string;
+    limit?: number;
+}
 interface AddCompaniesToListParams {
     organizationId: string;
     listId: string;
@@ -5035,7 +5342,7 @@ interface BulkImportCompanyEntry {
     category?: string;
     source?: string;
     enrichmentData?: Record<string, unknown>;
-    pipelineStatus?: Record<string, unknown>;
+    processingState?: ProcessingState;
 }
 interface BulkImportCompaniesParams {
     organizationId: string;
@@ -8082,6 +8389,14 @@ type ListToolMap = {
         params: Omit<UpdateContactStageParams, 'organizationId'>;
         result: void;
     };
+    listPendingCompanyIds: {
+        params: Omit<ListPendingCompanyIdsParams, 'organizationId'>;
+        result: string[];
+    };
+    listPendingContactIds: {
+        params: Omit<ListPendingContactIdsParams, 'organizationId'>;
+        result: string[];
+    };
 };
 type PdfToolMap = {
     render: {
@@ -9289,5 +9604,162 @@ declare class ToolingError extends ExecutionError {
     constructor(errorType: string, message: string, details?: unknown);
 }
 
-export { ActivityEventSchema, DEFAULT_CRM_ACTIONS, EmailSchema, ExecutionError, RegistryValidationError, ResourceRegistry, StepType, ToolingError, deriveActions };
-export type { AbsoluteScheduleConfig, AcqCompany, AcqContact, AcqDeal, AcqDealRow, AcqList, Action, ActionDef, ActivityEvent, AddToCampaignLead, AddToCampaignParams, AddToCampaignResult, AgentConfig, AgentConstraints, AgentDefinition, AgentMemory, FindCompanyEmailParams as AnymailfinderFindCompanyEmailParams, FindCompanyEmailResult as AnymailfinderFindCompanyEmailResult, FindDecisionMakerEmailParams as AnymailfinderFindDecisionMakerEmailParams, FindDecisionMakerEmailResult as AnymailfinderFindDecisionMakerEmailResult, FindPersonEmailParams as AnymailfinderFindPersonEmailParams, FindPersonEmailResult as AnymailfinderFindPersonEmailResult, AnymailfinderToolMap, VerifyEmailParams as AnymailfinderVerifyEmailParams, VerifyEmailResult as AnymailfinderVerifyEmailResult, ApifyToolMap, ApifyWebhookConfig, AppendRowsParams, AppendRowsResult, ApprovalToolMap, AttioToolMap, BatchUpdateParams, BatchUpdateResult, BulkDeleteLeadsParams, BulkDeleteLeadsResult, BulkImportParams, BulkImportResult, CancelHitlByDealIdParams, CancelSchedulesAndHitlByEmailParams, ClearDealFieldsParams, ClearRangeParams, ClearRangeResult, CompanyFilters, ConditionalNext, ContactFilters, Contract, CreateAttributeParams, CreateAttributeResult, CreateAutoPaymentLinkParams, CreateAutoPaymentLinkResult, CreateCheckoutSessionParams, CreateCheckoutSessionResult, CreateCompanyParams, CreateContactParams, CreateEnvelopeParams, CreateEnvelopeResult, CreateFolderParams, CreateFolderResult, CreateListParams, CreateNoteParams, CreateNoteResult, CreatePaymentLinkParams, CreatePaymentLinkResult, CreateRecordParams, CreateRecordResult, CreateScheduleInput, CrmToolMap, DeleteDealParams, DeleteNoteParams, DeleteNoteResult, DeleteRecordParams, DeleteRecordResult, DeleteRowByValueParams, DeleteRowByValueResult, DeploymentSpec, DownloadDocumentParams, DownloadDocumentResult, DropboxToolMap, ElevasConfig, EmailToolMap, EnvelopeDocument, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, ExecutionToolMap, FilterExpression, FilterRowsParams, FilterRowsResult, FormField, FormFieldType, FormSchema, GetDailyCampaignAnalyticsParams, GetDailyCampaignAnalyticsResult, GetEmailsParams, GetEmailsResult, GetEnvelopeParams, GetEnvelopeResult, GetHeadersParams, GetHeadersResult, GetLastRowParams, GetLastRowResult, GetPaymentLinkParams, GetPaymentLinkResult, GetRecordParams, GetRecordResult, GetRowByValueParams, GetRowByValueResult, GetSpreadsheetMetadataParams, GetSpreadsheetMetadataResult, GmailSendEmailParams, GmailSendEmailResult, GmailToolMap, GoogleSheetsToolMap, HumanCheckpointDefinition, InstantlyToolMap, IntegrationDefinition, LLMAdapterFactory, LLMGenerateRequest, LLMGenerateResponse, LLMMessage, LLMModel, LeadToolMap, LinearNext, ListAttributesParams, ListAttributesResult, ListLeadsParams, ListLeadsResult, ListNotesParams, ListNotesResult, ListObjectsResult, ListPaymentLinksParams, ListPaymentLinksResult, ListToolMap, MarkProposalReviewedParams, MarkProposalSentParams, MethodEntry, MillionVerifierToolMap, ModelConfig, NextConfig, NotificationSDKInput, NotificationToolMap, PaginatedResult, PaginationParams, PdfToolMap, ProjectsToolMap, QueryRecordsParams, QueryRecordsResult, ReadSheetParams, ReadSheetResult, Recipient, RecurringScheduleConfig, RelationshipDeclaration, RelativeScheduleConfig, RemoveFromSubsequenceParams, RemoveFromSubsequenceResult, ResendGetEmailParams, ResendGetEmailResult, ResendSendEmailParams, ResendSendEmailResult, ResendToolMap, ResourceCategory, ResourceDefinition, ResourceLink, ResourceMetricsConfig, ResourceRelationships, ResourceStatus$1 as ResourceStatus, ResourceType, RunActorParams, RunActorResult, SDKLLMGenerateParams, ScheduleOriginTracking, ScheduleTarget, ScheduleTriggerConfig, SchedulerToolMap, SendReplyParams, SendReplyResult, SetContactNurtureParams, SheetInfo, SignatureApiFieldType, SignatureApiToolMap, SigningPlace, SortCriteria, StartActorParams, StartActorResult, StepHandler, StorageDeleteInput, StorageDeleteOutput, StorageDownloadInput, StorageDownloadOutput, StorageListInput, StorageListOutput, StorageSignedUrlInput, StorageSignedUrlOutput, StorageToolMap, StorageUploadInput, StorageUploadOutput, StripeToolMap, TaskSchedule, TaskScheduleConfig, TombaToolMap, Tool, ToolExecutionOptions, ToolMethodMap, ToolingErrorType, TransitionItemParams, TriggerConfig, TriggerDefinition, UpdateAttributeParams, UpdateAttributeResult, UpdateCloseLostReasonParams, UpdateCompanyParams, UpdateContactParams, UpdateDiscoveryDataParams, UpdateFeesParams, UpdateInterestStatusParams, UpdateInterestStatusResult, UpdateListParams, UpdatePaymentLinkParams, UpdatePaymentLinkResult, UpdateProposalDataParams, UpdateRecordParams, UpdateRecordResult, UpdateRowByValueParams, UpdateRowByValueResult, UploadFileParams, UploadFileResult, UpsertCompanyParams, UpsertContactParams, UpsertDealParams, UpsertRowParams, UpsertRowResult, VoidEnvelopeParams, VoidEnvelopeResult, WebhookProviderType, WebhookTriggerConfig, WorkflowConfig, WorkflowDefinition, WorkflowStep, WriteSheetParams, WriteSheetResult };
+// ============================================================================
+// Lead-Gen Stateful Pipeline Definitions (Decision N8, Wave 4)
+//
+// Defines the (pipeline_key, stage_key, state_key) vocabulary for the three
+// entities that carry the Stateful trait via Track B:
+//   - acq_lists         (pipeline_key='lead-gen', stage_key='lifecycle')
+//   - acq_list_members  (pipeline_key='lead-gen', stages: outreach / prospecting / qualification)
+//   - acq_list_companies (pipeline_key='lead-gen', stages: outreach / prospecting / qualification)
+//
+// DB columns (pipeline_key, stage_key, state_key) remain free-form text with no
+// CHECK constraint — new states can be introduced without a migration (Decision N8).
+// These definitions are the org-specific source of truth consumed by UI and tooling.
+//
+// State vocabularies sourced from the post-restructure sales tree (W3 canonical):
+//   outreach/:
+//     - personalized  (instantly-personalization.ts → contacts)
+//     - uploaded      (instantly-upload.ts → contacts)
+//     - interested    (instantly-reply-handler.ts → contacts, initial reply transition)
+//   prospecting/:
+//     - populated     (apify-acquire.ts, apify-scrape.ts → companies)
+//     - extracted     (website-extract.ts → companies)
+//     - discovered    (email-discovery.ts, anymailfinder-enrich.ts → contacts)
+//     - verified      (email-verification.ts → contacts)
+//   qualification/:
+//     - qualified     (company-qualification.ts → companies)
+//
+// The 'pending' state is the W2 backfill default (coalesce(stage, 'pending')).
+// It is valid in any stage and represents "not yet processed by a workflow step".
+// ============================================================================
+
+/** One state within a stage — minimal shape: key + display label. */
+interface StatefulStateDefinition {
+  /** Matches state_key values written by workflow steps. */
+  stateKey: string
+  label: string
+}
+
+/** One stage within a pipeline — has a stage_key and an ordered list of valid states. */
+interface StatefulStageDefinition {
+  /** Matches stage_key values written by workflow steps. */
+  stageKey: string
+  label: string
+  /** UI color token. Consumers may map this to their design system. */
+  color?: string
+  states: StatefulStateDefinition[]
+}
+
+/**
+ * Pipeline definition for a single entity participating in the Stateful trait.
+ * Parallel to acq_deals' pipeline_key concept but structured for lead-gen entities.
+ */
+interface StatefulPipelineDefinition {
+  /** Matches pipeline_key values in the database (e.g. 'lead-gen'). */
+  pipelineKey: string
+  label: string
+  /** Entity this pipeline applies to (e.g. 'acq.list', 'acq.list-member', 'acq.list-company'). */
+  entityKey: string
+  stages: StatefulStageDefinition[]
+}
+
+// ============================================================================
+// CRM Stateful Pipeline Definition
+//
+// Defines the (pipeline_key, stage_key, state_key) vocabulary for crm.deal
+// entities. Stage keys match DEFAULT_ORGANIZATION_MODEL_SALES.pipelines[0].stages.
+//
+// State vocabularies sourced from the CRM action/handler tree:
+//   interested/:
+//     - discovery_replied     (instantly-reply-handler.ts → first/subsequent reply)
+//     - discovery_link_sent   (crm-send-booking-link.ts, crm-rebook.ts → booking link sent)
+//     - discovery_nudging     (crm-send-nudge.ts → nudge sent after link)
+//     - discovery_booking_cancelled (booking-revert.ts → Cal cancellation webhook)
+//     - reply_sent            (crm-send-reply.ts → operator reply sent)
+//     - followup_1_sent       (crm-reply-followup.ts day=3)
+//     - followup_2_sent       (crm-reply-followup.ts day=5)
+//     - followup_3_sent       (crm-reply-followup.ts day=7)
+//   proposal, closing, closed_won, closed_lost, nurturing: no observed sub-states
+// ============================================================================
+
+declare const CRM_DISCOVERY_REPLIED_STATE: StatefulStateDefinition = {
+  stateKey: 'discovery_replied',
+  label: 'Discovery Replied'
+}
+declare const CRM_DISCOVERY_LINK_SENT_STATE: StatefulStateDefinition = {
+  stateKey: 'discovery_link_sent',
+  label: 'Discovery Link Sent'
+}
+declare const CRM_DISCOVERY_NUDGING_STATE: StatefulStateDefinition = {
+  stateKey: 'discovery_nudging',
+  label: 'Discovery Nudging'
+}
+declare const CRM_DISCOVERY_BOOKING_CANCELLED_STATE: StatefulStateDefinition = {
+  stateKey: 'discovery_booking_cancelled',
+  label: 'Discovery Booking Cancelled'
+}
+declare const CRM_REPLY_SENT_STATE: StatefulStateDefinition = {
+  stateKey: 'reply_sent',
+  label: 'Reply Sent'
+}
+declare const CRM_FOLLOWUP_1_SENT_STATE: StatefulStateDefinition = {
+  stateKey: 'followup_1_sent',
+  label: 'Follow-up 1 Sent'
+}
+declare const CRM_FOLLOWUP_2_SENT_STATE: StatefulStateDefinition = {
+  stateKey: 'followup_2_sent',
+  label: 'Follow-up 2 Sent'
+}
+declare const CRM_FOLLOWUP_3_SENT_STATE: StatefulStateDefinition = {
+  stateKey: 'followup_3_sent',
+  label: 'Follow-up 3 Sent'
+}
+
+declare const CRM_PIPELINE_DEFINITION: StatefulPipelineDefinition = {
+  pipelineKey: 'crm',
+  label: 'CRM',
+  entityKey: 'crm.deal',
+  stages: [
+    {
+      stageKey: 'interested',
+      label: 'Interested',
+      color: 'blue',
+      states: [
+        CRM_DISCOVERY_REPLIED_STATE,
+        CRM_DISCOVERY_LINK_SENT_STATE,
+        CRM_DISCOVERY_NUDGING_STATE,
+        CRM_DISCOVERY_BOOKING_CANCELLED_STATE,
+        CRM_REPLY_SENT_STATE,
+        CRM_FOLLOWUP_1_SENT_STATE,
+        CRM_FOLLOWUP_2_SENT_STATE,
+        CRM_FOLLOWUP_3_SENT_STATE
+      ]
+    },
+    { stageKey: 'proposal', label: 'Proposal', color: 'yellow', states: [] },
+    { stageKey: 'closing', label: 'Closing', color: 'orange', states: [] },
+    { stageKey: 'closed_won', label: 'Closed Won', color: 'green', states: [] },
+    { stageKey: 'closed_lost', label: 'Closed Lost', color: 'red', states: [] },
+    { stageKey: 'nurturing', label: 'Nurturing', color: 'grape', states: [] }
+  ]
+}
+
+declare const CrmStageKeySchema = z.enum(crmStageKeys)
+declare const CrmStateKeySchema = z.enum(crmStateKeys)
+type CrmStageKey = z.infer<typeof CrmStageKeySchema>
+type CrmStateKey = z.infer<typeof CrmStateKeySchema>
+
+/**
+ * @elevasis/sdk - Types and utilities for building Elevasis organization resources
+ *
+ * All types are re-exported from @repo/core and inlined at build time
+ * via rollup-plugin-dts. External consumers never see @repo/core.
+ */
+
+declare const ListBuilderStageKeySchema: z.ZodEnum<{
+    [x: string]: string;
+}>;
+type ListBuilderStageKey = z.infer<typeof ListBuilderStageKeySchema>;
+
+export { ActivityEventSchema, BuildPlanSnapshotStepSchema, ProspectingBuildTemplateSchema as BuildTemplateSchema, CRM_PIPELINE_DEFINITION, CrmStageKeySchema, CrmStateKeySchema, DEFAULT_CRM_ACTIONS, EmailSchema, ExecutionError, LEAD_GEN_STAGE_CATALOG, ListBuilderStageKeySchema, ProcessingStageStatusSchema, RegistryValidationError, ResourceRegistry, StepType, ToolingError, deriveActions };
+export type { AbsoluteScheduleConfig, AcqCompany, AcqContact, AcqDeal, AcqDealRow, AcqList, Action, ActionDef, ActivityEvent, AddToCampaignLead, AddToCampaignParams, AddToCampaignResult, AgentConfig, AgentConstraints, AgentDefinition, AgentMemory, FindCompanyEmailParams as AnymailfinderFindCompanyEmailParams, FindCompanyEmailResult as AnymailfinderFindCompanyEmailResult, FindDecisionMakerEmailParams as AnymailfinderFindDecisionMakerEmailParams, FindDecisionMakerEmailResult as AnymailfinderFindDecisionMakerEmailResult, FindPersonEmailParams as AnymailfinderFindPersonEmailParams, FindPersonEmailResult as AnymailfinderFindPersonEmailResult, AnymailfinderToolMap, VerifyEmailParams as AnymailfinderVerifyEmailParams, VerifyEmailResult as AnymailfinderVerifyEmailResult, ApifyToolMap, ApifyWebhookConfig, AppendRowsParams, AppendRowsResult, ApprovalToolMap, AttioToolMap, BatchUpdateParams, BatchUpdateResult, BuildPlanSnapshotStep, BulkDeleteLeadsParams, BulkDeleteLeadsResult, BulkImportParams, BulkImportResult, CancelHitlByDealIdParams, CancelSchedulesAndHitlByEmailParams, ClearDealFieldsParams, ClearRangeParams, ClearRangeResult, CompanyFilters, ConditionalNext, ContactFilters, Contract, CreateAttributeParams, CreateAttributeResult, CreateAutoPaymentLinkParams, CreateAutoPaymentLinkResult, CreateCheckoutSessionParams, CreateCheckoutSessionResult, CreateCompanyParams, CreateContactParams, CreateEnvelopeParams, CreateEnvelopeResult, CreateFolderParams, CreateFolderResult, CreateListParams, CreateNoteParams, CreateNoteResult, CreatePaymentLinkParams, CreatePaymentLinkResult, CreateRecordParams, CreateRecordResult, CreateScheduleInput, CrmStageKey, CrmStateKey, CrmToolMap, DeleteDealParams, DeleteNoteParams, DeleteNoteResult, DeleteRecordParams, DeleteRecordResult, DeleteRowByValueParams, DeleteRowByValueResult, DeploymentSpec, DownloadDocumentParams, DownloadDocumentResult, DropboxToolMap, ElevasConfig, EmailToolMap, EnvelopeDocument, EventTriggerConfig, ExecutionContext, ExecutionInterface, ExecutionMetadata, ExecutionToolMap, FilterExpression, FilterRowsParams, FilterRowsResult, FormField, FormFieldType, FormSchema, GetDailyCampaignAnalyticsParams, GetDailyCampaignAnalyticsResult, GetEmailsParams, GetEmailsResult, GetEnvelopeParams, GetEnvelopeResult, GetHeadersParams, GetHeadersResult, GetLastRowParams, GetLastRowResult, GetPaymentLinkParams, GetPaymentLinkResult, GetRecordParams, GetRecordResult, GetRowByValueParams, GetRowByValueResult, GetSpreadsheetMetadataParams, GetSpreadsheetMetadataResult, GmailSendEmailParams, GmailSendEmailResult, GmailToolMap, GoogleSheetsToolMap, HumanCheckpointDefinition, InstantlyToolMap, IntegrationDefinition, LLMAdapterFactory, LLMGenerateRequest, LLMGenerateResponse, LLMMessage, LLMModel, LeadToolMap, LinearNext, ListAttributesParams, ListAttributesResult, ListBuilderStageKey, ListBuilderStep, ListLeadsParams, ListLeadsResult, ListNotesParams, ListNotesResult, ListObjectsResult, ListPaymentLinksParams, ListPaymentLinksResult, ListToolMap, MarkProposalReviewedParams, MarkProposalSentParams, MethodEntry, MillionVerifierToolMap, ModelConfig, NextConfig, NotificationSDKInput, NotificationToolMap, PaginatedResult, PaginationParams, PdfToolMap, ProcessingStageStatus, ProjectsToolMap, QueryRecordsParams, QueryRecordsResult, ReadSheetParams, ReadSheetResult, Recipient, RecurringScheduleConfig, RelationshipDeclaration, RelativeScheduleConfig, RemoveFromSubsequenceParams, RemoveFromSubsequenceResult, ResendGetEmailParams, ResendGetEmailResult, ResendSendEmailParams, ResendSendEmailResult, ResendToolMap, ResourceCategory, ResourceDefinition, ResourceLink, ResourceMetricsConfig, ResourceRelationships, ResourceStatus$1 as ResourceStatus, ResourceType, RunActorParams, RunActorResult, SDKLLMGenerateParams, ScheduleOriginTracking, ScheduleTarget, ScheduleTriggerConfig, SchedulerToolMap, SendReplyParams, SendReplyResult, SetContactNurtureParams, SheetInfo, SignatureApiFieldType, SignatureApiToolMap, SigningPlace, SortCriteria, StartActorParams, StartActorResult, StepHandler, StorageDeleteInput, StorageDeleteOutput, StorageDownloadInput, StorageDownloadOutput, StorageListInput, StorageListOutput, StorageSignedUrlInput, StorageSignedUrlOutput, StorageToolMap, StorageUploadInput, StorageUploadOutput, StripeToolMap, TaskSchedule, TaskScheduleConfig, TombaToolMap, Tool, ToolExecutionOptions, ToolMethodMap, ToolingErrorType, TransitionItemParams, TriggerConfig, TriggerDefinition, UpdateAttributeParams, UpdateAttributeResult, UpdateCloseLostReasonParams, UpdateCompanyParams, UpdateContactParams, UpdateDiscoveryDataParams, UpdateFeesParams, UpdateInterestStatusParams, UpdateInterestStatusResult, UpdateListParams, UpdatePaymentLinkParams, UpdatePaymentLinkResult, UpdateProposalDataParams, UpdateRecordParams, UpdateRecordResult, UpdateRowByValueParams, UpdateRowByValueResult, UploadFileParams, UploadFileResult, UpsertCompanyParams, UpsertContactParams, UpsertDealParams, UpsertRowParams, UpsertRowResult, VoidEnvelopeParams, VoidEnvelopeResult, WebhookProviderType, WebhookTriggerConfig, WorkflowConfig, WorkflowDefinition, WorkflowStep, WriteSheetParams, WriteSheetResult };