@elevasis/core 0.23.0 → 0.24.1

package/dist/knowledge/index.d.ts

@@ -1,5 +1,99 @@
 import { z } from 'zod';
 
+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>;
+
 /**
  * Placeholder discriminated union for ContentNode (Wave 1A).
  * Wave 2A wires concrete (kind, type) pairs via the registry.
@@ -18,6 +112,10 @@ declare const ContentNodeSchema: z.ZodObject<{
 }, z.core.$strip>;
 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;
@@ -52,6 +150,13 @@ interface SystemEntry {
     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>;
 }
@@ -76,12 +181,12 @@ interface SystemEntry {
 type RelationshipType = 'triggers' | 'uses' | 'approval';
 
 declare const SurfaceTypeSchema: z.ZodEnum<{
-    list: "list";
+    dashboard: "dashboard";
+    settings: "settings";
     graph: "graph";
+    list: "list";
     page: "page";
-    dashboard: "dashboard";
     detail: "detail";
-    settings: "settings";
 }>;
 interface SidebarSurfaceNode {
     type: 'surface';
@@ -125,80 +230,76 @@ declare const OrgKnowledgeNodeSchema: z.ZodObject<{
     title: z.ZodString;
     summary: 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]>>;
     externalUrl: z.ZodOptional<z.ZodString>;
+    sourceFilePath: z.ZodOptional<z.ZodString>;
     body: z.ZodString;
     links: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodUnion<readonly [z.ZodObject<{
         target: z.ZodObject<{
             kind: z.ZodEnum<{
+                knowledge: "knowledge";
                 system: "system";
                 action: "action";
-                knowledge: "knowledge";
+                ontology: "ontology";
                 role: "role";
                 goal: "goal";
                 stage: "stage";
@@ -210,10 +311,10 @@ declare const OrgKnowledgeNodeSchema: z.ZodObject<{
             id: z.ZodString;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
-        nodeId: z.ZodString;
+        nodeId: z.ZodUnion<readonly [z.ZodString, z.ZodTemplateLiteral<`ontology:${string}`>]>;
     }, z.core.$strip>]>, z.ZodTransform<{
         target: {
-            kind: "system" | "action" | "knowledge" | "role" | "goal" | "stage" | "resource" | "customer-segment" | "offering" | "content-node";
+            kind: "knowledge" | "system" | "action" | "ontology" | "role" | "goal" | "stage" | "resource" | "customer-segment" | "offering" | "content-node";
             id: string;
         };
         nodeId: string;
@@ -221,7 +322,7 @@ declare const OrgKnowledgeNodeSchema: z.ZodObject<{
         nodeId: string;
     } | {
         target: {
-            kind: "system" | "action" | "knowledge" | "role" | "goal" | "stage" | "resource" | "customer-segment" | "offering" | "content-node";
+            kind: "knowledge" | "system" | "action" | "ontology" | "role" | "goal" | "stage" | "resource" | "customer-segment" | "offering" | "content-node";
             id: string;
         };
     }>>>>;
@@ -232,71 +333,65 @@ type OrgKnowledgeNode = z.infer<typeof OrgKnowledgeNodeSchema>;
 type OrgKnowledgeKind = z.infer<typeof OrgKnowledgeKindSchema>;
 
 declare const OrganizationModelIconTokenSchema: 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]>;
 type OrganizationModelIconToken = z.infer<typeof OrganizationModelIconTokenSchema>;
 
@@ -331,10 +426,18 @@ declare const OrganizationModelSchema: z.ZodObject<{
             version: z.ZodDefault<z.ZodLiteral<1>>;
             lastModified: z.ZodString;
         }, z.core.$strip>>;
+        ontology: z.ZodOptional<z.ZodObject<{
+            version: z.ZodDefault<z.ZodLiteral<1>>;
+            lastModified: z.ZodString;
+        }, z.core.$strip>>;
         resources: z.ZodOptional<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;
@@ -380,10 +483,18 @@ declare const OrganizationModelSchema: z.ZodObject<{
             version: 1;
             lastModified: string;
         };
+        ontology: {
+            version: 1;
+            lastModified: string;
+        };
         resources: {
             version: 1;
             lastModified: string;
         };
+        topology: {
+            version: 1;
+            lastModified: string;
+        };
         actions: {
             version: 1;
             lastModified: string;
@@ -429,10 +540,18 @@ declare const OrganizationModelSchema: z.ZodObject<{
             version: 1;
             lastModified: string;
         } | undefined;
+        ontology?: {
+            version: 1;
+            lastModified: string;
+        } | undefined;
         resources?: {
             version: 1;
             lastModified: string;
         } | undefined;
+        topology?: {
+            version: 1;
+            lastModified: string;
+        } | undefined;
         actions?: {
             version: 1;
             lastModified: string;
@@ -580,18 +699,132 @@ declare const OrganizationModelSchema: z.ZodObject<{
         }, z.core.$strip>>>;
     }, z.core.$strip>>>>;
     systems: z.ZodDefault<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodType<SystemEntry, unknown, z.core.$ZodTypeInternals<SystemEntry, unknown>>>>>;
+    ontology: z.ZodDefault<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>>>;
     resources: z.ZodDefault<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[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";
             active: "active";
             archived: "archived";
         }>;
+        ontology: z.ZodOptional<z.ZodObject<{
+            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>>;
+            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">;
-        actionKey: z.ZodOptional<z.ZodString>;
         emits: z.ZodOptional<z.ZodArray<z.ZodObject<{
             eventKey: z.ZodString;
             label: z.ZodString;
@@ -608,12 +841,35 @@ 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";
             active: "active";
             archived: "archived";
         }>;
+        ontology: z.ZodOptional<z.ZodObject<{
+            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>>;
+            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";
@@ -662,24 +918,70 @@ 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";
             active: "active";
             archived: "archived";
         }>;
+        ontology: z.ZodOptional<z.ZodObject<{
+            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>>;
+            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;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
         ownerRoleId: z.ZodOptional<z.ZodString>;
         status: z.ZodEnum<{
             deprecated: "deprecated";
             active: "active";
             archived: "archived";
         }>;
+        ontology: z.ZodOptional<z.ZodObject<{
+            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>>;
+            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";
@@ -691,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;
@@ -824,80 +1189,76 @@ declare const OrganizationModelSchema: z.ZodObject<{
         title: z.ZodString;
         summary: 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]>>;
         externalUrl: z.ZodOptional<z.ZodString>;
+        sourceFilePath: z.ZodOptional<z.ZodString>;
         body: z.ZodString;
         links: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodUnion<readonly [z.ZodObject<{
             target: z.ZodObject<{
                 kind: z.ZodEnum<{
+                    knowledge: "knowledge";
                     system: "system";
                     action: "action";
-                    knowledge: "knowledge";
+                    ontology: "ontology";
                     role: "role";
                     goal: "goal";
                     stage: "stage";
@@ -909,10 +1270,10 @@ declare const OrganizationModelSchema: z.ZodObject<{
                 id: z.ZodString;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
-            nodeId: z.ZodString;
+            nodeId: z.ZodUnion<readonly [z.ZodString, z.ZodTemplateLiteral<`ontology:${string}`>]>;
         }, z.core.$strip>]>, z.ZodTransform<{
             target: {
-                kind: "system" | "action" | "knowledge" | "role" | "goal" | "stage" | "resource" | "customer-segment" | "offering" | "content-node";
+                kind: "knowledge" | "system" | "action" | "ontology" | "role" | "goal" | "stage" | "resource" | "customer-segment" | "offering" | "content-node";
                 id: string;
             };
             nodeId: string;
@@ -920,7 +1281,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             nodeId: string;
         } | {
             target: {
-                kind: "system" | "action" | "knowledge" | "role" | "goal" | "stage" | "resource" | "customer-segment" | "offering" | "content-node";
+                kind: "knowledge" | "system" | "action" | "ontology" | "role" | "goal" | "stage" | "resource" | "customer-segment" | "offering" | "content-node";
                 id: string;
             };
         }>>>>;
@@ -933,8 +1294,8 @@ 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. */
- | 'content-node';
-type OrganizationGraphEdgeKind = 'contains' | 'references' | 'maps_to' | 'uses' | 'governs' | 'links' | 'affects' | 'emits' | 'originates_from' | 'triggers' | 'applies_to' | 'effects';
+ | 'ontology' | 'content-node';
+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;
@@ -944,6 +1305,7 @@ interface OrganizationGraphNode {
     description?: string;
     icon?: OrganizationModelIconToken;
     enabled?: boolean;
+    ontologyKind?: string;
     resourceType?: 'workflow' | 'agent' | 'trigger' | 'integration' | 'external' | 'human_checkpoint' | 'script';
 }
 interface OrganizationGraphEdge {
@@ -1008,7 +1370,7 @@ declare function governs(graph: OrganizationGraph, nodeId: string): string[];
  */
 declare function governedBy(graph: OrganizationGraph, nodeId: string): string[];
 /** The recognized mount axes for Knowledge Map paths. */
-type KnowledgeMount = 'by-system' | 'by-kind' | 'by-owner' | 'graph' | 'node';
+type KnowledgeMount = 'by-system' | 'by-ontology' | 'by-kind' | 'by-owner' | 'graph' | 'node';
 /**
  * The result of parsing a Knowledge Map path string.
  *
@@ -1016,6 +1378,7 @@ type KnowledgeMount = 'by-system' | 'by-kind' | 'by-owner' | 'graph' | 'node';
  *
  * Per-mount arg arrays:
  * - `by-system`:  `[systemId]`   (e.g. `['sales.crm']`)
+ * - `by-ontology`:`[ontologyId]` (e.g. `['sales.crm:object/deal']`)
  * - `by-kind`:    `[kind]`       (e.g. `['playbook']`)
  * - `by-owner`:   `[ownerId]`    (e.g. `['role.ops-lead']`)
  * - `graph`:      `[nodeId, verb]` where verb is `'governs'` or `'governed-by'`
@@ -1030,6 +1393,7 @@ interface ParsedKnowledgePath {
  *
  * Supported path patterns:
  *   `/by-system/<systemId>`           -> `{ mount: 'by-system', args: ['<systemId>'] }`
+ *   `/by-ontology/<ontologyId>`       -> `{ mount: 'by-ontology', args: ['<ontologyId>'] }`
  *   `/by-kind/<kind>`                 → `{ mount: 'by-kind',    args: ['<kind>'] }`
  *   `/by-owner/<ownerId>`             → `{ mount: 'by-owner',   args: ['<ownerId>'] }`
  *   `/graph/<nodeId>/governs`         → `{ mount: 'graph',      args: ['<nodeId>', 'governs'] }`