@elevasis/sdk 1.17.0 → 1.19.0

package/dist/node/index.d.ts

@@ -9,12 +9,15 @@ interface KnowledgeCodegenNode {
     links: {
         nodeId: string;
     }[];
+    skills: string[];
+    domain?: string;
     ownerIds: string[];
     updatedAt: string;
 }
 interface GenerateKnowledgeNodesOptions {
     sourceDir: string;
     outputPath: string;
+    graphSkillsOutputPath?: string;
     typeImportPath?: string;
     exportedName?: string;
     sourceLabel?: string;

package/dist/node/index.js

@@ -79,10 +79,35 @@ function readKnowledgeNodeMdx(filePath) {
     icon: optionalString(frontmatter, "icon", filePath),
     body,
     links: optionalStringArray(frontmatter, "links", filePath).map((nodeId) => ({ nodeId })),
+    skills: optionalStringArray(frontmatter, "skills", filePath),
+    domain: optionalString(frontmatter, "domain", filePath),
     ownerIds: optionalStringArray(frontmatter, "ownerIds", filePath),
     updatedAt: assertString(frontmatter, "updatedAt", filePath)
   };
 }
+function generateGraphSkillsRegistry(nodes) {
+  const domains = {};
+  for (const node of nodes) {
+    if (!node.domain) continue;
+    const domain = domains[node.domain] ?? { skills: [], nodes: [] };
+    const skills = [...new Set(node.skills)].sort((a, b) => a.localeCompare(b));
+    domain.nodes.push({
+      id: node.id,
+      title: node.title,
+      kind: node.kind,
+      skills
+    });
+    domain.skills = [.../* @__PURE__ */ new Set([...domain.skills, ...skills])].sort((a, b) => a.localeCompare(b));
+    domains[node.domain] = domain;
+  }
+  for (const domain of Object.values(domains)) {
+    domain.nodes.sort((a, b) => a.id.localeCompare(b.id));
+  }
+  return {
+    generatedBy: "generate-knowledge-nodes",
+    domains: Object.fromEntries(Object.entries(domains).sort(([a], [b]) => a.localeCompare(b)))
+  };
+}
 function generateKnowledgeNodesTs(options) {
   const exportedName = options.exportedName ?? "mdxKnowledgeNodes";
   const typeImport = options.typeImportPath ? [`import type { OrgKnowledgeNode } from '${options.typeImportPath}'`, ""] : [];
@@ -118,6 +143,15 @@ function generateKnowledgeNodes(options) {
     }),
     "utf8"
   );
+  if (options.graphSkillsOutputPath) {
+    mkdirSync(dirname(options.graphSkillsOutputPath), { recursive: true });
+    writeFileSync(
+      options.graphSkillsOutputPath,
+      `${JSON.stringify(generateGraphSkillsRegistry(nodes), null, 2)}
+`,
+      "utf8"
+    );
+  }
   return { nodes, outputPath: options.outputPath };
 }
 var ALLOWED_COMPONENTS = /* @__PURE__ */ new Set(["Card", "Cards", "Step", "Steps", "Callout", "Tab", "Tabs"]);
@@ -181,7 +215,6 @@ var FACTORY_BLOCK = [
   " * to be { Fragment, jsx, jsxs } from react/jsx-runtime.",
   " */",
   "function makeKnowledgeComponent(fnBody: string): ComponentType<KnowledgeBodyProps> {",
-  "  // eslint-disable-next-line @typescript-eslint/no-implied-eval",
   "  const factory = new Function(fnBody) as (runtime: MDXRuntime) => { default: ComponentType }",
   "  return function KnowledgeBody(props: KnowledgeBodyProps) {",
   "    const runtime = { Fragment, jsx, jsxs, ...props } as unknown as MDXRuntime",

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

@@ -965,7 +965,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;
@@ -991,7 +991,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;
@@ -1017,7 +1017,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;
@@ -1056,7 +1056,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;
@@ -1084,7 +1084,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;
@@ -1112,7 +1112,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;
@@ -1508,7 +1508,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;
@@ -1523,7 +1522,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;
@@ -1538,7 +1536,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;
@@ -1617,7 +1614,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;
@@ -1632,7 +1628,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;
@@ -1647,7 +1642,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;
@@ -3799,7 +3793,43 @@ type Database = {
     };
 };
 
+/** 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>;
@@ -3809,12 +3839,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>>;
@@ -3849,14 +3874,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>;
@@ -3935,7 +3966,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;
@@ -4049,7 +4088,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;
@@ -4147,57 +4194,21 @@ 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";
-}>;
 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.
  */
@@ -4350,7 +4361,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;
@@ -4385,7 +4398,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;
@@ -4412,7 +4427,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;
@@ -4501,6 +4516,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;
@@ -4513,7 +4530,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;
@@ -4521,7 +4540,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;
@@ -4534,13 +4553,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 {
@@ -4554,6 +4575,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;
@@ -4565,7 +4588,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';
 }
@@ -4574,7 +4599,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';
 }
@@ -4832,6 +4859,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;
@@ -4869,7 +4908,7 @@ interface BulkImportCompanyEntry {
     category?: string;
     source?: string;
     enrichmentData?: Record<string, unknown>;
-    pipelineStatus?: Record<string, unknown>;
+    processingState?: ProcessingState;
 }
 interface BulkImportCompaniesParams {
     organizationId: string;
@@ -7835,6 +7874,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: {