@elevasis/sdk 1.15.1 → 1.16.0

package/dist/index.d.ts

@@ -21,6 +21,16 @@ import { z } from 'zod';
  * @module validation
  */
 
+/**
+ * Validates email format (RFC 5322)
+ *
+ * Security: Prevents email header injection, validates format before sending
+ *
+ * @example
+ * EmailSchema.parse('user@example.com') // OK
+ * EmailSchema.parse('invalid') // Error: Invalid email
+ */
+declare const EmailSchema: z.ZodString;
 /**
  * Standard pagination parameters
  *
@@ -290,56 +300,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[];
-}
-
 /**
  * Serialized Registry Types
  *
@@ -347,67 +307,6 @@ interface FormSchema {
  * Serialization happens once at API startup, enabling instant response times.
  */
 
-/**
- * Serialized form field for API responses
- */
-interface SerializedFormField {
-    name: string;
-    label: string;
-    type: FormFieldType;
-    defaultValue?: unknown;
-    required?: boolean;
-    placeholder?: string;
-    description?: string;
-    options?: Array<{
-        label: string;
-        value: string | number;
-    }>;
-    min?: number;
-    max?: number;
-}
-/**
- * Serialized form schema for API responses
- */
-interface SerializedFormSchema {
-    title?: string;
-    description?: string;
-    fields: SerializedFormField[];
-    layout?: 'vertical' | 'horizontal' | 'grid';
-}
-/**
- * Serialized execution form schema for API responses
- */
-interface SerializedExecutionFormSchema extends SerializedFormSchema {
-    fieldMappings?: Record<string, string>;
-    submitButton?: {
-        label?: string;
-        loadingLabel?: string;
-        confirmMessage?: string;
-    };
-}
-/**
- * Serialized schedule config for API responses
- */
-interface SerializedScheduleConfig {
-    enabled: boolean;
-    defaultSchedule?: string;
-    allowedPatterns?: string[];
-}
-/**
- * Serialized webhook config for API responses
- */
-interface SerializedWebhookConfig {
-    enabled: boolean;
-    payloadSchema?: unknown;
-}
-/**
- * Serialized execution interface for API responses
- */
-interface SerializedExecutionInterface {
-    form: SerializedExecutionFormSchema;
-    schedule?: SerializedScheduleConfig;
-    webhook?: SerializedWebhookConfig;
-}
 /**
  * Serialized agent definition (JSON-safe)
  * Result of serializeDefinition(AgentDefinition)
@@ -463,7 +362,6 @@ interface SerializedAgentDefinition {
         }>;
     };
     metricsConfig?: object;
-    interface?: SerializedExecutionInterface;
 }
 /**
  * Serialized workflow definition (JSON-safe)
@@ -503,7 +401,6 @@ interface SerializedWorkflowDefinition {
         outputSchema?: object;
     };
     metricsConfig?: object;
-    interface?: SerializedExecutionInterface;
 }
 
 /**
@@ -604,6 +501,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)
@@ -661,6 +608,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;
@@ -4016,309 +3965,6 @@ 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;
@@ -4627,47 +4273,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
@@ -4755,6 +4707,7 @@ interface CompanyFilters {
     status?: 'active' | 'invalid';
     includeAll?: boolean;
     excludeColumns?: Array<'enrichmentData' | 'pipelineStatus'>;
+    limit?: number;
 }
 interface CreateContactParams {
     organizationId: string;
@@ -8509,7 +8462,7 @@ interface Tool {
  * Tooling error types
  * Used across platform tools and integration tools
  */
-type ToolingErrorType = 'service_unavailable' | 'permission_denied' | 'adapter_not_found' | 'method_not_found' | 'tool_not_found' | 'credentials_missing' | 'credentials_invalid' | 'rate_limit_exceeded' | 'server_unavailable' | 'auth_error' | 'api_error' | 'validation_error' | 'network_error' | 'timeout_error' | 'unknown_error';
+type ToolingErrorType = 'service_unavailable' | 'permission_denied' | 'platform_internal' | 'adapter_not_found' | 'method_not_found' | 'tool_not_found' | 'credentials_missing' | 'credentials_invalid' | 'rate_limit_exceeded' | 'server_unavailable' | 'auth_error' | 'api_error' | 'validation_error' | 'network_error' | 'timeout_error' | 'unknown_error';
 
 /**
  * Supported integration types
@@ -8897,6 +8850,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>;
@@ -9255,23 +9209,6 @@ declare class ResourceRegistry {
      * @returns Command View data with nodes and edges
      */
     getCommandViewData(organizationName: string): CommandViewData;
-    /**
-     * List resources that have UI interfaces configured
-     * Used by Execution Runner Catalog UI
-     *
-     * @param organizationName - Organization name
-     * @param environment - Optional environment filter ('dev' or 'prod')
-     * @returns Array of resources with interfaces
-     */
-    listExecutable(organizationName: string, environment?: 'dev' | 'prod'): Array<{
-        resourceId: string;
-        resourceName: string;
-        resourceType: 'workflow' | 'agent';
-        description?: string;
-        status: 'dev' | 'prod';
-        version: string;
-        interface: SerializedExecutionInterface;
-    }>;
 }
 
 /**
@@ -9352,5 +9289,5 @@ declare class ToolingError extends ExecutionError {
     constructor(errorType: string, message: string, details?: unknown);
 }
 
-export { ActivityEventSchema, DEFAULT_CRM_ACTIONS, ExecutionError, RegistryValidationError, ResourceRegistry, StepType, ToolingError, deriveActions };
+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 };