@elevasis/sdk 1.20.2 → 1.22.0

package/dist/index.d.ts

@@ -503,125 +503,512 @@ interface ModelConfig {
 }
 
 declare const ResourceGovernanceStatusSchema: z.ZodEnum<{
-    active: "active";
     deprecated: "deprecated";
+    active: "active";
     archived: "archived";
 }>;
 declare const WorkflowResourceEntrySchema: z.ZodObject<{
     id: z.ZodString;
-    systemId: z.ZodString;
+    order: z.ZodDefault<z.ZodNumber>;
+    systemPath: z.ZodString;
     ownerRoleId: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
-        active: "active";
         deprecated: "deprecated";
+        active: "active";
         archived: "archived";
     }>;
+    ontology: z.ZodOptional<z.ZodObject<{
+        implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodEnum<{
+            schema: "schema";
+            config: "config";
+            entrypoint: "entrypoint";
+            handler: "handler";
+            test: "test";
+            docs: "docs";
+        }>;
+        symbol: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     kind: z.ZodLiteral<"workflow">;
-    capabilityKey: z.ZodOptional<z.ZodString>;
+    actionKey: z.ZodOptional<z.ZodString>;
+    emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        eventKey: z.ZodString;
+        label: z.ZodString;
+        payloadSchema: z.ZodOptional<z.ZodString>;
+        lifecycle: z.ZodOptional<z.ZodEnum<{
+            deprecated: "deprecated";
+            draft: "draft";
+            beta: "beta";
+            active: "active";
+            archived: "archived";
+        }>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 declare const AgentResourceEntrySchema: z.ZodObject<{
     id: z.ZodString;
-    systemId: z.ZodString;
+    order: z.ZodDefault<z.ZodNumber>;
+    systemPath: z.ZodString;
     ownerRoleId: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
-        active: "active";
         deprecated: "deprecated";
+        active: "active";
         archived: "archived";
     }>;
+    ontology: z.ZodOptional<z.ZodObject<{
+        implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodEnum<{
+            schema: "schema";
+            config: "config";
+            entrypoint: "entrypoint";
+            handler: "handler";
+            test: "test";
+            docs: "docs";
+        }>;
+        symbol: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     kind: z.ZodLiteral<"agent">;
     agentKind: z.ZodEnum<{
+        platform: "platform";
         orchestrator: "orchestrator";
         specialist: "specialist";
         utility: "utility";
-        system: "system";
     }>;
     actsAsRoleId: z.ZodOptional<z.ZodString>;
     sessionCapable: z.ZodBoolean;
+    invocations: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"slash-command">;
+        command: z.ZodString;
+        toolFactory: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"mcp-tool">;
+        server: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"api-endpoint">;
+        method: z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+        }>;
+        path: z.ZodString;
+        requestSchema: z.ZodOptional<z.ZodString>;
+        responseSchema: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"script-execution">;
+        resourceId: z.ZodString;
+    }, z.core.$strip>], "kind">>>;
+    emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        eventKey: z.ZodString;
+        label: z.ZodString;
+        payloadSchema: z.ZodOptional<z.ZodString>;
+        lifecycle: z.ZodOptional<z.ZodEnum<{
+            deprecated: "deprecated";
+            draft: "draft";
+            beta: "beta";
+            active: "active";
+            archived: "archived";
+        }>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 declare const ResourceEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     id: z.ZodString;
-    systemId: z.ZodString;
+    order: z.ZodDefault<z.ZodNumber>;
+    systemPath: z.ZodString;
     ownerRoleId: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
-        active: "active";
         deprecated: "deprecated";
+        active: "active";
         archived: "archived";
     }>;
+    ontology: z.ZodOptional<z.ZodObject<{
+        implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodEnum<{
+            schema: "schema";
+            config: "config";
+            entrypoint: "entrypoint";
+            handler: "handler";
+            test: "test";
+            docs: "docs";
+        }>;
+        symbol: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     kind: z.ZodLiteral<"workflow">;
-    capabilityKey: z.ZodOptional<z.ZodString>;
+    actionKey: z.ZodOptional<z.ZodString>;
+    emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        eventKey: z.ZodString;
+        label: z.ZodString;
+        payloadSchema: z.ZodOptional<z.ZodString>;
+        lifecycle: z.ZodOptional<z.ZodEnum<{
+            deprecated: "deprecated";
+            draft: "draft";
+            beta: "beta";
+            active: "active";
+            archived: "archived";
+        }>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
-    systemId: z.ZodString;
+    order: z.ZodDefault<z.ZodNumber>;
+    systemPath: z.ZodString;
     ownerRoleId: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
-        active: "active";
         deprecated: "deprecated";
+        active: "active";
         archived: "archived";
     }>;
+    ontology: z.ZodOptional<z.ZodObject<{
+        implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodEnum<{
+            schema: "schema";
+            config: "config";
+            entrypoint: "entrypoint";
+            handler: "handler";
+            test: "test";
+            docs: "docs";
+        }>;
+        symbol: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     kind: z.ZodLiteral<"agent">;
     agentKind: z.ZodEnum<{
+        platform: "platform";
         orchestrator: "orchestrator";
         specialist: "specialist";
         utility: "utility";
-        system: "system";
     }>;
     actsAsRoleId: z.ZodOptional<z.ZodString>;
     sessionCapable: z.ZodBoolean;
+    invocations: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"slash-command">;
+        command: z.ZodString;
+        toolFactory: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"mcp-tool">;
+        server: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"api-endpoint">;
+        method: z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+        }>;
+        path: z.ZodString;
+        requestSchema: z.ZodOptional<z.ZodString>;
+        responseSchema: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"script-execution">;
+        resourceId: z.ZodString;
+    }, z.core.$strip>], "kind">>>;
+    emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        eventKey: z.ZodString;
+        label: z.ZodString;
+        payloadSchema: z.ZodOptional<z.ZodString>;
+        lifecycle: z.ZodOptional<z.ZodEnum<{
+            deprecated: "deprecated";
+            draft: "draft";
+            beta: "beta";
+            active: "active";
+            archived: "archived";
+        }>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
-    systemId: z.ZodString;
+    order: z.ZodDefault<z.ZodNumber>;
+    systemPath: z.ZodString;
     ownerRoleId: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
-        active: "active";
         deprecated: "deprecated";
+        active: "active";
         archived: "archived";
     }>;
+    ontology: z.ZodOptional<z.ZodObject<{
+        implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodEnum<{
+            schema: "schema";
+            config: "config";
+            entrypoint: "entrypoint";
+            handler: "handler";
+            test: "test";
+            docs: "docs";
+        }>;
+        symbol: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     kind: z.ZodLiteral<"integration">;
     provider: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    order: z.ZodDefault<z.ZodNumber>;
+    systemPath: z.ZodString;
+    ownerRoleId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        deprecated: "deprecated";
+        active: "active";
+        archived: "archived";
+    }>;
+    ontology: z.ZodOptional<z.ZodObject<{
+        implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodEnum<{
+            schema: "schema";
+            config: "config";
+            entrypoint: "entrypoint";
+            handler: "handler";
+            test: "test";
+            docs: "docs";
+        }>;
+        symbol: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    kind: z.ZodLiteral<"script">;
+    language: z.ZodEnum<{
+        shell: "shell";
+        sql: "sql";
+        typescript: "typescript";
+        python: "python";
+    }>;
+    source: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        file: z.ZodString;
+    }, z.core.$strip>]>;
 }, z.core.$strip>], "kind">;
-declare const ResourcesDomainSchema: z.ZodObject<{
-    entries: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        id: z.ZodString;
-        systemId: z.ZodString;
-        ownerRoleId: z.ZodOptional<z.ZodString>;
-        status: z.ZodEnum<{
-            active: "active";
-            deprecated: "deprecated";
-            archived: "archived";
+declare const ResourcesDomainSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    order: z.ZodDefault<z.ZodNumber>;
+    systemPath: z.ZodString;
+    ownerRoleId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        deprecated: "deprecated";
+        active: "active";
+        archived: "archived";
+    }>;
+    ontology: z.ZodOptional<z.ZodObject<{
+        implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodEnum<{
+            schema: "schema";
+            config: "config";
+            entrypoint: "entrypoint";
+            handler: "handler";
+            test: "test";
+            docs: "docs";
         }>;
-        kind: z.ZodLiteral<"workflow">;
-        capabilityKey: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        id: z.ZodString;
-        systemId: z.ZodString;
-        ownerRoleId: z.ZodOptional<z.ZodString>;
-        status: z.ZodEnum<{
-            active: "active";
+        symbol: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    kind: z.ZodLiteral<"workflow">;
+    actionKey: z.ZodOptional<z.ZodString>;
+    emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        eventKey: z.ZodString;
+        label: z.ZodString;
+        payloadSchema: z.ZodOptional<z.ZodString>;
+        lifecycle: z.ZodOptional<z.ZodEnum<{
             deprecated: "deprecated";
+            draft: "draft";
+            beta: "beta";
+            active: "active";
             archived: "archived";
+        }>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    order: z.ZodDefault<z.ZodNumber>;
+    systemPath: z.ZodString;
+    ownerRoleId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        deprecated: "deprecated";
+        active: "active";
+        archived: "archived";
+    }>;
+    ontology: z.ZodOptional<z.ZodObject<{
+        implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodEnum<{
+            schema: "schema";
+            config: "config";
+            entrypoint: "entrypoint";
+            handler: "handler";
+            test: "test";
+            docs: "docs";
         }>;
-        kind: z.ZodLiteral<"agent">;
-        agentKind: z.ZodEnum<{
-            orchestrator: "orchestrator";
-            specialist: "specialist";
-            utility: "utility";
-            system: "system";
+        symbol: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    kind: z.ZodLiteral<"agent">;
+    agentKind: z.ZodEnum<{
+        platform: "platform";
+        orchestrator: "orchestrator";
+        specialist: "specialist";
+        utility: "utility";
+    }>;
+    actsAsRoleId: z.ZodOptional<z.ZodString>;
+    sessionCapable: z.ZodBoolean;
+    invocations: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"slash-command">;
+        command: z.ZodString;
+        toolFactory: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"mcp-tool">;
+        server: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"api-endpoint">;
+        method: z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
         }>;
-        actsAsRoleId: z.ZodOptional<z.ZodString>;
-        sessionCapable: z.ZodBoolean;
+        path: z.ZodString;
+        requestSchema: z.ZodOptional<z.ZodString>;
+        responseSchema: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
-        id: z.ZodString;
-        systemId: z.ZodString;
-        ownerRoleId: z.ZodOptional<z.ZodString>;
-        status: z.ZodEnum<{
-            active: "active";
+        kind: z.ZodLiteral<"script-execution">;
+        resourceId: z.ZodString;
+    }, z.core.$strip>], "kind">>>;
+    emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        eventKey: z.ZodString;
+        label: z.ZodString;
+        payloadSchema: z.ZodOptional<z.ZodString>;
+        lifecycle: z.ZodOptional<z.ZodEnum<{
             deprecated: "deprecated";
+            draft: "draft";
+            beta: "beta";
+            active: "active";
             archived: "archived";
+        }>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    order: z.ZodDefault<z.ZodNumber>;
+    systemPath: z.ZodString;
+    ownerRoleId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        deprecated: "deprecated";
+        active: "active";
+        archived: "archived";
+    }>;
+    ontology: z.ZodOptional<z.ZodObject<{
+        implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodEnum<{
+            schema: "schema";
+            config: "config";
+            entrypoint: "entrypoint";
+            handler: "handler";
+            test: "test";
+            docs: "docs";
         }>;
-        kind: z.ZodLiteral<"integration">;
-        provider: z.ZodString;
-    }, z.core.$strip>], "kind">>>;
-}, z.core.$strip>;
+        symbol: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    kind: z.ZodLiteral<"integration">;
+    provider: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    order: z.ZodDefault<z.ZodNumber>;
+    systemPath: z.ZodString;
+    ownerRoleId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        deprecated: "deprecated";
+        active: "active";
+        archived: "archived";
+    }>;
+    ontology: z.ZodOptional<z.ZodObject<{
+        implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        emits: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    codeRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodEnum<{
+            schema: "schema";
+            config: "config";
+            entrypoint: "entrypoint";
+            handler: "handler";
+            test: "test";
+            docs: "docs";
+        }>;
+        symbol: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    kind: z.ZodLiteral<"script">;
+    language: z.ZodEnum<{
+        shell: "shell";
+        sql: "sql";
+        typescript: "typescript";
+        python: "python";
+    }>;
+    source: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        file: z.ZodString;
+    }, z.core.$strip>]>;
+}, z.core.$strip>], "kind">>>;
 type ResourceGovernanceStatus = z.infer<typeof ResourceGovernanceStatusSchema>;
 type WorkflowResourceEntry = z.infer<typeof WorkflowResourceEntrySchema>;
 type AgentResourceEntry = z.infer<typeof AgentResourceEntrySchema>;
@@ -736,8 +1123,8 @@ interface WorkflowConfig extends ResourceDefinition {
     type: 'workflow';
     /** OM descriptor backing canonical identity and governance metadata. */
     resource?: WorkflowResourceEntry;
-    /** Lead-gen capability key for registry derivation (e.g. 'lead-gen.company.apollo-import') */
-    capabilityKey?: string;
+    /** Lead-gen action key for registry derivation (e.g. 'lead-gen.company.apollo-import') */
+    actionKey?: string;
 }
 interface WorkflowStepDefinition {
     id: string;
@@ -1088,7 +1475,7 @@ interface KnowledgeContent {
  * AIUsageCollector/AICallContext) and the worker proxy (which ignores them) satisfy the type.
  */
 type LLMAdapterFactory = (config: ModelConfig, ...args: any[]) => LLMAdapter;
-type AgentKind = 'orchestrator' | 'specialist' | 'utility' | 'system';
+type AgentKind = 'orchestrator' | 'specialist' | 'utility' | 'platform';
 interface AgentConfig extends ResourceDefinition {
     type: 'agent';
     /** OM descriptor backing canonical identity and governance metadata. */
@@ -3955,6 +4342,66 @@ type Database = {
                     }
                 ];
             };
+            user_notes: {
+                Row: {
+                    content: string;
+                    created_at: string;
+                    created_by: string;
+                    id: string;
+                    metadata: Json;
+                    organization_id: string | null;
+                    pinned: boolean;
+                    priority: string;
+                    source: string | null;
+                    title: string | null;
+                    updated_at: string;
+                    user_id: string;
+                };
+                Insert: {
+                    content: string;
+                    created_at?: string;
+                    created_by?: string;
+                    id?: string;
+                    metadata?: Json;
+                    organization_id?: string | null;
+                    pinned?: boolean;
+                    priority?: string;
+                    source?: string | null;
+                    title?: string | null;
+                    updated_at?: string;
+                    user_id: string;
+                };
+                Update: {
+                    content?: string;
+                    created_at?: string;
+                    created_by?: string;
+                    id?: string;
+                    metadata?: Json;
+                    organization_id?: string | null;
+                    pinned?: boolean;
+                    priority?: string;
+                    source?: string | null;
+                    title?: string | null;
+                    updated_at?: string;
+                    user_id?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "user_notes_organization_id_fkey";
+                        columns: ["organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "organizations";
+                        referencedColumns: ["id"];
+                    },
+                    {
+                        foreignKeyName: "user_notes_user_id_fkey";
+                        columns: ["user_id"];
+                        isOneToOne: false;
+                        referencedRelation: "users";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
             users: {
                 Row: {
                     config: Json;
@@ -4219,10 +4666,10 @@ declare const RecordColumnConfigSchema: z.ZodObject<{
     width: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
     renderType: z.ZodOptional<z.ZodEnum<{
         text: "text";
-        badge: "badge";
-        datetime: "datetime";
         count: "count";
         json: "json";
+        badge: "badge";
+        datetime: "datetime";
     }>>;
     badgeColor: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -4249,71 +4696,65 @@ declare const ProspectingBuildTemplateStepSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     color: z.ZodOptional<z.ZodString>;
     icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-        "nav.dashboard": "nav.dashboard";
-        "nav.calendar": "nav.calendar";
-        "nav.sales": "nav.sales";
-        "nav.crm": "nav.crm";
-        "nav.lead-gen": "nav.lead-gen";
-        "nav.projects": "nav.projects";
-        "nav.operations": "nav.operations";
-        "nav.monitoring": "nav.monitoring";
-        "nav.knowledge": "nav.knowledge";
-        "nav.settings": "nav.settings";
-        "nav.admin": "nav.admin";
-        "nav.archive": "nav.archive";
-        "knowledge.playbook": "knowledge.playbook";
-        "knowledge.strategy": "knowledge.strategy";
-        "knowledge.reference": "knowledge.reference";
-        "feature.dashboard": "feature.dashboard";
-        "feature.calendar": "feature.calendar";
-        "feature.business": "feature.business";
-        "feature.sales": "feature.sales";
-        "feature.crm": "feature.crm";
-        "feature.finance": "feature.finance";
-        "feature.lead-gen": "feature.lead-gen";
-        "feature.platform": "feature.platform";
-        "feature.projects": "feature.projects";
-        "feature.operations": "feature.operations";
-        "feature.knowledge": "feature.knowledge";
-        "feature.monitoring": "feature.monitoring";
-        "feature.settings": "feature.settings";
-        "feature.admin": "feature.admin";
-        "feature.archive": "feature.archive";
-        "feature.seo": "feature.seo";
-        "resource.agent": "resource.agent";
-        "resource.workflow": "resource.workflow";
-        "resource.integration": "resource.integration";
-        "resource.database": "resource.database";
-        "resource.user": "resource.user";
-        "resource.team": "resource.team";
-        "integration.gmail": "integration.gmail";
-        "integration.google-sheets": "integration.google-sheets";
-        "integration.attio": "integration.attio";
-        "surface.dashboard": "surface.dashboard";
-        "surface.calendar": "surface.calendar";
-        "surface.overview": "surface.overview";
-        "surface.command-view": "surface.command-view";
-        "surface.command-queue": "surface.command-queue";
-        "surface.pipeline": "surface.pipeline";
-        "surface.lists": "surface.lists";
-        "surface.resources": "surface.resources";
-        "surface.settings": "surface.settings";
-        "status.success": "status.success";
-        "status.error": "status.error";
-        "status.warning": "status.warning";
-        "status.info": "status.info";
-        "status.pending": "status.pending";
-        "action.approve": "action.approve";
-        "action.reject": "action.reject";
-        "action.retry": "action.retry";
-        "action.edit": "action.edit";
-        "action.view": "action.view";
-        "action.launch": "action.launch";
-        "action.message": "action.message";
-        "action.escalate": "action.escalate";
-        "action.promote": "action.promote";
-        "action.submit": "action.submit";
-        "action.email": "action.email";
+        message: "message";
+        error: "error";
+        agent: "agent";
+        workflow: "workflow";
+        "google-sheets": "google-sheets";
+        dashboard: "dashboard";
+        calendar: "calendar";
+        sales: "sales";
+        crm: "crm";
+        "lead-gen": "lead-gen";
+        projects: "projects";
+        operations: "operations";
+        monitoring: "monitoring";
+        knowledge: "knowledge";
+        settings: "settings";
+        admin: "admin";
+        archive: "archive";
+        business: "business";
+        finance: "finance";
+        platform: "platform";
+        seo: "seo";
+        playbook: "playbook";
+        strategy: "strategy";
+        reference: "reference";
+        integration: "integration";
+        database: "database";
+        user: "user";
+        team: "team";
+        gmail: "gmail";
+        attio: "attio";
+        overview: "overview";
+        "command-view": "command-view";
+        "command-queue": "command-queue";
+        pipeline: "pipeline";
+        lists: "lists";
+        resources: "resources";
+        approve: "approve";
+        reject: "reject";
+        retry: "retry";
+        edit: "edit";
+        view: "view";
+        launch: "launch";
+        escalate: "escalate";
+        promote: "promote";
+        submit: "submit";
+        email: "email";
+        success: "success";
+        warning: "warning";
+        info: "info";
+        pending: "pending";
+        bolt: "bolt";
+        building: "building";
+        briefcase: "briefcase";
+        apps: "apps";
+        graph: "graph";
+        shield: "shield";
+        users: "users";
+        "chart-bar": "chart-bar";
+        search: "search";
     }>, z.ZodString]>>;
     id: z.ZodString;
     primaryEntity: z.ZodEnum<{
@@ -4334,7 +4775,7 @@ declare const ProspectingBuildTemplateStepSchema: z.ZodObject<{
     recordSourceStageKey: z.ZodOptional<z.ZodString>;
     dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
     dependencyMode: z.ZodLiteral<"per-record-eligibility">;
-    capabilityKey: z.ZodString;
+    actionKey: z.ZodString;
     defaultBatchSize: z.ZodNumber;
     maxBatchSize: z.ZodNumber;
     recordColumns: z.ZodOptional<z.ZodObject<{
@@ -4345,10 +4786,10 @@ declare const ProspectingBuildTemplateStepSchema: z.ZodObject<{
             width: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
             renderType: z.ZodOptional<z.ZodEnum<{
                 text: "text";
-                badge: "badge";
-                datetime: "datetime";
                 count: "count";
                 json: "json";
+                badge: "badge";
+                datetime: "datetime";
             }>>;
             badgeColor: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
@@ -4359,10 +4800,10 @@ declare const ProspectingBuildTemplateStepSchema: z.ZodObject<{
             width: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
             renderType: z.ZodOptional<z.ZodEnum<{
                 text: "text";
-                badge: "badge";
-                datetime: "datetime";
                 count: "count";
                 json: "json";
+                badge: "badge";
+                datetime: "datetime";
             }>>;
             badgeColor: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
@@ -4391,71 +4832,65 @@ declare const ProspectingBuildTemplateSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     color: z.ZodOptional<z.ZodString>;
     icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-        "nav.dashboard": "nav.dashboard";
-        "nav.calendar": "nav.calendar";
-        "nav.sales": "nav.sales";
-        "nav.crm": "nav.crm";
-        "nav.lead-gen": "nav.lead-gen";
-        "nav.projects": "nav.projects";
-        "nav.operations": "nav.operations";
-        "nav.monitoring": "nav.monitoring";
-        "nav.knowledge": "nav.knowledge";
-        "nav.settings": "nav.settings";
-        "nav.admin": "nav.admin";
-        "nav.archive": "nav.archive";
-        "knowledge.playbook": "knowledge.playbook";
-        "knowledge.strategy": "knowledge.strategy";
-        "knowledge.reference": "knowledge.reference";
-        "feature.dashboard": "feature.dashboard";
-        "feature.calendar": "feature.calendar";
-        "feature.business": "feature.business";
-        "feature.sales": "feature.sales";
-        "feature.crm": "feature.crm";
-        "feature.finance": "feature.finance";
-        "feature.lead-gen": "feature.lead-gen";
-        "feature.platform": "feature.platform";
-        "feature.projects": "feature.projects";
-        "feature.operations": "feature.operations";
-        "feature.knowledge": "feature.knowledge";
-        "feature.monitoring": "feature.monitoring";
-        "feature.settings": "feature.settings";
-        "feature.admin": "feature.admin";
-        "feature.archive": "feature.archive";
-        "feature.seo": "feature.seo";
-        "resource.agent": "resource.agent";
-        "resource.workflow": "resource.workflow";
-        "resource.integration": "resource.integration";
-        "resource.database": "resource.database";
-        "resource.user": "resource.user";
-        "resource.team": "resource.team";
-        "integration.gmail": "integration.gmail";
-        "integration.google-sheets": "integration.google-sheets";
-        "integration.attio": "integration.attio";
-        "surface.dashboard": "surface.dashboard";
-        "surface.calendar": "surface.calendar";
-        "surface.overview": "surface.overview";
-        "surface.command-view": "surface.command-view";
-        "surface.command-queue": "surface.command-queue";
-        "surface.pipeline": "surface.pipeline";
-        "surface.lists": "surface.lists";
-        "surface.resources": "surface.resources";
-        "surface.settings": "surface.settings";
-        "status.success": "status.success";
-        "status.error": "status.error";
-        "status.warning": "status.warning";
-        "status.info": "status.info";
-        "status.pending": "status.pending";
-        "action.approve": "action.approve";
-        "action.reject": "action.reject";
-        "action.retry": "action.retry";
-        "action.edit": "action.edit";
-        "action.view": "action.view";
-        "action.launch": "action.launch";
-        "action.message": "action.message";
-        "action.escalate": "action.escalate";
-        "action.promote": "action.promote";
-        "action.submit": "action.submit";
-        "action.email": "action.email";
+        message: "message";
+        error: "error";
+        agent: "agent";
+        workflow: "workflow";
+        "google-sheets": "google-sheets";
+        dashboard: "dashboard";
+        calendar: "calendar";
+        sales: "sales";
+        crm: "crm";
+        "lead-gen": "lead-gen";
+        projects: "projects";
+        operations: "operations";
+        monitoring: "monitoring";
+        knowledge: "knowledge";
+        settings: "settings";
+        admin: "admin";
+        archive: "archive";
+        business: "business";
+        finance: "finance";
+        platform: "platform";
+        seo: "seo";
+        playbook: "playbook";
+        strategy: "strategy";
+        reference: "reference";
+        integration: "integration";
+        database: "database";
+        user: "user";
+        team: "team";
+        gmail: "gmail";
+        attio: "attio";
+        overview: "overview";
+        "command-view": "command-view";
+        "command-queue": "command-queue";
+        pipeline: "pipeline";
+        lists: "lists";
+        resources: "resources";
+        approve: "approve";
+        reject: "reject";
+        retry: "retry";
+        edit: "edit";
+        view: "view";
+        launch: "launch";
+        escalate: "escalate";
+        promote: "promote";
+        submit: "submit";
+        email: "email";
+        success: "success";
+        warning: "warning";
+        info: "info";
+        pending: "pending";
+        bolt: "bolt";
+        building: "building";
+        briefcase: "briefcase";
+        apps: "apps";
+        graph: "graph";
+        shield: "shield";
+        users: "users";
+        "chart-bar": "chart-bar";
+        search: "search";
     }>, z.ZodString]>>;
     id: z.ZodString;
     steps: z.ZodArray<z.ZodObject<{
@@ -4463,71 +4898,65 @@ declare const ProspectingBuildTemplateSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         color: z.ZodOptional<z.ZodString>;
         icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-            "nav.dashboard": "nav.dashboard";
-            "nav.calendar": "nav.calendar";
-            "nav.sales": "nav.sales";
-            "nav.crm": "nav.crm";
-            "nav.lead-gen": "nav.lead-gen";
-            "nav.projects": "nav.projects";
-            "nav.operations": "nav.operations";
-            "nav.monitoring": "nav.monitoring";
-            "nav.knowledge": "nav.knowledge";
-            "nav.settings": "nav.settings";
-            "nav.admin": "nav.admin";
-            "nav.archive": "nav.archive";
-            "knowledge.playbook": "knowledge.playbook";
-            "knowledge.strategy": "knowledge.strategy";
-            "knowledge.reference": "knowledge.reference";
-            "feature.dashboard": "feature.dashboard";
-            "feature.calendar": "feature.calendar";
-            "feature.business": "feature.business";
-            "feature.sales": "feature.sales";
-            "feature.crm": "feature.crm";
-            "feature.finance": "feature.finance";
-            "feature.lead-gen": "feature.lead-gen";
-            "feature.platform": "feature.platform";
-            "feature.projects": "feature.projects";
-            "feature.operations": "feature.operations";
-            "feature.knowledge": "feature.knowledge";
-            "feature.monitoring": "feature.monitoring";
-            "feature.settings": "feature.settings";
-            "feature.admin": "feature.admin";
-            "feature.archive": "feature.archive";
-            "feature.seo": "feature.seo";
-            "resource.agent": "resource.agent";
-            "resource.workflow": "resource.workflow";
-            "resource.integration": "resource.integration";
-            "resource.database": "resource.database";
-            "resource.user": "resource.user";
-            "resource.team": "resource.team";
-            "integration.gmail": "integration.gmail";
-            "integration.google-sheets": "integration.google-sheets";
-            "integration.attio": "integration.attio";
-            "surface.dashboard": "surface.dashboard";
-            "surface.calendar": "surface.calendar";
-            "surface.overview": "surface.overview";
-            "surface.command-view": "surface.command-view";
-            "surface.command-queue": "surface.command-queue";
-            "surface.pipeline": "surface.pipeline";
-            "surface.lists": "surface.lists";
-            "surface.resources": "surface.resources";
-            "surface.settings": "surface.settings";
-            "status.success": "status.success";
-            "status.error": "status.error";
-            "status.warning": "status.warning";
-            "status.info": "status.info";
-            "status.pending": "status.pending";
-            "action.approve": "action.approve";
-            "action.reject": "action.reject";
-            "action.retry": "action.retry";
-            "action.edit": "action.edit";
-            "action.view": "action.view";
-            "action.launch": "action.launch";
-            "action.message": "action.message";
-            "action.escalate": "action.escalate";
-            "action.promote": "action.promote";
-            "action.submit": "action.submit";
-            "action.email": "action.email";
+            message: "message";
+            error: "error";
+            agent: "agent";
+            workflow: "workflow";
+            "google-sheets": "google-sheets";
+            dashboard: "dashboard";
+            calendar: "calendar";
+            sales: "sales";
+            crm: "crm";
+            "lead-gen": "lead-gen";
+            projects: "projects";
+            operations: "operations";
+            monitoring: "monitoring";
+            knowledge: "knowledge";
+            settings: "settings";
+            admin: "admin";
+            archive: "archive";
+            business: "business";
+            finance: "finance";
+            platform: "platform";
+            seo: "seo";
+            playbook: "playbook";
+            strategy: "strategy";
+            reference: "reference";
+            integration: "integration";
+            database: "database";
+            user: "user";
+            team: "team";
+            gmail: "gmail";
+            attio: "attio";
+            overview: "overview";
+            "command-view": "command-view";
+            "command-queue": "command-queue";
+            pipeline: "pipeline";
+            lists: "lists";
+            resources: "resources";
+            approve: "approve";
+            reject: "reject";
+            retry: "retry";
+            edit: "edit";
+            view: "view";
+            launch: "launch";
+            escalate: "escalate";
+            promote: "promote";
+            submit: "submit";
+            email: "email";
+            success: "success";
+            warning: "warning";
+            info: "info";
+            pending: "pending";
+            bolt: "bolt";
+            building: "building";
+            briefcase: "briefcase";
+            apps: "apps";
+            graph: "graph";
+            shield: "shield";
+            users: "users";
+            "chart-bar": "chart-bar";
+            search: "search";
         }>, z.ZodString]>>;
         id: z.ZodString;
         primaryEntity: z.ZodEnum<{
@@ -4548,7 +4977,7 @@ declare const ProspectingBuildTemplateSchema: z.ZodObject<{
         recordSourceStageKey: z.ZodOptional<z.ZodString>;
         dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
         dependencyMode: z.ZodLiteral<"per-record-eligibility">;
-        capabilityKey: z.ZodString;
+        actionKey: z.ZodString;
         defaultBatchSize: z.ZodNumber;
         maxBatchSize: z.ZodNumber;
         recordColumns: z.ZodOptional<z.ZodObject<{
@@ -4559,10 +4988,10 @@ declare const ProspectingBuildTemplateSchema: z.ZodObject<{
                 width: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
                 renderType: z.ZodOptional<z.ZodEnum<{
                     text: "text";
-                    badge: "badge";
-                    datetime: "datetime";
                     count: "count";
                     json: "json";
+                    badge: "badge";
+                    datetime: "datetime";
                 }>>;
                 badgeColor: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>>;
@@ -4573,10 +5002,10 @@ declare const ProspectingBuildTemplateSchema: z.ZodObject<{
                 width: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
                 renderType: z.ZodOptional<z.ZodEnum<{
                     text: "text";
-                    badge: "badge";
-                    datetime: "datetime";
                     count: "count";
                     json: "json";
+                    badge: "badge";
+                    datetime: "datetime";
                 }>>;
                 badgeColor: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>>;
@@ -4631,7 +5060,7 @@ interface LeadGenStageCatalogEntry {
  * 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).
+ * Ordered roughly by pipeline progression (prospecting -> outreach -> qualification).
  */
 declare const LEAD_GEN_STAGE_CATALOG: Record<string, LeadGenStageCatalogEntry>;
 
@@ -4675,10 +5104,10 @@ declare const DealSchemas: {
     }, z.core.$strict>;
     ListDealTasksDueQuery: z.ZodObject<{
         window: z.ZodOptional<z.ZodEnum<{
-            upcoming: "upcoming";
             overdue: "overdue";
             today: "today";
             today_and_overdue: "today_and_overdue";
+            upcoming: "upcoming";
         }>>;
         assigneeUserId: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
@@ -5097,7 +5526,7 @@ declare const BuildPlanSnapshotStepSchema: z.ZodObject<{
     recordSourceStageKey: z.ZodOptional<z.ZodString>;
     dependsOn: z.ZodOptional<z.ZodArray<z.ZodString>>;
     dependencyMode: z.ZodLiteral<"per-record-eligibility">;
-    capabilityKey: z.ZodString;
+    actionKey: z.ZodString;
     defaultBatchSize: z.ZodNumber;
     maxBatchSize: z.ZodNumber;
     recordColumns: z.ZodOptional<z.ZodObject<{
@@ -5108,10 +5537,10 @@ declare const BuildPlanSnapshotStepSchema: z.ZodObject<{
             width: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
             renderType: z.ZodOptional<z.ZodEnum<{
                 text: "text";
-                badge: "badge";
-                datetime: "datetime";
                 count: "count";
                 json: "json";
+                badge: "badge";
+                datetime: "datetime";
             }>>;
             badgeColor: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
@@ -5122,10 +5551,10 @@ declare const BuildPlanSnapshotStepSchema: z.ZodObject<{
             width: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
             renderType: z.ZodOptional<z.ZodEnum<{
                 text: "text";
-                badge: "badge";
-                datetime: "datetime";
                 count: "count";
                 json: "json";
+                badge: "badge";
+                datetime: "datetime";
             }>>;
             badgeColor: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
@@ -5272,7 +5701,7 @@ interface BuildPlanSnapshotStep {
     recordSourceStageKey?: string;
     dependsOn?: string[];
     dependencyMode: BuildPlanSnapshotDependencyMode;
-    capabilityKey: string;
+    actionKey: string;
     defaultBatchSize: number;
     maxBatchSize: number;
     recordColumns?: Partial<Record<BuildPlanSnapshotPrimaryEntity, RecordColumnConfig[]>>;
@@ -6090,6 +6519,100 @@ type DealActionInput = AcqDealRow & {
 declare const DEFAULT_CRM_ACTIONS: ActionDef[];
 declare function deriveActions(deal: DealActionInput, actions?: ActionDef[]): Action[];
 
+declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
+    objectTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        storage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>>;
+    linkTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        from: z.ZodString;
+        to: z.ZodString;
+        cardinality: z.ZodOptional<z.ZodString>;
+        via: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+    actionTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        actsOn: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        effects: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$loose>>>>;
+    catalogTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        kind: z.ZodOptional<z.ZodString>;
+        appliesTo: z.ZodOptional<z.ZodString>;
+        entries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>>;
+    eventTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>>;
+    interfaceTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>>;
+    valueTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        primitive: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+    sharedProperties: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        valueType: z.ZodOptional<z.ZodString>;
+        searchable: z.ZodOptional<z.ZodBoolean>;
+        pii: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>>>;
+    groups: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        members: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    }, z.core.$loose>>>>;
+    surfaces: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ownerSystemId: z.ZodOptional<z.ZodString>;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        route: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>>;
+}, z.core.$strip>>;
+type OntologyScope = z.infer<typeof OntologyScopeSchema>;
+
 /**
  * A single CRM activity entry (note, stage change, or deal creation).
  * Matches the CrmActivityEntry interface from useRecentCrmActivity.ts.
@@ -7802,11 +8325,11 @@ declare const ProjectSchemas: {
         }>;
         status: z.ZodOptional<z.ZodEnum<{
             active: "active";
+            completed: "completed";
+            paused: "paused";
             on_track: "on_track";
             at_risk: "at_risk";
             blocked: "blocked";
-            paused: "paused";
-            completed: "completed";
         }>>;
         description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         deal_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -7827,11 +8350,11 @@ declare const ProjectSchemas: {
         }>>;
         status: z.ZodOptional<z.ZodEnum<{
             active: "active";
+            completed: "completed";
+            paused: "paused";
             on_track: "on_track";
             at_risk: "at_risk";
             blocked: "blocked";
-            paused: "paused";
-            completed: "completed";
         }>>;
         description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         deal_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -7852,11 +8375,11 @@ declare const ProjectSchemas: {
         }>>;
         status: z.ZodOptional<z.ZodEnum<{
             active: "active";
+            completed: "completed";
+            paused: "paused";
             on_track: "on_track";
             at_risk: "at_risk";
             blocked: "blocked";
-            paused: "paused";
-            completed: "completed";
         }>>;
         search: z.ZodOptional<z.ZodString>;
         client_id: z.ZodOptional<z.ZodString>;
@@ -7881,11 +8404,11 @@ declare const ProjectSchemas: {
     CreateMilestoneRequest: z.ZodObject<{
         name: z.ZodString;
         status: z.ZodOptional<z.ZodEnum<{
-            blocked: "blocked";
             completed: "completed";
+            overdue: "overdue";
             upcoming: "upcoming";
+            blocked: "blocked";
             in_progress: "in_progress";
-            overdue: "overdue";
         }>>;
         description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         due_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -7895,11 +8418,11 @@ declare const ProjectSchemas: {
     UpdateMilestoneRequest: z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         status: z.ZodOptional<z.ZodEnum<{
-            blocked: "blocked";
             completed: "completed";
+            overdue: "overdue";
             upcoming: "upcoming";
+            blocked: "blocked";
             in_progress: "in_progress";
-            overdue: "overdue";
         }>>;
         description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         due_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -7923,25 +8446,25 @@ declare const ProjectSchemas: {
         name: z.ZodString;
         type: z.ZodOptional<z.ZodEnum<{
             code: "code";
-            feature: "feature";
             other: "other";
             research: "research";
             documentation: "documentation";
             report: "report";
             design: "design";
             refactor: "refactor";
+            feature: "feature";
             bug: "bug";
         }>>;
         status: z.ZodOptional<z.ZodEnum<{
-            blocked: "blocked";
             completed: "completed";
+            cancelled: "cancelled";
+            blocked: "blocked";
             in_progress: "in_progress";
             planned: "planned";
             submitted: "submitted";
             approved: "approved";
-            revision_requested: "revision_requested";
             rejected: "rejected";
-            cancelled: "cancelled";
+            revision_requested: "revision_requested";
         }>>;
         description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         milestone_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -7959,25 +8482,25 @@ declare const ProjectSchemas: {
         name: z.ZodOptional<z.ZodString>;
         type: z.ZodOptional<z.ZodEnum<{
             code: "code";
-            feature: "feature";
             other: "other";
             research: "research";
             documentation: "documentation";
             report: "report";
             design: "design";
             refactor: "refactor";
+            feature: "feature";
             bug: "bug";
         }>>;
         status: z.ZodOptional<z.ZodEnum<{
-            blocked: "blocked";
             completed: "completed";
+            cancelled: "cancelled";
+            blocked: "blocked";
             in_progress: "in_progress";
             planned: "planned";
             submitted: "submitted";
             approved: "approved";
-            revision_requested: "revision_requested";
             rejected: "rejected";
-            cancelled: "cancelled";
+            revision_requested: "revision_requested";
         }>>;
         description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         milestone_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -7996,15 +8519,15 @@ declare const ProjectSchemas: {
     MergeResumeContextRequest: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     GetTasksQuery: z.ZodObject<{
         status: z.ZodOptional<z.ZodEnum<{
-            blocked: "blocked";
             completed: "completed";
+            cancelled: "cancelled";
+            blocked: "blocked";
             in_progress: "in_progress";
             planned: "planned";
             submitted: "submitted";
             approved: "approved";
-            revision_requested: "revision_requested";
             rejected: "rejected";
-            cancelled: "cancelled";
+            revision_requested: "revision_requested";
         }>>;
         milestone_id: z.ZodOptional<z.ZodString>;
         parent_task_id: z.ZodOptional<z.ZodString>;
@@ -9349,47 +9872,73 @@ 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';
 
-declare const SystemEntrySchema: z.ZodObject<{
-    id: z.ZodString;
-    title: z.ZodString;
-    description: z.ZodString;
-    kind: z.ZodEnum<{
-        platform: "platform";
-        product: "product";
-        operational: "operational";
-        diagnostic: "diagnostic";
-    }>;
-    responsibleRoleId: z.ZodOptional<z.ZodString>;
-    governedByKnowledge: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    drivesGoals: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    status: z.ZodEnum<{
-        active: "active";
-        deprecated: "deprecated";
-        archived: "archived";
-    }>;
-}, z.core.$strip>;
-declare const SystemsDomainSchema: z.ZodObject<{
-    systems: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        title: z.ZodString;
-        description: z.ZodString;
-        kind: z.ZodEnum<{
-            platform: "platform";
-            product: "product";
-            operational: "operational";
-            diagnostic: "diagnostic";
-        }>;
-        responsibleRoleId: z.ZodOptional<z.ZodString>;
-        governedByKnowledge: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        drivesGoals: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        status: z.ZodEnum<{
-            active: "active";
-            deprecated: "deprecated";
-            archived: "archived";
-        }>;
-    }, z.core.$strip>>>;
+/**
+ * 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 SystemEntry = z.infer<typeof SystemEntrySchema>;
+type ContentNode = z.infer<typeof ContentNodeSchema>;
+
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** Explicit interface needed to annotate the recursive SystemEntrySchema. */
+interface SystemEntry {
+    id: string;
+    label?: string;
+    title?: string;
+    description?: string;
+    kind?: 'product' | 'operational' | 'platform' | 'diagnostic';
+    parentSystemId?: string;
+    ui?: {
+        path: string;
+        surfaces: string[];
+        icon?: string;
+        order?: number;
+    };
+    lifecycle?: 'draft' | 'beta' | 'active' | 'deprecated' | 'archived';
+    responsibleRoleId?: string;
+    governedByKnowledge?: string[];
+    actions?: {
+        actionId: string;
+        intent: 'exposes' | 'consumes';
+        invocation?: unknown;
+    }[];
+    policies?: string[];
+    drivesGoals?: string[];
+    /** @deprecated Use lifecycle. Accepted for one publish cycle. */
+    status?: 'active' | 'deprecated' | 'archived';
+    path?: string;
+    icon?: string;
+    color?: string;
+    uiPosition?: 'sidebar-primary' | 'sidebar-bottom';
+    enabled?: boolean;
+    devOnly?: boolean;
+    requiresAdmin?: boolean;
+    order: number;
+    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>;
+}
+declare const SystemsDomainSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<SystemEntry, unknown, z.core.$ZodTypeInternals<SystemEntry, unknown>>>>;
 
 /**
  * Resource Registry type definitions
@@ -9404,7 +9953,7 @@ type ResourceStatus$1 = 'dev' | 'prod';
  * Used as the discriminator field in ResourceDefinition
  */
 type ResourceType = 'agent' | 'workflow' | 'trigger' | 'integration' | 'external' | 'human';
-type ResourceSystemSummary = Pick<SystemEntry, 'id' | 'title' | 'description' | 'kind' | 'status'>;
+type ResourceSystemSummary = Pick<SystemEntry, 'id' | 'title' | 'description' | 'kind' | 'lifecycle'>;
 /**
  * Base interface for ALL platform resources
  * Shared by both executable (agents, workflows) and non-executable (triggers, integrations, etc.) resources
@@ -9430,8 +9979,8 @@ interface ResourceDefinition {
     sessionCapable?: boolean;
     /** Whether the resource is local (monorepo) or remote (externally deployed) */
     origin?: 'local' | 'remote';
-    /** OM System membership, when backed by a Resource descriptor */
-    systemId?: string;
+    /** OM System membership — dot-separated system path (e.g. "sys.lead-gen"), when backed by a Resource descriptor */
+    systemPath?: string;
     /** Display metadata for the owning OM System */
     system?: ResourceSystemSummary;
     /** Governance lifecycle status from the OM Resource descriptor */
@@ -9774,13 +10323,22 @@ type OrganizationModelResources = z.infer<typeof ResourcesDomainSchema>;
 declare const LinkSchema: z.ZodObject<{
     nodeId: z.ZodString;
     kind: z.ZodEnum<{
+        links: "links";
+        affects: "affects";
+        effects: "effects";
+        implements: "implements";
+        reads: "reads";
+        writes: "writes";
+        emits: "emits";
         contains: "contains";
         references: "references";
-        exposes: "exposes";
         maps_to: "maps_to";
-        "operates-on": "operates-on";
         uses: "uses";
         governs: "governs";
+        originates_from: "originates_from";
+        triggers: "triggers";
+        applies_to: "applies_to";
+        uses_catalog: "uses_catalog";
     }>;
 }, z.core.$strip>;
 type Link = z.infer<typeof LinkSchema>;
@@ -10162,12 +10720,8 @@ declare class RegistryValidationError extends Error {
 type ResourceValidatorMode = 'strict' | 'warn-only';
 type ResourceGovernanceValidationIssueType = 'missing-code-resource' | 'missing-om-resource' | 'type-mismatch' | 'system-mismatch' | 'missing-om-system' | 'raw-resource-id';
 interface ResourceGovernanceModel {
-    systems?: {
-        systems: SystemEntry[];
-    };
-    resources?: {
-        entries: ResourceEntry[];
-    };
+    systems?: Record<string, SystemEntry>;
+    resources?: Record<string, ResourceEntry>;
 }
 interface ResourceGovernanceValidationIssue {
     type: ResourceGovernanceValidationIssueType;
@@ -10257,150 +10811,150 @@ 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: [] }
-  ]
+// ============================================================================
+// 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 CrmStageKeySchema = z.enum(crmStageKeys)
-declare const CrmStateKeySchema = z.enum(crmStateKeys)
-type CrmStageKey = z.infer<typeof CrmStageKeySchema>
+declare const CrmStageKeySchema = z.enum(crmStageKeys)
+declare const CrmStateKeySchema = z.enum(crmStateKeys)
+type CrmStageKey = z.infer<typeof CrmStageKeySchema>
 type CrmStateKey = z.infer<typeof CrmStateKeySchema>
 
 /**