@x12i/memorix-service 3.7.1 → 3.7.7

package/dist/mcp/nexum-tools.js

@@ -0,0 +1,257 @@
+import { ServiceError } from "../errors.js";
+import { knowledgeUpstreamUrl, proxyJson, throwIfKnowledgeUpstreamError, } from "../knowledge-upstream.js";
+import { recordLooksLikeKnowledgeGraph } from "../activity-ring.js";
+export const NEXUM_MCP_TOOL_NAMES = [
+    "nexum_list_snapshots",
+    "nexum_get_snapshot",
+    "nexum_knowledge_status",
+    "nexum_list_entities",
+    "nexum_get_entity",
+    "nexum_query",
+];
+export const NEXUM_MCP_TOOLS = [
+    {
+        name: "nexum_list_snapshots",
+        description: "List Memorix knowledge-graph snapshot subjects (objectType=content, contentType=snapshots). Optional filter to data.kind=knowledge-graph.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: { type: "number", description: "Max records (default 50, max 200)" },
+                cursor: { type: "string" },
+                knowledgeGraphOnly: {
+                    type: "boolean",
+                    description: "When true, keep only records with data.kind=knowledge-graph",
+                },
+            },
+        },
+    },
+    {
+        name: "nexum_get_snapshot",
+        description: "Get one Memorix content/snapshots subject by recordId (knowledge-graph snapshot when indexed).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                recordId: { type: "string" },
+            },
+            required: ["recordId"],
+        },
+    },
+    {
+        name: "nexum_knowledge_status",
+        description: "Probe Nexum explore REST (canvas Mongo store) health. Separate from Memorix subjects.",
+        inputSchema: { type: "object", properties: {} },
+    },
+    {
+        name: "nexum_list_entities",
+        description: "List or search canvas graph entities via Nexum explore REST (graphified-* Mongo).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                graphId: { type: "string" },
+                q: { type: "string", description: "Search query; omit for visualization slice" },
+                limit: { type: "string" },
+            },
+        },
+    },
+    {
+        name: "nexum_get_entity",
+        description: "Get one canvas entity/node by id from Nexum explore REST.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityId: { type: "string" },
+                graphId: { type: "string" },
+            },
+            required: ["entityId"],
+        },
+    },
+    {
+        name: "nexum_query",
+        description: "Neighbor query on the canvas graph (Nexum explore REST). Requires nodeId seed.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                nodeId: { type: "string" },
+                graphId: { type: "string" },
+                depth: { type: "number" },
+            },
+            required: ["nodeId"],
+        },
+    },
+];
+function asRecord(args) {
+    return args && typeof args === "object" && !Array.isArray(args)
+        ? args
+        : {};
+}
+function textResult(payload) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: typeof payload === "string"
+                    ? payload
+                    : JSON.stringify(payload, null, 2),
+            },
+        ],
+    };
+}
+function errorResult(err) {
+    if (err instanceof ServiceError) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({ code: err.code, message: err.message, details: err.details }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: err instanceof Error ? err.message : String(err),
+            },
+        ],
+        isError: true,
+    };
+}
+export async function callNexumMcpTool(opts) {
+    const { platform, scope, name } = opts;
+    const args = asRecord(opts.args);
+    try {
+        switch (name) {
+            case "nexum_list_snapshots": {
+                const ports = platform.portsFor(scope);
+                const limit = Math.min(Number(args.limit ?? 50) || 50, 200);
+                const listed = await ports.reader.listContent(scope, {
+                    objectType: "content",
+                    contentType: "snapshots",
+                    limit,
+                    cursor: typeof args.cursor === "string" ? args.cursor : undefined,
+                });
+                let items = listed.items ?? [];
+                if (args.knowledgeGraphOnly === true) {
+                    items = items.filter((r) => recordLooksLikeKnowledgeGraph(r));
+                }
+                return textResult({
+                    scope,
+                    addressing: {
+                        objectType: "content",
+                        contentType: "snapshots",
+                    },
+                    records: items,
+                    pageInfo: { nextCursor: listed.nextCursor ?? null },
+                });
+            }
+            case "nexum_get_snapshot": {
+                const recordId = String(args.recordId ?? "").trim();
+                if (!recordId) {
+                    throw new ServiceError("VALIDATION", "recordId required", 400);
+                }
+                const ports = platform.portsFor(scope);
+                const record = await ports.reader.getContent(scope, {
+                    objectType: "content",
+                    contentType: "snapshots",
+                    recordId,
+                });
+                return textResult({
+                    scope,
+                    addressing: {
+                        objectType: "content",
+                        contentType: "snapshots",
+                        recordId,
+                    },
+                    record,
+                    knowledgeGraph: recordLooksLikeKnowledgeGraph(record),
+                });
+            }
+            case "nexum_knowledge_status": {
+                const baseUrl = knowledgeUpstreamUrl();
+                let upstream = {
+                    ok: false,
+                };
+                try {
+                    const health = await proxyJson("GET", `${baseUrl}/health`);
+                    upstream = {
+                        ok: health.status >= 200 && health.status < 300,
+                        status: health.status,
+                    };
+                }
+                catch (err) {
+                    upstream = {
+                        ok: false,
+                        error: err instanceof Error ? err.message : String(err),
+                    };
+                }
+                return textResult({
+                    scope,
+                    upstreamOk: upstream.ok,
+                    upstream,
+                    exploreBaseUrl: baseUrl,
+                    note: "Canvas store (Nexum explore REST). Subjects use nexum_list_snapshots / nexum_get_snapshot.",
+                });
+            }
+            case "nexum_list_entities": {
+                const graphId = String(args.graphId ?? "default").trim() || "default";
+                const q = typeof args.q === "string" ? args.q.trim() : "";
+                const limit = String(args.limit ?? (q ? "50" : "500"));
+                const baseUrl = knowledgeUpstreamUrl();
+                const path = q
+                    ? `/v1/orgs/${encodeURIComponent(scope.orgId)}/graphs/${encodeURIComponent(graphId)}/search?q=${encodeURIComponent(q)}&limit=${encodeURIComponent(limit)}`
+                    : `/v1/orgs/${encodeURIComponent(scope.orgId)}/graphs/${encodeURIComponent(graphId)}/visualization?maximumNodes=${encodeURIComponent(limit)}`;
+                const upstream = await proxyJson("GET", `${baseUrl}${path}`);
+                throwIfKnowledgeUpstreamError(upstream);
+                return textResult({
+                    scope,
+                    graphId,
+                    result: upstream.body,
+                });
+            }
+            case "nexum_get_entity": {
+                const entityId = String(args.entityId ?? "").trim();
+                if (!entityId) {
+                    throw new ServiceError("VALIDATION", "entityId required", 400);
+                }
+                const graphId = String(args.graphId ?? "default").trim() || "default";
+                const baseUrl = knowledgeUpstreamUrl();
+                const path = `/v1/orgs/${encodeURIComponent(scope.orgId)}/graphs/${encodeURIComponent(graphId)}/nodes/${encodeURIComponent(entityId)}`;
+                const upstream = await proxyJson("GET", `${baseUrl}${path}`);
+                throwIfKnowledgeUpstreamError(upstream);
+                return textResult({
+                    scope,
+                    graphId,
+                    entityId,
+                    result: upstream.body,
+                });
+            }
+            case "nexum_query": {
+                const nodeId = String(args.nodeId ?? "").trim();
+                if (!nodeId) {
+                    throw new ServiceError("VALIDATION", "nodeId required", 400);
+                }
+                const graphId = String(args.graphId ?? "default").trim() || "default";
+                const depth = Number(args.depth ?? 1);
+                const baseUrl = knowledgeUpstreamUrl();
+                const path = `/v1/orgs/${encodeURIComponent(scope.orgId)}/graphs/${encodeURIComponent(graphId)}/nodes/${encodeURIComponent(nodeId)}/neighbors?depth=${encodeURIComponent(String(depth))}`;
+                const upstream = await proxyJson("GET", `${baseUrl}${path}`);
+                throwIfKnowledgeUpstreamError(upstream);
+                return textResult({
+                    scope,
+                    graphId,
+                    seed: nodeId,
+                    depth,
+                    result: upstream.body,
+                });
+            }
+            default:
+                throw new ServiceError("VALIDATION", `Unknown tool: ${name}`, 400);
+        }
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+//# sourceMappingURL=nexum-tools.js.map

package/dist/mcp/nexum-tools.js.map

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

package/dist/mcp/service-public-url.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Absolute base URL for agent-facing links (MCP copy snippets, OpenAPI).
+ * Prefer public advertise URL, then MEMORIX_SERVICE_URL; never advertise 0.0.0.0.
+ */
+export declare function memorixServicePublicUrl(env?: NodeJS.ProcessEnv): string;
+export declare function nexumMcpPublicUrl(env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=service-public-url.d.ts.map

package/dist/mcp/service-public-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-public-url.d.ts","sourceRoot":"","sources":["../../src/mcp/service-public-url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAWR;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAER"}

package/dist/mcp/service-public-url.js

@@ -0,0 +1,19 @@
+/**
+ * Absolute base URL for agent-facing links (MCP copy snippets, OpenAPI).
+ * Prefer public advertise URL, then MEMORIX_SERVICE_URL; never advertise 0.0.0.0.
+ */
+export function memorixServicePublicUrl(env = process.env) {
+    const fromEnv = env.MEMORIX_PUBLIC_URL?.trim() ||
+        env.MEMORIX_SERVICE_PUBLIC_URL?.trim() ||
+        env.MEMORIX_SERVICE_URL?.trim();
+    if (fromEnv)
+        return fromEnv.replace(/\/+$/, "");
+    const port = Number(env.MEMORIX_SERVICE_PORT ?? 5100);
+    const rawHost = env.MEMORIX_SERVICE_HOST?.trim() || "127.0.0.1";
+    const host = rawHost === "0.0.0.0" || rawHost === "::" ? "127.0.0.1" : rawHost;
+    return `http://${host}:${Number.isFinite(port) ? port : 5100}`;
+}
+export function nexumMcpPublicUrl(env = process.env) {
+    return `${memorixServicePublicUrl(env)}/mcp/nexum`;
+}
+//# sourceMappingURL=service-public-url.js.map

package/dist/mcp/service-public-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-public-url.js","sourceRoot":"","sources":["../../src/mcp/service-public-url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,OAAO,GACX,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE;QAC9B,GAAG,CAAC,0BAA0B,EAAE,IAAI,EAAE;QACtC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;IAClC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,IAAI,IAAI,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,IAAI,WAAW,CAAC;IAChE,MAAM,IAAI,GACR,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;IACpE,OAAO,UAAU,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,GAAG,uBAAuB,CAAC,GAAG,CAAC,YAAY,CAAC;AACrD,CAAC"}

package/dist/nexum-analysis/backfill.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Scan + enqueue knowledge indexing for existing subjects (legacy backfill).
+ * Operators only — not a lander surface.
+ */
+import type { MemorixPlatform } from "../platform.js";
+import type { MemorixScope } from "../scope.js";
+export type IndexingScanRow = {
+    objectType: string;
+    contentType: string;
+    recordId: string;
+    revision: number;
+    classification: "eligible" | "already-indexed" | "legacy-nexum-ot" | "no-policy" | "no-payload";
+    policyId?: string;
+};
+export type IndexingScanResult = {
+    scope: MemorixScope;
+    scanned: number;
+    counts: Record<IndexingScanRow["classification"], number>;
+    samples: IndexingScanRow[];
+    note: string;
+};
+export declare function scanIndexingCandidates(input: {
+    platform: MemorixPlatform;
+    scope: MemorixScope;
+    pairs?: Array<{
+        objectType: string;
+        contentType: string;
+    }>;
+    limitPerPair?: number;
+    sampleLimit?: number;
+}): Promise<IndexingScanResult>;
+export declare function backfillIndexing(input: {
+    platform: MemorixPlatform;
+    scope: MemorixScope;
+    pairs?: Array<{
+        objectType: string;
+        contentType: string;
+    }>;
+    limitPerPair?: number;
+    /** Default true — report only. Pass false to enqueue. */
+    dryRun?: boolean;
+    maxEnqueue?: number;
+}): Promise<{
+    scope: MemorixScope;
+    dryRun: boolean;
+    scanned: number;
+    enqueued: number;
+    skipped: number;
+    results: Array<{
+        recordId: string;
+        objectType: string;
+        contentType: string;
+        status: string;
+        reason?: string;
+        operationId?: string;
+        policy?: string;
+    }>;
+}>;
+//# sourceMappingURL=backfill.d.ts.map

package/dist/nexum-analysis/backfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill.d.ts","sourceRoot":"","sources":["../../src/nexum-analysis/backfill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAUhD,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EACV,UAAU,GACV,iBAAiB,GACjB,iBAAiB,GACjB,WAAW,GACX,YAAY,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1D,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAoGF,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmC9B;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAC5C,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC;IACV,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ,CAAC,CAsFD"}

package/dist/nexum-analysis/backfill.js

@@ -0,0 +1,199 @@
+import { matchNexumIndexingPolicy, recordToNexumItems, resolveNexumIndexingPolicies, } from "./policy.js";
+import { maybeEnqueueNexumAnalysis } from "./enqueue.js";
+const DEFAULT_SCAN_CTS = [
+    { objectType: "content", contentType: "snapshots" },
+    { objectType: "content", contentType: "knowx" },
+];
+function resolvePolicies(platform, scope) {
+    const effective = platform.metadata.resolveEffective(scope.agentIds);
+    const extensionBag = {};
+    for (const e of effective.effective ?? []) {
+        if (!e.kind?.includes("."))
+            continue;
+        if (!extensionBag[e.kind])
+            extensionBag[e.kind] = [];
+        extensionBag[e.kind].push({
+            id: e.id,
+            ...e.definition,
+        });
+    }
+    return resolveNexumIndexingPolicies({ extensions: extensionBag });
+}
+function classifyRecord(candidate, policies) {
+    const base = {
+        objectType: candidate.objectType,
+        contentType: candidate.contentType,
+        recordId: candidate.recordId,
+        revision: candidate.revision,
+    };
+    if (candidate.objectType.startsWith("nexum-")) {
+        return { ...base, classification: "legacy-nexum-ot" };
+    }
+    const kind = candidate.data && typeof candidate.data.kind === "string"
+        ? candidate.data.kind.trim()
+        : "";
+    if (kind === "knowledge-graph") {
+        return { ...base, classification: "already-indexed" };
+    }
+    const policy = matchNexumIndexingPolicy(candidate, policies);
+    if (!policy) {
+        return { ...base, classification: "no-policy" };
+    }
+    if (!recordToNexumItems(candidate).length) {
+        return { ...base, classification: "no-payload", policyId: policy.id };
+    }
+    return { ...base, classification: "eligible", policyId: policy.id };
+}
+async function* iterateSubjects(input) {
+    const ports = input.platform.portsFor(input.scope);
+    for (const pair of input.pairs) {
+        let cursor;
+        let taken = 0;
+        try {
+            while (taken < input.limitPerPair) {
+                const page = await ports.reader.listContent(input.scope, {
+                    objectType: pair.objectType,
+                    contentType: pair.contentType,
+                    limit: Math.min(100, input.limitPerPair - taken),
+                    cursor,
+                });
+                for (const rec of page.items ?? []) {
+                    const recordId = String(rec.recordId ?? "").trim();
+                    if (!recordId)
+                        continue;
+                    taken += 1;
+                    const data = rec.data && typeof rec.data === "object" && !Array.isArray(rec.data)
+                        ? rec.data
+                        : undefined;
+                    yield {
+                        orgId: input.scope.orgId,
+                        agentIds: input.scope.agentIds,
+                        objectType: pair.objectType,
+                        contentType: pair.contentType,
+                        recordId,
+                        revision: Number(rec.revision ?? 0),
+                        data,
+                    };
+                }
+                cursor = page.nextCursor ?? undefined;
+                if (!cursor || !(page.items?.length))
+                    break;
+            }
+        }
+        catch {
+            // Pair not allowed for this org/pack (e.g. knowx CT missing) — skip.
+            continue;
+        }
+    }
+}
+export async function scanIndexingCandidates(input) {
+    const policies = resolvePolicies(input.platform, input.scope);
+    const pairs = input.pairs?.length ? input.pairs : DEFAULT_SCAN_CTS;
+    const limitPerPair = Math.min(Math.max(input.limitPerPair ?? 200, 1), 2000);
+    const sampleLimit = Math.min(Math.max(input.sampleLimit ?? 50, 0), 500);
+    const counts = {
+        eligible: 0,
+        "already-indexed": 0,
+        "legacy-nexum-ot": 0,
+        "no-policy": 0,
+        "no-payload": 0,
+    };
+    const samples = [];
+    let scanned = 0;
+    for await (const candidate of iterateSubjects({
+        platform: input.platform,
+        scope: input.scope,
+        pairs,
+        limitPerPair,
+    })) {
+        const row = classifyRecord(candidate, policies);
+        counts[row.classification] += 1;
+        scanned += 1;
+        if (samples.length < sampleLimit)
+            samples.push(row);
+    }
+    return {
+        scope: input.scope,
+        scanned,
+        counts,
+        samples,
+        note: "eligible = would enqueue indexing; already-indexed = knowledge-graph snapshots; legacy-nexum-ot = old OT rows (re-index from source subjects, do not rewrite in place)",
+    };
+}
+export async function backfillIndexing(input) {
+    const policies = resolvePolicies(input.platform, input.scope);
+    const pairs = input.pairs?.length ? input.pairs : DEFAULT_SCAN_CTS;
+    const limitPerPair = Math.min(Math.max(input.limitPerPair ?? 200, 1), 2000);
+    const maxEnqueue = Math.min(Math.max(input.maxEnqueue ?? 100, 1), 500);
+    const dryRun = input.dryRun !== false;
+    const results = [];
+    let enqueued = 0;
+    let skipped = 0;
+    let scanned = 0;
+    for await (const candidate of iterateSubjects({
+        platform: input.platform,
+        scope: input.scope,
+        pairs,
+        limitPerPair,
+    })) {
+        scanned += 1;
+        const row = classifyRecord(candidate, policies);
+        if (row.classification !== "eligible") {
+            skipped += 1;
+            continue;
+        }
+        if (enqueued >= maxEnqueue)
+            break;
+        if (dryRun) {
+            enqueued += 1;
+            results.push({
+                recordId: candidate.recordId,
+                objectType: candidate.objectType,
+                contentType: candidate.contentType,
+                status: "would-enqueue",
+                policy: row.policyId,
+            });
+            continue;
+        }
+        const r = await maybeEnqueueNexumAnalysis({
+            platform: input.platform,
+            scope: input.scope,
+            objectType: candidate.objectType,
+            contentType: candidate.contentType,
+            recordId: candidate.recordId,
+            revision: candidate.revision,
+            data: candidate.data,
+        });
+        if (r.status === "queued") {
+            enqueued += 1;
+            results.push({
+                recordId: candidate.recordId,
+                objectType: candidate.objectType,
+                contentType: candidate.contentType,
+                status: "queued",
+                operationId: r.operationId,
+                policy: r.policy,
+            });
+        }
+        else {
+            skipped += 1;
+            results.push({
+                recordId: candidate.recordId,
+                objectType: candidate.objectType,
+                contentType: candidate.contentType,
+                status: "skipped",
+                reason: r.reason,
+                policy: r.policy,
+            });
+        }
+    }
+    return {
+        scope: input.scope,
+        dryRun,
+        scanned,
+        enqueued,
+        skipped,
+        results: results.slice(0, 200),
+    };
+}
+//# sourceMappingURL=backfill.js.map

package/dist/nexum-analysis/backfill.js.map

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

package/dist/nexum-analysis/enqueue.d.ts

@@ -0,0 +1,29 @@
+import type { MemorixPlatform } from "../platform.js";
+import type { MemorixScope } from "../scope.js";
+export type AnalysisEnqueueResult = {
+    status: "queued";
+    policy: string;
+    operationId: string;
+    required: boolean;
+} | {
+    status: "skipped";
+    reason: string;
+    policy?: string;
+};
+/**
+ * The analyze pipeline and its `content`/`snapshots` persist target live on
+ * the host agent that installed them. Writer agents (for example
+ * `network-synapix`) do not carry that pipeline. Union the host agent when
+ * the writer scope cannot see it.
+ */
+export declare function resolveAnalyzeAgentIds(scopeAgentIds: string[], hasPipeline: (agentIds: string[]) => boolean): string[];
+export declare function maybeEnqueueNexumAnalysis(input: {
+    platform: Pick<MemorixPlatform, "metadata" | "operationalDbFor" | "portsFor">;
+    scope: MemorixScope;
+    objectType: string;
+    contentType: string;
+    recordId: string;
+    revision: number;
+    data?: Record<string, unknown>;
+}): Promise<AnalysisEnqueueResult>;
+//# sourceMappingURL=enqueue.d.ts.map

package/dist/nexum-analysis/enqueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enqueue.d.ts","sourceRoot":"","sources":["../../src/nexum-analysis/enqueue.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAYhD,MAAM,MAAM,qBAAqB,GAC7B;IACE,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB,GACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAKN;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,GAC3C,MAAM,EAAE,CASV;AA6BD,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,kBAAkB,GAAG,UAAU,CAAC,CAAC;IAC9E,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA0KjC"}