@x12i/memorix-retrieval 1.35.0 → 1.37.0

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,31 @@
+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[];
+    /** Agent scope observed on the Catalox catalog item (when present). */
+    scopeAgents?: string[];
+};
+export declare function resolveMemorixGraphDescriptor(client: MemorixRetrievalClient, graphId: string, options?: {
+    agentId?: string;
+}): Promise<MemorixGraphDescriptorResolution>;
+export declare function loadMemorixGraphDescriptor(client: MemorixRetrievalClient, graphId: string, options?: {
+    agentId?: string;
+}): Promise<MemorixGraphDescriptor>;
+export declare function listMemorixGraphDescriptors(client: MemorixRetrievalClient, options?: {
+    agentId?: string;
+}): Promise<Array<{
+    id: string;
+    title: string;
+    defined: boolean;
+    source: MemorixGraphDescriptorSource;
+    scopeAgents?: string[];
+}>>;
+//# 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;AAMnC,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;IAC7B,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAsCF,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,gCAAgC,CAAC,CA+D3C;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CAGjC;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CACR,KAAK,CAAC;IACJ,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,4BAA4B,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC,CACH,CA4DA"}

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

@@ -0,0 +1,141 @@
+import { MEMORIX_GRAPH_DESCRIPTORS_CATALOG, } from "@x12i/memorix-descriptors";
+import { extractScopeFromData, mergeCatalogItemScopeIntoData, objectTypeMatchesAgent, } from "@x12i/memorix-agents";
+import { DEFAULT_ASSET_TOPOLOGY_VULNERABILITIES_GRAPH } from "./fallback-graph-capabilities.js";
+import { inferGraphDescriptorBundle } from "./infer-graph-descriptor.js";
+export { DEFAULT_ASSET_TOPOLOGY_VULNERABILITIES_GRAPH } from "./fallback-graph-capabilities.js";
+function asGraphDescriptor(data) {
+    return data;
+}
+function isCatalogMissingError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return (message.includes("Catalog not found") ||
+        message.includes("Access denied for catalog") ||
+        message.includes("binding_not_found_or_inactive"));
+}
+function scopeAgentsFromCatalogItem(item) {
+    const merged = mergeCatalogItemScopeIntoData(item);
+    return extractScopeFromData(merged).agents;
+}
+function assertAgentAllowed(scopeAgents, agentId, graphId) {
+    if (!agentId)
+        return;
+    const scope = { domains: [], agents: scopeAgents ?? [] };
+    if (!objectTypeMatchesAgent(scope, agentId)) {
+        throw new Error(`Graph descriptor "${graphId}" is out of scope for agentId="${agentId}"`);
+    }
+}
+export async function resolveMemorixGraphDescriptor(client, graphId, options) {
+    const agentId = options?.agentId?.trim() || undefined;
+    try {
+        const result = await client.catalox.getCatalogItem({ appId: client.appId }, MEMORIX_GRAPH_DESCRIPTORS_CATALOG, graphId);
+        if (result.outcome === "found" && result.item?.data) {
+            const scopeAgents = scopeAgentsFromCatalogItem({
+                data: result.item.data,
+                scope: result.item.scope,
+                metadata: result.item
+                    .metadata,
+            });
+            assertAgentAllowed(scopeAgents, agentId, graphId);
+            return {
+                descriptor: asGraphDescriptor(result.item.data),
+                defined: true,
+                source: "catalox",
+                scopeAgents,
+            };
+        }
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes("out of scope"))
+            throw err;
+        if (!isCatalogMissingError(err))
+            throw err;
+    }
+    // Prefer Hippox / schema inference over static bundled fallback.
+    try {
+        const inferred = await inferGraphDescriptorBundle(client, graphId);
+        if (inferred?.descriptor) {
+            const hasStructure = (inferred.descriptor.includeEdgeTemplates?.length ?? 0) > 0 ||
+                (inferred.descriptor.nodes?.length ?? 0) > 0;
+            if (hasStructure) {
+                // Inferred descriptors inherit neo product scope for cyber deployments.
+                assertAgentAllowed(["neo"], agentId, graphId);
+                return {
+                    descriptor: inferred.descriptor,
+                    defined: false,
+                    source: "inferred",
+                    inferredCapabilities: inferred.entityCapabilities,
+                    inferenceWarnings: inferred.warnings,
+                    scopeAgents: ["neo"],
+                };
+            }
+        }
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes("out of scope"))
+            throw err;
+        // Fall through to bundled fallback / error.
+    }
+    if (graphId === DEFAULT_ASSET_TOPOLOGY_VULNERABILITIES_GRAPH.id) {
+        assertAgentAllowed(["neo"], agentId, graphId);
+        return {
+            descriptor: DEFAULT_ASSET_TOPOLOGY_VULNERABILITIES_GRAPH,
+            defined: false,
+            source: "fallback",
+            scopeAgents: ["neo"],
+        };
+    }
+    throw new Error(`Graph descriptor not found: ${graphId}`);
+}
+export async function loadMemorixGraphDescriptor(client, graphId, options) {
+    const resolved = await resolveMemorixGraphDescriptor(client, graphId, options);
+    return resolved.descriptor;
+}
+export async function listMemorixGraphDescriptors(client, options) {
+    const agentId = options?.agentId?.trim() || undefined;
+    const fallback = [
+        {
+            id: DEFAULT_ASSET_TOPOLOGY_VULNERABILITIES_GRAPH.id,
+            title: DEFAULT_ASSET_TOPOLOGY_VULNERABILITIES_GRAPH.title,
+            defined: false,
+            source: "fallback",
+            scopeAgents: ["neo"],
+        },
+    ].filter((g) => objectTypeMatchesAgent({ domains: [], agents: g.scopeAgents }, agentId));
+    const listFn = client.catalox.listCatalogItems;
+    if (!listFn)
+        return fallback;
+    try {
+        const page = await listFn({ appId: client.appId }, MEMORIX_GRAPH_DESCRIPTORS_CATALOG, { limit: 200, offset: 0 });
+        const items = (page.items ?? [])
+            .map((item) => {
+            const scopeAgents = scopeAgentsFromCatalogItem({
+                data: item.data,
+                scope: item.scope,
+                metadata: item
+                    .metadata,
+            });
+            return {
+                id: String(item.data.id ?? item.id),
+                title: String(item.data.title ?? item.title ?? item.id),
+                defined: true,
+                source: "catalox",
+                scopeAgents,
+            };
+        })
+            .filter((g) => objectTypeMatchesAgent({ domains: [], agents: g.scopeAgents ?? [] }, agentId));
+        if (items.length === 0 ||
+            !items.some((i) => i.id === DEFAULT_ASSET_TOPOLOGY_VULNERABILITIES_GRAPH.id)) {
+            const profile = client.processEnv?.MEMORIX_DEPLOYMENT_PROFILE?.trim();
+            if (profile !== "ebook") {
+                items.unshift(...fallback);
+            }
+        }
+        return items;
+    }
+    catch (err) {
+        if (isCatalogMissingError(err))
+            return fallback;
+        throw err;
+    }
+}
+//# sourceMappingURL=load-graph-descriptor.js.map

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

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

package/dist/graphs/record-access.d.ts

@@ -0,0 +1,36 @@
+import type { MemorixEntityDescriptor } from "../descriptors/descriptor-types.js";
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { JsonObject, MemorixGraphConcept, MemorixGraphContent } from "./types.js";
+/**
+ * Infer snapshot objectType from an identifierKey kind prefix (e.g. `cidr:…` → subnets).
+ * Uses descriptor node `kind` when set, otherwise fallback/inferred entity graph kinds.
+ */
+export declare function guessObjectTypeFromIdentifierKey(identifierKey: string, nodes: ReadonlyArray<{
+    objectType: string;
+    kind?: string;
+}>, kindByObjectType?: Readonly<Record<string, string | undefined>>): string | undefined;
+/** Ordered object types to try when resolving a Directory/Focus selection. */
+export declare function focusLookupObjectTypes(input: {
+    focusObjectType: string;
+    focusIdentifierKey?: string;
+    nodes: ReadonlyArray<{
+        objectType: string;
+        kind?: string;
+    }>;
+    kindByObjectType?: Readonly<Record<string, string | undefined>>;
+}): string[];
+export declare function conceptFromRecord(doc: JsonObject): MemorixGraphConcept | null;
+export declare function loadEntity(client: MemorixRetrievalClient, objectType: string): Promise<MemorixEntityDescriptor>;
+export declare function findSnapshotByRecordId(client: MemorixRetrievalClient, objectType: string, recordId: string): Promise<JsonObject | null>;
+export declare function findSnapshotByIdentifierKey(client: MemorixRetrievalClient, objectType: string, identifierKey: string): Promise<JsonObject | null>;
+export declare function listSnapshots(client: MemorixRetrievalClient, objectType: string, options?: {
+    query?: JsonObject;
+    limit?: number;
+    offset?: number;
+}): Promise<JsonObject[]>;
+export declare function countSnapshots(client: MemorixRetrievalClient, objectType: string, options?: {
+    query?: JsonObject;
+}): Promise<number>;
+export declare function fetchContentLenses(client: MemorixRetrievalClient, objectType: string, recordId: string, lenses: string[]): Promise<MemorixGraphContent>;
+export declare function recordIdOf(doc: JsonObject): string;
+//# sourceMappingURL=record-access.d.ts.map

package/dist/graphs/record-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-access.d.ts","sourceRoot":"","sources":["../../src/graphs/record-access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAQjE,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGvF;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,aAAa,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC3D,gBAAgB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAC9D,MAAM,GAAG,SAAS,CAcpB;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,gBAAgB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CACjE,GAAG,MAAM,EAAE,CAiBX;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,mBAAmB,GAAG,IAAI,CA2B7E;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAkB5B;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAW5B;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GACL,OAAO,CAAC,UAAU,EAAE,CAAC,CAYvB;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,UAAU,CAAA;CAAO,GACnC,OAAO,CAAC,MAAM,CAAC,CASjB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,mBAAmB,CAAC,CA8C9B;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAElD"}

package/dist/graphs/record-access.js

@@ -0,0 +1,178 @@
+import { resolveMemorixCollectionName } from "../data/collection-name.js";
+import { memorixReadByTarget } from "../data/target-read.js";
+import { loadMemorixEntityDescriptorByName } from "../descriptors/discover-entities.js";
+import { resolveMemorixTargetFromDescriptor, } from "../mongo/target-config.js";
+import { readRecordId } from "@x12i/memorix-descriptors";
+import { graphLensForStorageContentType, storageContentTypeForLens } from "./types.js";
+/**
+ * Infer snapshot objectType from an identifierKey kind prefix (e.g. `cidr:…` → subnets).
+ * Uses descriptor node `kind` when set, otherwise fallback/inferred entity graph kinds.
+ */
+export function guessObjectTypeFromIdentifierKey(identifierKey, nodes, kindByObjectType) {
+    const colon = identifierKey.indexOf(":");
+    if (colon <= 0)
+        return undefined;
+    const kind = identifierKey.slice(0, colon);
+    if (!kind)
+        return undefined;
+    const byExplicit = nodes.find((n) => n.kind === kind);
+    if (byExplicit)
+        return byExplicit.objectType;
+    for (const n of nodes) {
+        const inferredKind = kindByObjectType?.[n.objectType] ?? n.kind;
+        if (inferredKind === kind)
+            return n.objectType;
+    }
+    return undefined;
+}
+/** Ordered object types to try when resolving a Directory/Focus selection. */
+export function focusLookupObjectTypes(input) {
+    const ordered = [];
+    const add = (ot) => {
+        if (ot && !ordered.includes(ot))
+            ordered.push(ot);
+    };
+    if (input.focusIdentifierKey) {
+        add(guessObjectTypeFromIdentifierKey(input.focusIdentifierKey, input.nodes, input.kindByObjectType));
+    }
+    add(input.focusObjectType);
+    for (const n of input.nodes)
+        add(n.objectType);
+    return ordered;
+}
+export function conceptFromRecord(doc) {
+    const concept = doc.concept;
+    if (!concept || typeof concept !== "object" || Array.isArray(concept))
+        return null;
+    const c = concept;
+    const identifier = c.identifier;
+    if (!identifier || typeof identifier !== "object" || Array.isArray(identifier))
+        return null;
+    const id = identifier;
+    const kind = typeof id.kind === "string" ? id.kind : "";
+    const identifierKey = typeof id.identifierKey === "string"
+        ? id.identifierKey
+        : kind && id[kind] != null
+            ? `${kind}:${String(id[kind])}`
+            : "";
+    if (!kind || !identifierKey)
+        return null;
+    const title = typeof c.title === "string" && c.title.trim()
+        ? c.title
+        : String(id[kind] ?? identifierKey);
+    return {
+        identifier: {
+            ...id,
+            kind,
+            identifierKey,
+        },
+        title,
+    };
+}
+export async function loadEntity(client, objectType) {
+    return loadMemorixEntityDescriptorByName(client, objectType);
+}
+export async function findSnapshotByRecordId(client, objectType, recordId) {
+    const entity = await loadEntity(client, objectType);
+    const target = resolveMemorixTargetFromDescriptor(entity);
+    const collection = resolveMemorixCollectionName(entity, "snapshots", client.processEnv);
+    const docs = await memorixReadByTarget(client, {
+        target,
+        collection,
+        query: {
+            $or: [
+                { recordId },
+                { entityId: recordId },
+                { eventId: recordId },
+                { _id: recordId },
+            ],
+        },
+        limit: 1,
+    });
+    return docs[0] ?? null;
+}
+export async function findSnapshotByIdentifierKey(client, objectType, identifierKey) {
+    const entity = await loadEntity(client, objectType);
+    const target = resolveMemorixTargetFromDescriptor(entity);
+    const collection = resolveMemorixCollectionName(entity, "snapshots", client.processEnv);
+    const docs = await memorixReadByTarget(client, {
+        target,
+        collection,
+        query: { "concept.identifier.identifierKey": identifierKey },
+        limit: 1,
+    });
+    return docs[0] ?? null;
+}
+export async function listSnapshots(client, objectType, options = {}) {
+    const entity = await loadEntity(client, objectType);
+    const target = resolveMemorixTargetFromDescriptor(entity);
+    const collection = resolveMemorixCollectionName(entity, "snapshots", client.processEnv);
+    const docs = await memorixReadByTarget(client, {
+        target,
+        collection,
+        query: options.query ?? {},
+        limit: options.limit ?? 50,
+        skip: options.offset ?? 0,
+    });
+    return docs;
+}
+export async function countSnapshots(client, objectType, options = {}) {
+    const entity = await loadEntity(client, objectType);
+    const collection = resolveMemorixCollectionName(entity, "snapshots", client.processEnv);
+    const { memorixCount } = await import("../data/memorix-count.js");
+    return memorixCount(client, {
+        entity,
+        source: collection,
+        query: options.query ?? {},
+    });
+}
+export async function fetchContentLenses(client, objectType, recordId, lenses) {
+    const entity = await loadEntity(client, objectType);
+    const target = resolveMemorixTargetFromDescriptor(entity);
+    const content = {};
+    for (const lens of lenses) {
+        const storageCt = storageContentTypeForLens(lens);
+        if (!entity.contentTypes[storageCt] && storageCt !== "snapshots") {
+            // try alternate decision/decisions
+            const alt = storageCt === "decisions"
+                ? "decision"
+                : storageCt === "decision"
+                    ? "decisions"
+                    : null;
+            if (!alt || !entity.contentTypes[alt])
+                continue;
+            const collection = resolveMemorixCollectionName(entity, alt, client.processEnv);
+            const docs = await memorixReadByTarget(client, {
+                target,
+                collection,
+                query: { $or: [{ recordId }, { entityId: recordId }] },
+                limit: 1,
+            });
+            const doc = docs[0];
+            const data = doc?.data;
+            if (data && typeof data === "object" && !Array.isArray(data)) {
+                content[graphLensForStorageContentType(alt)] = data;
+            }
+            continue;
+        }
+        if (!entity.contentTypes[storageCt])
+            continue;
+        const collection = resolveMemorixCollectionName(entity, storageCt, client.processEnv);
+        const docs = await memorixReadByTarget(client, {
+            target,
+            collection,
+            query: { $or: [{ recordId }, { entityId: recordId }] },
+            limit: 1,
+        });
+        const doc = docs[0];
+        const data = doc?.data;
+        if (data && typeof data === "object" && !Array.isArray(data)) {
+            content[lens] = data;
+        }
+    }
+    return content;
+}
+export function recordIdOf(doc) {
+    return readRecordId(doc) || String(doc.entityId ?? doc.eventId ?? "");
+}
+//# sourceMappingURL=record-access.js.map