@x12i/memorix-metadata 3.0.3 → 3.2.0

package/dist/topology.js

@@ -0,0 +1,376 @@
+/**
+ * Effective metadata topology — pure projection of concrete connections.
+ *
+ * Author relationships on abstracts; consume OT↔OT edges from this projection.
+ * Sources/streams feed object types. Agent services declare abstract ports
+ * (authored service→abstract edges). Services also appear on OT neighborhoods
+ * when a pipeline invokes them and a mapping on the same pipeline lands on an OT.
+ */
+import { resolveAbstractBindings, resolveAbstractBindingsFromPack, } from "./abstracts.js";
+import { foldLegacyAbstractBindings } from "./fold-bindings.js";
+import { resolveSourceStreams } from "./streams.js";
+function nodeId(kind, entityId) {
+    return `${kind}:${entityId}`;
+}
+function displayName(def, fallback) {
+    if (typeof def.name === "string" && def.name.trim())
+        return def.name.trim();
+    if (typeof def.title === "string" && def.title.trim())
+        return def.title.trim();
+    return fallback;
+}
+function pushNode(nodes, kind, entityId, name) {
+    const id = nodeId(kind, entityId);
+    if (!nodes.has(id)) {
+        nodes.set(id, { id, kind, entityId, name: name ?? entityId });
+    }
+    return id;
+}
+function pushEdge(edges, seen, from, to, kind, via) {
+    const viaKey = via
+        ? `:${via.relationshipDefinitionId ?? ""}:${via.pipelineId ?? ""}:${via.mappingId ?? ""}:${via.streamId ?? ""}:${via.direction ?? ""}`
+        : "";
+    const id = `${from}->${to}:${kind}${viaKey}`;
+    if (seen.has(id))
+        return;
+    seen.add(id);
+    edges.push(via ? { id, from, to, kind, via } : { id, from, to, kind });
+}
+function isMetadataPack(input) {
+    return (!!input &&
+        typeof input === "object" &&
+        input.format === "memorix-metadata/1" &&
+        Array.isArray(input.agents));
+}
+function isEffectiveResult(input) {
+    return (!!input &&
+        typeof input === "object" &&
+        "effective" in input &&
+        "ok" in input &&
+        Array.isArray(input.effective));
+}
+function emptyPack(agentId) {
+    return {
+        format: "memorix-metadata/1",
+        agentId,
+        agents: [],
+        objectTypes: [],
+        abstractTypes: [],
+        abstractBindings: [],
+        relationshipDefinitions: [],
+        mappings: [],
+        views: [],
+        writes: [],
+        sources: [],
+        services: [],
+        pipelines: [],
+        schedules: [],
+        kindDeclarations: [],
+        extensions: {},
+    };
+}
+/** Rebuild a pack from a flat effective definition array (for entry-only callers). */
+export function packFromEffectiveDefinitions(entries, agentId = "effective") {
+    const pack = emptyPack(agentId);
+    const bucket = (kind) => {
+        switch (kind) {
+            case "agents":
+                return pack.agents;
+            case "object-types":
+                return pack.objectTypes;
+            case "abstract-types":
+                return pack.abstractTypes;
+            case "relationship-definitions":
+                return pack.relationshipDefinitions;
+            case "mappings":
+                return pack.mappings;
+            case "views":
+                return pack.views;
+            case "writes":
+                return pack.writes;
+            case "sources":
+                return pack.sources;
+            case "services":
+                return pack.services;
+            case "pipelines":
+                return pack.pipelines;
+            case "schedules":
+                return pack.schedules;
+            case "kind-declarations":
+                return pack.kindDeclarations;
+            default:
+                return [];
+        }
+    };
+    for (const e of entries) {
+        const def = { ...(e.definition ?? {}), id: e.id };
+        const list = bucket(e.kind);
+        if (list)
+            list.push(def);
+    }
+    if (!pack.agents.some((a) => a.id === agentId)) {
+        pack.agents.push({ id: agentId, name: agentId, parentId: null });
+    }
+    return pack;
+}
+function resolvePackAndAbstracts(input) {
+    if (isMetadataPack(input)) {
+        const abstracts = resolveAbstractBindingsFromPack(input);
+        return { pack: input, abstracts, ok: abstracts.ok, issues: abstracts.issues };
+    }
+    if (isEffectiveResult(input)) {
+        if (input.effectivePack) {
+            const abstracts = resolveAbstractBindings(input);
+            return {
+                pack: input.effectivePack,
+                abstracts,
+                ok: input.ok && abstracts.ok,
+                issues: [
+                    ...input.issues.map((i) => ({ code: i.code, message: i.message })),
+                    ...abstracts.issues,
+                ],
+            };
+        }
+        if (input.effective.length > 0) {
+            const pack = packFromEffectiveDefinitions(input.effective, input.selectedAgentIds[0] ?? "effective");
+            const abstracts = resolveAbstractBindingsFromPack(pack);
+            return {
+                pack,
+                abstracts,
+                ok: input.ok && abstracts.ok,
+                issues: [
+                    ...input.issues.map((i) => ({ code: i.code, message: i.message })),
+                    ...abstracts.issues,
+                ],
+            };
+        }
+        return {
+            pack: null,
+            abstracts: {
+                ok: false,
+                issues: [],
+                plans: [],
+                relationshipExpansions: [],
+                identityModel: {
+                    abstractsMaterializeRecords: false,
+                    abstractsHaveCollections: false,
+                    concreteRecordIdRetained: true,
+                },
+            },
+            ok: false,
+            issues: [{ code: "TOPO-EMPTY", message: "No effective metadata to project" }],
+        };
+    }
+    // EffectiveDefinition[]
+    const entries = input;
+    const pack = packFromEffectiveDefinitions(entries);
+    const abstracts = resolveAbstractBindingsFromPack(pack);
+    return { pack, abstracts, ok: abstracts.ok, issues: abstracts.issues };
+}
+function memberObjectTypes(abs) {
+    return [...new Set((abs.members ?? []).map((m) => m.objectType).filter(Boolean))];
+}
+/**
+ * Build a resolved graph of effective connections over metadata.
+ * No new authoring kinds — pure projection from pack / effective result.
+ */
+export function buildEffectiveMetadataTopology(input) {
+    const { pack, abstracts, ok, issues } = resolvePackAndAbstracts(input);
+    if (!pack) {
+        return { ok: false, nodes: [], edges: [], issues };
+    }
+    foldLegacyAbstractBindings(pack);
+    const nodes = new Map();
+    const edges = [];
+    const seen = new Set();
+    // --- Agents ---
+    for (const a of pack.agents) {
+        pushNode(nodes, "agents", a.id, a.name ?? a.id);
+    }
+    // --- Object types ---
+    for (const ot of pack.objectTypes) {
+        pushNode(nodes, "object-types", ot.id, ot.name ?? ot.id);
+    }
+    // --- Abstracts + member edges (sole membership source of truth) ---
+    for (const abs of pack.abstractTypes) {
+        pushNode(nodes, "abstract-types", abs.id, abs.name ?? abs.id);
+        for (const m of memberObjectTypes(abs)) {
+            pushNode(nodes, "object-types", m);
+            pushEdge(edges, seen, nodeId("abstract-types", abs.id), nodeId("object-types", m), "member");
+        }
+    }
+    // --- Relationship defs (abstract endpoints) + projected OT↔OT ---
+    for (const rel of pack.relationshipDefinitions) {
+        pushNode(nodes, "relationship-definitions", rel.id, rel.name ?? rel.id);
+        const fromAbs = rel.from?.abstractType?.trim();
+        const toAbs = rel.to?.abstractType?.trim();
+        if (fromAbs) {
+            pushNode(nodes, "abstract-types", fromAbs);
+            pushEdge(edges, seen, nodeId("relationship-definitions", rel.id), nodeId("abstract-types", fromAbs), "from");
+        }
+        if (toAbs) {
+            pushNode(nodes, "abstract-types", toAbs);
+            pushEdge(edges, seen, nodeId("relationship-definitions", rel.id), nodeId("abstract-types", toAbs), "to");
+        }
+    }
+    for (const exp of abstracts.relationshipExpansions) {
+        for (const combo of exp.candidateCombinations) {
+            pushNode(nodes, "object-types", combo.fromObjectType);
+            pushNode(nodes, "object-types", combo.toObjectType);
+            pushEdge(edges, seen, nodeId("object-types", combo.fromObjectType), nodeId("object-types", combo.toObjectType), "related", {
+                relationshipDefinitionId: exp.relationshipId,
+                direction: "from-to",
+            });
+        }
+    }
+    // --- Mappings ---
+    const mappingById = new Map();
+    for (const m of pack.mappings) {
+        mappingById.set(m.id, m);
+        pushNode(nodes, "mappings", m.id, m.id);
+        if (m.objectType?.trim()) {
+            pushNode(nodes, "object-types", m.objectType.trim());
+        }
+    }
+    // --- Connector instances (metadata kind `sources`) + streams ---
+    // The connector *package* id lives on the instance (`connectorRef`); it is not
+    // a peer topology node. Operators manage one concept: installed connectors.
+    for (const source of pack.sources) {
+        const sourceNode = pushNode(nodes, "sources", source.id, source.name ?? source.id);
+        const streams = resolveSourceStreams(source);
+        const streamFed = new Set();
+        for (const stream of streams) {
+            const streamEntityId = `${source.id}/${stream.streamId}`;
+            const streamNode = pushNode(nodes, "streams", streamEntityId, stream.name ?? stream.endpoint ?? stream.streamId);
+            pushEdge(edges, seen, sourceNode, streamNode, "stream");
+            const ot = stream.objectType?.trim();
+            if (ot) {
+                streamFed.add(ot);
+                pushNode(nodes, "object-types", ot);
+                pushEdge(edges, seen, streamNode, nodeId("object-types", ot), "feeds", {
+                    streamId: stream.streamId,
+                });
+            }
+        }
+        // Aggregate source→OT feeds only when no stream already covers that OT.
+        const routeOts = new Set();
+        for (const r of source.routes ?? []) {
+            if (r.objectType?.trim())
+                routeOts.add(r.objectType.trim());
+        }
+        for (const s of source.streams ?? []) {
+            if (s.objectType?.trim())
+                routeOts.add(s.objectType.trim());
+        }
+        for (const ot of routeOts) {
+            if (streamFed.has(ot))
+                continue;
+            pushNode(nodes, "object-types", ot);
+            pushEdge(edges, seen, sourceNode, nodeId("object-types", ot), "feeds");
+        }
+    }
+    // --- Services (authored abstract ports + pipeline-derived OT transforms) ---
+    for (const svc of pack.services) {
+        pushNode(nodes, "services", svc.id, svc.name ?? svc.id);
+        const ports = [...(svc.inputs ?? []), ...(svc.outputs ?? [])];
+        const seenAbs = new Set();
+        for (const port of ports) {
+            const abs = port.abstractType?.trim();
+            if (!abs || seenAbs.has(abs))
+                continue;
+            seenAbs.add(abs);
+            pushNode(nodes, "abstract-types", abs);
+            pushEdge(edges, seen, nodeId("services", svc.id), nodeId("abstract-types", abs), "transforms", { serviceId: svc.id });
+        }
+    }
+    // --- Pipelines: step edges + derived service→OT transforms ---
+    for (const pipeline of pack.pipelines) {
+        pushNode(nodes, "pipelines", pipeline.id, pipeline.name ?? pipeline.id);
+        const serviceIds = new Set();
+        const mappingIds = new Set();
+        for (const step of pipeline.steps ?? []) {
+            const stepKind = step.kind?.trim() || "step";
+            if (step.sourceId?.trim()) {
+                pushNode(nodes, "sources", step.sourceId.trim());
+                pushEdge(edges, seen, nodeId("pipelines", pipeline.id), nodeId("sources", step.sourceId.trim()), stepKind, { pipelineId: pipeline.id, stepId: step.id });
+            }
+            if (step.serviceId?.trim()) {
+                serviceIds.add(step.serviceId.trim());
+                pushNode(nodes, "services", step.serviceId.trim());
+                pushEdge(edges, seen, nodeId("pipelines", pipeline.id), nodeId("services", step.serviceId.trim()), stepKind, { pipelineId: pipeline.id, stepId: step.id });
+            }
+            if (step.mappingId?.trim()) {
+                mappingIds.add(step.mappingId.trim());
+                pushNode(nodes, "mappings", step.mappingId.trim());
+                pushEdge(edges, seen, nodeId("pipelines", pipeline.id), nodeId("mappings", step.mappingId.trim()), stepKind, { pipelineId: pipeline.id, stepId: step.id });
+            }
+            const target = step.target;
+            if (target?.kind === "service" && target.serviceId?.trim()) {
+                serviceIds.add(target.serviceId.trim());
+                pushNode(nodes, "services", target.serviceId.trim());
+                pushEdge(edges, seen, nodeId("pipelines", pipeline.id), nodeId("services", target.serviceId.trim()), stepKind, { pipelineId: pipeline.id, stepId: step.id });
+            }
+            if (target?.kind === "connector" && target.sourceId?.trim()) {
+                pushNode(nodes, "sources", target.sourceId.trim());
+                pushEdge(edges, seen, nodeId("pipelines", pipeline.id), nodeId("sources", target.sourceId.trim()), stepKind, { pipelineId: pipeline.id, stepId: step.id });
+            }
+            if (target?.kind === "pipeline" && target.pipelineId?.trim()) {
+                pushNode(nodes, "pipelines", target.pipelineId.trim());
+                pushEdge(edges, seen, nodeId("pipelines", pipeline.id), nodeId("pipelines", target.pipelineId.trim()), "run-pipeline", { pipelineId: pipeline.id, stepId: step.id });
+            }
+            if ((step.kind === "run-pipeline" ||
+                step.kind === "pipeline" ||
+                step.kind === "call-pipeline") &&
+                step.pipelineId?.trim()) {
+                pushNode(nodes, "pipelines", step.pipelineId.trim());
+                pushEdge(edges, seen, nodeId("pipelines", pipeline.id), nodeId("pipelines", step.pipelineId.trim()), "run-pipeline", { pipelineId: pipeline.id, stepId: step.id });
+            }
+            if ((target?.kind === "runx" && target.capabilityId?.trim()) ||
+                (step.kind === "runx" && step.capabilityId?.trim())) {
+                const cap = target?.capabilityId?.trim() || step.capabilityId?.trim() || "";
+                // runx capabilities are external; use services overlay for topology discovery.
+                pushNode(nodes, "services", `runx:${cap}`, `runx:${cap}`);
+                pushEdge(edges, seen, nodeId("pipelines", pipeline.id), nodeId("services", `runx:${cap}`), "runx", { pipelineId: pipeline.id, stepId: step.id });
+            }
+        }
+        // Derived transforms: service on pipeline + mapping on same pipeline → OT
+        for (const serviceId of serviceIds) {
+            for (const mappingId of mappingIds) {
+                const mapping = mappingById.get(mappingId);
+                const ot = mapping?.objectType?.trim();
+                if (!ot)
+                    continue;
+                pushNode(nodes, "object-types", ot);
+                pushEdge(edges, seen, nodeId("services", serviceId), nodeId("object-types", ot), "transforms", { pipelineId: pipeline.id, mappingId });
+            }
+        }
+    }
+    // --- Views / writes / schedules / kind-declarations ---
+    for (const v of pack.views) {
+        pushNode(nodes, "views", v.id, displayName(v, v.id));
+    }
+    for (const w of pack.writes) {
+        pushNode(nodes, "writes", w.id, w.id);
+    }
+    for (const s of pack.schedules) {
+        pushNode(nodes, "schedules", s.id, s.id);
+        if (s.pipelineId?.trim()) {
+            pushNode(nodes, "pipelines", s.pipelineId.trim());
+            pushEdge(edges, seen, nodeId("schedules", s.id), nodeId("pipelines", s.pipelineId.trim()), "runs", { pipelineId: s.pipelineId.trim() });
+        }
+    }
+    for (const k of pack.kindDeclarations ?? []) {
+        pushNode(nodes, "kind-declarations", k.id, k.name ?? k.id);
+    }
+    // Drop edges whose endpoints vanished (should not happen after pushNode)
+    const pruned = edges.filter((e) => nodes.has(e.from) && nodes.has(e.to));
+    const sortedNodes = [...nodes.values()].sort((a, b) => a.id.localeCompare(b.id));
+    const sortedEdges = pruned.sort((a, b) => a.id.localeCompare(b.id));
+    return {
+        ok,
+        nodes: sortedNodes,
+        edges: sortedEdges,
+        issues,
+    };
+}
+//# sourceMappingURL=topology.js.map

package/dist/topology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology.js","sourceRoot":"","sources":["../src/topology.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -22,7 +22,10 @@ export type AgentDefinition = {
 export declare function parentIdsOf(agent: AgentDefinition | null | undefined): string[];
 export type ContentTypeSpec = {
     id: string;
+    /** When true, subjects of this object type should have this content type. */
     required?: boolean;
+    /** Why this content type is required; set when `required` is true. */
+    requiredReason?: string;
     notes?: string;
     retention?: string;
     discriminator?: {
@@ -38,6 +41,13 @@ export type ObjectTypeFieldSpec = {
     valueType: string;
     /** Defaults to applying across all content types when omitted. */
     contentType?: string;
+    /**
+     * Target object type when this field holds a record id (or array of ids).
+     * Required for entity-valued fields (`recordId` / array of recordIds).
+     */
+    refersTo?: {
+        objectType: string;
+    };
 };
 export type ObjectTypeDefinition = {
     id: string;
@@ -57,16 +67,6 @@ export type AbstractPropertyDefinition = {
     required?: boolean;
     description?: string;
 };
-/**
- * Metadata-only abstract type. Never materializes a collection or abstract recordId.
- */
-export type AbstractTypeDefinition = {
-    id: string;
-    name: string;
-    meaning: string;
-    category: string;
-    properties?: AbstractPropertyDefinition[];
-};
 /**
  * How one abstract property is satisfied for one concrete union member.
  * Direct: propertyPath (+ compatible concreteValueType).
@@ -97,9 +97,24 @@ export type AbstractMemberBinding = {
     properties?: AbstractPropertyBinding[];
 };
 /**
- * Binding of an abstract to one or more concrete object types (a union).
- * Prefer `members` for property-level detail; `concreteObjectTypes` remains valid
- * for membership-only unions (e.g. People = employees ∪ contractors).
+ * Metadata-only abstract type. Never materializes a collection or abstract recordId.
+ * Owns membership and property projection (`members`) — no separate binding kind.
+ */
+export type AbstractTypeDefinition = {
+    id: string;
+    name: string;
+    meaning: string;
+    category: string;
+    properties?: AbstractPropertyDefinition[];
+    /** Concrete object types that participate + how each fills abstract properties. */
+    members?: AbstractMemberBinding[];
+    /** True when more than one concrete object type participates. */
+    union?: boolean;
+    notes?: string;
+};
+/**
+ * @deprecated Legacy separate binding documents. Folded into
+ * `AbstractTypeDefinition.members` by `foldLegacyAbstractBindings`.
  */
 export type AbstractBindingDefinition = {
     id: string;
@@ -162,7 +177,12 @@ export type ViewDefinition = {
     id: string;
     kind: string;
     title?: string;
+    /**
+     * @deprecated Concrete objectType binding is forbidden — views are abstract-only.
+     * Retained on the type only for migration diagnostics; validation rejects it.
+     */
     objectType?: string;
+    /** Required: views speak abstract language; apps stay connector-agnostic. */
     abstractType?: string;
     relationshipDefinitionId?: string;
     direction?: string;
@@ -261,10 +281,72 @@ export type SourceDefinition = {
         defaultPageSize?: number;
     };
     connectorRef?: string;
+    /** Connector package version for remote host / registry resolve. */
+    connectorVersion?: string;
+    /**
+     * Remote connector host base URL (FR-040).
+     * When set, Memory pulls via `createRemoteConnectorHost` instead of in-process.
+     */
+    hostBaseUrl?: string;
+    /**
+     * Logical host key resolved through the platform remote-host map
+     * (e.g. `mgc-source` → `MGC_SOURCE_SERVICE_URL`).
+     */
+    connectorHostKey?: string;
+    /**
+     * When true, pull MUST use a remote host (hostBaseUrl / host key / default).
+     * Never falls through to an in-process adapter.
+     */
+    remoteHosting?: boolean;
+    /**
+     * Authoritative direction when set (MGC catalog / pack). Prefer over capability inference.
+     * Source packs use `"source"`; targets use DestinationDefinition.role.
+     */
+    role?: "source" | "target";
 };
+/**
+ * Outbound destination for target connectors (generic connectors deliver path).
+ * Parallel to SourceDefinition: credentialRef only; durable receipts live in Memory.
+ */
+export type DestinationDefinition = {
+    id: string;
+    name: string;
+    kind: string;
+    connectorRef: string;
+    connectorVersion?: string;
+    credentialRef?: string;
+    /** Remote target host base URL (POST /v1/deliver). */
+    hostBaseUrl?: string;
+    connectorHostKey?: string;
+    /** Authoritative package direction (always `"target"` for destinations when set). */
+    role?: "target";
+    /** Optional mapping / stream labels for the deliver envelope. */
+    config?: Record<string, unknown>;
+};
+/**
+ * `agent` (default): subject I/O speaks only abstracts.
+ * `connector`: connector-adjacent pull/promote workers — exempt from the
+ * abstract-port law; may use concrete Memory surfaces (`raw`).
+ */
+export type ServiceRole = "agent" | "connector";
 export type ServiceIoPort = {
     id: string;
-    /** Logical schema / type reference — not a runtime payload. */
+    /**
+     * Abstract type this port speaks. Required on subject-data ports for
+     * `role: "agent"` services (default). Runtime may resolve to concrete members.
+     */
+    abstractType?: string;
+    /** Optional property / view path on the abstract. */
+    path?: string;
+    /**
+     * Non-subject control port (triggerReason, sourceId, cursors, …).
+     * Exempt from abstractType requirement on agent services.
+     */
+    control?: boolean;
+    /**
+     * Logical schema / view reference — not a runtime payload.
+     * Must not be `memorix-record/{contentType}` on agent services; prefer abstractType.
+     */
     schemaRef?: string;
     description?: string;
 };
@@ -275,13 +357,20 @@ export type ServiceInvocation = {
 /**
  * Declarative service contract: capabilities + logical I/O + invocation shape.
  * Forbidden: secret values, deployment/runtime state.
+ * Agent services speak only abstracts (hard rule); connector-role workers may
+ * land concrete raw via sources/connectors.
  */
 /** Opt-in Memorix surfaces a called service may use mid-invocation. */
-export type MemorixServiceAccess = "explore" | "checkpoints";
+export type MemorixServiceAccess = "explore" | "checkpoints" | "raw";
 export type ServiceDefinition = {
     id: string;
     name: string;
     description?: string;
+    /**
+     * Default `agent`. Use `connector` for pull/promote workers that speak
+     * concrete Memory / source ids — not agent vocabulary.
+     */
+    role?: ServiceRole;
     capabilities: string[];
     inputs?: ServiceIoPort[];
     outputs?: ServiceIoPort[];
@@ -289,14 +378,51 @@ export type ServiceDefinition = {
     /**
      * When set, pipeline invoke injects a `memorix` callback context so the
      * worker can call Explore and/or Source checkpoints mid-work.
+     * `raw` is allowed only when `role: "connector"`.
      */
     memorixAccess?: MemorixServiceAccess[];
 };
+export type PipelineStepTarget = {
+    kind: "service";
+    serviceId: string;
+} | {
+    kind: "ai-service";
+    aiServiceType: string;
+    itemId: string;
+} | {
+    kind: "connector";
+    connectorId: string;
+    sourceId: string;
+} | {
+    kind: "destination";
+    connectorId: string;
+    destinationId: string;
+} | {
+    kind: "pipeline";
+    pipelineId: string;
+} | {
+    kind: "runx";
+    capabilityId: string;
+};
 export type PipelineStep = {
     id: string;
     kind: string;
     sourceId?: string;
     serviceId?: string;
+    /** Nested pipeline id when kind is run-pipeline / pipeline. */
+    pipelineId?: string;
+    /** Runx capability id when kind is runx. */
+    capabilityId?: string;
+    connectorId?: string;
+    /** Unified invoke target (service | ai-service | connector | pipeline | runx). */
+    target?: PipelineStepTarget;
+    /** Step-level AI binding (alternative to service pack aiService). */
+    aiService?: {
+        aiServiceType?: string;
+        itemId?: string;
+        endpointEnv?: string;
+        endpoint?: string;
+    };
     contentType?: string;
     /** Completion / step execution policy belongs on the pipeline, not on mappings. */
     completionPolicy?: JsonObject;
@@ -335,7 +461,11 @@ export type MetadataPack = {
     agents: AgentDefinition[];
     objectTypes: ObjectTypeDefinition[];
     abstractTypes: AbstractTypeDefinition[];
-    abstractBindings: AbstractBindingDefinition[];
+    /**
+     * @deprecated Always empty after normalize/fold. Kept optional for load compat.
+     * Membership lives on `abstractTypes[].members`.
+     */
+    abstractBindings?: AbstractBindingDefinition[];
     relationshipDefinitions: RelationshipDefinition[];
     mappings: MappingDefinition[];
     views: ViewDefinition[];