@elevasis/sdk 1.22.1 → 1.24.0

package/dist/node/index.js

@@ -511,4 +511,166 @@ async function runKnowledgeCodegen(layout) {
   );
 }
 
-export { generateKnowledgeBodies, generateKnowledgeNodes, generateKnowledgeNodesTs, readKnowledgeNodeMdx, runKnowledgeCodegen };
+// ../core/src/organization-model/helpers.ts
+function childSystemsOf(system) {
+  return system.systems ?? system.subsystems ?? {};
+}
+function listAllSystems(model) {
+  const results = [];
+  function walk(map, prefix) {
+    for (const [localId, system] of Object.entries(map)) {
+      const fullPath = prefix ? `${prefix}.${localId}` : localId;
+      results.push({ path: fullPath, system });
+      const childSystems = childSystemsOf(system);
+      if (Object.keys(childSystems).length > 0) {
+        walk(childSystems, fullPath);
+      }
+    }
+  }
+  walk(model.systems, "");
+  return results;
+}
+
+// src/node/project-deployment-spec.ts
+function toSdkResourceDescriptor(resource, getResourceOntologyBinding) {
+  const ontologyBinding = getResourceOntologyBinding?.(resource.id);
+  return {
+    ...resource,
+    ...ontologyBinding ?? {},
+    systemId: resource.systemPath
+  };
+}
+function withPlatformResourceDescriptor(workflow, getWorkflowResourceDescriptor, getResourceOntologyBinding) {
+  const resource = getWorkflowResourceDescriptor(workflow.config.resourceId);
+  const sdkResource = toSdkResourceDescriptor(resource, getResourceOntologyBinding);
+  return {
+    ...workflow,
+    config: {
+      ...workflow.config,
+      resource: sdkResource,
+      resourceId: sdkResource.id,
+      type: sdkResource.kind
+    }
+  };
+}
+function withPlatformResourceDescriptors(workflows, getWorkflowResourceDescriptor, getResourceOntologyBinding) {
+  return workflows.map(
+    (workflow) => withPlatformResourceDescriptor(workflow, getWorkflowResourceDescriptor, getResourceOntologyBinding)
+  );
+}
+function withPlatformIntegrationResourceDescriptor(integration, getIntegrationResourceDescriptor, getResourceOntologyBinding) {
+  const resource = getIntegrationResourceDescriptor(integration.resourceId);
+  const sdkResource = toSdkResourceDescriptor(resource, getResourceOntologyBinding);
+  return {
+    ...integration,
+    resource: sdkResource,
+    resourceId: sdkResource.id,
+    type: sdkResource.kind
+  };
+}
+function withPlatformIntegrationResourceDescriptors(integrations, getIntegrationResourceDescriptor, getResourceOntologyBinding) {
+  return integrations.map(
+    (integration) => withPlatformIntegrationResourceDescriptor(integration, getIntegrationResourceDescriptor, getResourceOntologyBinding)
+  );
+}
+function projectTopologyRelationships(model) {
+  const projected = {};
+  function ensure(sourceId) {
+    projected[sourceId] ??= {};
+    return projected[sourceId];
+  }
+  for (const relationship of Object.values(model.topology.relationships)) {
+    if (relationship.from.kind === "humanCheckpoint") continue;
+    if (relationship.kind === "triggers" && relationship.to.kind === "resource") {
+      const target = model.resources[relationship.to.id];
+      if (target?.kind !== "workflow" && target?.kind !== "agent") continue;
+      const source = ensure(relationship.from.id);
+      source.triggers ??= {};
+      if (target.kind === "workflow") {
+        source.triggers.workflows ??= [];
+        source.triggers.workflows.push(target.id);
+      } else {
+        source.triggers.agents ??= [];
+        source.triggers.agents.push(target.id);
+      }
+      continue;
+    }
+    if (relationship.kind === "uses" && relationship.from.kind === "resource" && relationship.to.kind === "resource") {
+      const target = model.resources[relationship.to.id];
+      if (target?.kind !== "integration") continue;
+      const source = ensure(relationship.from.id);
+      source.uses ??= {};
+      source.uses.integrations ??= [];
+      source.uses.integrations.push(target.id);
+    }
+  }
+  return projected;
+}
+function projectDeploymentSpec(options) {
+  const workflows = withPlatformResourceDescriptors(
+    options.workflows,
+    options.getWorkflowResourceDescriptor,
+    options.getResourceOntologyBinding
+  );
+  const integrations = withPlatformIntegrationResourceDescriptors(
+    options.integrations ?? [],
+    options.getIntegrationResourceDescriptor,
+    options.getResourceOntologyBinding
+  );
+  const workflowResourceIds = new Set(workflows.map((workflow) => workflow.config.resourceId));
+  const integrationResourceIds = new Set(integrations.map((integration) => integration.resourceId));
+  const resources = projectDeploymentResources(
+    options.organizationModel.resources,
+    workflowResourceIds,
+    integrationResourceIds,
+    options.getResourceOntologyBinding
+  );
+  return {
+    version: options.version,
+    organizationModel: {
+      systems: projectDeploymentSystems(options.organizationModel),
+      resources
+    },
+    workflows,
+    agents: options.agents ?? [],
+    triggers: options.triggers,
+    integrations,
+    humanCheckpoints: options.humanCheckpoints,
+    relationships: projectTopologyRelationships(options.organizationModel),
+    ...options.externalResources ? { externalResources: options.externalResources } : {}
+  };
+}
+function projectDeploymentResources(resources, workflowResourceIds, integrationResourceIds, getResourceOntologyBinding) {
+  return Object.fromEntries(
+    Object.values(resources).filter((resource) => workflowResourceIds.has(resource.id) || integrationResourceIds.has(resource.id)).map((resource) => {
+      const sdkResource = toSdkResourceDescriptor(resource, getResourceOntologyBinding);
+      return [sdkResource.id, sdkResource];
+    })
+  );
+}
+function projectDeploymentSystems(model) {
+  return Object.fromEntries(
+    listAllSystems(model).map(({ path, system }, index) => {
+      const lifecycle = system.lifecycle === "archived" ? "archived" : system.lifecycle === "deprecated" ? "deprecated" : "active";
+      return [
+        system.id,
+        {
+          id: system.id,
+          order: system.order ?? (index + 1) * 10,
+          title: system.label ?? system.title ?? system.id,
+          description: system.description ?? "",
+          kind: system.kind ?? "product",
+          ...system.parentSystemId ? { parentSystemId: system.parentSystemId } : {},
+          ...path !== system.id ? { systemPath: path } : {},
+          governedByKnowledge: system.governedByKnowledge ?? [],
+          drivesGoals: system.drivesGoals ?? [],
+          lifecycle,
+          status: lifecycle,
+          ...system.responsibleRoleId ? { responsibleRoleId: system.responsibleRoleId } : {}
+        }
+      ];
+    })
+  );
+}
+
+export { generateKnowledgeBodies, generateKnowledgeNodes, generateKnowledgeNodesTs, projectDeploymentSpec, projectTopologyRelationships, readKnowledgeNodeMdx, runKnowledgeCodegen, toSdkResourceDescriptor, withPlatformIntegrationResourceDescriptor, withPlatformIntegrationResourceDescriptors, withPlatformResourceDescriptor, withPlatformResourceDescriptors };

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

@@ -359,14 +359,18 @@ declare const WorkflowResourceEntrySchema: 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";
         }>;
@@ -406,14 +410,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";
         }>;
@@ -484,14 +492,18 @@ declare const ResourceEntrySchema: 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";
         }>;
@@ -530,14 +542,18 @@ declare const ResourceEntrySchema: 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";
         }>;
@@ -607,14 +623,18 @@ declare const ResourceEntrySchema: 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";
         }>;
@@ -642,14 +662,18 @@ declare const ResourceEntrySchema: 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";
         }>;
@@ -4353,36 +4377,6 @@ declare const CredentialRequirementSchema: z.ZodObject<{
 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";
@@ -4446,7 +4440,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;
         }>;
@@ -4813,9 +4807,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;
@@ -4828,7 +4824,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;
@@ -9031,24 +9027,6 @@ interface Tool {
  */
 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;
@@ -9090,11 +9068,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>;
 }
 
@@ -9871,14 +9844,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";
             }>;
@@ -9917,14 +9894,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";
             }>;
@@ -9994,14 +9975,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";
             }>;
@@ -10029,14 +10014,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";
             }>;
@@ -10261,6 +10250,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             crm: "crm";
             "lead-gen": "lead-gen";
             projects: "projects";
+            clients: "clients";
             operations: "operations";
             monitoring: "monitoring";
             knowledge: "knowledge";
@@ -10322,11 +10312,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>;
@@ -10334,7 +10323,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;
@@ -10342,7 +10331,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;
             };
         }>>>>;