@x12i/memorix-service 3.7.1 → 3.7.7

package/dist/nexum-analysis/enqueue.js

@@ -0,0 +1,190 @@
+/**
+ * After a successful content write, optionally enqueue Nexum analyze.
+ */
+import { randomUUID } from "node:crypto";
+import { isNexumAutoAnalyzeEnabled, matchNexumIndexingPolicy, recordToNexumItems, resolveNexumIndexingPolicies, } from "./policy.js";
+import { enqueueAnalysisOutbox, markAnalysisOutbox } from "./outbox.js";
+import { invokePipeline } from "../pipeline-invoke.js";
+import { memorixActivityRing } from "../activity-ring.js";
+const HOST_ANALYZE_PIPELINE = "opx-nexum-analyze";
+const HOST_ANALYZE_AGENT = "opx";
+/**
+ * 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 function resolveAnalyzeAgentIds(scopeAgentIds, hasPipeline) {
+    if (hasPipeline(scopeAgentIds))
+        return scopeAgentIds;
+    if (!scopeAgentIds.includes(HOST_ANALYZE_AGENT) &&
+        hasPipeline([HOST_ANALYZE_AGENT])) {
+        return [...scopeAgentIds, HOST_ANALYZE_AGENT];
+    }
+    return scopeAgentIds;
+}
+function emitIndexStatus(input) {
+    memorixActivityRing.recordIndex({
+        orgId: input.orgId,
+        operationId: input.operationId,
+        status: input.status,
+        policyId: input.policyId,
+        runId: input.runId,
+        pipelineId: input.pipelineId,
+        error: input.error,
+        source: input.source,
+    });
+}
+export async function maybeEnqueueNexumAnalysis(input) {
+    if (!isNexumAutoAnalyzeEnabled()) {
+        return { status: "skipped", reason: "indexing disabled" };
+    }
+    if (!process.env.MEMORIX_NEXUM_URL?.trim() && !process.env.NEXUM_URL?.trim()) {
+        return { status: "skipped", reason: "indexing worker unset" };
+    }
+    const effective = input.platform.metadata.resolveEffective(input.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,
+        });
+    }
+    // Prefer custom-kind id used by pack declarations.
+    if (!extensionBag["nexum.indexing-policy"]) {
+        const aliased = (effective.effective ?? []).filter((e) => e.kind === "nexum.indexing-policy");
+        if (aliased.length) {
+            extensionBag["nexum.indexing-policy"] = aliased.map((e) => ({
+                id: e.id,
+                ...e.definition,
+            }));
+        }
+    }
+    const policies = resolveNexumIndexingPolicies({
+        extensions: extensionBag,
+    });
+    const candidate = {
+        orgId: input.scope.orgId,
+        agentIds: input.scope.agentIds,
+        objectType: input.objectType,
+        contentType: input.contentType,
+        recordId: input.recordId,
+        revision: input.revision,
+        data: input.data,
+    };
+    const policy = matchNexumIndexingPolicy(candidate, policies);
+    if (!policy) {
+        return { status: "skipped", reason: "no matching indexing policy" };
+    }
+    const items = recordToNexumItems(candidate);
+    if (!items.length) {
+        return {
+            status: "skipped",
+            reason: "no analyzeable payload",
+            policy: policy.id,
+        };
+    }
+    let db;
+    try {
+        db = input.platform.operationalDbFor(input.scope.orgId);
+    }
+    catch {
+        return {
+            status: "skipped",
+            reason: "operational db unavailable",
+            policy: policy.id,
+        };
+    }
+    const operationId = `anl_${randomUUID().replace(/-/g, "").slice(0, 16)}`;
+    await enqueueAnalysisOutbox(db, {
+        candidate,
+        policyId: policy.id,
+        operationId,
+    });
+    const source = {
+        objectType: candidate.objectType,
+        contentType: candidate.contentType,
+        recordId: candidate.recordId,
+        revision: candidate.revision,
+    };
+    emitIndexStatus({
+        orgId: candidate.orgId,
+        operationId,
+        status: "queued",
+        policyId: policy.id,
+        source,
+    });
+    // Fire-and-forget pipeline start (do not block write response).
+    void (async () => {
+        try {
+            await markAnalysisOutbox(db, candidate, {
+                status: "analyzing",
+                pipelineId: HOST_ANALYZE_PIPELINE,
+            });
+            emitIndexStatus({
+                orgId: candidate.orgId,
+                operationId,
+                status: "analyzing",
+                policyId: policy.id,
+                pipelineId: HOST_ANALYZE_PIPELINE,
+                source,
+            });
+            const analyzeAgentIds = resolveAnalyzeAgentIds(input.scope.agentIds, (agentIds) => Boolean(input.platform.metadata.getDefinition(agentIds, "pipelines", HOST_ANALYZE_PIPELINE)?.definition));
+            const result = await invokePipeline({
+                platform: input.platform,
+                orgId: input.scope.orgId,
+                agentIds: analyzeAgentIds,
+                pipelineId: HOST_ANALYZE_PIPELINE,
+                input: { items },
+                wait: true,
+            });
+            const status = result.status === "succeeded" ? "succeeded" : "failed";
+            await markAnalysisOutbox(db, candidate, {
+                status,
+                runId: result.run.runId,
+                pipelineId: result.pipelineId,
+                error: result.status === "succeeded"
+                    ? undefined
+                    : String(result.run.error ?? result.status),
+            });
+            emitIndexStatus({
+                orgId: candidate.orgId,
+                operationId,
+                status,
+                policyId: policy.id,
+                runId: result.run.runId,
+                pipelineId: result.pipelineId,
+                error: result.status === "succeeded"
+                    ? undefined
+                    : String(result.run.error ?? result.status),
+                source,
+            });
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            await markAnalysisOutbox(db, candidate, {
+                status: "failed",
+                error,
+            }).catch(() => undefined);
+            emitIndexStatus({
+                orgId: candidate.orgId,
+                operationId,
+                status: "failed",
+                policyId: policy.id,
+                error,
+                source,
+            });
+        }
+    })();
+    return {
+        status: "queued",
+        policy: policy.id,
+        operationId,
+        required: policy.processing?.mode === "async-required",
+    };
+}
+//# sourceMappingURL=enqueue.js.map

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * Durable Nexum analysis outbox in `{orgId}_operational.nexum-analysis-outbox`.
+ * Unique on address+revision; newer revisions supersede older queued/analyzing rows.
+ */
+import type { Db } from "mongodb";
+import type { AnalysisCandidate } from "./policy.js";
+export type AnalysisOutboxStatus = "queued" | "analyzing" | "succeeded" | "failed" | "skipped" | "superseded" | "dead-letter";
+export type AnalysisOutboxRow = {
+    operationId: string;
+    orgId: string;
+    agentIds: string[];
+    objectType: string;
+    contentType: string;
+    recordId: string;
+    revision: number;
+    policyId: string;
+    status: AnalysisOutboxStatus;
+    pipelineId?: string;
+    runId?: string;
+    error?: string;
+    attempts?: number;
+    enqueuedAt: string;
+    updatedAt: string;
+};
+export declare function enqueueAnalysisOutbox(db: Db, input: {
+    candidate: AnalysisCandidate;
+    policyId: string;
+    operationId: string;
+}): Promise<AnalysisOutboxRow>;
+export declare function markAnalysisOutbox(db: Db, candidate: AnalysisCandidate, patch: Partial<Pick<AnalysisOutboxRow, "status" | "pipelineId" | "runId" | "error" | "attempts">>): Promise<void>;
+export declare function listQueuedAnalysis(db: Db, limit?: number): Promise<AnalysisOutboxRow[]>;
+/**
+ * Reconcile scanner: requeue stale failed rows (bounded attempts) or DLQ;
+ * DLQ stuck analyzing rows past STALE_MS.
+ */
+export declare function reconcileAnalysisOutbox(db: Db, opts?: {
+    now?: Date;
+    staleMs?: number;
+    maxAttempts?: number;
+}): Promise<{
+    requeued: number;
+    deadLetter: number;
+}>;
+//# sourceMappingURL=outbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outbox.d.ts","sourceRoot":"","sources":["../../src/nexum-analysis/outbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,WAAW,GACX,WAAW,GACX,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,aAAa,CAAC;AAElB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AA8CF,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,EAAE,EACN,KAAK,EAAE;IACL,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,iBAAiB,CAAC,CAyD5B;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,OAAO,CACZ,IAAI,CACF,iBAAiB,EACjB,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CACzD,CACF,GACA,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,EAAE,EACN,KAAK,SAAK,GACT,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAc9B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,EAAE,EACN,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CA2EnD"}

package/dist/nexum-analysis/outbox.js

@@ -0,0 +1,176 @@
+import { memorixActivityRing } from "../activity-ring.js";
+const COLL = "nexum-analysis-outbox";
+const MAX_ATTEMPTS = 5;
+/** Stuck analyzing / failed rows older than this move to dead-letter (or requeue once). */
+const STALE_MS = 15 * 60 * 1000;
+function rowId(c) {
+    return `${c.orgId}\0${c.objectType}\0${c.contentType}\0${c.recordId}\0${c.revision}`;
+}
+function addressFilter(c) {
+    return {
+        orgId: c.orgId,
+        objectType: c.objectType,
+        contentType: c.contentType,
+        recordId: c.recordId,
+    };
+}
+function emitOutboxActivity(row) {
+    memorixActivityRing.recordIndex({
+        orgId: row.orgId,
+        operationId: row.operationId,
+        status: row.status,
+        policyId: row.policyId,
+        error: row.error,
+        source: {
+            objectType: row.objectType,
+            contentType: row.contentType,
+            recordId: row.recordId,
+            revision: row.revision,
+        },
+    });
+}
+export async function enqueueAnalysisOutbox(db, input) {
+    const now = new Date().toISOString();
+    const row = {
+        operationId: input.operationId,
+        orgId: input.candidate.orgId,
+        agentIds: [...input.candidate.agentIds],
+        objectType: input.candidate.objectType,
+        contentType: input.candidate.contentType,
+        recordId: input.candidate.recordId,
+        revision: input.candidate.revision,
+        policyId: input.policyId,
+        status: "queued",
+        attempts: 0,
+        enqueuedAt: now,
+        updatedAt: now,
+    };
+    const coll = db.collection(COLL);
+    // Supersede older revisions still in flight for the same address.
+    const superseded = await coll.find({
+        ...addressFilter(input.candidate),
+        revision: { $lt: input.candidate.revision },
+        status: { $in: ["queued", "analyzing", "failed"] },
+    }).toArray();
+    await coll.updateMany({
+        ...addressFilter(input.candidate),
+        revision: { $lt: input.candidate.revision },
+        status: { $in: ["queued", "analyzing", "failed"] },
+    }, {
+        $set: {
+            status: "superseded",
+            updatedAt: now,
+            error: `superseded by revision ${input.candidate.revision}`,
+        },
+    });
+    for (const raw of superseded) {
+        const prev = raw;
+        emitOutboxActivity({
+            orgId: prev.orgId,
+            operationId: prev.operationId,
+            status: "superseded",
+            policyId: prev.policyId,
+            error: `superseded by revision ${input.candidate.revision}`,
+            objectType: prev.objectType,
+            contentType: prev.contentType,
+            recordId: prev.recordId,
+            revision: prev.revision,
+        });
+    }
+    await coll.updateOne({ _id: rowId(input.candidate) }, { $set: row }, { upsert: true });
+    return row;
+}
+export async function markAnalysisOutbox(db, candidate, patch) {
+    await db.collection(COLL).updateOne({ _id: rowId(candidate) }, {
+        $set: {
+            ...patch,
+            updatedAt: new Date().toISOString(),
+        },
+    });
+}
+export async function listQueuedAnalysis(db, limit = 50) {
+    const rows = await db
+        .collection(COLL)
+        .find({ status: "queued" })
+        .sort({ enqueuedAt: 1 })
+        .limit(limit)
+        .toArray();
+    return rows.map((r) => {
+        const { _id: _unused, ...rest } = r;
+        void _unused;
+        return rest;
+    });
+}
+/**
+ * Reconcile scanner: requeue stale failed rows (bounded attempts) or DLQ;
+ * DLQ stuck analyzing rows past STALE_MS.
+ */
+export async function reconcileAnalysisOutbox(db, opts) {
+    const now = opts?.now ?? new Date();
+    const staleMs = opts?.staleMs ?? STALE_MS;
+    const maxAttempts = opts?.maxAttempts ?? MAX_ATTEMPTS;
+    const cutoff = new Date(now.getTime() - staleMs).toISOString();
+    const coll = db.collection(COLL);
+    let requeued = 0;
+    let deadLetter = 0;
+    const stale = await coll
+        .find({
+        status: { $in: ["analyzing", "failed"] },
+        updatedAt: { $lt: cutoff },
+    })
+        .limit(100)
+        .toArray();
+    for (const raw of stale) {
+        const row = raw;
+        const attempts = Number(row.attempts ?? 0);
+        const iso = now.toISOString();
+        if (row.status === "failed" && attempts < maxAttempts) {
+            await coll.updateOne({ _id: raw._id }, {
+                $set: {
+                    status: "queued",
+                    updatedAt: iso,
+                    error: undefined,
+                },
+                $inc: { attempts: 1 },
+            });
+            requeued += 1;
+            emitOutboxActivity({
+                orgId: row.orgId,
+                operationId: row.operationId,
+                status: "queued",
+                policyId: row.policyId,
+                objectType: row.objectType,
+                contentType: row.contentType,
+                recordId: row.recordId,
+                revision: row.revision,
+            });
+        }
+        else {
+            const error = row.error ??
+                (row.status === "analyzing"
+                    ? "stale analyzing → dead-letter"
+                    : "max attempts → dead-letter");
+            await coll.updateOne({ _id: raw._id }, {
+                $set: {
+                    status: "dead-letter",
+                    updatedAt: iso,
+                    error,
+                },
+            });
+            deadLetter += 1;
+            emitOutboxActivity({
+                orgId: row.orgId,
+                operationId: row.operationId,
+                status: "dead-letter",
+                policyId: row.policyId,
+                error,
+                objectType: row.objectType,
+                contentType: row.contentType,
+                recordId: row.recordId,
+                revision: row.revision,
+            });
+        }
+    }
+    return { requeued, deadLetter };
+}
+//# sourceMappingURL=outbox.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outbox.js","sourceRoot":"","sources":["../../src/nexum-analysis/outbox.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AA6B1D,MAAM,IAAI,GAAG,uBAAuB,CAAC;AACrC,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,2FAA2F;AAC3F,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEhC,SAAS,KAAK,CAAC,CAAoB;IACjC,OAAO,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;AACvF,CAAC;AAED,SAAS,aAAa,CAAC,CAAoB;IACzC,OAAO;QACL,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,GAU3B;IACC,mBAAmB,CAAC,WAAW,CAAC;QAC9B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE;YACN,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,EAAM,EACN,KAIC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,GAAG,GAAsB;QAC7B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK;QAC5B,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC;QACvC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU;QACtC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW;QACxC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ;QAClC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,CAAC;QACX,UAAU,EAAE,GAAG;QACf,SAAS,EAAE,GAAG;KACf,CAAC;IACF,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,kEAAkE;IAClE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;QACjC,GAAG,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC;QACjC,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE;QAC3C,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE;KACnD,CAAC,CAAC,OAAO,EAAE,CAAC;IACb,MAAM,IAAI,CAAC,UAAU,CACnB;QACE,GAAG,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC;QACjC,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE;QAC3C,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE;KACnD,EACD;QACE,IAAI,EAAE;YACJ,MAAM,EAAE,YAAY;YACpB,SAAS,EAAE,GAAG;YACd,KAAK,EAAE,0BAA0B,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE;SAC5D;KACF,CACF,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,GAAmC,CAAC;QACjD,kBAAkB,CAAC;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,0BAA0B,KAAK,CAAC,SAAS,CAAC,QAAQ,EAAE;YAC3D,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,CAAC,SAAS,CAClB,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,CAAU,EAAE,EACxC,EAAE,IAAI,EAAE,GAAG,EAAE,EACb,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,EAAM,EACN,SAA4B,EAC5B,KAKC;IAED,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,CACjC,EAAE,GAAG,EAAE,KAAK,CAAC,SAAS,CAAU,EAAE,EAClC;QACE,IAAI,EAAE;YACJ,GAAG,KAAK;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC;KACF,CACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,EAAM,EACN,KAAK,GAAG,EAAE;IAEV,MAAM,IAAI,GAAG,MAAM,EAAE;SAClB,UAAU,CAAC,IAAI,CAAC;SAChB,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;SAC1B,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;SACvB,KAAK,CAAC,KAAK,CAAC;SACZ,OAAO,EAAE,CAAC;IACb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACpB,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,CAEjC,CAAC;QACF,KAAK,OAAO,CAAC;QACb,OAAO,IAAyB,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,EAAM,EACN,IAA6D;IAE7D,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,QAAQ,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,YAAY,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/D,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,MAAM,KAAK,GAAG,MAAM,IAAI;SACrB,IAAI,CAAC;QACJ,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE;QACxC,SAAS,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;KAC3B,CAAC;SACD,KAAK,CAAC,GAAG,CAAC;SACV,OAAO,EAAE,CAAC;IAEb,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,GAA4C,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAC9B,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC;YACtD,MAAM,IAAI,CAAC,SAAS,CAClB,EAAE,GAAG,EAAE,GAAG,CAAC,GAAY,EAAE,EACzB;gBACE,IAAI,EAAE;oBACJ,MAAM,EAAE,QAAQ;oBAChB,SAAS,EAAE,GAAG;oBACd,KAAK,EAAE,SAAS;iBACjB;gBACD,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;aACtB,CACF,CAAC;YACF,QAAQ,IAAI,CAAC,CAAC;YACd,kBAAkB,CAAC;gBACjB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GACT,GAAG,CAAC,KAAK;gBACT,CAAC,GAAG,CAAC,MAAM,KAAK,WAAW;oBACzB,CAAC,CAAC,+BAA+B;oBACjC,CAAC,CAAC,4BAA4B,CAAC,CAAC;YACpC,MAAM,IAAI,CAAC,SAAS,CAClB,EAAE,GAAG,EAAE,GAAG,CAAC,GAAY,EAAE,EACzB;gBACE,IAAI,EAAE;oBACJ,MAAM,EAAE,aAAa;oBACrB,SAAS,EAAE,GAAG;oBACd,KAAK;iBACN;aACF,CACF,CAAC;YACF,UAAU,IAAI,CAAC,CAAC;YAChB,kBAAkB,CAAC;gBACjB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,MAAM,EAAE,aAAa;gBACrB,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,KAAK;gBACL,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,48 @@
+/**
+ * Nexum auto-analyze eligibility (metadata policy + env gate).
+ * Hard exclusions prevent loops on knowledge-graph subjects we just wrote.
+ */
+export type NexumIndexingPolicy = {
+    id: string;
+    enabled: boolean;
+    match: {
+        objectTypes?: string[];
+        contentTypes?: string[];
+        excludeObjectTypes?: string[];
+        excludeContentTypes?: string[];
+    };
+    processing?: {
+        mode?: "async-required" | "async" | "off";
+    };
+};
+export type AnalysisCandidate = {
+    orgId: string;
+    agentIds: string[];
+    objectType: string;
+    contentType: string;
+    recordId: string;
+    revision: number;
+    data?: Record<string, unknown>;
+};
+/**
+ * Env master switch — indexing is **on by default**.
+ * Opt out with `NEXUM_AUTO_ANALYZE=0` / `false` / `no` / `off`.
+ */
+export declare function isNexumAutoAnalyzeEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function parsePoliciesFromExtensions(extensions: Record<string, unknown> | undefined | null): NexumIndexingPolicy[];
+export declare function matchNexumIndexingPolicy(candidate: Pick<AnalysisCandidate, "objectType" | "contentType" | "data">, policies: NexumIndexingPolicy[]): NexumIndexingPolicy | null;
+export declare function resolveNexumIndexingPolicies(input: {
+    extensions?: Record<string, unknown> | null;
+    env?: NodeJS.ProcessEnv;
+}): NexumIndexingPolicy[];
+/** Map a landed Memorix record into Nexum analyze items[]. */
+export declare function recordToNexumItems(candidate: AnalysisCandidate): Array<{
+    id: string;
+    inputType: "content" | "structured" | "unknown";
+    objectType?: string;
+    title?: string;
+    format?: string;
+    content?: string;
+    data?: Record<string, unknown>;
+}>;
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/nexum-analysis/policy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE;QACL,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;KAChC,CAAC;IACF,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,GAAG,KAAK,CAAC;KAC3C,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,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,CAAC;AAyBF;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAMT;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACrD,mBAAmB,EAAE,CAwCvB;AAiBD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,IAAI,CACb,iBAAiB,EACjB,YAAY,GAAG,aAAa,GAAG,MAAM,CACtC,EACD,QAAQ,EAAE,mBAAmB,EAAE,GAC9B,mBAAmB,GAAG,IAAI,CAwB5B;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,mBAAmB,EAAE,CAIxB;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,KAAK,CAAC;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC,CAsCD"}

package/dist/nexum-analysis/policy.js

@@ -0,0 +1,165 @@
+/**
+ * Nexum auto-analyze eligibility (metadata policy + env gate).
+ * Hard exclusions prevent loops on knowledge-graph subjects we just wrote.
+ */
+const DEFAULT_POLICIES = [
+    {
+        id: "default-content-knowledge",
+        enabled: true,
+        match: {
+            objectTypes: ["content"],
+            contentTypes: ["snapshots", "knowx"],
+            excludeContentTypes: ["raw", "nexum"],
+        },
+        processing: { mode: "async-required" },
+    },
+];
+function asRecord(v) {
+    return v && typeof v === "object" && !Array.isArray(v)
+        ? v
+        : null;
+}
+function asString(v) {
+    return typeof v === "string" ? v.trim() : "";
+}
+/**
+ * Env master switch — indexing is **on by default**.
+ * Opt out with `NEXUM_AUTO_ANALYZE=0` / `false` / `no` / `off`.
+ */
+export function isNexumAutoAnalyzeEnabled(env = process.env) {
+    const raw = String(env.NEXUM_AUTO_ANALYZE ?? "")
+        .trim()
+        .toLowerCase();
+    if (!raw)
+        return true;
+    return !(raw === "0" || raw === "false" || raw === "no" || raw === "off");
+}
+export function parsePoliciesFromExtensions(extensions) {
+    const bag = extensions?.["nexum.indexing-policy"] ??
+        extensions?.["nexum-indexing-policy"];
+    if (!Array.isArray(bag))
+        return [];
+    const out = [];
+    for (const raw of bag) {
+        const o = asRecord(raw);
+        if (!o)
+            continue;
+        const id = asString(o.id);
+        if (!id)
+            continue;
+        const match = asRecord(o.match) ?? {};
+        out.push({
+            id,
+            enabled: o.enabled !== false,
+            match: {
+                objectTypes: Array.isArray(match.objectTypes)
+                    ? match.objectTypes.map(asString).filter(Boolean)
+                    : undefined,
+                contentTypes: Array.isArray(match.contentTypes)
+                    ? match.contentTypes.map(asString).filter(Boolean)
+                    : undefined,
+                excludeObjectTypes: Array.isArray(match.excludeObjectTypes)
+                    ? match.excludeObjectTypes.map(asString).filter(Boolean)
+                    : undefined,
+                excludeContentTypes: Array.isArray(match.excludeContentTypes)
+                    ? match.excludeContentTypes.map(asString).filter(Boolean)
+                    : undefined,
+            },
+            processing: {
+                mode: asString(asRecord(o.processing)?.mode) === "off"
+                    ? "off"
+                    : asString(asRecord(o.processing)?.mode) === "async"
+                        ? "async"
+                        : "async-required",
+            },
+        });
+    }
+    return out;
+}
+function matchesList(value, list) {
+    if (!list?.length)
+        return true;
+    return list.some((p) => p === "*" || p === value);
+}
+function excluded(value, list) {
+    if (!list?.length)
+        return false;
+    return list.some((p) => {
+        if (p === value)
+            return true;
+        if (p.endsWith("-*") && value.startsWith(p.slice(0, -1)))
+            return true;
+        if (p.endsWith("*") && value.startsWith(p.slice(0, -1)))
+            return true;
+        return false;
+    });
+}
+export function matchNexumIndexingPolicy(candidate, policies) {
+    const kind = asString(candidate.data?.kind);
+    // Never re-analyze Nexum persist output (loop guard).
+    if (kind === "knowledge-graph")
+        return null;
+    if (candidate.objectType.startsWith("nexum-"))
+        return null;
+    if (candidate.contentType === "nexum")
+        return null;
+    for (const policy of policies) {
+        if (!policy.enabled)
+            continue;
+        if (policy.processing?.mode === "off")
+            continue;
+        if (excluded(candidate.objectType, policy.match.excludeObjectTypes) ||
+            excluded(candidate.contentType, policy.match.excludeContentTypes)) {
+            continue;
+        }
+        if (matchesList(candidate.objectType, policy.match.objectTypes) &&
+            matchesList(candidate.contentType, policy.match.contentTypes)) {
+            return policy;
+        }
+    }
+    return null;
+}
+export function resolveNexumIndexingPolicies(input) {
+    const fromPack = parsePoliciesFromExtensions(input.extensions);
+    if (fromPack.length)
+        return fromPack;
+    return DEFAULT_POLICIES;
+}
+/** Map a landed Memorix record into Nexum analyze items[]. */
+export function recordToNexumItems(candidate) {
+    const data = candidate.data ?? {};
+    const markdown = typeof data.markdown === "string" ? data.markdown.trim() : "";
+    if (markdown) {
+        return [
+            {
+                id: candidate.recordId,
+                inputType: "content",
+                objectType: candidate.objectType,
+                title: (typeof data.title === "string" && data.title.trim()) ||
+                    candidate.recordId,
+                format: (typeof data.sourceFormat === "string" && data.sourceFormat) ||
+                    "markdown",
+                content: markdown,
+            },
+        ];
+    }
+    if (Object.keys(data).length === 0)
+        return [];
+    return [
+        {
+            id: candidate.recordId,
+            inputType: "structured",
+            objectType: candidate.objectType,
+            title: (typeof data.title === "string" && data.title.trim()) ||
+                (typeof data.label === "string" && data.label.trim()) ||
+                candidate.recordId,
+            data: {
+                ...data,
+                contentType: candidate.contentType,
+                recordId: candidate.recordId,
+                revision: candidate.revision,
+            },
+        },
+    ];
+}
+//# sourceMappingURL=policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/nexum-analysis/policy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH,MAAM,gBAAgB,GAA0B;IAC9C;QACE,EAAE,EAAE,2BAA2B;QAC/B,OAAO,EAAE,IAAI;QACb,KAAK,EAAE;YACL,WAAW,EAAE,CAAC,SAAS,CAAC;YACxB,YAAY,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;YACpC,mBAAmB,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;SACtC;QACD,UAAU,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE;KACvC;CACF,CAAC;AAEF,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACpD,CAAC,CAAE,CAA6B;QAChC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC;SAC7C,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;IACjB,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,UAAsD;IAEtD,MAAM,GAAG,GACP,UAAU,EAAE,CAAC,uBAAuB,CAAC;QACrC,UAAU,EAAE,CAAC,uBAAuB,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAA0B,EAAE,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,EAAE;YAAE,SAAS;QAClB,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC;YACP,EAAE;YACF,OAAO,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK;YAC5B,KAAK,EAAE;gBACL,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;oBAC3C,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;oBACjD,CAAC,CAAC,SAAS;gBACb,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;oBAC7C,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;oBAClD,CAAC,CAAC,SAAS;gBACb,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC;oBACzD,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;oBACxD,CAAC,CAAC,SAAS;gBACb,mBAAmB,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC;oBAC3D,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;oBACzD,CAAC,CAAC,SAAS;aACd;YACD,UAAU,EAAE;gBACV,IAAI,EACF,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,KAAK,KAAK;oBAC9C,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,KAAK,OAAO;wBAClD,CAAC,CAAC,OAAO;wBACT,CAAC,CAAC,gBAAgB;aACzB;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,EAAE,IAA0B;IAC5D,IAAI,CAAC,IAAI,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,IAA0B;IACzD,IAAI,CAAC,IAAI,EAAE,MAAM;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACrB,IAAI,CAAC,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QAC7B,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACtE,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACrE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,SAGC,EACD,QAA+B;IAE/B,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,sDAAsD;IACtD,IAAI,IAAI,KAAK,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,IAAI,SAAS,CAAC,WAAW,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAEnD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,SAAS;QAC9B,IAAI,MAAM,CAAC,UAAU,EAAE,IAAI,KAAK,KAAK;YAAE,SAAS;QAChD,IACE,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC;YAC/D,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,EACjE,CAAC;YACD,SAAS;QACX,CAAC;QACD,IACE,WAAW,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC;YAC3D,WAAW,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAC7D,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAG5C;IACC,MAAM,QAAQ,GAAG,2BAA2B,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/D,IAAI,QAAQ,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IACrC,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,kBAAkB,CAAC,SAA4B;IAS7D,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;IAClC,MAAM,QAAQ,GACZ,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL;gBACE,EAAE,EAAE,SAAS,CAAC,QAAQ;gBACtB,SAAS,EAAE,SAAS;gBACpB,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,KAAK,EACH,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBACrD,SAAS,CAAC,QAAQ;gBACpB,MAAM,EACJ,CAAC,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,IAAI,IAAI,CAAC,YAAY,CAAC;oBAC5D,UAAU;gBACZ,OAAO,EAAE,QAAQ;aAClB;SACF,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9C,OAAO;QACL;YACE,EAAE,EAAE,SAAS,CAAC,QAAQ;YACtB,SAAS,EAAE,YAAY;YACvB,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,KAAK,EACH,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACrD,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACrD,SAAS,CAAC,QAAQ;YACpB,IAAI,EAAE;gBACJ,GAAG,IAAI;gBACP,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,QAAQ,EAAE,SAAS,CAAC,QAAQ;aAC7B;SACF;KACF,CAAC;AACJ,CAAC"}