@x12i/memorix-retrieval 1.35.0 → 1.36.0

package/dist/graphs/fallback-graph-capabilities.js

@@ -0,0 +1,243 @@
+/**
+ * Bundled entity graph capabilities when Catalox entity descriptors
+ * have not been re-seeded with a `graph` block yet.
+ */
+export const FALLBACK_ENTITY_GRAPH = {
+    assets: {
+        node: {
+            kind: "ipAddress",
+            directoryFields: ["ipAddress", "hostType", "zones"],
+            contentLenses: ["snapshot", "analysis", "decisions"],
+            ui: { icon: "server" },
+        },
+        edgeTemplates: [
+            {
+                id: "asset-topology-associated",
+                source: { kind: "associatedArray", key: "associatedTopology" },
+                edges: [
+                    {
+                        type: "containedIn",
+                        from: { source: "concept" },
+                        to: { source: "itemField", field: "cidr", kind: "cidr" },
+                        toObjectType: "subnets",
+                        toKind: "cidr",
+                        when: { itemFieldExists: "cidr" },
+                    },
+                    {
+                        type: "inZone",
+                        from: { source: "itemField", field: "cidr", kind: "cidr" },
+                        to: { source: "itemField", field: "zone", kind: "zoneName" },
+                        toObjectType: "topology-zones",
+                        toKind: "zoneName",
+                        when: { itemFieldExists: "zone" },
+                    },
+                    {
+                        type: "reachableFrom",
+                        from: {
+                            source: "itemArrayField",
+                            field: "reachableFromZones",
+                            kind: "zoneName",
+                        },
+                        to: { source: "itemField", field: "zone", kind: "zoneName" },
+                        toObjectType: "topology-zones",
+                        toKind: "zoneName",
+                        when: { itemFieldExists: "zone" },
+                    },
+                    {
+                        type: "pathBridge",
+                        from: { source: "literal", kind: "zoneName", value: "OUTSIDE" },
+                        to: { source: "itemField", field: "zone", kind: "zoneName" },
+                        toObjectType: "topology-zones",
+                        toKind: "zoneName",
+                        synthesizePath: { titleTemplate: "{from} → {to}" },
+                        when: {
+                            itemFieldExists: "zone",
+                            itemArrayIncludes: { field: "reachableFromZones", value: "OUTSIDE" },
+                        },
+                    },
+                ],
+            },
+            {
+                id: "asset-vulnerabilities-by-ip",
+                source: {
+                    kind: "queryByField",
+                    objectType: "vulnerabilities",
+                    sourcePath: "data.assetIp",
+                    targetPath: "data.assetIp",
+                    limit: 50,
+                },
+                edges: [
+                    {
+                        type: "affectsAsset",
+                        from: { source: "relatedConcept" },
+                        to: { source: "concept" },
+                        toObjectType: "vulnerabilities",
+                        toKind: "hostVulnerability",
+                        neighbor: "from",
+                    },
+                ],
+            },
+        ],
+    },
+    vulnerabilities: {
+        node: {
+            kind: "hostVulnerability",
+            directoryFields: ["assetIp", "severity", "vulnerabilityName"],
+            contentLenses: ["snapshot", "discovery", "analysis", "decisions"],
+            ui: { icon: "alert-triangle" },
+        },
+        edgeTemplates: [
+            {
+                id: "vuln-in-group",
+                source: {
+                    kind: "queryByField",
+                    objectType: "vulnerabilities-groups",
+                    sourcePath: "data.vulnerabilityName",
+                    targetPath: "data.name",
+                    limit: 5,
+                },
+                edges: [
+                    {
+                        type: "inGroup",
+                        from: { source: "concept" },
+                        to: { source: "relatedConcept" },
+                        toObjectType: "vulnerabilities-groups",
+                        toKind: "pluginId",
+                        neighbor: "to",
+                    },
+                ],
+            },
+            {
+                id: "vuln-group-by-plugin",
+                source: {
+                    kind: "queryByField",
+                    objectType: "vulnerabilities-groups",
+                    sourcePath: "data.pluginId",
+                    targetPath: "data.pluginId",
+                    limit: 5,
+                },
+                edges: [
+                    {
+                        type: "inGroup",
+                        from: { source: "concept" },
+                        to: { source: "relatedConcept" },
+                        toObjectType: "vulnerabilities-groups",
+                        toKind: "pluginId",
+                        neighbor: "to",
+                    },
+                ],
+            },
+        ],
+    },
+    subnets: {
+        node: {
+            kind: "cidr",
+            directoryFields: ["cidr", "zone"],
+            contentLenses: ["snapshot", "analysis"],
+            ui: { icon: "network" },
+        },
+    },
+    "topology-zones": {
+        node: {
+            kind: "zoneName",
+            directoryFields: ["name"],
+            contentLenses: ["snapshot", "analysis"],
+            ui: { icon: "shield" },
+        },
+    },
+    "vulnerabilities-groups": {
+        node: {
+            kind: "pluginId",
+            directoryFields: ["name", "severity", "pluginId", "cveId"],
+            contentLenses: ["snapshot", "analysis"],
+            ui: { icon: "bug" },
+        },
+    },
+};
+export const DEFAULT_ASSET_TOPOLOGY_VULNERABILITIES_GRAPH = {
+    id: "asset-topology-vulnerabilities-graph",
+    title: "Asset topology & vulnerabilities",
+    focusObjectType: "assets",
+    maxDepth: 2,
+    includeEdgeTemplates: [
+        "asset-topology-associated",
+        "asset-vulnerabilities-by-ip",
+        "vuln-in-group",
+        "vuln-group-by-plugin",
+    ],
+    tiers: [
+        {
+            id: "topology",
+            label: "Topology",
+            objectTypes: ["assets", "subnets", "topology-zones"],
+        },
+        {
+            id: "vulnerabilities",
+            label: "Vulnerabilities",
+            objectTypes: ["vulnerabilities", "vulnerabilities-groups"],
+        },
+    ],
+    nodes: [
+        { objectType: "assets", tier: "topology" },
+        { objectType: "subnets", tier: "topology" },
+        { objectType: "topology-zones", tier: "topology" },
+        { objectType: "vulnerabilities-groups", tier: "vulnerabilities" },
+        { objectType: "vulnerabilities", tier: "vulnerabilities" },
+    ],
+    directory: {
+        defaultObjectTypes: [
+            "assets",
+            "subnets",
+            "topology-zones",
+            "vulnerabilities",
+            "vulnerabilities-groups",
+        ],
+        searchFields: ["title", "identifierKey"],
+        narrativeFiltersByObjectType: {
+            assets: [
+                { key: "has-vulnerabilities", label: "Has vulnerabilities" },
+                { key: "has-no-vulnerabilities", label: "No vulnerabilities" },
+                { key: "is-triaged", label: "Is triaged" },
+                { key: "has-lateral-movement-risk", label: "Lateral movement risk" },
+                { key: "has-critical-predicted-impact", label: "Critical predicted impact" },
+                { key: "has-high-or-critical-exploitability", label: "High or critical exploitability" },
+            ],
+            vulnerabilities: [
+                { key: "has-critical-severity", label: "Critical severity" },
+                { key: "has-high-severity", label: "High severity" },
+                { key: "has-medium-severity", label: "Medium severity" },
+                { key: "has-breach-vector", label: "Breach vector" },
+            ],
+            "vulnerabilities-groups": [
+                { key: "has-critical-severity", label: "Critical severity" },
+                { key: "has-high-severity", label: "High severity" },
+                { key: "has-medium-severity", label: "Medium severity" },
+                { key: "has-low-severity", label: "Low severity" },
+            ],
+            subnets: [
+                { key: "has-assets", label: "Has assets" },
+                { key: "has-possible-paths", label: "Has possible paths" },
+            ],
+            "topology-zones": [{ key: "has-analysis", label: "Has analysis" }],
+        },
+    },
+    ui: { icon: "network", group: "network", order: 10 },
+};
+export function resolveEntityGraphCapability(objectType, fromEntity, inferred) {
+    const g = fromEntity?.graph;
+    if (g?.node?.kind) {
+        if (g.edgeTemplates?.length)
+            return g;
+        if (inferred?.edgeTemplates?.length) {
+            return {
+                ...g,
+                edgeTemplates: inferred.edgeTemplates,
+            };
+        }
+        return g;
+    }
+    if (inferred?.node?.kind)
+        return inferred;
+    return FALLBACK_ENTITY_GRAPH[objectType] ?? null;
+}
+//# sourceMappingURL=fallback-graph-capabilities.js.map

package/dist/graphs/fallback-graph-capabilities.js.map

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

package/dist/graphs/index.d.ts

@@ -0,0 +1,8 @@
+export type { JsonObject, MemorixGraphConcept, MemorixGraphConceptIdentifier, MemorixGraphContent, MemorixGraphDirectoryResult, MemorixGraphDocument, MemorixGraphEdge, MemorixGraphNode, } from "./types.js";
+export { graphLensForStorageContentType, storageContentTypeForLens, } from "./types.js";
+export { DEFAULT_ASSET_TOPOLOGY_VULNERABILITIES_GRAPH, FALLBACK_ENTITY_GRAPH, resolveEntityGraphCapability, } from "./fallback-graph-capabilities.js";
+export { listMemorixGraphDescriptors, loadMemorixGraphDescriptor, resolveMemorixGraphDescriptor, type MemorixGraphDescriptorResolution, type MemorixGraphDescriptorSource, } from "./load-graph-descriptor.js";
+export { inferGraphDescriptorBundle, inferGraphDescriptorFromSchema, guessFocusObjectTypeFromGraphId, type InferredGraphBundle, } from "./infer-graph-descriptor.js";
+export { buildMemorixGraphDocument, type BuildMemorixGraphDocumentInput, } from "./build-graph-document.js";
+export { buildMemorixGraphDirectory, fetchMemorixGraphNodeContent, type BuildMemorixGraphDirectoryInput, } from "./build-graph-directory.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/graphs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graphs/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,mBAAmB,EACnB,2BAA2B,EAC3B,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,4CAA4C,EAC5C,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,6BAA6B,EAC7B,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,+BAA+B,EAC/B,KAAK,mBAAmB,GACzB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,yBAAyB,EACzB,KAAK,8BAA8B,GACpC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,KAAK,+BAA+B,GACrC,MAAM,4BAA4B,CAAC"}

package/dist/graphs/index.js

@@ -0,0 +1,7 @@
+export { graphLensForStorageContentType, storageContentTypeForLens, } from "./types.js";
+export { DEFAULT_ASSET_TOPOLOGY_VULNERABILITIES_GRAPH, FALLBACK_ENTITY_GRAPH, resolveEntityGraphCapability, } from "./fallback-graph-capabilities.js";
+export { listMemorixGraphDescriptors, loadMemorixGraphDescriptor, resolveMemorixGraphDescriptor, } from "./load-graph-descriptor.js";
+export { inferGraphDescriptorBundle, inferGraphDescriptorFromSchema, guessFocusObjectTypeFromGraphId, } from "./infer-graph-descriptor.js";
+export { buildMemorixGraphDocument, } from "./build-graph-document.js";
+export { buildMemorixGraphDirectory, fetchMemorixGraphNodeContent, } from "./build-graph-directory.js";
+//# sourceMappingURL=index.js.map

package/dist/graphs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graphs/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,4CAA4C,EAC5C,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,6BAA6B,GAG9B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,+BAA+B,GAEhC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,yBAAyB,GAE1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,GAE7B,MAAM,4BAA4B,CAAC"}

package/dist/graphs/infer-graph-descriptor.d.ts

@@ -0,0 +1,17 @@
+import type { MemorixEntityGraphCapability, MemorixGraphDescriptor } from "@x12i/memorix-descriptors";
+import type { MemorixRetrievalClient } from "../client/types.js";
+export type InferredGraphBundle = {
+    descriptor: MemorixGraphDescriptor;
+    entityCapabilities: Record<string, MemorixEntityGraphCapability>;
+    warnings: string[];
+};
+export declare function guessFocusObjectTypeFromGraphId(graphId: string, objectTypes: string[]): string | null;
+/**
+ * Lightweight schema-only guess (no Hippox). Uses entity.relations as queryByField templates.
+ */
+export declare function inferGraphDescriptorFromSchema(client: MemorixRetrievalClient, graphId: string, focusObjectTypeHint?: string): Promise<InferredGraphBundle | null>;
+/**
+ * Prefer Hippox (schema + fuzzy). Fall back to schema-only if Hippox is unavailable.
+ */
+export declare function inferGraphDescriptorBundle(client: MemorixRetrievalClient, graphId: string): Promise<InferredGraphBundle | null>;
+//# sourceMappingURL=infer-graph-descriptor.d.ts.map

package/dist/graphs/infer-graph-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer-graph-descriptor.d.ts","sourceRoot":"","sources":["../../src/graphs/infer-graph-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAKjE,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,sBAAsB,CAAC;IACnC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;IACjE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAoBF,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,GAAG,IAAI,CA0Bf;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,MAAM,EACf,mBAAmB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA4JrC;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA2BrC"}

package/dist/graphs/infer-graph-descriptor.js

@@ -0,0 +1,234 @@
+import { discoverMemorixEntities } from "../descriptors/discover-entities.js";
+import { loadMemorixEntityDescriptorByName } from "../descriptors/discover-entities.js";
+import { entityDescriptorConnections } from "../descriptors/discover-entities.js";
+function slugTemplateId(source, target, sourcePath) {
+    const pathSlug = sourcePath
+        .replace(/^data\./, "")
+        .replace(/[^a-zA-Z0-9]+/g, "-")
+        .replace(/^-|-$/g, "")
+        .toLowerCase();
+    return `schema-${source}-to-${target}-${pathSlug || "join"}`;
+}
+function humanizeGraphId(graphId) {
+    return graphId
+        .replace(/-graph$/i, "")
+        .split("-")
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(" ");
+}
+export function guessFocusObjectTypeFromGraphId(graphId, objectTypes) {
+    if (!objectTypes.length)
+        return null;
+    const stem = graphId.replace(/-graph$/i, "").toLowerCase();
+    if (objectTypes.includes(stem))
+        return stem;
+    const scored = [];
+    for (const ot of objectTypes) {
+        const singular = ot.endsWith("s") ? ot.slice(0, -1) : ot;
+        const candidates = [ot, singular].filter((c) => c.length >= 3);
+        let bestIndex = -1;
+        let bestScore = 0;
+        for (const candidate of candidates) {
+            const idx = stem.indexOf(candidate);
+            if (idx < 0)
+                continue;
+            const score = 1000 - idx + (candidate === ot ? 5 : 0) + candidate.length;
+            if (bestIndex < 0 || idx < bestIndex || (idx === bestIndex && score > bestScore)) {
+                bestIndex = idx;
+                bestScore = score;
+            }
+        }
+        if (bestIndex >= 0)
+            scored.push({ ot, score: bestScore, index: bestIndex });
+    }
+    scored.sort((a, b) => a.index - b.index || b.score - a.score);
+    return scored[0]?.ot ?? objectTypes[0] ?? null;
+}
+/**
+ * Lightweight schema-only guess (no Hippox). Uses entity.relations as queryByField templates.
+ */
+export async function inferGraphDescriptorFromSchema(client, graphId, focusObjectTypeHint) {
+    const discovery = await discoverMemorixEntities(client);
+    const objectTypes = discovery.summaries.map((s) => s.entityName).filter(Boolean);
+    if (objectTypes.length < 1)
+        return null;
+    const focusObjectType = focusObjectTypeHint ?? guessFocusObjectTypeFromGraphId(graphId, objectTypes);
+    if (!focusObjectType)
+        return null;
+    const entityCapabilities = {};
+    const includeEdgeTemplates = [];
+    const related = new Set([focusObjectType]);
+    const warnings = [];
+    for (const ot of objectTypes) {
+        try {
+            const entity = await loadMemorixEntityDescriptorByName(client, ot);
+            const kind = entity.graph?.node?.kind ??
+                (ot.replace(/s$/, "") || ot);
+            entityCapabilities[ot] = {
+                node: {
+                    kind,
+                    contentLenses: entity.graph?.node
+                        ?.contentLenses ?? ["snapshot"],
+                    directoryFields: entity.graph?.node
+                        ?.directoryFields ?? [],
+                },
+                edgeTemplates: [],
+            };
+            // Prefer authored graph.edgeTemplates when present.
+            const authored = entity.graph;
+            if (authored?.edgeTemplates?.length) {
+                entityCapabilities[ot] = {
+                    node: {
+                        ...entityCapabilities[ot].node,
+                        ...authored.node,
+                    },
+                    edgeTemplates: [...authored.edgeTemplates],
+                };
+                for (const t of authored.edgeTemplates) {
+                    includeEdgeTemplates.push(t.id);
+                    for (const e of t.edges)
+                        related.add(e.toObjectType);
+                }
+                continue;
+            }
+            for (const conn of entityDescriptorConnections(entity)) {
+                if (!objectTypes.includes(conn.targetEntityName))
+                    continue;
+                const templateId = slugTemplateId(ot, conn.targetEntityName, conn.sourceProperty);
+                includeEdgeTemplates.push(templateId);
+                related.add(conn.targetEntityName);
+                entityCapabilities[ot].edgeTemplates.push({
+                    id: templateId,
+                    source: {
+                        kind: "queryByField",
+                        objectType: conn.targetEntityName,
+                        sourcePath: conn.sourceProperty,
+                        targetPath: conn.targetProperty,
+                        limit: 50,
+                    },
+                    edges: [
+                        {
+                            type: `linksTo${conn.targetEntityName
+                                .split("-")
+                                .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+                                .join("")}`,
+                            from: { source: "concept" },
+                            to: { source: "relatedConcept" },
+                            toObjectType: conn.targetEntityName,
+                            toKind: entityCapabilities[conn.targetEntityName]?.node.kind ??
+                                conn.targetEntityName,
+                            neighbor: "to",
+                        },
+                    ],
+                });
+            }
+        }
+        catch {
+            warnings.push(`Could not load entity descriptor for ${ot}`);
+        }
+    }
+    // Restrict to neighborhood of focus using authored/schema edges only.
+    const adjacency = new Map();
+    for (const [ot, cap] of Object.entries(entityCapabilities)) {
+        for (const t of cap.edgeTemplates ?? []) {
+            for (const e of t.edges) {
+                if (!adjacency.has(ot))
+                    adjacency.set(ot, new Set());
+                adjacency.get(ot).add(e.toObjectType);
+            }
+        }
+    }
+    const reachable = new Set([focusObjectType]);
+    const queue = [focusObjectType];
+    while (queue.length) {
+        const cur = queue.shift();
+        for (const next of adjacency.get(cur) ?? []) {
+            if (reachable.has(next))
+                continue;
+            reachable.add(next);
+            queue.push(next);
+        }
+    }
+    const filteredTemplates = includeEdgeTemplates.filter((id) => {
+        for (const [ot, cap] of Object.entries(entityCapabilities)) {
+            if (!reachable.has(ot))
+                continue;
+            if (cap.edgeTemplates?.some((t) => t.id === id))
+                return true;
+        }
+        return false;
+    });
+    const nodes = [...reachable].sort((a, b) => {
+        if (a === focusObjectType)
+            return -1;
+        if (b === focusObjectType)
+            return 1;
+        return a.localeCompare(b);
+    });
+    if (filteredTemplates.length === 0 && nodes.length === 1) {
+        warnings.push("Schema inference found no relations from focus object type.");
+    }
+    const descriptor = {
+        id: graphId,
+        title: humanizeGraphId(graphId),
+        focusObjectType,
+        maxDepth: 2,
+        includeEdgeTemplates: filteredTemplates,
+        tiers: [
+            { id: "focus", label: "Focus", objectTypes: [focusObjectType] },
+            ...(nodes.filter((n) => n !== focusObjectType).length
+                ? [
+                    {
+                        id: "related",
+                        label: "Related",
+                        objectTypes: nodes.filter((n) => n !== focusObjectType),
+                    },
+                ]
+                : []),
+        ],
+        nodes: nodes.map((ot) => ({
+            objectType: ot,
+            kind: entityCapabilities[ot]?.node.kind,
+            tier: ot === focusObjectType ? "focus" : "related",
+        })),
+        directory: {
+            defaultObjectTypes: nodes,
+            searchFields: ["title", "identifierKey"],
+        },
+        ui: { icon: "network", group: "inferred", order: 100 },
+    };
+    return { descriptor, entityCapabilities, warnings };
+}
+/**
+ * Prefer Hippox (schema + fuzzy). Fall back to schema-only if Hippox is unavailable.
+ */
+export async function inferGraphDescriptorBundle(client, graphId) {
+    try {
+        const hippox = await import("@x12i/memorix-hippox");
+        const guess = await hippox.guessMemorixGraphDescriptor({
+            retrieval: client,
+            graphId,
+            processEnv: client.processEnv,
+            sampleLimit: 200,
+            minInclusionRatio: 0.5,
+            minConfidence: 0.35,
+        });
+        if (guess) {
+            return {
+                descriptor: guess.descriptor,
+                entityCapabilities: guess.entityCapabilities,
+                warnings: guess.warnings,
+            };
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        // Package missing or runtime failure → schema-only path.
+        if (!message.includes("Cannot find package") && !message.includes("Cannot find module")) {
+            // Still try schema; keep going.
+        }
+    }
+    return inferGraphDescriptorFromSchema(client, graphId);
+}
+//# sourceMappingURL=infer-graph-descriptor.js.map

package/dist/graphs/infer-graph-descriptor.js.map

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

package/dist/graphs/load-graph-descriptor.d.ts

@@ -0,0 +1,22 @@
+import { type MemorixEntityGraphCapability, type MemorixGraphDescriptor } from "@x12i/memorix-descriptors";
+import type { MemorixRetrievalClient } from "../client/types.js";
+export { DEFAULT_ASSET_TOPOLOGY_VULNERABILITIES_GRAPH } from "./fallback-graph-capabilities.js";
+export type MemorixGraphDescriptorSource = "catalox" | "inferred" | "fallback";
+export type MemorixGraphDescriptorResolution = {
+    descriptor: MemorixGraphDescriptor;
+    /** False when Catalox has no graph descriptor item (inferred or bundled fallback used). */
+    defined: boolean;
+    source: MemorixGraphDescriptorSource;
+    /** Synthesized entity graph capabilities when source is inferred. */
+    inferredCapabilities?: Record<string, MemorixEntityGraphCapability>;
+    inferenceWarnings?: string[];
+};
+export declare function resolveMemorixGraphDescriptor(client: MemorixRetrievalClient, graphId: string): Promise<MemorixGraphDescriptorResolution>;
+export declare function loadMemorixGraphDescriptor(client: MemorixRetrievalClient, graphId: string): Promise<MemorixGraphDescriptor>;
+export declare function listMemorixGraphDescriptors(client: MemorixRetrievalClient): Promise<Array<{
+    id: string;
+    title: string;
+    defined: boolean;
+    source: MemorixGraphDescriptorSource;
+}>>;
+//# sourceMappingURL=load-graph-descriptor.d.ts.map

package/dist/graphs/load-graph-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-graph-descriptor.d.ts","sourceRoot":"","sources":["../../src/graphs/load-graph-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,EAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAIjE,OAAO,EAAE,4CAA4C,EAAE,MAAM,kCAAkC,CAAC;AAEhG,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/E,MAAM,MAAM,gCAAgC,GAAG;IAC7C,UAAU,EAAE,sBAAsB,CAAC;IACnC,2FAA2F;IAC3F,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,4BAA4B,CAAC;IACrC,qEAAqE;IACrE,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;IACpE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC;AAeF,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gCAAgC,CAAC,CA+C3C;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,sBAAsB,CAAC,CAGjC;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,4BAA4B,CAAA;CAAE,CAAC,CAAC,CA2CvG"}