@exellix/exellix-runtime 3.5.1

package/dist/execution-matrix/matrix-logxer.d.ts

@@ -0,0 +1,15 @@
+import { type Logxer } from '@x12i/logxer';
+import type { LogxerQueryableClient } from '@exellix/graph-engine';
+/**
+ * Package-scoped Logxer: levels from **`EXELLIX_RUNTIME_LOGS_LEVEL`** (canonical) or legacy **`EXELLIX_RUNTIME_LOG_LEVEL`**.
+ * Enables in-process **`getJobLogs`** for playground-style observability (see `@x12i/logxer` docs/package-usage.md).
+ * For Mongo query logs, set **`MONGO_URI`** (and often **`logxer_mongo_db_logs_level=info`**, default DB level is warn).
+ */
+export declare function createExecutionMatrixLogxer(): Logxer;
+/** Shared default instance for orchestration when the host does not inject **`matrixLogxer`** on claim deps. */
+export declare function getExecutionMatrixLogxer(): Logxer;
+/**
+ * Adapts `@x12i/logxer` **`getJobLogs`** results to the minimal **`LogxerQueryableClient`** shape used by graph-engine types.
+ */
+export declare function createMatrixLogxerQueryableClient(logxer: Logxer): LogxerQueryableClient;
+//# sourceMappingURL=matrix-logxer.d.ts.map

package/dist/execution-matrix/matrix-logxer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-logxer.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/matrix-logxer.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,MAAM,EAAyB,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAiB,MAAM,uBAAuB,CAAC;AAelF;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CASpD;AAED,gHAAgH;AAChH,wBAAgB,wBAAwB,IAAI,MAAM,CAGjD;AAkBD;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAevF"}

package/dist/execution-matrix/matrix-logxer.js

@@ -0,0 +1,65 @@
+import { initConfig } from '@x12i/env';
+import { createLogxer } from '@x12i/logxer';
+const PACKAGE_NAME = '@exellix/exellix-runtime';
+const ENV_PREFIX = 'EXELLIX_RUNTIME';
+let defaultLogxer;
+let dotenvAppliedForLogxer = false;
+function ensureProcessEnvFromDotenvBeforeLogxer() {
+    if (dotenvAppliedForLogxer)
+        return;
+    dotenvAppliedForLogxer = true;
+    // Logxer reads MONGO_URI etc. from process.env at construction; load .env first (CLI: `x12i-env run --env-file .env -- ...`).
+    initConfig({}, { dotenvPath: '.env', throwOnMissing: false });
+}
+/**
+ * Package-scoped Logxer: levels from **`EXELLIX_RUNTIME_LOGS_LEVEL`** (canonical) or legacy **`EXELLIX_RUNTIME_LOG_LEVEL`**.
+ * Enables in-process **`getJobLogs`** for playground-style observability (see `@x12i/logxer` docs/package-usage.md).
+ * For Mongo query logs, set **`MONGO_URI`** (and often **`logxer_mongo_db_logs_level=info`**, default DB level is warn).
+ */
+export function createExecutionMatrixLogxer() {
+    ensureProcessEnvFromDotenvBeforeLogxer();
+    return createLogxer({ packageName: PACKAGE_NAME, envPrefix: ENV_PREFIX, debugNamespace: 'exellix-runtime' }, {
+        queryStore: { enabled: true },
+        queryCache: { enabled: true },
+    });
+}
+/** Shared default instance for orchestration when the host does not inject **`matrixLogxer`** on claim deps. */
+export function getExecutionMatrixLogxer() {
+    if (!defaultLogxer)
+        defaultLogxer = createExecutionMatrixLogxer();
+    return defaultLogxer;
+}
+const QUERY_LEVELS = new Set(['debug', 'info', 'warn', 'error']);
+function mapEnvelopeToLogxerLine(line) {
+    const lv = String(line.level || '').toLowerCase();
+    const level = QUERY_LEVELS.has(lv) ? lv : undefined;
+    return {
+        ts: line.timestamp,
+        level,
+        scope: line.source,
+        packageName: line.package,
+        nodeId: line.nodeId,
+        message: line.message,
+        data: line.data,
+    };
+}
+/**
+ * Adapts `@x12i/logxer` **`getJobLogs`** results to the minimal **`LogxerQueryableClient`** shape used by graph-engine types.
+ */
+export function createMatrixLogxerQueryableClient(logxer) {
+    return {
+        async getJobLogs(input) {
+            const res = await logxer.getJobLogs({
+                jobId: input.jobId,
+                graphId: input.graphId,
+                nodeId: input.nodeId,
+                limit: input.limit,
+            });
+            return {
+                jobId: res.jobId,
+                lines: res.lines.map(mapEnvelopeToLogxerLine),
+            };
+        },
+    };
+}
+//# sourceMappingURL=matrix-logxer.js.map

package/dist/execution-matrix/matrix-logxer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-logxer.js","sourceRoot":"","sources":["../../src/execution-matrix/matrix-logxer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAsC,MAAM,cAAc,CAAC;AAGhF,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAChD,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAErC,IAAI,aAAiC,CAAC;AACtC,IAAI,sBAAsB,GAAG,KAAK,CAAC;AAEnC,SAAS,sCAAsC;IAC7C,IAAI,sBAAsB;QAAE,OAAO;IACnC,sBAAsB,GAAG,IAAI,CAAC;IAC9B,8HAA8H;IAC9H,UAAU,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,sCAAsC,EAAE,CAAC;IACzC,OAAO,YAAY,CACjB,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,EACvF;QACE,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC7B,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;KAC9B,CACF,CAAC;AACJ,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC,aAAa;QAAE,aAAa,GAAG,2BAA2B,EAAE,CAAC;IAClE,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjE,SAAS,uBAAuB,CAAC,IAAsB;IACrD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,EAA6B,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,SAAS;QAClB,KAAK;QACL,KAAK,EAAE,IAAI,CAAC,MAAM;QAClB,WAAW,EAAE,IAAI,CAAC,OAAO;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iCAAiC,CAAC,MAAc;IAC9D,OAAO;QACL,KAAK,CAAC,UAAU,CAAC,KAAK;YACpB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;gBAClC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC,CAAC;YACH,OAAO;gBACL,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC;aAC9C,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/execution-matrix/matrix-read-tier.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Read-only matrix tier: opens Mongo via {@link createExellixMatrixDataTier} and exposes dashboard helpers.
+ * Replaces the former `@exellix/exellix-matrix-read` package for in-process / BFF use.
+ */
+import type { MemorixRuntimeTier, XmemoryDataTier } from './memorix-runtime-tier.js';
+import { type ExellixConfigStore } from './config-store.js';
+import { type FetchGraphOperationalDashboardSliceQuery, type GraphOperationalDashboardSlice } from './graph-operational-aggregates.js';
+import { type FetchMemorixMatrixEntityFacetQuery, type MemorixMatrixEntityFacetResult } from './memorix-matrix-entity-facet.js';
+import { type CreateExellixMatrixDataTierOptions, type ExellixMatrixDataTier } from './matrix-data-tier.js';
+import { type ExecutionMatrixMultiGraphRowView, type FetchExecutionMatrixMultiGraphOverviewQuery, type FetchSourceJoinViewQuery, type NavigatorPage } from './navigator.js';
+import { type ExecutionMatrixRuntime } from './runtime-store.js';
+import type { ExecutionMatrixFailureRecord, ListFailureRecordsOptions, ListMatrixRowsOptions } from './contracts.js';
+import type { MatrixSourceResolver } from './source-resolver.js';
+import type { SourceJoinView } from './navigator.js';
+export type OpenMatrixReadTierOptions = CreateExellixMatrixDataTierOptions & {
+    memorixTier?: MemorixRuntimeTier | XmemoryDataTier;
+};
+export type MatrixReadTier = {
+    readonly runtime: ExecutionMatrixRuntime;
+    readonly configStore: ExellixConfigStore;
+    readonly memorixTier?: XmemoryDataTier;
+    graphDashboard: (query: FetchGraphOperationalDashboardSliceQuery) => Promise<GraphOperationalDashboardSlice>;
+    navigatorPage: (query: ListMatrixRowsOptions & {
+        graphId?: string;
+        includeFailureCount?: boolean;
+    }) => Promise<NavigatorPage>;
+    sourceJoinView: (query: FetchSourceJoinViewQuery, opts?: {
+        sourceResolver?: MatrixSourceResolver;
+    }) => Promise<SourceJoinView>;
+    multiGraphOverview: (query: FetchExecutionMatrixMultiGraphOverviewQuery) => Promise<ExecutionMatrixMultiGraphRowView[]>;
+    entityFacet: (query: FetchMemorixMatrixEntityFacetQuery) => Promise<MemorixMatrixEntityFacetResult>;
+    listFailureRecords: (opts: ListFailureRecordsOptions, readManyCap?: number) => Promise<ExecutionMatrixFailureRecord[]>;
+    getFailureRecord: (failureId: string) => Promise<ExecutionMatrixFailureRecord | null>;
+    getLatestFailureRecordForRowGraph: (matrixRowId: string, graphId: string, opts?: {
+        matrixCatalogId?: string;
+    }) => Promise<ExecutionMatrixFailureRecord | null>;
+    close: () => Promise<void>;
+};
+export declare function openMatrixReadTier(options?: OpenMatrixReadTierOptions): Promise<MatrixReadTier>;
+export declare function createMatrixReadTierFromDataTier(dataTier: ExellixMatrixDataTier, memorixTier?: XmemoryDataTier): Promise<MatrixReadTier>;
+//# sourceMappingURL=matrix-read-tier.d.ts.map

package/dist/execution-matrix/matrix-read-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-read-tier.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/matrix-read-tier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAEL,KAAK,wCAAwC,EAC7C,KAAK,8BAA8B,EACpC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAiC,KAAK,kCAAkC,EAAE,KAAK,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAC/J,OAAO,EAEL,KAAK,kCAAkC,EACvC,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAIL,KAAK,gCAAgC,EACrC,KAAK,2CAA2C,EAChD,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAgC,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC/F,OAAO,KAAK,EACV,4BAA4B,EAC5B,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,yBAAyB,GAAG,kCAAkC,GAAG;IAC3E,WAAW,CAAC,EAAE,kBAAkB,GAAG,eAAe,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;IACvC,cAAc,EAAE,CAAC,KAAK,EAAE,wCAAwC,KAAK,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC7G,aAAa,EAAE,CACb,KAAK,EAAE,qBAAqB,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAE,KAC/E,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B,cAAc,EAAE,CACd,KAAK,EAAE,wBAAwB,EAC/B,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,oBAAoB,CAAA;KAAE,KAC7C,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,kBAAkB,EAAE,CAClB,KAAK,EAAE,2CAA2C,KAC/C,OAAO,CAAC,gCAAgC,EAAE,CAAC,CAAC;IACjD,WAAW,EAAE,CAAC,KAAK,EAAE,kCAAkC,KAAK,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACpG,kBAAkB,EAAE,CAClB,IAAI,EAAE,yBAAyB,EAC/B,WAAW,CAAC,EAAE,MAAM,KACjB,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAAC;IAC7C,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;IACtF,iCAAiC,EAAE,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,KAChC,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;IAClD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,cAAc,CAAC,CAIzG;AAED,wBAAsB,gCAAgC,CACpD,QAAQ,EAAE,qBAAqB,EAC/B,WAAW,CAAC,EAAE,eAAe,GAC5B,OAAO,CAAC,cAAc,CAAC,CAqCzB"}

package/dist/execution-matrix/matrix-read-tier.js

@@ -0,0 +1,41 @@
+import { createExellixConfigStore } from './config-store.js';
+import { fetchGraphOperationalDashboardSlice, } from './graph-operational-aggregates.js';
+import { fetchMemorixMatrixEntityFacet } from './memorix-matrix-entity-facet.js';
+import { createExellixMatrixDataTier, } from './matrix-data-tier.js';
+import { fetchExecutionMatrixMultiGraphOverview, fetchExecutionMatrixNavigatorPage, fetchSourceJoinView, } from './navigator.js';
+import { createExecutionMatrixRuntime } from './runtime-store.js';
+export async function openMatrixReadTier(options = {}) {
+    const { memorixTier, ...dataTierOptions } = options;
+    const dataTier = await createExellixMatrixDataTier(dataTierOptions);
+    return createMatrixReadTierFromDataTier(dataTier, memorixTier);
+}
+export async function createMatrixReadTierFromDataTier(dataTier, memorixTier) {
+    const runtime = createExecutionMatrixRuntime(dataTier.rows, dataTier.failures, {
+        snapshots: dataTier.snapshots,
+        serializeClaims: true,
+    });
+    const configStore = createExellixConfigStore({
+        matrices: dataTier.matrices,
+        graphs: dataTier.graphs,
+    });
+    return {
+        runtime,
+        configStore,
+        memorixTier,
+        graphDashboard: (query) => fetchGraphOperationalDashboardSlice({ runtime, loadGraphConfig: (graphId) => configStore.graphs.get(graphId) }, query),
+        navigatorPage: (query) => fetchExecutionMatrixNavigatorPage(runtime, query),
+        sourceJoinView: (query, opts) => fetchSourceJoinView({ runtime, sourceResolver: opts?.sourceResolver }, query),
+        multiGraphOverview: (query) => fetchExecutionMatrixMultiGraphOverview(runtime, query),
+        entityFacet: (query) => {
+            if (!memorixTier) {
+                throw new Error('entityFacet requires memorixTier — pass memorixTier to openMatrixReadTier (e.g. createMemorixRuntimeTier() / createXmemoryDataTier())');
+            }
+            return fetchMemorixMatrixEntityFacet({ tier: memorixTier, runtime }, query);
+        },
+        listFailureRecords: (opts, readManyCap) => runtime.listFailureRecords(opts, readManyCap),
+        getFailureRecord: (failureId) => runtime.getFailureRecord(failureId),
+        getLatestFailureRecordForRowGraph: (matrixRowId, graphId, opts) => runtime.getLatestFailureRecordForRowGraph(matrixRowId, graphId, opts),
+        close: () => dataTier.close(),
+    };
+}
+//# sourceMappingURL=matrix-read-tier.js.map

package/dist/execution-matrix/matrix-read-tier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-read-tier.js","sourceRoot":"","sources":["../../src/execution-matrix/matrix-read-tier.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,wBAAwB,EAA2B,MAAM,mBAAmB,CAAC;AACtF,OAAO,EACL,mCAAmC,GAGpC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,6BAA6B,EAAgF,MAAM,kCAAkC,CAAC;AAC/J,OAAO,EACL,2BAA2B,GAG5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sCAAsC,EACtC,iCAAiC,EACjC,mBAAmB,GAKpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,4BAA4B,EAA+B,MAAM,oBAAoB,CAAC;AA0C/F,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAqC,EAAE;IAC9E,MAAM,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,CAAC;IACpD,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,eAAe,CAAC,CAAC;IACpE,OAAO,gCAAgC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,QAA+B,EAC/B,WAA6B;IAE7B,MAAM,OAAO,GAAG,4BAA4B,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE;QAC7E,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,eAAe,EAAE,IAAI;KACtB,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,wBAAwB,CAAC;QAC3C,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;KACxB,CAAC,CAAC;IAEH,OAAO;QACL,OAAO;QACP,WAAW;QACX,WAAW;QACX,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CACxB,mCAAmC,CACjC,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAC1E,KAAK,CACN;QACH,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,iCAAiC,CAAC,OAAO,EAAE,KAAK,CAAC;QAC3E,cAAc,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAC9B,mBAAmB,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,KAAK,CAAC;QAC/E,kBAAkB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,sCAAsC,CAAC,OAAO,EAAE,KAAK,CAAC;QACrF,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE;YACrB,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,uIAAuI,CACxI,CAAC;YACJ,CAAC;YACD,OAAO,6BAA6B,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;QAC9E,CAAC;QACD,kBAAkB,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,EAAE,WAAW,CAAC;QACxF,gBAAgB,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC;QACpE,iCAAiC,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAChE,OAAO,CAAC,iCAAiC,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC;QACvE,KAAK,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE;KAC9B,CAAC;AACJ,CAAC"}

package/dist/execution-matrix/memorix-entity-type-helpers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pure helpers for Memorix tier statistics keyed by entity type and execution-matrix row filters.
+ */
+import type { MemorixTierStatistics } from './memorix-tier-statistics.js';
+/** Per-bucket document counts for a single entity-type key from {@link getXmemoryTierStatistics}. */
+export type TierEntityTypeSectionCounts = {
+    things: number;
+    scopedViews: number;
+    scopedData: number;
+    memorixSnapshots: number;
+};
+/**
+ * Reads **`docCount`** for **`entityType`** from each surface’s paginated **`entityTypes`** page
+ * (`@x12i/xmemory-store` ≥ 2.9). If that type is not on the current page (see **`entityTypesSkip`** /
+ * **`entityTypesLimit`** on statistics options), the count is **`0`** — raise **`entityTypesLimit`** or pass
+ * **`entityTypesSkip`** when you need rare types.
+ */
+export declare function pickTierEntityTypeSectionCounts(stats: MemorixTierStatistics, entityType: string): TierEntityTypeSectionCounts;
+/**
+ * Extra filter for {@link ExecutionMatrixRuntime.listRecords} to narrow rows by entity discriminator.
+ * Hosts should set **`input.entityType`** or **`input.memorixEntityType`** during materialization when
+ * dashboards partition by Memorix entity type.
+ */
+export declare function buildMatrixRowEntityTypeExtraFilter(entityType: string): Record<string, unknown>;
+//# sourceMappingURL=memorix-entity-type-helpers.d.ts.map

package/dist/execution-matrix/memorix-entity-type-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-entity-type-helpers.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/memorix-entity-type-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAgC,MAAM,8BAA8B,CAAC;AAExG,qGAAqG;AACrG,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAOF;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,qBAAqB,EAC5B,UAAU,EAAE,MAAM,GACjB,2BAA2B,CAO7B;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI/F"}

package/dist/execution-matrix/memorix-entity-type-helpers.js

@@ -0,0 +1,32 @@
+/**
+ * Pure helpers for Memorix tier statistics keyed by entity type and execution-matrix row filters.
+ */
+function docCountForEntityType(section, entityType) {
+    const hit = section.entityTypes.find((e) => e.typeKey === entityType);
+    return hit?.docCount ?? 0;
+}
+/**
+ * Reads **`docCount`** for **`entityType`** from each surface’s paginated **`entityTypes`** page
+ * (`@x12i/xmemory-store` ≥ 2.9). If that type is not on the current page (see **`entityTypesSkip`** /
+ * **`entityTypesLimit`** on statistics options), the count is **`0`** — raise **`entityTypesLimit`** or pass
+ * **`entityTypesSkip`** when you need rare types.
+ */
+export function pickTierEntityTypeSectionCounts(stats, entityType) {
+    return {
+        things: docCountForEntityType(stats.things, entityType),
+        scopedViews: docCountForEntityType(stats.scopedViews, entityType),
+        scopedData: docCountForEntityType(stats.scopedData, entityType),
+        memorixSnapshots: docCountForEntityType(stats.snapshots, entityType),
+    };
+}
+/**
+ * Extra filter for {@link ExecutionMatrixRuntime.listRecords} to narrow rows by entity discriminator.
+ * Hosts should set **`input.entityType`** or **`input.memorixEntityType`** during materialization when
+ * dashboards partition by Memorix entity type.
+ */
+export function buildMatrixRowEntityTypeExtraFilter(entityType) {
+    return {
+        $or: [{ 'input.entityType': entityType }, { 'input.memorixEntityType': entityType }],
+    };
+}
+//# sourceMappingURL=memorix-entity-type-helpers.js.map

package/dist/execution-matrix/memorix-entity-type-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-entity-type-helpers.js","sourceRoot":"","sources":["../../src/execution-matrix/memorix-entity-type-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,SAAS,qBAAqB,CAAC,OAAqC,EAAE,UAAkB;IACtF,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC;IACtE,OAAO,GAAG,EAAE,QAAQ,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,KAA4B,EAC5B,UAAkB;IAElB,OAAO;QACL,MAAM,EAAE,qBAAqB,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC;QACvD,WAAW,EAAE,qBAAqB,CAAC,KAAK,CAAC,WAAW,EAAE,UAAU,CAAC;QACjE,UAAU,EAAE,qBAAqB,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,CAAC;QAC/D,gBAAgB,EAAE,qBAAqB,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,CAAC;KACrE,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mCAAmC,CAAC,UAAkB;IACpE,OAAO;QACL,GAAG,EAAE,CAAC,EAAE,kBAAkB,EAAE,UAAU,EAAE,EAAE,EAAE,yBAAyB,EAAE,UAAU,EAAE,CAAC;KACrF,CAAC;AACJ,CAAC"}

package/dist/execution-matrix/memorix-entity-type-helpers.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memorix-entity-type-helpers.spec.d.ts.map

package/dist/execution-matrix/memorix-entity-type-helpers.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-entity-type-helpers.spec.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/memorix-entity-type-helpers.spec.ts"],"names":[],"mappings":""}

package/dist/execution-matrix/memorix-entity-type-helpers.spec.js

@@ -0,0 +1,83 @@
+import { describe, expect, it } from 'vitest';
+import { DEFAULT_ENTITY_TYPES_LIMIT, DEFAULT_ENTITY_TYPES_SKIP, TIER_STATS_MISSING_TYPE, } from './memorix-tier-statistics.js';
+import { buildMatrixRowEntityTypeExtraFilter, pickTierEntityTypeSectionCounts } from './memorix-entity-type-helpers.js';
+function emptySection(overrides) {
+    return {
+        matchedDocTotal: 0,
+        entityTypesTotal: 0,
+        entityTypesSkip: DEFAULT_ENTITY_TYPES_SKIP,
+        entityTypesLimit: DEFAULT_ENTITY_TYPES_LIMIT,
+        entityTypesHasMore: false,
+        entityTypes: [],
+        ...overrides,
+    };
+}
+function mockStats(overrides) {
+    const skip = DEFAULT_ENTITY_TYPES_SKIP;
+    const limit = DEFAULT_ENTITY_TYPES_LIMIT;
+    return {
+        generatedAt: '2026-01-01T00:00:00.000Z',
+        presetEffectiveAt: '2026-01-01T00:00:00.000Z',
+        ttlMsUsed: 3600000,
+        appliedScope: { namespace: 'test-ns' },
+        entityTypesSkip: skip,
+        entityTypesLimit: limit,
+        things: emptySection(),
+        scopedViews: emptySection(),
+        scopedData: emptySection(),
+        snapshots: emptySection(),
+        ...overrides,
+        fromCache: overrides.fromCache ?? false,
+    };
+}
+describe('pickTierEntityTypeSectionCounts', () => {
+    it('reads entityTypes buckets per section', () => {
+        const stats = mockStats({
+            things: emptySection({
+                matchedDocTotal: 5,
+                entityTypes: [{ typeKey: 'Alpha', docCount: 2 }],
+            }),
+            scopedViews: emptySection({
+                matchedDocTotal: 1,
+                entityTypes: [{ typeKey: 'Alpha', docCount: 1 }],
+            }),
+            scopedData: emptySection({
+                matchedDocTotal: 10,
+                entityTypes: [{ typeKey: 'Beta', docCount: 10 }],
+            }),
+            snapshots: emptySection({
+                matchedDocTotal: 3,
+                entityTypes: [{ typeKey: TIER_STATS_MISSING_TYPE, docCount: 3 }],
+            }),
+        });
+        expect(pickTierEntityTypeSectionCounts(stats, 'Alpha')).toEqual({
+            things: 2,
+            scopedViews: 1,
+            scopedData: 0,
+            memorixSnapshots: 0,
+        });
+        expect(pickTierEntityTypeSectionCounts(stats, 'Beta')).toEqual({
+            things: 0,
+            scopedViews: 0,
+            scopedData: 10,
+            memorixSnapshots: 0,
+        });
+    });
+    it('returns zeros for unknown entity key', () => {
+        const stats = mockStats({});
+        expect(pickTierEntityTypeSectionCounts(stats, 'Nope')).toEqual({
+            things: 0,
+            scopedViews: 0,
+            scopedData: 0,
+            memorixSnapshots: 0,
+        });
+    });
+});
+describe('buildMatrixRowEntityTypeExtraFilter', () => {
+    it('matches input.entityType or input.memorixEntityType', () => {
+        expect(buildMatrixRowEntityTypeExtraFilter('cat-1')).toEqual({
+            $or: [{ 'input.entityType': 'cat-1' }, { 'input.memorixEntityType': 'cat-1' }],
+        });
+    });
+});
+//# sourceMappingURL=memorix-entity-type-helpers.spec.js.map

package/dist/execution-matrix/memorix-entity-type-helpers.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-entity-type-helpers.spec.js","sourceRoot":"","sources":["../../src/execution-matrix/memorix-entity-type-helpers.spec.ts"],"names":[],"mappings":"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"}

package/dist/execution-matrix/memorix-inference-persister.d.ts

@@ -0,0 +1,73 @@
+import { XronoxStore, type CollectionDefinition, type XronoxCollection } from '@x12i/xronox-store';
+export declare const DEFAULT_MEMORIX_DB: "memorix";
+export declare const MEMORIX_INFERENCE_COLLECTION_POSTFIX: "-infernces";
+export declare const MEMORIX_INFERENCE_RECORD_PK: "_id";
+export type MemorixRecordForGraphInput = {
+    itemId: unknown;
+    graphInput: Record<string, unknown>;
+};
+export type MemorixInferencePersistMetadata = {
+    /** Source entity name. Output collection is `${entityName}-infernces`. */
+    entityName: string;
+    graphId?: string;
+    matrixCatalogId?: string;
+    matrixRunId?: string;
+    matrixRowId?: string;
+    jobId?: string;
+    sourceId?: string;
+    sourceIds?: string[];
+    [key: string]: unknown;
+};
+export type MemorixInferenceRecordMetadata = MemorixInferencePersistMetadata & {
+    entityName: string;
+    collectionName: string;
+    persistedAt: string;
+    outputWasArray: boolean;
+    outputIndex?: number;
+    outputCount?: number;
+};
+export type MemorixInferenceRecord = {
+    _itemId: unknown;
+    infernces: unknown;
+    metadata: MemorixInferenceRecordMetadata;
+};
+export type PersistMemorixInferenceInput = {
+    itemId: unknown;
+    inference: unknown;
+    metadata: MemorixInferencePersistMetadata;
+};
+export type MemorixInferencePersistResult = {
+    collectionName: string;
+    insertedId: string;
+    record: MemorixInferenceRecord;
+};
+export type MemorixInferenceCollectionResolver = (collectionName: string, metadata: MemorixInferencePersistMetadata) => XronoxCollection<Record<string, unknown>>;
+export type CreateMemorixInferencePersisterFromXronoxOptions = {
+    /** Mongo connection URI. When omitted, uses `process.env.MONGO_URI`. */
+    mongoUri?: string;
+    /** Memorix database name. When omitted, uses `process.env.MEMORIX_DB`, else `memorix`. */
+    mongoDb?: string;
+    /** Optional store role. When omitted, uses `process.env.MEMORIX_MONGO_ROLE`, then `process.env.MONGO_ROLE`, then `memorix`. */
+    mongoRole?: string;
+    /**
+     * Entity names to pre-register with xronox on store init. The persister still resolves the
+     * target collection from each call's `metadata.entityName`.
+     */
+    entityNames?: string[];
+};
+export declare function resolveMemorixDbName(mongoDb?: string): string;
+export declare function buildMemorixInferenceCollectionName(entityName: string): string;
+export declare function memorixInferenceCollectionDef(entityName: string): CollectionDefinition;
+export declare function prepareMemorixRecordForGraph(record: Record<string, unknown>): MemorixRecordForGraphInput;
+export declare class MemorixInferencePersister {
+    private readonly resolveCollection;
+    constructor(resolveCollection: MemorixInferenceCollectionResolver);
+    persistInference(input: PersistMemorixInferenceInput): Promise<MemorixInferencePersistResult>;
+    persistInferences(input: PersistMemorixInferenceInput): Promise<MemorixInferencePersistResult[]>;
+}
+export declare function createMemorixInferencePersister(resolveCollection: MemorixInferenceCollectionResolver): MemorixInferencePersister;
+export declare function createMemorixInferencePersisterFromXronox(options?: CreateMemorixInferencePersisterFromXronoxOptions): Promise<{
+    store: XronoxStore;
+    persister: MemorixInferencePersister;
+}>;
+//# sourceMappingURL=memorix-inference-persister.d.ts.map

package/dist/execution-matrix/memorix-inference-persister.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-inference-persister.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/memorix-inference-persister.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEnG,eAAO,MAAM,kBAAkB,EAAG,SAAkB,CAAC;AACrD,eAAO,MAAM,oCAAoC,EAAG,YAAqB,CAAC;AAC1E,eAAO,MAAM,2BAA2B,EAAG,KAAc,CAAC;AAE1D,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,+BAA+B,GAAG;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,8BAA8B,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,+BAA+B,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,sBAAsB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG,CAC/C,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,+BAA+B,KACtC,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE/C,MAAM,MAAM,gDAAgD,GAAG;IAC7D,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+HAA+H;IAC/H,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AA+BF,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAUtF;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,0BAA0B,CAQxG;AA4BD,qBAAa,yBAAyB;IACxB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,kCAAkC;IAE5E,gBAAgB,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAO7F,iBAAiB,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,EAAE,CAAC;CAiBvG;AAED,wBAAgB,+BAA+B,CAC7C,iBAAiB,EAAE,kCAAkC,GACpD,yBAAyB,CAE3B;AAED,wBAAsB,yCAAyC,CAC7D,OAAO,GAAE,gDAAqD,GAC7D,OAAO,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,yBAAyB,CAAA;CAAE,CAAC,CAkBvE"}

package/dist/execution-matrix/memorix-inference-persister.js

@@ -0,0 +1,126 @@
+import { XronoxStore } from '@x12i/xronox-store';
+export const DEFAULT_MEMORIX_DB = 'memorix';
+export const MEMORIX_INFERENCE_COLLECTION_POSTFIX = '-infernces';
+export const MEMORIX_INFERENCE_RECORD_PK = '_id';
+function isoNow() {
+    return new Date().toISOString();
+}
+function assertRecord(value, name) {
+    if (value === null || value === undefined || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${name}: expected a record object`);
+    }
+}
+function normalizeEntityName(entityName) {
+    const normalized = entityName.trim();
+    if (normalized.length === 0) {
+        throw new Error('Memorix inference persister: metadata.entityName is required');
+    }
+    if (!/^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(normalized)) {
+        throw new Error(`Memorix inference persister: unsafe entityName '${entityName}' (allowed: letters, numbers, underscore, hyphen)`);
+    }
+    return normalized;
+}
+function assertItemId(itemId) {
+    if (itemId === undefined || itemId === null || itemId === '') {
+        throw new Error('Memorix inference persister: source record _id / itemId is required');
+    }
+}
+export function resolveMemorixDbName(mongoDb) {
+    const resolved = (mongoDb ?? process.env.MEMORIX_DB ?? DEFAULT_MEMORIX_DB).trim();
+    if (resolved.length === 0) {
+        throw new Error('resolveMemorixDbName: mongoDb resolved to an empty database name');
+    }
+    return resolved;
+}
+export function buildMemorixInferenceCollectionName(entityName) {
+    return `${normalizeEntityName(entityName)}${MEMORIX_INFERENCE_COLLECTION_POSTFIX}`;
+}
+export function memorixInferenceCollectionDef(entityName) {
+    return {
+        name: buildMemorixInferenceCollectionName(entityName),
+        primaryKey: MEMORIX_INFERENCE_RECORD_PK,
+        indexes: [
+            { keys: { _itemId: 1, 'metadata.persistedAt': -1 } },
+            { keys: { 'metadata.entityName': 1, 'metadata.persistedAt': -1 } },
+            { keys: { 'metadata.graphId': 1, 'metadata.persistedAt': -1 } },
+        ],
+    };
+}
+export function prepareMemorixRecordForGraph(record) {
+    assertRecord(record, 'prepareMemorixRecordForGraph');
+    if (!Object.prototype.hasOwnProperty.call(record, '_id')) {
+        throw new Error('prepareMemorixRecordForGraph: source record is missing required _id');
+    }
+    const { _id: itemId, ...graphInput } = record;
+    assertItemId(itemId);
+    return { itemId, graphInput };
+}
+function buildMemorixInferenceRecord(input, context) {
+    assertItemId(input.itemId);
+    const entityName = normalizeEntityName(input.metadata.entityName);
+    const collectionName = buildMemorixInferenceCollectionName(entityName);
+    const metadata = {
+        ...input.metadata,
+        entityName,
+        collectionName,
+        persistedAt: isoNow(),
+        outputWasArray: context?.outputWasArray === true,
+        ...(context?.outputIndex !== undefined ? { outputIndex: context.outputIndex } : {}),
+        ...(context?.outputCount !== undefined ? { outputCount: context.outputCount } : {}),
+    };
+    return {
+        collectionName,
+        record: {
+            _itemId: input.itemId,
+            infernces: input.inference,
+            metadata,
+        },
+    };
+}
+export class MemorixInferencePersister {
+    resolveCollection;
+    constructor(resolveCollection) {
+        this.resolveCollection = resolveCollection;
+    }
+    async persistInference(input) {
+        const { collectionName, record } = buildMemorixInferenceRecord(input);
+        const collection = this.resolveCollection(collectionName, input.metadata);
+        const insertedId = await collection.insert(record);
+        return { collectionName, insertedId: String(insertedId), record };
+    }
+    async persistInferences(input) {
+        if (!Array.isArray(input.inference)) {
+            return [await this.persistInference(input)];
+        }
+        const outputCount = input.inference.length;
+        const out = [];
+        for (let outputIndex = 0; outputIndex < input.inference.length; outputIndex += 1) {
+            const { collectionName, record } = buildMemorixInferenceRecord({ ...input, inference: input.inference[outputIndex] }, { outputWasArray: true, outputIndex, outputCount });
+            const collection = this.resolveCollection(collectionName, input.metadata);
+            const insertedId = await collection.insert(record);
+            out.push({ collectionName, insertedId: String(insertedId), record });
+        }
+        return out;
+    }
+}
+export function createMemorixInferencePersister(resolveCollection) {
+    return new MemorixInferencePersister(resolveCollection);
+}
+export async function createMemorixInferencePersisterFromXronox(options = {}) {
+    const mongoUri = options.mongoUri ?? process.env.MONGO_URI;
+    const mongoDb = resolveMemorixDbName(options.mongoDb);
+    const mongoRole = options.mongoRole ?? process.env.MEMORIX_MONGO_ROLE ?? process.env.MONGO_ROLE ?? 'memorix';
+    if (!mongoUri || !String(mongoUri).trim()) {
+        throw new Error('createMemorixInferencePersisterFromXronox: mongoUri missing — set MONGO_URI (ERC / env) or pass options.mongoUri');
+    }
+    const store = new XronoxStore({
+        mongoUri,
+        mongoDb,
+        mongoRole,
+        collections: (options.entityNames ?? []).map((entityName) => memorixInferenceCollectionDef(entityName)),
+    });
+    await store.init();
+    const persister = createMemorixInferencePersister((collectionName) => store.collection(collectionName));
+    return { store, persister };
+}
+//# sourceMappingURL=memorix-inference-persister.js.map

package/dist/execution-matrix/memorix-inference-persister.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-inference-persister.js","sourceRoot":"","sources":["../../src/execution-matrix/memorix-inference-persister.ts"],"names":[],"mappings":"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"}

package/dist/execution-matrix/memorix-inference-persister.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memorix-inference-persister.spec.d.ts.map

package/dist/execution-matrix/memorix-inference-persister.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorix-inference-persister.spec.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/memorix-inference-persister.spec.ts"],"names":[],"mappings":""}