@qjp88995/agent-runtime-redis 0.1.0 → 0.2.0

package/dist/coordination.d.ts

@@ -1,21 +1,31 @@
 import type { Redis } from 'ioredis';
-import { type LoggerFactory, type SessionLock, type SubagentAwaitLease, type TreeBudget, type WakeChannel } from '@qjp88995/agent-runtime';
+import { type LoggerFactory, type SessionLock, type SubagentAwaitLease, type TaskLease, type TaskSignals, type TreeBudget, type WakeChannel } from '@qjp88995/agent-runtime';
 import { type RedisKeyOptions } from './keys.js';
 export interface RedisSessionLockOptions extends RedisKeyOptions {
     /** 缺省 `LOCK_TTL_MS`（60s）。 */
     ttlMs?: number;
 }
-/** SET NX PX 抢锁，Lua 比对 token 再 DEL / PEXPIRE。TTL 兜底持有者崩溃。 */
+/** 会话锁。TTL 兜底持有者崩溃。 */
 export declare class RedisSessionLock implements SessionLock {
-    private readonly redis;
-    private readonly keys;
-    private readonly ttlMs;
+    private readonly lock;
     constructor(redis: Redis, options?: RedisSessionLockOptions);
     acquire(sessionId: string): Promise<string | null>;
     renew(sessionId: string, token: string): Promise<boolean>;
     release(sessionId: string, token: string): Promise<void>;
     isHeld(sessionId: string): Promise<boolean>;
 }
+export interface RedisTaskLeaseOptions extends RedisKeyOptions {
+    /** 缺省 `LOCK_TTL_MS`（60s）。监视器每段等待（runtime 缺省 20s）之后续一次。 */
+    ttlMs?: number;
+}
+/** 任务监视租约：与会话锁同一套写法，键 `agent-task:lease:<taskId>`。 */
+export declare class RedisTaskLease implements TaskLease {
+    private readonly lock;
+    constructor(redis: Redis, options?: RedisTaskLeaseOptions);
+    acquire(taskId: string): Promise<string | null>;
+    renew(taskId: string, token: string): Promise<boolean>;
+    release(taskId: string, token: string): Promise<void>;
+}
 export interface RedisWakeChannelOptions extends RedisKeyOptions {
     /**
      * 订阅用的连接。缺省 `redis.duplicate()`，由本对象负责关闭；宿主自己给的不关。
@@ -54,6 +64,32 @@ export declare class RedisWakeChannel implements WakeChannel {
     /** 摘掉所有处理函数；订阅连接是本对象建的就关掉。 */
     dispose(): Promise<void>;
 }
+export interface RedisTaskSignalsOptions extends RedisKeyOptions {
+    /** 订阅用的连接。缺省 `redis.duplicate()`，由本对象负责关闭；宿主自己给的不关。 */
+    subscriber?: Redis;
+    logger?: LoggerFactory;
+}
+/**
+ * 「任务转后台」广播走 Redis pub/sub，载荷就是任务 id。与 `RedisWakeChannel` 同样用
+ * `create()` 等 SUBSCRIBE 应答回来才返回。广播丢了不要紧：前台等待方每段等待之后都回看任务行
+ * 的 `background`，信号只是让它不必等满这一段。
+ */
+export declare class RedisTaskSignals implements TaskSignals {
+    private readonly redis;
+    private readonly sub;
+    private readonly ownsSub;
+    private readonly channel;
+    private readonly logger;
+    private readonly handlers;
+    private disposed;
+    private constructor();
+    static create(redis: Redis, options?: RedisTaskSignalsOptions): Promise<RedisTaskSignals>;
+    private dispatch;
+    background(taskId: string): Promise<void>;
+    onBackground(handler: Handler): () => void;
+    /** 摘掉处理函数；订阅连接是本对象建的就关掉，否则只退订本频道。 */
+    dispose(): Promise<void>;
+}
 export interface RedisSubagentAwaitLeaseOptions extends RedisKeyOptions {
     /** 缺省 `AWAIT_LEASE_TTL_MS`（60s）。 */
     ttlMs?: number;

package/dist/coordination.d.ts.map

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

package/dist/coordination.js

@@ -2,41 +2,76 @@ import { randomUUID } from 'node:crypto';
 import { AWAIT_LEASE_TTL_MS, consoleLogger, LOCK_TTL_MS, } from '@qjp88995/agent-runtime';
 import { redisKeys } from './keys.js';
 /**
- * 会话锁、唤醒 / 空闲广播、子 Agent 等待租约、树级名额的 Redis 实现。
+ * 会话锁、唤醒 / 空闲广播、子 Agent 等待租约、树级名额、任务监视租约与转后台广播的 Redis 实现。
  * 搬自 agent-base `agent-core/loop/{session-lock,session-wake}.service.ts`、`session-idle.ts`、
  * `agent-core/subagent/{subagent-await,tree-budget}.service.ts`，语义见 runtime 的 `ports/coordination`。
  *
- * 锁 / 租约 / 名额都直接用宿主给的共享连接（全是非阻塞的常规命令），只有唤醒频道要一条
- * 独立的订阅连接（进了 subscribe 模式的连接不能再发普通命令）。
+ * 锁 / 租约 / 名额都直接用宿主给的共享连接（全是非阻塞的常规命令），只有唤醒频道与转后台广播
+ * 各要一条独立的订阅连接（进了 subscribe 模式的连接不能再发普通命令）。
  */
 /** DEL 前比对 token，避免误删「TTL 过期后被别人重新抢到」的锁。 */
 const RELEASE_LUA = "if redis.call('get', KEYS[1]) == ARGV[1] then return redis.call('del', KEYS[1]) else return 0 end";
 /** PEXPIRE 前比对 token，只续自己的锁。 */
 const RENEW_LUA = "if redis.call('get', KEYS[1]) == ARGV[1] then return redis.call('pexpire', KEYS[1], ARGV[2]) else return 0 end";
-/** SET NX PX 抢锁，Lua 比对 token 再 DEL / PEXPIRE。TTL 兜底持有者崩溃。 */
-export class RedisSessionLock {
+/** SET NX PX 抢，Lua 比对 token 再 DEL / PEXPIRE。会话锁与任务租约共用，只是键空间不同。 */
+class RedisTokenLock {
     redis;
-    keys;
+    keyOf;
     ttlMs;
-    constructor(redis, options = {}) {
+    constructor(redis, keyOf, ttlMs) {
         this.redis = redis;
-        this.keys = redisKeys(options);
-        this.ttlMs = options.ttlMs ?? LOCK_TTL_MS;
+        this.keyOf = keyOf;
+        this.ttlMs = ttlMs;
     }
-    async acquire(sessionId) {
+    async acquire(id) {
         const token = randomUUID();
-        const res = await this.redis.set(this.keys.lock(sessionId), token, 'PX', this.ttlMs, 'NX');
+        const res = await this.redis.set(this.keyOf(id), token, 'PX', this.ttlMs, 'NX');
         return res === 'OK' ? token : null;
     }
-    async renew(sessionId, token) {
-        const res = await this.redis.eval(RENEW_LUA, 1, this.keys.lock(sessionId), token, String(this.ttlMs));
+    async renew(id, token) {
+        const res = await this.redis.eval(RENEW_LUA, 1, this.keyOf(id), token, String(this.ttlMs));
         return res === 1;
     }
-    async release(sessionId, token) {
-        await this.redis.eval(RELEASE_LUA, 1, this.keys.lock(sessionId), token);
+    async release(id, token) {
+        await this.redis.eval(RELEASE_LUA, 1, this.keyOf(id), token);
     }
-    async isHeld(sessionId) {
-        return (await this.redis.exists(this.keys.lock(sessionId))) === 1;
+    async isHeld(id) {
+        return (await this.redis.exists(this.keyOf(id))) === 1;
+    }
+}
+/** 会话锁。TTL 兜底持有者崩溃。 */
+export class RedisSessionLock {
+    lock;
+    constructor(redis, options = {}) {
+        this.lock = new RedisTokenLock(redis, redisKeys(options).lock, options.ttlMs ?? LOCK_TTL_MS);
+    }
+    acquire(sessionId) {
+        return this.lock.acquire(sessionId);
+    }
+    renew(sessionId, token) {
+        return this.lock.renew(sessionId, token);
+    }
+    release(sessionId, token) {
+        return this.lock.release(sessionId, token);
+    }
+    isHeld(sessionId) {
+        return this.lock.isHeld(sessionId);
+    }
+}
+/** 任务监视租约：与会话锁同一套写法，键 `agent-task:lease:<taskId>`。 */
+export class RedisTaskLease {
+    lock;
+    constructor(redis, options = {}) {
+        this.lock = new RedisTokenLock(redis, redisKeys(options).taskLease, options.ttlMs ?? LOCK_TTL_MS);
+    }
+    acquire(taskId) {
+        return this.lock.acquire(taskId);
+    }
+    renew(taskId, token) {
+        return this.lock.renew(taskId, token);
+    }
+    release(taskId, token) {
+        return this.lock.release(taskId, token);
     }
 }
 /**
@@ -132,6 +167,65 @@ export class RedisWakeChannel {
         }
     }
 }
+/**
+ * 「任务转后台」广播走 Redis pub/sub，载荷就是任务 id。与 `RedisWakeChannel` 同样用
+ * `create()` 等 SUBSCRIBE 应答回来才返回。广播丢了不要紧：前台等待方每段等待之后都回看任务行
+ * 的 `background`，信号只是让它不必等满这一段。
+ */
+export class RedisTaskSignals {
+    redis;
+    sub;
+    ownsSub;
+    channel;
+    logger;
+    handlers = new Set();
+    disposed = false;
+    constructor(redis, sub, ownsSub, channel, logger) {
+        this.redis = redis;
+        this.sub = sub;
+        this.ownsSub = ownsSub;
+        this.channel = channel;
+        this.logger = logger;
+    }
+    static async create(redis, options = {}) {
+        const sub = options.subscriber ?? redis.duplicate();
+        const signals = new RedisTaskSignals(redis, sub, !options.subscriber, redisKeys(options).taskBackgroundChannel, (options.logger ?? consoleLogger)('RedisTaskSignals'));
+        sub.on('message', (ch, taskId) => {
+            if (ch === signals.channel)
+                signals.dispatch(taskId);
+        });
+        await sub.subscribe(signals.channel);
+        return signals;
+    }
+    dispatch(taskId) {
+        for (const handler of [...this.handlers]) {
+            try {
+                handler(taskId);
+            }
+            catch (err) {
+                this.logger.error(`background handler failed for ${taskId}: ${String(err)}`, err instanceof Error ? err.stack : undefined);
+            }
+        }
+    }
+    async background(taskId) {
+        await this.redis.publish(this.channel, taskId);
+    }
+    onBackground(handler) {
+        this.handlers.add(handler);
+        return () => this.handlers.delete(handler);
+    }
+    /** 摘掉处理函数；订阅连接是本对象建的就关掉，否则只退订本频道。 */
+    async dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.handlers.clear();
+        if (this.ownsSub)
+            await this.sub.quit().catch(() => undefined);
+        else
+            await this.sub.unsubscribe(this.channel).catch(() => undefined);
+    }
+}
 /**
  * 等待租约：一个带 TTL 的键。`claim` 是一条原子 DEL，父与 finalizer 抢同一条，恰有一方胜出。
  * Redis 出错时按端口约定一律退化成异步（见各方法）。

package/dist/coordination.js.map

@@ -1 +1 @@
-{"version":3,"file":"coordination.js","sourceRoot":"","sources":["../src/coordination.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,WAAW,GAOZ,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAwC,SAAS,EAAE,MAAM,WAAW,CAAC;AAE5E;;;;;;;GAOG;AAEH,4CAA4C;AAC5C,MAAM,WAAW,GACf,mGAAmG,CAAC;AACtG,gCAAgC;AAChC,MAAM,SAAS,GACb,gHAAgH,CAAC;AAOnH,6DAA6D;AAC7D,MAAM,OAAO,gBAAgB;IAKR;IAJF,IAAI,CAAY;IAChB,KAAK,CAAS;IAE/B,YACmB,KAAY,EAC7B,UAAmC,EAAE;QADpB,UAAK,GAAL,KAAK,CAAO;QAG7B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EACzB,KAAK,EACL,IAAI,EACJ,IAAI,CAAC,KAAK,EACV,IAAI,CACL,CAAC;QACF,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB,EAAE,KAAa;QAC1C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAC/B,SAAS,EACT,CAAC,EACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EACzB,KAAK,EACL,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CACnB,CAAC;QACF,OAAO,GAAG,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,KAAa;QAC5C,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC;CACF;AAYD;;;;;;;;;GASG;AACH,MAAM,OAAO,gBAAgB;IAMR;IACA;IACA;IACA;IACA;IATF,YAAY,GAAG,IAAI,GAAG,EAAW,CAAC;IAClC,YAAY,GAAG,IAAI,GAAG,EAAW,CAAC;IAC3C,QAAQ,GAAG,KAAK,CAAC;IAEzB,YACmB,KAAY,EACZ,GAAU,EACV,OAAgB,EAChB,IAAe,EACf,MAAc;QAJd,UAAK,GAAL,KAAK,CAAO;QACZ,QAAG,GAAH,GAAG,CAAO;QACV,YAAO,GAAP,OAAO,CAAS;QAChB,SAAI,GAAJ,IAAI,CAAW;QACf,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,KAAY,EACZ,UAAmC,EAAE;QAErC,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAClC,KAAK,EACL,GAAG,EACH,CAAC,OAAO,CAAC,UAAU,EACnB,SAAS,CAAC,OAAO,CAAC,EAClB,CAAC,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC,CAAC,kBAAkB,CAAC,CACtD,CAAC;QACF,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,EAAU,EAAE,OAAe,EAAE,EAAE,CAChD,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,CAC9B,CAAC;QACF,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxE,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,QAAQ,CAAC,EAAU,EAAE,OAAe;QAC1C,IAAI,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,SAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,SAAS,GAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAA6B,CAAC,SAAS,CAAC;YACzE,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,GAAG,SAAS,CAAC;YACxB,CAAC;YACD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAC;gBAChE,OAAO;YACT,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,QAAsB,EAAE,SAAiB,EAAE,IAAY;QACpE,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,OAAO,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,GAAG,IAAI,uBAAuB,SAAS,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,EACzD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC7C,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,CAAC,OAAgB;QACrB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CACtB,IAAI,CAAC,IAAI,CAAC,WAAW,EACrB,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC,CAC9B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAgB;QACrB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,8BAA8B;IAC9B,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,GAAG;iBACX,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;iBACzD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;CACF;AAQD;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IAMf;IALF,IAAI,CAAY;IAChB,KAAK,CAAS;IACd,MAAM,CAAS;IAEhC,YACmB,KAAY,EAC7B,UAA0C,EAAE;QAD3B,UAAK,GAAL,KAAK,CAAO;QAG7B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,kBAAkB,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC,CAAC,yBAAyB,CAAC,CAAC;IAC7E,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,KAAK,CAAC,cAAsB;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAClB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EACjC,GAAG,EACH,IAAI,EACJ,IAAI,CAAC,KAAK,CACX,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,qBAAqB,cAAc,oCAAoC,MAAM,CAAC,GAAG,CAAC,EAAE,CACrF,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,KAAK,CAAC,cAAsB;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;QAC9C,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,SAAS,CAAC,cAAsB;QACpC,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,yBAAyB,cAAc,4BAA4B,MAAM,CAAC,GAAG,CAAC,EAAE,CACjF,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,KAAK,CACT,cAAsB,EACtB,EAA0B;QAE1B,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,qBAAqB,cAAc,KAAK,EAAE,aAAa,MAAM,CAAC,GAAG,CAAC,EAAE,CACrE,CAAC;YACF,OAAO,EAAE,KAAK,QAAQ,CAAC;QACzB,CAAC;IACH,CAAC;CACF;AAED,sCAAsC;AACtC,MAAM,iBAAiB,GACrB,2KAA2K,CAAC;AAC9K,6BAA6B;AAC7B,MAAM,QAAQ,GACZ,wFAAwF,CAAC;AAO3F,0CAA0C;AAC1C,MAAM,OAAO,eAAe;IAKP;IAJF,IAAI,CAAY;IAChB,UAAU,CAAS;IAEpC,YACmB,KAAY,EAC7B,UAAkC,EAAE;QADnB,UAAK,GAAL,KAAK,CAAO;QAG7B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,aAAqB,EAAE,KAAa;QAChD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAC/B,iBAAiB,EACjB,CAAC,EACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EACjC,MAAM,CAAC,KAAK,CAAC,EACb,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CACxB,CAAC;QACF,OAAO,GAAG,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,aAAqB;QAC9B,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,2BAA2B;IAC3B,KAAK,CAAC,GAAG,CAAC,aAAqB,EAAE,CAAS;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;;YACjC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACnE,CAAC;CACF"}
+{"version":3,"file":"coordination.js","sourceRoot":"","sources":["../src/coordination.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,15 +1,16 @@
 /**
  * `@qjp88995/agent-runtime` 的 Redis 适配：多实例部署时替换进程内的总线与协调件。
  *
- * 换的是五个端口——`StreamBus`、`SessionLock`、`WakeChannel`、`SubagentAwaitLease`、`TreeBudget`。
- * 存储类端口（跑次、消息、会话、问题、厂商文件）不在这里：它们归宿主的数据库。
+ * 换的是七个端口——`StreamBus`、`SessionLock`、`WakeChannel`、`SubagentAwaitLease`、`TreeBudget`、
+ * `TaskLease`、`TaskSignals`。
+ * 存储类端口（跑次、消息、会话、问题、厂商文件、任务表）不在这里：它们归宿主的数据库。
  */
 import type { Redis } from 'ioredis';
 import type { LoggerFactory } from '@qjp88995/agent-runtime';
-import { RedisSessionLock, RedisSubagentAwaitLease, RedisTreeBudget, RedisWakeChannel } from './coordination.js';
+import { RedisSessionLock, RedisSubagentAwaitLease, RedisTaskLease, RedisTaskSignals, RedisTreeBudget, RedisWakeChannel } from './coordination.js';
 import type { RedisKeyOptions } from './keys.js';
 import { RedisStreamBus, type RedisStreamBusOptions } from './stream-bus.js';
-export { RedisSessionLock, type RedisSessionLockOptions, RedisSubagentAwaitLease, type RedisSubagentAwaitLeaseOptions, RedisTreeBudget, type RedisTreeBudgetOptions, RedisWakeChannel, type RedisWakeChannelOptions, } from './coordination.js';
+export { RedisSessionLock, type RedisSessionLockOptions, RedisSubagentAwaitLease, type RedisSubagentAwaitLeaseOptions, RedisTaskLease, type RedisTaskLeaseOptions, RedisTaskSignals, type RedisTaskSignalsOptions, RedisTreeBudget, type RedisTreeBudgetOptions, RedisWakeChannel, type RedisWakeChannelOptions, } from './coordination.js';
 export { type RedisKeyOptions, type RedisKeys, redisKeys } from './keys.js';
 export { RedisStreamBus, type RedisStreamBusOptions } from './stream-bus.js';
 export interface RedisPortsOptions extends RedisKeyOptions {
@@ -23,7 +24,9 @@ export interface RedisPorts {
     wake: RedisWakeChannel;
     awaitLease: RedisSubagentAwaitLease;
     treeBudget: RedisTreeBudget;
-    /** 停总线定时器、关唤醒频道的订阅连接。不关 `redis` 本身（它是宿主的）。 */
+    taskLease: RedisTaskLease;
+    taskSignals: RedisTaskSignals;
+    /** 停总线定时器、关唤醒频道与转后台广播的订阅连接。不关 `redis` 本身（它是宿主的）。 */
     dispose(): Promise<void>;
 }
 /**
@@ -33,8 +36,8 @@ export interface RedisPorts {
  * const ports = { ...createInProcessPorts(), ...(await createRedisPorts(redis)) };
  * ```
  *
- * `redis` 是宿主的共享连接（锁、租约、名额、写会话流都用它）；唤醒频道与每个会话订阅
- * 各自 `duplicate()` 一条。等唤醒频道订阅就绪才返回。
+ * `redis` 是宿主的共享连接（锁、租约、名额、写会话流都用它）；唤醒频道、转后台广播与每个会话订阅
+ * 各自 `duplicate()` 一条。等两个频道的订阅都就绪才返回。
  */
 export declare function createRedisPorts(redis: Redis, options?: RedisPortsOptions): Promise<RedisPorts>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,uBAAuB,EACvB,KAAK,8BAA8B,EACnC,eAAe,EACf,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,gDAAgD;IAChD,GAAG,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,uBAAuB,CAAC;IACpC,UAAU,EAAE,eAAe,CAAC;IAC5B,8CAA8C;IAC9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAerB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,uBAAuB,EACvB,KAAK,8BAA8B,EACnC,cAAc,EACd,KAAK,qBAAqB,EAC1B,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,eAAe,EACf,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,gDAAgD;IAChD,GAAG,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,uBAAuB,CAAC;IACpC,UAAU,EAAE,eAAe,CAAC;IAC5B,SAAS,EAAE,cAAc,CAAC;IAC1B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,oDAAoD;IACpD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAoBrB"}

package/dist/index.js

@@ -1,6 +1,6 @@
-import { RedisSessionLock, RedisSubagentAwaitLease, RedisTreeBudget, RedisWakeChannel, } from './coordination.js';
+import { RedisSessionLock, RedisSubagentAwaitLease, RedisTaskLease, RedisTaskSignals, RedisTreeBudget, RedisWakeChannel, } from './coordination.js';
 import { RedisStreamBus } from './stream-bus.js';
-export { RedisSessionLock, RedisSubagentAwaitLease, RedisTreeBudget, RedisWakeChannel, } from './coordination.js';
+export { RedisSessionLock, RedisSubagentAwaitLease, RedisTaskLease, RedisTaskSignals, RedisTreeBudget, RedisWakeChannel, } from './coordination.js';
 export { redisKeys } from './keys.js';
 export { RedisStreamBus } from './stream-bus.js';
 /**
@@ -10,12 +10,15 @@ export { RedisStreamBus } from './stream-bus.js';
  * const ports = { ...createInProcessPorts(), ...(await createRedisPorts(redis)) };
  * ```
  *
- * `redis` 是宿主的共享连接（锁、租约、名额、写会话流都用它）；唤醒频道与每个会话订阅
- * 各自 `duplicate()` 一条。等唤醒频道订阅就绪才返回。
+ * `redis` 是宿主的共享连接（锁、租约、名额、写会话流都用它）；唤醒频道、转后台广播与每个会话订阅
+ * 各自 `duplicate()` 一条。等两个频道的订阅都就绪才返回。
  */
 export async function createRedisPorts(redis, options = {}) {
     const { keyPrefix, logger } = options;
-    const wake = await RedisWakeChannel.create(redis, { keyPrefix, logger });
+    const [wake, taskSignals] = await Promise.all([
+        RedisWakeChannel.create(redis, { keyPrefix, logger }),
+        RedisTaskSignals.create(redis, { keyPrefix, logger }),
+    ]);
     const bus = new RedisStreamBus(redis, { ...options.bus, keyPrefix });
     return {
         bus,
@@ -23,9 +26,11 @@ export async function createRedisPorts(redis, options = {}) {
         wake,
         awaitLease: new RedisSubagentAwaitLease(redis, { keyPrefix, logger }),
         treeBudget: new RedisTreeBudget(redis, { keyPrefix }),
+        taskLease: new RedisTaskLease(redis, { keyPrefix }),
+        taskSignals,
         async dispose() {
             bus.dispose();
-            await wake.dispose();
+            await Promise.all([wake.dispose(), taskSignals.dispose()]);
         },
     };
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAA8B,MAAM,iBAAiB,CAAC;AAE7E,OAAO,EACL,gBAAgB,EAEhB,uBAAuB,EAEvB,eAAe,EAEf,gBAAgB,GAEjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAwC,SAAS,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,cAAc,EAA8B,MAAM,iBAAiB,CAAC;AAkB7E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAY,EACZ,UAA6B,EAAE;IAE/B,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACtC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IACrE,OAAO;QACL,GAAG;QACH,IAAI,EAAE,IAAI,gBAAgB,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC;QAChD,IAAI;QACJ,UAAU,EAAE,IAAI,uBAAuB,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACrE,UAAU,EAAE,IAAI,eAAe,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC;QACrD,KAAK,CAAC,OAAO;YACX,GAAG,CAAC,OAAO,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAA8B,MAAM,iBAAiB,CAAC;AAE7E,OAAO,EACL,gBAAgB,EAEhB,uBAAuB,EAEvB,cAAc,EAEd,gBAAgB,EAEhB,eAAe,EAEf,gBAAgB,GAEjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAwC,SAAS,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,cAAc,EAA8B,MAAM,iBAAiB,CAAC;AAoB7E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAY,EACZ,UAA6B,EAAE;IAE/B,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACtC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACrD,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;KACtD,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IACrE,OAAO;QACL,GAAG;QACH,IAAI,EAAE,IAAI,gBAAgB,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC;QAChD,IAAI;QACJ,UAAU,EAAE,IAAI,uBAAuB,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACrE,UAAU,EAAE,IAAI,eAAe,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC;QACrD,SAAS,EAAE,IAAI,cAAc,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC;QACnD,WAAW;QACX,KAAK,CAAC,OAAO;YACX,GAAG,CAAC,OAAO,EAAE,CAAC;YACd,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/keys.d.ts

@@ -1,5 +1,5 @@
 /**
- * 键与频道名。缺省与 agent-base 线上用的一字不差——agent-base 换上本包时可以滚动发布
+ * 键与频道名。缺省与 agent-base 线上用的一字不差（`agent-task:*` 是 0.2.0 新加的，没有旧格式要兼容）——agent-base 换上本包时可以滚动发布
  * （新旧实例共用一个 Redis 期间锁、唤醒、租约、会话流都互通），空闲广播的载荷也照旧是
  * JSON `{ sessionId }`，它现有的订阅方不用改。
  *
@@ -16,6 +16,8 @@ export interface RedisKeys {
     awaited(childSessionId: string): string;
     liveSubs(rootSessionId: string): string;
     sessionStream(rootSessionId: string): string;
+    taskLease(taskId: string): string;
+    taskBackgroundChannel: string;
 }
 export declare function redisKeys(options?: RedisKeyOptions): RedisKeys;
 //# sourceMappingURL=keys.d.ts.map

package/dist/keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9C;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE,eAAoB,GAAG,SAAS,CAUlE"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE,eAAoB,GAAG,SAAS,CAYlE"}

package/dist/keys.js

@@ -7,6 +7,8 @@ export function redisKeys(options = {}) {
         awaited: c => `${p}agent-subagent:awaited:${c}`,
         liveSubs: r => `${p}agent-tree:live-subs:${r}`,
         sessionStream: r => `${p}agent-session:${r}`,
+        taskLease: t => `${p}agent-task:lease:${t}`,
+        taskBackgroundChannel: `${p}agent-task:background`,
     };
 }
 //# sourceMappingURL=keys.js.map

package/dist/keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,SAAS,CAAC,UAA2B,EAAE;IACrD,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAClC,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE;QACrC,WAAW,EAAE,GAAG,CAAC,iBAAiB;QAClC,WAAW,EAAE,GAAG,CAAC,oBAAoB;QACrC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC,EAAE;QAC/C,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE;QAC9C,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE;KAC7C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,SAAS,CAAC,UAA2B,EAAE;IACrD,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;IAClC,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE;QACrC,WAAW,EAAE,GAAG,CAAC,iBAAiB;QAClC,WAAW,EAAE,GAAG,CAAC,oBAAoB;QACrC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,0BAA0B,CAAC,EAAE;QAC/C,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,wBAAwB,CAAC,EAAE;QAC9C,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE;QAC5C,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAAE;QAC3C,qBAAqB,EAAE,GAAG,CAAC,uBAAuB;KACnD,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qjp88995/agent-runtime-redis",
-  "version": "0.1.0",
-  "description": "Redis adapters for @qjp88995/agent-runtime: event bus, session lock, wake/idle channel, subagent await lease and tree budget, for running on more than one instance.",
+  "version": "0.2.0",
+  "description": "Redis adapters for @qjp88995/agent-runtime: event bus, session lock, wake/idle channel, subagent await lease, tree budget, task lease and task background signal, for running on more than one instance.",
   "license": "UNLICENSED",
   "type": "module",
   "publishConfig": {
@@ -30,14 +30,14 @@
   },
   "peerDependencies": {
     "ioredis": "^5.4.0",
-    "@qjp88995/agent-runtime": "^0.1.0"
+    "@qjp88995/agent-runtime": "^0.2.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.5",
     "ioredis": "^5.11.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.10",
-    "@qjp88995/agent-runtime": "0.1.0"
+    "@qjp88995/agent-runtime": "0.2.0"
   },
   "scripts": {
     "build": "rm -rf dist *.tsbuildinfo && tsc -p tsconfig.build.json",

package/src/coordination.ts

@@ -9,6 +9,8 @@ import {
   type LoggerFactory,
   type SessionLock,
   type SubagentAwaitLease,
+  type TaskLease,
+  type TaskSignals,
   type TreeBudget,
   type WakeChannel,
 } from '@qjp88995/agent-runtime';
@@ -16,12 +18,12 @@ import {
 import { type RedisKeyOptions, type RedisKeys, redisKeys } from './keys.js';
 
 /**
- * 会话锁、唤醒 / 空闲广播、子 Agent 等待租约、树级名额的 Redis 实现。
+ * 会话锁、唤醒 / 空闲广播、子 Agent 等待租约、树级名额、任务监视租约与转后台广播的 Redis 实现。
  * 搬自 agent-base `agent-core/loop/{session-lock,session-wake}.service.ts`、`session-idle.ts`、
  * `agent-core/subagent/{subagent-await,tree-budget}.service.ts`，语义见 runtime 的 `ports/coordination`。
  *
- * 锁 / 租约 / 名额都直接用宿主给的共享连接（全是非阻塞的常规命令），只有唤醒频道要一条
- * 独立的订阅连接（进了 subscribe 模式的连接不能再发普通命令）。
+ * 锁 / 租约 / 名额都直接用宿主给的共享连接（全是非阻塞的常规命令），只有唤醒频道与转后台广播
+ * 各要一条独立的订阅连接（进了 subscribe 模式的连接不能再发普通命令）。
  */
 
 /** DEL 前比对 token，避免误删「TTL 过期后被别人重新抢到」的锁。 */
@@ -36,23 +38,18 @@ export interface RedisSessionLockOptions extends RedisKeyOptions {
   ttlMs?: number;
 }
 
-/** SET NX PX 抢锁，Lua 比对 token 再 DEL / PEXPIRE。TTL 兜底持有者崩溃。 */
-export class RedisSessionLock implements SessionLock {
-  private readonly keys: RedisKeys;
-  private readonly ttlMs: number;
-
+/** SET NX PX 抢，Lua 比对 token 再 DEL / PEXPIRE。会话锁与任务租约共用，只是键空间不同。 */
+class RedisTokenLock {
   constructor(
     private readonly redis: Redis,
-    options: RedisSessionLockOptions = {}
-  ) {
-    this.keys = redisKeys(options);
-    this.ttlMs = options.ttlMs ?? LOCK_TTL_MS;
-  }
+    private readonly keyOf: (id: string) => string,
+    private readonly ttlMs: number
+  ) {}
 
-  async acquire(sessionId: string): Promise<string | null> {
+  async acquire(id: string): Promise<string | null> {
     const token = randomUUID();
     const res = await this.redis.set(
-      this.keys.lock(sessionId),
+      this.keyOf(id),
       token,
       'PX',
       this.ttlMs,
@@ -61,23 +58,82 @@ export class RedisSessionLock implements SessionLock {
     return res === 'OK' ? token : null;
   }
 
-  async renew(sessionId: string, token: string): Promise<boolean> {
+  async renew(id: string, token: string): Promise<boolean> {
     const res = await this.redis.eval(
       RENEW_LUA,
       1,
-      this.keys.lock(sessionId),
+      this.keyOf(id),
       token,
       String(this.ttlMs)
     );
     return res === 1;
   }
 
-  async release(sessionId: string, token: string): Promise<void> {
-    await this.redis.eval(RELEASE_LUA, 1, this.keys.lock(sessionId), token);
+  async release(id: string, token: string): Promise<void> {
+    await this.redis.eval(RELEASE_LUA, 1, this.keyOf(id), token);
   }
 
-  async isHeld(sessionId: string): Promise<boolean> {
-    return (await this.redis.exists(this.keys.lock(sessionId))) === 1;
+  async isHeld(id: string): Promise<boolean> {
+    return (await this.redis.exists(this.keyOf(id))) === 1;
+  }
+}
+
+/** 会话锁。TTL 兜底持有者崩溃。 */
+export class RedisSessionLock implements SessionLock {
+  private readonly lock: RedisTokenLock;
+
+  constructor(redis: Redis, options: RedisSessionLockOptions = {}) {
+    this.lock = new RedisTokenLock(
+      redis,
+      redisKeys(options).lock,
+      options.ttlMs ?? LOCK_TTL_MS
+    );
+  }
+
+  acquire(sessionId: string): Promise<string | null> {
+    return this.lock.acquire(sessionId);
+  }
+
+  renew(sessionId: string, token: string): Promise<boolean> {
+    return this.lock.renew(sessionId, token);
+  }
+
+  release(sessionId: string, token: string): Promise<void> {
+    return this.lock.release(sessionId, token);
+  }
+
+  isHeld(sessionId: string): Promise<boolean> {
+    return this.lock.isHeld(sessionId);
+  }
+}
+
+export interface RedisTaskLeaseOptions extends RedisKeyOptions {
+  /** 缺省 `LOCK_TTL_MS`（60s）。监视器每段等待（runtime 缺省 20s）之后续一次。 */
+  ttlMs?: number;
+}
+
+/** 任务监视租约：与会话锁同一套写法，键 `agent-task:lease:<taskId>`。 */
+export class RedisTaskLease implements TaskLease {
+  private readonly lock: RedisTokenLock;
+
+  constructor(redis: Redis, options: RedisTaskLeaseOptions = {}) {
+    this.lock = new RedisTokenLock(
+      redis,
+      redisKeys(options).taskLease,
+      options.ttlMs ?? LOCK_TTL_MS
+    );
+  }
+
+  acquire(taskId: string): Promise<string | null> {
+    return this.lock.acquire(taskId);
+  }
+
+  renew(taskId: string, token: string): Promise<boolean> {
+    return this.lock.renew(taskId, token);
+  }
+
+  release(taskId: string, token: string): Promise<void> {
+    return this.lock.release(taskId, token);
   }
 }
 
@@ -201,6 +257,80 @@ export class RedisWakeChannel implements WakeChannel {
   }
 }
 
+export interface RedisTaskSignalsOptions extends RedisKeyOptions {
+  /** 订阅用的连接。缺省 `redis.duplicate()`，由本对象负责关闭；宿主自己给的不关。 */
+  subscriber?: Redis;
+  logger?: LoggerFactory;
+}
+
+/**
+ * 「任务转后台」广播走 Redis pub/sub，载荷就是任务 id。与 `RedisWakeChannel` 同样用
+ * `create()` 等 SUBSCRIBE 应答回来才返回。广播丢了不要紧：前台等待方每段等待之后都回看任务行
+ * 的 `background`，信号只是让它不必等满这一段。
+ */
+export class RedisTaskSignals implements TaskSignals {
+  private readonly handlers = new Set<Handler>();
+  private disposed = false;
+
+  private constructor(
+    private readonly redis: Redis,
+    private readonly sub: Redis,
+    private readonly ownsSub: boolean,
+    private readonly channel: string,
+    private readonly logger: Logger
+  ) {}
+
+  static async create(
+    redis: Redis,
+    options: RedisTaskSignalsOptions = {}
+  ): Promise<RedisTaskSignals> {
+    const sub = options.subscriber ?? redis.duplicate();
+    const signals = new RedisTaskSignals(
+      redis,
+      sub,
+      !options.subscriber,
+      redisKeys(options).taskBackgroundChannel,
+      (options.logger ?? consoleLogger)('RedisTaskSignals')
+    );
+    sub.on('message', (ch: string, taskId: string) => {
+      if (ch === signals.channel) signals.dispatch(taskId);
+    });
+    await sub.subscribe(signals.channel);
+    return signals;
+  }
+
+  private dispatch(taskId: string): void {
+    for (const handler of [...this.handlers]) {
+      try {
+        handler(taskId);
+      } catch (err) {
+        this.logger.error(
+          `background handler failed for ${taskId}: ${String(err)}`,
+          err instanceof Error ? err.stack : undefined
+        );
+      }
+    }
+  }
+
+  async background(taskId: string): Promise<void> {
+    await this.redis.publish(this.channel, taskId);
+  }
+
+  onBackground(handler: Handler): () => void {
+    this.handlers.add(handler);
+    return () => this.handlers.delete(handler);
+  }
+
+  /** 摘掉处理函数；订阅连接是本对象建的就关掉，否则只退订本频道。 */
+  async dispose(): Promise<void> {
+    if (this.disposed) return;
+    this.disposed = true;
+    this.handlers.clear();
+    if (this.ownsSub) await this.sub.quit().catch(() => undefined);
+    else await this.sub.unsubscribe(this.channel).catch(() => undefined);
+  }
+}
+
 export interface RedisSubagentAwaitLeaseOptions extends RedisKeyOptions {
   /** 缺省 `AWAIT_LEASE_TTL_MS`（60s）。 */
   ttlMs?: number;

package/src/index.ts

@@ -1,8 +1,9 @@
 /**
  * `@qjp88995/agent-runtime` 的 Redis 适配：多实例部署时替换进程内的总线与协调件。
  *
- * 换的是五个端口——`StreamBus`、`SessionLock`、`WakeChannel`、`SubagentAwaitLease`、`TreeBudget`。
- * 存储类端口（跑次、消息、会话、问题、厂商文件）不在这里：它们归宿主的数据库。
+ * 换的是七个端口——`StreamBus`、`SessionLock`、`WakeChannel`、`SubagentAwaitLease`、`TreeBudget`、
+ * `TaskLease`、`TaskSignals`。
+ * 存储类端口（跑次、消息、会话、问题、厂商文件、任务表）不在这里：它们归宿主的数据库。
  */
 import type { Redis } from 'ioredis';
 
@@ -11,6 +12,8 @@ import type { LoggerFactory } from '@qjp88995/agent-runtime';
 import {
   RedisSessionLock,
   RedisSubagentAwaitLease,
+  RedisTaskLease,
+  RedisTaskSignals,
   RedisTreeBudget,
   RedisWakeChannel,
 } from './coordination.js';
@@ -22,6 +25,10 @@ export {
   type RedisSessionLockOptions,
   RedisSubagentAwaitLease,
   type RedisSubagentAwaitLeaseOptions,
+  RedisTaskLease,
+  type RedisTaskLeaseOptions,
+  RedisTaskSignals,
+  type RedisTaskSignalsOptions,
   RedisTreeBudget,
   type RedisTreeBudgetOptions,
   RedisWakeChannel,
@@ -42,7 +49,9 @@ export interface RedisPorts {
   wake: RedisWakeChannel;
   awaitLease: RedisSubagentAwaitLease;
   treeBudget: RedisTreeBudget;
-  /** 停总线定时器、关唤醒频道的订阅连接。不关 `redis` 本身（它是宿主的）。 */
+  taskLease: RedisTaskLease;
+  taskSignals: RedisTaskSignals;
+  /** 停总线定时器、关唤醒频道与转后台广播的订阅连接。不关 `redis` 本身（它是宿主的）。 */
   dispose(): Promise<void>;
 }
 
@@ -53,15 +62,18 @@ export interface RedisPorts {
  * const ports = { ...createInProcessPorts(), ...(await createRedisPorts(redis)) };
  * ```
  *
- * `redis` 是宿主的共享连接（锁、租约、名额、写会话流都用它）；唤醒频道与每个会话订阅
- * 各自 `duplicate()` 一条。等唤醒频道订阅就绪才返回。
+ * `redis` 是宿主的共享连接（锁、租约、名额、写会话流都用它）；唤醒频道、转后台广播与每个会话订阅
+ * 各自 `duplicate()` 一条。等两个频道的订阅都就绪才返回。
  */
 export async function createRedisPorts(
   redis: Redis,
   options: RedisPortsOptions = {}
 ): Promise<RedisPorts> {
   const { keyPrefix, logger } = options;
-  const wake = await RedisWakeChannel.create(redis, { keyPrefix, logger });
+  const [wake, taskSignals] = await Promise.all([
+    RedisWakeChannel.create(redis, { keyPrefix, logger }),
+    RedisTaskSignals.create(redis, { keyPrefix, logger }),
+  ]);
   const bus = new RedisStreamBus(redis, { ...options.bus, keyPrefix });
   return {
     bus,
@@ -69,9 +81,11 @@ export async function createRedisPorts(
     wake,
     awaitLease: new RedisSubagentAwaitLease(redis, { keyPrefix, logger }),
     treeBudget: new RedisTreeBudget(redis, { keyPrefix }),
+    taskLease: new RedisTaskLease(redis, { keyPrefix }),
+    taskSignals,
     async dispose() {
       bus.dispose();
-      await wake.dispose();
+      await Promise.all([wake.dispose(), taskSignals.dispose()]);
     },
   };
 }

package/src/keys.ts

@@ -1,5 +1,5 @@
 /**
- * 键与频道名。缺省与 agent-base 线上用的一字不差——agent-base 换上本包时可以滚动发布
+ * 键与频道名。缺省与 agent-base 线上用的一字不差（`agent-task:*` 是 0.2.0 新加的，没有旧格式要兼容）——agent-base 换上本包时可以滚动发布
  * （新旧实例共用一个 Redis 期间锁、唤醒、租约、会话流都互通），空闲广播的载荷也照旧是
  * JSON `{ sessionId }`，它现有的订阅方不用改。
  *
@@ -17,6 +17,8 @@ export interface RedisKeys {
   awaited(childSessionId: string): string;
   liveSubs(rootSessionId: string): string;
   sessionStream(rootSessionId: string): string;
+  taskLease(taskId: string): string;
+  taskBackgroundChannel: string;
 }
 
 export function redisKeys(options: RedisKeyOptions = {}): RedisKeys {
@@ -28,5 +30,7 @@ export function redisKeys(options: RedisKeyOptions = {}): RedisKeys {
     awaited: c => `${p}agent-subagent:awaited:${c}`,
     liveSubs: r => `${p}agent-tree:live-subs:${r}`,
     sessionStream: r => `${p}agent-session:${r}`,
+    taskLease: t => `${p}agent-task:lease:${t}`,
+    taskBackgroundChannel: `${p}agent-task:background`,
   };
 }