@x12i/memorix-metadata 3.0.2 → 3.1.0

package/dist/topology.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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 type { EffectiveDefinition, EffectiveMetadataResult } from "./resolve.js";
+import type { MetadataPack } from "./types.js";
+export type TopologyNodeKind = "agents" | "object-types" | "abstract-types" | "relationship-definitions" | "sources" | "streams" | "connectors" | "services" | "pipelines" | "mappings" | "views" | "writes" | "schedules" | "kind-declarations";
+export type TopologyEdgeKind = "abstract" | "member" | "from" | "to" | "related" | "feeds" | "uses" | "stream" | "transforms" | "runs" | string;
+export type TopologyEdgeVia = {
+    relationshipDefinitionId?: string;
+    direction?: "from-to" | "to-from";
+    pipelineId?: string;
+    mappingId?: string;
+    streamId?: string;
+    stepId?: string;
+    /** Authored service→abstract port binding. */
+    serviceId?: string;
+};
+export type TopologyNode = {
+    id: string;
+    kind: TopologyNodeKind | string;
+    entityId: string;
+    name?: string;
+};
+export type TopologyEdge = {
+    id: string;
+    from: string;
+    to: string;
+    kind: TopologyEdgeKind;
+    via?: TopologyEdgeVia;
+};
+export type EffectiveMetadataTopology = {
+    ok: boolean;
+    nodes: TopologyNode[];
+    edges: TopologyEdge[];
+    issues: Array<{
+        code: string;
+        message: string;
+    }>;
+};
+/** Rebuild a pack from a flat effective definition array (for entry-only callers). */
+export declare function packFromEffectiveDefinitions(entries: EffectiveDefinition[], agentId?: string): MetadataPack;
+/**
+ * Build a resolved graph of effective connections over metadata.
+ * No new authoring kinds — pure projection from pack / effective result.
+ */
+export declare function buildEffectiveMetadataTopology(input: EffectiveMetadataResult | MetadataPack | EffectiveDefinition[]): EffectiveMetadataTopology;
+//# sourceMappingURL=topology.d.ts.map

package/dist/topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology.d.ts","sourceRoot":"","sources":["../src/topology.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEjF,OAAO,KAAK,EAGV,YAAY,EAOb,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,cAAc,GACd,gBAAgB,GAChB,0BAA0B,GAC1B,SAAS,GACT,SAAS,GACT,YAAY,GACZ,UAAU,GACV,WAAW,GACX,UAAU,GACV,OAAO,GACP,QAAQ,GACR,WAAW,GACX,mBAAmB,CAAC;AAExB,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,QAAQ,GACR,MAAM,GACN,IAAI,GACJ,SAAS,GACT,OAAO,GACP,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG;IAC5B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,GAAG,CAAC,EAAE,eAAe,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD,CAAC;AAkFF,sFAAsF;AACtF,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mBAAmB,EAAE,EAC9B,OAAO,SAAc,GACpB,YAAY,CA0Cd;AAuED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,uBAAuB,GAAG,YAAY,GAAG,mBAAmB,EAAE,GACpE,yBAAyB,CA+P3B"}

package/dist/topology.js

@@ -0,0 +1,348 @@
+/**
+ * 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 });
+            }
+        }
+        // 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":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,uBAAuB,EACvB,+BAA+B,GAEhC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AA2EpD,SAAS,MAAM,CAAC,IAAY,EAAE,QAAgB;IAC5C,OAAO,GAAG,IAAI,IAAI,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,WAAW,CAAC,GAA4B,EAAE,QAAgB;IACjE,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5E,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC/E,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CACf,KAAgC,EAChC,IAAY,EACZ,QAAgB,EAChB,IAAa;IAEb,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACnB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,QAAQ,CACf,KAAqB,EACrB,IAAiB,EACjB,IAAY,EACZ,EAAU,EACV,IAAsB,EACtB,GAAqB;IAErB,MAAM,MAAM,GAAG,GAAG;QAChB,CAAC,CAAC,IAAI,GAAG,CAAC,wBAAwB,IAAI,EAAE,IAAI,GAAG,CAAC,UAAU,IAAI,EAAE,IAAI,GAAG,CAAC,SAAS,IAAI,EAAE,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,IAAI,GAAG,CAAC,SAAS,IAAI,EAAE,EAAE;QACtI,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,EAAE,GAAG,GAAG,IAAI,KAAK,EAAE,IAAI,IAAI,GAAG,MAAM,EAAE,CAAC;IAC7C,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO;IACzB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACb,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,CACL,CAAC,CAAC,KAAK;QACP,OAAO,KAAK,KAAK,QAAQ;QACxB,KAAsB,CAAC,MAAM,KAAK,oBAAoB;QACvD,KAAK,CAAC,OAAO,CAAE,KAAsB,CAAC,MAAM,CAAC,CAC9C,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,CACL,CAAC,CAAC,KAAK;QACP,OAAO,KAAK,KAAK,QAAQ;QACzB,WAAW,IAAK,KAAgB;QAChC,IAAI,IAAK,KAAgB;QACzB,KAAK,CAAC,OAAO,CAAE,KAAiC,CAAC,SAAS,CAAC,CAC5D,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,OAAO;QACL,MAAM,EAAE,oBAAoB;QAC5B,OAAO;QACP,MAAM,EAAE,EAAE;QACV,WAAW,EAAE,EAAE;QACf,aAAa,EAAE,EAAE;QACjB,gBAAgB,EAAE,EAAE;QACpB,uBAAuB,EAAE,EAAE;QAC3B,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,EAAE;QACb,gBAAgB,EAAE,EAAE;QACpB,UAAU,EAAE,EAAE;KACf,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,4BAA4B,CAC1C,OAA8B,EAC9B,OAAO,GAAG,WAAW;IAErB,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAmD,EAAE;QAC/E,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,MAAyD,CAAC;YACxE,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,WAA8D,CAAC;YAC7E,KAAK,gBAAgB;gBACnB,OAAO,IAAI,CAAC,aAAgE,CAAC;YAC/E,KAAK,0BAA0B;gBAC7B,OAAO,IAAI,CAAC,uBAA0E,CAAC;YACzF,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC,QAA2D,CAAC;YAC1E,KAAK,OAAO;gBACV,OAAO,IAAI,CAAC,KAAwD,CAAC;YACvE,KAAK,QAAQ;gBACX,OAAO,IAAI,CAAC,MAAyD,CAAC;YACxE,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,OAA0D,CAAC;YACzE,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC,QAA2D,CAAC;YAC1E,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,SAA4D,CAAC;YAC3E,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,SAA4D,CAAC;YAC3E,KAAK,mBAAmB;gBACtB,OAAO,IAAI,CAAC,gBAAmE,CAAC;YAClF;gBACE,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAA8C,CAAC;QAC9F,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAqE;IAMpG,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,+BAA+B,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;IAChF,CAAC;IAED,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;YACjD,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,aAAa;gBACzB,SAAS;gBACT,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,SAAS,CAAC,EAAE;gBAC5B,MAAM,EAAE;oBACN,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;oBAClE,GAAG,SAAS,CAAC,MAAM;iBACpB;aACF,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,4BAA4B,CACvC,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,WAAW,CACzC,CAAC;YACF,MAAM,SAAS,GAAG,+BAA+B,CAAC,IAAI,CAAC,CAAC;YACxD,OAAO;gBACL,IAAI;gBACJ,SAAS;gBACT,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,SAAS,CAAC,EAAE;gBAC5B,MAAM,EAAE;oBACN,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;oBAClE,GAAG,SAAS,CAAC,MAAM;iBACpB;aACF,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,IAAI;YACV,SAAS,EAAE;gBACT,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,EAAE;gBACT,sBAAsB,EAAE,EAAE;gBAC1B,aAAa,EAAE;oBACb,2BAA2B,EAAE,KAAK;oBAClC,wBAAwB,EAAE,KAAK;oBAC/B,wBAAwB,EAAE,IAAI;iBAC/B;aACF;YACD,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SAC9E,CAAC;IACJ,CAAC;IAED,wBAAwB;IACxB,MAAM,OAAO,GAAG,KAA8B,CAAC;IAC/C,MAAM,IAAI,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,+BAA+B,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;AACzE,CAAC;AAED,SAAS,iBAAiB,CAAC,GAA2B;IACpD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAAqE;IAErE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IACvE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IACrD,CAAC;IAED,0BAA0B,CAAC,IAAI,CAAC,CAAC;IAEjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC9C,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,iBAAiB;IACjB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,uBAAuB;IACvB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,WAAqC,EAAE,CAAC;QAC5D,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,qEAAqE;IACrE,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,aAAyC,EAAE,CAAC;QACjE,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9D,KAAK,MAAM,CAAC,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;YACnC,QAAQ,CACN,KAAK,EACL,IAAI,EACJ,MAAM,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,EAChC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,EACzB,QAAQ,CACT,CAAC;QACJ,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,uBAAmD,EAAE,CAAC;QAC3E,QAAQ,CAAC,KAAK,EAAE,0BAA0B,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,GAAG,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAC3C,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;YAC3C,QAAQ,CACN,KAAK,EACL,IAAI,EACJ,MAAM,CAAC,0BAA0B,EAAE,GAAG,CAAC,EAAE,CAAC,EAC1C,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,EACjC,MAAM,CACP,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;YACzC,QAAQ,CACN,KAAK,EACL,IAAI,EACJ,MAAM,CAAC,0BAA0B,EAAE,GAAG,CAAC,EAAE,CAAC,EAC1C,MAAM,CAAC,gBAAgB,EAAE,KAAK,CAAC,EAC/B,IAAI,CACL,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,sBAAsB,EAAE,CAAC;QACnD,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,qBAAqB,EAAE,CAAC;YAC9C,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;YACtD,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;YACpD,QAAQ,CACN,KAAK,EACL,IAAI,EACJ,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,EAC5C,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,YAAY,CAAC,EAC1C,SAAS,EACT;gBACE,wBAAwB,EAAE,GAAG,CAAC,cAAc;gBAC5C,SAAS,EAAE,SAAS;aACrB,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,MAAM,WAAW,GAAG,IAAI,GAAG,EAA6B,CAAC;IACzD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAA+B,EAAE,CAAC;QACrD,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;YACzB,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,+EAA+E;IAC/E,4EAA4E;IAC5E,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAA6B,EAAE,CAAC;QACxD,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;QAEnF,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,cAAc,GAAG,GAAG,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACzD,MAAM,UAAU,GAAG,QAAQ,CACzB,KAAK,EACL,SAAS,EACT,cAAc,EACd,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAClD,CAAC;YACF,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;YACxD,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;YACrC,IAAI,EAAE,EAAE,CAAC;gBACP,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAClB,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;gBACpC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE;oBACrE,QAAQ,EAAE,MAAM,CAAC,QAAQ;iBAC1B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,wEAAwE;QACxE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,SAAS;YAChC,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;YACpC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAA+B,EAAE,CAAC;QACvD,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;YACtC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YACvC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC;YACvC,QAAQ,CACN,KAAK,EACL,IAAI,EACJ,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,EAAE,CAAC,EAC1B,MAAM,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAC7B,YAAY,EACZ,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,CACtB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAiC,EAAE,CAAC;QAC9D,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC;YAC7C,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;gBAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;gBACjD,QAAQ,CACN,KAAK,EACL,IAAI,EACJ,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC,EAChC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EACvC,QAAQ,EACR,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAC7C,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;gBAC3B,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;gBACtC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;gBACnD,QAAQ,CACN,KAAK,EACL,IAAI,EACJ,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC,EAChC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EACzC,QAAQ,EACR,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAC7C,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;gBAC3B,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;gBACtC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;gBACnD,QAAQ,CACN,KAAK,EACL,IAAI,EACJ,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC,EAChC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,EACzC,QAAQ,EACR,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAC7C,CAAC;YACJ,CAAC;QACH,CAAC;QAED,0EAA0E;QAC1E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAC3C,MAAM,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;gBACvC,IAAI,CAAC,EAAE;oBAAE,SAAS;gBAClB,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;gBACpC,QAAQ,CACN,KAAK,EACL,IAAI,EACJ,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,EAC7B,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC,EAC1B,YAAY,EACZ,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,CACvC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,WAAW,CAAC,CAAuC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAiC,EAAE,CAAC;QACvD,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;YACzB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;YAClD,QAAQ,CACN,KAAK,EACL,IAAI,EACJ,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EACzB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,EACxC,MAAM,EACN,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CACpC,CAAC;QACJ,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,gBAAgB,IAAI,EAAE,EAAE,CAAC;QAC5C,QAAQ,CAAC,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,yEAAyE;IACzE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjF,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEpE,OAAO;QACL,EAAE;QACF,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,WAAW;QAClB,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -1,18 +1,31 @@
 /**
  * Canonical metadata document shapes (Phase 3A).
- * Agents are one kind; parentId optional; no base/concrete classification.
+ * Agents are one kind; parentIds optional; no base/concrete classification.
  */
 export type JsonObject = Record<string, unknown>;
 export type AgentDefinition = {
     id: string;
     name: string;
     description?: string;
-    /** Optional parent agent id. Null/undefined = root. */
+    /**
+     * Direct parent agent ids. Empty / omitted = root.
+     * Prefer this over parentId; values are unique and sorted when normalized.
+     */
+    parentIds?: string[];
+    /**
+     * Legacy single parent. Prefer parentIds.
+     * When both are present, parentIds wins after normalize.
+     */
     parentId?: string | null;
 };
+/** Resolve direct parent ids from an agent record (supports legacy parentId). */
+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?: {
@@ -28,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;
@@ -47,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).
@@ -87,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;
@@ -169,6 +194,13 @@ export type WriteDefinition = {
         issuer?: string;
     };
 };
+/** How Memory resumes the next pull for this route. */
+export type SourceCheckpointMethod = "cursor" | "watermark" | "fullScanHash";
+export type SourceRouteCheckpoint = {
+    method: SourceCheckpointMethod;
+    /** watermark only — path/field in provider payload or header name */
+    watermarkField?: string;
+};
 export type SourceRouteDefinition = {
     endpoint: string;
     objectType: string;
@@ -177,6 +209,45 @@ export type SourceRouteDefinition = {
     primaryKind?: string;
     modes?: Array<"context" | "knowledge">;
     pageSize?: number;
+    /** Declared checkpoint method for this route (runtime state is per-org). */
+    checkpoint?: SourceRouteCheckpoint;
+    /**
+     * Optional stable stream id. When omitted, runtime derives a compatibility
+     * identity from endpoint + objectType (FR-007 / FR-043).
+     */
+    streamId?: string;
+};
+/** Stable data-producing unit that owns independent checkpoint state (FR-007). */
+export type SourceStreamDefinition = {
+    streamId: string;
+    /** User-readable name. */
+    name?: string;
+    /** Provider operation or endpoint path. */
+    endpoint: string;
+    objectType: string;
+    dataCategory: "entity" | "event" | "knowledge" | "operational" | string;
+    identityPath?: string;
+    primaryKind?: string;
+    modes?: Array<"context" | "knowledge">;
+    pageSize?: number;
+    checkpoint?: SourceRouteCheckpoint;
+    /** True when streamId was derived from a legacy route (not authored). */
+    derivedFromRoute?: boolean;
+};
+export type SourceWorkflowStepKind = "command" | "poll" | "collect" | "control";
+/** Declarative workflow step metadata (runtime handlers live in the connector). */
+export type SourceWorkflowStepDefinition = {
+    id: string;
+    name?: string;
+    kind: SourceWorkflowStepKind;
+    dependsOn?: string[];
+    /** Provider operation label for Studio. */
+    providerOperation?: string;
+    /** Stream ids produced by this step (collect steps). */
+    streamIds?: string[];
+};
+export type SourceWorkflowDefinition = {
+    steps: SourceWorkflowStepDefinition[];
 };
 export type SourceRetentionPolicy = {
     context?: {
@@ -193,7 +264,12 @@ export type SourceDefinition = {
     /** Logical credential reference id — not a secret value. */
     credentialRef?: string;
     endpoints?: string[];
+    /** Legacy flat routes — still supported via compatibility adapter. */
     routes?: SourceRouteDefinition[];
+    /** Preferred stable streams (FR-007). When absent, derived from routes. */
+    streams?: SourceStreamDefinition[];
+    /** Ordered / dependency-based retrieval workflow (FR-006). */
+    workflow?: SourceWorkflowDefinition;
     retention?: SourceRetentionPolicy;
     pagination?: {
         style?: "cursor" | "page";
@@ -201,9 +277,30 @@ export type SourceDefinition = {
     };
     connectorRef?: string;
 };
+/**
+ * `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;
 };
@@ -214,15 +311,30 @@ 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" | "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[];
     invocation?: ServiceInvocation;
+    /**
+     * 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 PipelineStep = {
     id: string;
@@ -267,7 +379,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[];