@elevasis/core 0.24.0 → 0.24.1

package/dist/index.js

@@ -281,7 +281,6 @@ function addLegacyEntityProjections(index, diagnostics, sourcesById, entities) {
           table: entity.table
         }
       } : {},
-      legacyEntityId: entity.id,
       ...entity.rowSchema !== void 0 ? { rowSchema: entity.rowSchema } : {},
       ...entity.stateCatalogId !== void 0 ? { stateCatalogId: entity.stateCatalogId } : {}
     };
@@ -306,8 +305,7 @@ function addLegacyEntityProjections(index, diagnostics, sourcesById, entities) {
         from: legacyObjectId(entity),
         to: legacyObjectId(targetEntity),
         cardinality: link.kind,
-        ...link.via !== void 0 ? { via: link.via } : {},
-        legacyEntityId: entity.id
+        ...link.via !== void 0 ? { via: link.via } : {}
       };
       addRecord(index, diagnostics, sourcesById, "linkTypes", linkType, {
         source: "legacy.entities.links",
@@ -365,8 +363,7 @@ function addSystemContentProjections(index, diagnostics, sourcesById, systemPath
       kind: node.type,
       ...typeof node.data?.["entityId"] === "string" ? { appliesTo: formatOntologyId({ scope: systemPath, kind: "object", localId: node.data["entityId"] }) } : {},
       ...Object.keys(entries).length > 0 ? { entries } : {},
-      ...node.data !== void 0 ? { data: node.data } : {},
-      legacyContentId: `${systemPath}:${localId}`
+      ...node.data !== void 0 ? { data: node.data } : {}
     };
     addRecord(index, diagnostics, sourcesById, "catalogTypes", catalogType, {
       source: "legacy.system.content",
@@ -1508,11 +1505,20 @@ var EventDescriptorSchema = EventEmissionDescriptorSchema.extend({
   ownerKind: z.enum(["resource", "entity"]).meta({ label: "Owner kind" })
 });
 var ResourceOntologyBindingSchema = z.object({
-  implements: z.array(OntologyIdSchema).optional(),
+  actions: z.array(OntologyIdSchema).optional(),
+  primaryAction: OntologyIdSchema.optional(),
   reads: z.array(OntologyIdSchema).optional(),
   writes: z.array(OntologyIdSchema).optional(),
   usesCatalogs: z.array(OntologyIdSchema).optional(),
   emits: z.array(OntologyIdSchema).optional()
+}).superRefine((binding, ctx) => {
+  if (binding.primaryAction === void 0) return;
+  if (binding.actions?.includes(binding.primaryAction)) return;
+  ctx.addIssue({
+    code: z.ZodIssueCode.custom,
+    path: ["primaryAction"],
+    message: "Resource ontology primaryAction must be included in actions"
+  });
 });
 var CodeReferenceSchema = z.object({
   path: z.string().trim().min(1).max(500).regex(/^[A-Za-z0-9_./$@()[\] -]+$/, "Code reference paths must be repo-relative paths"),
@@ -1527,6 +1533,10 @@ var ResourceEntryBaseSchema = z.object({
   order: z.number().default(0),
   /** Required single System membership — value is a dot-separated system path (e.g. "sales.lead-gen"). */
   systemPath: SystemPathSchema.meta({ ref: "system" }),
+  /** Executable display title owned by the OM Resource descriptor. */
+  title: LabelSchema.optional(),
+  /** Executable display description owned by the OM Resource descriptor. */
+  description: DescriptionSchema.optional(),
   /** Optional role responsible for maintaining this resource. */
   ownerRoleId: ModelIdSchema.meta({ ref: "role" }).optional(),
   status: ResourceGovernanceStatusSchema,
@@ -1541,8 +1551,6 @@ var ResourceEntryBaseSchema = z.object({
 });
 var WorkflowResourceEntrySchema = ResourceEntryBaseSchema.extend({
   kind: z.literal("workflow"),
-  /** Mirrors WorkflowConfig.actionKey when the runtime workflow has one. */
-  actionKey: z.string().trim().min(1).max(255).optional(),
   emits: z.array(EventEmissionDescriptorSchema).optional()
 });
 var AgentResourceEntrySchema = ResourceEntryBaseSchema.extend({
@@ -1590,6 +1598,22 @@ function defineResources(resources) {
     Object.entries(resources).map(([key, resource]) => [key, ResourceEntrySchema.parse(resource)])
   );
 }
+function ontologyIdFrom(input) {
+  return typeof input === "string" ? input : input.id;
+}
+function ontologyIdArrayFrom(input) {
+  return input?.map(ontologyIdFrom);
+}
+function defineResourceOntology(input) {
+  return ResourceOntologyBindingSchema.parse({
+    actions: ontologyIdArrayFrom(input.actions),
+    primaryAction: input.primaryAction === void 0 ? void 0 : ontologyIdFrom(input.primaryAction),
+    reads: ontologyIdArrayFrom(input.reads),
+    writes: ontologyIdArrayFrom(input.writes),
+    usesCatalogs: ontologyIdArrayFrom(input.usesCatalogs),
+    emits: ontologyIdArrayFrom(input.emits)
+  });
+}
 
 // src/organization-model/domains/roles.ts
 var RoleIdSchema = ModelIdSchema;
@@ -1770,6 +1794,179 @@ var OrgKnowledgeNodeSchema = z.object({
   updatedAt: z.string().trim().min(1).max(50)
 });
 var KnowledgeDomainSchema = z.record(ModelIdSchema, OrgKnowledgeNodeSchema).default({});
+var SecretLikeMetadataKeySchema = /(?:secret|password|passwd|token|api[-_]?key|credential|private[-_]?key)/i;
+var SecretLikeMetadataValueSchema = /(?:sk-[A-Za-z0-9_-]{12,}|pk_live_[A-Za-z0-9_-]{12,}|eyJ[A-Za-z0-9_-]{20,}|-----BEGIN (?:RSA |OPENSSH |EC )?PRIVATE KEY-----)/;
+var OmTopologyNodeKindSchema = z.enum([
+  "system",
+  "resource",
+  "ontology",
+  "policy",
+  "role",
+  "trigger",
+  "humanCheckpoint",
+  "externalResource"
+]);
+var OmTopologyRelationshipKindSchema = z.enum(["triggers", "uses", "approval"]);
+var OmTopologyNodeRefSchema = z.discriminatedUnion("kind", [
+  z.object({ kind: z.literal("system"), id: ModelIdSchema }),
+  z.object({ kind: z.literal("resource"), id: ResourceIdSchema }),
+  z.object({ kind: z.literal("ontology"), id: OntologyIdSchema }),
+  z.object({ kind: z.literal("policy"), id: ModelIdSchema }),
+  z.object({ kind: z.literal("role"), id: ModelIdSchema }),
+  z.object({ kind: z.literal("trigger"), id: ResourceIdSchema }),
+  z.object({ kind: z.literal("humanCheckpoint"), id: ResourceIdSchema }),
+  z.object({ kind: z.literal("externalResource"), id: ResourceIdSchema })
+]);
+var OmTopologyMetadataSchema = z.record(z.string().trim().min(1).max(120), JsonValueSchema).superRefine((metadata, ctx) => {
+  function visit(value, path) {
+    if (typeof value === "string" && SecretLikeMetadataValueSchema.test(value)) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        path,
+        message: "Topology metadata must not contain secret-like values"
+      });
+      return;
+    }
+    if (Array.isArray(value)) {
+      value.forEach((entry, index) => visit(entry, [...path, index]));
+      return;
+    }
+    if (typeof value !== "object" || value === null) return;
+    Object.entries(value).forEach(([key, entry]) => {
+      if (SecretLikeMetadataKeySchema.test(key)) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          path: [...path, key],
+          message: `Topology metadata key "${key}" looks secret-like`
+        });
+      }
+      visit(entry, [...path, key]);
+    });
+  }
+  visit(metadata, []);
+});
+var OmTopologyRelationshipSchema = z.object({
+  from: OmTopologyNodeRefSchema,
+  kind: OmTopologyRelationshipKindSchema,
+  to: OmTopologyNodeRefSchema,
+  systemPath: SystemPathSchema.optional(),
+  required: z.boolean().optional(),
+  metadata: OmTopologyMetadataSchema.optional()
+});
+var OmTopologyDomainSchema = z.object({
+  version: z.literal(1).default(1),
+  relationships: z.record(z.string().trim().min(1).max(255), OmTopologyRelationshipSchema).default({})
+}).default({ version: 1, relationships: {} });
+var DEFAULT_ORGANIZATION_MODEL_TOPOLOGY = {
+  version: 1,
+  relationships: {}
+};
+function idFrom(input) {
+  return typeof input === "string" ? input : input.id;
+}
+function parseRef(kind, id) {
+  return OmTopologyNodeRefSchema.parse({ kind, id });
+}
+function isNodeRef(input) {
+  return OmTopologyNodeRefSchema.safeParse(input).success;
+}
+function isResourceEntry(input) {
+  if (typeof input !== "object" || input === null) return false;
+  const candidate = input;
+  return typeof candidate.id === "string" && typeof candidate.systemPath === "string" && typeof candidate.status === "string" && ["workflow", "agent", "integration", "script"].includes(String(candidate.kind));
+}
+var topologyRef = {
+  system: (system) => parseRef("system", idFrom(system)),
+  resource: (resource) => parseRef("resource", idFrom(resource)),
+  ontology: (record) => parseRef("ontology", idFrom(record)),
+  policy: (policy) => parseRef("policy", idFrom(policy)),
+  role: (role) => parseRef("role", idFrom(role)),
+  trigger: (trigger) => parseRef("trigger", idFrom(trigger)),
+  humanCheckpoint: (checkpoint) => parseRef("humanCheckpoint", idFrom(checkpoint)),
+  externalResource: (externalResource) => parseRef("externalResource", idFrom(externalResource))
+};
+var topologyRelationship = {
+  triggers: (from, to, options = {}) => defineTopologyRelationship({
+    ...options,
+    from,
+    kind: "triggers",
+    to
+  }),
+  uses: (from, to, options = {}) => defineTopologyRelationship({
+    ...options,
+    from,
+    kind: "uses",
+    to
+  }),
+  approval: (from, to, options = {}) => defineTopologyRelationship({
+    ...options,
+    from,
+    kind: "approval",
+    to
+  }),
+  usesIntegration: (from, integration, options = {}) => defineTopologyRelationship({
+    required: true,
+    ...options,
+    from,
+    kind: "uses",
+    to: integration
+  }),
+  requestsApproval: (from, checkpoint, options = {}) => defineTopologyRelationship({
+    required: true,
+    ...options,
+    from,
+    kind: "approval",
+    to: topologyRef.humanCheckpoint(checkpoint)
+  }),
+  checkpointRoutesTo: (checkpoint, to, options = {}) => defineTopologyRelationship({
+    required: true,
+    ...options,
+    from: topologyRef.humanCheckpoint(checkpoint),
+    kind: "triggers",
+    to
+  })
+};
+function compileTopologyNodeRef(input) {
+  if (isNodeRef(input)) return input;
+  if (isResourceEntry(input)) return topologyRef.resource(input);
+  throw new Error("Topology node refs must be typed node objects or serializable { kind, id } refs");
+}
+function parseTopologyNodeRef(input) {
+  if (typeof input !== "string") return OmTopologyNodeRefSchema.parse(input);
+  const separatorIndex = input.indexOf(":");
+  if (separatorIndex === -1) {
+    throw new Error(`Topology node ref "${input}" must use <kind>:<id>`);
+  }
+  const kind = input.slice(0, separatorIndex);
+  const id = input.slice(separatorIndex + 1);
+  if (!OmTopologyNodeKindSchema.safeParse(kind).success) {
+    throw new Error(`Topology node ref "${input}" has unsupported kind "${kind}"`);
+  }
+  return OmTopologyNodeRefSchema.parse({ kind, id });
+}
+function defineTopologyRelationship(input) {
+  return OmTopologyRelationshipSchema.parse({
+    ...input,
+    from: compileTopologyNodeRef(input.from),
+    to: compileTopologyNodeRef(input.to)
+  });
+}
+function defineTopology(relationships) {
+  const entries = Array.isArray(relationships) ? relationships.map((relationship, index) => [`relationship-${index + 1}`, relationship]) : Object.entries(relationships);
+  return OmTopologyDomainSchema.parse({
+    version: 1,
+    relationships: Object.fromEntries(entries.map(([key, relationship]) => [key, defineTopologyRelationship(relationship)]))
+  });
+}
+function isOntologyTopologyRef(value) {
+  if (!isNodeRef(value) || value.kind !== "ontology") return false;
+  try {
+    parseOntologyId(value.id);
+    return true;
+  } catch {
+    return false;
+  }
+}
 var PolicyIdSchema = ModelIdSchema;
 var PolicyApplicabilitySchema = z.object({
   systemIds: z.array(ModelIdSchema.meta({ ref: "system" })).default([]),
@@ -1859,6 +2056,7 @@ var OrganizationModelDomainKeySchema = z.enum([
   "systems",
   "ontology",
   "resources",
+  "topology",
   "actions",
   "entities",
   "policies",
@@ -1878,6 +2076,7 @@ var DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA = {
   systems: { version: 1, lastModified: "2026-05-10" },
   ontology: { version: 1, lastModified: "2026-05-14" },
   resources: { version: 1, lastModified: "2026-05-10" },
+  topology: { version: 1, lastModified: "2026-05-14" },
   actions: { version: 1, lastModified: "2026-05-10" },
   entities: { version: 1, lastModified: "2026-05-10" },
   policies: { version: 1, lastModified: "2026-05-10" },
@@ -1893,6 +2092,7 @@ var OrganizationModelDomainMetadataByDomainSchema = z.object({
   systems: OrganizationModelDomainMetadataSchema,
   ontology: OrganizationModelDomainMetadataSchema,
   resources: OrganizationModelDomainMetadataSchema,
+  topology: OrganizationModelDomainMetadataSchema,
   actions: OrganizationModelDomainMetadataSchema,
   entities: OrganizationModelDomainMetadataSchema,
   policies: OrganizationModelDomainMetadataSchema,
@@ -1911,6 +2111,7 @@ var OrganizationModelSchemaBase = z.object({
   systems: SystemsDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_SYSTEMS),
   ontology: OntologyScopeSchema.default(DEFAULT_ONTOLOGY_SCOPE),
   resources: ResourcesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_RESOURCES),
+  topology: OmTopologyDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_TOPOLOGY),
   actions: ActionsDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_ACTIONS),
   entities: EntitiesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_ENTITIES),
   policies: PoliciesDomainSchema.default(DEFAULT_ORGANIZATION_MODEL_POLICIES),
@@ -2253,6 +2454,25 @@ var OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((model, ct
     surface: ontologyCompilation.ontology.surfaces
   };
   const ontologyIds = new Set(Object.values(ontologyIndexByKind).flatMap((index) => Object.keys(index)));
+  function topologyTargetExists(ref) {
+    if (ref.kind === "system") return systemsById.has(ref.id);
+    if (ref.kind === "resource") return resourcesById.has(ref.id);
+    if (ref.kind === "ontology") return ontologyIds.has(ref.id);
+    if (ref.kind === "policy") return policiesById.has(ref.id);
+    if (ref.kind === "role") return rolesById.has(ref.id);
+    return true;
+  }
+  Object.entries(model.topology.relationships).forEach(([relationshipId, relationship]) => {
+    ["from", "to"].forEach((side) => {
+      const ref = relationship[side];
+      if (topologyTargetExists(ref)) return;
+      addIssue(
+        ctx,
+        ["topology", "relationships", relationshipId, side],
+        `Topology relationship "${relationshipId}" ${side} references unknown ${ref.kind} "${ref.id}"`
+      );
+    });
+  });
   const ontologyReferenceKeyKinds = {
     valueType: "value-type",
     catalogType: "catalog",
@@ -2391,11 +2611,18 @@ var OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((model, ct
     }
   });
   function validateResourceOntologyBinding(resourceId, bindingKey, expectedKind, ids) {
-    ids?.forEach((ontologyId, ontologyIndex) => {
+    const ontologyIds2 = ids === void 0 ? [] : Array.isArray(ids) ? ids : [ids];
+    ontologyIds2.forEach((ontologyId, ontologyIndex) => {
       if (ontologyIndexByKind[expectedKind][ontologyId] === void 0) {
         addIssue(
           ctx,
-          ["resources", resourceId, "ontology", bindingKey, ontologyIndex],
+          [
+            "resources",
+            resourceId,
+            "ontology",
+            bindingKey,
+            ...Array.isArray(ids) ? [ontologyIndex] : []
+          ],
           `Resource "${resourceId}" ontology binding "${bindingKey}" references unknown ${expectedKind} ontology ID "${ontologyId}"`
         );
       }
@@ -2404,7 +2631,8 @@ var OrganizationModelSchema = OrganizationModelSchemaBase.superRefine((model, ct
   Object.values(model.resources).forEach((resource) => {
     const binding = resource.ontology;
     if (binding === void 0) return;
-    validateResourceOntologyBinding(resource.id, "implements", "action", binding.implements);
+    validateResourceOntologyBinding(resource.id, "actions", "action", binding.actions);
+    validateResourceOntologyBinding(resource.id, "primaryAction", "action", binding.primaryAction);
     validateResourceOntologyBinding(resource.id, "reads", "object", binding.reads);
     validateResourceOntologyBinding(resource.id, "writes", "object", binding.writes);
     validateResourceOntologyBinding(resource.id, "usesCatalogs", "catalog", binding.usesCatalogs);
@@ -2550,9 +2778,10 @@ var OrganizationGraphEdgeKindSchema = z.enum([
   "emits",
   "originates_from",
   "triggers",
+  "approval",
   "applies_to",
   "effects",
-  "implements",
+  "actions",
   "reads",
   "writes",
   "uses_catalog"
@@ -3330,6 +3559,7 @@ var DEFAULT_ORGANIZATION_MODEL = {
   },
   ontology: DEFAULT_ONTOLOGY_SCOPE,
   resources: DEFAULT_ORGANIZATION_MODEL_RESOURCES,
+  topology: DEFAULT_ORGANIZATION_MODEL_TOPOLOGY,
   actions: DEFAULT_ORGANIZATION_MODEL_ACTIONS,
   entities: DEFAULT_ORGANIZATION_MODEL_ENTITIES2,
   policies: DEFAULT_ORGANIZATION_MODEL_POLICIES,
@@ -3978,4 +4208,4 @@ function createFoundationOrganizationModel(override) {
   };
 }
 
-export { ActionIdSchema, ActionInvocationKindSchema, ActionInvocationSchema, ActionRefSchema, ActionSchema, ActionScopeSchema, ActionsDomainSchema, AgentKindSchema, AgentResourceEntrySchema, AgentRoleHolderSchema, ApiEndpointInvocationSchema, CRM_ACTION_ENTRIES, CodeReferenceRoleSchema, CodeReferenceSchema, CustomerSegmentSchema, CustomersDomainSchema, DEFAULT_ONTOLOGY_SCOPE, DEFAULT_ORGANIZATION_MODEL, DEFAULT_ORGANIZATION_MODEL_ACTIONS, DEFAULT_ORGANIZATION_MODEL_CUSTOMERS, DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA, DEFAULT_ORGANIZATION_MODEL_ENTITIES, DEFAULT_ORGANIZATION_MODEL_GOALS, DEFAULT_ORGANIZATION_MODEL_NAVIGATION, DEFAULT_ORGANIZATION_MODEL_OFFERINGS, DEFAULT_ORGANIZATION_MODEL_POLICIES, DEFAULT_ORGANIZATION_MODEL_RESOURCES, DEFAULT_ORGANIZATION_MODEL_ROLES, DEFAULT_ORGANIZATION_MODEL_STATUSES, DEFAULT_ORGANIZATION_MODEL_SYSTEMS, EntitiesDomainSchema, EntityIdSchema, EntityLinkKindSchema, EntityLinkSchema, EntitySchema, EventDescriptorSchema, EventEmissionDescriptorSchema, EventIdSchema, FirmographicsSchema, GoalsDomainSchema, HumanRoleHolderSchema, IconNameSchema, IntegrationResourceEntrySchema, KNOWLEDGE_FEATURE_ID, KNOWLEDGE_SYSTEM_ID, KeyResultSchema, KnowledgeDomainSchema, KnowledgeLinkSchema, KnowledgeTargetKindSchema, KnowledgeTargetRefSchema, LEAD_GEN_ACTION_ENTRIES, LEAD_GEN_STAGE_CATALOG, LinkSchema, MONITORING_FEATURE_ID, MONITORING_SYSTEM_ID, McpToolInvocationSchema, NavigationGroupSchema, NodeIdPathSchema, NodeIdStringSchema, OPERATIONS_COMMAND_VIEW_SURFACE_ID, OPERATIONS_FEATURE_ID, OPERATIONS_SYSTEM_ID, ORGANIZATION_MODEL_ICON_TOKENS, ObjectiveSchema, OfferingsDomainSchema, OntologyActionTypeSchema, OntologyCatalogTypeSchema, OntologyEventTypeSchema, OntologyGroupSchema, OntologyIdSchema, OntologyInterfaceTypeSchema, OntologyKindSchema, OntologyLinkTypeSchema, OntologyObjectTypeSchema, OntologyScopeSchema, OntologySharedPropertySchema, OntologySurfaceTypeSchema, OntologyValueTypeSchema, OrgKnowledgeKindSchema, OrgKnowledgeNodeSchema, OrganizationModelBuiltinIconTokenSchema, OrganizationModelDomainKeySchema, OrganizationModelDomainMetadataByDomainSchema, OrganizationModelDomainMetadataSchema, OrganizationModelIconTokenSchema, OrganizationModelNavigationSchema, OrganizationModelSchema, PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID, PROJECTS_SYSTEM_ID, PROJECTS_VIEW_ACTION_ID, PROSPECTING_FEATURE_ID, PROSPECTING_LISTS_SURFACE_ID, PROSPECTING_SYSTEM_ID, PoliciesDomainSchema, PolicyApplicabilitySchema, PolicyEffectSchema, PolicyIdSchema, PolicyPredicateSchema, PolicySchema, PolicyTriggerSchema, PricingModelSchema, ProductSchema, ResourceEntrySchema, ResourceGovernanceStatusSchema, ResourceIdSchema, ResourceKindSchema, ResourceOntologyBindingSchema, ResourcesDomainSchema, RoleHolderSchema, RoleHoldersSchema, RoleIdSchema, RoleSchema, RolesDomainSchema, SALES_FEATURE_ID, SALES_PIPELINE_SURFACE_ID, SALES_SYSTEM_ID, SEO_FEATURE_ID, SEO_SYSTEM_ID, SETTINGS_FEATURE_ID, SETTINGS_ROLES_SURFACE_ID, SETTINGS_SYSTEM_ID, ScriptExecutionInvocationSchema, ScriptResourceEntrySchema, ScriptResourceLanguageSchema, ScriptResourceSourceSchema, SidebarNavigationSchema, SidebarNodeSchema, SidebarSectionSchema, SidebarSurfaceTargetsSchema, SlashCommandInvocationSchema, StatusEntrySchema, StatusSemanticClassSchema, StatusesDomainSchema, SurfaceDefinitionSchema, SurfaceTypeSchema, SystemEntrySchema, SystemIdSchema, SystemKindSchema, SystemLifecycleSchema, SystemPathSchema, SystemStatusSchema, SystemUiSchema, SystemsDomainSchema, TeamRoleHolderSchema, TechStackEntrySchema, UiPositionSchema, WorkflowResourceEntrySchema, compileOrganizationOntology, createFoundationOrganizationModel, defineOrganizationModel, defineResource, defineResources, findOrganizationActionById, formatOntologyId, getOntologyDiagnostics, getSortedSidebarEntries, isOntologyGraphNodeId, listResolvedOntologyRecords, ontologyGraphNodeId, ontologyIdFromGraphNodeId, parseOntologyId, resolveOrganizationModel, resolveOrganizationModelWithResources };
+export { ActionIdSchema, ActionInvocationKindSchema, ActionInvocationSchema, ActionRefSchema, ActionSchema, ActionScopeSchema, ActionsDomainSchema, AgentKindSchema, AgentResourceEntrySchema, AgentRoleHolderSchema, ApiEndpointInvocationSchema, CRM_ACTION_ENTRIES, CodeReferenceRoleSchema, CodeReferenceSchema, CustomerSegmentSchema, CustomersDomainSchema, DEFAULT_ONTOLOGY_SCOPE, DEFAULT_ORGANIZATION_MODEL, DEFAULT_ORGANIZATION_MODEL_ACTIONS, DEFAULT_ORGANIZATION_MODEL_CUSTOMERS, DEFAULT_ORGANIZATION_MODEL_DOMAIN_METADATA, DEFAULT_ORGANIZATION_MODEL_ENTITIES, DEFAULT_ORGANIZATION_MODEL_GOALS, DEFAULT_ORGANIZATION_MODEL_NAVIGATION, DEFAULT_ORGANIZATION_MODEL_OFFERINGS, DEFAULT_ORGANIZATION_MODEL_POLICIES, DEFAULT_ORGANIZATION_MODEL_RESOURCES, DEFAULT_ORGANIZATION_MODEL_ROLES, DEFAULT_ORGANIZATION_MODEL_STATUSES, DEFAULT_ORGANIZATION_MODEL_SYSTEMS, DEFAULT_ORGANIZATION_MODEL_TOPOLOGY, EntitiesDomainSchema, EntityIdSchema, EntityLinkKindSchema, EntityLinkSchema, EntitySchema, EventDescriptorSchema, EventEmissionDescriptorSchema, EventIdSchema, FirmographicsSchema, GoalsDomainSchema, HumanRoleHolderSchema, IconNameSchema, IntegrationResourceEntrySchema, KNOWLEDGE_FEATURE_ID, KNOWLEDGE_SYSTEM_ID, KeyResultSchema, KnowledgeDomainSchema, KnowledgeLinkSchema, KnowledgeTargetKindSchema, KnowledgeTargetRefSchema, LEAD_GEN_ACTION_ENTRIES, LEAD_GEN_STAGE_CATALOG, LinkSchema, MONITORING_FEATURE_ID, MONITORING_SYSTEM_ID, McpToolInvocationSchema, NavigationGroupSchema, NodeIdPathSchema, NodeIdStringSchema, OPERATIONS_COMMAND_VIEW_SURFACE_ID, OPERATIONS_FEATURE_ID, OPERATIONS_SYSTEM_ID, ORGANIZATION_MODEL_ICON_TOKENS, ObjectiveSchema, OfferingsDomainSchema, OmTopologyDomainSchema, OmTopologyMetadataSchema, OmTopologyNodeKindSchema, OmTopologyNodeRefSchema, OmTopologyRelationshipKindSchema, OmTopologyRelationshipSchema, OntologyActionTypeSchema, OntologyCatalogTypeSchema, OntologyEventTypeSchema, OntologyGroupSchema, OntologyIdSchema, OntologyInterfaceTypeSchema, OntologyKindSchema, OntologyLinkTypeSchema, OntologyObjectTypeSchema, OntologyScopeSchema, OntologySharedPropertySchema, OntologySurfaceTypeSchema, OntologyValueTypeSchema, OrgKnowledgeKindSchema, OrgKnowledgeNodeSchema, OrganizationModelBuiltinIconTokenSchema, OrganizationModelDomainKeySchema, OrganizationModelDomainMetadataByDomainSchema, OrganizationModelDomainMetadataSchema, OrganizationModelIconTokenSchema, OrganizationModelNavigationSchema, OrganizationModelSchema, PROJECTS_FEATURE_ID, PROJECTS_INDEX_SURFACE_ID, PROJECTS_SYSTEM_ID, PROJECTS_VIEW_ACTION_ID, PROSPECTING_FEATURE_ID, PROSPECTING_LISTS_SURFACE_ID, PROSPECTING_SYSTEM_ID, PoliciesDomainSchema, PolicyApplicabilitySchema, PolicyEffectSchema, PolicyIdSchema, PolicyPredicateSchema, PolicySchema, PolicyTriggerSchema, PricingModelSchema, ProductSchema, ResourceEntrySchema, ResourceGovernanceStatusSchema, ResourceIdSchema, ResourceKindSchema, ResourceOntologyBindingSchema, ResourcesDomainSchema, RoleHolderSchema, RoleHoldersSchema, RoleIdSchema, RoleSchema, RolesDomainSchema, SALES_FEATURE_ID, SALES_PIPELINE_SURFACE_ID, SALES_SYSTEM_ID, SEO_FEATURE_ID, SEO_SYSTEM_ID, SETTINGS_FEATURE_ID, SETTINGS_ROLES_SURFACE_ID, SETTINGS_SYSTEM_ID, ScriptExecutionInvocationSchema, ScriptResourceEntrySchema, ScriptResourceLanguageSchema, ScriptResourceSourceSchema, SidebarNavigationSchema, SidebarNodeSchema, SidebarSectionSchema, SidebarSurfaceTargetsSchema, SlashCommandInvocationSchema, StatusEntrySchema, StatusSemanticClassSchema, StatusesDomainSchema, SurfaceDefinitionSchema, SurfaceTypeSchema, SystemEntrySchema, SystemIdSchema, SystemKindSchema, SystemLifecycleSchema, SystemPathSchema, SystemStatusSchema, SystemUiSchema, SystemsDomainSchema, TeamRoleHolderSchema, TechStackEntrySchema, UiPositionSchema, WorkflowResourceEntrySchema, compileOrganizationOntology, compileTopologyNodeRef, createFoundationOrganizationModel, defineOrganizationModel, defineResource, defineResourceOntology, defineResources, defineTopology, defineTopologyRelationship, findOrganizationActionById, formatOntologyId, getOntologyDiagnostics, getSortedSidebarEntries, isOntologyGraphNodeId, isOntologyTopologyRef, listResolvedOntologyRecords, ontologyGraphNodeId, ontologyIdFromGraphNodeId, parseOntologyId, parseTopologyNodeRef, resolveOrganizationModel, resolveOrganizationModelWithResources, topologyRef, topologyRelationship };

package/dist/knowledge/index.d.ts

@@ -434,6 +434,10 @@ declare const OrganizationModelSchema: z.ZodObject<{
             version: z.ZodDefault<z.ZodLiteral<1>>;
             lastModified: z.ZodString;
         }, z.core.$strip>>;
+        topology: z.ZodOptional<z.ZodObject<{
+            version: z.ZodDefault<z.ZodLiteral<1>>;
+            lastModified: z.ZodString;
+        }, z.core.$strip>>;
         actions: z.ZodOptional<z.ZodObject<{
             version: z.ZodDefault<z.ZodLiteral<1>>;
             lastModified: z.ZodString;
@@ -487,6 +491,10 @@ declare const OrganizationModelSchema: z.ZodObject<{
             version: 1;
             lastModified: string;
         };
+        topology: {
+            version: 1;
+            lastModified: string;
+        };
         actions: {
             version: 1;
             lastModified: string;
@@ -540,6 +548,10 @@ declare const OrganizationModelSchema: z.ZodObject<{
             version: 1;
             lastModified: string;
         } | undefined;
+        topology?: {
+            version: 1;
+            lastModified: string;
+        } | undefined;
         actions?: {
             version: 1;
             lastModified: string;
@@ -783,6 +795,8 @@ declare const OrganizationModelSchema: z.ZodObject<{
         id: z.ZodString;
         order: z.ZodDefault<z.ZodNumber>;
         systemPath: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
         ownerRoleId: z.ZodOptional<z.ZodString>;
         status: z.ZodEnum<{
             deprecated: "deprecated";
@@ -790,7 +804,8 @@ declare const OrganizationModelSchema: z.ZodObject<{
             archived: "archived";
         }>;
         ontology: z.ZodOptional<z.ZodObject<{
-            implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            primaryAction: z.ZodOptional<z.ZodString>;
             reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
             writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
             usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -810,7 +825,6 @@ declare const OrganizationModelSchema: z.ZodObject<{
             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;
@@ -827,6 +841,8 @@ declare const OrganizationModelSchema: z.ZodObject<{
         id: z.ZodString;
         order: z.ZodDefault<z.ZodNumber>;
         systemPath: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
         ownerRoleId: z.ZodOptional<z.ZodString>;
         status: z.ZodEnum<{
             deprecated: "deprecated";
@@ -834,7 +850,8 @@ declare const OrganizationModelSchema: z.ZodObject<{
             archived: "archived";
         }>;
         ontology: z.ZodOptional<z.ZodObject<{
-            implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            primaryAction: z.ZodOptional<z.ZodString>;
             reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
             writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
             usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -901,6 +918,8 @@ declare const OrganizationModelSchema: z.ZodObject<{
         id: z.ZodString;
         order: z.ZodDefault<z.ZodNumber>;
         systemPath: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
         ownerRoleId: z.ZodOptional<z.ZodString>;
         status: z.ZodEnum<{
             deprecated: "deprecated";
@@ -908,7 +927,8 @@ declare const OrganizationModelSchema: z.ZodObject<{
             archived: "archived";
         }>;
         ontology: z.ZodOptional<z.ZodObject<{
-            implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            primaryAction: z.ZodOptional<z.ZodString>;
             reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
             writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
             usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -933,6 +953,8 @@ declare const OrganizationModelSchema: z.ZodObject<{
         id: z.ZodString;
         order: z.ZodDefault<z.ZodNumber>;
         systemPath: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
         ownerRoleId: z.ZodOptional<z.ZodString>;
         status: z.ZodEnum<{
             deprecated: "deprecated";
@@ -940,7 +962,8 @@ declare const OrganizationModelSchema: z.ZodObject<{
             archived: "archived";
         }>;
         ontology: z.ZodOptional<z.ZodObject<{
-            implements: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            actions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            primaryAction: z.ZodOptional<z.ZodString>;
             reads: z.ZodOptional<z.ZodArray<z.ZodString>>;
             writes: z.ZodOptional<z.ZodArray<z.ZodString>>;
             usesCatalogs: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -970,6 +993,69 @@ declare const OrganizationModelSchema: z.ZodObject<{
             file: z.ZodString;
         }, z.core.$strip>]>;
     }, z.core.$strip>], "kind">>>>;
+    topology: z.ZodDefault<z.ZodDefault<z.ZodObject<{
+        version: z.ZodDefault<z.ZodLiteral<1>>;
+        relationships: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            from: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"system">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"resource">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"ontology">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"policy">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"role">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"trigger">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"humanCheckpoint">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"externalResource">;
+                id: z.ZodString;
+            }, z.core.$strip>], "kind">;
+            kind: z.ZodEnum<{
+                triggers: "triggers";
+                uses: "uses";
+                approval: "approval";
+            }>;
+            to: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"system">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"resource">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"ontology">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"policy">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"role">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"trigger">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"humanCheckpoint">;
+                id: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"externalResource">;
+                id: z.ZodString;
+            }, z.core.$strip>], "kind">;
+            systemPath: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
     actions: z.ZodDefault<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         order: z.ZodNumber;
@@ -1209,7 +1295,7 @@ type OrganizationModel = z.infer<typeof OrganizationModelSchema>;
 type OrganizationGraphNodeKind = 'organization' | 'system' | 'role' | 'action' | 'entity' | 'event' | 'policy' | 'stage' | 'resource' | 'knowledge' | 'customer-segment' | 'offering' | 'goal' | 'surface' | 'navigation-group'
 /** Phase 3 preview — Phase 4 populates this kind via graph projection of system.content entries. */
  | 'ontology' | 'content-node';
-type OrganizationGraphEdgeKind = 'contains' | 'references' | 'maps_to' | 'uses' | 'governs' | 'links' | 'affects' | 'emits' | 'originates_from' | 'triggers' | 'applies_to' | 'effects' | 'implements' | 'reads' | 'writes' | 'uses_catalog';
+type OrganizationGraphEdgeKind = 'contains' | 'references' | 'maps_to' | 'uses' | 'governs' | 'links' | 'affects' | 'emits' | 'originates_from' | 'triggers' | 'approval' | 'applies_to' | 'effects' | 'actions' | 'reads' | 'writes' | 'uses_catalog';
 
 interface OrganizationGraphNode {
     id: string;