@exellix/exellix-runtime 3.5.1

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

@@ -0,0 +1,43 @@
+/**
+ * Discriminated `DataSource` helpers: type guards and per-kind parsers used by the catalog loader,
+ * the configuration store, and the run-mode loop.
+ *
+ * The shapes themselves live in {@link ./contracts.ts} so they can be exported alongside the rest
+ * of the public surface.
+ */
+import { type DataSource, type EligibilityPolicy, type SnapshotTransform } from './contracts.js';
+export declare function isDataSource(v: unknown): v is DataSource;
+export declare function isEventDataSource(v: unknown): v is Extract<DataSource, {
+    kind: 'event';
+}>;
+export declare function isStorageDataSource(v: unknown): v is Extract<DataSource, {
+    kind: 'storage';
+}>;
+export declare function isRecordDataSource(v: unknown): v is Extract<DataSource, {
+    kind: 'record';
+}>;
+export declare function isQuerySnapshotDataSource(v: unknown): v is Extract<DataSource, {
+    kind: 'query-snapshot';
+}>;
+/**
+ * Resolve the effective empty-poll interval (seconds) for a data source.
+ *
+ * - `record` → {@link DEFAULT_RECORD_POLL_SECONDS} (60)
+ * - `query-snapshot` → {@link DEFAULT_QUERY_SNAPSHOT_POLL_SECONDS} (3600)
+ * - `storage` → {@link DEFAULT_STORAGE_POLL_SECONDS} (60)
+ * - `event` → 0 (the loop never polls; host drives via API)
+ */
+export declare function resolvePollWhenEmptySeconds(dataSource: DataSource | undefined): number;
+export type DataSourceValidationResult = {
+    dataSource: DataSource;
+    warnings: string[];
+};
+/**
+ * Validate and normalize a `dataSource` block. Throws when the shape is invalid.
+ * Returns `{ dataSource, warnings }` so the caller (catalog parser / config store) can
+ * surface advisory issues without rejecting the configuration.
+ */
+export declare function parseDataSource(raw: unknown, issues: string[]): DataSourceValidationResult;
+export declare function parseSnapshotTransform(raw: unknown, issues: string[]): SnapshotTransform;
+export declare function parseEligibility(raw: unknown, issues: string[]): EligibilityPolicy;
+//# sourceMappingURL=data-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-source.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/data-source.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAOL,KAAK,UAAU,EAEf,KAAK,iBAAiB,EAEtB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AAqBxB,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,UAAU,CAGxD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAEzF;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAE7F;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAE3F;AAED,wBAAgB,yBAAyB,CACvC,CAAC,EAAE,OAAO,GACT,CAAC,IAAI,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAEtD;AAMD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAYtF;AAMD,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,0BAA0B,CAqH1F;AA0BD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAsCxF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAkClF"}

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

@@ -0,0 +1,307 @@
+/**
+ * Discriminated `DataSource` helpers: type guards and per-kind parsers used by the catalog loader,
+ * the configuration store, and the run-mode loop.
+ *
+ * The shapes themselves live in {@link ./contracts.ts} so they can be exported alongside the rest
+ * of the public surface.
+ */
+import { DEFAULT_QUERY_SNAPSHOT_POLL_SECONDS, DEFAULT_RECORD_POLL_SECONDS, DEFAULT_STORAGE_POLL_SECONDS, EXECUTION_MATRIX_STATUSES, MAX_RECORDS_PER_RUN, SNAPSHOT_TRANSFORM_TIMEOUT_HARD_CAP_MS, } from './contracts.js';
+const DATA_SOURCE_KINDS = [
+    'event',
+    'storage',
+    'record',
+    'query-snapshot',
+];
+function isPlainObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+function isPositiveInt(v) {
+    return typeof v === 'number' && Number.isFinite(v) && Number.isInteger(v) && v >= 1;
+}
+/* ----------------------------------------------------------------------------
+ * Type guards
+ * --------------------------------------------------------------------------*/
+export function isDataSource(v) {
+    if (!isPlainObject(v))
+        return false;
+    return DATA_SOURCE_KINDS.includes(v.kind);
+}
+export function isEventDataSource(v) {
+    return isPlainObject(v) && v.kind === 'event';
+}
+export function isStorageDataSource(v) {
+    return isPlainObject(v) && v.kind === 'storage';
+}
+export function isRecordDataSource(v) {
+    return isPlainObject(v) && v.kind === 'record';
+}
+export function isQuerySnapshotDataSource(v) {
+    return isPlainObject(v) && v.kind === 'query-snapshot';
+}
+/* ----------------------------------------------------------------------------
+ * Defaults
+ * --------------------------------------------------------------------------*/
+/**
+ * Resolve the effective empty-poll interval (seconds) for a data source.
+ *
+ * - `record` → {@link DEFAULT_RECORD_POLL_SECONDS} (60)
+ * - `query-snapshot` → {@link DEFAULT_QUERY_SNAPSHOT_POLL_SECONDS} (3600)
+ * - `storage` → {@link DEFAULT_STORAGE_POLL_SECONDS} (60)
+ * - `event` → 0 (the loop never polls; host drives via API)
+ */
+export function resolvePollWhenEmptySeconds(dataSource) {
+    if (!dataSource)
+        return DEFAULT_RECORD_POLL_SECONDS;
+    switch (dataSource.kind) {
+        case 'event':
+            return 0;
+        case 'storage':
+            return dataSource.pollWhenEmptySeconds ?? DEFAULT_STORAGE_POLL_SECONDS;
+        case 'record':
+            return dataSource.pollWhenEmptySeconds ?? DEFAULT_RECORD_POLL_SECONDS;
+        case 'query-snapshot':
+            return dataSource.pollWhenEmptySeconds ?? DEFAULT_QUERY_SNAPSHOT_POLL_SECONDS;
+    }
+}
+/**
+ * Validate and normalize a `dataSource` block. Throws when the shape is invalid.
+ * Returns `{ dataSource, warnings }` so the caller (catalog parser / config store) can
+ * surface advisory issues without rejecting the configuration.
+ */
+export function parseDataSource(raw, issues) {
+    const warnings = [];
+    if (!isPlainObject(raw)) {
+        issues.push('dataSource must be an object');
+        throw new Error('parseDataSource: invalid root');
+    }
+    const kind = raw.kind;
+    if (typeof kind !== 'string' || !DATA_SOURCE_KINDS.includes(kind)) {
+        issues.push(`dataSource.kind must be one of ${DATA_SOURCE_KINDS.join(', ')}`);
+        throw new Error('parseDataSource: invalid kind');
+    }
+    switch (kind) {
+        case 'event': {
+            const subKind = raw.subKind;
+            if (subKind !== undefined && !['api', 'on-demand', 'chat'].includes(String(subKind))) {
+                issues.push("dataSource.subKind must be one of 'api', 'on-demand', 'chat' when set");
+                throw new Error('parseDataSource: invalid subKind');
+            }
+            const correlationKey = raw.correlationKey;
+            if (correlationKey !== undefined && typeof correlationKey !== 'string') {
+                issues.push('dataSource.correlationKey must be a string when set');
+                throw new Error('parseDataSource: invalid correlationKey');
+            }
+            const ds = { kind: 'event' };
+            if (subKind !== undefined)
+                ds.subKind = subKind;
+            if (typeof correlationKey === 'string')
+                ds.correlationKey = correlationKey;
+            return { dataSource: ds, warnings };
+        }
+        case 'storage': {
+            const container = raw.container;
+            if (typeof container !== 'string' || !container.trim()) {
+                issues.push('dataSource.container must be a non-empty string');
+                throw new Error('parseDataSource: invalid container');
+            }
+            const path = raw.path;
+            if (path !== undefined && typeof path !== 'string') {
+                issues.push('dataSource.path must be a string when set');
+                throw new Error('parseDataSource: invalid path');
+            }
+            const selector = raw.selector;
+            if (selector !== undefined && !isPlainObject(selector)) {
+                issues.push('dataSource.selector must be an object when set');
+                throw new Error('parseDataSource: invalid selector');
+            }
+            const poll = parsePollWhenEmpty(raw.pollWhenEmptySeconds, issues, warnings, 'storage');
+            const eligibility = raw.eligibility !== undefined ? parseEligibility(raw.eligibility, issues) : undefined;
+            const ds = {
+                kind: 'storage',
+                container: container.trim(),
+            };
+            if (typeof path === 'string')
+                ds.path = path;
+            if (selector !== undefined)
+                ds.selector = selector;
+            if (poll !== undefined)
+                ds.pollWhenEmptySeconds = poll;
+            if (eligibility)
+                ds.eligibility = eligibility;
+            return { dataSource: ds, warnings };
+        }
+        case 'record': {
+            const collectionRef = raw.collectionRef;
+            if (typeof collectionRef !== 'string' || !collectionRef.trim()) {
+                issues.push('dataSource.collectionRef must be a non-empty string');
+                throw new Error('parseDataSource: invalid collectionRef');
+            }
+            const selection = raw.selection;
+            if (selection !== undefined && !isPlainObject(selection)) {
+                issues.push('dataSource.selection must be an object when set');
+                throw new Error('parseDataSource: invalid selection');
+            }
+            const recordsPerRun = raw.recordsPerRun;
+            if (recordsPerRun !== undefined) {
+                if (!isPositiveInt(recordsPerRun) || recordsPerRun > MAX_RECORDS_PER_RUN) {
+                    issues.push(`dataSource.recordsPerRun must be an integer in [1..${MAX_RECORDS_PER_RUN}]`);
+                    throw new Error('parseDataSource: invalid recordsPerRun');
+                }
+            }
+            const poll = parsePollWhenEmpty(raw.pollWhenEmptySeconds, issues, warnings, 'record');
+            const eligibility = raw.eligibility !== undefined ? parseEligibility(raw.eligibility, issues) : undefined;
+            const ds = {
+                kind: 'record',
+                collectionRef: collectionRef.trim(),
+            };
+            if (selection !== undefined)
+                ds.selection = selection;
+            if (typeof recordsPerRun === 'number')
+                ds.recordsPerRun = recordsPerRun;
+            if (poll !== undefined)
+                ds.pollWhenEmptySeconds = poll;
+            if (eligibility)
+                ds.eligibility = eligibility;
+            return { dataSource: ds, warnings };
+        }
+        case 'query-snapshot': {
+            const collectionRef = raw.collectionRef;
+            if (typeof collectionRef !== 'string' || !collectionRef.trim()) {
+                issues.push('dataSource.collectionRef must be a non-empty string');
+                throw new Error('parseDataSource: invalid collectionRef');
+            }
+            const selection = raw.selection;
+            if (selection !== undefined && !isPlainObject(selection)) {
+                issues.push('dataSource.selection must be an object when set');
+                throw new Error('parseDataSource: invalid selection');
+            }
+            const transform = parseSnapshotTransform(raw.transform, issues);
+            const materialize = raw.materialize;
+            if (materialize !== undefined && materialize !== 'one-row' && materialize !== 'expand') {
+                issues.push("dataSource.materialize must be 'one-row' or 'expand' when set");
+                throw new Error('parseDataSource: invalid materialize');
+            }
+            const poll = parsePollWhenEmpty(raw.pollWhenEmptySeconds, issues, warnings, 'query-snapshot');
+            const eligibility = raw.eligibility !== undefined ? parseEligibility(raw.eligibility, issues) : undefined;
+            const ds = {
+                kind: 'query-snapshot',
+                collectionRef: collectionRef.trim(),
+                transform,
+            };
+            if (selection !== undefined)
+                ds.selection = selection;
+            if (materialize === 'one-row' || materialize === 'expand')
+                ds.materialize = materialize;
+            if (poll !== undefined)
+                ds.pollWhenEmptySeconds = poll;
+            if (eligibility)
+                ds.eligibility = eligibility;
+            return { dataSource: ds, warnings };
+        }
+    }
+}
+function parsePollWhenEmpty(raw, issues, warnings, kind) {
+    if (raw === undefined)
+        return undefined;
+    if (!isPositiveInt(raw)) {
+        issues.push(`dataSource.pollWhenEmptySeconds must be a positive integer when set`);
+        throw new Error('parsePollWhenEmpty: invalid value');
+    }
+    if (kind === 'query-snapshot' && raw < 60) {
+        warnings.push(`dataSource.pollWhenEmptySeconds=${raw} is unusually short for query-snapshot (recommended >= 60s)`);
+    }
+    if (kind === 'record' && raw > 24 * 60 * 60) {
+        warnings.push(`dataSource.pollWhenEmptySeconds=${raw} is unusually long for record (> 24h; consider executionMode='single-pass' instead)`);
+    }
+    return raw;
+}
+export function parseSnapshotTransform(raw, issues) {
+    if (!isPlainObject(raw)) {
+        issues.push('dataSource.transform must be an object');
+        throw new Error('parseSnapshotTransform: invalid root');
+    }
+    const language = raw.language;
+    if (language !== 'js') {
+        issues.push("dataSource.transform.language must be 'js'");
+        throw new Error('parseSnapshotTransform: invalid language');
+    }
+    const source = raw.source;
+    if (typeof source !== 'string' || !source.trim()) {
+        issues.push('dataSource.transform.source must be a non-empty string');
+        throw new Error('parseSnapshotTransform: invalid source');
+    }
+    const version = raw.version;
+    if (typeof version !== 'string' || !version.trim()) {
+        issues.push('dataSource.transform.version must be a non-empty string');
+        throw new Error('parseSnapshotTransform: invalid version');
+    }
+    const timeoutMs = raw.timeoutMs;
+    if (timeoutMs !== undefined) {
+        if (!isPositiveInt(timeoutMs) || timeoutMs > SNAPSHOT_TRANSFORM_TIMEOUT_HARD_CAP_MS) {
+            issues.push(`dataSource.transform.timeoutMs must be a positive integer <= ${SNAPSHOT_TRANSFORM_TIMEOUT_HARD_CAP_MS}`);
+            throw new Error('parseSnapshotTransform: invalid timeoutMs');
+        }
+    }
+    const memoryMb = raw.memoryMb;
+    if (memoryMb !== undefined && (!isPositiveInt(memoryMb) || memoryMb > 1024)) {
+        issues.push('dataSource.transform.memoryMb must be a positive integer (advisory, capped at 1024)');
+        throw new Error('parseSnapshotTransform: invalid memoryMb');
+    }
+    const out = { language: 'js', source, version: version.trim() };
+    if (typeof timeoutMs === 'number')
+        out.timeoutMs = timeoutMs;
+    if (typeof memoryMb === 'number')
+        out.memoryMb = memoryMb;
+    return out;
+}
+export function parseEligibility(raw, issues) {
+    if (!isPlainObject(raw)) {
+        issues.push('eligibility must be an object');
+        throw new Error('parseEligibility: invalid root');
+    }
+    const out = {};
+    if (raw.fromStatuses !== undefined) {
+        out.fromStatuses = parseStatusList(raw.fromStatuses, issues, 'eligibility.fromStatuses');
+    }
+    if (raw.excludeStatuses !== undefined) {
+        out.excludeStatuses = parseStatusList(raw.excludeStatuses, issues, 'eligibility.excludeStatuses');
+    }
+    if (raw.ageMinMinutes !== undefined) {
+        if (typeof raw.ageMinMinutes !== 'number' || !Number.isFinite(raw.ageMinMinutes) || raw.ageMinMinutes < 0) {
+            issues.push('eligibility.ageMinMinutes must be a non-negative number');
+            throw new Error('parseEligibility: invalid ageMinMinutes');
+        }
+        out.ageMinMinutes = raw.ageMinMinutes;
+    }
+    if (raw.modelProfileNotIn !== undefined) {
+        if (!Array.isArray(raw.modelProfileNotIn) || raw.modelProfileNotIn.some((v) => typeof v !== 'string')) {
+            issues.push('eligibility.modelProfileNotIn must be a string array');
+            throw new Error('parseEligibility: invalid modelProfileNotIn');
+        }
+        out.modelProfileNotIn = raw.modelProfileNotIn;
+    }
+    if (raw.extraFilter !== undefined) {
+        if (!isPlainObject(raw.extraFilter)) {
+            issues.push('eligibility.extraFilter must be an object');
+            throw new Error('parseEligibility: invalid extraFilter');
+        }
+        out.extraFilter = raw.extraFilter;
+    }
+    return out;
+}
+function parseStatusList(raw, issues, path) {
+    if (!Array.isArray(raw)) {
+        issues.push(`${path} must be an array`);
+        throw new Error('parseStatusList: not array');
+    }
+    const out = [];
+    for (const v of raw) {
+        if (typeof v !== 'string' || !EXECUTION_MATRIX_STATUSES.includes(v)) {
+            issues.push(`${path} contains invalid status ${JSON.stringify(v)}`);
+            throw new Error('parseStatusList: invalid status');
+        }
+        out.push(v);
+    }
+    return out;
+}
+//# sourceMappingURL=data-source.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * Convert {@link EligibilityPolicy} into concrete claim parameters consumed by
+ * `ExecutionMatrixRuntime.claimNext` / `claimRecord`.
+ *
+ * Pure module — no IO, no logging — so the orchestrator and config-store can call it
+ * deterministically without side effects.
+ */
+import type { EligibilityPolicy, ExecutionMatrixStatus } from './contracts.js';
+export type EligibilityClaimParams = {
+    /** Mapped 1:1 to `ClaimNextOptions.fromStatuses` (or default when `undefined`). */
+    fromStatuses?: ExecutionMatrixStatus[];
+    /** Merged into `ClaimNextOptions.extraFilter`. */
+    extraFilter?: Record<string, unknown>;
+};
+/**
+ * Resolve effective claim parameters from an eligibility policy.
+ *
+ * Behavior:
+ * - `fromStatuses` defaults to `['not-started']` when omitted.
+ * - `excludeStatuses` (default `['in-progress']`) is subtracted from `fromStatuses`.
+ * - When `ageMinMinutes > 0`, an extra Mongo-style filter requires
+ *   `execution.$elemMatch.lastAttempt.endedAt` to be missing OR `<= cutoff` ISO timestamp.
+ *   The clause is added under key `__eligibilityAgeCutoff` so callers can debug-trace it;
+ *   in practice it is consumed by orchestrator-level merging when host wires it in.
+ * - When `modelProfileNotIn` is non-empty, an analogous clause requires the prior
+ *   `lastAttempt.modelProfile` to be absent or NOT in the list. This is also added under
+ *   `__eligibilityModelProfileNotIn` for trace; orchestrator merges it into the actual claim filter.
+ * - `extraFilter` from the policy is merged in last (policy wins on collisions with derived clauses).
+ *
+ * Note: the runtime's claim path supports the simple key-value `extraFilter` form. Mongo-side it
+ * also accepts `$elemMatch`-style clauses. Hosts that need the age / modelProfile clauses applied
+ * to the actual claim should configure their store with Mongo and ensure the keys above are
+ * interpreted by their query layer; see {@link ExecutionMatrixRuntime} for how the in-memory
+ * matcher walks paths.
+ */
+export declare function eligibilityToClaim(policy: EligibilityPolicy | undefined, now?: Date): EligibilityClaimParams;
+/**
+ * In-memory predicate variant of {@link eligibilityToClaim} for callers that walk rows
+ * client-side (memory store path). Returns a function that returns true when a runtime step
+ * matches the eligibility's age / modelProfile constraints.
+ */
+export declare function makeEligibilityStepPredicate(policy: EligibilityPolicy | undefined, now?: Date): (step: {
+    lastAttempt?: {
+        endedAt?: string;
+        modelProfile?: string;
+    };
+}) => boolean;
+//# sourceMappingURL=eligibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE/E,MAAM,MAAM,sBAAsB,GAAG;IACnC,mFAAmF;IACnF,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACvC,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,CAAC;AAKF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,GAAG,GAAE,IAAiB,GACrB,sBAAsB,CA8BxB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,GAAG,GAAE,IAAiB,GACrB,CAAC,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,KAAK,OAAO,CAuBlF"}

package/dist/execution-matrix/eligibility.js

@@ -0,0 +1,89 @@
+/**
+ * Convert {@link EligibilityPolicy} into concrete claim parameters consumed by
+ * `ExecutionMatrixRuntime.claimNext` / `claimRecord`.
+ *
+ * Pure module — no IO, no logging — so the orchestrator and config-store can call it
+ * deterministically without side effects.
+ */
+const DEFAULT_FROM_STATUSES = ['not-started'];
+const DEFAULT_EXCLUDE_STATUSES = ['in-progress'];
+/**
+ * Resolve effective claim parameters from an eligibility policy.
+ *
+ * Behavior:
+ * - `fromStatuses` defaults to `['not-started']` when omitted.
+ * - `excludeStatuses` (default `['in-progress']`) is subtracted from `fromStatuses`.
+ * - When `ageMinMinutes > 0`, an extra Mongo-style filter requires
+ *   `execution.$elemMatch.lastAttempt.endedAt` to be missing OR `<= cutoff` ISO timestamp.
+ *   The clause is added under key `__eligibilityAgeCutoff` so callers can debug-trace it;
+ *   in practice it is consumed by orchestrator-level merging when host wires it in.
+ * - When `modelProfileNotIn` is non-empty, an analogous clause requires the prior
+ *   `lastAttempt.modelProfile` to be absent or NOT in the list. This is also added under
+ *   `__eligibilityModelProfileNotIn` for trace; orchestrator merges it into the actual claim filter.
+ * - `extraFilter` from the policy is merged in last (policy wins on collisions with derived clauses).
+ *
+ * Note: the runtime's claim path supports the simple key-value `extraFilter` form. Mongo-side it
+ * also accepts `$elemMatch`-style clauses. Hosts that need the age / modelProfile clauses applied
+ * to the actual claim should configure their store with Mongo and ensure the keys above are
+ * interpreted by their query layer; see {@link ExecutionMatrixRuntime} for how the in-memory
+ * matcher walks paths.
+ */
+export function eligibilityToClaim(policy, now = new Date()) {
+    if (!policy) {
+        return { fromStatuses: [...DEFAULT_FROM_STATUSES] };
+    }
+    const include = policy.fromStatuses && policy.fromStatuses.length > 0
+        ? [...policy.fromStatuses]
+        : [...DEFAULT_FROM_STATUSES];
+    const exclude = policy.excludeStatuses && policy.excludeStatuses.length > 0
+        ? policy.excludeStatuses
+        : DEFAULT_EXCLUDE_STATUSES;
+    const fromStatuses = include.filter((s) => !exclude.includes(s));
+    const extraFilter = {};
+    if (typeof policy.ageMinMinutes === 'number' && policy.ageMinMinutes > 0) {
+        const cutoff = new Date(now.getTime() - policy.ageMinMinutes * 60_000).toISOString();
+        extraFilter['execution.lastAttempt.endedAt.$lte'] = cutoff;
+    }
+    if (policy.modelProfileNotIn && policy.modelProfileNotIn.length > 0) {
+        extraFilter['execution.lastAttempt.modelProfile.$nin'] = [...policy.modelProfileNotIn];
+    }
+    if (policy.extraFilter && Object.keys(policy.extraFilter).length > 0) {
+        Object.assign(extraFilter, policy.extraFilter);
+    }
+    const out = { fromStatuses };
+    if (Object.keys(extraFilter).length > 0)
+        out.extraFilter = extraFilter;
+    return out;
+}
+/**
+ * In-memory predicate variant of {@link eligibilityToClaim} for callers that walk rows
+ * client-side (memory store path). Returns a function that returns true when a runtime step
+ * matches the eligibility's age / modelProfile constraints.
+ */
+export function makeEligibilityStepPredicate(policy, now = new Date()) {
+    if (!policy)
+        return () => true;
+    const cutoffMs = typeof policy.ageMinMinutes === 'number' && policy.ageMinMinutes > 0
+        ? now.getTime() - policy.ageMinMinutes * 60_000
+        : null;
+    const blockedProfiles = policy.modelProfileNotIn && policy.modelProfileNotIn.length > 0
+        ? new Set(policy.modelProfileNotIn)
+        : null;
+    return (step) => {
+        if (cutoffMs !== null) {
+            const endedAt = step.lastAttempt?.endedAt;
+            if (endedAt) {
+                const t = Date.parse(endedAt);
+                if (Number.isFinite(t) && t > cutoffMs)
+                    return false;
+            }
+        }
+        if (blockedProfiles) {
+            const profile = step.lastAttempt?.modelProfile;
+            if (profile && blockedProfiles.has(profile))
+                return false;
+        }
+        return true;
+    };
+}
+//# sourceMappingURL=eligibility.js.map

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

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

package/dist/execution-matrix/execution-matrix-claim-pause.d.ts

@@ -0,0 +1,20 @@
+/**
+ * In-process pause / resume for matrix workers using {@link ProcessMatrixClaimDeps.shouldClaimNext}.
+ *
+ * Use one controller per worker (or share across workers only if you intend coordinated pause).
+ */
+export type ExecutionMatrixClaimPauseController = {
+    /** After this, {@link shouldClaimNext} returns false until {@link resume}. */
+    pause: () => void;
+    /** Allow new claims again. */
+    resume: () => void;
+    isPaused: () => boolean;
+    /** Pass to {@link ProcessMatrixClaimDeps.shouldClaimNext}. */
+    shouldClaimNext: () => boolean;
+};
+/**
+ * Creates a simple pause gate: **`shouldClaimNext`** is **`true`** while not paused.
+ * Pausing does not interrupt **`executeGraph`** for a claim already taken; it only blocks the next claim.
+ */
+export declare function createExecutionMatrixClaimPauseController(initialPaused?: boolean): ExecutionMatrixClaimPauseController;
+//# sourceMappingURL=execution-matrix-claim-pause.d.ts.map

package/dist/execution-matrix/execution-matrix-claim-pause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-matrix-claim-pause.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/execution-matrix-claim-pause.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,8EAA8E;IAC9E,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,8DAA8D;IAC9D,eAAe,EAAE,MAAM,OAAO,CAAC;CAChC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yCAAyC,CACvD,aAAa,UAAQ,GACpB,mCAAmC,CAYrC"}

package/dist/execution-matrix/execution-matrix-claim-pause.js

@@ -0,0 +1,18 @@
+/**
+ * Creates a simple pause gate: **`shouldClaimNext`** is **`true`** while not paused.
+ * Pausing does not interrupt **`executeGraph`** for a claim already taken; it only blocks the next claim.
+ */
+export function createExecutionMatrixClaimPauseController(initialPaused = false) {
+    let paused = initialPaused;
+    return {
+        pause: () => {
+            paused = true;
+        },
+        resume: () => {
+            paused = false;
+        },
+        isPaused: () => paused,
+        shouldClaimNext: () => !paused,
+    };
+}
+//# sourceMappingURL=execution-matrix-claim-pause.js.map

package/dist/execution-matrix/execution-matrix-claim-pause.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-matrix-claim-pause.js","sourceRoot":"","sources":["../../src/execution-matrix/execution-matrix-claim-pause.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,UAAU,yCAAyC,CACvD,aAAa,GAAG,KAAK;IAErB,IAAI,MAAM,GAAG,aAAa,CAAC;IAC3B,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,EAAE,GAAG,EAAE;YACX,MAAM,GAAG,KAAK,CAAC;QACjB,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM;QACtB,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM;KAC/B,CAAC;AACJ,CAAC"}

package/dist/execution-matrix/execution-matrix-claim-pause.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=execution-matrix-claim-pause.spec.d.ts.map

package/dist/execution-matrix/execution-matrix-claim-pause.spec.d.ts.map

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

package/dist/execution-matrix/execution-matrix-claim-pause.spec.js

@@ -0,0 +1,23 @@
+import { describe, expect, it } from 'vitest';
+import { createExecutionMatrixClaimPauseController } from './execution-matrix-claim-pause.js';
+describe('createExecutionMatrixClaimPauseController', () => {
+    it('exposes pause, resume, and shouldClaimNext', () => {
+        const c = createExecutionMatrixClaimPauseController();
+        expect(c.isPaused()).toBe(false);
+        expect(c.shouldClaimNext()).toBe(true);
+        c.pause();
+        expect(c.isPaused()).toBe(true);
+        expect(c.shouldClaimNext()).toBe(false);
+        c.resume();
+        expect(c.isPaused()).toBe(false);
+        expect(c.shouldClaimNext()).toBe(true);
+    });
+    it('honors initialPaused', () => {
+        const c = createExecutionMatrixClaimPauseController(true);
+        expect(c.isPaused()).toBe(true);
+        expect(c.shouldClaimNext()).toBe(false);
+        c.resume();
+        expect(c.shouldClaimNext()).toBe(true);
+    });
+});
+//# sourceMappingURL=execution-matrix-claim-pause.spec.js.map

package/dist/execution-matrix/execution-matrix-claim-pause.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-matrix-claim-pause.spec.js","sourceRoot":"","sources":["../../src/execution-matrix/execution-matrix-claim-pause.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,yCAAyC,EAAE,MAAM,mCAAmC,CAAC;AAE9F,QAAQ,CAAC,2CAA2C,EAAE,GAAG,EAAE;IACzD,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,GAAG,yCAAyC,EAAE,CAAC;QACtD,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC,CAAC,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,GAAG,yCAAyC,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/execution-matrix/execution-matrix.live.spec.d.ts

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

package/dist/execution-matrix/execution-matrix.live.spec.d.ts.map

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