@exellix/exellix-runtime 3.5.1

package/dist/execution-matrix/materializer.js

@@ -0,0 +1,210 @@
+import { buildExecutionSeedFromGraphEntry as engineBuildExecutionSeedFromGraphEntry, } from '@exellix/graph-engine';
+import { RUNTIME_ROW_INPUT_RECORDS_KEY, RUNTIME_ROW_INPUT_SNAPSHOT_ID_KEY, RUNTIME_ROW_INPUT_SOURCE_ID_KEY, RUNTIME_ROW_INPUT_SOURCE_IDS_KEY, } from './contracts.js';
+function isoNow() {
+    return new Date().toISOString();
+}
+/** Shallow-merge mapped input entries in array order (host-defined keys per entry). */
+export function mergeMappedInputEntries(entries) {
+    const out = {};
+    for (const e of entries) {
+        Object.assign(out, e);
+    }
+    return out;
+}
+/**
+ * Order graph catalog records for a matrix: filter to `matrixGraphIds`, then sort by
+ * `execution.priority` ascending; ties break by first occurrence in `matrixGraphIds`.
+ */
+export function sortGraphRecordsForMatrix(matrixGraphIds, graphRecords) {
+    const map = new Map(graphRecords.map((g) => [g.graphId, g]));
+    const missing = matrixGraphIds.filter((id) => !map.has(id));
+    if (missing.length) {
+        throw new Error(`sortGraphRecordsForMatrix: missing graph catalog records for: ${missing.map((m) => JSON.stringify(m)).join(', ')}`);
+    }
+    const orderIndex = new Map(matrixGraphIds.map((id, i) => [id, i]));
+    return matrixGraphIds
+        .map((id) => map.get(id))
+        .sort((a, b) => {
+        const d = a.execution.priority - b.execution.priority;
+        if (d !== 0)
+            return d;
+        return (orderIndex.get(a.graphId) ?? 0) - (orderIndex.get(b.graphId) ?? 0);
+    });
+}
+/**
+ * Build the graph-engine `execution` seed from `metadata.graphEntry.inputs` (value kinds only).
+ *
+ * Delegates to `@exellix/graph-engine` `buildExecutionSeedFromGraphEntry` so path handling matches
+ * Layer-01 (`GraphEntryValueInputSpec.path` under merged `execution`, flat `input.*` only — no `input.raw`).
+ * Matrix rows expose work-unit fields on {@link ExecutionMatrixRuntimeRecord.input}; at claim time the orchestrator
+ * sets `runtime.input = record.input` (canonical host slot). This helper optionally aligns `executionMemory` via
+ * `layers: [{ input: inputRow }]`. `kind: "execution"` specs are skipped — resolve prior runs in the host.
+ */
+export function buildExecutionSeedFromGraphEntry(graphEntry, inputRow) {
+    const { execution } = engineBuildExecutionSeedFromGraphEntry(graphEntry, {
+        layers: [{ input: inputRow }],
+    });
+    return execution;
+}
+/**
+ * Turn catalog payload + concrete input rows into persisted runtime row shapes (caller inserts via {@link ExecutionMatrixRuntime}).
+ */
+function randomRowSuffix() {
+    try {
+        return globalThis.crypto.randomUUID();
+    }
+    catch {
+        return `${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+    }
+}
+export function materializeExecutionMatrixRuntimeRows(input) {
+    const now = isoNow();
+    const orderedGraphs = sortGraphRecordsForMatrix(input.payload.graphs, input.graphRecords);
+    const mappedByGraph = {};
+    for (const g of orderedGraphs) {
+        mappedByGraph[g.graphId] = mergeMappedInputEntries(g.mappedInput);
+    }
+    return input.inputRows.map((row, idx) => {
+        const matrixRowId = `row_${input.matrixItemId}_${input.matrixRunId ?? 'default'}_${idx}_${randomRowSuffix()}`;
+        const execution = orderedGraphs.map((g) => ({
+            graphId: g.graphId,
+            priority: g.execution.priority,
+            status: 'not-started',
+            start: null,
+            end: null,
+            lastUpdated: now,
+        }));
+        return {
+            matrixRowId,
+            matrixCatalogId: input.matrixCatalogId,
+            matrixItemId: input.matrixItemId,
+            matrixRunId: input.matrixRunId,
+            materializationOrder: idx,
+            input: {
+                ...input.payload.input,
+                ...row,
+                ...(input.runtimeScope ?? {}),
+                mappedByGraph,
+            },
+            execution,
+            inferences: [],
+            createdAt: now,
+            updatedAt: now,
+            claimVersion: 0,
+        };
+    });
+}
+export async function resolveInputRowsWithResolver(selector, resolver, runtimeScope) {
+    if (!resolver)
+        return [];
+    return resolver(selector, runtimeScope);
+}
+/* ----------------------------------------------------------------------------
+ * Batched record materialization (recordsPerRun > 1)
+ * --------------------------------------------------------------------------*/
+/**
+ * Split `inputRows` into chunks of `recordsPerRun`. When `recordsPerRun <= 1` the input is
+ * returned as a list of singletons (one chunk per row), preserving legacy semantics.
+ *
+ * `idExtractor` is used to lift a stable `sourceId` per record when present (e.g. xmemory id).
+ */
+export function chunkInputRowsForBatch(rows, recordsPerRun, idExtractor) {
+    const size = Math.max(1, Math.floor(recordsPerRun ?? 1));
+    const out = [];
+    for (let i = 0; i < rows.length; i += size) {
+        const slice = rows.slice(i, i + size);
+        const records = [...slice];
+        const sourceIds = idExtractor
+            ? records.map((r) => idExtractor(r)).filter((v) => typeof v === 'string' && v.length > 0)
+            : records
+                .map((r) => {
+                const v = r[RUNTIME_ROW_INPUT_SOURCE_ID_KEY];
+                return typeof v === 'string' && v.length > 0 ? v : undefined;
+            })
+                .filter((v) => Boolean(v));
+        out.push({ records, sourceIds });
+    }
+    return out;
+}
+/**
+ * Materialize runtime rows where each row carries `input.records: TRow[]` and `input.sourceIds: string[]`,
+ * the standardized shape produced by the `record` data-source kind with `recordsPerRun > 1`.
+ *
+ * When `recordsPerRun <= 1` this delegates to {@link materializeExecutionMatrixRuntimeRows} so callers
+ * always get one materializer entry point.
+ */
+export function materializeBatchedRecordRows(input) {
+    const recordsPerRun = input.recordsPerRun ?? 1;
+    if (recordsPerRun <= 1) {
+        return materializeExecutionMatrixRuntimeRows({
+            matrixCatalogId: input.matrixCatalogId,
+            matrixItemId: input.matrixItemId,
+            matrixRunId: input.matrixRunId,
+            payload: input.payload,
+            graphRecords: input.graphRecords,
+            inputRows: input.inputRows,
+            ...(input.runtimeScope ? { runtimeScope: input.runtimeScope } : {}),
+        });
+    }
+    const chunks = chunkInputRowsForBatch(input.inputRows, recordsPerRun, input.sourceIdOf);
+    const synthetic = chunks.map((c) => ({
+        [RUNTIME_ROW_INPUT_RECORDS_KEY]: c.records,
+        [RUNTIME_ROW_INPUT_SOURCE_IDS_KEY]: c.sourceIds,
+    }));
+    return materializeExecutionMatrixRuntimeRows({
+        matrixCatalogId: input.matrixCatalogId,
+        matrixItemId: input.matrixItemId,
+        matrixRunId: input.matrixRunId,
+        payload: input.payload,
+        graphRecords: input.graphRecords,
+        inputRows: synthetic,
+        ...(input.runtimeScope ? { runtimeScope: input.runtimeScope } : {}),
+    });
+}
+/**
+ * Convert a persisted snapshot into runtime rows.
+ *
+ * Each emitted row stores `input.snapshotId` pointing back to the snapshot document so the graph
+ * can re-read the payload at execution time without re-running the transform.
+ */
+export function materializeFromSnapshot(input) {
+    const mode = input.materialize ?? 'one-row';
+    if (mode === 'expand') {
+        if (!Array.isArray(input.snapshot.payload)) {
+            throw new Error(`materializeFromSnapshot: materialize='expand' requires snapshot.payload to be an array (got ${typeof input.snapshot.payload})`);
+        }
+        const expanded = input.snapshot.payload.map((entry, i) => ({
+            [RUNTIME_ROW_INPUT_SNAPSHOT_ID_KEY]: input.snapshot.snapshotId,
+            snapshotIndex: i,
+            ...(typeof entry === 'object' && entry !== null && !Array.isArray(entry)
+                ? entry
+                : { value: entry }),
+        }));
+        return materializeExecutionMatrixRuntimeRows({
+            matrixCatalogId: input.matrixCatalogId,
+            matrixItemId: input.matrixItemId,
+            matrixRunId: input.matrixRunId,
+            payload: input.payload,
+            graphRecords: input.graphRecords,
+            inputRows: expanded,
+            ...(input.runtimeScope ? { runtimeScope: input.runtimeScope } : {}),
+        });
+    }
+    const single = {
+        [RUNTIME_ROW_INPUT_SNAPSHOT_ID_KEY]: input.snapshot.snapshotId,
+        snapshotPayload: input.snapshot.payload,
+    };
+    if (input.snapshot.sourceIds && input.snapshot.sourceIds.length > 0) {
+        single[RUNTIME_ROW_INPUT_SOURCE_IDS_KEY] = [...input.snapshot.sourceIds];
+    }
+    return materializeExecutionMatrixRuntimeRows({
+        matrixCatalogId: input.matrixCatalogId,
+        matrixItemId: input.matrixItemId,
+        matrixRunId: input.matrixRunId,
+        payload: input.payload,
+        graphRecords: input.graphRecords,
+        inputRows: [single],
+        ...(input.runtimeScope ? { runtimeScope: input.runtimeScope } : {}),
+    });
+}
+//# sourceMappingURL=materializer.js.map

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

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

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

@@ -0,0 +1,24 @@
+import { Activix } from '@x12i/activix';
+export type CreateExecutionMatrixActivixFromEnvOptions = {
+    /**
+     * Mongo connection URI. When omitted, uses **`process.env.MONGO_URI`** (required when **`storageMode`** is **`database`** and **`strict`** is true).
+     */
+    mongoUri?: string;
+    /**
+     * Activity collection name for this package only (must not reuse graph-engine default collection names).
+     * When omitted, uses **`process.env.EXELLIX_RUNTIME_ACTIVIX_COLLECTION`**, else **`exellix-execution-matrix-activities`**.
+     */
+    collection?: string;
+    /** When true (default), missing **`mongoUri`** in database mode throws. */
+    strict?: boolean;
+    storageMode?: 'database' | 'local' | 'automatic';
+};
+/**
+ * Creates an **`@x12i/activix`** instance owned by **`@exellix/exellix-runtime`** (separate collection from graph-engine).
+ *
+ * Environment:
+ * - **`EXELLIX_RUNTIME_ACTIVIX_COLLECTION`** — optional; default collection name **`exellix-execution-matrix-activities`**
+ * - **`MONGO_URI`** — used when **`mongoUri`** is not passed (database mode)
+ */
+export declare function createExecutionMatrixActivixFromEnv(options?: CreateExecutionMatrixActivixFromEnvOptions): Promise<Activix>;
+//# sourceMappingURL=matrix-activix.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-activix.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/matrix-activix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,MAAM,0CAA0C,GAAG;IACvD;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;CAClD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,mCAAmC,CACvD,OAAO,CAAC,EAAE,0CAA0C,GACnD,OAAO,CAAC,OAAO,CAAC,CA6BlB"}

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

@@ -0,0 +1,34 @@
+import { Activix } from '@x12i/activix';
+/**
+ * Creates an **`@x12i/activix`** instance owned by **`@exellix/exellix-runtime`** (separate collection from graph-engine).
+ *
+ * Environment:
+ * - **`EXELLIX_RUNTIME_ACTIVIX_COLLECTION`** — optional; default collection name **`exellix-execution-matrix-activities`**
+ * - **`MONGO_URI`** — used when **`mongoUri`** is not passed (database mode)
+ */
+export async function createExecutionMatrixActivixFromEnv(options) {
+    const strict = options?.strict !== false;
+    const storageMode = options?.storageMode ?? 'database';
+    const mongoUri = (options?.mongoUri && String(options.mongoUri).trim()) ||
+        (typeof process !== 'undefined' && process.env.MONGO_URI?.trim()) ||
+        '';
+    if (storageMode === 'database' && !mongoUri && strict) {
+        throw new Error('createExecutionMatrixActivixFromEnv: mongoUri missing — pass options.mongoUri or set MONGO_URI');
+    }
+    const collectionName = (options?.collection && String(options.collection).trim()) ||
+        (typeof process !== 'undefined' && process.env.EXELLIX_RUNTIME_ACTIVIX_COLLECTION?.trim()) ||
+        'exellix-execution-matrix-activities';
+    return Activix.create({
+        storageMode,
+        ...(mongoUri ? { mongoUri } : {}),
+        collection: {
+            name: collectionName,
+            indexes: [
+                { keys: { 'runContext.jobId': 1, startTime: 1 } },
+                { keys: { 'runContext.jobId': 1, 'runContext.graphId': 1, startTime: 1 } },
+            ],
+        },
+        diagnostics: { owner: '@exellix/exellix-runtime', component: 'execution-matrix' },
+    });
+}
+//# sourceMappingURL=matrix-activix.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-activix.js","sourceRoot":"","sources":["../../src/execution-matrix/matrix-activix.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAiBxC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,OAAoD;IAEpD,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC;IACzC,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,UAAU,CAAC;IACvD,MAAM,QAAQ,GACZ,CAAC,OAAO,EAAE,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;QACjE,EAAE,CAAC;IACL,IAAI,WAAW,KAAK,UAAU,IAAI,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAC;IACJ,CAAC;IACD,MAAM,cAAc,GAClB,CAAC,OAAO,EAAE,UAAU,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,IAAI,EAAE,CAAC;QAC1F,qCAAqC,CAAC;IAExC,OAAO,OAAO,CAAC,MAAM,CAAC;QACpB,WAAW;QACX,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,UAAU,EAAE;YACV,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,EAAE,kBAAkB,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE;gBACjD,EAAE,IAAI,EAAE,EAAE,kBAAkB,EAAE,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE;aAC3E;SACF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,0BAA0B,EAAE,SAAS,EAAE,kBAAkB,EAAE;KAClF,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,55 @@
+/**
+ * Mongo-backed matrix persistence tier — opens rows, failures, snapshots, and config collections
+ * without exposing `@x12i/xronox-store` on the public import path (hosts use this factory only).
+ */
+import type { createExecutionMatrixRuntime } from './runtime-store.js';
+import { createExellixConfigStoreFromXronox, createExecutionMatrixRuntimeFromXronox } from './xronox-matrix-factory.js';
+/** xronox-shaped collection handle expected by {@link createExecutionMatrixRuntime}. */
+export type ExellixMatrixPersistenceCollection = Parameters<typeof createExecutionMatrixRuntime>[0];
+type ExecutionMatrixXronoxBundle = Awaited<ReturnType<typeof createExecutionMatrixRuntimeFromXronox>>;
+type ConfigXronoxBundle = Awaited<ReturnType<typeof createExellixConfigStoreFromXronox>>;
+export type CreateExellixMatrixDataTierOptions = {
+    mongoUri?: string;
+    executionDb?: string;
+    configDb?: string;
+    executionMongoRole?: string;
+    configMongoRole?: string;
+    /** When `false`, skips native `mongodb` pass-through hooks. Default `true`. */
+    mongoDriverPassThrough?: boolean;
+    /** Passed through to underlying runtime store wiring (default `true` for workers). */
+    serializeClaims?: boolean;
+};
+export type ExellixMatrixDataTierProbe = {
+    executionStore: ExecutionMatrixXronoxBundle['store'];
+    configStore: ConfigXronoxBundle['store'];
+    executionMongoUri: string;
+    configMongoUri: string;
+};
+export type ExellixMatrixDataTier = {
+    rows: ExellixMatrixPersistenceCollection;
+    failures: ExellixMatrixPersistenceCollection;
+    snapshots: ExellixMatrixPersistenceCollection;
+    matrices: ExellixMatrixPersistenceCollection;
+    graphs: ExellixMatrixPersistenceCollection;
+    init?: () => Promise<void>;
+    close: () => Promise<void>;
+    executionStore?: ExecutionMatrixXronoxBundle['store'];
+    configStore?: ConfigXronoxBundle['store'];
+    executionMongoUri?: string;
+    configMongoUri?: string;
+    probe?: ExellixMatrixDataTierProbe;
+};
+export type ResolvedExellixMatrixDataTierOptions = CreateExellixMatrixDataTierOptions & {
+    mongoUri: string;
+    executionDb: string;
+    configDb: string;
+};
+/** Merges caller options with `MONGO_URI`, `execution_db`, and `config_db`. */
+export declare function resolveExellixMatrixDataTierOptions(overrides?: CreateExellixMatrixDataTierOptions, env?: NodeJS.ProcessEnv): ResolvedExellixMatrixDataTierOptions;
+/**
+ * Opens Mongo-backed persistence for execution-matrix operational data and config collections.
+ * Databases (defaults): `exellix-runtime` (rows, failures, snapshots), `exellix` (matrix/graph configs).
+ */
+export declare function createExellixMatrixDataTier(options?: CreateExellixMatrixDataTierOptions): Promise<ExellixMatrixDataTier>;
+export {};
+//# sourceMappingURL=matrix-data-tier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-data-tier.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/matrix-data-tier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAQvE,OAAO,EACL,kCAAkC,EAClC,sCAAsC,EACvC,MAAM,4BAA4B,CAAC;AAKpC,wFAAwF;AACxF,MAAM,MAAM,kCAAkC,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpG,KAAK,2BAA2B,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,sCAAsC,CAAC,CAAC,CAAC;AACtG,KAAK,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,kCAAkC,CAAC,CAAC,CAAC;AAEzF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,sFAAsF;IACtF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,cAAc,EAAE,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrD,WAAW,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,kCAAkC,CAAC;IACzC,QAAQ,EAAE,kCAAkC,CAAC;IAC7C,SAAS,EAAE,kCAAkC,CAAC;IAC9C,QAAQ,EAAE,kCAAkC,CAAC;IAC7C,MAAM,EAAE,kCAAkC,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,cAAc,CAAC,EAAE,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACtD,WAAW,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,0BAA0B,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG,kCAAkC,GAAG;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,mCAAmC,CACjD,SAAS,GAAE,kCAAuC,EAClD,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,oCAAoC,CAWtC;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,GAAE,kCAAuC,GAC/C,OAAO,CAAC,qBAAqB,CAAC,CAwDhC"}

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

@@ -0,0 +1,74 @@
+import { exellixGraphConfigsCollectionDef, exellixMatrixConfigsCollectionDef, executionMatrixFailuresCollectionDef, executionMatrixRowsCollectionDef, executionMatrixSnapshotsCollectionDef, } from './collections.js';
+import { createExellixConfigStoreFromXronox, createExecutionMatrixRuntimeFromXronox, } from './xronox-matrix-factory.js';
+const DEFAULT_EXECUTION_DB = 'exellix-runtime';
+const DEFAULT_CONFIG_DB = 'exellix';
+/** Merges caller options with `MONGO_URI`, `execution_db`, and `config_db`. */
+export function resolveExellixMatrixDataTierOptions(overrides = {}, env = process.env) {
+    const mongoUri = (overrides.mongoUri ?? env.MONGO_URI?.trim() ?? '').trim();
+    if (!mongoUri) {
+        throw new Error('createExellixMatrixDataTier: mongoUri missing — set MONGO_URI or pass options.mongoUri');
+    }
+    return {
+        ...overrides,
+        mongoUri,
+        executionDb: overrides.executionDb ?? (env.execution_db?.trim() || DEFAULT_EXECUTION_DB),
+        configDb: overrides.configDb ?? (env.config_db?.trim() || DEFAULT_CONFIG_DB),
+    };
+}
+/**
+ * Opens Mongo-backed persistence for execution-matrix operational data and config collections.
+ * Databases (defaults): `exellix-runtime` (rows, failures, snapshots), `exellix` (matrix/graph configs).
+ */
+export async function createExellixMatrixDataTier(options = {}) {
+    const resolved = resolveExellixMatrixDataTierOptions(options);
+    const passThrough = resolved.mongoDriverPassThrough !== false;
+    const exec = await createExecutionMatrixRuntimeFromXronox({
+        mongoUri: resolved.mongoUri,
+        mongoDb: resolved.executionDb,
+        mongoRole: resolved.executionMongoRole,
+        mongoDriverPassThrough: passThrough,
+        serializeClaims: resolved.serializeClaims ?? true,
+    });
+    const cfg = await createExellixConfigStoreFromXronox({
+        mongoUri: resolved.mongoUri,
+        mongoDb: resolved.configDb,
+        mongoRole: resolved.configMongoRole,
+        mongoDriverPassThrough: passThrough,
+    });
+    const rows = exec.store.collection(executionMatrixRowsCollectionDef().name);
+    const failures = exec.store.collection(executionMatrixFailuresCollectionDef().name);
+    const snapshots = exec.store.collection(executionMatrixSnapshotsCollectionDef().name);
+    const matrices = cfg.store.collection(exellixMatrixConfigsCollectionDef().name);
+    const graphs = cfg.store.collection(exellixGraphConfigsCollectionDef().name);
+    let closed = false;
+    const close = async () => {
+        if (closed)
+            return;
+        closed = true;
+        await exec.store.close().catch(() => undefined);
+        await cfg.store.close().catch(() => undefined);
+        await exec.closeMongoDriverPassThrough?.().catch(() => undefined);
+        await cfg.closeMongoDriverPassThrough?.().catch(() => undefined);
+    };
+    const probe = {
+        executionStore: exec.store,
+        configStore: cfg.store,
+        executionMongoUri: resolved.mongoUri,
+        configMongoUri: resolved.mongoUri,
+    };
+    return {
+        rows,
+        failures,
+        snapshots,
+        matrices,
+        graphs,
+        init: async () => undefined,
+        close,
+        executionStore: exec.store,
+        configStore: cfg.store,
+        executionMongoUri: resolved.mongoUri,
+        configMongoUri: resolved.mongoUri,
+        probe,
+    };
+}
+//# sourceMappingURL=matrix-data-tier.js.map

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

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

package/dist/execution-matrix/matrix-execute-graph-adapter.d.ts

@@ -0,0 +1,43 @@
+import type { ExecuteGraphInput, GraphModelObject } from '@exellix/graph-engine';
+import type { MatrixGraphExecuteOverrides } from './contracts.js';
+import { type MatrixGraphExecutor } from './orchestrator.js';
+/**
+ * Payload the matrix orchestrator passes to {@link ProcessMatrixClaimDeps.executeGraph}
+ * (`executeMatrixGraphForClaim`). Alias for {@link ExecuteGraphInput} — use this name in host
+ * code to distinguish orchestrator-forwards from ad-hoc graph-engine invokes.
+ */
+export type OrchestratorExecuteGraphInput = ExecuteGraphInput;
+export type MatrixExecuteGraphAdapterContext = {
+    graphId: string;
+    jobId: string;
+    /** Present when the orchestrator/default job or host resolver exposes the matrix row id. */
+    matrixRowId?: string;
+    input: OrchestratorExecuteGraphInput;
+};
+export type MatrixExecuteGraphAdapterOptions = {
+    /** Typically `createExellixGraphRuntime(opts).executeGraph.bind(runtime)`. */
+    executeGraph: MatrixGraphExecutor;
+    /**
+     * Optional live graph model (e.g. from an in-memory loader). Applied after the inbound model
+     * so hosts can rehydrate the canonical model object immediately before execution.
+     */
+    resolveGraphModel?: (ctx: MatrixExecuteGraphAdapterContext) => GraphModelObject | undefined | Promise<GraphModelObject | undefined>;
+    /**
+     * Extract matrix row id when it is not present on `runtime.job`. The default matrix job
+     * envelope includes `matrixRowId`; this hook supports custom executors or older hosts.
+     */
+    resolveMatrixRowId?: (input: OrchestratorExecuteGraphInput) => string | undefined;
+    /** Base runtime overrides merged under orchestrator-supplied runtime fields (see package docs for precedence). */
+    defaults?: MatrixGraphExecuteOverrides;
+};
+/**
+ * Wraps a graph-engine executor so hosts can layer runtime defaults and optionally re-resolve
+ * the live `GraphModelObject` without fighting orchestrator-owned runtime keys (`jobId`,
+ * `job`, active `input`, seeded `executionMemory`).
+ *
+ * Merge rules for everything else match {@link mergeMatrixGraphExecuteOverrides}:
+ * runtime fields from the inbound call win over {@link MatrixExecuteGraphAdapterOptions.defaults}.
+ * When {@link resolveGraphModel} returns a model, it replaces the inbound model.
+ */
+export declare function createMatrixExecuteGraphAdapter(options: MatrixExecuteGraphAdapterOptions): MatrixGraphExecutor;
+//# sourceMappingURL=matrix-execute-graph-adapter.d.ts.map

package/dist/execution-matrix/matrix-execute-graph-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-execute-graph-adapter.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/matrix-execute-graph-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAsB,gBAAgB,EAAsB,MAAM,uBAAuB,CAAC;AACzH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAE3B;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,GAAG,iBAAiB,CAAC;AAE9D,MAAM,MAAM,gCAAgC,GAAG;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,6BAA6B,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,8EAA8E;IAC9E,YAAY,EAAE,mBAAmB,CAAC;IAClC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAClB,GAAG,EAAE,gCAAgC,KAClC,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IAC1E;;;OAGG;IACH,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,6BAA6B,KAAK,MAAM,GAAG,SAAS,CAAC;IAClF,kHAAkH;IAClH,QAAQ,CAAC,EAAE,2BAA2B,CAAC;CACxC,CAAC;AAkBF;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,mBAAmB,CA2CrB"}

package/dist/execution-matrix/matrix-execute-graph-adapter.js

@@ -0,0 +1,62 @@
+import { mergeMatrixGraphExecuteOverrides, sanitizeMatrixGraphExecuteOverrides, } from './orchestrator.js';
+function stripOrchestratorRuntimeCoreKeys(runtime) {
+    const rest = { ...runtime };
+    delete rest.jobId;
+    delete rest.job;
+    delete rest.input;
+    delete rest.executionMemory;
+    return rest;
+}
+function matrixRowIdFromJob(job) {
+    if (!job || typeof job !== 'object')
+        return undefined;
+    const j = job;
+    const v = j.matrixRowId ?? j.matrix_row_id;
+    return typeof v === 'string' && v.length > 0 ? v : undefined;
+}
+/**
+ * Wraps a graph-engine executor so hosts can layer runtime defaults and optionally re-resolve
+ * the live `GraphModelObject` without fighting orchestrator-owned runtime keys (`jobId`,
+ * `job`, active `input`, seeded `executionMemory`).
+ *
+ * Merge rules for everything else match {@link mergeMatrixGraphExecuteOverrides}:
+ * runtime fields from the inbound call win over {@link MatrixExecuteGraphAdapterOptions.defaults}.
+ * When {@link resolveGraphModel} returns a model, it replaces the inbound model.
+ */
+export function createMatrixExecuteGraphAdapter(options) {
+    const run = options.executeGraph;
+    return async (input) => {
+        const jobId = typeof input.runtime.jobId === 'string' && input.runtime.jobId.length > 0 ? input.runtime.jobId : undefined;
+        if (!jobId) {
+            throw new Error('createMatrixExecuteGraphAdapter: inbound ExecuteGraphInput.runtime.jobId is required');
+        }
+        const graphId = typeof input.model.id === 'string' && input.model.id.length > 0 ? input.model.id : undefined;
+        if (!graphId) {
+            throw new Error('createMatrixExecuteGraphAdapter: inbound ExecuteGraphInput.model.id is required');
+        }
+        const matrixRowId = options.resolveMatrixRowId?.(input) ?? matrixRowIdFromJob(input.runtime.job);
+        const fromCall = stripOrchestratorRuntimeCoreKeys(input.runtime);
+        const merged = sanitizeMatrixGraphExecuteOverrides(mergeMatrixGraphExecuteOverrides(options.defaults, fromCall));
+        const resolvedModel = await options.resolveGraphModel?.({
+            graphId,
+            jobId,
+            ...(matrixRowId !== undefined ? { matrixRowId } : {}),
+            input,
+        });
+        if (resolvedModel && resolvedModel.id !== graphId) {
+            throw new Error(`createMatrixExecuteGraphAdapter: resolved graph model id '${resolvedModel.id}' does not match inbound model id '${graphId}'`);
+        }
+        const next = {
+            model: resolvedModel ?? input.model,
+            runtime: {
+                jobId: input.runtime.jobId,
+                job: input.runtime.job,
+                ...(input.runtime.input !== undefined ? { input: input.runtime.input } : {}),
+                ...(input.runtime.executionMemory !== undefined ? { executionMemory: input.runtime.executionMemory } : {}),
+                ...(merged ?? {}),
+            },
+        };
+        return run(next);
+    };
+}
+//# sourceMappingURL=matrix-execute-graph-adapter.js.map

package/dist/execution-matrix/matrix-execute-graph-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-execute-graph-adapter.js","sourceRoot":"","sources":["../../src/execution-matrix/matrix-execute-graph-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gCAAgC,EAChC,mCAAmC,GAEpC,MAAM,mBAAmB,CAAC;AAoC3B,SAAS,gCAAgC,CAAC,OAA2B;IACnE,MAAM,IAAI,GAAG,EAAE,GAAI,OAA8C,EAAE,CAAC;IACpE,OAAO,IAAI,CAAC,KAAK,CAAC;IAClB,OAAO,IAAI,CAAC,GAAG,CAAC;IAChB,OAAO,IAAI,CAAC,KAAK,CAAC;IAClB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC5B,OAAO,IAAmC,CAAC;AAC7C,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAY;IACtC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,aAAa,CAAC;IAC3C,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAAyC;IAEzC,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IACjC,OAAO,KAAK,EAAE,KAAwB,EAA+B,EAAE;QACrE,MAAM,KAAK,GACT,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9G,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;QAC1G,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7G,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;QACrG,CAAC;QACD,MAAM,WAAW,GACf,OAAO,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAG,gCAAgC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,mCAAmC,CAChD,gCAAgC,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAC7D,CAAC;QACF,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACtD,OAAO;YACP,KAAK;YACL,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,KAAK;SACN,CAAC,CAAC;QACH,IAAI,aAAa,IAAI,aAAa,CAAC,EAAE,KAAK,OAAO,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,6DAA6D,aAAa,CAAC,EAAE,sCAAsC,OAAO,GAAG,CAC9H,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAsB;YAC9B,KAAK,EAAE,aAAa,IAAI,KAAK,CAAC,KAAK;YACnC,OAAO,EAAE;gBACP,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK;gBAC1B,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG;gBACtB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5E,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1G,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;aAClB;SACF,CAAC;QAEF,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC"}

package/dist/execution-matrix/matrix-execute-graph-adapter.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=matrix-execute-graph-adapter.spec.d.ts.map

package/dist/execution-matrix/matrix-execute-graph-adapter.spec.d.ts.map

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

package/dist/execution-matrix/matrix-execute-graph-adapter.spec.js

@@ -0,0 +1,60 @@
+import { describe, expect, it, vi } from 'vitest';
+import { createMatrixExecuteGraphAdapter } from './matrix-execute-graph-adapter.js';
+function mockExecuteGraphSuccess(finalOutput = {}) {
+    return {
+        status: 'completed',
+        jobId: 'mock-job',
+        taskId: 'mock-task-id',
+        graphId: 'G',
+        outputsByNodeId: {},
+        engineSnapshot: {},
+        finalOutput,
+    };
+}
+describe('createMatrixExecuteGraphAdapter', () => {
+    it('forwards orchestrator runtime core keys and applies resolveGraphModel last', async () => {
+        const inner = vi.fn().mockResolvedValue(mockExecuteGraphSuccess());
+        const graphModel = { id: 'G', response: { shape: { type: 'literal', value: {} } }, nodes: [], version: 'live' };
+        const adapter = createMatrixExecuteGraphAdapter({
+            executeGraph: inner,
+            defaults: { failFast: false },
+            resolveGraphModel: async () => graphModel,
+        });
+        const input = {
+            model: { id: 'G', response: { shape: { type: 'literal', value: {} } }, nodes: [] },
+            runtime: {
+                jobId: 'job-1',
+                job: { matrixRowId: 'row-1' },
+                executionMemory: { input: { raw: 1 } },
+                failFast: true,
+            },
+        };
+        await adapter(input);
+        expect(inner).toHaveBeenCalledTimes(1);
+        const call = inner.mock.calls[0][0];
+        expect(call.model).toBe(graphModel);
+        expect(call.runtime.jobId).toBe('job-1');
+        expect(call.runtime.executionMemory).toEqual(input.runtime.executionMemory);
+        expect(call.runtime.failFast).toBe(true);
+    });
+    it('defaults lose to orchestrator-carried extras on merge', async () => {
+        const inner = vi.fn().mockResolvedValue(mockExecuteGraphSuccess());
+        const adapter = createMatrixExecuteGraphAdapter({
+            executeGraph: inner,
+            defaults: { maxRunLogEntries: 1 },
+        });
+        const input = {
+            model: { id: 'G', response: { shape: { type: 'literal', value: {} } }, nodes: [] },
+            runtime: {
+                jobId: 'job-1',
+                job: {},
+                executionMemory: {},
+                maxRunLogEntries: 99,
+            },
+        };
+        await adapter(input);
+        const call = inner.mock.calls[0][0];
+        expect(call.runtime.maxRunLogEntries).toBe(99);
+    });
+});
+//# sourceMappingURL=matrix-execute-graph-adapter.spec.js.map

package/dist/execution-matrix/matrix-execute-graph-adapter.spec.js.map

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