@elevasis/sdk 1.22.1 → 1.24.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z, ZodTypeAny } from 'zod';
 
 /**
  * Common validation utilities
@@ -526,14 +526,18 @@ declare const WorkflowResourceEntrySchema$1: z.ZodObject<{
         writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
         usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
         emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        contract: z.ZodOptional<z.ZodObject<{
+            input: z.ZodOptional<z.ZodString>;
+            output: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         role: z.ZodEnum<{
-            schema: "schema";
             config: "config";
             entrypoint: "entrypoint";
             handler: "handler";
+            schema: "schema";
             test: "test";
             docs: "docs";
         }>;
@@ -573,14 +577,18 @@ declare const AgentResourceEntrySchema: z.ZodObject<{
         writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
         usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
         emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        contract: z.ZodOptional<z.ZodObject<{
+            input: z.ZodOptional<z.ZodString>;
+            output: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         role: z.ZodEnum<{
-            schema: "schema";
             config: "config";
             entrypoint: "entrypoint";
             handler: "handler";
+            schema: "schema";
             test: "test";
             docs: "docs";
         }>;
@@ -651,14 +659,18 @@ declare const ResourceEntrySchema$1: z.ZodDiscriminatedUnion<[z.ZodObject<{
         writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
         usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
         emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        contract: z.ZodOptional<z.ZodObject<{
+            input: z.ZodOptional<z.ZodString>;
+            output: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         role: z.ZodEnum<{
-            schema: "schema";
             config: "config";
             entrypoint: "entrypoint";
             handler: "handler";
+            schema: "schema";
             test: "test";
             docs: "docs";
         }>;
@@ -697,14 +709,18 @@ declare const ResourceEntrySchema$1: z.ZodDiscriminatedUnion<[z.ZodObject<{
         writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
         usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
         emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        contract: z.ZodOptional<z.ZodObject<{
+            input: z.ZodOptional<z.ZodString>;
+            output: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         role: z.ZodEnum<{
-            schema: "schema";
             config: "config";
             entrypoint: "entrypoint";
             handler: "handler";
+            schema: "schema";
             test: "test";
             docs: "docs";
         }>;
@@ -774,14 +790,18 @@ declare const ResourceEntrySchema$1: z.ZodDiscriminatedUnion<[z.ZodObject<{
         writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
         usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
         emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        contract: z.ZodOptional<z.ZodObject<{
+            input: z.ZodOptional<z.ZodString>;
+            output: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         role: z.ZodEnum<{
-            schema: "schema";
             config: "config";
             entrypoint: "entrypoint";
             handler: "handler";
+            schema: "schema";
             test: "test";
             docs: "docs";
         }>;
@@ -809,14 +829,18 @@ declare const ResourceEntrySchema$1: z.ZodDiscriminatedUnion<[z.ZodObject<{
         writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
         usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
         emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        contract: z.ZodOptional<z.ZodObject<{
+            input: z.ZodOptional<z.ZodString>;
+            output: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         role: z.ZodEnum<{
-            schema: "schema";
             config: "config";
             entrypoint: "entrypoint";
             handler: "handler";
+            schema: "schema";
             test: "test";
             docs: "docs";
         }>;
@@ -4533,6 +4557,7 @@ declare const ProspectingBuildTemplateStepSchema: z.ZodObject<{
         crm: "crm";
         "lead-gen": "lead-gen";
         projects: "projects";
+        clients: "clients";
         operations: "operations";
         monitoring: "monitoring";
         knowledge: "knowledge";
@@ -4669,6 +4694,7 @@ declare const ProspectingBuildTemplateSchema: z.ZodObject<{
         crm: "crm";
         "lead-gen": "lead-gen";
         projects: "projects";
+        clients: "clients";
         operations: "operations";
         monitoring: "monitoring";
         knowledge: "knowledge";
@@ -4735,6 +4761,7 @@ declare const ProspectingBuildTemplateSchema: z.ZodObject<{
             crm: "crm";
             "lead-gen": "lead-gen";
             projects: "projects";
+            clients: "clients";
             operations: "operations";
             monitoring: "monitoring";
             knowledge: "knowledge";
@@ -4860,36 +4887,6 @@ type ListBuilderStep = z.infer<typeof ProspectingBuildTemplateStepSchema>;
 type RecordColumnConfig = z.infer<typeof RecordColumnConfigSchema>;
 type CredentialRequirement = z.infer<typeof CredentialRequirementSchema>;
 
-/** 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';
-    /** Additional entities allowed to write/read this processing_state key. */
-    additionalEntities?: Array<'company' | 'contact'>;
-    /**
-     * Optional read-side override for Records views when a company-scoped step
-     * produces records on a different entity.
-     */
-    recordEntity?: 'company' | 'contact';
-    /** Stage key to read from recordEntity.processing_state for Records views. */
-    recordStageKey?: string;
-}
-/**
- * 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";
@@ -4953,7 +4950,7 @@ declare const DealSchemas: {
         assigneeUserId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strict>;
     TransitionItemRequest: z.ZodObject<{
-        pipelineKey: z.ZodLiteral<string>;
+        pipelineKey: z.ZodString;
         stageKey: z.ZodEnum<{
             [x: string]: string;
         }>;
@@ -5320,9 +5317,11 @@ declare const DealSchemas: {
     }, 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.
+ * One stage entry in a list's `pipeline_config.stages[]`.
+ *
+ * Stage catalogs are model-owned. The published core schema validates the
+ * transport shape and leaves closed-catalog checks to callers with a resolved
+ * Organization Model.
  */
 declare const PipelineStageSchema: z.ZodObject<{
     key: z.ZodString;
@@ -5409,7 +5408,7 @@ type ProcessingStageStatus = z.infer<typeof ProcessingStageStatusSchema>;
 
 /** Raw database row type for acq_deals table */
 type AcqDealRow = Database['public']['Tables']['acq_deals']['Row'];
-type LeadGenStageKey = (typeof LEAD_GEN_STAGE_CATALOG)[keyof typeof LEAD_GEN_STAGE_CATALOG]['key'];
+type LeadGenStageKey = string;
 interface ProcessingStateEntry {
     status: ProcessingStageStatus;
     data?: unknown;
@@ -9698,24 +9697,6 @@ type ToolingErrorType = 'service_unavailable' | 'permission_denied' | 'platform_
  */
 type IntegrationType = 'gmail' | 'google-sheets' | 'slack' | 'github' | 'linear' | 'attio' | 'airtable' | 'salesforce' | 'hubspot' | 'stripe' | 'twilio' | 'sendgrid' | 'mailgun' | 'zapier' | 'webhook' | 'apify' | 'instantly' | 'resend' | 'signature-api' | 'dropbox' | 'anymailfinder' | 'tomba' | 'millionverifier';
 
-/**
- * Placeholder discriminated union for ContentNode (Wave 1A).
- * Wave 2A wires concrete (kind, type) pairs via the registry.
- *
- * Per D2: unregistered (kind, type) pairs are allowed and pass through validation.
- * Per L14: every node carries BOTH `kind` and `type`.
- */
-declare const ContentNodeSchema: z.ZodObject<{
-    label: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    order: z.ZodOptional<z.ZodNumber>;
-    parentContentId: z.ZodOptional<z.ZodString>;
-    kind: z.ZodString;
-    type: z.ZodString;
-    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>;
-type ContentNode = z.infer<typeof ContentNodeSchema>;
-
 type JsonPrimitive = string | number | boolean | null;
 type JsonValue = JsonPrimitive | JsonValue[] | {
     [key: string]: JsonValue;
@@ -9757,11 +9738,6 @@ interface SystemEntry {
     config?: Record<string, JsonValue>;
     ontology?: OntologyScope;
     systems?: Record<string, SystemEntry>;
-    /**
-     * @deprecated Compatibility-only bridge for old tenant data and migration readers.
-     * Author new semantic catalogs in `ontology` and local settings in `config`.
-     */
-    content?: Record<string, ContentNode>;
     subsystems?: Record<string, SystemEntry>;
 }
 
@@ -10631,14 +10607,18 @@ declare const OrganizationModelSchema: z.ZodObject<{
             writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
             usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
             emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            contract: z.ZodOptional<z.ZodObject<{
+                input: z.ZodOptional<z.ZodString>;
+                output: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
             path: z.ZodString;
             role: z.ZodEnum<{
-                schema: "schema";
                 config: "config";
                 entrypoint: "entrypoint";
                 handler: "handler";
+                schema: "schema";
                 test: "test";
                 docs: "docs";
             }>;
@@ -10677,14 +10657,18 @@ declare const OrganizationModelSchema: z.ZodObject<{
             writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
             usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
             emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            contract: z.ZodOptional<z.ZodObject<{
+                input: z.ZodOptional<z.ZodString>;
+                output: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
             path: z.ZodString;
             role: z.ZodEnum<{
-                schema: "schema";
                 config: "config";
                 entrypoint: "entrypoint";
                 handler: "handler";
+                schema: "schema";
                 test: "test";
                 docs: "docs";
             }>;
@@ -10754,14 +10738,18 @@ declare const OrganizationModelSchema: z.ZodObject<{
             writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
             usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
             emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            contract: z.ZodOptional<z.ZodObject<{
+                input: z.ZodOptional<z.ZodString>;
+                output: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
             path: z.ZodString;
             role: z.ZodEnum<{
-                schema: "schema";
                 config: "config";
                 entrypoint: "entrypoint";
                 handler: "handler";
+                schema: "schema";
                 test: "test";
                 docs: "docs";
             }>;
@@ -10789,14 +10777,18 @@ declare const OrganizationModelSchema: z.ZodObject<{
             writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
             usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
             emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            contract: z.ZodOptional<z.ZodObject<{
+                input: z.ZodOptional<z.ZodString>;
+                output: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
             path: z.ZodString;
             role: z.ZodEnum<{
-                schema: "schema";
                 config: "config";
                 entrypoint: "entrypoint";
                 handler: "handler";
+                schema: "schema";
                 test: "test";
                 docs: "docs";
             }>;
@@ -11021,6 +11013,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             crm: "crm";
             "lead-gen": "lead-gen";
             projects: "projects";
+            clients: "clients";
             operations: "operations";
             monitoring: "monitoring";
             knowledge: "knowledge";
@@ -11082,11 +11075,10 @@ declare const OrganizationModelSchema: z.ZodObject<{
                     ontology: "ontology";
                     role: "role";
                     goal: "goal";
-                    stage: "stage";
                     resource: "resource";
+                    stage: "stage";
                     "customer-segment": "customer-segment";
                     offering: "offering";
-                    "content-node": "content-node";
                 }>;
                 id: z.ZodString;
             }, z.core.$strip>;
@@ -11094,7 +11086,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             nodeId: z.ZodUnion<readonly [z.ZodString, z.ZodTemplateLiteral<`ontology:${string}`>]>;
         }, z.core.$strip>]>, z.ZodTransform<{
             target: {
-                kind: "knowledge" | "system" | "action" | "ontology" | "role" | "goal" | "stage" | "resource" | "customer-segment" | "offering" | "content-node";
+                kind: "knowledge" | "system" | "action" | "ontology" | "role" | "goal" | "resource" | "stage" | "customer-segment" | "offering";
                 id: string;
             };
             nodeId: string;
@@ -11102,7 +11094,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             nodeId: string;
         } | {
             target: {
-                kind: "knowledge" | "system" | "action" | "ontology" | "role" | "goal" | "stage" | "resource" | "customer-segment" | "offering" | "content-node";
+                kind: "knowledge" | "system" | "action" | "ontology" | "role" | "goal" | "resource" | "stage" | "customer-segment" | "offering";
                 id: string;
             };
         }>>>>;
@@ -11557,6 +11549,87 @@ interface ElevasConfig {
     };
 }
 
+declare function defineContract<TContract extends Contract>(contract: TContract): TContract;
+
+declare function defineStep<TStep extends WorkflowStep>(step: TStep): TStep;
+
+declare function defineWorkflow<TWorkflow extends WorkflowDefinition>(workflow: TWorkflow): TWorkflow;
+
+type ContractRegistry = Record<string, Record<string, unknown>>;
+type ContractRefResolutionErrorCode = 'contract-ref-unknown-module' | 'contract-ref-unknown-export' | 'contract-ref-not-zod-type';
+declare class ContractRefResolutionError extends Error {
+    readonly code: ContractRefResolutionErrorCode;
+    readonly ref: string;
+    constructor(code: ContractRefResolutionErrorCode, message: string, ref: string);
+}
+interface ResolvedContractRef<TValue extends ZodTypeAny = ZodTypeAny> {
+    ref: string;
+    moduleSpecifier: string;
+    exportName: string;
+    value: TValue;
+}
+declare function isZodType(value: unknown): value is ZodTypeAny;
+declare function resolveContractRef(ref: string, registry: ContractRegistry): ResolvedContractRef;
+
+/** Minimal logger interface compatible with ExecutionContext.logger. */
+interface WorkflowLogger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+interface ConcurrentPoolOptions<T, R> {
+    /** Items to process. */
+    items: T[];
+    /** Max concurrent tasks. */
+    concurrency: number;
+    /** Process a single item. Receives the item and its index. */
+    process: (item: T, index: number) => Promise<R>;
+    /** Called when an item succeeds. */
+    onSuccess?: (result: R, item: T, index: number) => void;
+    /** Called when an item fails. Return void to continue, throw to abort. */
+    onError?: (error: unknown, item: T, index: number) => void;
+}
+interface ConcurrentPoolResult<R> {
+    results: Array<{
+        index: number;
+        value: R;
+    } | {
+        index: number;
+        error: unknown;
+    }>;
+    succeeded: number;
+    failed: number;
+}
+/**
+ * Process items concurrently with a sliding window.
+ * Maintains `concurrency` active tasks at all times, enqueuing new ones as each completes.
+ */
+declare function concurrentPool<T, R>(opts: ConcurrentPoolOptions<T, R>): Promise<ConcurrentPoolResult<R>>;
+/** Shared output schema for diagnostic workflows. */
+declare const diagnosticOutput: z.ZodObject<{
+    success: z.ZodBoolean;
+    tool: z.ZodString;
+    method: z.ZodString;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type DiagnosticOutput = z.infer<typeof diagnosticOutput>;
+/** Shared input schema for integration diagnostics that require a credential. */
+declare const integrationInput: z.ZodObject<{
+    credential: z.ZodString;
+}, z.core.$strip>;
+/** Run a diagnostic call and capture timing plus errors. */
+declare function runDiagnostic(tool: string, method: string, fn: () => Promise<unknown>): Promise<DiagnosticOutput>;
+/**
+ * Split a full name into firstName/lastName, stripping common titles and credentials.
+ * Handles formats like "Dr. Sarah Smith", "John Smith, DVM", "Jane Doe PhD".
+ */
+declare function splitName(name: string): {
+    firstName: string;
+    lastName: string | undefined;
+};
+
 /**
  * Runtime values for SDK developers.
  *
@@ -11584,147 +11657,6 @@ declare class ToolingError extends ExecutionError {
     constructor(errorType: string, message: string, details?: unknown);
 }
 
-// ============================================================================
-// 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)
-//     - crawled       (apify-website-crawl.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 ResourceOntologyBindingSchema = z
   .object({
     actions: z.array(OntologyIdSchema).optional(),
@@ -11732,7 +11664,22 @@ declare const ResourceOntologyBindingSchema = z
     reads: z.array(OntologyIdSchema).optional(),
     writes: z.array(OntologyIdSchema).optional(),
     usesCatalogs: z.array(OntologyIdSchema).optional(),
-    emits: z.array(OntologyIdSchema).optional()
+    emits: z.array(OntologyIdSchema).optional(),
+    /**
+     * Optional typed contract binding for this resource's workflow I/O.
+     * Each ref is a `package/subpath#ExportName` string that resolves to a
+     * Zod schema in `@repo/elevasis-core` (or the consumer's equivalent package).
+     *
+     * Absence of this field preserves all existing behavior — it is additive + optional.
+     * Tier-1 validation (schema.ts): ref-string shape only (browser-safe, no imports).
+     * Tier-2 validation (om:verify): intra-package typed-map resolution asserts ZodType.
+     */
+    contract: z
+      .object({
+        input: ContractRefSchema.optional(),
+        output: ContractRefSchema.optional()
+      })
+      .optional()
   })
   .superRefine((binding, ctx) => {
     if (binding.primaryAction === undefined) return
@@ -11754,33 +11701,33 @@ type ResourceOntologyBindingInput = {
   usesCatalogs?: OntologyRefInput[]
   emits?: OntologyRefInput[]
 }
-
+
 declare const WorkflowResourceEntrySchema = ResourceEntryBaseSchema.extend({
   kind: z.literal('workflow'),
   emits: z.array(EventEmissionDescriptorSchema).optional()
-})
-
-declare const IntegrationResourceEntrySchema = ResourceEntryBaseSchema.extend({
-  kind: z.literal('integration'),
-  provider: z.string().trim().min(1).max(100)
-})
-
-declare const ResourceEntrySchema = z.discriminatedUnion('kind', [
-  WorkflowResourceEntrySchema,
-  AgentResourceEntrySchema,
-  IntegrationResourceEntrySchema,
-  ScriptResourceEntrySchema
-])
-
-declare function defineResource<const TResource extends ResourceEntry>(resource: TResource): TResource {
-  return ResourceEntrySchema.parse(resource) as TResource
-}
-
+})
+
+declare const IntegrationResourceEntrySchema = ResourceEntryBaseSchema.extend({
+  kind: z.literal('integration'),
+  provider: z.string().trim().min(1).max(100)
+})
+
+declare const ResourceEntrySchema = z.discriminatedUnion('kind', [
+  WorkflowResourceEntrySchema,
+  AgentResourceEntrySchema,
+  IntegrationResourceEntrySchema,
+  ScriptResourceEntrySchema
+])
+
+declare function defineResource<const TResource extends ResourceEntry>(resource: TResource): TResource {
+  return ResourceEntrySchema.parse(resource) as TResource
+}
+
 declare function defineResources<const TResources extends Record<string, ResourceEntry>>(
   resources: TResources
 ): TResources {
-  return Object.fromEntries(
-    Object.entries(resources).map(([key, resource]) => [key, ResourceEntrySchema.parse(resource)])
+  return Object.fromEntries(
+    Object.entries(resources).map(([key, resource]) => [key, ResourceEntrySchema.parse(resource)])
   ) as TResources
 }
 
@@ -11794,7 +11741,7 @@ declare function defineResourceOntology(input: ResourceOntologyBindingInput): Re
     emits: ontologyIdArrayFrom(input.emits)
   })
 }
-type ResourceOntologyBinding = z.infer<typeof ResourceOntologyBindingSchema>
+type ResourceOntologyBinding = z.infer<typeof ResourceOntologyBindingSchema>
 type ResourceEntry = z.infer<typeof ResourceEntrySchema>
 
 declare const OmTopologyNodeRefSchema = z.discriminatedUnion('kind', [
@@ -11961,10 +11908,8 @@ type CrmStateKey = z.infer<typeof CrmStateKeySchema>
  * via rollup-plugin-dts. External consumers never see internal workspace imports.
  */
 
-declare const ListBuilderStageKeySchema: z.ZodEnum<{
-    [x: string]: string;
-}>;
+declare const ListBuilderStageKeySchema: z.ZodString;
 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, bindResourceDescriptor, defineResource, defineResourceOntology, defineResources, defineTopology, defineTopologyRelationship, deriveActions, parseTopologyNodeRef, topologyRef, topologyRelationship, validateResourceGovernance };
-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, OrganizationModelIntegrationResourceEntry, OrganizationModelResourceEntry, OrganizationModelResourceOntologyBinding, OrganizationModelTopology, OrganizationModelTopologyNodeRef, OrganizationModelTopologyRelationship, OrganizationModelWorkflowResourceEntry, 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 };
+export { ActivityEventSchema, BuildPlanSnapshotStepSchema, ProspectingBuildTemplateSchema as BuildTemplateSchema, ContractRefResolutionError, CrmStageKeySchema, CrmStateKeySchema, DEFAULT_CRM_ACTIONS, EmailSchema, ExecutionError, ListBuilderStageKeySchema, ProcessingStageStatusSchema, RegistryValidationError, ResourceRegistry, StepType, ToolingError, bindResourceDescriptor, concurrentPool, defineContract, defineResource, defineResourceOntology, defineResources, defineStep, defineTopology, defineTopologyRelationship, defineWorkflow, deriveActions, diagnosticOutput, integrationInput, isZodType, parseTopologyNodeRef, resolveContractRef, runDiagnostic, splitName, topologyRef, topologyRelationship, validateResourceGovernance };
+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, ConcurrentPoolOptions, ConcurrentPoolResult, ConditionalNext, ContactFilters, Contract, ContractRefResolutionErrorCode, ContractRegistry, 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, DiagnosticOutput, 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, OrganizationModelIntegrationResourceEntry, OrganizationModelResourceEntry, OrganizationModelResourceOntologyBinding, OrganizationModelTopology, OrganizationModelTopologyNodeRef, OrganizationModelTopologyRelationship, OrganizationModelWorkflowResourceEntry, PaginatedResult, PaginationParams, PdfToolMap, ProcessingStageStatus, ProjectsToolMap, QueryRecordsParams, QueryRecordsResult, ReadSheetParams, ReadSheetResult, Recipient, RecurringScheduleConfig, RelationshipDeclaration, RelativeScheduleConfig, RemoveFromSubsequenceParams, RemoveFromSubsequenceResult, ResendGetEmailParams, ResendGetEmailResult, ResendSendEmailParams, ResendSendEmailResult, ResendToolMap, ResolvedContractRef, 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, WorkflowLogger, WorkflowStep, WriteSheetParams, WriteSheetResult };