@exellix/exellix-runtime 3.5.1

package/dist/execution-matrix/run-loop.js

@@ -0,0 +1,350 @@
+/**
+ * Continuous run-mode loop and single-pass on-demand driver.
+ *
+ * Both share one cycle: fetch -> materialize -> claim/execute. The continuous variant sleeps
+ * `dataSource.pollWhenEmptySeconds` (resolved per kind) when a cycle produces no work and an
+ * `AbortSignal` is open; the single-pass variant runs exactly one cycle and returns.
+ *
+ * Event/API trigger flows continue to use the existing `executeGraph` / `processNextMatrixClaim`
+ * APIs and are not driven by this loop. See {@link ./execution-mode.ts} `shouldLoopDriveMatrix`.
+ */
+import { RUNTIME_ROW_INPUT_SOURCE_ID_KEY, RUNTIME_ROW_INPUT_SOURCE_IDS_KEY, } from './contracts.js';
+import { resolvePollWhenEmptySeconds } from './data-source.js';
+import { buildEffectiveMatrixConfig, shouldLoopDriveMatrix } from './execution-mode.js';
+import { materializeBatchedRecordRows, materializeExecutionMatrixRuntimeRows, materializeFromSnapshot, } from './materializer.js';
+import { processAllMatrixGraphExecutions, } from './orchestrator.js';
+import { buildSnapshotRecord, runSnapshotTransform, } from './snapshot-runner.js';
+import { diffSourceIdsAgainstMatrix } from './source-resolver.js';
+/* ----------------------------------------------------------------------------
+ * Single cycle
+ * --------------------------------------------------------------------------*/
+/**
+ * Runs exactly one fetch-materialize-execute pass.
+ *
+ * Behavior per `dataSource.kind`:
+ * - `event`: cycle is a no-op unless `inputRows` were supplied; counts as `emptyPass`.
+ * - `storage`: same as `record` (uses the resolver).
+ * - `record`: pulls source ids → diffs vs already-materialized rows → fetches new records →
+ *   bundles by `recordsPerRun` → materializes → runs `processAllMatrixGraphExecutions`.
+ * - `query-snapshot`: pulls records → runs the transform under `node:vm` → persists snapshot →
+ *   materializes from snapshot → runs `processAllMatrixGraphExecutions`.
+ */
+export async function runMatrixCycle(deps, opts) {
+    const dsKind = opts.payload.dataSource?.kind ?? 'event';
+    let fetched = 0;
+    let materialized = 0;
+    let snapshotId;
+    let inserted = false;
+    if (opts.snapshot) {
+        const rows = materializeFromSnapshot({
+            matrixCatalogId: opts.matrixCatalogId,
+            matrixItemId: opts.matrixItemId,
+            ...(opts.matrixRunId !== undefined ? { matrixRunId: opts.matrixRunId } : {}),
+            payload: opts.payload,
+            graphRecords: opts.graphRecords,
+            snapshot: opts.snapshot,
+            ...(opts.payload.dataSource?.kind === 'query-snapshot' && opts.payload.dataSource.materialize
+                ? { materialize: opts.payload.dataSource.materialize }
+                : {}),
+        });
+        materialized += await insertRows(deps.runtime, rows);
+        snapshotId = opts.snapshot.snapshotId;
+        inserted = rows.length > 0;
+    }
+    else if (opts.inputRows && opts.inputRows.length > 0) {
+        const rows = await materializeForKind(opts, opts.inputRows);
+        materialized += await insertRows(deps.runtime, rows);
+        inserted = rows.length > 0;
+        fetched = opts.inputRows.length;
+    }
+    else if (dsKind === 'record' || dsKind === 'storage') {
+        const fetchedRecords = await fetchNewRecordsForKind(deps, opts);
+        fetched = fetchedRecords.length;
+        if (fetched > 0) {
+            const rows = await materializeForKind(opts, fetchedRecords);
+            materialized += await insertRows(deps.runtime, rows);
+            inserted = rows.length > 0;
+        }
+    }
+    else if (dsKind === 'query-snapshot') {
+        const result = await runQuerySnapshotCycle(deps, opts);
+        fetched = result.fetched;
+        snapshotId = result.snapshotId;
+        materialized += result.materialized;
+        inserted = result.materialized > 0;
+    }
+    // event kind with no inputRows -> nothing to do; just attempt to drain any existing
+    // claims (in case the host inserted rows out-of-band).
+    const outcomes = await processAllMatrixGraphExecutions(deps, {
+        matrixCatalogId: opts.matrixCatalogId,
+        ...(opts.matrixRunId !== undefined ? { matrixRunId: opts.matrixRunId } : {}),
+        graphIds: opts.payload.graphs,
+        ...(opts.executeOverrides ? { executeOverrides: opts.executeOverrides } : {}),
+    });
+    const executed = outcomes.filter((o) => 'jobId' in o).length;
+    const emptyPass = !inserted && executed === 0;
+    return {
+        fetched,
+        materialized,
+        executed,
+        emptyPass,
+        ...(snapshotId ? { snapshotId } : {}),
+        outcomes,
+    };
+}
+async function insertRows(runtime, rows) {
+    let count = 0;
+    for (const r of rows) {
+        await runtime.insertRuntimeRow(r);
+        count += 1;
+    }
+    return count;
+}
+async function materializeForKind(opts, inputRows) {
+    const ds = opts.payload.dataSource;
+    if (ds?.kind === 'record' && (ds.recordsPerRun ?? 1) > 1) {
+        return materializeBatchedRecordRows({
+            matrixCatalogId: opts.matrixCatalogId,
+            matrixItemId: opts.matrixItemId,
+            ...(opts.matrixRunId !== undefined ? { matrixRunId: opts.matrixRunId } : {}),
+            payload: opts.payload,
+            graphRecords: opts.graphRecords,
+            inputRows,
+            recordsPerRun: ds.recordsPerRun,
+        });
+    }
+    return materializeExecutionMatrixRuntimeRows({
+        matrixCatalogId: opts.matrixCatalogId,
+        matrixItemId: opts.matrixItemId,
+        ...(opts.matrixRunId !== undefined ? { matrixRunId: opts.matrixRunId } : {}),
+        payload: opts.payload,
+        graphRecords: opts.graphRecords,
+        inputRows,
+    });
+}
+async function fetchNewRecordsForKind(deps, opts) {
+    if (!deps.sourceResolver)
+        return [];
+    const ds = opts.payload.dataSource;
+    if (!ds || (ds.kind !== 'record' && ds.kind !== 'storage'))
+        return [];
+    const selection = ds.selection;
+    const sourceIds = await deps.sourceResolver.listSourceIds(selection, deps.runtimeScope);
+    if (sourceIds.length === 0)
+        return [];
+    const known = await collectKnownSourceIds(deps.runtime, opts);
+    const fresh = diffSourceIdsAgainstMatrix(sourceIds, known);
+    if (fresh.length === 0)
+        return [];
+    return deps.sourceResolver.fetchRecordsByIds(fresh, deps.runtimeScope);
+}
+async function collectKnownSourceIds(runtime, opts) {
+    const rows = await runtime.listRecords({
+        matrixCatalogId: opts.matrixCatalogId,
+        ...(opts.matrixRunId !== undefined ? { matrixRunId: opts.matrixRunId } : {}),
+        limit: 10_000,
+    });
+    const out = new Set();
+    for (const r of rows) {
+        const single = r.input[RUNTIME_ROW_INPUT_SOURCE_ID_KEY];
+        if (typeof single === 'string' && single.length > 0)
+            out.add(single);
+        const many = r.input[RUNTIME_ROW_INPUT_SOURCE_IDS_KEY];
+        if (Array.isArray(many)) {
+            for (const v of many)
+                if (typeof v === 'string' && v.length > 0)
+                    out.add(v);
+        }
+    }
+    return [...out];
+}
+async function runQuerySnapshotCycle(deps, opts) {
+    if (!deps.sourceResolver)
+        return { fetched: 0, materialized: 0 };
+    const ds = opts.payload.dataSource;
+    if (!ds || ds.kind !== 'query-snapshot')
+        return { fetched: 0, materialized: 0 };
+    const selection = ds.selection;
+    const ids = await deps.sourceResolver.listSourceIds(selection, deps.runtimeScope);
+    if (ids.length === 0)
+        return { fetched: 0, materialized: 0 };
+    const records = await deps.sourceResolver.fetchRecordsByIds(ids, deps.runtimeScope);
+    if (records.length === 0)
+        return { fetched: 0, materialized: 0 };
+    const result = runSnapshotTransform(ds.transform, { records });
+    const snapshot = buildSnapshotRecord({
+        matrixCatalogId: opts.matrixCatalogId,
+        ...(opts.matrixRunId !== undefined ? { matrixRunId: opts.matrixRunId } : {}),
+        ...(selection !== undefined ? { selection } : {}),
+        sourceIds: ids,
+        transformResult: result,
+    });
+    await deps.runtime.insertSnapshot(snapshot);
+    const rows = materializeFromSnapshot({
+        matrixCatalogId: opts.matrixCatalogId,
+        matrixItemId: opts.matrixItemId,
+        ...(opts.matrixRunId !== undefined ? { matrixRunId: opts.matrixRunId } : {}),
+        payload: opts.payload,
+        graphRecords: opts.graphRecords,
+        snapshot,
+        ...(ds.materialize ? { materialize: ds.materialize } : {}),
+    });
+    const inserted = await insertRows(deps.runtime, rows);
+    return { fetched: records.length, materialized: inserted, snapshotId: snapshot.snapshotId };
+}
+/* ----------------------------------------------------------------------------
+ * Single-pass on-demand
+ * --------------------------------------------------------------------------*/
+/**
+ * Run exactly one cycle and return. Equivalent to `runMatrixCycle` plus a tagged shape
+ * useful for tests / API responses.
+ */
+export async function runMatrixOncePass(deps, opts) {
+    return runMatrixCycle(deps, opts);
+}
+/* ----------------------------------------------------------------------------
+ * Continuous run-mode
+ * --------------------------------------------------------------------------*/
+/**
+ * Loop until aborted. Sleeps `pollWhenEmptySeconds` (resolved per data source kind, or the override)
+ * after empty cycles. Returns immediately when the matrix's data source kind is `event` (the loop
+ * cannot drive event-driven matrices — host calls execute paths directly on incoming events).
+ */
+export async function runMatrixContinuously(deps, opts) {
+    if (!shouldLoopDriveMatrix(opts.payload)) {
+        return { cyclesRun: 0, reason: 'event-source' };
+    }
+    const sleepSeconds = opts.pollWhenEmptySecondsOverride ?? resolvePollWhenEmptySeconds(opts.payload.dataSource);
+    const maxCycles = opts.maxCycles ?? Number.POSITIVE_INFINITY;
+    let cyclesRun = 0;
+    while (!opts.signal.aborted) {
+        if (cyclesRun >= maxCycles) {
+            return { cyclesRun, reason: 'maxCycles' };
+        }
+        const cycle = await runMatrixCycle(deps, opts);
+        cyclesRun += 1;
+        if (opts.signal.aborted)
+            break;
+        if (cycle.emptyPass && sleepSeconds > 0) {
+            await sleepWithAbort(sleepSeconds * 1000, opts.signal);
+        }
+    }
+    return { cyclesRun, reason: 'aborted' };
+}
+/** Promise sleep that resolves early when `signal` aborts. */
+export function sleepWithAbort(ms, signal) {
+    if (signal.aborted)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/**
+ * Resolve the merged effective configuration plus referenced graph records from the configuration
+ * store. Throws when the matrix is missing or any referenced graph id is missing from the
+ * graph configuration collection.
+ */
+export async function resolveMatrixExecutionConfig(configStore, matrixCatalogId) {
+    const effective = await configStore.matrices.getEffectiveConfig(matrixCatalogId);
+    if (!effective) {
+        throw new Error(`resolveMatrixExecutionConfig: matrix '${matrixCatalogId}' not found`);
+    }
+    const graphRecords = [];
+    for (const graphId of effective.payload.graphs) {
+        const gc = await configStore.graphs.get(graphId);
+        if (!gc) {
+            throw new Error(`resolveMatrixExecutionConfig: graph '${graphId}' referenced by matrix '${matrixCatalogId}' is missing`);
+        }
+        graphRecords.push(gc.payload);
+    }
+    return { effective, graphRecords };
+}
+/**
+ * Config-driven single-pass entry point. Resolves the matrix and its graphs from
+ * {@link ExellixConfigStore} on every call, then invokes {@link runMatrixCycle}.
+ *
+ * Use the inline `runMatrixOncePass(deps, opts)` form when you already have payload + graphRecords
+ * in hand (event/API path); use this form when the host stores configuration centrally.
+ */
+export async function runMatrixOncePassByCatalogId(deps, opts) {
+    const { effective, graphRecords } = await resolveMatrixExecutionConfig(deps.configStore, opts.matrixCatalogId);
+    const cycleOpts = {
+        matrixCatalogId: opts.matrixCatalogId,
+        matrixItemId: opts.matrixItemId,
+        ...(opts.matrixRunId !== undefined ? { matrixRunId: opts.matrixRunId } : {}),
+        payload: effective.payload,
+        graphRecords,
+        ...(opts.inputRows ? { inputRows: opts.inputRows } : {}),
+        ...(opts.snapshot ? { snapshot: opts.snapshot } : {}),
+        ...(opts.jobId !== undefined ? { jobId: opts.jobId } : {}),
+        ...(opts.debugMode !== undefined ? { debugMode: opts.debugMode } : {}),
+        ...(opts.executeOverrides ? { executeOverrides: opts.executeOverrides } : {}),
+    };
+    const result = await runMatrixCycle(deps, cycleOpts);
+    return { ...result, effective };
+}
+/**
+ * Config-driven continuous loop. Re-reads the configuration at the start of each cycle by
+ * default so config edits are picked up without restarting the loop. Pass
+ * `refreshConfigPerCycle: false` to lock in the configuration at startup.
+ */
+export async function runMatrixContinuouslyByCatalogId(deps, opts) {
+    const refresh = opts.refreshConfigPerCycle ?? true;
+    let { effective, graphRecords } = await resolveMatrixExecutionConfig(deps.configStore, opts.matrixCatalogId);
+    if (!shouldLoopDriveMatrix(effective.payload)) {
+        return { cyclesRun: 0, reason: 'event-source' };
+    }
+    const maxCycles = opts.maxCycles ?? Number.POSITIVE_INFINITY;
+    let cyclesRun = 0;
+    while (!opts.signal.aborted) {
+        if (cyclesRun >= maxCycles) {
+            return { cyclesRun, reason: 'maxCycles' };
+        }
+        if (refresh && cyclesRun > 0) {
+            ({ effective, graphRecords } = await resolveMatrixExecutionConfig(deps.configStore, opts.matrixCatalogId));
+            if (!shouldLoopDriveMatrix(effective.payload)) {
+                return { cyclesRun, reason: 'event-source' };
+            }
+        }
+        const cycleOpts = {
+            matrixCatalogId: opts.matrixCatalogId,
+            matrixItemId: opts.matrixItemId,
+            ...(opts.matrixRunId !== undefined ? { matrixRunId: opts.matrixRunId } : {}),
+            payload: effective.payload,
+            graphRecords,
+            ...(opts.inputRows ? { inputRows: opts.inputRows } : {}),
+            ...(opts.snapshot ? { snapshot: opts.snapshot } : {}),
+            ...(opts.jobId !== undefined ? { jobId: opts.jobId } : {}),
+            ...(opts.debugMode !== undefined ? { debugMode: opts.debugMode } : {}),
+            ...(opts.executeOverrides ? { executeOverrides: opts.executeOverrides } : {}),
+        };
+        const cycle = await runMatrixCycle(deps, cycleOpts);
+        cyclesRun += 1;
+        if (opts.signal.aborted)
+            break;
+        if (cycle.emptyPass) {
+            const sleepSeconds = opts.pollWhenEmptySecondsOverride ?? resolvePollWhenEmptySeconds(effective.payload.dataSource);
+            if (sleepSeconds > 0) {
+                await sleepWithAbort(sleepSeconds * 1000, opts.signal);
+            }
+        }
+    }
+    return { cyclesRun, reason: 'aborted' };
+}
+/**
+ * Convenience: build an effective config in-process from an inline payload (useful for tests
+ * and BFF code paths that don't go through the config store).
+ */
+export function buildEffectiveConfigInline(matrixCatalogId, payload) {
+    return buildEffectiveMatrixConfig(matrixCatalogId, payload);
+}
+//# sourceMappingURL=run-loop.js.map

package/dist/execution-matrix/run-loop.js.map

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

package/dist/execution-matrix/runtime-connectivity-health.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Operations / Studio: connectivity and identity payload for **`runtime-real`** style hosts.
+ * HTTP routes live in the product BFF; this module returns JSON-safe structures to serialize from
+ * `GET /api/runtime-real/health` (or `?probe=dependencies` on an existing status route).
+ *
+ * @see docs/execution-matrix-runtime.md — “Runtime-real health”
+ */
+import type { XronoxStore } from '@x12i/xronox-store';
+/** Suggested Studio / BFF path (Graphs Studio `vite-plugin-runtime-real-api` convention). */
+export declare const EXELLIX_RUNTIME_REAL_HEALTH_PATH: "/api/runtime-real/health";
+export type ExellixRuntimeHealthLaneBase = {
+    ok: boolean;
+    reason?: string;
+};
+export type ExellixRuntimeHealthExecutionMongoLane = ExellixRuntimeHealthLaneBase & {
+    collection?: string;
+    /** Redacted URI fingerprint when {@link ExellixRuntimeConnectivityProbeOptions.executionMongoUri} was set. */
+    connectionFingerprint?: string;
+    readProbeMs?: number;
+    connected?: boolean;
+    /** Whether {@link XronoxStore} was constructed with **`mongoDriverCount`** (enables **`countMatching`**). */
+    mongoDriverCount?: 'available' | 'unavailable' | 'skipped';
+};
+export type ExellixRuntimeHealthConfigMongoLane = ExellixRuntimeHealthLaneBase & {
+    collection?: string;
+    connectionFingerprint?: string;
+    readProbeMs?: number;
+    connected?: boolean;
+    mongoDriverCount?: 'available' | 'unavailable' | 'skipped';
+};
+export type ExellixRuntimeHealthXmemoryLane = ExellixRuntimeHealthLaneBase & {
+    connectionFingerprint?: string;
+    mapsDb?: string;
+    opDb?: string;
+    thingsDb?: string;
+};
+export type ExellixRuntimeHealthSchedulerLane = ExellixRuntimeHealthLaneBase & {
+    mode: 'skipped' | 'activix-mongo';
+    /** When **`mode`** is **`activix-mongo`**: result of **`testActivixMongoConnection`**. */
+    mongoPingOk?: boolean;
+    /** Activities collection inspected (matrix-owned default unless overridden in env). */
+    collection?: string;
+    visibleActivityCount?: number;
+    /** Latest activity **`startTime`** from persistence snapshot (ISO string when present). */
+    lastActivityStartTime?: string;
+    /** Host-supplied worker id (e.g. **`MATRIX_WORKER_ID`**) — optional. */
+    workerIdentity?: string;
+};
+export type ExellixRuntimeHealthLanes = {
+    /** Process / API tier is up (always true when this function returns). */
+    runtime: ExellixRuntimeHealthLaneBase & {
+        uptimeSec?: number;
+    };
+    executionMongo?: ExellixRuntimeHealthExecutionMongoLane;
+    configMongo?: ExellixRuntimeHealthConfigMongoLane;
+    xmemory?: ExellixRuntimeHealthXmemoryLane;
+    scheduler?: ExellixRuntimeHealthSchedulerLane;
+};
+export type ExellixRuntimeHealthPackages = {
+    '@exellix/exellix-runtime': string;
+    '@exellix/graph-engine'?: string;
+} & Record<`@x12i/${string}`, string | undefined>;
+export type ExellixRuntimeHealthPayload = {
+    /**
+     * Overall readiness for “matrix execution infrastructure” probes requested in this call.
+     * When only liveness fields are implied (no store probes), this stays **`true`**.
+     */
+    ok: boolean;
+    timestamp: string;
+    buildId: string;
+    packages: ExellixRuntimeHealthPackages;
+    lanes: ExellixRuntimeHealthLanes;
+};
+export type ExellixRuntimeConnectivityProbeOptions = {
+    /**
+     * Build / deploy identity. Falls back to **`EXELLIX_RUNTIME_BUILD_ID`**, **`GIT_SHA`**, then
+     * **`@exellix/exellix-runtime`** package version from **`package.json`**.
+     */
+    buildId?: string;
+    /** Operational matrix **`XronoxStore`** ( **`exellix-runtime`** DB by convention). */
+    executionStore?: XronoxStore;
+    /**
+     * Used for **`connectionFingerprint`** on the execution lane only (never send raw URIs to clients).
+     */
+    executionMongoUri?: string;
+    /** Defaults to matrix rows collection from {@link executionMatrixRowsCollectionDef}. */
+    executionPingCollection?: string;
+    /** Separate config DB store when the host splits operational vs config Mongo. */
+    configStore?: XronoxStore;
+    configMongoUri?: string;
+    /** Defaults to **`exellix_matrix_configs`** collection name from factory wiring. */
+    configPingCollection?: string;
+    /** When true, resolves **`resolveXmemoryStoreEnv`** and reports redacted **`mongoUri`** + DB names (no cluster I/O beyond env parse). */
+    includeXmemoryEnv?: boolean;
+    /**
+     * When true, runs Activix Mongo ping + a small read-only activity snapshot on the matrix-owned collection.
+     * Failures set **`lanes.scheduler.ok`** to false but do **not** flip top-level **`ok`** unless **`schedulerLaneCritical`** is true.
+     */
+    includeActivixSchedulerProbe?: boolean;
+    /** When true, a failed Activix / scheduler lane also sets **`ok: false`**. Default false. */
+    schedulerLaneCritical?: boolean;
+    activixActivitiesCollection?: string;
+    workerIdentity?: string;
+};
+/**
+ * Strip credentials from a Mongo URI for operator dashboards (**host + path + protocol only**).
+ */
+export declare function redactMongoUriForDiagnostics(raw: string): string;
+/**
+ * Package versions from this repo’s **`package.json`** (what support correlates with the published tarball / lockfile).
+ */
+export declare function readExellixRuntimeHealthPackageVersions(): ExellixRuntimeHealthPackages;
+/**
+ * Full connectivity probe for BFF **`/api/runtime-real/health`** (or **`?probe=dependencies`**).
+ *
+ * - With **no** stores passed: **`ok: true`**, **`lanes.runtime`**, **`packages`**, **`buildId`** — no graph / Catalox required.
+ * - With **`executionStore`**: top-level **`ok`** follows execution Mongo read probe (matrix persistence lane).
+ */
+export declare function runExellixRuntimeConnectivityProbe(options?: ExellixRuntimeConnectivityProbeOptions): Promise<ExellixRuntimeHealthPayload>;
+/**
+ * Minimal process liveness JSON (**no Mongo I/O**) — safe for the lightest **`GET …/health`** handler.
+ */
+export declare function buildExellixRuntimeRealLivenessPayload(options?: {
+    buildId?: string;
+}): Pick<ExellixRuntimeHealthPayload, 'ok' | 'timestamp' | 'buildId' | 'packages'> & {
+    lanes: Pick<ExellixRuntimeHealthLanes, 'runtime'>;
+};
+//# sourceMappingURL=runtime-connectivity-health.d.ts.map

package/dist/execution-matrix/runtime-connectivity-health.d.ts.map

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