@furystack/redis-task-runner 1.0.0

package/README.md

@@ -0,0 +1,128 @@
+# @furystack/redis-task-runner
+
+Redis Streams adapter for [`@furystack/task-runner`](../task-runner). Backs
+multi-node task execution with persistent, broker-side-reclaimable consumer
+groups. See `docs/internal/distributed-task-management.md` Milestone 3 for
+the full design.
+
+## Installation
+
+```bash
+npm install @furystack/redis-task-runner
+# or
+yarn add @furystack/redis-task-runner
+```
+
+## Usage
+
+The caller owns the `redis` client lifecycle (`connect` / `quit`) — same as
+[`@furystack/redis-cross-node-bus`](../redis-cross-node-bus) and
+[`@furystack/redis-store`](../redis-store).
+
+```ts
+import { S3Client } from '@aws-sdk/client-s3'
+import { createInjector } from '@furystack/inject'
+import { BlobStore } from '@furystack/blob-store'
+import { CrossNodeBus } from '@furystack/cross-node-bus'
+import { defineRedisCrossNodeBusAdapter } from '@furystack/redis-cross-node-bus'
+import { defineS3BlobStore } from '@furystack/s3-blob-store'
+import { TaskRunner } from '@furystack/task-runner'
+import { defineRedisTaskRunner } from '@furystack/redis-task-runner'
+import { createClient } from 'redis'
+
+const client = createClient({ url: process.env.REDIS_URL })
+await client.connect()
+
+const s3Client = new S3Client({ region: process.env.AWS_REGION })
+
+await using injector = createInjector()
+injector.bind(CrossNodeBus, defineRedisCrossNodeBusAdapter({ client, serviceName: 'svc-a' }))
+injector.bind(BlobStore, defineS3BlobStore({ client: s3Client, bucket: 'svc-a-blobs' }))
+injector.bind(
+  TaskRunner,
+  defineRedisTaskRunner({
+    client,
+    serviceName: 'svc-a',
+    topicPrefix: 'svc-a/',
+    visibilityTimeoutMs: 60_000,
+  }),
+)
+
+const runner = injector.get(TaskRunner)
+
+// shutdown
+await injector[Symbol.asyncDispose]()
+await client.quit()
+```
+
+## Stream layout
+
+| Key                                               | Purpose                                                                       |
+| ------------------------------------------------- | ----------------------------------------------------------------------------- |
+| `${prefix}tasks:queue:${type}:v${handlerVersion}` | One stream per `(type, version)` lane. XADD on enqueue.                       |
+| `${prefix}tasks:idem:${type}:${idempotencyKey}`   | `SET NX EX` idempotency-lease key.                                            |
+| `${prefix}tasks:scheduler`                        | Single ZSET parking delayed tasks until their `notBefore` (members are JSON). |
+
+A single consumer group named `runner` (override via `consumerGroup`) joins
+every lane. Each registered worker spawns `concurrency` slots; slot consumers
+are named `${workerId}-slot-${index}`.
+
+## Capabilities
+
+| Capability            | Value  | Notes                                                                                                                                                     |
+| --------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `persistent`          | `true` | Streams survive broker restarts (configure broker durability separately).                                                                                 |
+| `distributed`         | `true` | Consumer-group competing-consumer dispatch across nodes.                                                                                                  |
+| `delayedDispatch`     | `true` | Scheduler ZSET + Lua atomic-pop dispatcher; `notBefore` honored at the broker.                                                                            |
+| `fleetCapEnforcement` | `true` | Per-type ZSET holder tokens (scored by expiry); a claim that finds its lane full is released back to the stream and retried, so the cap holds fleet-wide. |
+| `brokerSideReclaim`   | `true` | `XAUTOCLAIM` recovers stale PEL entries past the visibility timeout.                                                                                      |
+
+## Delayed dispatch
+
+Tasks submitted with a future `notBefore` are parked in a single global
+`${prefix}tasks:scheduler` ZSET (member = JSON `{taskId, type, handlerVersion}`,
+score = epoch ms). Every adapter instance ticks a 250 ms scheduler that
+evaluates a short Lua script atomically popping due entries and
+`XADD`ing them onto the matching `(type, version)` stream. Lua atomicity
+(the `ZREM` inside the script) prevents two adapter instances from
+double-dispatching the same delayed task.
+
+Tune the tick rate via `schedulerIntervalMs` — lower = lower delay
+jitter at the cost of broker chatter; higher = looser floor on
+`notBefore` precision.
+
+## Visibility & reclaim
+
+Each slot iteration runs `XAUTOCLAIM` first (idle threshold = the
+type-specific `visibilityTimeoutMs`); reclaimed entries are delivered through
+the same `onClaim` path as fresh ones. The runner core marks the prior
+in-progress attempt as `'timed-out'` before starting a fresh attempt — handlers
+that observe `ctx.attempt > 1` see the same payload as attempt 1 (replay log
+keyed by `(taskId, stepIndex)` dedups recorded steps).
+
+`heartbeat()` resets the broker-side idle counter via `XCLAIM JUSTID`. Hot-lane
+progress reports (`ctx.reportProgress`) implicitly heartbeat via the runner
+core's coalesced dataset write — handlers reporting progress regularly stay
+under the visibility threshold automatically.
+
+## Constructor options
+
+| Option                    | Type     | Default    | Notes                                                 |
+| ------------------------- | -------- | ---------- | ----------------------------------------------------- |
+| `client`                  | required | —          | Caller-owned `redis` client. Must be connected.       |
+| `serviceName`             | required | —          | Telemetry attribution.                                |
+| `topicPrefix`             | optional | `''`       | Wire prefix for every stream / lease / scheduler key. |
+| `consumerGroup`           | optional | `'runner'` | Group name. Override only when sharing a broker.      |
+| `visibilityTimeoutMs`     | optional | `60_000`   | Default reclaim threshold per task lane.              |
+| `visibilityTimeoutByType` | optional | `{}`       | Per-type override (`{ 'video-encode': 600_000 }`).    |
+| `blockTimeoutMs`          | optional | `200`      | `XREADGROUP BLOCK` timeout.                           |
+| `retryBackoffMs`          | optional | `250`      | Backoff between reads after broker errors.            |
+| `idempotencyTtlSec`       | optional | `86_400`   | `SET NX EX` lease TTL.                                |
+| `schedulerIntervalMs`     | optional | `250`      | Delayed-dispatch scheduler tick interval.             |
+
+## Integration tests
+
+`src/redis-task-runner.integration.spec.ts` exercises submit/claim/complete,
+two-worker no-double-execute, broker-side reclaim, draft/start two-phase,
+and cancel-broadcast against a real broker reachable at `REDIS_URL`
+(default `redis://localhost:6379`). CI brings it up via `docker compose up -d`.

package/esm/cross-process-smoke.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cross-process-smoke.spec.d.ts.map

package/esm/cross-process-smoke.spec.d.ts.map

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

package/esm/cross-process-smoke.spec.js

@@ -0,0 +1,463 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+/**
+ * Cross-process multi-worker smoke (PRD F2 / Milestone 6 precursor).
+ *
+ * Forks real OS worker processes (`child_process.fork`) that each host their
+ * own injector, Redis client and `RedisTaskRunner`, sharing one broker. The
+ * Task + TaskReplayLog datasets are bound to `@furystack/redis-store` so task
+ * state is coherent across processes (this is what F1 + F1b unblocked — the
+ * runner cannot use an in-memory store cross-process). The cross-node bus is
+ * in-process per child: the scenarios below (claim concurrency, fleet cap,
+ * visibility reclaim, drain) are all broker- or worker-local and need no
+ * cross-process bus delivery.
+ *
+ * Scenarios:
+ *
+ * 1. **Claim concurrency / no double-execute** — two worker processes drain a
+ *    batch of tasks; every task runs exactly once across the fleet.
+ * 2. **Fleet cap** — `concurrencyLimits` holds the max-concurrent count for a
+ *    type across both processes (measured via a shared Redis counter).
+ * 3. **Visibility reclaim** — a worker is `SIGKILL`ed mid-handler; a second
+ *    worker reclaims the stalled claim (`XAUTOCLAIM`) and completes it.
+ * 4. **Graceful drain** — a worker drains mid-flight: the in-flight task
+ *    finishes and no further task is claimed.
+ *
+ * **Build prereq.** Children execute the compiled `esm/*.js`, so the package
+ * must be built before this runs. CI runs `yarn build` before `yarn test`;
+ * a local isolated run needs `yarn workspace @furystack/redis-task-runner build`
+ * first.
+ *
+ * **Redis prereq.** Broker reachable at `REDIS_URL` (default
+ * `redis://localhost:6379`); CI brings it up via `docker compose up -d`.
+ */
+import { fork } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { BlobStore, InMemoryBlobStore } from '@furystack/blob-store';
+import { CrossNodeBus, defineInProcessCrossNodeBus } from '@furystack/cross-node-bus';
+import { createInjector } from '@furystack/inject';
+import { RedisStore } from '@furystack/redis-store';
+import { defineTaskHandler, isTerminalStatus, Task, TaskReplayLogEntry, TaskReplayLogStore, TaskRunner, TaskStore, } from '@furystack/task-runner';
+import { defineRedisTaskRunner } from './define-redis-task-runner.js';
+import { createClient } from 'redis';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+const REDIS_URL = process.env.REDIS_URL ?? 'redis://localhost:6379';
+const CHILD_CONFIG_ENV = 'CHILD_CONFIG';
+/** Tracks the max concurrent value seen in `KEYS[1]` against the live count. */
+const MAX_SCRIPT = `
+local m = tonumber(redis.call('GET', KEYS[1]) or '0')
+local v = tonumber(ARGV[1])
+if v > m then redis.call('SET', KEYS[1], v) end
+return v
+`;
+const sleep = (ms) => new Promise((resolveSleep) => setTimeout(resolveSleep, ms));
+const evalScript = (client, script, keys, args) => {
+    const evalFn = client.eval;
+    return evalFn.call(client, script, { keys, arguments: args });
+};
+/**
+ * Handlers shared by every worker. Each records progress in shared Redis keys
+ * (under the `${storePrefix}c:` namespace) so the parent can assert behavior
+ * across processes.
+ */
+const buildHandlers = (client, ns) => {
+    const echo = defineTaskHandler({
+        type: 'echo',
+        version: 1,
+        handler: async (ctx) => {
+            await client.incr(`${ns}exec:${ctx.taskId}`);
+            return { ok: true };
+        },
+    });
+    const capped = defineTaskHandler({
+        type: 'capped',
+        version: 1,
+        handler: async () => {
+            const live = await client.incr(`${ns}live`);
+            await evalScript(client, MAX_SCRIPT, [`${ns}max`], [String(live)]);
+            await sleep(300);
+            await client.decr(`${ns}live`);
+        },
+    });
+    const reclaim = defineTaskHandler({
+        type: 'reclaim',
+        version: 1,
+        retryPolicy: { maxAttempts: 1, backoff: 'none', baseDelayMs: 0, jitter: 0 },
+        handler: async () => {
+            await client.incr(`${ns}reclaim:starts`);
+            await sleep(5000);
+            await client.incr(`${ns}reclaim:finishes`);
+        },
+    });
+    const drainable = defineTaskHandler({
+        type: 'drain',
+        version: 1,
+        handler: async () => {
+            await client.incr(`${ns}drain:started`);
+            await sleep(700);
+            await client.incr(`${ns}drain:done`);
+        },
+    });
+    return [echo, capped, reclaim, drainable];
+};
+const bindRuntime = (injector, client, config) => {
+    injector.bind(BlobStore, ({ onDispose }) => {
+        const store = new InMemoryBlobStore({ name: `${config.id}-blobs` });
+        // eslint-disable-next-line furystack/prefer-using-wrapper -- delegated to onDispose
+        onDispose(() => store[Symbol.dispose]());
+        return store;
+    });
+    injector.bind(CrossNodeBus, defineInProcessCrossNodeBus());
+    // `as PhysicalStore` bridges the method-param variance gap between
+    // `RedisStore`'s `TWriteableData` (id required) and the StoreToken's
+    // `WithOptionalId` — the same shape `defineStore` accepts via bivariance.
+    injector.bind(TaskStore, () => new RedisStore({ model: Task, primaryKey: 'id', client, keyPrefix: `${config.storePrefix}t` }));
+    injector.bind(TaskReplayLogStore, () => new RedisStore({
+        model: TaskReplayLogEntry,
+        primaryKey: 'id',
+        client,
+        keyPrefix: `${config.storePrefix}r`,
+    }));
+    injector.bind(TaskRunner, defineRedisTaskRunner({
+        client,
+        serviceName: config.id,
+        topicPrefix: config.topicPrefix,
+        visibilityTimeoutMs: config.visibilityMs,
+        blockTimeoutMs: 50,
+        retryBackoffMs: 50,
+        schedulerIntervalMs: 50,
+        reconcilerIntervalMs: 1_000_000,
+        concurrencyLimits: config.capLimit !== undefined ? { capped: config.capLimit } : undefined,
+    }));
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Child worker process.
+// ─────────────────────────────────────────────────────────────────────────────
+const runChild = async (config) => {
+    const send = (message) => {
+        process.send?.(message);
+    };
+    const client = createClient({ url: REDIS_URL });
+    await client.connect();
+    const injector = createInjector();
+    bindRuntime(injector, client, config);
+    const runner = injector.get(TaskRunner);
+    const worker = runner.registerWorker({
+        name: config.id,
+        handlers: buildHandlers(client, `${config.storePrefix}c:`),
+        concurrency: config.concurrency,
+        tags: [],
+        compatibleVersions: {},
+    });
+    process.on('message', (message) => {
+        void (async () => {
+            if (message.kind === 'drain') {
+                await worker.drain({ timeoutMs: 5000 });
+                send({ kind: 'drained', id: config.id });
+            }
+            else {
+                worker[Symbol.dispose]();
+                await injector[Symbol.asyncDispose]();
+                if (client.isOpen)
+                    await client.quit();
+                process.exit(0);
+            }
+        })().catch((error) => send({ kind: 'log', line: `${config.id} crashed: ${String(error)}` }));
+    });
+    send({ kind: 'ready', id: config.id });
+};
+const isChildMode = process.argv[2] === 'child';
+if (isChildMode) {
+    const raw = process.env[CHILD_CONFIG_ENV];
+    if (!raw) {
+        process.stderr.write('cross-process-smoke child requires CHILD_CONFIG\n');
+        process.exit(1);
+    }
+    else {
+        runChild(JSON.parse(raw)).catch((error) => {
+            process.stderr.write(`child crashed: ${error.stack ?? String(error)}\n`);
+            process.exit(1);
+        });
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Parent / vitest side.
+// ─────────────────────────────────────────────────────────────────────────────
+const COMPILED_SPEC_PATH = resolve(dirname(fileURLToPath(import.meta.url)), '..', 'esm', 'cross-process-smoke.spec.js');
+const forkWorker = (config) => {
+    const inbox = [];
+    const listeners = new Set();
+    const child = fork(COMPILED_SPEC_PATH, ['child', config.id], {
+        env: { ...process.env, [CHILD_CONFIG_ENV]: JSON.stringify(config) },
+    });
+    child.on('message', (message) => {
+        const typed = message;
+        inbox.push(typed);
+        for (const listener of listeners)
+            listener(typed);
+    });
+    const receive = (predicate, timeoutMs = 8000) => {
+        const matched = inbox.find(predicate);
+        if (matched)
+            return Promise.resolve(matched);
+        return new Promise((resolveReceive, reject) => {
+            const timer = setTimeout(() => {
+                listeners.delete(handler);
+                reject(new Error(`Timed out after ${timeoutMs}ms waiting on ${config.id}`));
+            }, timeoutMs);
+            const handler = (message) => {
+                if (predicate(message)) {
+                    clearTimeout(timer);
+                    listeners.delete(handler);
+                    resolveReceive(message);
+                }
+            };
+            listeners.add(handler);
+        });
+    };
+    return { id: config.id, child, receive };
+};
+const shutdownWorker = async (worker) => {
+    if (worker.child.exitCode !== null || worker.child.signalCode !== null)
+        return;
+    worker.child.send({ kind: 'shutdown' });
+    await new Promise((resolveExit) => {
+        if (worker.child.exitCode !== null)
+            resolveExit();
+        else
+            worker.child.once('exit', () => resolveExit());
+    });
+};
+const buildParent = async (topicPrefix, storePrefix) => {
+    const client = createClient({ url: REDIS_URL });
+    await client.connect();
+    const injector = createInjector();
+    bindRuntime(injector, client, { id: 'parent', topicPrefix, storePrefix, visibilityMs: 60_000 });
+    const runner = injector.get(TaskRunner);
+    return {
+        runner,
+        client,
+        [Symbol.asyncDispose]: async () => {
+            await injector[Symbol.asyncDispose]();
+            if (client.isOpen)
+                await client.quit();
+        },
+    };
+};
+const waitFor = async (predicate, timeoutMs) => {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (await predicate())
+            return;
+        await sleep(75);
+    }
+    throw new Error(`waitFor: timed out after ${timeoutMs}ms`);
+};
+const pollStatus = async (parent, taskId, timeoutMs) => {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const task = await parent.runner.get(taskId);
+        if (task && isTerminalStatus(task.status))
+            return task.status;
+        await sleep(100);
+    }
+    return (await parent.runner.get(taskId))?.status;
+};
+const num = (value) => (value ? Number(value) : 0);
+if (!isChildMode) {
+    describe('cross-process smoke (PRD F2)', () => {
+        let topicPrefix;
+        let storePrefix;
+        let active = [];
+        const fork_ = (config) => {
+            const worker = forkWorker({ ...config, topicPrefix, storePrefix });
+            active.push(worker);
+            return worker;
+        };
+        const awaitReady = async (...workers) => {
+            await Promise.all(workers.map((worker) => worker.receive((message) => message.kind === 'ready')));
+        };
+        beforeEach(() => {
+            topicPrefix = `xp-${randomUUID().slice(0, 8)}/`;
+            storePrefix = `xps-${randomUUID().slice(0, 8)}/`;
+            active = [];
+        });
+        afterEach(async () => {
+            await Promise.all(active.map(shutdownWorker));
+            active = [];
+            const client = createClient({ url: REDIS_URL });
+            try {
+                await client.connect();
+                for (const prefix of [topicPrefix, storePrefix]) {
+                    const keys = await client.keys(`${prefix}*`);
+                    if (keys.length > 0)
+                        await client.del(keys);
+                }
+            }
+            catch {
+                // Redis unreachable — the test bodies already failed loudly.
+            }
+            finally {
+                if (client.isOpen)
+                    await client.quit();
+            }
+        }, 15_000);
+        it('runs each task exactly once across two worker processes', async () => {
+            const env_1 = { stack: [], error: void 0, hasError: false };
+            try {
+                const parent = __addDisposableResource(env_1, await buildParent(topicPrefix, storePrefix), true);
+                const w1 = fork_({ id: 'w1', concurrency: 2, visibilityMs: 60_000 });
+                const w2 = fork_({ id: 'w2', concurrency: 2, visibilityMs: 60_000 });
+                await awaitReady(w1, w2);
+                const tasks = await Promise.all(Array.from({ length: 8 }, () => parent.runner.submit({ type: 'echo', payload: {}, handlerVersion: 1 })));
+                for (const task of tasks) {
+                    expect(await pollStatus(parent, task.id, 15_000)).toBe('succeeded');
+                }
+                for (const task of tasks) {
+                    expect(num(await parent.client.get(`${storePrefix}c:exec:${task.id}`))).toBe(1);
+                }
+            }
+            catch (e_1) {
+                env_1.error = e_1;
+                env_1.hasError = true;
+            }
+            finally {
+                const result_1 = __disposeResources(env_1);
+                if (result_1)
+                    await result_1;
+            }
+        }, 40_000);
+        it('enforces a fleet-wide concurrency cap across two worker processes', async () => {
+            const env_2 = { stack: [], error: void 0, hasError: false };
+            try {
+                const parent = __addDisposableResource(env_2, await buildParent(topicPrefix, storePrefix), true);
+                const w1 = fork_({ id: 'w1', concurrency: 2, visibilityMs: 60_000, capLimit: 2 });
+                const w2 = fork_({ id: 'w2', concurrency: 2, visibilityMs: 60_000, capLimit: 2 });
+                await awaitReady(w1, w2);
+                const tasks = await Promise.all(Array.from({ length: 6 }, () => parent.runner.submit({ type: 'capped', payload: {}, handlerVersion: 1 })));
+                for (const task of tasks) {
+                    expect(await pollStatus(parent, task.id, 20_000)).toBe('succeeded');
+                }
+                const maxConcurrent = num(await parent.client.get(`${storePrefix}c:max`));
+                expect(maxConcurrent).toBeLessThanOrEqual(2);
+                expect(maxConcurrent).toBe(2);
+            }
+            catch (e_2) {
+                env_2.error = e_2;
+                env_2.hasError = true;
+            }
+            finally {
+                const result_2 = __disposeResources(env_2);
+                if (result_2)
+                    await result_2;
+            }
+        }, 40_000);
+        it('reclaims a task after the owning worker process is killed', async () => {
+            const env_3 = { stack: [], error: void 0, hasError: false };
+            try {
+                const parent = __addDisposableResource(env_3, await buildParent(topicPrefix, storePrefix), true);
+                const victim = fork_({ id: 'victim', concurrency: 1, visibilityMs: 1000 });
+                await awaitReady(victim);
+                const task = await parent.runner.submit({ type: 'reclaim', payload: {}, handlerVersion: 1 });
+                await waitFor(async () => num(await parent.client.get(`${storePrefix}c:reclaim:starts`)) >= 1, 10_000);
+                // Hard-kill the worker mid-handler; its claim goes stale in the PEL.
+                victim.child.kill('SIGKILL');
+                const survivor = fork_({ id: 'survivor', concurrency: 1, visibilityMs: 1000 });
+                await awaitReady(survivor);
+                expect(await pollStatus(parent, task.id, 25_000)).toBe('succeeded');
+                expect(num(await parent.client.get(`${storePrefix}c:reclaim:finishes`))).toBeGreaterThanOrEqual(1);
+            }
+            catch (e_3) {
+                env_3.error = e_3;
+                env_3.hasError = true;
+            }
+            finally {
+                const result_3 = __disposeResources(env_3);
+                if (result_3)
+                    await result_3;
+            }
+        }, 45_000);
+        it('drains a worker process: in-flight task finishes, no new task is claimed', async () => {
+            const env_4 = { stack: [], error: void 0, hasError: false };
+            try {
+                const parent = __addDisposableResource(env_4, await buildParent(topicPrefix, storePrefix), true);
+                const worker = fork_({ id: 'w1', concurrency: 1, visibilityMs: 60_000 });
+                await awaitReady(worker);
+                const inFlight = await parent.runner.submit({ type: 'drain', payload: {}, handlerVersion: 1 });
+                await waitFor(async () => num(await parent.client.get(`${storePrefix}c:drain:started`)) >= 1, 10_000);
+                worker.child.send({ kind: 'drain' });
+                const queued = await parent.runner.submit({ type: 'drain', payload: {}, handlerVersion: 1 });
+                await worker.receive((message) => message.kind === 'drained', 10_000);
+                // The in-flight task completed despite the drain.
+                expect((await parent.runner.get(inFlight.id))?.status).toBe('succeeded');
+                expect(num(await parent.client.get(`${storePrefix}c:drain:done`))).toBe(1);
+                // The second task was never claimed by the drained worker.
+                await sleep(500);
+                expect((await parent.runner.get(queued.id))?.status).toBe('pending');
+                expect(num(await parent.client.get(`${storePrefix}c:drain:started`))).toBe(1);
+            }
+            catch (e_4) {
+                env_4.error = e_4;
+                env_4.hasError = true;
+            }
+            finally {
+                const result_4 = __disposeResources(env_4);
+                if (result_4)
+                    await result_4;
+            }
+        }, 40_000);
+    });
+}
+//# sourceMappingURL=cross-process-smoke.spec.js.map

package/esm/cross-process-smoke.spec.js.map

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

package/esm/define-redis-task-runner.d.ts

@@ -0,0 +1,38 @@
+import type { ServiceFactory } from '@furystack/inject';
+import { type TaskRunner } from '@furystack/task-runner';
+import type { RedisQueueAdapterOptions } from './redis-queue-adapter.js';
+import { type RedisTaskRunnerOptions } from './redis-task-runner.js';
+/**
+ * Options accepted by {@link defineRedisTaskRunner}. `client` and
+ * `serviceName` are required; the remaining knobs forward to
+ * {@link RedisQueueAdapterOptions}.
+ */
+export type DefineRedisTaskRunnerOptions = Omit<RedisQueueAdapterOptions, 'client' | 'serviceName'> & {
+    client: RedisQueueAdapterOptions['client'];
+    serviceName: string;
+} & RedisTaskRunnerOptions;
+/**
+ * Returns a {@link ServiceFactory} for {@link TaskRunner}, backed by
+ * Redis Streams. Override the (intentionally throwing) default
+ * binding at boot:
+ *
+ * ```ts
+ * const client = createClient({ url: process.env.REDIS_URL })
+ * await client.connect()
+ *
+ * injector.bind(
+ *   TaskRunner,
+ *   defineRedisTaskRunner({
+ *     client,
+ *     serviceName: 'svc-a',
+ *     topicPrefix: 'svc-a/',
+ *     visibilityTimeoutMs: 60_000,
+ *   }),
+ * )
+ * ```
+ *
+ * Caller still owns `client.connect()` / `client.quit()` —
+ * the adapter never closes it.
+ */
+export declare const defineRedisTaskRunner: (options: DefineRedisTaskRunnerOptions) => ServiceFactory<TaskRunner>;
+//# sourceMappingURL=define-redis-task-runner.d.ts.map