@x12i/memorix-pipeline-orchestrator 1.0.0

package/dist/runtime/execute-step.d.ts

@@ -0,0 +1,22 @@
+import { type PipelineServiceResponse } from "@x12i/memorix-pipeline-services";
+import type { PipelineRun, PipelineStep, StepRun } from "../types.js";
+import type { OrchestratorRuntimePorts } from "./ports.js";
+export declare function resolveStepInputs(step: PipelineStep, run: PipelineRun, stepOutputs: Record<string, Record<string, unknown>>): Record<string, unknown>;
+/**
+ * Promote worker result *Ref fields and snapshotId onto step outputs so
+ * downstream requiredInputs / envelope builders can wire them by name.
+ */
+export declare function extractNamedResultRefs(resultBody: unknown, snapshotId?: string, snapshotCollection?: string): Record<string, unknown>;
+export type ExecuteStepResult = {
+    stepRun: StepRun;
+    outputs: Record<string, unknown>;
+};
+export declare function executeStep(options: {
+    step: PipelineStep;
+    run: PipelineRun;
+    stepOutputs: Record<string, Record<string, unknown>>;
+    ports: OrchestratorRuntimePorts;
+    signal?: AbortSignal;
+}): Promise<ExecuteStepResult>;
+export type { PipelineServiceResponse };
+//# sourceMappingURL=execute-step.d.ts.map

package/dist/runtime/execute-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-step.d.ts","sourceRoot":"","sources":["../../src/runtime/execute-step.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,KAAK,EAAe,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAgBxE,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCzB;AAWD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,OAAO,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8CzB;AAsBD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,wBAAsB,WAAW,CAAC,OAAO,EAAE;IACzC,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,WAAW,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,KAAK,EAAE,wBAAwB,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiT7B;AAED,YAAY,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/runtime/execute-step.js

@@ -0,0 +1,406 @@
+import { redactSensitive, } from "@x12i/memorix-pipeline-services";
+import { resolveRawCollection, resolveSnapshotsCollection } from "../collections.js";
+import { buildInvokeEnvelope } from "./build-invoke-envelope.js";
+import { createDerivedObjectContentRefResolver, resolveSelectorsToRefs, } from "./object-content-resolver.js";
+import { getContextPath } from "./run-context.js";
+import { interpretWorkerResponse } from "./preflight.js";
+function substitute(template, inputs) {
+    return template.replace(/<([a-zA-Z0-9_]+)>/g, (_m, key) => {
+        const v = inputs[key];
+        return v == null ? "" : String(v);
+    });
+}
+export function resolveStepInputs(step, run, stepOutputs) {
+    const context = run.context ?? {};
+    const config = typeof context.connectorConfig === "object" && context.connectorConfig !== null
+        ? context.connectorConfig
+        : {};
+    const out = {};
+    for (const req of step.requiredInputs) {
+        let value;
+        switch (req.source) {
+            case "literal":
+                value = req.value;
+                break;
+            case "connector-config":
+                value = config[req.name] ?? context[req.name];
+                break;
+            case "run-context":
+                value = getContextPath(context, req.name) ?? context[req.name];
+                break;
+            case "step-output": {
+                const from = req.fromStep ? stepOutputs[req.fromStep] : undefined;
+                value = from?.[req.name] ?? from?.result ?? from;
+                break;
+            }
+            default:
+                value = undefined;
+        }
+        if (value === undefined && req.required) {
+            throw new Error(`Missing required input "${req.name}" for step ${step.id}`);
+        }
+        if (value !== undefined)
+            out[req.name] = value;
+    }
+    return out;
+}
+function isDataRef(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        typeof value.collection === "string");
+}
+/**
+ * Promote worker result *Ref fields and snapshotId onto step outputs so
+ * downstream requiredInputs / envelope builders can wire them by name.
+ */
+export function extractNamedResultRefs(resultBody, snapshotId, snapshotCollection) {
+    const named = {};
+    const body = resultBody != null && typeof resultBody === "object" && !Array.isArray(resultBody)
+        ? resultBody
+        : null;
+    const result = body && body.result != null && typeof body.result === "object" && !Array.isArray(body.result)
+        ? body.result
+        : body;
+    if (result) {
+        for (const [key, value] of Object.entries(result)) {
+            if (key.endsWith("Ref") && isDataRef(value)) {
+                named[key] = value;
+            }
+            if (key.endsWith("Refs") && Array.isArray(value)) {
+                named[key] = value;
+            }
+            if (key === "receiptIds" && Array.isArray(value)) {
+                named.receiptIds = value;
+            }
+            if (key === "dlqIssueIds" && Array.isArray(value)) {
+                named.dlqIssueIds = value;
+            }
+        }
+        if (isDataRef(result.analysisRef))
+            named.analysisRef = result.analysisRef;
+        if (isDataRef(result.decisionRef))
+            named.decisionRef = result.decisionRef;
+        if (isDataRef(result.narrativeRef))
+            named.narrativeRef = result.narrativeRef;
+        if (isDataRef(result.contentRef))
+            named.contentRef = result.contentRef;
+        if (isDataRef(result.discoveriesRef))
+            named.discoveriesRef = result.discoveriesRef;
+        if (isDataRef(result.suggestedPlansRef))
+            named.suggestedPlansRef = result.suggestedPlansRef;
+        if (isDataRef(result.suggestedActionsRef)) {
+            named.suggestedActionsRef = result.suggestedActionsRef;
+        }
+    }
+    if (snapshotId && snapshotCollection) {
+        const snapRef = {
+            collection: snapshotCollection,
+            snapshotId,
+        };
+        if (!named.resultRef)
+            named.resultRef = snapRef;
+    }
+    return named;
+}
+async function defaultFetch(url, init) {
+    const res = await fetch(url, init);
+    const text = await res.text();
+    let body;
+    try {
+        body = text ? JSON.parse(text) : null;
+    }
+    catch {
+        body = { raw: text };
+    }
+    return { status: res.status, body };
+}
+function executionTimeoutMs(step) {
+    const exec = step.request?.execution;
+    return typeof exec?.timeoutMs === "number" ? exec.timeoutMs : undefined;
+}
+export async function executeStep(options) {
+    const { step, run, stepOutputs, ports } = options;
+    const startedAt = new Date().toISOString();
+    let attempts = 0;
+    const maxRetries = Math.max(0, step.errorBehavior.maxRetries);
+    const fetchImpl = ports.fetchImpl ?? defaultFetch;
+    const resolver = ports.objectContentResolver ?? createDerivedObjectContentRefResolver();
+    for (const dep of step.dependsOn) {
+        const depRun = run.stepRuns[dep];
+        if (!depRun || depRun.status !== "completed") {
+            if (step.errorBehavior.onMissingDependency === "skip") {
+                return {
+                    stepRun: {
+                        stepId: step.id,
+                        status: "completed",
+                        attempts: 0,
+                        startedAt,
+                        finishedAt: new Date().toISOString(),
+                        outputs: { skipped: true, reason: `missing dependency ${dep}` },
+                    },
+                    outputs: {},
+                };
+            }
+            if (step.errorBehavior.onMissingDependency === "block") {
+                return {
+                    stepRun: {
+                        stepId: step.id,
+                        status: "pending",
+                        attempts: 0,
+                        error: `Blocked: dependency ${dep} not completed`,
+                    },
+                    outputs: {},
+                };
+            }
+            throw new Error(`Missing dependency ${dep} for step ${step.id}`);
+        }
+    }
+    let lastError;
+    let lastWorkerStatus;
+    while (attempts <= maxRetries) {
+        attempts += 1;
+        const controller = new AbortController();
+        const onAbort = () => controller.abort();
+        if (options.signal) {
+            if (options.signal.aborted)
+                controller.abort();
+            else
+                options.signal.addEventListener("abort", onAbort, { once: true });
+        }
+        const timeoutMs = executionTimeoutMs(step);
+        const timer = timeoutMs != null
+            ? setTimeout(() => controller.abort(), timeoutMs)
+            : undefined;
+        try {
+            if (controller.signal.aborted) {
+                throw new Error("Step aborted");
+            }
+            const inputs = resolveStepInputs(step, run, stepOutputs);
+            let resultBody = null;
+            const declaredInputRefs = step.objectTypes?.inputs?.length
+                ? await resolver.resolve(step.objectTypes.inputs)
+                : resolveSelectorsToRefs(step.objectTypes?.inputs ?? []);
+            const declaredOutputRefs = step.objectTypes?.outputs?.length
+                ? await resolver.resolve(step.objectTypes.outputs)
+                : resolveSelectorsToRefs(step.objectTypes?.outputs ?? []);
+            if (step.apiCalls?.length) {
+                const callResults = [];
+                for (const call of step.apiCalls) {
+                    const url = substitute(call.url, inputs);
+                    const headers = { ...(call.headers ?? {}) };
+                    if (call.auth && inputs[call.auth] != null) {
+                        headers.authorization = `Bearer ${String(inputs[call.auth])}`;
+                    }
+                    const res = await fetchImpl(url, {
+                        method: call.method,
+                        headers,
+                        body: call.bodyTemplate != null
+                            ? JSON.stringify(call.bodyTemplate)
+                            : undefined,
+                        signal: controller.signal,
+                    });
+                    if (res.status >= 400) {
+                        throw new Error(`API ${call.method} ${url} failed with ${res.status}`);
+                    }
+                    callResults.push(res.body);
+                }
+                resultBody = callResults.length === 1 ? callResults[0] : callResults;
+            }
+            if (step.invoke?.serviceType) {
+                const serviceId = step.invoke.serviceId ?? step.serviceId;
+                if (!serviceId)
+                    throw new Error(`invoke.serviceId required for step ${step.id}`);
+                const agentId = typeof run.context?.agentId === "string" ? run.context.agentId : undefined;
+                const inv = await ports.invoker.invoke({
+                    serviceType: step.invoke.serviceType,
+                    serviceId,
+                    agentId,
+                    signal: controller.signal,
+                    timeoutMs,
+                    request: buildInvokeEnvelope({
+                        step,
+                        run,
+                        serviceType: step.invoke.serviceType,
+                        serviceId,
+                        agentId,
+                        inputs,
+                        resultBody,
+                        attempt: attempts,
+                        declaredInputRefs,
+                        declaredOutputRefs,
+                        dependencyOutputs: stepOutputs,
+                    }),
+                });
+                if (inv.status >= 400) {
+                    throw new Error(`Invoke ${step.invoke.serviceType}:${serviceId} failed: ${inv.status}`);
+                }
+                resultBody = inv.body;
+                const interpreted = interpretWorkerResponse(inv.body, step.statusBehavior.partialAllowed);
+                lastWorkerStatus = interpreted.status;
+                if (interpreted.failed) {
+                    throw new Error(interpreted.error ?? "worker failed");
+                }
+            }
+            const outputs = {
+                result: redactSensitive(resultBody),
+                declaredInputRefs,
+                declaredOutputRefs,
+            };
+            let status = "running";
+            const isNormalizerInvoke = step.invoke?.serviceType === "normalizer" || step.serviceType === "normalizer";
+            if (step.rawOutput) {
+                const collection = resolveRawCollection(step) ?? step.rawOutput.collection ?? "pipeline-raw";
+                const raw = await ports.rawStore.save({
+                    collection,
+                    runId: run.runId,
+                    stepId: step.id,
+                    orgId: run.orgId,
+                    data: {
+                        raw: redactSensitive(resultBody),
+                        inputs: redactSensitive(inputs),
+                        metadata: step.rawOutput.includeMetadata
+                            ? { objectType: step.objectType, vendor: step.vendor, serviceType: step.serviceType }
+                            : undefined,
+                    },
+                });
+                outputs.rawId = raw.id;
+                if (raw.ref)
+                    outputs.rawRef = raw.ref;
+                status = "raw_saved";
+            }
+            // Disable inline normalization for normalizer invokes — worker owns map runtime.
+            if (step.normalizedOutput?.enabled && !isNormalizerInvoke) {
+                try {
+                    outputs.normalized = {
+                        type: step.normalizedOutput.outputType,
+                        mapper: step.normalizedOutput.mapper,
+                        data: resultBody,
+                    };
+                    status = "normalized";
+                }
+                catch (err) {
+                    if (step.errorBehavior.onNormalizationError === "save-raw-and-fail-normalization") {
+                        return {
+                            stepRun: {
+                                stepId: step.id,
+                                status: "failed",
+                                attempts,
+                                inputs: redactSensitive(inputs),
+                                outputs,
+                                error: err instanceof Error ? err.message : String(err),
+                                startedAt,
+                                finishedAt: new Date().toISOString(),
+                                workerStatus: lastWorkerStatus,
+                            },
+                            outputs,
+                        };
+                    }
+                    if (step.errorBehavior.onNormalizationError === "skip-normalization") {
+                        status = step.rawOutput ? "raw_saved" : "running";
+                    }
+                    else {
+                        throw err;
+                    }
+                }
+            }
+            else if (isNormalizerInvoke && step.normalizedOutput?.enabled) {
+                outputs.normalizedDeferredToWorker = true;
+                status = "normalized";
+            }
+            let snapshotCollection;
+            if (step.snapshotOutput) {
+                snapshotCollection =
+                    resolveSnapshotsCollection(step) ??
+                        step.snapshotOutput.collection ??
+                        "pipeline-snapshots";
+                const snap = await ports.snapshotStore.save({
+                    collection: snapshotCollection,
+                    runId: run.runId,
+                    stepId: step.id,
+                    orgId: run.orgId,
+                    data: outputs.normalized ?? resultBody,
+                });
+                outputs.snapshotId = snap.id;
+                if (snap.ref)
+                    outputs.snapshotRef = snap.ref;
+                status = "snapshotted";
+            }
+            Object.assign(outputs, extractNamedResultRefs(resultBody, typeof outputs.snapshotId === "string" ? outputs.snapshotId : undefined, snapshotCollection));
+            const partial = lastWorkerStatus === "partial";
+            return {
+                stepRun: {
+                    stepId: step.id,
+                    status: "completed",
+                    attempts,
+                    inputs: redactSensitive(inputs),
+                    outputs: {
+                        ...outputs,
+                        lifecycle: status,
+                        partial: partial || undefined,
+                    },
+                    startedAt,
+                    finishedAt: new Date().toISOString(),
+                    workerStatus: lastWorkerStatus,
+                },
+                outputs,
+            };
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err.message : String(err);
+            if (controller.signal.aborted && options.signal?.aborted) {
+                return {
+                    stepRun: {
+                        stepId: step.id,
+                        status: "failed",
+                        attempts,
+                        error: "cancelled",
+                        startedAt,
+                        finishedAt: new Date().toISOString(),
+                        workerStatus: lastWorkerStatus,
+                    },
+                    outputs: {},
+                };
+            }
+            if (step.errorBehavior.onApiError === "retry" &&
+                attempts <= maxRetries &&
+                step.statusBehavior.retryable) {
+                continue;
+            }
+            if (step.errorBehavior.onApiError === "skip") {
+                return {
+                    stepRun: {
+                        stepId: step.id,
+                        status: "completed",
+                        attempts,
+                        error: lastError,
+                        outputs: { skipped: true },
+                        startedAt,
+                        finishedAt: new Date().toISOString(),
+                        workerStatus: lastWorkerStatus,
+                    },
+                    outputs: {},
+                };
+            }
+            break;
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+            options.signal?.removeEventListener("abort", onAbort);
+        }
+    }
+    return {
+        stepRun: {
+            stepId: step.id,
+            status: "failed",
+            attempts,
+            error: lastError ?? "unknown error",
+            startedAt,
+            finishedAt: new Date().toISOString(),
+            workerStatus: lastWorkerStatus,
+        },
+        outputs: {},
+    };
+}
+//# sourceMappingURL=execute-step.js.map

package/dist/runtime/execute-step.js.map

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

package/dist/runtime/leases.d.ts

@@ -0,0 +1,45 @@
+import type { ExecutionClaim, OperationalStores } from "@x12i/memorix-pipeline-runtime";
+import type { PipelineOrchestratorStore } from "../store/types.js";
+export type LeaseHandle = {
+    claimKey: string;
+    ownerId: string;
+    generation: number;
+    release: () => Promise<void>;
+};
+export type ClaimRunOptions = {
+    operational: OperationalStores;
+    orgId: string;
+    runId: string;
+    ownerId?: string;
+    ttlMs?: number;
+    heartbeatIntervalMs?: number;
+};
+export type ClaimStepOptions = ClaimRunOptions & {
+    stepId: string;
+};
+/** Atomically claim the run-level execution lease. Returns null if another owner holds it. */
+export declare function claimRun(options: ClaimRunOptions): Promise<LeaseHandle | null>;
+/** Atomically claim a step-level execution lease. Returns null if another owner holds it. */
+export declare function claimStep(options: ClaimStepOptions): Promise<LeaseHandle | null>;
+/** Get the current run-level claim record (for visibility/lease endpoint). */
+export declare function getRunClaim(options: {
+    operational: OperationalStores;
+    orgId: string;
+    runId: string;
+}): Promise<ExecutionClaim | null>;
+export type ReconcileResult = {
+    abandoned: string[];
+    checked: number;
+};
+/**
+ * Scan runs that are stuck in running/resuming with no live claim and mark them abandoned.
+ * Intended to be called on orchestrator startup or via POST /runs/:runId/reconcile.
+ */
+export declare function reconcileExpiredClaims(options: {
+    operational: OperationalStores;
+    store: PipelineOrchestratorStore;
+    abandonTtlMs?: number;
+    /** Restrict to a single run if provided. */
+    runId?: string;
+}): Promise<ReconcileResult>;
+//# sourceMappingURL=leases.d.ts.map

package/dist/runtime/leases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leases.d.ts","sourceRoot":"","sources":["../../src/runtime/leases.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAMnE,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,8FAA8F;AAC9F,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAUpF;AAED,6FAA6F;AAC7F,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAUtF;AA2BD,8EAA8E;AAC9E,wBAAsB,WAAW,CAAC,OAAO,EAAE;IACzC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAIjC;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,WAAW,EAAE,iBAAiB,CAAC;IAC/B,KAAK,EAAE,yBAAyB,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,eAAe,CAAC,CAoC3B"}

package/dist/runtime/leases.js

@@ -0,0 +1,84 @@
+import { randomUUID } from "node:crypto";
+const DEFAULT_TTL_MS = 30_000;
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 10_000;
+const DEFAULT_ABANDON_TTL_MS = 5 * 60_000;
+/** Atomically claim the run-level execution lease. Returns null if another owner holds it. */
+export async function claimRun(options) {
+    const { operational, orgId, runId } = options;
+    const ownerId = options.ownerId ?? randomUUID();
+    const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+    const heartbeatIntervalMs = options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;
+    const claim = await operational.claims.claim({ orgId, runId, ownerId, ttlMs });
+    if (!claim)
+        return null;
+    return buildLeaseHandle({ operational, orgId, claim, ttlMs, heartbeatIntervalMs });
+}
+/** Atomically claim a step-level execution lease. Returns null if another owner holds it. */
+export async function claimStep(options) {
+    const { operational, orgId, runId, stepId } = options;
+    const ownerId = options.ownerId ?? randomUUID();
+    const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+    const heartbeatIntervalMs = options.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS;
+    const claim = await operational.claims.claim({ orgId, runId, stepId, ownerId, ttlMs });
+    if (!claim)
+        return null;
+    return buildLeaseHandle({ operational, orgId, claim, ttlMs, heartbeatIntervalMs });
+}
+function buildLeaseHandle(options) {
+    const { operational, orgId, claim, ttlMs, heartbeatIntervalMs } = options;
+    const { claimKey, ownerId, generation } = claim;
+    const timer = setInterval(() => {
+        void operational.claims.heartbeat(orgId, claimKey, ownerId, ttlMs).catch(() => undefined);
+    }, heartbeatIntervalMs);
+    return {
+        claimKey,
+        ownerId,
+        generation,
+        release: async () => {
+            clearInterval(timer);
+            await operational.claims.release(orgId, claimKey, ownerId);
+        },
+    };
+}
+/** Get the current run-level claim record (for visibility/lease endpoint). */
+export async function getRunClaim(options) {
+    const { operational, orgId, runId } = options;
+    const claimKey = `${orgId}:${runId}`;
+    return operational.claims.get(orgId, claimKey);
+}
+/**
+ * Scan runs that are stuck in running/resuming with no live claim and mark them abandoned.
+ * Intended to be called on orchestrator startup or via POST /runs/:runId/reconcile.
+ */
+export async function reconcileExpiredClaims(options) {
+    const { operational, store } = options;
+    const abandonTtlMs = options.abandonTtlMs ?? DEFAULT_ABANDON_TTL_MS;
+    const now = new Date();
+    const abandoned = [];
+    const runs = options.runId
+        ? await store.getRun(options.runId).then((r) => (r ? [r] : []))
+        : await store.listRuns({});
+    for (const run of runs) {
+        if (run.status !== "running" && run.status !== "resuming")
+            continue;
+        const orgId = run.orgId ?? "default";
+        const claimKey = `${orgId}:${run.runId}`;
+        const claim = await operational.claims.get(orgId, claimKey);
+        const claimAlive = claim &&
+            claim.status === "claimed" &&
+            new Date(claim.expiresAt).getTime() > now.getTime();
+        if (!claimAlive) {
+            const runAge = now.getTime() - new Date(run.updatedAt).getTime();
+            if (runAge > abandonTtlMs) {
+                await store.updateRun(run.runId, {
+                    ...run,
+                    status: "abandoned",
+                    updatedAt: now.toISOString(),
+                });
+                abandoned.push(run.runId);
+            }
+        }
+    }
+    return { abandoned, checked: runs.length };
+}
+//# sourceMappingURL=leases.js.map

package/dist/runtime/leases.js.map

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

package/dist/runtime/memory-ports.d.ts

@@ -0,0 +1,21 @@
+import { createMemoryOperationalStores } from "@x12i/memorix-pipeline-runtime";
+import type { OrchestratorRuntimePorts, RawStore, ServiceInvoker, SnapshotStore } from "./ports.js";
+export { createMemoryOperationalStores };
+export declare function createMemoryRawStore(): RawStore;
+export declare function createMemorySnapshotStore(): SnapshotStore;
+/** Invoker that returns a stub success without calling network. */
+export declare function createStubServiceInvoker(handler?: (input: {
+    serviceType: string;
+    serviceId: string;
+    request?: Record<string, unknown>;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}) => Promise<{
+    status: number;
+    body: unknown;
+}> | {
+    status: number;
+    body: unknown;
+}): ServiceInvoker;
+export declare function createMemoryRuntimePorts(overrides?: Partial<OrchestratorRuntimePorts>): OrchestratorRuntimePorts;
+//# sourceMappingURL=memory-ports.d.ts.map

package/dist/runtime/memory-ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-ports.d.ts","sourceRoot":"","sources":["../../src/runtime/memory-ports.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,KAAK,EACV,wBAAwB,EAExB,QAAQ,EACR,cAAc,EAEd,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,6BAA6B,EAAE,CAAC;AAMzC,wBAAgB,oBAAoB,IAAI,QAAQ,CAiC/C;AAED,wBAAgB,yBAAyB,IAAI,aAAa,CAiCzD;AAED,mEAAmE;AACnE,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAK,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACnF,cAAc,CAUhB;AAED,wBAAgB,wBAAwB,CACtC,SAAS,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAC5C,wBAAwB,CAe1B"}